源码系统概览
文章正文
Orca是一款面向并行Agent开发环境的开源项目（ADE，Agent Development Environment），定位是AI编程代理的编排与调度中心。
它让开发者可以在一个桌面应用中同时启动Codex、Claude Code、Pi等多个编码Agent，每个Agent在独立的git worktree中并行运行、互不干扰，最终对比结果合并最优方案。
项目同时提供桌面端、移动端和VPS部署方式，移动端App可随时监控Agent进度并下发指令。
源码简介
Orca将「并行、隔离、可审查」作为核心设计目标。
Parallel Worktrees机制把同一个需求分发给多个Agent，各自在独立工作树中执行，避免相互污染；
SSH Worktrees支持把Agent放到远程高性能机器上运行，并具备自动重连与端口转发能力。桌面端提供Ghostty-class终端分屏、Design Mode真实浏览器设计模式与AI Diff批注审查，开发者可以直接在diff行上评论并发回给Agent修改。
项目配套Orca CLI命令行工具与Mobile Companion手机App，CLI支持用脚本驱动Orca自动完成工作流，手机端可接收Agent完成通知、查看终端输出并发送后续指令。
原生集成GitHub与Linear，应用内即可浏览PR与Issue，并可从任务一键开出worktree。
适用场景
适合手头有较多API订阅额度、希望最大化利用算力的开发者；
习惯多线程工作、需要同时对比多个AI方案的高级开发人员；
需要审查AI代码并在diff上直接打回修改的团队负责人；
喜欢远程开发、想在VPS上跑Agent但需要图形界面的用户；
以及移动端重度用户，希望随时监控Agent进度并下发指令。
对追求极致工作流自动化、想把UI交互直接喂给Agent的极客，Orca的CLI与Design Mode也提供了充足的自动化接口。
技术架构与部署指南
| 维度 | 本套源码 | 同类通用方案 |
|---|---|---|
| 技术栈 | Orca是一个TypeScript单体仓库（monorepo），桌面端基于Electron与React构建，render | 依具体方案选型，需自行搭建与维护 |
| 部署方式 | 桌面版可在官网下载macOS、Windows与Linux安装包； | 多托管于第三方平台或订阅云服务 |
| 功能侧重 | Parallel Worktrees并行工作树：
一个需求分发给多个Agent，各自在独立git worktree |
功能通用，定制深度有限 |
| 数据归属 | 数据自持，部署在自有服务器，不出站 | 数据通常留存于服务商侧 |
| 成本模式 | 获取后自主部署，无持续授权费用 | 通常按订阅或调用量计费 |
技术栈与运行环境
Orca是一个TypeScript单体仓库（monorepo），桌面端基于Electron与React构建，renderer负责界面渲染，main进程负责终端与会话调度；
移动端使用React Native（Expo）实现，包含host/worktree/session/diff review等多级页面。
源码中包含ssh2、node-pty、xterm等终端与远程连接依赖，仓库节点规模约8万代码节点、31万调用边。
运行环境要求Node.js 22+与pnpm，桌面端支持macOS、Windows与Linux；
移动端需要Expo Go或开发客户端，桌面与手机处于同一局域网时可通过WebSocket RPC（端口6768）联通。
VPS部署使用orca serve启动服务端。
功能亮点
Parallel Worktrees并行工作树：
一个需求分发给多个Agent，各自在独立git worktree中运行，互不污染，可对比结果合并最优解。
代码中createManagedWorktree/removeManagedWorktree等模块负责工作树的创建、管理与回收。
SSH远程工作树：支持在远程高性能机器上运行Agent，具备自动重连与端口转发能力，ssh-pty-source-delivery-ledger等模块管理远程PTY会话的交付。
Design Mode设计模式：在真实Chromium窗口中点击UI元素，可直接把HTML、CSS与截图喂给Agent，实现从页面元素到代码的闭环。
AI Diff批注审查：在diff行上直接评论并发回给Agent修改，无需离开Orca；拖拽文件或图片可直接进入Agent提示词，支持全局自动保存。
Mobile Companion移动伴生App：手机端接收Agent完成通知、查看终端输出并发送后续指令；
Orca CLI可被Agent驱动，用脚本自动化所有工作流。原生集成GitHub与Linear，应用内浏览PR、Issue，一键从任务开出worktree。
安装与部署提示
桌面版可在官网下载macOS、Windows与Linux安装包；
Linux服务器可通过orca serve运行服务端。开发环境本地构建：pnpm install安装依赖后执行pnpm dev启动桌面端，确认移动RPC服务在端口6768监听后，从mobile目录启动Expo即可在手机或模拟器上运行移动端。
截图与演示说明
为Orca应用图标；
为桌面端主界面演示，展示多个Agent在并行工作树中运行的场景，右上角可见移动伴生App；
为Mobile Companion移动端界面；
为Parallel Worktrees并行工作树编排示意；
为终端分屏界面；
为Design Mode内嵌浏览器设计模式演示；
为GitHub与Linear任务工作流界面；
为SSH远程工作树演示。
常见问题
问：Orca需要单独的API Key吗？
答：Orca本身不绑定模型服务，运行的是你自己订阅的Codex、Claude Code、Pi等编码Agent，模型调用走各Agent自身配置的API Key或订阅额度。
问：Parallel Worktrees会不会污染主仓库？
答：每个Agent运行在独立git worktree中，分支与文件互不干扰，审查通过后可将选定工作树的改动合并回主分支，避免多Agent同时写同一分支产生冲突。
安全风险提示
并行运行多个Agent会同时消耗多路API额度，成本随并发数线性上升，建议先在单个Agent上验证任务方案。源码包含telemetry遥测模块（匿名安装ID），如需完全离线使用请关注遥测开关。运行远程Agent时涉及SSH凭据与端口转发，请妥善保管密钥并限制远程主机权限。项目处于快速迭代期，接口与配置格式可能随版本变化。
下载说明
本项目为开源代码，仅供学习研究、测试部署与二次开发参考。源码来自GitHub公开仓库，使用前请确认符合MIT协议相关条款。
GitHub项目开源地址：https://github.com/stablyai/orca