这份详细的部署教程将指引您安装和运行 Orca——一个被称为“AI 编排器”的强大桌面应用。它的核心能力是让您同时运行和管理多个 AI 编程代理（如 Claude Code、Codex 等），每个代理都在独立的 Git 工作树中工作，从而极大提升并行开发和探索的效率。

Orca 的特色在于它将多个终端代理整合到一个可视化的界面中，并提供了如“设计模式”（抓取 UI 元素）、“SSH 工作树”（远程运行）、“移动端伴侣”等增强功能，让您能像指挥舰队一样协调您的 AI 助手。它适用于桌面端 (macOS, Windows, Linux) 并配有移动端伴侣应用。

整个部署流程非常简单，您只需下载对应操作系统的安装包即可。

📥 安装方式

桌面端 (macOS, Windows, Linux)

Orca 提供了多种便捷的安装方式。

  1. 直接下载安装包（推荐）：

    • 访问 Orca 官网 或 GitHub Releases 页面，下载适用于您操作系统的安装包。
    • macOS：下载 .dmg 文件（Apple Silicon 或 Intel），打开后将 Orca.app 拖入 Applications 文件夹。
    • Windows：下载 .exe 安装程序并运行。
    • Linux：下载 .AppImage 文件，赋予执行权限 (chmod +x) 后直接运行。

  2. 通过包管理器安装：

    • macOS (Homebrew)：

      1
      brew install --cask stablyai/orca/orca

    • Arch Linux (AUR)：

      1
      2
      3
      4
      # 安装预编译二进制版本
      yay -S stably-orca-bin
      # 或从源码构建
      yay -S stably-orca-git

移动端伴侣 (iOS, Android)

Orca 提供移动端应用，用于远程监控和指导代理。

  • iOS：在 App Store 搜索 “Orca” 下载，或加入 TestFlight 获取测试版。
  • Android：从 GitHub Releases 下载最新的 APK 文件并安装。具体安装指南请参考项目文档。

无界面服务器 (Headless Linux)

如果您需要在远程 Linux 服务器上运行 Orca 的后端服务，可以使用 orca serve 命令。详细指南请参考项目中的 headless Linux 服务器指南。

🚀 首次启动与核心概念

安装完成后，首次启动 Orca，您将看到一个现代化的界面。理解以下几个核心概念有助于您快速上手：

  • 工作树 (Worktrees)：这是 Orca 的核心。每个 AI 代理都可以在独立的 Git 工作树中运行。这意味着您可以同一个仓库启动多个代理，让它们并行解决不同任务或探索不同方案，而不会相互干扰。
  • 代理 (Agents)：您可以在 Orca 中启动并排运行多个代理，例如，同时让一个 Claude Code 代理重构代码，一个 Codex 代理编写测试，一个 OpenCode 代理更新文档。
  • 终端与设计模式：
    • 终端：Orca 内置了高性能终端，支持无限分屏，滚动历史记录在重启后依然保留。
    • 设计模式 (Design Mode)：这是一个独特功能，您可以在内置的 Chromium 窗口中点击任意 UI 元素，其 HTML、CSS 和截图会被直接发送给代理，用于 UI 相关的开发或调试任务。
  • 集成工作流：Orca 原生集成了 GitHub 和 Linear，您可以直接在应用内浏览 PR、Issue 和项目看板，并直接从任务卡片打开一个工作树进行开发。

🛠️ 开发者与贡献

如果您想从源码构建 Orca 或为其贡献代码，请参考项目根目录的 CONTRIBUTING.md 文件。它包含了详细的开发环境设置和构建指南。

🔒 隐私与签名

  • 隐私：Orca 会收集匿名的使用数据以帮助改进产品。您可以在设置中选择退出。详细信息请参阅项目的 隐私与遥测文档。
  • 构建签名：Windows 版本的代码签名由 SignPath.io 提供，证书由 SignPath 基金会颁发。