English | Français | 简体中文 | Deutsch
> **注意：** 本翻译由机器自动生成，可能存在不准确之处。
为并行编码智能体打造的无限画布 IDE。
---
Cate 是一款基于无限画布的桌面 IDE，为同时运行大量终端和编码智能体而设计。在 Cate 终端里运行 Claude Code、Codex 或任意智能体 CLI，画布就成了任务控制中心：每个终端都会显示它的智能体是在工作、已完成还是在等你，一旦有智能体需要输入，Cate 会立即发出通知。一键创建并行的 git worktree，每个 worktree 在画布上拥有自己的彩色领地，五个智能体跑在五个分支上，依然是五条泾渭分明的工作流，而不是一堆标签页。
围绕这个核心是一套完整的 IDE：Monaco 编辑器、内嵌浏览器、文档查看器、git 工具和内置智能体聊天。面板可以浮在画布任意位置、停靠成标签和分屏，或拆分到独立的系统窗口。重新打开文件夹时，Cate 会还原整个布局。
**快速开始：** 打开一个文件夹，它就成为一个工作区。右键添加面板，按 `Cmd+K` 打开命令面板，把面板拖到停靠区即可创建标签和分屏。无需任何配置文件。
嘿，说你呢，来加入我们的 stargazers 吧 :)
## 安装
下载预构建版本。日常使用请勿从源码构建。
| 平台 | 格式 | 链接 |
|----------|---------|------|
| macOS | DMG、ZIP（`arm64`、`x64`） | [最新版本](https://github.com/0-AI-UG/cate/releases/latest) |
| Windows | NSIS 安装器、ZIP（`x64`） | [最新版本](https://github.com/0-AI-UG/cate/releases/latest) |
| Linux | AppImage、DEB、`tar.gz`（`x64`） | [最新版本](https://github.com/0-AI-UG/cate/releases/latest) |
macOS 也可以用 Homebrew 安装：
```sh
brew install --cask cate
```
## 包含什么
- **感知智能体的终端：** Cate 会为支持的智能体 CLI（Claude Code、Codex、Cursor、Grok、OpenCode、Pi）安装钩子，由智能体自己上报一轮对话的开始、结束以及权限询问。面板的运行中／等待／已完成状态，以及智能体需要你回应时的通知，都由此驱动。不发送钩子的智能体不会显示任何状态。
- **智能体会话在重启后延续：** 钩子流会带上每个 CLI 的会话 ID。重新打开项目，终端会带着回滚缓冲回来，并用智能体自己的恢复命令重新接上会话。ID 已失效时会退回普通 shell，而不是恢复错误的会话。
- **为并行分支准备的 worktree：** 描述你要做什么，Cate 就会基于本地分支、远程分支或一个开放的 PR 创建 worktree 和分支。每个 worktree 都有专属颜色，贯穿侧边栏、停靠标签，以及画布上绘制在其面板背后的领地。
- **画布上或停靠区里的面板：** 终端、Monaco 编辑器、浏览器、PDF／图片／DOCX 查看器、扩展 webview、嵌套画布。可以浮在画布上、停靠成标签和分屏，或拖进独立窗口。布局按项目保存。
- **Git 与搜索：** 版本控制侧边栏支持暂存、提交、分支、stash 和历史，可跨多个仓库；文件树带 git 状态标记；并排差异对比。工作区内使用 ripgrep 搜索，`Cmd+K` 查找命令、面板和文件。
- **智能体可调用的 CLI：** 在 Cate 终端里，`cate` 可以驱动浏览器面板（`open`、`screenshot`、`snapshot`、`click`、`type`）、读取其他终端、打开文件、管理面板。设置 → CLI 中可分别授予每个能力的读取与控制权限。
- **本地与远程走同一条路：** 同一个运行时守护进程服务所有工作区。通过 SSH 或 WSL 指向一台主机，终端、git、搜索和智能体都在那边运行；编辑器、浏览器和画布留在本地。
## 扩展
Cate 提供第三方面板的扩展系统（MCP 服务器、图表等），每个扩展运行在独立的隔离 webview 中。在配套仓库浏览和开发：[0-AI-UG/cate-extensions](https://github.com/0-AI-UG/cate-extensions)。
## 键盘快捷键
下表为 macOS；Windows/Linux 上用 `Ctrl` 代替 `Cmd`。
| 面板与文件 | | 视图与导航 | |
|---|---|---|---|
| 新建终端 | `Cmd+T` | 命令面板 | `Cmd+K` |
| 新建编辑器 | `Cmd+Shift+E` | 全局搜索 | `Cmd+Shift+F` |
| 新建浏览器 | `Cmd+Shift+B` | 切换侧边栏 | `Cmd+B` |
| 新建智能体 | `Cmd+Shift+A` | 切换文件浏览器 | `Cmd+Shift+X` |
| 新建画布 | `Cmd+Shift+C` | 切换小地图 | `Cmd+Shift+M` |
| 新建文件 | `Cmd+N` | 聚焦下一个 / 上一个面板 | `Ctrl+Tab` / `Ctrl+Shift+Tab` |
| 保存文件 | `Cmd+S` | 在面板间移动 | `Cmd+←↑↓→` |
| 关闭面板 | `Cmd+W` | 删除聚焦的面板 | `Cmd+Backspace` |
| 画布 | |
|---|---|
| 放大 / 缩小 | `Cmd+=` / `Cmd+-` |
| 重置缩放 | `Cmd+0` |
| 缩放至全部 / 选区 | `Cmd+1` / `Cmd+2` |
| 自动布局画布 | `Cmd+Shift+L` |
| 平移画布 | `Shift+←↑↓→` |
| 切换选择 / 抓手工具 | `Shift+Space` |
| 撤销 / 重做 | `Cmd+Z` / `Cmd+Shift+Z` |
所有快捷键都可以在设置中重新绑定。
## 从源码构建
面向贡献者。其他情况请用上面的发布版本。
**前置条件：**
- [Bun](https://bun.sh)：包管理器和脚本运行器。
- [Node.js](https://nodejs.org/) 20 或 22 LTS（见 `.nvmrc`），需在 PATH 中。构建脚本在其下运行；运行时守护进程自带 Node 22。
- **仅 Linux：** `node-pty` 为 macOS 和 Windows 提供预构建二进制，但不含 Linux，因此需要从源码编译。请安装 Python 3 和 C++ 工具链：
- Debian/Ubuntu：`sudo apt install build-essential python3`
- Fedora/RHEL：`sudo dnf install @development-tools gcc-c++ make python3`
- Arch：`sudo pacman -S base-devel python`
全新克隆后，一条命令完成全部准备（安装依赖并构建本地运行时守护进程）：
```bash
git clone https://github.com/0-AI-UG/cate.git
cd cate
bun run setup
```
然后：
```bash
bun run dev # 带热重载的开发服务器
bun run typecheck
bun run test # 单元测试（vitest）
bun run test:e2e # Playwright 集成测试
bun run build # 生产构建
bun run package # 打包分发（:mac、:win、:linux）
```
打包后的二进制文件位于 `release/`。运行时守护进程由 `bun run runtime:tarball` 重新构建（修改 `src/runtime/` 下的内容后需重新运行）。
## 架构
```text
src/
├── agent/ # 内置 Pi 编码智能体：进程管理、鉴权、市场、面板 UI
├── cli/ # Cate 终端内可用的 `cate` CLI（浏览器控制、面板、编辑器）
├── main/ # Electron 主进程：IPC、工作区、窗口、更新器、安全
├── preload/ # 上下文隔离的 IPC 桥
├── renderer/ # React 18 应用：画布、停靠、面板、侧边栏、store、hooks
├── runtime/ # 远程（SSH）工作区的运行时守护进程：终端、智能体、搜索
└── shared/ # IPC 通道与共享类型
```
Cate 的所有 IPC 都经过上下文隔离的 preload 桥。文件系统访问限定在已注册的工作区根目录，浏览器面板禁用 Node 集成，终端无法在批准目录之外启动。
**技术栈：** Electron 41、React 18、Zustand 5、Monaco 0.52、xterm.js 5.5 + node-pty 1.0、Tailwind 3.4、electron-vite、electron-builder、electron-updater、Sentry。PDF 和 DOCX 用 pdf.js 与 mammoth，git 用 simple-git，文件监听用 `@parcel/watcher` 与 chokidar。内置编码智能体基于 `@earendil-works/pi`，作为按需运行时随应用分发。
## 贡献
见 [CONTRIBUTING.md](CONTRIBUTING.md)。逐版本的历史记录在 [CHANGELOG](CHANGELOG.md)。
## Star 历史
## 许可证
[MIT](LICENSE)
