> ## Documentation Index
> Fetch the complete documentation index at: https://vibex.peatboy.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent 会话

> 创建、观察、暂停、分叉和恢复 Vibex Agent 会话。

会话把一次开发任务的输入、Agent 输出和工具操作保存为结构化时间线。**权威运行时**保存权威时间线，其它客户端只显示它的投影。

## 创建会话

1. 选择目标项目和位置（**本地** 或 **新建 Worktree**，见[项目与工作区](/docs/workspaces)）。
2. 在输入框顶部选择 Agent、供应商配置、模型、**思考深度**和**对话模式**。
3. 输入任务。用 `/` 选命令，用 `@` 引用工作区文件，用 `$` 插入 Skill，或用 `↑` / `↓` 翻出这个会话早先发过的消息；也可以添加附件。
4. 发送前确认工作区和权限范围。Agent 可能需要读取文件、执行终端命令或请求额外授权。

切换 Agent 或模型只影响后续运行。已写入时间线的消息会保留其原始运行身份。

## 阅读时间线

| 项目           | 你会看到什么                                          |
| ------------ | ----------------------------------------------- |
| 用户与 Agent 消息 | Markdown 文本和附件。                                 |
| 推理           | Agent 的推理摘要，可用 **展开推理过程** / **收起推理过程** 展开或收起。   |
| Plan         | 待办步骤及其进度。                                       |
| 工具与进程详情      | 工具名称、参数摘要、进程和退出结果，以及 **{n} process events** 计数。 |
| 权限请求         | 等待你批准或拒绝的操作。                                    |
| 询问表单         | Agent 需要你填写的类型化表单。                              |
| 委派           | 子 Agent 或委派任务的状态和结果。                            |
| 状态事件         | 运行、排队、等待、完成、失败、停止和重连。                           |

回合上方会显示 **工作了** 的耗时。生成过程中会显示 **思考中...** 或 **等待确认中...**。

工具参数、终端输出和文件差异可能包含敏感内容。分享诊断前先检查并脱敏。

## 目标

支持目标的 Agent 会通过 ACP 发布目标状态：通用的 `_meta.goal` 扩展，以及 Codex 旧的 `_meta.codex.goal` 命名空间。Vibex 把这些归一成同一套模型，并把每次变化存成一条目标时间线条目。

目标显示在输入框上方的固定目标栏里，紧接在排队消息栏下面：

* 目标栏显示阶段、目标和 Agent 自己上报的统计（已用时间、token 用量、回合数）。
* 铅笔按钮（**编辑目标**）打开原地编辑器改写目标；保存时通过目标控制下发，不经过输入框。
* **暂停目标** / **继续目标** 暂停或继续目标。
* **清除目标** 清除目标；进行中、已暂停、已阻塞和额度受限的目标都能清除。

只有适配器明确声明支持时，对应的按钮才会出现。以 `/goal` 发出的消息保留自己的气泡，并在气泡边缘带一个目标图标。

## 控制运行

| 操作         | 说明                                           |
| ---------- | -------------------------------------------- |
| **停止当前回复** | 停止当前运行。已写入的文件或已执行的命令**不会**自动回滚。              |
| **继续**     | 在同一会话中继续发送任务。                                |
| **重试**     | 按 Agent 支持的重试语义重新运行失败回合；不确定是否已执行的外部操作应先检查结果。 |
| **分叉会话**   | 从当前时间线创建分支会话，适合比较两种实现。                       |
| **重命名**    | 修改会话标题，不会改变 Agent 上下文。                       |
| **编辑消息**   | 改写最后一条用户消息；已完成的时间线事件不会被改写。                   |

<Warning>
  停止 Agent 只停止运行过程，不会撤销文件、Git 或外部服务变更。请在 Git diff 和终端中分别检查结果。
</Warning>

## 消息队列与自动继续

运行期间发送的后续消息会进入队列。输入框上的队列区域提供：

