用途
plan-collab 用于让智能体与人实时协作编辑同一份 Markdown 计划。计划以 Artifact 形式存在于浏览器中，由人直接编辑，智能体通过本地 archdev plan collab start 启动的 seat 进程加入 Artifact 频道作为代理角色，并接收转发给它的信号。计划只存放在 Artifact 中，不会写入磁盘，种子文件仅作为初始草稿。
主要能力
- 启动 seat：
archdev plan collab start --file plan.md [--handle plan.collab.json] [--artifact <id>] [--agent <id>] [--model @alias]，输出包含页面 URL 的 started 事件后持续运行。 - 信号循环：
archdev plan collab signals --handle ...逐条等待、打印并确认信号，支持通过--input发送回复。 - 幽灵补全：收到 complete.request 后，用
complete返回插入位置与候选文本；带--model @alias时由 seat 自行应答。 - 选区提问：对 ask.request 用
suggest生成 CriticMarkup 建议（替换、插入、删除），再用 agent.reply 清除提示。 - 智能体任务：对 agent.request 读取、修改计划，可逐条建议或整段 apply，并以 run.status 汇报进度和写入范围。
- 任务拆解：计划批准后，针对 plan.tasks.request 返回 plan.tasks.result 形式的任务草稿，含 key、title、risk、area、dependsOn。
- 运行撤销：收到 run.undo 时逆转该次运行写入的内容，并以 undone、reviewed 状态回报。
使用方式
所有命令需已登录用户会话。seat 每份计划一个进程，需在工作期间保持运行；句柄文件默认位于种子文件旁，包含回环端口和能力令牌，不可打印、提交或分享，seat 退出时删除。位置按 Unicode 码点计算；revision 会过期，apply、suggest、complete 必须使用当前 revision，过期需重新 read 并重算位置。编辑会取消待处理的补全请求。所有命令每行输出一个 JSON 对象，以 CLI 的 --help 为准。
适用场景
适合需要人与智能体围绕同一份 Markdown 计划实时互动的工作流：边想边改计划、对选区请求改写建议、让智能体执行计划内任务、批准后拆解为任务图，以及对智能体写入内容进行审阅和撤销。
限制
依赖 archdev 与已登录会话及本地 seat 进程；计划不落盘，种子文件修改不影响计划；建议不能落在代码围栏内或与待处理标记重叠，文本中不能包含 CriticMarkup 标记序列；幽灵补全易被下一次按键取消，单命令串行处理常来不及应答；计划批准后到重新打开前禁止编辑。