文档 / 设置参考

设置按窗格分组。按 Cmd-, 后输入关键词，即可搜索所有设置项。本文档中的功能页面会直接链接到相关窗格。

通用¶

• Orca CLI — 为 shell 和代理注册内置命令行工具。
• 更新（Updates） — 检查并安装更新。对 Check for Updates（检查更新） 使用修饰键点击：

• Open in 菜单 — 选择出现在工作树 Open in（打开方式） 菜单中的应用程序。VS Code / Insiders 可为 SSH 工作树启用 Remote SSH 打开方式；其他编辑器仅支持本地路径。
• 界面缩放（UI zoom） — 当前安装的界面缩放比例。
• 默认新工作树名称（Default new-worktree name） — 自定义前缀或海洋生物名称。
• 编辑器自动换行（Editor Word Wrap） — 文件编辑器的默认自动换行（默认开启）。可通过文件标签页的 ⋯ 菜单或 Alt+Z 切换。与 Diff Word Wrap（差异自动换行） 相互独立。

外观¶

• 主题、强调色、密度。
• 界面的字体族；编辑器字体为可选（留空 = 跟随终端字体；设置值则仅覆盖文件编辑器和差异视图）。
• 编辑器迷你地图开关。
• 状态栏开关，包括资源管理器（Resource Manager）（CPU/内存/会话、守护进程控制、工作区磁盘扫描）。
• 用量百分比（Usage percentages） — 在状态栏列表中，以 % 已用 或 % 剩余 的形式显示提供商限额。
• 应用图标 — 可循环切换 Dock 和窗口切换器中显示的图标：Classic、Watercolor 和 Blue。
• 语言（Language） — 主要的界面控制项。可在系统（跟随操作系统）、English、中文（简体）、한국어、日本語 或 Español 之间切换。设置搜索也会匹配“语言”对应的本地词汇（语言 / 語言 / 언어 / 言語 / Idioma），因此即使界面仍为英文，你也能找到 Language 设置。

Git¶

• 默认基础引用（base ref）解析器。
• 提交签名选项。
• 外部 Git 工具使用的编辑器。
• Auto-Rename Branch From Work（根据工作自动重命名分支） — 在代理开始工作后，重命名 Orca 生成的海洋生物分支。
• GitHub API 配额（GitHub API Budget） — 来自本地 gh CLI 的剩余 REST（核心）、Search 和 GraphQL 配额。当 PR 检查或任务停止刷新时，此功能很有用；如果数字看起来正常，但 GitHub 仍对实时调用进行速率限制，请参阅 GitHub 错误排查。

终端¶

• 字体、主题、光标样式、内边距。
• Ghostty 导入。
• Warp 主题导入 — 通过 Import themes from Warp（从 Warp 导入主题）（按操作系统自动发现 Warp 的主题文件夹）或 Import from YAML（从 YAML 导入）（适用于任意包含 Warp 格式主题文件的文件夹）引入你的 Warp YAML 主题。
• 针对 macOS 日文键盘，将 JIS 日元符号（¥）映射为反斜杠（\）。
• Windows 默认 shell（PowerShell 或 CMD）。
• 允许 TUI 剪贴板写入（OSC 52） — 默认开启。允许 Zellij、tmux、Neovim、fzf、Grok（及类似工具）通过 PTY 写入系统剪贴板，包括通过 SSH 连接时。如果你更偏好以前的锁定限制，可以将其关闭。

快速命令¶

• 已保存的终端命令和智能体提示词预设，可限定为全局或项目范围。每行都有一个复制控件，用于复制命令正文。
• 用于查看和编辑命令列表的范围筛选器。同一列表会同步到移动端配套应用。
• 在远程或多主机设置中，命令按所属的 Orca 主机分组（Saved on（保存于））。主机归属与全局/项目范围以及命令的运行位置是分开的 — 请参阅终端 → 快速命令。

智能体¶

• 已安装的智能体 — 检测到的 CLI，你可以启用或禁用。
• 启用或禁用检测到的智能体，使启动菜单只显示你想使用的 CLI。
• 智能体权限（Agent Permissions）— 选择 Yolo 可获得更少的 CLI 权限提示，或选择 Manual（手动） 为尚未自定义的智能体保留各自的审批流程。
• Claude 和 Codex 账户列表。
• 每个智能体的启动钩子。
• 智能体状态钩子（Agent status hooks） — 在 Orca 中显示工作中 / 等待中 / 已完成状态。切换后无需重启应用即可生效（包括 Windows WSL 钩子中继）。CLI：orca agent hooks on|off|status。
• 保持电脑唤醒（Keep computer awake） — 开（On）（持续保持唤醒）、智能体（Agent）（智能体工作时保持唤醒）或关（Off）。桌面状态栏上的 Caffeinate（咖啡图标）提供相同的控制项。在配对的 Web 客户端上隐藏。
• 技能新鲜度（Skill freshness） — 智能体窗格和技能卡片仍会显示完整状态。侧边栏导航仅对需要操作的技能显示徽标（Update available（有可用更新）、Needs attention（需要注意） / 待审查）；健康、加载中以及可选的未安装行保持静默。使用对话框中的 Update（更新） 可在后台刷新全局技能（无需终端）。进度显示在状态栏上；关闭对话框不会取消运行。请参阅 Orca 技能。

