DOCS · QUICK START

从单人分身到团队协作

五步完成第一次团队协作。桌面版 v1.0.40 起支持本文全部单人能力; 团队空间与共享会话为内测能力,需邀请开通。

Step 1

安装桌面版

下载对应平台的安装包(macOS 13+ / Windows 10+)。首次打开按引导完成授权。

# 安装后验证版本
小澄菜单 → 关于 → 版本应为 1.0.40

Step 2

把一个项目交给分身

在「工作」页选择本地项目目录,用一句话交代目标。分身会理解上下文、 制定计划、编辑文件并运行验证;所有变更以 Diff 呈现,由你审阅。

目标示例:修复登录页在 Safari 白屏的问题,
先复现,再定位,改动最小化,附测试。

Step 3

创建团队空间并邀请成员(内测)

团队空间是独立的协作边界:成员、项目、知识与权限都在空间内,与你的私人数据隔离。

# 创建空间
POST /api/v1/workspaces        { "name": "我的团队" }

# 生成邀请(token 只返回一次,默认 72 小时有效)
POST /api/v1/workspaces/:id/invitations  { "role": "member" }

# 对方接受
POST /api/v1/invitations/:token/accept

Step 4

进入共享会话

共享会话里所有人看到相同的事件流。建议人人可发;指令只有控制权持有者能发—— 控制权转移时旧持有者的指令会被拒绝,不会互相覆盖。

# 创建共享会话
POST /api/v1/workspaces/:id/sessions  { "title": "新版官网发布" }

# 取得控制权(一次只有一个有效持有者)
POST /api/v1/sessions/:id/control/acquire

# 发指令(需要控制权)与提建议(人人可发)
POST /api/v1/sessions/:id/commands  { "kind": "instruction", ... }
POST /api/v1/sessions/:id/commands  { "kind": "suggestion", ... }

Step 5

交接给同伴

交接摘要从真实执行历史自动生成(含事件引用),接收人接受后控制权原子转移。 拒绝则原持有者继续——双方都不会悬空。

# 发起交接(摘要底稿自动生成,可编辑补充)
POST /api/v1/sessions/:id/handoffs  { "toUserId": "..." }

# 对方接受或拒绝
POST /api/v1/handoffs/:id/accept
POST /api/v1/handoffs/:id/decline

常见问题

团队数据和我私人的数据会混吗?
不会。空间成员只能看到被授权的项目;你的私人项目、记忆、凭据与本地路径不随项目迁移。

两个人同时指挥会怎样?
一次只有一个有效控制权。并发申请只有一人成功,另一人拿到当前持有者信息; 转移后旧持有者的指令会被明确拒绝。

交接后原来的任务还在跑吗?
在。交接转移的是控制权(谁决定方向),不重启也不中断执行。

深入共享会话(建议/控制权/交接的正确用法)见 共享会话指南。 版本说明见 更新记录;团队协作详情见 产品页。

macOS (Apple Silicon)macOS (Intel)Windows x64iOSAndroid