从单人分身到团队协作
五步完成第一次团队协作。桌面版 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/acceptStep 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常见问题
团队数据和我私人的数据会混吗?
不会。空间成员只能看到被授权的项目;你的私人项目、记忆、凭据与本地路径不随项目迁移。
两个人同时指挥会怎样?
一次只有一个有效控制权。并发申请只有一人成功,另一人拿到当前持有者信息; 转移后旧持有者的指令会被明确拒绝。
交接后原来的任务还在跑吗?
在。交接转移的是控制权(谁决定方向),不重启也不中断执行。