文档 / 终端

Orca 的终端与 VS Code 所使用的终端相同，都基于 xterm.js，并针对 AI 智能体工作流做了一些额外增强。

窗格与标签页¶

终端就是标签页——参见 标签页、窗格与拆分布局。拆分终端窗格可得到并排的两个 shell。

智能体终端标签页会显示智能体身份和实时状态：正在工作、等待输入、已完成或已完成但未读。对于 Claude 和 Codex，当 Orca 能将窗格映射到相应会话时，标签标题还可以显示 AI Vault 对话名称（自定义标题 / 线程名称）——手动重命名仍然优先。

TUI 剪贴板（OSC 52）¶

许多终端 UI（Zellij、tmux、Neovim、fzf、Grok）通过 OSC 52 而非操作系统剪贴板 API 进行复制。Orca 默认 允许这些写入，因此远程/TUI 复制在 SSH 上与本地一样工作。

可在 设置 → 终端 → 允许 TUI 剪贴板写入（OSC 52） 中切换。

搜索¶

Cmd-F 打开回滚搜索。支持匹配高亮、区分大小写、正则表达式和匹配导航。

链接操作¶

普通单击终端链接（HTTP/OSC 8 URL、文件路径、工作区、终端或任务句柄）会打开一个紧凑的操作弹窗，而不是立即导航。本地 Web 链接以及由经能力验证的配对运行时拥有的链接提供 Orca 浏览器 和 系统浏览器；SSH 拥有的链接和较旧的运行时则仅使用系统浏览器。Web 链接还提供 复制链接，可复制解析后的 URL（包括隐藏的 OSC 8 目标），而无需关闭弹窗——文件和工作区目标保持不变。Cmd-单击（macOS）/ Ctrl-单击（Windows / Linux）仍会直接打开，Shift+Cmd / Shift+Ctrl-单击仍使用链接路由替代方案。

可预览的 HTML 文件链接可在本地、SSH 和配对运行时工作区中用 Orca 打开；远程文件行还提供 下载并使用默认应用打开。如果链接的文件已在相邻工作区标签页中打开，Orca 会激活该标签页，而不是打开重复标签页。参见 HTML 查看器。

可在 设置 → 浏览器 → 显示终端链接操作 下关闭该弹窗。关闭后，打开链接需要按住修饰键单击。

复制终端上下文¶

右键单击终端并选择 复制上下文，可从该窗格复制一段有界记录。当你希望将最近的智能体输出粘贴到另一个工具、而无需启动 Orca 分叉时，可使用此功能。

主题¶

终端颜色主题可在 设置 → 终端 下配置。Orca 附带一个常用主题库，你可自定义其中的任何主题。

Ghostty 导入¶

如果你使用 Ghostty，Orca 可以在首次启动时导入其主题、字体和光标配置。你之后可以从 设置 → 终端 → 从 Ghostty 导入 重新运行导入。

Warp 主题导入¶

如果你在 Warp 中收集过主题，请在 设置 → 终端 下的终端主题选择器中点击 从 Warp 导入主题，将它们作为 Orca 终端主题导入。Orca 会扫描当前操作系统的 Warp 主题目录（macOS 上为 ~/.warp/themes，Linux 上为 $XDG_DATA_HOME/warp-terminal/themes，Windows 上为 %APPDATA%\warp\Warp\data\themes），并让你选择要导入的 YAML 主题。它旁边的 从 YAML 导入 按钮会打开同一选择器，并将其指向任意包含 Warp 格式 .yaml/.yml 文件的文件夹——当你将主题存储在与默认位置不同的地方时，这很有用。

导入的主题会与 Orca 内置主题一同出现在主题下拉菜单中。

Windows Shell¶

在 设置 → 终端 下，可在 PowerShell、命令提示符和 WSL 之间配置 Windows 的默认 shell。当 wsl.exe --status 执行成功时，WSL 会自动提供。标签栏上的 + 下拉菜单还会显示一个子菜单，这样你就可以在不更改默认设置的情况下，在任何 shell 中打开一次性标签页。

对于位于 WSL 文件系统（\\wsl.localhost\...）上的仓库，Orca 会通过 wsl.exe -d <distro> 启动。对于在 WSL 中打开的 Windows 路径仓库，Orca 会将 cwd 转换为 /mnt/<drive>/...，并将你放入一个登录 bash。

快捷键¶

• Cmd-T — 在当前工作树中新建终端标签页。
• Cmd-Alt-T（macOS）— 使用默认智能体新建智能体标签页。在 Linux 和 Windows 上，此组合键默认未绑定；可在 设置 → 快捷键 下指定（搜索“New agent tab”）。每个受支持的智能体还有各自的“New agent tab”操作——可绑定组合键直接启动特定 CLI，而无需通过默认智能体。
• Cmd-W — 关闭当前标签页。
• Cmd-\ — 向右拆分。
• Cmd-Shift-\ — 向下拆分。

原生按键绑定¶

Orca 会通告 kitty 键盘协议，因此终端应用可以接收到真正的 Shift+Enter、Ctrl+Enter 及其他感知修饰键的按键——这些绑定在 Orca 中的工作方式与在 Ghostty、WezTerm 或你的本机终端中相同。

对于 macOS 上的日语 JIS 键盘，如果你希望物理 Yen（¥）键在终端会话中发送反斜杠，请启用 设置 → 终端 → JIS Yen（¥）到反斜杠 (\)。

浮动终端¶

浮动终端是一个全局 shell 操作面，无论你位于哪个工作树或标签页，都只需一个组合键即可随时调出。新安装默认启用。

• 使用 Cmd+Option+A（macOS）/ Ctrl+Alt+A（Linux/Windows）切换。如果面板已打开，同一组合键会聚焦面板；如果面板已聚焦，则会将其关闭。
• 点击窗口边缘的浮动按钮，或在 设置 → 终端 → 浮动终端 下将触发按钮移动到状态栏。
• 在同一设置下设置启动工作目录（默认 ~），以便新的浮动标签页落在你期望的位置。
• 浮动面板拥有自己的标签页，并支持编排设置——无需占用工作树窗格即可启动后台运行。

快速命令¶

快速命令可保存你经常运行的终端命令，例如 npm run dev、pnpm test 或项目特定的设置脚本。它们还可以为启动时提示型智能体（例如 Claude 和 Codex）保存可复用的智能体提示词。可通过 设置 → 快速命令 或标签栏上的 添加命令 按钮创建，然后从工作树标签栏中的“快速命令”拆分按钮或终端上下文菜单运行它们。

每条命令都有一个标签、命令文本和作用域。对于在所有位置都适用的命令，使用 全局；对于仅在特定仓库的工作树中显示命令，使用 项目。标签栏按钮会打开一个新的终端标签页并运行该命令；终端上下文菜单可以将命令插入当前终端。使用命令行上的复制控件（设置列表、标签栏菜单或移动端快速命令）可将命令内容复制到剪贴板。

当你使用配对的远程 Orca Server（或其他执行主机）时，选择器可以并排显示 本地和远程 集合，并按主机标注（例如 本地 Mac 和 Orca Server）。保存于 表示命令的存储位置；运行命令仍会在你调用它的终端或工作区中执行——因此，客户端拥有的命令可以在远程工作树中运行。未声明支持多主机快速命令的旧版服务器会回退到仅本地列表。