Orca：协调编码代理，同时保留清楚的工作记录
Orca 架构：工作区、远端主机和 relay cell
分别理解本地任务、无界面访问与手机中继，不假设所有连接都走同一条路径。
Orca 架构：工作区、远端主机和 relay cell知识学习CN编辑简报更新 2026-09-18
你将学会
- 文件位置与执行主机
- 手机 relay 有独立组件
- 推送不是中继数据路径
开始前需要
- 基本命令行与配置阅读能力
- 能够在独立且获准的环境中试验
记录主机、工作树和验收证据，不自动合并分支，也不删除尚未审阅的工作。
先看结论
- 没有主机的路径可能歧义。
- relay 使用独立工作区。
- 推送与中继是不同路径。
文件位置与执行主机
worktree 组织检出状态，终端运行代理或 shell；远端工作时，文件和进程可能位于另一台主机。记录工作树路径时同时写执行主机，避免查看了同名但错误的目录。
无界面指南提供明确的 ready 输出，其中绑定地址用于运维安全判断，公布地址用于客户端可达性。两者承担不同职责，不能因为字符串相似就合并为一个状态。
手机 relay 有独立组件
cloud README 描述手机与桌面分别建立到 relay cell 的出站 WebSocket，director 分配主机并协调迁移，cell 承载连接。这描述中继路径，不代表全部直连或 SSH 路径。
cloud/ 是独立 pnpm 工作区，包含中继协议、服务和运维组件。构建桌面根包并不意味着已经部署私人 relay，后者有自己的配置和运行要求。
推送不是中继数据路径
同一文档将手机 push gateway 与 relay 分开，前者通过 APNs、FCM 发送通知。手机出现横幅不等于交互式中继会话健康，也不能证明底层任务已经成功。
README 提醒了离线 FCM 通知的交付限制，因此应分别监控执行、连接和通知。本次只检查文档分解，没有审计加密实现或执行真实手机推送测试。
如何选择
| 比较维度 | 方案 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
区分 relay 与直连运行时端点。
- 3
独立跟踪推送交付。
可复制示例
text
任务 → 指定主机的 worktree 与终端
手机 / 桌面 → relay cell ← director
桌面 → push gateway → APNs / FCM常见问题
收到通知说明任务成功吗？
它只是通知事件，仍需查看任务结果。
构建桌面就部署 relay 了吗？
没有，中继有独立工作区和设置。
资料来源
- Orca / README.md来源核查 2026-09-18
- Orca / docs/reference/headless-linux-server.md来源核查 2026-09-18
- Orca / cloud/README.md来源核查 2026-09-18