Agent Tracing Visualizer

注意

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

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

启动

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

kimi vis

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

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

命令行选项

选项	简写	说明
--port INTEGER	-p	指定端口号（默认：5495）
--open / --no-open		启动时自动打开浏览器（默认：--open）
--reload		启用自动重载（用于开发调试）

示例：

# 指定端口
kimi vis --port 8080

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

功能

Wire 事件时间线

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

上下文查看器

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

会话浏览器

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

会话目录快捷操作

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

会话下载与导出

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

• ZIP 下载：在会话浏览器和会话详情页中点击下载按钮，即可将会话目录打包为 ZIP 文件下载
• CLI 导出：使用 kimi export <session_id> 命令将指定会话导出为 ZIP 文件

会话导入

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

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

用量统计

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