设置参考

设置被分组到不同的面板中。这里的所有内容都可以用 Cmd-, 打开后输入关键词进行搜索。本文档中的功能页面会直接链接到相关面板。

General

• DevAgent CLI —— 为 shell 和 agent 注册内置的命令行工具。
• Updates —— 检查并安装更新。在 Check for Updates 上使用修饰键点击：

修饰键

效果

Shift+click

包含最新的 RC 预发布版

Cmd+click（macOS）/ Ctrl+click（Windows/Linux）

最新的 perf 标记预发布版

Option+click（仅 macOS）

选择一个经过验证的本地 macOS 构建（已做兼容性检查）。失败时会显示 “Could Not Use Local Build”，并提供 Choose Another Build。

• Open in menu —— 选择 worktree Open in 菜单中的应用。VS Code / Insiders 会为 SSH worktree 启用 Remote SSH 打开；其他编辑器仍仅限本地路径。
• UI zoom —— 按安装实例设置的 UI 缩放。
• Default new-worktree name —— 自定义前缀或海洋生物名。
• Editor Word Wrap —— 文件编辑器的默认换行（默认开启）。可从文件标签页的 ⋯ 菜单或 Alt+Z 切换。与 Diff Word Wrap 相互独立。

Appearance

• 主题、强调色、密度。
• UI 字体族；编辑器字体为可选项（留空 = 跟随终端字体；设定一个值则仅覆盖文件编辑器和 diff）。
• 编辑器 minimap 开关。
• 状态栏开关，包括 Resource Manager（CPU/内存/会话、守护进程控制、工作区磁盘扫描）。
• Usage percentages —— 在状态栏名单上以 % used（已用）或 % remaining（剩余）显示提供方额度。
• App Icon —— 在 Classic、Watercolor 和 Blue 之间切换 Dock 和窗口切换器中显示的图标。
• Language —— 主界面语言控制。可在 System（跟随操作系统）、English、中文（简体）、한국어、日本語、Español 之间切换。设置搜索也匹配 “language” 的各语言原生词（语言 / 語言 / 언어 / 言語 / Idioma），因此即使 UI 仍是英文，你也能找到 Language。

Git

• 默认 base ref 解析器。
• 提交签名选项。
• 外部 git 工具使用的编辑器。
• Auto-Rename Branch From Work —— 在 agent 开始工作后重命名 DevAgent 生成的生物名分支。
• GitHub API Budget —— 来自本地 gh CLI 的剩余 REST（core）、Search 和 GraphQL 配额。当 PR 检查或 Tasks 停止刷新时很有用；如果数字看起来正常但 GitHub 仍对实时调用限流，请参见 排查 GitHub 错误。

Terminal

• 字体、主题、光标样式、内边距。
• Ghostty 导入。
• Warp 主题导入 —— 用 Import themes from Warp 导入你的 Warp YAML 主题（会按操作系统自动发现 Warp 的主题文件夹），或用 Import from YAML 从任意存放 Warp 格式主题文件的文件夹导入。
• 针对 macOS 日文键盘的 JIS 日元（¥）转反斜杠（\）。
• Windows 默认 shell（PowerShell 或 CMD）。
• Allow TUI Clipboard Writes (OSC 52) —— 默认开启。允许 Zellij、tmux、Neovim、fzf、Grok（及类似工具）通过 PTY 写入系统剪贴板，SSH 场景下同样支持。如果你更喜欢旧的锁定行为，可将其关闭。

Quick Commands

• 已保存的终端命令和 agent-prompt 预设，作用域可为全局或某个项目。每一行都有一个复制命令主体的控件。
• 用于审阅和编辑命令列表的作用域筛选。同一份列表会同步到移动端伴侣应用。
• 在远程或多主机配置下，命令会按拥有它们的 DevAgent 主机分组（Saved on）。主机归属独立于 Global/Project 作用域，也独立于命令的运行位置 —— 参见 Terminal → Quick Commands。

Agents

