Orca 并行 Agent 编排详解：项目定位、核心功能与安装实践（基于仓库日文 README）

Orca 并行 Agent 编排详解项目定位、核心功能与安装实践基于仓库日文 README【免费下载链接】orcaOrca is the ADE for working with a fleet of parallel agents. Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.项目地址: https://gitcode.com/GitHub_Trending/orca48/orcaOrca 是一个面向「并行 AI 编码 Agent 编排」的桌面级开发环境ADE本篇文章以仓库内 docs/readme/README.ja.md日文 README为主线结合仓库源码梳理其产品定位、九大核心功能、兼容的 Agent 生态、多平台安装方式与本地开发流程。读完本文你将掌握 Orca 的完整能力地图知道它在并行工作树、终端、浏览器、代码评审、SSH 远程与移动端配套等场景下各自解决了什么问题并能在 macOS / Windows / Linux / 移动端正确安装与使用它。Orca 是什么为 100x 构建者而生的 AI 编排器在日文 README 的定位描述中Orca 是「100x ビルダーのための AI オーケストレーター」面向 100x 构建者的 AI 编排器。它的核心思路不是再发明一个编码 Agent而是把多个现成的 CLI 编码 Agent并行组织起来Codex、Claude Code、OpenCode、Pi 等可以被并排运行每一个都拥有专属的 git 工作树worktree并且所有执行过程都能在同一个界面中集中追踪。仓库根目录的 package.json 将自己的描述写为 “Next-gen IDE for parallel agentic development”面向并行 Agent 开发的下一代 IDE与 README 的定位互相印证。从仓库结构与bin字段看Orca 是一个典型的 Electron TypeScript 工程入口为./out/cli/index.js的orcaCLI 与./out/main/index.js的桌面主进程同时包含mobile/移动端 Expo / React Native 应用、cloud/relay 等云端组件与src/cli、src/main、src/renderer等分层目录覆盖「桌面 移动 远程运行时」三种载体。在 GitHub 项目信息层面Orca 以 MIT License 开源见仓库根目录 LICENSE支持 macOS、Windows、Linux 三平台。核心功能逐项拆解README 以特性墙feature wall表格的形式列出了九项旗舰能力。下面逐项展开并结合仓库源码给出可实现性的佐证。1. 移动端 Companion在手机上监视与操作 Agent手机端 companion 应用用于与桌面应用配对让你在离开电脑时依然能监控 Agent 状态Agent 完成时会收到通知并可从任何地方发送 follow-up 继续推进任务。README 给出了 iOS App Store 与 Android APK 两种获取渠道。仓库中对应的移动端实现位于 mobile/ 目录是一个基于 Expo / React Native 的工程包含完整的业务页面mobile/app/index.tsx首页、mobile/app/terminal-settings.tsx终端设置、mobile/app/notifications.tsx通知、mobile/app/pair.tsx配对等十余个屏幕并有src/terminal/、src/agent-history/、src/session/等共享逻辑模块。这也从源码层面佐证了「桌面主应用 移动端通过配对进行远控」的产品形态。2. 并行工作树Parallel Worktrees一个 Prompt 打向多个 Agent这是 Orca 最具辨识度的能力把一个 Prompt 展开到 5 个 Agent 上让它们分别在相互独立的 git 工作树中执行随后对比各自的产出把最优结果合并回主分支。该能力不仅存在于 README 介绍中还完整落地在 CLI 与测试里CLI 提供完整的 worktree 管理命令组见 src/cli/root-help-text-primary.ts 的 “Worktrees” 段worktree list / show / current / create / set / rm / ps其中worktree ps输出跨工作树的紧凑编排摘要对应处理器实现位于 src/cli/handlers/worktree.ts并配套有index-worktree-create-parent.test.ts、index-worktree-create-agent.test.ts等测试覆盖「以父提交创建」与「面向 Agent 创建」等不同路径仓库还专门提供了并行工作树特性演示图。把任务扇出到多棵工作树再由人工或编排逻辑挑选最佳方案合并这比单 Agent 串行试错更能压缩探索时间——代价是需要对并发 git 工作树做可靠的状态管理这正是 Orca 编排器的价值所在。3. 终端分割WebGL 渲染 无限分割 持久滚动缓冲README 将内置终端描述为具备WebGL 渲染、无限分割unlimited splits、重启后依然保留的滚动缓冲scrollback的 Ghostty 级别终端。这一描述在依赖层面有充分证据package.json 的devDependencies中直接依赖xterm/xterm6.1.0-beta.303、xterm/addon-webglGPU 渲染、xterm/addon-serialize用于持久化/序列化终端内容、xterm/addon-search、xterm/addon-ligatures、xterm/addon-unicode11与xterm/addon-web-links运行时依赖里包含node-pty并在config/patches/、config/relay-assets/中维护了针对 xterm 与 node-pty 的定制补丁如xterm__addon-serialize、node-pty-1.1.0-*系列CLI 侧同样暴露了完整的终端编排命令terminal create / split / switch / read / send / wait见 src/cli/root-help-text-primary.ts说明「分割」「多 Tab」「等待某个终端条件」都是可脚本化的头等公民。「重启后保留滚动缓冲」与xterm/addon-serialize的存在相吻合——通过序列化把终端内容持久化供下次启动时恢复。4. 设计模式Design Mode把点击变成 Agent 的输入面对「需要真实 UI 操作才能完成」的前端任务Orca 内置真实 Chromium 窗口的设计模式点击页面上的任意 UI 元素后该元素的HTML、CSS、裁切后的截图会直接被注入到 Agent 的 Prompt 里从而让模型基于真实 DOM 结构而不是猜测来修改样式或布局。仓库中对应能力的证据链同样清晰主进程侧存在庞大的浏览器模块目录 src/main/browser/CLI 提供一整套浏览器自动化原语位于 src/cli/root-help-text-primary.ts 的 “Browser Automation” 段snapshot带元素引用如e1、e2的可访问性快照、goto、click、fill、type、select、hover、keypress、scroll、screenshot、eval、wait、check等config/oxlint-plugins/mobile-pairing-qrcode-import.mjs、tests/e2e中大量浏览器用例的存在说明浏览器与会话交互是经过端到端测试保障的模块。简单来说设计模式是「浏览器自动化原语 DOM 信息抽取 Agent 提示词注入」三者的产品化封装。5. GitHub 与 Linear 的原生集成README 强调在应用内即可浏览 PR、Issue 与项目看板并且可以从任意任务直接打开工作树开始干活、在不切换上下文的情况下完成评审。这在仓库中有大块的一等公民实现主进程目录下存在独立的 src/main/github/、src/main/linear/ 模块分别约 198 与 62 个文件CLI 侧也提供linear命令读取 Linear ticket 上下文供 Agent 使用、linear-save-issue、linear-list-issues等处理器见 src/cli/handlers/ 目录。src/main/linear/ 内部还按任务linear-save-issue-request与查询linear-list-issues拆分了职责反映了「任务类型驱动 拉取远端数据」的架构取向。6. SSH 工作树把 Agent 放到更强的远程机器上跑当本地算力不够时Orca 支持把 Agent 调度到强力的远程机器上执行并且远程环境下依然拥有完整的文件编辑、git、终端能力还附带自动重连与端口转发。仓库侧依据package.json 运行时依赖包含ssh2这是底层 SSH 通道实现主进程存在庞大的 src/main/ssh/ 模块约 316 个 TS 文件并有 cloud/docs/relay-workflows.md、cloud/docs/orca-relay-operations.md 等运维文档说明远程链路还涉及云端 relay 的编排CLI 中environment add / list / show / rm通过配对码保存远程 Orca runtime以及host list等命令正是「把远程主机登记为可执行目标」的操作入口。7. AI Diff 注Annotate把评审意见送回 Agent在 AI 生成的 diff 上逐行批注并直接发回给对应的 Agent让模型针对具体行反馈做出修改评审、修改、提交都无需离开 Orca。对应实现证据仓库中存在src/main/github、src/renderer下的评审相关组件例如src/renderer/src/components/editor/combined-diff/中的评审批注与 diff 分节加载注册逻辑配置里也能看到combine-diff相关的评审控件CLI 侧则有file diff在工作区编辑器打开文件 diff等命令。整体构成「diff 查看 → 行级批注 → 回传 Agent → 迭代修改 → 提交」的闭环。8. 把文件拖进 Prompt自带编辑器的工作流粘合内置编辑器以默认全开自动保存autosave的方式工作README 称之为“全面オートセーブが効く VS Code エディタ”你可以把文件甚至图片直接拖进 Agent 的 Prompt 输入框让上下文携带真实产物。从技术栈看仓库在编辑能力上投入很重package.json 中包含了monaco-editor编辑器内核、monaco-editor/react以及一整套tiptap/*富文本/Markdown 渲染、rehype-*/remark-*Markdown 处理管线、mermaid、katex等文档预览能力支撑「把文件内容高质量地呈现给人和 Agent」。9. Orca CLI让 Agent 自己操作 OrcaOrca 把自身完全暴露为 CLI意味着Agent而非只有人类可以反过来驱动 Orca。README 点名的四个命令为orca worktree create、snapshot、click、fill可在 src/cli/root-help-text-primary.ts 的 Browser Automation 段看到snapshot / click / fill的真实参数形态例如click按--element引用点击、fill按--element清空并填入--value。这样 Agent 就能自己创建工作树、开浏览器、操作页面把任意工作流脚本化。其他同捆能力除九大旗舰特性外README 还列出了一批**同捆同梱**能力一并归纳如下能力说明仓库佐证快速打开Quick Open不离开当前流程横向检索工作树、文件、Agent、命令与仓库上下文src/renderer下的全局搜索与快速打开 UI 体系账户切换与用量追踪查看 Claude / Codex 使用量与速率限制重置时间无需重新登录即可切换账户src/main/claude-accounts/、src/main/codex-accounts/、claude-usage、codex-usage、rate-limits模块富仓库预览在工作区内直接预览 Markdown、图片、PDF 与仓库文档monaco-editor、pdfjs-dist、tiptap/*、remark-*渲染栈Computer Use需要真实操作的工作流中让 Agent 操作桌面应用与屏幕 UIsrc/cli/root-help-text-primary.ts “Computer Use” 段 17 个子命令click / scroll / drag / type-text / hotkey / paste-text / set-value等通知与未读状态第一时间获知 Agent 完成或需人工介入可将线程标为未读稍后处理mobile/app/notifications.tsx 与桌面通知体系持续交付节奏几乎每日发布新版本README 自述“此列表永远追不上真实功能”完整清单以 changelog 为准package.json的build:*发布脚本链与Casks/orca.rb的版本管理兼容的 Agent 生态任何 CLI AgentREADME 用一句话概括兼容性「あらゆる CLI エージェント」——只要能在终端里跑就能在 Orca 里跑因为 Orca 编排的本质上就是“终端里可执行的命令行程序 每棵工作树 状态追踪”。README 列出的实测/预置支持清单相当长Claude Code、Codex、Grok、Cursor、GitHub Copilot、OpenCode、Amp、OpenClaude、Antigravity、Pi、oh-my-pi、Hermes Agent、Goose、Auggie、Autohand Code、Charm、Cline、Codebuff、Command Code、Continue、Droid、Kilocode、Kimi、Kiro、Mistral Vibe、Qwen Code、Rovo Dev以及“ any CLI agent”。仓库主进程中存在与这些 Provider 一一对应的目录与账户管理模块例如 src/main/claude/、src/main/codex/、src/main/opencode/、src/main/cursor/、src/main/copilot/、src/main/openclaude/、src/main/grok/ 等从源码结构看每个 Agent 的接入都被抽象成「账户体系 使用量计量 会话运行」的组合这解释了为何新增 Agent 主要是配置层面而非架构层面的工作。安装与运行桌面端macOS / Windows / Linux官网直接下载访问 onOrca.dev 的下载页可获取各平台构建发行版构建直链macOS Apple Silicondmg、macOS Inteldmg、Windows.exe、LinuxAppImage包管理器安装# macOSHomebrew Cask brew install --cask stablyai/orca/orca # Arch LinuxAUR—— 或使用 stably-orca-git 从源码构建 yay -S stably-orca-bin仓库内 Casks/orca.rb 保存了 Homebrew cask 的完整定义值得注意的几个工程细节使用arch arm: arm64, intel: x64区分 Apple Silicon 与 Intel 构建并从 GitHub Releases 拉取orca-macos-arch.dmgauto_updates true表示应用内更新electron-updater自行负责把新版 Orca.app 写入 /ApplicationsHomebrew 不应与它竞争注释中明确解释了这一取舍conflicts_with cask: orcarc说明正式版与 RC 版Casks/orcarc.rb互斥安装depends_on macos: :big_sur给出最低系统版本为 Big Surcask 会把应用内自带的orcaCLI位于Orca.app/Contents/Resources/bin/orca符号链接到 Homebrew 的 bin 目录使无头headless服务器场景下也能在 shell 中直接调用orca servezap清理列表覆盖~/.orca工作树与 Agent 状态所在与各类 Electron 用户数据目录保证brew uninstall --zap能彻底还原环境。移动端 CompanioniOS / Android移动端需要与桌面应用**配对pairing**后方可使用iOS从 App Store 安装Android直接安装官方 APK。仓库内 mobile/ 即是移动端源码工程mobile/app/pair.tsx、mobile/app/pair-scan.tsx、mobile/app/pair-confirm.tsx 三屏对应着扫码-确认的配对交互流程此外还有mobile/app/browser-settings.tsx、mobile/app/terminal-settings.tsx、mobile/app/voice-settings.tsx等说明移动端不只是“看板”还具备远程终端、浏览器与语音等操作能力。从源码构建与本地开发如果要在本地运行开发版可参考仓库根 package.json 提供的脚本注意其要求node24与pnpm12pnpm install # 安装依赖postinstall 会重建 node-pty 等原生依赖 pnpm run dev # 启动 Electron 开发模式先确保 electron 原生运行时就绪 pnpm run dev:web # 仅启动 Web 渲染端vite完整的桌面端构建链是pnpm run build:desktoptypecheck → build relay → build cli → build electron-vite → 校验内置 skill → build web再加pnpm run build:native即得到全量pnpm run build平台专属打包则由build:mac/build:win/build:linux负责走 config/electron-builder.config.cjs 配置。仓库内置了大量测试与基准脚本pnpm test、test:e2e:*、bench:*适合希望深入贡献或自行定制构建的读者。社区、支持与隐私README 同时说明了项目周边的支持渠道官方 Discord 社区与 Xorca_build用于同步更新与公告功能缺失或改进建议可提交 Feature Request项目迭代节奏很快README 自述“每天都在发版”隐私方面Orca 会收集匿名使用数据官方提供「隐私与遥测telemetry」文档说明数据范围与**退出opt-out**方式若喜欢该项目可为其点 Star 以便跟踪每日发布。开发与许可想参与贡献或在本地运行可参考仓库根目录的 CONTRIBUTING 指南。Orca 以MIT License开源见 LICENSE即免费且允许自由使用与二次开发。小结综合日文 README 与仓库源码可以看到Orca 的本质是把“并行 Agent 编排”做成一个完整 IDE 体验——用 git 工作树隔离并行探索的副作用用终端/浏览器/编辑器/评审界面承接 Agent 的输入与产出用移动端与 SSH 打通“随时随地”的使用边界再通过orcaCLI 把这些能力全部脚本化让 Agent 本身也能参与编排。对正在从“单 Agent 试用”走向“多 Agent 并行工作流”的开发者而言Orca 提供了一条降低编排复杂度的可行路径。【免费下载链接】orcaOrca is the ADE for working with a fleet of parallel agents. Run any coding agent with your own subscription. Available on desktop, mobile and remote runtime.项目地址: https://gitcode.com/GitHub_Trending/orca48/orca创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考