AI 智能体会话
本章介绍 VelaTerm 如何以带类型的会话来运行 AI 编程智能体：支持的智能体、实时状态、自动恢复对话、导入与分叉对话、权限模式、启动设置、安装引导以及信息面板。会话视图另有专门章节：会话视图。
1. 支持的智能体
VelaTerm 可以启动以下智能体：Claude Code（显示为「Claude」）、Codex、OpenCode、Copilot、Cursor、Antigravity、Cline、Pi、OMP、Crush、Kimi Code、Kiro、Grok Build 和 Zoo Code。各智能体自身的 CLI 需要先安装并完成登录。
各智能体支持的功能有所不同：
| 智能体 | 状态报告方式 | “需要你处理”状态 | 恢复 | 分叉 | 权限控制 | 会话视图 |
|---|---|---|---|---|---|---|
| Claude Code | 由智能体报告 | ✅ | ✅ | ✅ | 五种模式 | ✅ |
| Codex | 由智能体报告 | ✅ | ✅ | ✅ | 三种模式 | ✅ |
| OpenCode | 由智能体报告 | ✅ | ✅ | ✗ | 两种模式 | ✅ |
| Copilot | 由智能体报告 | ✅ | ✅ | ✗ | 跳过确认开关 | ✗ |
| Cursor | 由智能体报告 | ✗ | ✅ | ✗ | 跳过确认开关 | ✗ |
| Antigravity | 由智能体报告 | ✗ | ✅ | ✗ | 跳过确认开关 | ✗ |
| Cline | 由智能体报告 | ✗ | ✅ | ✗ | 跳过确认开关 | ✗ |
| Pi | 由智能体报告 | — | ✅ | ✅ | 无（Pi 不会请求确认） | ✅ |
| OMP | 由智能体报告 | ✅ | ✅ | ✅ | 跳过确认开关；会话视图中为两种模式 | ✅ |
| Crush | 部分由智能体报告，部分从屏幕识别 | ✅ | ✅ | ✗ | 跳过确认开关 | ✗ |
| Kimi Code | 由智能体报告 | ✅ | ✅ | ✗ | 跳过确认开关 | ✗ |
| Kiro | 由智能体报告 | ✗ | ✅ | ✗ | 跳过确认开关 | ✗ |
| Grok Build | 由智能体报告 | ✅ | ✅ | ✗ | 跳过确认开关 | ✗ |
| Zoo Code | 从屏幕识别 | ✅ | ✅ | ✗ | 跳过确认开关 | ✗ |
- 由智能体报告是指智能体自己会在开始工作、需要你处理和完成时通知 VelaTerm，因此状态是准确的。如果 Codex 的版本支持生命周期钩子，它会报告每个阶段；较旧的 Codex 版本只在回合结束时报告。“需要你处理”一列显示 ✗ 的智能体不会报告提问或权限提示，因此在回合结束前，会话会一直显示为“工作中”。
- 从屏幕识别是指 VelaTerm 通过智能体的终端界面识别其状态。
- 对于 Copilot、Cursor、Antigravity、Kimi Code、Kiro 和 Grok Build，首次启动此类会话时，VelaTerm 会在该智能体的用户配置中添加自己的配置项。智能体在 VelaTerm 之外运行时，这些配置项不起任何作用。
- 你在普通终端中自行启动的智能体不受影响；状态报告仅适用于由 VelaTerm 启动的智能体会话。
2. 创建智能体会话
- 右键菜单。右键点击项目、分组或会话。菜单第一级提供三个智能体：最初是 Claude、Codex 和 OpenCode，之后会变为你最近创建过的三种智能体类型。「更多智能体会话」列出所有智能体、你保存的预设、「自定义参数新建…」以及「新建智能体会话」（可搜索的选择器）。
- 新建智能体会话选择器。在 macOS 上按 ⌘N（Windows、Linux 以及普通浏览器中为 Ctrl+Alt+N）会打开可搜索的智能体和预设列表，最近的选择标有「上次使用」。详见设置与快捷键 §9。
- 子会话。会话的「新建子会话」子菜单会在该会话下创建新会话。也可以在对话中启动会话，详见会话派生与 Git 协作。
选择自定义参数新建…，会打开一个对话框，其中包括智能体类型（「Agent 类型」）、可选的名称（「会话名称（留空自动命名）」）、「启动参数（可选）」、「可执行文件（可选）」（仅供本会话使用的替代可执行文件）、权限设置、「打开方式」（「终端视图」或「会话视图」，仅对两者都支持的智能体显示）以及「Worktree」选项。「存为预设」会以一个名称保存这些设置，并可选配图标。预设会出现在菜单和选择器中，启动时使用其保存的可执行文件、参数和权限设置。
Claude、Codex、OpenCode、Pi 和 OMP 会话默认以会话视图打开；其他智能体以终端视图打开。可在「设置 ▸ 智能体 ▸ 默认视图」中按智能体分别更改。
3. 状态点：谁在工作，谁需要你处理
每个智能体会话旁的圆点会实时更新：
| 圆点 | 含义 |
|---|---|
| 绿色，脉动 | 正在工作 |
| 黄色，脉动 | 需要你处理：提问或权限请求 |
| 黄色，波纹扩散，该行显示黄色条 | 未读：你在查看其他内容时，智能体已完成或提出了问题 |
| 洋红色 | 已回复，且你已查看 |
| 蓝色 | 正在运行，但没有报告智能体活动 |
| 红色 | 出错 |
| 灰色 | 无法获取状态 |
当智能体停下来等你处理时（提问、权限请求或回合结束），你会收到系统通知，该会话被标记为未读，并计入 Dock 角标。如果你正在查看该会话，则不会弹出通知。在已签名的 macOS 版本中，点击通知即可打开对应会话。状态栏中的「通知：开」/「通知：关」用于开启或关闭系统通知；未读标记和通知标识仍会保留。存在通知标识时，左栏顶部会显示一个按钮，用于清除全部通知标识。
状态栏中的「工作中」「等待处理」和「已查看」计数可将左栏筛选为处于相应状态的会话，详见界面与会话管理 §6。
4. 自动恢复：关闭后再打开，对话照常继续
一句话概括：项目树中的每个智能体会话节点都是一段持续进行的对话。
- 首次运行时，VelaTerm 会记下智能体自身的对话 ID。
- 此后，无论你是关闭了标签页还是退出了应用，再次打开该节点都会继续同一段对话。恢复之前，VelaTerm 会检查该对话是否仍然存在；如果对话已被删除，会话会重新开始，而不会报错。
- 如需开始新的对话，请新建一个会话节点。在会话视图中，
/clear会在原位置用一个新的空会话替换当前会话。
「新建会话」菜单末尾的恢复会话…，用于添加你已有的对话，例如你在普通终端中运行过的对话。选择「Agent 类型」，粘贴该智能体的对话 ID，然后选择「恢复并打开」。§1 中的所有智能体类型都可以通过这种方式恢复。
项目右键菜单中的导入会话…，会列出工作目录恰好为该项目目录的已有 Codex、Claude、OpenCode 和 Kiro 对话。可以按标题、智能体或会话 ID 搜索（「搜索标题、Agent 名称或会话 ID」），选中若干行后选择「导入」。这些对话会加入项目树，打开即可继续。导入不会复制或更改智能体自身的历史记录。已在 VelaTerm 中的对话（包括已归档的）会标记为「已导入」。位于子目录或独立工作树中的对话，只有在将该目录作为单独的项目打开时才会出现。Kiro 的历史记录目前只能查看纯文本记录。连接到远程 VelaTerm 时，列表来自远程计算机。
5. 分叉：从对话中分出新分支
对于已有对话的 Claude、Codex、Pi 和 OMP 会话，右键点击 →「Fork 会话」。这会创建一个同级节点，它从源对话当前的历史记录开始，源对话保持不变，类似于 git 分支。可以用它在同一上下文的基础上尝试两种不同的方案。
6. 权限
权限设置决定智能体在不询问你的情况下可以执行多少操作。
- Claude、Codex 和 OpenCode 提供具名模式。Claude：「计划模式」「每次询问」「自动接受改动」「自动判断」「全部放行」。Codex：「只读」「自动判断」「完全访问」。OpenCode：「每次询问」「全部放行」。
- Copilot、Cursor、Antigravity、Cline、OMP、Crush、Kimi Code、Kiro、Grok Build 和 Zoo Code 只有一个开关「跳过全部权限确认」，开启后会以智能体自身的跳过确认选项启动它。在会话视图中，OMP 提供「每次询问」和「全部放行」。
- Pi 运行工具时不会询问，因此没有权限设置。
可以在以下位置更改：
- 单个会话：会话的「编辑」表单（「权限」，或「跳过全部权限确认」复选框）；在终端视图中，使用状态栏中的权限项（「权限：询问」/「权限：跳过」，或当前模式名称）；在会话视图中，使用输入框下方的权限控件。
- 新会话的默认值：「设置 ▸ 智能体 ▸ 权限」。状态栏和会话视图中的菜单也提供「设为默认」。
部分更改需要重启智能体后才能生效。此时 VelaTerm 会提供「立即重启」或「稍后」；重启后对话会恢复，但正在运行的任务会被中断。「全部放行」「完全访问」和「跳过全部权限确认」会跳过所有确认，请谨慎使用。
7. 启动设置与安装引导
启动参数。会话的「编辑」表单中有「启动参数（可选）」，用于为该会话添加命令行参数。「设置 ▸ 智能体」中可为每种智能体类型设置默认值。
可执行文件路径。如果智能体安装在 PATH 之外，请在「设置 ▸ 智能体」中设置其「可执行文件路径（可选）」。留空时，会在 PATH 中查找该命令。
未安装时：启动尚未安装的智能体，会话中会显示一张卡片「<Agent> 未安装」，并附有适用于你所用系统的推荐安装命令。
- 「一键安装」会在会话中运行该命令。找到安装好的程序后，其路径会保存到设置中，并弹出对话框，提供「立即重启」或「稍后」。
- 「重试启动」会重新启动会话，例如在你自行安装智能体之后。
- 如果智能体已安装在 PATH 之外，请在「可执行文件路径」中输入完整路径并选择「使用该路径」，或使用「浏览…」选择。
- 「安装文档」会打开该智能体的安装文档；「我自己装」会关闭该卡片。
安装完成后，各智能体仍需完成自身的登录或配置 API 密钥。
8. 信息面板：用量、上下文与资源
打开智能体会话后，右栏的「信息」标签页会显示：
- 智能体：智能体类型、会话名称、工作目录、Git 分支、启动时间和运行时长。对于 Kiro 会话，还提供一个链接，可以只读方式查看对话历史。
- 用量（Claude、Codex、Grok Build）：账号额度的使用情况，例如五小时和七天窗口的用量及其重置时间。↻ 按钮可立即刷新。自动刷新及其间隔在「设置 ▸ 行为」中设置（「额度自动刷新」「额度刷新」）。刷新失败时，上次的数值仍会显示，并带有「stale」标记。
- 本回合（Claude、Codex、Grok Build、OpenCode、Pi、OMP、Kiro）：模型、上下文窗口的占用程度，以及当前回合的 token 数和所用工具。
- 资源：会话进程的 CPU 和内存占用；勾选「system」选项后，还会显示整台计算机的数据。
9. 对话记录、导出与归档
- 右键点击 →「导出会话…」（适用于已有对话的 Claude 和 Codex 会话）会将完整对话写入 Markdown 文件，包括推理过程以及每次工具调用的输入和结果。
- 会话菜单中的「整理到会话知识库」会让智能体从对话中提取可复用的知识，详见会话知识库。
- 已归档的会话可以在知识库的「已归档会话」视图中查看。Claude、Codex、OpenCode、Pi、OMP、Grok Build 和 Kiro 的对话以消息形式显示；其他智能体如果有终端录制，则显示终端录制。恢复已归档的会话会保留其对话 ID，因此可以照常继续对话。详见界面与会话管理 §8。
10. 其他行为
- 自动命名：未命名的会话会以你发送的第一条消息作为名称。
- 主题切换：在亮色和暗色主题之间切换时，以终端视图运行的 Claude 会话会随之更新，无需重启。
- Vela 技能：「设置 ▸ 通用 ▸ Vela 技能」会为 Claude Code 和 Codex 安装一组技能，用于启动子会话、打开文件，以及读取其他会话或向其发送消息，详见会话命令。
- Windows：Claude Code 和 Codex 获得完整支持（在 PowerShell 中运行）；其他智能体尽力提供支持。