协作命令参考

collaborate 是适合手动操作的引导入口，collaboration 则提供可脚本化的完整控制命令。协作由后台服务持续管理，参与者可以分布在不同可信设备和工作区。下文中的“运行”指一次具体协作任务，不是当前终端窗口；“草稿”指尚未创建运行的已保存计划。

创建方式

脚本示例：

originrouter collaboration create \
  --objective "Audit the release and prepare fixes" \
  --participant planner:codex:studio-mac:/work/app \
  --participant reviewer:claude:linux-ci:/srv/app \
  --role "planner=inspect, implement, and coordinate" \
  --role "reviewer=independently verify risk and tests" \
  --permission planner=workspace-write \
  --permission reviewer=read-only \
  --concurrency 2 \
  --token-limit 180000 \
  --yes

创建参数

查找和检查

跟进和控制

attach <run-id> 持续跟进这次运行。--plain 适合日志，--verbose 或 --raw 增加细节，--participant 和 --task 用于过滤。

完整控制命令：confirm、revise --feedback、pause、resume、retry [--task]、cancel、archive 和 delete --yes。永久删除在非交互环境必须显式传入 --yes。

当一次运行暂停并等待你决定（例如批准操作、补充信息或解除阻断）时，先运行 attention <run-id> 查看待处理事项，再使用：

originrouter collaboration resolve <run-id> <attention-id> \
  --action <action> \
  --text "optional reply"

状态与恢复

典型流程包括配置、等待规划确认、运行、暂停或处理待确认事项，最终进入完成、失败、取消或预算耗尽状态。一次运行的状态不得仅依据终端连接是否中断来判断。

• 本地服务不可用：service status，必要时 service restart。
• 设备或中继服务不可用：运行 collaboration doctor，再决定重试或等待。
• 能力、运行环境、模型服务或路由不匹配：在目标设备运行 doctor 并修复智能体路由。
• 预算或策略阻止：检查这次运行、设备和智能体预算，再 resume 或 retry。
• 规划或配置仍需确认：交互确认；只有在明确希望自动接受两道启动确认时才使用 --yes。

自动化脚本应同时检查 JSON 中的 state、diagnostic_code 和进程退出状态。详见退出状态与错误恢复。