Orca Internals把并行 Agent IDE 拆到运行时底层

从 Electron 进程边界、PTY 数据流和 Agent Hooks，一路读到 SSH、编排、移动端与插件安全模型。

🧭

沿真实执行链阅读

不按目录复述代码，从“创建工作区并启动 Agent”这条主链追踪 renderer、IPC、runtime、PTY provider 与持久化。

🧱

分清 Project、Repo、Host Setup、Workspace、Worktree、Tab、Leaf、Pane Key 和 PTY，后续细节才不会失去坐标。

⚙️

重点解释终端快照、隐藏输出恢复、幂等创建、跨主机所有权、断线重连、版本兼容与失效关闭。

🤖

Orca 不实现一个统一 Agent Loop，而是托管多种 CLI Agent；文档分析它如何统一启动、状态、会话恢复与子 Agent 拓扑。

🌐

Electron 桌面端之外，还包括 headless runtime、SSH relay、CLI、WebSocket RPC、React Native 移动端和插件 worker。

🔍

关键判断都附上游文件路径、核心类型、时序图和设计取舍，适合边读文档边做源码调试。

分析基准：本教程基于本地 orca-main 快照的 package.json 版本 1.4.163，分析日期为 2026-08-01。上游 main 持续变化，链接用于定位模块，具体行号应以该版本快照为准。

Pi 的核心问题是“一个 Agent 如何循环思考与行动”；Orca 的核心问题完全不同：怎样把许多彼此不兼容的 Agent CLI，变成可并行、可恢复、可远程操控、可被桌面和手机共同观察的工程工作台？

因此真正值得拆解的不是某个模型调用，而是四类“所有权”：