• 已安装的 agent —— 你可以启用或禁用的、检测到的 CLI。
• 启用或禁用检测到的 agent，让启动菜单只显示你想用的 CLI。
• Agent Permissions —— 选择 Yolo 以减少 CLI 权限提示，或选择 Manual 以为你尚未自定义的 agent 保留各自的审批流程。
• Claude 和 Codex 账户列表。
• 每个 agent 的启动钩子。
• Agent status hooks —— 在 DevAgent 中显示工作中 / 等待中 / 已完成状态。切换无需重启应用即可生效（包括 Windows WSL 钩子中继）。CLI：devagent agent hooks on|off|status。
• Keep computer awake —— On（持续保持唤醒）、Agent（agent 工作期间保持唤醒）或 Off。同样的控件也以 Caffeinate（咖啡图标）出现在桌面状态栏。在配对的 web 客户端上隐藏。
• Skill freshness —— Agents 面板和 skill 卡片仍会显示完整状态。侧边栏导航只为需要处理的 skill 加徽标（Update available、Needs attention / 需审阅）；健康、加载中和可选的未安装行保持安静。在对话框中使用 Update 可在后台刷新全局 skill（无需终端）。进度显示在状态栏；关闭对话框不会取消运行。参见 DevAgent skills。

Browser

• 配置文件（参见 Browser-use 配置文件）。
• Default Zoom —— 应用于新打开的浏览器标签页的缩放级别（通过 Cmd-滚轮 做的按标签页调整会单独记住）。
• Design Mode 默认值。
• Devtools 选择启用。
• Link Routing —— 在 DevAgent 浏览器或系统浏览器中打开来自终端、markdown 和编辑器的 http(s) 链接。嵌套的 Hold Shift… 会为一次点击反转该默认行为（⇧⌘-click / Shift+Ctrl+click）。参见 按 worktree 的浏览器。
• Show terminal link actions —— 默认开启。对终端链接的普通点击会打开一个紧凑的操作弹出框。关闭后需使用 ⌘-click / Ctrl-click。参见 Terminal → 链接操作。
• Default Search Engine —— 当你在浏览器地址栏或新标签页 omnibox 中输入非 URL 文本时使用。

Artifacts

• DevAgent account —— 登录（与 DevAgent Relay 同一账户体系）以发布和管理共享文件。
• Allow publishing public artifact links —— 默认关闭。这是设备级的总开关：开启后，你、agent 以及本机上的 devagent CLI 都可以上传 HTML/Markdown 并生成公开查看链接。关闭它不会删除已有链接。
• Show Artifacts / 侧边栏快捷方式 —— 打开 Artifacts 列表以搜索、预览、复制或删除账户所拥有的链接。
• Ask Before Deleting Artifacts —— 在断开某个公开链接前的可选确认。
• 在打开的本地 HTML 页面或 Markdown 编辑器中，用 Share as artifact 分享，或通过 devagent artifacts … 分享。参见 CLI 参考 → Artifacts。

Integrations

• GitHub OAuth。
• Linear API token。
• Jira —— Cloud（邮箱 + API token）或自托管的 Server/Data Center（PAT 或用户名/密码）。参见 Jira 事项抽屉。
• Bitbucket Cloud —— 用 Email & API token（默认）或 Access token 进行 Connect。DevAgent 会在保存前校验凭据。ORCA_BITBUCKET_* 环境变量优先，并会隐藏 Connect / Disconnect。已保存的凭据留在本机 —— 在 Remote DevAgent Server 上，请改为在服务器上设置这些环境变量。参见 托管评审。
• MiniMax —— 粘贴一个 MiniMax 会话 cookie（来自 platform.minimax.io/console/usage），以为 MiniMax CLI 启用本地用量和速率限制跟踪。可选的 group ID 和 usage models 字段会覆盖从 cookie 中挑选出的默认值。
• MCP 服务器。

Notifications

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

Voice

• Enable Voice Dictation —— 需要麦克风权限（macOS 可能会打开隐私与安全）。
• Microphone —— 选择听写使用哪个输入设备。默认使用系统麦克风；当你不想用操作系统默认设备时，可选择某个特定设备（例如耳机）。如果所选麦克风被拔出或缺失，DevAgent 会回退到系统默认设备并显示一条非阻塞提示。
• Dictation mode —— Toggle（按快捷键开始/停止）或 Hold（按住快捷键讲话）。
• Speech Model —— 下载/选择一个本地模型，或在粘贴 API key 后使用云端 OpenAI 模型：
  • Parakeet TDT v3（推荐）—— 多语言欧洲语种，离线。
  • Parakeet TDT v2 —— 英语，更快。
  • Zipformer 系列 —— 中英双语流式；英语/中文流式；Zipformer Streaming KO（韩语）。
  • Paraformer Bilingual —— 中文方言 + 英语。
  • Parakeet TDT-CTC JA —— 日语。
  • SenseVoice —— 中文 / 英语 / 日语 / 韩语 / 粤语，支持自动语言检测。
  • Whisper Tiny —— 90+ 种语言，准确度较低。
  • GPT-4o mini / GPT-4o Transcribe —— 云端；需要在同一面板下填写 OpenAI key。
