Collaborator完整入门：AI智能体开发环境的无限画布新范式，为什么它让Agent与代码并肩工作

【免费下载链接】collab-publicCollaborator is a place to create with agents.项目地址: https://gitcode.com/gh_mirrors/co/collab-public

Collaborator 是一款面向 AI 智能体（Agent）开发的桌面应用，它把终端、上下文文件和正在运行的代码全部铺在一块无限画布上：左边是文件导航栏，中间是与 Agent 终端、Markdown 笔记、代码文件并排摆放的工作区，真正做到“无上下文切换、无标签页翻找”。本文是一份面向新手的完整入门指南，带你 5 分钟上手这款 AI 智能体开发环境。

为什么需要“Agent与代码并肩”的工作方式？

传统的 AI 编程工作流通常是这样的：IDE 里开一个终端，跑起 Claude Code 或 Codex，然后反复在“看终端输出”和“编辑文件”之间切换——标签页越开越多，上下文越切越碎。

Collaborator 换了一种思路：把一切都变成画布上的“磁贴”（Tile）。

• 🖥️终端磁贴：每个终端是一个独立会话，专门用来跑 AI Agent
• 📝笔记磁贴：Markdown 文件拖上来即可实时编辑
• 💻代码磁贴：带语法高亮的代码编辑器
• 🖼️图片磁贴：只读图片预览

终端跑着 Agent 的同时，旁边就是它正在改的文件、你要读的文档——视野之内，全部可见。项目定位详见 README.md。

一键安装：三种平台最快上手方法

Collaborator 是原生桌面应用，支持 macOS、Windows 和 Linux（Windows 终端可同时支持 PowerShell 和 WSL2 发行版）。

方式一：下载安装包（推荐）

前往发布页下载对应平台的最新安装包：macOS / Windows 用安装包，Linux 直接安装。

方式二：命令行安装（macOS / Linux）

curl -fsSL https://raw.githubusercontent.com/collaborator-ai/collab-public/main/install.sh | bash

方式三：从源码运行开发版

如果你想参与开发（源码结构参考 CONTRIBUTING.md）：

git clone https://gitcode.com/gh_mirrors/co/collab-public cd collab-public/collab-electron bun install bun run dev

前提：Node.js 22+ 与 Bun。构建基于 electron-vite，开发模式下支持热重载。

无限画布：4步开启你的Agent工作台

第1步：添加工作区

打开应用后，点击左侧导航栏顶部的工作区下拉框选择 “Add workspace”，或按快捷键Cmd+Shift+O（Linux/Windows 为Ctrl+Shift+O），然后选择一个本地文件夹。支持多工作区并存，每个工作区有独立的文件树。

第2步：双击画布创建终端

在空白画布上双击，即刻生成一个终端磁贴，其工作目录自动设为当前工作区路径。在这里启动你的 Agent（Claude Code、Codex、Gemini CLI 等），多个 Agent 可以并排同时跑，互不干扰——每个终端磁贴都绑定一个由 node-pty 独立守护的持久会话，实现细节见 collab-electron/src/main/pty.ts 与 collab-electron/src/main/sidecar/client.ts。

第3步：把文件拖上画布

从左侧文件树中把文件拖拽到画布上：.md文件变成可编辑的笔记磁贴，其他文本文件变成代码磁贴，图片变成只读预览。磁贴位置、大小自动吸附网格，拖标题栏即可移动。

第4步：自由缩放与平移

缩放范围 33%–100%，右下角会短暂显示当前缩放百分比。

文件导航器与查看器：Agent的上下文管理

左侧导航器（Navigator）提供完整的文件树能力：展开/折叠、F2 重命名、多选（Shift+点击 / Cmd+点击）、拖拽移动文件、Cmd+K快速搜索，还支持“时间线”视图按修改日期浏览。选中文件后，主区域的查看器会展示其内容——Markdown 支持 wikilink 与封面图，代码文件支持行号高亮，且磁盘上的外部改动会自动热重载。

所有应用状态（磁贴布局、视口、工作区列表）都以 JSON 文件保存在本地~/.collaborator/目录，无需账号、数据不出本地。布局引擎的源码在 collab-electron/src/windows/shell/src/tile-manager.js 和 collab-electron/src/windows/shell/src/canvas-state.js。

进阶玩法：用CLI指挥画布，让Agent替你摆放磁贴

这是 Collaborator 最“极客”的亮点：内置的collab-canvas命令行工具让你（或你的 Agent）从终端反向控制画布——列出磁贴、在指定网格坐标创建终端/笔记/代码/图片磁贴。完整命令参考 collab-electron/packages/collab-canvas-skill/skills/collab-canvas/SKILL.md：

# 在坐标 (5,5) 创建一个终端磁贴 collab-canvas tile create term --pos 5,5 # 把 README.md 打开为笔记磁贴 collab-canvas tile create note --file ./README.md

配合 Agent 使用时，Agent 可以在执行任务的同时自动为自己“摆出”工作现场——这正是“无限画布新范式”的含义：空间即上下文，布局即状态。

此外，应用还在记录统一的画布事件日志（PTY 生命周期、OSC 事件、磁贴操作），为未来的 Agent 可观测性打基础，设计文档见 collab-electron/docs/superpowers/specs/2026-04-05-canvas-event-log-design.md。

技术栈一览：为什么它快而稳

Collaborator 用现代桌面技术栈构建（collab-electron/package.json）：

• Electron 40+ 多 Webview 架构
• React 19+ Tailwind CSS 4
• xterm.js+ 独立 node-pty sidecar 进程（终端永不随窗口崩溃）
• Monaco Editor（代码编辑）、BlockNote/TipTap（富文本）、D3（工作区关系图）

总结：谁适合Collaborator？

Collaborator 目前处于早期快速迭代阶段（窗口底部还写着 “ALPHA – BEWARE BUGS”），但它的核心范式已经足够清晰：别再在标签页里寻找你的 Agent，让 Agent 和你的代码并肩站在一起。现在就下载安装，双击画布，开启你的第一个终端吧 🚀

【免费下载链接】collab-publicCollaborator is a place to create with agents.项目地址: https://gitcode.com/gh_mirrors/co/collab-public