stablyai/orca · 上手攻略
- 仓库：stablyai/orca
- 链接：https://github.com/stablyai/orca
- 分类：ai
- 作者：Tom
- 更新：2026-07-22
是什么
Orca 是一个专为并行多 Agent 协作设计的 AI IDE（集成开发环境），让你可以在同一个界面里同时运行多个 AI 编程 Agent（Codex、Claude Code、OpenCode、Cursor 等），每个 Agent 运行在独立的 git worktree 中，结果集中管理、按需对比合并。它本质上是一个"Agent 调度台"——不是替代你的 Agent，而是让 Agent 们并行作战、受你统一指挥。
桌面端支持 macOS（Apple Silicon / Intel）、Windows、Linux（含 AppImage），另有 iOS App 和 Android APK 实现移动端监控。
解决什么问题
- 单 Agent 能力有限：一个任务让 5 个不同 Agent 同时做，对比结果取最优——Orca 的 Parallel Worktrees 功能将此工程化。
- Agent 之间无法协作：每个 Agent 在独立 worktree 中运行，git 分支隔离，不会互相覆盖代码。
- 监控全靠 Terminal 标签页：Orca 用 Terminal Splits（WebGL 渲染）替代割裂的终端窗口，支持无限分屏和持久化回滚历史。
- 代码审查上下文丢失：GitHub PR / Linear 任务直接在 App 内浏览，开 worktree 写代码，review 不用切工具。
- 移动端无法干预：iOS/Android App 让你实时监控 Agent 进度、发送 follow-up 指令，不在电脑前也能 steering。
快速安装
桌面端
方式一：直接下载安装包
| 平台 | 下载地址 |
|---|---|
| macOS Apple Silicon | orca-macos-arm64.dmg |
| macOS Intel | orca-macos-x64.dmg |
| Windows | orca-windows-setup.exe |
| Linux AppImage | orca-linux.AppImage |
方式二：Homebrew（macOS）
brew install --cask stablyai/orca/orca
方式三：Arch Linux AUR
yay -S stably-orca-bin # 预编译二进制
# 或
yay -S stably-orca-git # 从源码构建
Linux 无头服务器：参考 headless Linux server guide。
移动端
| 平台 | 获取方式 |
|---|---|
| iOS | App Store 或 TestFlight |
| Android | APK v0.0.31 |
Agent 依赖
Orca 本身不包含 Agent，需要另行安装。Orca 支持任何 CLI Agent（只要它能跑在终端里），包括但不限于：
Claude Code、Codex、Grok、Cursor CLI、GitHub Copilot CLI、OpenCode、MiMo Code、Amp、OpenClaude、Antigravity、Pi、oh-my-pi、Hermes Agent、Devin、Goose、Auggie、Autohand Code、Cline、Continue、Droid、Kilocode、Kimi Code、Kiro、Mistral Vibe、Qwen Code、Rovo Dev……以及任何 CLI Agent。
核心用法
1. Parallel Worktrees（并行 Agent 测试）
核心功能：一个 prompt 同时发给 N 个 Agent，各自独立写代码，对比结果合并。
orca worktree create <task-description> # 创建并行 worktree 任务
orca worktree compare <task-id> # 对比多个分支结果
orca worktree merge <winner-branch> # 合并最优分支
文档：https://www.onorca.dev/docs/model/worktrees
2. 终端分屏（Terminal Splits）
WebGL 渲染，支持无限分屏、split 历史持久化（重启不丢）。
# 快捷键操作
Ctrl+Shift+T # 新建分屏
Ctrl+Shift+W # 关闭当前分屏
Ctrl+Shift+Arrow # 切换分屏焦点
文档：https://www.onorca.dev/docs/terminal
3. Design Mode（UI 设计协作）
点击任意网页 UI 元素，Orca 自动提取其 HTML/CSS + 截图截取，发送给 Agent 指导还原。
# Design Mode 操作：点击页面元素 → Agent 收到截图 + 代码片段
文档：https://www.onorca.dev/docs/browser/design-mode
4. GitHub / Linear 集成
App 内直接浏览 PR、Issues、Project Board，从任务列表开 worktree 写代码，无需 context switch。
文档：https://www.onorca.dev/docs/review/linear
5. SSH Worktrees（远程 Agent）
在远程高配机器上跑 Agent，本地编辑文件、git 操作、terminal——自动重连、端口转发。
orca ssh connect <remote-host>
orca worktree create --ssh <remote-host> <task>
文档：https://www.onorca.dev/docs/ssh
6. AI Diff 批注
在任意 diff 行上直接写评论，发回给 Agent 继续修改，无需离开 Orca。
# 在 diff 视图点击行号 → 添加注释 → Agent 收到反馈继续修改
文档：https://www.onorca.dev/docs/review/annotate-ai-diff
7. Orca CLI（自动化脚本）
orca worktree create <task> # 创建 worktree
orca snapshot save <id> # 保存快照
orca click <selector> # 让 Agent 点击 UI 元素
orca fill <selector> <text> # 让 Agent 填写表单
文档：https://www.onorca.dev/docs/cli/overview
8. Computer Use（桌面应用操控）
让 Agent 直接操控桌面可见的应用程序 UI，适合需要真实交互的复杂场景。
# 启用后 Agent 可以点击、拖拽真实窗口
文档：https://www.onorca.dev/docs/cli/computer-use
典型适用场景
| 场景 | 核心功能 |
|---|---|
| 同任务多 Agent 对比 | Parallel Worktrees |
| 远程高配机器跑 Agent | SSH Worktrees |
| UI 还原 / 设计稿转代码 | Design Mode |
| PR/Issue → 代码 → Review 全链路 | GitHub/Linear 集成 |
| 多 Agent 并行探索代码库 | Terminal Splits + Worktrees |
| 移动端监控 Agent 进度 | iOS/Android App |
| AI 代码审查与批注 | AI Diff 批注 |
| Agent 驱动的桌面自动化 | Computer Use |
坑与注意
- Orca 本身不含 Agent：安装 Orca 后仍需另行安装想要的 Agent（Claude Code、Codex 等），Orca 只是调度台。
- 并行 Agent 数量与资源：每个 Agent 独立占用 GPU/CPU，注意机器配置，96 GB+ 内存的 Mac Studio 才能同时跑多个大模型。
- SSH Worktrees 网络依赖：远程连接质量影响体验，断线后 Orca 有 auto-reconnect，但高延迟下 Agent 执行可能超时。
- Linux headless 模式：需要 X server 或 Wayland，参考官方 headless guide 配置。
- 移动端是监控而非主控：iOS/Android App 主要用于监控进度和发送 follow-up，不能替代桌面端完成复杂配置。
- 每日更新节奏：官方 changelog 提到"We ship daily"，功能迭代极快，文档可能有滞后。
与同类对比
| 特性 | Orca | Cursor | GitHub Copilot Chat | Goose |
|---|---|---|---|---|
| 多 Agent 并行 | ✅ Parallel Worktrees | ❌ | ❌ | ❌ |
| Agent 调度台 | ✅ | ❌ | ❌ | ❌ |
| git worktree 隔离 | ✅ | ❌ | ❌ | ❌ |
| 移动端监控 | ✅ iOS/Android | ❌ | ❌ | ❌ |
| SSH 远程 Agent | ✅ | ❌ | ❌ | ❌ |
| Design Mode | ✅ | ❌ | ❌ | ❌ |
| AI Diff 批注 | ✅ | 部分 | ❌ | ❌ |
| 终端分屏 | ✅ WebGL | ❌ | ❌ | ❌ |
| MIT 许可证 | ✅ | ❌ | ❌ | ✅ |
一句话结论
Orca 是目前唯一的多 Agent 并行 IDE——用一个 prompt 让多个 Agent 同时探索、对比结果，用 Parallel Worktrees + Terminal Splits + 移动端监控构建完整的 Agent 协作工作流，特别适合需要充分探索方案空间的复杂编程任务。