会话视图
会话视图以聊天的形式呈现智能体会话：消息、工具卡片，以及可以直接用按钮答复的权限请求。本章介绍如何在终端视图与会话视图之间切换、在智能体工作时发送消息、输入框下方的控件、回退、后台任务、用量上限，以及如何阅读较长的对话。
1. 什么是会话视图
所有智能体会话都可以在终端视图中运行，由智能体显示自己的终端界面。其中五种智能体还可以在会话视图中运行：Claude Code、Codex、OpenCode、Pi 和 OMP。其他类型的智能体始终使用终端视图。
在会话视图中，对话由 VelaTerm 自行绘制：你的消息、智能体的回答和推理过程、每次工具调用各一张卡片，以及权限请求和提问卡片。通过输入框下方的控件，可以更改模型、推理强度和权限模式，无需重启会话。
两种视图延续的是同一段对话。会话可以从一种视图切换到另一种视图，历史记录会一并保留。
2. 选择视图
按智能体设置默认视图。「设置 ▸ 智能体 ▸ 默认视图」决定该智能体的新会话以哪种视图打开，可选「会话视图」或「终端视图」；五种智能体的默认值都是「会话视图」。已有会话保留创建时的视图。
单个会话。「自定义参数新建…」对话框中有「打开方式」选项，可以让单个会话以另一种视图启动。
切换已有会话。分屏顶部有一个切换按钮：
- 在终端视图中，点击机器人按钮（「会话视图」）可将会话切换到会话视图。
- 在会话视图中，点击终端按钮（「终端视图」）可切换回来。在你关闭提示或使用该按钮之前，会有一条简短的提示指向这个按钮。
如果智能体正在工作，VelaTerm 会先询问：「切换视图将重新启动智能体。当前进行中的回合会中断，对话内容不会丢失。」选择「切换」即可继续。空闲的会话会立即切换。
3. 发送消息
输入框中的提示文字为「给智能体发消息，可用 /命令、/技能 与 @文件」。按 Enter 发送，按 Shift+Enter 换行。光标位于文本开头或末尾时，按 ↑ 和 ↓ 可以调出你在本对话中发送过的消息。
新对话会显示「在下方输入内容，开始对话。」发送第一条消息时，智能体进程才会启动。
智能体工作期间
回合进行期间，输入框中显示「输入消息，本轮结束后将自动发送」。此时有三种发送方式：
| 操作 | macOS | Windows 和 Linux |
|---|---|---|
| 排队：本回合结束后发送 | Enter | Enter |
| 插话：将消息加入正在进行的回合 | ⌥Enter，或「插话」按钮 | Alt+Enter，或「插话」按钮 |
| 中断：停止当前回合，优先发送这条消息 | ⌘Enter | Ctrl+Enter |
五种智能体都支持插话。没有回合在进行时，这些组合键都只是直接发送消息。
排队中的消息显示在「待发送」下。点击消息可以编辑，点击其「插话」按钮可将其加入正在进行的回合，点击 × 可将其移除。排队的消息会在各回合结束后依次发送。
要停止正在进行的回合，请按 Esc 或点击停止按钮（输入框为空时，停止按钮会取代发送按钮，提示为「停止 · Esc」）。对话中会先显示「正在停止当前回合…」，然后显示「当前回合已停止」。
4. 输入框下方的控件
输入框下方的一行控件作用于下一条消息。显示哪些控件取决于智能体和模型：
| 控件 | 智能体 | 作用 |
|---|---|---|
| 模型 | 全部五种 | 选择模型。「跟随 <agent> 默认设置」沿用智能体自身的配置 |
| 思考程度 | 全部五种 | 选择所选模型提供的推理级别；Claude 还提供「关闭」 |
| 协作模式 | Codex、OpenCode | Codex：「默认模式」（直接开始工作）或「计划模式」（先调查并制定计划）。在 OpenCode 中，该控件名为「智能体」，用于选择 OpenCode 的 agent，例如 build 或 plan |
| 权限模式 | Claude、Codex、OpenCode、OMP | 见下表 |
| 快速模式 | Claude（限支持该功能的模型） | 开启或关闭快速模式 |
| 速度 | Codex（提供多种速度时） | 选择服务速度 |
| 语气 | Codex（限支持该功能的模型） | 「默认语气」「中性」「友好」或「务实」 |
| MCP 服务器 | Claude、Codex | 显示已配置的 MCP 服务器及其状态；可以重新连接、停用或启用服务器。对于 Codex，启用或停用服务器会更改你的 Codex 用户配置，其他 Codex 对话也使用这份配置 |
| 后台任务 | Claude | 见 §9 |
| 账号 | Claude、Codex | 重新登录或登出，见 §12 |
| Codex 额度重置券 | Codex | 查看并使用 Codex 的速率限制重置券 |
「模型」「思考程度」和「权限模式」菜单提供「设为默认」，可将当前选择设为该智能体新对话的默认值。思考程度的默认值只对设置时所选的模型生效。
「设置 ▸ 会话视图 ▸ 输入工具栏」决定输入框旁显示哪些控件及其顺序。「模型」「思考程度」「协作模式」和「权限模式」默认开启。已关闭或放不下的控件会移入更多菜单，因此所有受支持的控件始终可以使用。智能体进程未运行时，「MCP 服务器」和「后台任务」不可用（提示「智能体进程未运行。发送消息即可启动。」）。
智能体首次报告用量数据后，Claude 和 Codex 对话还会在发送按钮旁显示一个小的上下文用量指示器。随着上下文逐渐占满或接近速率限制，它的颜色会发生变化。将鼠标悬停在上面，可以查看上下文用量（「上下文：已用 …，上限 … token」）、智能体报告的会话费用（如有）以及速率限制警告。
权限模式
| 智能体 | 模式 |
|---|---|
| Claude Code | 「计划模式」「每次询问」「自动接受改动」「自动判断」「全部放行」 |
| Codex | 「只读」「自动判断」「完全访问」 |
| OpenCode | 「每次询问」「全部放行」 |
| OMP | 「每次询问」「全部放行」 |
| Pi | 无权限控制；Pi 运行工具时不会询问 |
对 Codex 会话的更改从下一回合开始生效，菜单中会相应标明。将正在运行的 Claude 会话切换为「全部放行」需要重启；VelaTerm 会询问「重启并启用全部放行？」，并保留对话历史。「全部放行」和「完全访问」会跳过所有确认，请谨慎使用。
5. 答复智能体
智能体需要你处理时，对话末尾会出现一张卡片，会话的状态点也会变为黄色：
- 权限请求：「<tool> 请求执行」，附有「允许」和「拒绝」。部分请求还提供长期规则，例如「本会话允许 …」或「始终允许 …」。
- 提问：「智能体提出了一个问题」。选择或输入答案，然后点击「下一题」或「提交」；点击「关闭」则不作答。
- 计划审批：「计划已就绪，等待批准」，附有「批准并执行」和「拒绝」。
- MCP 服务器输入：「<server> 请求输入」，附有「提交」「拒绝」和「取消」。
6. 图片
可以将图片粘贴或拖入输入框。每条消息最多可附带 4 张图片，每张不超过 5 MB；如果某张图片未被加入，输入框会说明原因。缩略图显示在文字上方，每张都带有移除按钮。也可以只发送图片而不附文字。在对话中右键点击图片，可以选择「查看原图」「复制图片」或「保存图片」。
7. 命令与补全
输入 / 可列出命令，输入 @ 可插入文件路径。按 Tab 或 Enter 插入高亮的建议项，按 Esc 关闭列表。对于 Claude 和 Codex，列表中还包括智能体自身的命令和技能。
以下命令由 VelaTerm 自行处理：
| 命令 | 智能体 | 效果 |
|---|---|---|
/clear（也可用 /new） | 全部五种 | 归档当前会话，并在同一分屏中用一个设置相同的新空会话替换它 |
/rewind | Claude、Codex、OpenCode | 在你最近一条消息上打开回退菜单（见 §8） |
/compact | Codex、OpenCode、Pi、OMP | 总结对话，以释放上下文空间 |
/review | Codex | 让 Codex 审查代码；可附带 branch <name>、commit <sha> 或具体说明 |
/undo、/redo | OpenCode | 撤销上一条消息及其文件改动，或恢复上一次撤销的内容 |
/share、/unshare | OpenCode | 创建或移除用于分享对话的链接 |
8. 回退与编辑
你发送的消息带有「从这里回退」按钮。可以恢复的内容取决于智能体：
| 智能体 | 可选项 |
|---|---|
| Claude Code | 「回退对话」「恢复文件」「回退对话并恢复文件」 |
| Codex | 「回退对话」 |
| OpenCode | 「回退对话并恢复文件」 |
| Pi、OMP | 不支持 |
回退会删除所选消息及其后的全部内容。只有当智能体进程正在运行且处于空闲状态，并且没有排队的消息或未处理的权限请求时，才能回退。恢复文件时，确认前会显示将有多少个文件发生变化。回退无法撤销。
Claude 和 Codex 的消息还带有「编辑」按钮。修改文字或图片后，选择「确认并重新发送」，再点击「删除并重新发送」确认。原消息及其后的全部内容会被永久删除，编辑后的消息从该位置重新发送。文件改动不会被恢复。
9. 后台任务（Claude）
Claude 可以在后台运行子智能体和命令。后台任务控件会列出这些任务及其状态（「运行中」「已完成」「失败」「已停止」）。点击「停止」可结束任务；也可以在单独的标签页中打开任务，查看其运行时长、token 数、工具调用、提示词和结果。回合进行期间，「将正在运行的工作转入后台」会把当前工作转入后台，让你可以继续对话。
后台任务运行期间，会话会保持“工作中”状态。
10. 用量上限与自动继续
当 Claude 或 Codex 对话因达到五小时或每周用量上限而停止时，VelaTerm 会在额度重置后继续该任务。此功能默认开启；如需停用，请关闭「设置 ▸ 行为 ▸ 额度重置后自动继续」。
开启该设置后，对话中会显示何时继续，例如「已达到 5 小时用量上限，将于 14:30 自动继续任务。」，并附有「取消」按钮。应用重启后，等待仍然有效。如果你自己发送了消息、执行了回退、取消了等待、关闭了该设置、归档或删除了会话，或者将会话切换到终端视图，等待就会结束，且不会发送任何内容。如果重置时间未知，或者继续后再次达到上限，对话中会给出说明，并且不会自动继续。
11. 阅读较长的对话
- 对话最新的部分会最先加载。向上滚动或选择「加载更早的消息」，可以查看更早的内容。
- 连续的工具调用会折叠为一行（「N 个工具调用」），点击即可查看每次调用。
- 每条回答都可以隐藏其中间步骤（「隐藏过程」/「显示过程（N 步）」）。分屏顶部提供「隐藏全部过程」/「显示全部过程」。
- 使用分屏顶部的「搜索…」按钮，或「在终端内搜索」快捷键（⌘F / Ctrl+Alt+F），可以在对话中搜索。
- 向上滚动后，点击「回到最新消息」可返回对话末尾。
- 你发送的消息带有复制按钮。任何消息中的文字都可以选中并复制。
已归档的对话在知识库中以只读方式打开，详见界面与会话管理 §8。
12. 登录与登出（Claude 和 Codex）
账号控件（「Claude 账号」或「Codex 账号」）默认不在工具栏中显示。可以从更多菜单中打开，也可以在「设置 ▸ 会话视图 ▸ 输入工具栏」中开启。它提供「重新登录」和「登出」。切换账号要等当前回合结束后才会进行；Claude 还会等待后台任务和权限请求处理完毕。
Codex。当 Codex 请求报告登录状态已失效时，对话中会提供「重新登录」。打开授权页面，输入对话中显示的验证码。登录完成后视图会自动更新，你可以继续同一段对话。你的 ChatGPT 账号或工作空间必须已启用设备码登录，且所用的 Codex CLI 必须支持该功能。「取消」可中止尚未完成的登录。
Claude。「重新登录」会显示一个授权链接。在该页面登录后，将页面显示的完整授权码（包括 # 之后的部分）粘贴到「授权码」中，然后选择「提交授权码」。授权码不会作为聊天消息发送。此功能要求所用的 Claude CLI 版本支持账号授权。
登出前会要求确认。登出会清除所连接计算机上的账号凭据，因此使用同一凭据的其他会话也会受到影响。对话历史会保留。登出后，对话中会提供「登录」，以便继续。登出 Claude 不会更改已配置的 API 密钥。
13. 用 ! 运行 Shell 命令
输入 ! 并在后面跟上命令，例如 ! az login --tenant <id>，即可在会话的 shell 中运行该命令，而不是将其发送给智能体。五种智能体都支持此功能。
- 命令在智能体的工作目录中、使用智能体的环境运行。
!之后的文本会按原样传给 shell。 - 「Shell 命令」行会显示命令、实时输出和「取消」按钮。命令结束后，该行显示退出码或「已取消」。输出过长时只保留最后一部分，并在该行中注明。
- 命令结束后，智能体会收到该命令及其输出，并可据此作出响应。
- 每个对话同一时间只能运行一条 shell 命令。Shell 命令不能附带图片，也不接受交互式输入。命令没有时间限制，因此等待浏览器登录的命令会一直运行，直到完成或被你取消。
14. 智能体进程停止时
- 关闭对话所在的标签页会释放智能体进程：空闲的智能体会立即停止，正在工作的智能体会在当前回合结束后停止。你发送下一条消息时，智能体会重新启动并继续同一段对话。
- 会话右键菜单中的「结束进程」会在确认后结束正在运行的智能体。对话历史会保留。
- 如果智能体自行退出，对话中会显示「智能体已退出（代码 N）」。
- 如果智能体尚未安装，分屏中会显示「<Agent> 未安装」，并提供「一键安装」「安装文档」和「我自己装」。「一键安装」会将会话切换到终端视图并在其中运行安装，详见AI 智能体会话 §7。