---
url: /kimi-cli/zh/reference/kimi-vis.md
---
# Agent Tracing Visualizer

::: warning 注意
Agent Tracing Visualizer 目前为技术预览版（Technical Preview），功能和界面可能在后续版本中发生变化。
:::

Agent Tracing Visualizer 是一个基于浏览器的可视化仪表板，用于检查和分析 Kimi Code CLI 的会话追踪数据。它可以帮助你理解 Agent 的行为、查看 Wire 事件时间线、分析上下文使用情况，以及浏览历史会话。

## 启动

在终端中运行 `kimi vis` 命令启动 Visualizer：

```sh
kimi vis
```

服务器启动后会自动打开浏览器。默认地址为 `http://127.0.0.1:5495`。

如果默认端口被占用，服务器会自动尝试下一个可用端口（默认范围 `5495`–`5504`），并在终端打印访问地址。

你也可以在交互式 Shell 中输入 `/vis` 斜杠命令，直接从当前会话切换到 Visualizer。

## 命令行选项

| 选项 | 简写 | 说明 |
|------|------|------|
| `--host TEXT` | `-h` | 绑定到指定 IP 地址 |
| `--network` | `-n` | 启用网络访问（绑定到 `0.0.0.0`），自动探测并显示 LAN IP |
| `--port INTEGER` | `-p` | 指定端口号（默认：`5495`） |
| `--open / --no-open` | | 启动时自动打开浏览器（默认：`--open`） |
| `--reload` | | 启用自动重载（用于开发调试） |

示例：

```sh
# 指定端口
kimi vis --port 8080

# 不自动打开浏览器
kimi vis --no-open

# 在局域网中共享（自动探测并显示 LAN IP）
kimi vis -n
```

## 功能

### Wire 事件时间线

以时间线形式展示 Wire 事件的完整流程，包括轮次（Turn）的开始和结束、步骤（Step）的执行、工具调用和返回结果等。支持事件过滤和详细信息查看。

### 上下文查看器

可视化展示会话的上下文内容，包括 User 消息、Assistant 消息和工具调用。帮助理解 Agent 在每个步骤中 "看到" 的信息。

### 会话浏览器

浏览和搜索所有历史会话，按项目分组展示。可以查看每个会话的详细信息，包括工作目录、创建时间和消息数量。

### 会话目录快捷操作

在会话详情页顶部，可以使用 `Open Dir` 直接打开当前会话目录。该操作在 macOS 上调用 Finder，在 Windows 上调用 Explorer。`Copy DIR` 会复制当前会话目录的原始路径，便于你在终端、编辑器或问题报告中继续排查。

### 会话下载与导出

可以将会话数据导出为 ZIP 文件，方便离线分析或分享。

* **ZIP 下载**：在会话浏览器和会话详情页中点击下载按钮，即可将会话目录打包为 ZIP 文件下载
* **CLI 导出**：使用 `kimi export [<session_id>]` 命令导出会话为 ZIP 文件；省略 `<session_id>` 时会预览并确认当前工作目录的上一个会话

### 会话导入

支持将 ZIP 格式的会话数据导入到 Visualizer 中查看。导入的会话存储在独立的 `~/.kimi/imported_sessions/` 目录中，不会与正常会话混淆。

在会话浏览器中可以通过 "Imported" 筛选器切换查看导入的会话。导入的会话支持删除操作，删除前会弹出确认对话框。

### 用量统计

展示 Token 用量的统计数据和图表，包括输入和输出 Token 的分布、缓存命中率等信息。