文档 / 安装

下载¶

Orca 是一款桌面应用。请从 GitHub 下载适用于您平台的最新构建版本：

**macOS：** [Apple Silicon](https://github.com/stablyai/orca/releases/latest/download/orca-macos-arm64.dmg) · [Intel](https://github.com/stablyai/orca/releases/latest/download/orca-macos-x64.dmg)
**Windows：** [安装程序](https://github.com/stablyai/orca/releases/latest/download/orca-windows-setup.exe)
**Linux：** AppImage [x64](https://github.com/stablyai/orca/releases/latest/download/orca-linux.AppImage) · [arm64](https://github.com/stablyai/orca/releases/latest/download/orca-linux-arm64.AppImage) · [.deb](https://github.com/stablyai/orca/releases) · [.rpm](https://github.com/stablyai/orca/releases) — 请参阅 [Linux](#linux) 了解如何选择
旧版本：[GitHub Releases](https://github.com/stablyai/orca/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（候选发布版）构建会率先推出新功能，通常每天更新。

在 Linux 上，Orca 能否自行应用更新取决于您安装的软件包。请在选择之前参阅 Linux。

没有永久性的应用内 RC 频道选择。按住修饰键点击检查更新（设置 → 通用 → 更新，或应用/帮助菜单）：

修饰键	效果
Shift+点击	包含最新的 RC 预发布版本
Cmd+点击（macOS）/ Ctrl+点击（Windows/Linux）	最新带 perf 标签的预发布版本
Option+点击（仅限 macOS）	选择一个通过 Orca 兼容性检查的本地 macOS 构建

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

旧版本始终可以在 GitHub Releases 页面上获取。如果您回退版本，Orca 不会强制降级您的工作树数据。

平台说明¶

macOS¶

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

Windows¶

默认 shell 可以在设置 → 终端中设置为 PowerShell 或 CMD。大多数用户会选择 PowerShell。

Linux¶

每个发布的版本都附带三个 Linux 软件包——AppImage、.deb 和 .rpm——同时支持 x64 和 arm64。它们包含相同的应用。不同之处在于更新抵达您的方式，因此请据此选择。

软件包	何时选择	更新方式
AppImage	您希望 Orca 像在 macOS 和 Windows 上一样自行更新	Orca 会在原位下载并应用更新
`.deb`	您在 Debian 或 Ubuntu 上使用 `apt` 管理软件	Orca 会提示有新版本并为您提供安装命令
`.rpm`	您使用 `dnf`、`yum` 或 `zypper` 管理软件	与 `.deb` 相同

AppImage 每个架构都有一个稳定的下载链接——x64 为 orca-linux.AppImage，arm64 为 orca-linux-arm64.AppImage——并且在首次运行前需要执行 chmod +x，因为 GitHub 发布资产不携带权限位。.deb 和 .rpm 文件名包含版本号和架构，且两种格式的架构命名不同（orca-ide_<version>_amd64.deb 或 _arm64.deb；orca-ide-<version>.x86_64.rpm 或 .aarch64.rpm），因此请从 Releases 页面获取这些文件名，而不是使用固定 URL。

更新机制¶

AppImage 可自行更新。 如果您需要自动更新，请选择它。Orca 会检查新版本，您点击更新，它就会在原位替换 AppImage——与 macOS 和 Windows 上的流程相同。

.deb 和 .rpm 不会自行更新。 Orca 仍会检测到新版本并下载软件包，然后为您提供一个复制安装命令按钮。请复制而不是重新输入：Orca 会将每个程序解析为可信系统目录中的绝对路径，并对软件包路径加单引号，因此您粘贴的内容看起来像这样：

/usr/bin/sudo /usr/bin/apt install -- '/home/you/.cache/orca-updater/pending/orca-ide_1.4.194_amd64.deb'

显示哪个包管理器取决于你的系统实际有什么：对于 .deb，优先 apt，否则 dpkg -i；对于 .rpm，依次是 zypper、dnf、yum，然后是 rpm -Uvh。如果设置了 XDG_CACHE_HOME，下载目录会遵循它；未设置时则回退到 ~/.cache。

在运行命令之前退出 Orca，安装完成后再重新打开它。你正在替换一个正在运行的应用程序的文件，包管理器无法在正在运行的进程下方安全地替换它们。Orca 故意从不为你提升权限来执行此操作：安装系统包需要 root，orca serve 以非特权用户身份运行，而无头主机没有认证代理来提示。VS Code 和 Signal 对 .deb 也做了同样的选择。

由发行版管理的构建会被原样保留。 如果你正在运行一个重新打包的 Orca——一个 AUR 构建、一个 Nix 派生——Orca 发现没有任何它可以驱动的包管理器拥有此安装，并停止提供一个它永远无法应用的下载。它仍会报告存在新版本，因此你可以按通常的方式更新。

#18086 跟踪发布一个签名仓库，以便你的操作系统包管理器像管理其他所有内容一样管理 Orca 更新。它尚不存在——目前，.deb 和 .rpm 更新是上述手动步骤。

CLI 命令是 `orca-ide`¶

在 Linux 上，Orca CLI 安装为 orca-ide，而不是 orca。GNOME Orca——默认随 Ubuntu 和其他 GNOME 桌面环境提供的屏幕阅读器——已经占用了 /usr/bin/orca，而 Orca 不会遮蔽它。.deb 和 .rpm 包之所以命名为 orca-ide，也是出于同样的原因。

.deb 和 .rpm 会在安装时将 orca-ide 放到你的 PATH 中，作为 /usr/bin/orca-ide。
使用 AppImage 时，从设置 → 常规 → Orca CLI 注册 CLI。这会安装 ~/.local/bin/orca-ide。
在 Orca 自己的终端中，直接使用 orca 即可。Orca 会在它管理的终端的 PATH 中放置一个 shim，因此在那里运行的代理和脚本使用与 macOS 和 Windows 上相同的命令。
在无头主机上，打包的 orca serve 在启动时会向 ~/.local/bin 写入一个裸 orca，除非一个它不拥有的文件已经占用该名称。它在启动期间写入，因此它永远不会是启动服务器的东西——首次启动始终是 orca-ide serve。

不要用 command -v orca 来验证：在 GNOME 桌面上，它会成功并解析到屏幕阅读器。在你自己的 shell 中使用 orca-ide，在 Orca 内部使用 orca。如果你希望到处都使用短名称，并且你不使用屏幕阅读器，请自行创建链接：

ln -s "$(command -v orca-ide)" ~/.local/bin/orca

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 orca48/orca