* **自动发送** / **手动发送** —— 切换自动或手动提交队列。
* **引导** —— 只对声明了原生引导（native steering）的 Agent 出现：它把这条消息注入正在运行的回合，而不是先打断。其它 Agent 仍然回退为打断并重发。
* **发送排队消息**、**编辑排队消息**、**删除排队消息** —— 逐项操作。
* **恢复队列发送** / **清空排队消息** —— 整体恢复或清空。

投递方式会记在用户消息上，并渲染成气泡下边缘的反应标记：**已引导运行中的回合**（主色）或 **已打断上一轮并重新发送**（警告色）。当后面已经存在更新的回合时，旧回合会标记为被取代：实时状态、运行时长和流式行扩展停止，但已经产生的行仍然可见并保持展开。

取消或删除队列项不会撤销已经完成的操作。

启用 **自动继续** 后，只有满足会话设置和 Agent 能力的回合会自动推进。遇到权限请求、询问表单、失败或需要用户选择时会停下来等待。

## 权限请求与询问表单

当 Agent 请求终端、文件写入或其他受保护能力时，时间线会显示请求原因和范围，通常包含工作目录、参数和环境变量。可选操作为 **允许**、**拒绝** 和 **本会话始终允许**。

询问表单需要填写结构化内容。提交前确认值和作用范围；取消表单会让 Agent 收到取消结果，而不是隐式批准。

## 全局搜索

`cmd-k` 在任何位置都能打开 **全局搜索**（工作台命令面板），入口是标题栏里的搜索图标，紧挨运行时控件之前。一次输入同时检索三组结果：

| 分组                | 范围                | 选中后                            |
| ----------------- | ----------------- | ------------------------------ |
| **最近会话** / **会话** | 会话标题和消息正文         | 打开会话并跳到命中的那条消息                 |
| **设置**            | 设置项               | 打开设置、定位到对应分区并高亮那一行             |
| **快捷操作**          | 注册在工作台上的真实 Action | 直接执行；每行显示自己的快捷键，前置条件不满足时显示为不可用 |

* 面板顶部有自己的查询框，三组之间画有分隔线；空查询时只列出 **最近会话**。
* 会话搜索只索引和高亮对话文本——用户消息、Agent 回答、推理和计划——并只给命中的关键词着色，当前命中颜色更重。
* 输入非空时按 `escape` 先清空输入，再按一次才关闭。
* 索引在后台构建并保留，再次打开是瞬间完成的。已归档的会话不参与搜索。

单会话内的查找仍然用 `cmd-f`（**在当前会话中查找**）。

## 导入本地历史

通过侧栏 **更多** 菜单或项目右键菜单中的 **导入会话** 导入其它 Agent 的历史。

支持 14 个来源：**Claude Code**、**Codex**、**OpenCode**、**Gemini CLI**、**Cline**、**Hermes**、**CodeBuddy Code**、**Kimi Code**、**Pi**、**Grok**、**Cursor**、**DeepSeek Harness**、**ZCode**、**Google Antigravity**。

流程：

1. Vibex 扫描本机历史，显示 **正在扫描本地 Agent 会话...**。
2. 在预览列表中按项目分组勾选要导入的会话，可以按 Agent 筛选或重新扫描。
3. 点击 **导入 {n} 个会话**，等待 **导入完成**。

结果会分成 **已导入**、**已导入**、**已消失**、**失败** 四类。

<Note>
  扫描器只读取元数据：标题、时间、工作区路径、消息数量和来源路径。导入时才会重新读取内容并一次性写入时间线。凭据、密钥和完整 Agent home 配置**不会**导入。已导入过的会话不会重复导入，也不会被刷新覆盖。
</Note>

## 通知与未读

会话完成、失败或等待输入时，权威运行时可以发送桌面通知。三类通知可以在 **设置 → 会话** 的 **Agent 通知** 中分别开关，它们已从 **常规** 移到那里。

有未读完成项的会话在侧栏显示圆点提示；打开会话后提示消失，以权威时间线为准。系统托盘菜单也提供 **新建会话**、**配置中心** 和 **设置** 的快捷入口。

## 子 Agent 时间线

当会话使用了委派（delegation）时，右侧栏会出现 **子 Agent 时间线** 入口，可以查看子 Agent 的独立时间线，并从父会话跳转过去。