浏览器¶

• 配置文件（请参阅浏览器使用配置文件）。
• 默认缩放（Default Zoom） — 应用于新打开的浏览器标签页的缩放级别（通过 Cmd+滚轮对单个标签页进行的调整会被单独记住）。
• 设计模式默认值。
• Devtools 选择启用。
• 远程服务器工作区（Remote server workspaces） — 选择 This device（此设备） 可在当前桌面上渲染新的配对运行时浏览器页面，或选择 Server (streamed)（服务器（流式传输）） 在服务器上渲染。流量始终经过远程服务器，且该选择仅适用于新页面。请参阅每个工作树的浏览器 → 远程工作区。
• 通过 SSH 工作区主机浏览（Browse through SSH workspace hosts） — 将浏览器流量和 DNS 通过每个工作区的 SSH 主机发送。关闭此选项可改为从当前设备浏览。
• 链接路由（Link Routing） — 在 Orca 浏览器或系统浏览器中打开来自终端、Markdown 和编辑器的 http(s) 链接。嵌套的 Hold Shift…（按住 Shift…） 选项可在单次点击时反转此默认行为（⇧⌘-点击 / Shift+Ctrl+点击）。请参阅每个工作树的浏览器。
• 显示终端链接操作（Show terminal link actions） — 默认开启。直接单击终端链接即可打开紧凑的操作弹出框。关闭后则需要 ⌘-点击 / Ctrl-点击。请参阅终端 → 链接操作。
• 默认搜索引擎（Default Search Engine） — 在浏览器地址栏或新标签页多功能框中输入非 URL 文本时使用。

工件¶

• Orca 账户 — 登录（与 Orca Relay 同一账户体系）以发布和管理共享文件。
• 允许发布公共工件链接 — 默认关闭。设备级开关：开启后，你、代理以及本机的 orca CLI 可以上传 HTML/Markdown 并生成公共查看链接。关闭不会删除现有链接。
• 显示工件 / 侧边栏快捷方式 — 打开工件列表，以搜索、预览、复制或删除账户拥有的链接。
• 删除工件前询问 — 在断开公共链接前进行可选确认。
• 从打开的本地 HTML 页面或 Markdown 编辑器中通过 共享为工件 共享，或通过 orca artifacts …。参见 CLI 参考 → 工件。

集成¶

• GitHub OAuth。
• Linear API token。
• Jira — Cloud（邮箱 + API token）或自托管 Server/Data Center（PAT 或用户名/密码）。参见 Jira 项目抽屉。
• Bitbucket Cloud — 使用 邮箱和 API token（默认）或 访问令牌 进行 连接。Orca 会在保存前验证凭据。ORCA_BITBUCKET_* 环境变量优先，并隐藏 连接 / 断开连接。已保存的凭据保留在本机上 — 在 远程 Orca 服务器 上，请改为在服务器上设置环境变量。参见 托管评审。
• MiniMax — 粘贴 MiniMax 会话 cookie（来自 platform.minimax.io/console/usage）以启用 MiniMax CLI 的本地用量和速率限制跟踪。可选的组 ID 和用量模型字段会覆盖从 cookie 中选择的默认值。
• MCP 服务器。

通知¶

• 代理完成：系统、声音、徽章。
• 按类别自定义桌面通知声音。
• PR 检查失败。
• 有可用更新。

语音¶

• 启用语音听写 — 需要麦克风权限（macOS 可能会打开“隐私与安全性”）。
• 麦克风 — 选择听写使用的输入设备。默认使用系统麦克风；如果不想使用操作系统默认设备，可选择特定设备（例如头戴式耳机）。如果所选麦克风被拔出或不存在，Orca 会回退到系统默认麦克风并显示非阻塞通知。
• 听写模式 — 切换（按快捷键开始/停止）或 长按（按住快捷键说话）。
• 语音模型 — 下载/选择本地设备模型，或在粘贴 API 密钥后使用云端 OpenAI 模型：
• Parakeet TDT v3（推荐）— 多语言欧洲语言，离线。
• Parakeet TDT v2 — 英语，更快。
• Zipformer 系列 — 双语 ZH+EN 流式；流式 EN/ZH；Zipformer Streaming KO（韩语）。
• Paraformer Bilingual — 中文方言 + 英语。
• Parakeet TDT-CTC JA — 日语。
• SenseVoice — ZH / EN / JA / KO / 粤语，支持自动语言检测。
• Whisper Tiny — 90+ 种语言，准确度较低。
• GPT-4o mini / GPT-4o Transcribe — 云端；需要在同一面板下提供 OpenAI 密钥。
• 监听时，监听中… 胶囊显示 停止 控件；在切换模式下，工具提示还会显示听写快捷键。

