终端使用

本章介绍终端本身：输入与输出、终端内搜索、复制与粘贴、图片粘贴、命令补全提示、内置的 v 系列命令、用 vrun 启动的后台命令、Windows 上的 Shell 选择、会话录制、渲染器设置以及快捷键。

1. 基础

终端会话运行的是真实的 shell。在 macOS 和 Linux 上使用系统默认 shell（$SHELL）；在 Windows 上默认使用 cmd，也可以更改（见 §7）。工作目录默认为项目根目录。在会话的编辑表单中，可以修改「工作目录（留空用项目根）」，并设置「启动命令（可选）」，该命令会在每次会话启动时运行（例如 pnpm dev）。

多个智能体同时产生大量输出时，VelaTerm 会优先处理你的输入和当前可见的标签页，并限制后台标签页的输出速度。此行为由「设置 ▸ 高级 ▸ 前台优先输出」控制（默认开启）。如果切换标签页后全屏程序显示错乱，可点击分屏顶部的「重绘」按钮重新绘制。开启「设置 ▸ 高级 ▸ 切回标签时重绘」后，每当标签页变为可见时都会自动重绘。

2. 终端内搜索（⌘F）

按 ⌘F 会打开搜索栏（「在终端中搜索」），用于搜索当前终端的回滚内容，并提供上一个和下一个按钮：

如需跨会话搜索历史内容，请使用全局搜索（⌘⇧F），详见界面与会话管理。

3. 复制与粘贴

• 用鼠标选中文本后，使用 ⌘C / ⌘V 或右键菜单（「复制」「粘贴」「全选」「清屏」「搜索…」）。
• 在会捕获鼠标的程序中（vim、htop 以及大多数智能体界面），拖动时按住 Option（macOS）或 Shift（Windows 和 Linux），即可强制进行普通的文本选择。
• Claude Code、Codex 等智能体界面可以自行复制文本。如果它们刚刚复制过文本，且终端中没有选中任何内容，右键菜单会显示「已自动复制 N 字符 · ⌘V 粘贴」。

4. 粘贴图片

要把图片交给命令行智能体，可以将图片粘贴或拖入终端。「设置 ▸ 终端 ▸ 图片粘贴」提供两种方式：

• 粘贴文件路径（默认）：图片会保存为临时文件，其路径会插入到提示符处，任何能读取文件的智能体都可以打开它。Codex 收到的形式为 image_path: …。
• 原生图片粘贴：由 Claude Code 或 Codex 从系统剪贴板读取图片，并显示其自身的图片占位符。此选项仅在本地桌面版中可用；远程会话始终粘贴文件路径，以便智能体在其所在的机器上读取图片。

「设置 ▸ 行为 ▸ 自动清理粘贴图片」会在应用退出时删除这些临时文件，并在启动时清理超过 24 小时的残留文件。「立即清理」会立即删除它们。插入到文档中的图片不受影响。

5. 命令补全提示

在 macOS 和 Linux 的普通终端会话中，VelaTerm 可以根据 shell 自身的补全定义显示建议列表。「设置 ▸ 终端 ▸ 命令补全提示」可选择「自动提示」（默认）、「按 Tab 提示」或「完全关闭」。使用方向键选择候选项，按 Tab 插入；按 Enter 则始终按已输入的内容运行命令。当选择无法继续移动时，上下方向键会交还给 shell，因此在第一个候选项上按上方向键会调出上一条命令。Windows 上不提供该列表。完整说明见命令补全提示。

6. 内置命令

VelaTerm 启动的每个会话的 PATH 中都有一组简短的命令。这些命令无需安装，在普通终端和智能体会话中均可使用：

使用 --help 运行命令可查看其选项；会话命令一章详细介绍了每个命令。这些命令大多也以技能的形式存在于 Claude Code（/vopen）和 Codex（$vopen）中；vrun 和 vflow 没有对应的技能，而 vask 只以技能的形式存在。这些技能通过「设置 ▸ 通用」中的「Vela 技能」按钮安装。

