设置与快捷键
点击标题栏中的齿轮按钮即可打开设置。在 macOS 上，应用菜单中也有「设置…」（⌘,）；在 Windows 和 Linux 上，按 Alt 后选择「文件 ▸ 设置…」。设置窗口包含八个类别：通用、外观、终端、会话视图、行为、高级、智能体和快捷键。本章逐项说明各设置，最后列出默认快捷键。桌面版与连接到它的浏览器客户端共用同一套设置。
1. 通用
| 设置项 | 说明 |
|---|---|
| 语言 | 界面语言。「自动（跟随系统）」会使用系统语言；共提供十一种语言 |
| 通知提示音 | 通知的提示音（默认开启） |
| 系统通知 | 开启或关闭系统通知（默认开启）。如果系统尚未允许通知，可点击「允许通知」申请权限；如果通知已被屏蔽，会显示适用于你所用系统的操作步骤 |
| Shell 命令 | 仅限 macOS 桌面版：「安装 ‘vela’ 命令」会将 vela <project-path> 添加到你的 shell 中，用于在 VelaTerm 中打开项目。「卸载 ‘vela’ 命令」会将其移除 |
| Vela 技能 | 「安装」（安装后变为「重新安装」）会为 Claude Code 和 Codex 安装 VelaTerm 技能，例如 /vspawn 和 $vspawn。如果 Codex 中没有列出这些技能，请新开一个 Codex 会话。详见会话命令 §2 |
2. 外观
| 设置项 | 说明 |
|---|---|
| 强调色 | 界面的强调色：「跟随明暗」或四种颜色之一 |
| 密度 | 「紧凑」「标准」（默认）或「宽松」 |
| 分屏 | 分屏样式：「无缝」（默认）或「卡片」 |
| 分隔条 | 「极细」（默认）或「可见」 |
| 左栏 | 「标准」（默认）或「紧凑」 |
| 界面字体 | 界面使用的字体 |
| 界面字号 | 界面的字号；「自动」会根据密度确定 |
亮色和暗色主题在标题栏中切换（跟随系统、暗色、亮色），不在此处设置。以终端视图运行的 Claude 会话会随主题切换而更新，无需重启。
3. 终端
| 设置项 | 说明 |
|---|---|
| 图片粘贴 | 「粘贴文件路径」（默认）会将粘贴的图片保存为临时文件并插入其路径。「原生图片粘贴」让 Claude Code 或 Codex 从剪贴板读取图片，仅在本地桌面版中可用 |
| 命令补全提示 | 「自动提示」「按 Tab 提示」或「完全关闭」。修改后立即生效，已打开的终端也适用；在不支持的平台上不显示。详见命令补全提示 |
| 默认 Shell | 新终端使用的 shell。仅在提供多种 shell 的 Windows 上显示；macOS 和 Linux 始终使用系统 shell |
| 终端字体 | 终端使用的字体 |
| 终端字号 | 终端的字号（默认 13）。使用过程中可用 ⌘+ / ⌘- / ⌘0 调整 |
| 终端行高 | 终端的行距（默认 1.2×） |
4. 会话视图
这些设置作用于智能体会话的会话视图，详见会话视图。
| 设置项 | 说明 |
|---|---|
| 会话字体、会话字号、会话行高 | 对话的排版，与终端设置相互独立（默认字号 13.5，行高 1.2×） |
| 输入工具栏 | 决定输入框旁显示哪些控件及其顺序：模型、思考程度、协作模式、权限模式、快速模式、速度、语气、MCP 服务器、后台任务、账号和 Codex 额度重置券。每个控件都有开关；箭头用于调整已开启控件的顺序。模型、思考程度、协作模式和权限模式默认开启 |
当前智能体或模型不支持的控件不会显示。受支持的控件在其功能暂时不可用时仍会显示，例如智能体进程停止时的「MCP 服务器」和「后台任务」。
已关闭的控件以及输入框旁放不下的控件都位于更多菜单中，因此无需先在这里开启，就可以使用所有受支持的控件。当所有受支持的控件都已开启且放得下时，不会显示「更多」。关闭后再次开启的控件会移到该行末尾。在移动端，已关闭的控件显示在第二行。
5. 行为
| 设置项 | 说明 |
|---|---|
| 标签页 | 「单标签」（默认）在打开智能体会话时复用当前标签页，之前的标签页在后台继续运行。「多标签」让每个会话在单独的标签页中打开 |
| 状态筛选动态增加 | 左栏的状态筛选生效时，之后变为符合条件的会话会被加入筛选结果（默认开启） |
| 后台保活上限 | 在单标签模式下显示：后台标签页的最大数量（8、16、32 或 64；默认 32）。超出上限时，最早的不活跃后台标签页会被结束 |
| 派生前确认 | 启动子会话前显示确认卡片（默认开启），详见会话派生与 Git 协作 §4 |
| 额度自动刷新 | 让信息面板中的账号用量保持最新（默认开启） |
| 额度刷新 | 刷新间隔：30 秒、1 分钟、2 分钟或 5 分钟（默认 5 分钟） |
| 额度重置后自动继续 | 五小时或每周用量上限重置后，自动继续 Claude 或 Codex 的任务（默认开启） |
| 自动清理粘贴图片 | 应用退出时删除粘贴图片产生的临时文件，并在启动时删除超过 24 小时的此类文件（默认开启）。「立即清理」会立即删除它们 |
会话引用上下文决定 vrefer --ask（以及 vask 技能）如何将另一个会话的对话交给负责回答的智能体。「使用全文」（默认）会传递完整对话。「先总结」会先用此处选定的「总结智能体」、模型和推理强度压缩对话。详见会话命令 §5。
6. 高级
| 设置项 | 说明 |
|---|---|
| 终端渲染器 | 「DOM」（默认）或「WebGL」。除非有特定理由，否则请保持默认设置 |
| 切回标签时重绘 | 切回终端所在的标签页时完整重绘终端（默认关闭）。如果切换后终端界面偶尔显示错乱，请开启此项 |
| 前台优先输出 | 其他标签页中的智能体产生大量输出时，保持输入的响应速度（默认开启） |
| 记录会话日志 | 将智能体会话的终端输出保存到日志文件中（默认关闭）。开启后，已归档的会话可以回放，全局搜索也会覆盖终端输出。普通终端会话从不录制 |
7. 智能体
「新会话默认设置」作用于所选智能体新创建的会话。为单个会话所做的设置优先，但可执行文件路径除外，它始终作用于整个智能体类型。
| 设置项 | 说明 |
|---|---|
| Agent 类型 | 正在编辑其默认设置的智能体 |
| 可执行文件路径（可选） | 智能体可执行文件的完整路径。留空时，会在 PATH 中查找该命令。一键安装成功后会自动填写 |
| 启动参数（可选） | 默认的命令行参数，例如 --model opus |
| 权限 | 新会话的默认权限。Claude、Codex 和 OpenCode 提供各自的具名模式；其他大多数智能体提供「默认」和「YOLO」（跳过全部权限确认）；Pi 没有权限提示。详见AI 智能体会话 §6 |
| 默认视图 | 适用于 Claude、Codex、OpenCode、Pi 和 OMP：新会话使用「会话视图」（默认）或「终端视图」。已有会话保留原来的视图 |
8. 快捷键
点击某个操作的组合键，然后按下新的组合键；按 Escape 取消。组合键由一个字母加上 ⌘（macOS 桌面版）或 Ctrl 组成，还可以加上 Shift 和 Option/Alt。如果该组合键已被占用，提示信息会指出占用它的操作。「恢复默认」会重置所有快捷键。
| 操作 | macOS 桌面版 | Windows、Linux |
|---|---|---|
| 打开项目 | ⌘O | Ctrl+Alt+O |
| 新建终端 | ⌘T | Ctrl+Alt+T |
| 新建智能体会话 | ⌘N | Ctrl+Alt+N |
| 新建浏览器标签（仅限桌面版） | ⌘⇧B | Ctrl+Alt+B |
| 向右分屏 | ⌘D | Ctrl+Alt+D |
| 向下分屏 | ⌘⇧D | Ctrl+Alt+E |
| 关闭分屏/标签 | ⌘W | Ctrl+Alt+W |
| 在终端内搜索 | ⌘F | Ctrl+Alt+F |
| 搜索所有会话 | ⌘⇧F | Ctrl+Alt+G |
| 保存文档 | ⌘S | Ctrl+S |
普通浏览器。在普通浏览器中使用 VelaTerm（通过 URL 远程访问）时，由于浏览器自身占用了许多 ⌘ 和 Ctrl 组合键，上表中 Windows 和 Linux 的快捷键适用于所有系统，设置页面也会按此显示。例外情况是 macOS 上的浏览器：向右分屏和向下分屏仍为 ⌘D 和 ⌘⇧D。桌面版的远程连接窗口使用桌面版的快捷键。
固定按键不可更改：⌘1–9 用于切换标签页，⌘+ / ⌘- / ⌘0 用于调整或重置终端字号（Windows、Linux 以及浏览器中使用 Ctrl）。
9. 新建智能体会话选择器
「新建智能体会话」会打开一个可搜索的列表，其中包含智能体类型和已保存的预设（「搜索智能体和预设」）。最近使用的选项排在最前面，并标有「上次使用」。
选择器会显示会话的创建位置。当前处于某个已保存的会话中时，选择「同级」会在其旁边创建新会话，选择「子会话」则会在其下创建。搜索框获得焦点时：
- 按 Tab 在「同级」和「子会话」之间切换。
- 按 ↑ 和 ↓ 选择结果，按 Enter 创建会话。
- 按 Shift+Tab 将焦点移到上一个控件；按 Escape 关闭选择器。
也可以点击某个结果，然后选择「新建」。如果没有可用的项目，请先选择一个项目或使用「打开项目」。
选择器有自己的地址，其中保存了目标、位置、搜索文本和当前选择。复制链接、刷新页面或后退、前进时，都会恢复选择器，而不会创建会话。如果创建失败，选择器会保持打开，以便你重试。
10. 其他按键
| 位置 | 按键 | 作用 |
|---|---|---|
| 会话视图 | Enter / Shift+Enter | 发送 / 换行 |
| 会话视图，智能体工作期间 | ⌥Enter（Alt+Enter） | 将消息加入正在进行的回合 |
| 会话视图，智能体工作期间 | ⌘Enter（Ctrl+Enter） | 停止当前回合并发送这条消息 |
| 会话视图，智能体工作期间 | Esc | 停止当前回合 |
| 派生确认卡片 | ⌘Enter（Ctrl+Enter） | 启动会话 |
| 标签栏 | 鼠标中键点击 | 关闭标签页 |
| 左栏 | ⌘/Ctrl 加点击、Shift 加点击 | 选择多个会话，或选择一个范围 |