SSH¶

• SSH 工作树、目标、密码短语、默认身份文件。
• 高级：代理 / 跳板主机；复用 SSH 连接以加快设置（系统 OpenSSH 多路复用；默认开启）。
• Kerberos 主机：OpenSSH 配置中的 GSSAPIAuthentication 驱动系统 OpenSSH 认证（参见 SSH 工作树）。

远程 Orca 服务器¶

• 配对并连接远程 Orca 运行时。
• 将此桌面应用作为服务器发布，并创建可撤销的访问链接。
• 服务器路由项目、终端和提供商检查的高级默认运行时选择。

快捷键¶

• 完整键位映射 — 所有绑定均可重新映射。
• 切换休眠工作区默认未绑定；如果你想要侧边栏休眠工作树筛选器的直接快捷键，可在此分配。
• 切换工作区看板 默认未绑定；在此分配它，可通过一个快捷键打开或关闭工作区看板。workspace.openBoard 的现有绑定继续有效。
• 关闭所有编辑器标签页在 macOS 上默认为 Cmd+Option+W，在 Windows / Linux 上为 Ctrl+Alt+W。
• 标签页导航默认值（新安装）： 跨所有类型的下一个/上一个标签页为 Cmd+Shift+] / Cmd+Shift+[（Linux/Windows 上为 Ctrl）。同类型的下一个/上一个为 Cmd+Option+] / Cmd+Option+[。上一个最近标签页为 Ctrl+Tab。现有安装保留 ~/.orca/keybindings.json 下的自定义覆盖。
• 添加评审备注 默认为 Cmd+Shift+A（macOS）/ Ctrl+Shift+A（Windows / Linux）；可重新映射。
• 将评审备注发送给代理 默认未绑定；在此分配它，可在不使用鼠标的情况下打开活动工作树差异备注的发送备注菜单。
• 删除工作区 在 macOS 上默认为 Cmd+Shift+Backspace，在 Windows / Linux 上为 Ctrl+Shift+Backspace。将鼠标悬停在你要删除的侧边栏工作区上；Orca 仍会请求确认。

仓库¶

• 每个仓库的基础引用和钩子。
• 创建工作树时自动运行命令。
• 侧边栏的仓库图标：选择图标、完整可搜索的表情符号选择器、上传的图片、网站 favicon 或 GitHub 头像，然后选择预设或自定义十六进制徽章颜色。
• 用于提交信息、拉取请求详情和分支名的 Source Control AI 覆盖。
• 工作树共享路径 — 从主检出物化到每个新工作树的被 Git 忽略的路径（macOS 上尽可能使用 APFS 克隆复制，否则使用符号链接）。补充 orca.yaml 和 .worktreeinclude 中仓库检入的 worktree.sharedDirectories（参见 工作树）。

浮动工作区¶

• 启用浮动工作区 — 终端、浏览器和 Markdown 标签页的全局表面，不绑定到仓库工作树。
• 终端目录 — 新浮动终端标签页的起始目录（~ = 主目录）。
• 切换按钮位置 — 浮动工作区切换按钮出现的位置；无论按钮放在哪里，键盘快捷键都有效。

插件（实验性）¶

• 插件系统 — 设置 → 插件。打开系统，然后逐个审查并启用每个插件。在你同意之前，什么都不会运行。
• 市场 — 添加 git 市场源，浏览插件，预览功能（面板、命令、语言包、VM 配方），安装、更新或回滚。
• 插件工作进程始终在本机上运行；SSH 工作区操作仍通过 Orca 路由。
• 能力和 API 形状可能会变化；将第三方插件视为不受信任的软件。

实验性功能¶

• 活动页面 — 用于代理事件的 Slack 风格工作树信息流。
• 紧凑工作树卡片 — 在布局仍处于实验阶段时，隐藏侧边栏中冗余的第二行。
• 代理休眠 — 暂停空闲的后台代理，并在重新打开时自动恢复。
• 代理仪表盘 — 展示“需要你 / 工作中 / 已完成”代理的看板（可选“空闲”），支持搜索以及项目/工作区/PR 筛选；可在窗口内打开或作为弹出窗口打开。显示空闲代理位于仪表盘看板设置控件中，而不是这里。参见 代理与会话。
• 聊天界面 — 在受支持的代理终端上提供可选聊天界面。参见 聊天界面。
• 云虚拟机 — 显示设置控件和工作区 运行于 目标，用于仓库拥有的按需环境（云沙箱、虚拟机或本地 Docker）。设置指南和配方安装位于此实验性开关下。参见 运行 Orca 的方式。
• 尚未稳定的功能 — 行为可能会变化。