• 聆听时会显示一个 Listening… 药丸标记，并带有 Stop 控件；在 toggle 模式下，工具提示还会显示听写快捷键。

SSH

• SSH worktree、目标、口令短语、默认身份文件。
• 高级：代理 / 跳板主机；Reuse SSH connection for faster setup（系统 OpenSSH 复用；默认开启）。
• Kerberos 主机：OpenSSH 配置中的 GSSAPIAuthentication 驱动系统 OpenSSH 认证（参见 SSH worktree）。

Remote DevAgent Servers

• 配对并连接到远程 DevAgent 运行时。
• 将此桌面应用宣告为服务器，并创建可吊销的访问链接。
• 为服务器路由的项目、终端和提供方检查做高级默认运行时选择。

Shortcuts

• 完整键位映射 —— 每个绑定都可重新映射。
• Toggle Sleeping Workspaces 出厂未绑定；如果你想为侧边栏的休眠 worktree 筛选设置一个直接快捷键，可在此处指派。
• Close all editor 标签页 在 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 中保留已自定义的覆盖设置。
• Add Review Note 在 macOS 上默认为 Cmd+Shift+A，在 Windows / Linux 上为 Ctrl+Shift+A；可重新映射。
• Send Review Notes to Agent 出厂未绑定；在此处指派后，即可不用鼠标就打开当前 worktree diff 笔记的发送菜单。

Repository

• 按仓库的 base ref 和钩子。
• worktree 创建时自动运行的命令。
• 侧边栏的仓库图标：选择一个图标、完整的可搜索 emoji 选择器、上传的图片、网站 favicon 或 GitHub 头像，然后选择一个预设或自定义的十六进制徽标颜色。
• 针对提交信息、pull request 详情和分支名的 Source Control AI 覆盖设置。
• Worktree Shared Paths —— 从主检出向每个新 worktree 具体化的 gitignore 路径（macOS 上尽可能使用 APFS clone-copy，否则用符号链接）。它是对 orca.yaml 中仓库签入的 worktree.sharedDirectories 和 .worktreeinclude 的补充（参见 Worktree）。

Floating Workspace

• Enable Floating Workspace —— 用于终端、浏览器和 markdown 标签页的全局界面，这些标签页不绑定到某个仓库 worktree。
• Terminal Directory —— 新浮动终端标签页的起始目录（~ = 家目录）。
• Toggle Button Location —— 浮动工作区切换按钮出现的位置；无论按钮放在哪里，键盘快捷键都有效。

Plugins（实验性）

• Plugin system —— 设置 → 插件。先开启整个系统，然后逐个审阅并启用各插件。在你同意之前不会有任何东西运行。
• Marketplaces —— 添加一个 git marketplace 源，浏览插件，预览能力（面板、命令、语言包、VM 配方），安装、更新或回滚。
• 插件 worker 始终在本机上运行；SSH 工作区操作仍通过 DevAgent 路由。
• 能力和 API 形态可能变化；请把第三方插件当作不受信任的软件对待。

Experimental

• Activity Page —— Slack 风格的 worktree 动态流，用于 agent 事件。
• 紧凑 worktree 卡片 —— 在布局仍属实验性阶段时隐藏侧边栏中冗余的第二行。
• Agent hibernation —— 暂停空闲的后台 agent，并在重新打开时自动恢复它们。
• Agent Dashboard —— Needs You / Working / Done（可选 Idle）agent 的看板，外加实验性的 Agent Map；带搜索和项目/工作区/PR 筛选；可在窗口内打开或作为弹出窗口。Show idle agents 位于看板设置控件中，而不在此处。参见 Agent 与会话。
• Chat UI —— 在受支持的 agent 终端上的可选聊天界面。参见 Chat UI。
• Cloud VM —— 为仓库自有的按需环境（云沙箱、VM 或本地 Docker）显示设置控件和工作区 Run on 目标。设置指南和配方安装位于这个实验性开关之下。参见 运行 DevAgent 的多种方式。
• 尚不稳定的功能 —— 行为可能变化。