Orca：协调编码代理，同时保留清楚的工作记录
实践：制作只读 Orca 任务台账
记录主机、工作树和验收证据，不自动合并分支，也不删除尚未审阅的工作。
实践：制作只读 Orca 任务台账知识学习CN编辑简报更新 2026-09-18
你将学会
- 进度之前先确定身份
- 处理不完整观察
- 验收学习效果
开始前需要
- 基本命令行与配置阅读能力
- 能够在独立且获准的环境中试验
记录主机、工作树和验收证据，不自动合并分支，也不删除尚未审阅的工作。
先看结论
- 路径需要关联主机身份。
- 验收需要代理状态以外的证据。
- 初版台账应保持只读。
进度之前先确定身份
为每个虚构任务分配标识，记录主机、worktree 路径、分支和预期输出。本地与远端使用相似目录名时，只有路径会产生歧义，必须带上执行主机。
把代理报告完成与人工接受分开，接受前附脱敏 diff 引用和检查结果。这个练习让读者理解，绿色代理状态不等于代码已经通过集成验收。
处理不完整观察
明确显示断开、等待审阅和未知状态。连接丢失不应自动变成代码修改成功或失败，保留最后观察时间，告诉读者哪些信息仍然缺失。
第一版使用只读 Git 检查或虚构夹具，不允许台账合并分支、删除 worktree 或重启远端运行时。这些行为都需要额外授权与恢复设计。
验收学习效果
覆盖两台主机的同名目录、未提交 diff、失败检查和断开的会话。界面必须明确定位哪份工作，并说明还缺少什么证据，才能算通过学习目标。
任务表和小型主机关系图已经足够。这是独立练习，不声称 Orca 已提供该数据结构，也不把建议写成维护者承诺的未来功能。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
记录主机、工作树和预期输出。
- 2
区分代理完成与人工接受。
- 3
测试歧义路径和缺失观察。
可复制示例
json
{
"proposal": true,
"readOnly": true,
"host": "demo-host",
"worktree": "demo-path",
"agentComplete": false,
"humanAccepted": false,
"lastObservedAt": null
}常见问题
台账可以自动合并吗？
不在本次只读练习范围内。
数据结构属于 Orca 官方吗？
不是，是独立学习格式建议。
资料来源
- Orca / README.md来源核查 2026-09-18
- Orca / docs/reference/headless-linux-server.md来源核查 2026-09-18