第7章 Orca 安装指南：多平台支持与自动更新机制

安装 下载 Orca 的 macOS、Windows 或 Linux 版本，并可选择加入 RC 版本计划。 [下载]

Orca 是一款桌面应用。您可以为自己发送一封邮件，其中包含在 macOS、Windows 或 Linux 上打开的链接： * macOS：Apple Silicon 芯片版 · Intel 芯片版 * Windows：安装程序 * Linux：AppImage · .deb · .rpm * 旧版本：请前往 GitHub Releases 页面查看。

Homebrew (macOS) Orca 同时也以 Homebrew cask 的形式发布，并会在每次稳定版发布时自动更新版本：

`brew install --cask stablyai/orca/orca`

执行 `brew upgrade --cask orca` 即可获取新的稳定版构建。该 cask 跟踪的是稳定版渠道——若要使用 RC 版本，请使用上述 GitHub Releases 链接，或通过应用内“检查更新”流程（详见下文“更新”部分）进行更新。

首次启动 首次启动 Orca 时，它将执行以下操作：

* 请求访问主目录权限，以便添加代码仓库。 * 如果检测到 `~/.claude`、`~/.codex` 或 Ghostty 终端设置，将提示是否导入。 * 显示一个空白落地页，供用户添加第一个代码仓库。

更新 Orca 默认自动更新，跟踪稳定版渠道。稳定版经过严格测试；RC (Release Candidate，候选版) 构建则优先发布新功能，通常每日推送。

应用内没有永久加入 RC 渠道的选项。在“检查更新”界面（路径：设置 → 常规 → 更新，或应用/帮助菜单）按住修饰键点击可实现不同效果：

* Shift + 点击：包含最新的 RC 预发布版 * Cmd + 点击 (macOS) / Ctrl + 点击 (Windows/Linux)：获取带有 perf 标签的最新预发布版 * Option + 点击 (仅限 macOS)：选择一个通过 Orca 兼容性检查的已验证本地 macOS 构建

您仍然可以从 GitHub Releases 页面直接下载任意版本的构建。

平台说明

macOS 已签名并经过公证。首次启动时，macOS 可能会要求您确认打开应用——这对基于 Electron 的应用来说是正常现象。

Windows 在 设置 → 终端 中可将默认 Shell 设置为 PowerShell 或 CMD。大多数用户推荐使用 PowerShell。附带的 `orca` 命令是原生程序，无需安装 Visual C++ Redistributable 即可运行。

Linux 若希望 Orca 能够自我更新，请选择 AppImage。`.deb` 和 `.rpm` 包会报告可用更新，并提示您使用包管理器命令进行安装；执行该命令前请先退出 Orca。Linux 下的 CLI 命令命名为 `orca-ide`，以避免与 GNOME Orca 屏幕阅读器冲突。