vopen 会根据文件类型选择视图：

vopen README.md          # Markdown → Markdown editor
vopen src/main.rs        # source code → code editor with syntax highlighting
vopen diagram.png        # image → image viewer
vopen https://crates.io  # web address → browser tab (desktop app only)

相对路径以当前目录为基准解析，并且可以一次打开多个文件。文档标签页的说明见文档与浏览器标签页；vspawn 的说明见会话派生与 Git 协作；vkb 的说明见代码图谱与知识库和本地知识库。

6.1 后台命令（vrun）

vrun <label> <command...> 会启动一条命令并等待其完成，然后输出退出码、耗时以及日志末尾。因此，智能体用 vrun 启动耗时较长的构建或测试时，结果一出来就能得知。关闭会话不会停止该命令。vrun --status <label> 报告之前启动的命令的情况，-t <seconds> 设置等待时长（默认 1800 秒）；等待超时后，vrun 以退出码 124 退出，命令则继续运行。

此类命令运行期间，终端上方会出现「后台命令」行。每一项都会显示其标签和「已运行 …」，并提供用于查看命令输出的「日志」按钮和「停止」按钮；点击「确认停止」即可结束该命令。没有命令运行时，该行会消失。

7. Shell 选择（仅限 Windows）

在 Windows 上，终端会话可以使用任何检测到的 shell：PowerShell、pwsh、cmd、Git Bash，以及所有已安装的 WSL 发行版。可以在「新建终端」子菜单、会话编辑表单中的「Shell（留空用系统默认）」或右键菜单的「Shell」中选择。正在运行的会话会立即以新的 shell 重启。「设置 ▸ 终端 ▸ 默认 Shell」用于设置未明确指定 shell 的新终端所使用的 shell。

只有当 WSL 报告有已安装的发行版时，才会出现 WSL: <distribution> 形式的条目。选择其中一项会启动该发行版，并将会话的 Windows 项目目录映射到其中。WSL 仅适用于普通终端会话；智能体会话仍使用 Windows 主机的 shell。内置的 v 系列命令在 WSL 终端中不可用。

关于内置的 Git Bash：full 安装程序包含完整的 Git Bash（含 git、ssh 和 perl）。min 安装程序只包含核心子集；运行缺少的命令时，会提示下载完整版本，也可以通过右键菜单中的「下载完整 Git Bash」下载。智能体会话不受影响，它们使用 PowerShell。

macOS 和 Linux 上没有 shell 选择器，会话使用系统默认 shell。

8. 会话录制

「设置 ▸ 高级 ▸ 记录会话日志」默认关闭。开启后，VelaTerm 会将以终端视图运行的智能体会话的终端输出保存到本地日志文件中，每个会话最多 50 MB。普通终端会话从不录制。

借助录制，你可以按屏幕上的原样回放已归档的会话，其屏幕文本也可以被搜索。只有在无法读取智能体自身的对话记录时，VelaTerm 才会使用录制；否则，查看和搜索都使用对话记录。录制文件会随其所属会话一起删除。

9. 渲染器

「设置 ▸ 高级 ▸ 终端渲染器」提供 DOM（默认）和 WebGL 两种选项。在桌面版中推荐使用 DOM。早期版本还提供 Canvas 渲染器；该选项现已移除，之前保存为 Canvas 的设置现在会使用 DOM。

10. 常用快捷键

下表列出 macOS 桌面版的默认快捷键。Windows 和 Linux 版的大多数操作用 Ctrl+Alt 代替 ⌘（向下分屏为 Ctrl+Alt+E，搜索所有会话为 Ctrl+Alt+G，保存仍为 Ctrl+S）。浏览器客户端使用基于 Ctrl 的默认快捷键，以避开浏览器自身的快捷键。「设置 ▸ 快捷键」会显示你所用系统上的实际快捷键，除切换标签页和调整字号外，所有操作的快捷键都可以在此更改。