Kimi Code CLI Agent Tracing Visualizer 使用指南用kimi vis可视化分析会话追踪数据【免费下载链接】kimi-cliKimi Code CLI is your next CLI agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kimi-cliKimi Code CLI 内置的 Agent Tracing Visualizerkimi vis是一个基于浏览器的会话追踪可视化仪表板用于检查和分析 CLI 在运行过程中产生的会话追踪数据。通过它你可以查看 Wire 事件时间线、分析上下文使用情况、浏览历史会话并导出或导入会话数据用于离线分析。本文将完整介绍 Visualizer 的启动方式、命令行选项、六大核心功能并结合仓库源码如 vis 命令入口、FastAPI 服务端、会话 API剖析其底层实现原理帮助你快速上手并深入理解这一技术预览功能。注意Agent Tracing Visualizer 目前为技术预览版Technical Preview可能不够稳定功能与界面会在后续版本中发生变化。快速启动 Visualizer在终端中运行kimi vis命令即可启动 Visualizerkimi vis服务器启动后会自动打开浏览器。默认访问地址为http://127.0.0.1:5495。如果默认端口5495被占用服务器会自动尝试下一个可用端口默认尝试范围5495–5504并在终端打印实际的访问地址。这一行为由find_available_port实现见 utils/server.py它会从起始端口开始逐个尝试绑定最多尝试 10 次超过范围则抛出RuntimeError。你还可以在交互式 Shell 中直接输入/vis斜杠命令从当前会话无缝切换到 Visualizer。该命令定义在 ui/shell/slash.py通过抛出SwitchToVis异常见 cli/init.py让主循环在会话结束后自动切换界面。命令行选项详解kimi vis支持以下命令行选项选项简写说明--host TEXT-h绑定到指定 IP 地址--network-n启用网络访问绑定到0.0.0.0自动探测并显示局域网 IP--port INTEGER-p指定端口号默认5495--open / --no-open启动时自动打开浏览器默认--open--reload启用自动重载用于开发调试从源码看这些参数由 Typer 定义在 cli/vis.py 中绑定地址的优先级逻辑为显式指定--host时优先使用该地址否则若启用--network则绑定0.0.0.0两者都未指定时默认绑定127.0.0.1仅本机可访问。常用示例# 指定端口 kimi vis --port 8080 # 不自动打开浏览器 kimi vis --no-open # 在局域网中共享自动探测并显示 LAN IP kimi vis -n当使用-n或--host绑定非本机地址时服务端还会打印可访问的地址列表本机与局域网地址方便其他设备访问。需要特别注意的是一旦服务暴露到网络非 localhost 绑定出于安全考虑打开目录Open Dir功能会被自动禁用——这是 vis/app.py 中通过设置KIMI_VIS_RESTRICT_OPEN_IN环境变量实现的后端能力接口 vis/api/system.py 会据此向前端报告open_in_supported标志。核心功能一Wire 事件时间线Wire 事件时间线以时间线形式展示会话的完整事件流包括Turn轮次的开始与结束每次用户输入到 Agent 响应完成算一轮Step步骤的执行Agent 内部的思考与决策步骤工具调用Tool Call与返回结果Tool Result。前端支持事件过滤与详细信息查看包括事件类型筛选、工具调用分组可处理并行工具调用等。前端界面代码位于 vis/src/features/wire-viewer。后端的数据来源是会话目录中的wire.jsonl文件。服务端通过 sessions.py 中的GET /api/vis/sessions/{work_dir_hash}/{session_id}/wire接口逐行解析该文件并递归展开子代理事件SubagentEvent后返回带时间戳的事件数组。核心功能二上下文查看器上下文查看器可视化展示会话的上下文内容包括 User 消息、Assistant 消息和工具调用帮助你理解 Agent 在每个步骤中看到的信息——即进入模型上下文窗口的完整消息序列。后端从context.jsonl文件中读取消息见 sessions.py每行是一个 JSON 消息对象。前端在 vis/src/features/context-viewer 中按角色渲染消息支持从上下文消息直接跳转到对应的 Wire 事件按tool_call_id关联实现上下文 ↔ 时间线的双向追踪。核心功能三会话浏览器会话浏览器用于浏览和搜索所有历史会话按项目工作目录分组展示。每个会话显示会话 ID 与标题标题优先取state.json中的自定义标题否则从wire.jsonl第一个TurnBegin的用户输入中提取最多 100 字符见 sessions.py工作目录路径通过元数据中工作目录的 MD5 哈希反查创建/最后更新时间、消息数量、轮次数量、子代理数量文件大小信息wire.jsonl、context.jsonl、state.json各自与合计大小。会话按最后更新时间倒序排列。列表接口GET /api/vis/sessions的扫描逻辑在 sessions.py 中通过run_in_executor在线程池中执行避免阻塞事件循环。核心功能四会话目录快捷操作在会话详情页顶部你可以使用Open Dir直接打开当前会话目录。该操作在 macOS 上调用 Finder在 Windows 上调用 ExplorerCopy DIR复制当前会话目录的原始路径便于你在终端、编辑器或问题报告中继续排查。open_in_supported能力由 vis/api/system.py 判定仅在 macOS/Windows 平台且服务未暴露到网络时可用Linux 上返回false。这一点也有对应测试覆盖见 tests/vis/test_app.py。核心功能五会话下载与导出你可以将会话数据导出为 ZIP 文件方便离线分析或分享。ZIP 下载在会话浏览器和会话详情页点击下载按钮即可将会话目录打包为 ZIP 下载。后端通过GET /api/vis/sessions/{work_dir_hash}/{session_id}/download接口实现见 sessions.py会递归打包会话目录下的全部文件CLI 导出使用kimi export [session_id]命令导出会话为 ZIP 文件。省略session_id时CLI 会预览当前工作目录的上一个会话并要求确认。kimi export的实现在 cli/export.py 中导出内容比简单的目录打包更丰富生成manifest.json清单包含导出时间、kimi-cli 版本、Python 版本、操作系统信息、会话活动时间范围等诊断信息打包会话目录下的所有文件包括subagents/和tasks/子目录额外收集最近 2 天内的全局日志文件~/.kimi/logs/kimi.*.log总量上限 100 MB便于问题诊断。同时支持--output, -o指定输出路径默认session-id.zip在当前目录和--yes, -y跳过确认。注意导出包含日志时 CLI 会提示归档中可能包含其他会话的文件路径、命令或配置分享前请先审阅内容。核心功能六会话导入Visualizer 支持导入 ZIP 格式的会话数据用于查看。导入的会话存储在独立的~/.kimi/imported_sessions/目录中注意~/.kimi是默认共享目录可通过环境变量KIMI_SHARE_DIR覆盖见 share.py不会与正常会话混淆。该目录结构同样在 contenteditable="false">【免费下载链接】kimi-cliKimi Code CLI is your next CLI agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kimi-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Kimi Code CLI Agent Tracing Visualizer 使用指南：用 `kimi vis` 可视化分析会话追踪数据
Kimi Code CLI Agent Tracing Visualizer 使用指南用kimi vis可视化分析会话追踪数据【免费下载链接】kimi-cliKimi Code CLI is your next CLI agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kimi-cliKimi Code CLI 内置的 Agent Tracing Visualizerkimi vis是一个基于浏览器的会话追踪可视化仪表板用于检查和分析 CLI 在运行过程中产生的会话追踪数据。通过它你可以查看 Wire 事件时间线、分析上下文使用情况、浏览历史会话并导出或导入会话数据用于离线分析。本文将完整介绍 Visualizer 的启动方式、命令行选项、六大核心功能并结合仓库源码如 vis 命令入口、FastAPI 服务端、会话 API剖析其底层实现原理帮助你快速上手并深入理解这一技术预览功能。注意Agent Tracing Visualizer 目前为技术预览版Technical Preview可能不够稳定功能与界面会在后续版本中发生变化。快速启动 Visualizer在终端中运行kimi vis命令即可启动 Visualizerkimi vis服务器启动后会自动打开浏览器。默认访问地址为http://127.0.0.1:5495。如果默认端口5495被占用服务器会自动尝试下一个可用端口默认尝试范围5495–5504并在终端打印实际的访问地址。这一行为由find_available_port实现见 utils/server.py它会从起始端口开始逐个尝试绑定最多尝试 10 次超过范围则抛出RuntimeError。你还可以在交互式 Shell 中直接输入/vis斜杠命令从当前会话无缝切换到 Visualizer。该命令定义在 ui/shell/slash.py通过抛出SwitchToVis异常见 cli/init.py让主循环在会话结束后自动切换界面。命令行选项详解kimi vis支持以下命令行选项选项简写说明--host TEXT-h绑定到指定 IP 地址--network-n启用网络访问绑定到0.0.0.0自动探测并显示局域网 IP--port INTEGER-p指定端口号默认5495--open / --no-open启动时自动打开浏览器默认--open--reload启用自动重载用于开发调试从源码看这些参数由 Typer 定义在 cli/vis.py 中绑定地址的优先级逻辑为显式指定--host时优先使用该地址否则若启用--network则绑定0.0.0.0两者都未指定时默认绑定127.0.0.1仅本机可访问。常用示例# 指定端口 kimi vis --port 8080 # 不自动打开浏览器 kimi vis --no-open # 在局域网中共享自动探测并显示 LAN IP kimi vis -n当使用-n或--host绑定非本机地址时服务端还会打印可访问的地址列表本机与局域网地址方便其他设备访问。需要特别注意的是一旦服务暴露到网络非 localhost 绑定出于安全考虑打开目录Open Dir功能会被自动禁用——这是 vis/app.py 中通过设置KIMI_VIS_RESTRICT_OPEN_IN环境变量实现的后端能力接口 vis/api/system.py 会据此向前端报告open_in_supported标志。核心功能一Wire 事件时间线Wire 事件时间线以时间线形式展示会话的完整事件流包括Turn轮次的开始与结束每次用户输入到 Agent 响应完成算一轮Step步骤的执行Agent 内部的思考与决策步骤工具调用Tool Call与返回结果Tool Result。前端支持事件过滤与详细信息查看包括事件类型筛选、工具调用分组可处理并行工具调用等。前端界面代码位于 vis/src/features/wire-viewer。后端的数据来源是会话目录中的wire.jsonl文件。服务端通过 sessions.py 中的GET /api/vis/sessions/{work_dir_hash}/{session_id}/wire接口逐行解析该文件并递归展开子代理事件SubagentEvent后返回带时间戳的事件数组。核心功能二上下文查看器上下文查看器可视化展示会话的上下文内容包括 User 消息、Assistant 消息和工具调用帮助你理解 Agent 在每个步骤中看到的信息——即进入模型上下文窗口的完整消息序列。后端从context.jsonl文件中读取消息见 sessions.py每行是一个 JSON 消息对象。前端在 vis/src/features/context-viewer 中按角色渲染消息支持从上下文消息直接跳转到对应的 Wire 事件按tool_call_id关联实现上下文 ↔ 时间线的双向追踪。核心功能三会话浏览器会话浏览器用于浏览和搜索所有历史会话按项目工作目录分组展示。每个会话显示会话 ID 与标题标题优先取state.json中的自定义标题否则从wire.jsonl第一个TurnBegin的用户输入中提取最多 100 字符见 sessions.py工作目录路径通过元数据中工作目录的 MD5 哈希反查创建/最后更新时间、消息数量、轮次数量、子代理数量文件大小信息wire.jsonl、context.jsonl、state.json各自与合计大小。会话按最后更新时间倒序排列。列表接口GET /api/vis/sessions的扫描逻辑在 sessions.py 中通过run_in_executor在线程池中执行避免阻塞事件循环。核心功能四会话目录快捷操作在会话详情页顶部你可以使用Open Dir直接打开当前会话目录。该操作在 macOS 上调用 Finder在 Windows 上调用 ExplorerCopy DIR复制当前会话目录的原始路径便于你在终端、编辑器或问题报告中继续排查。open_in_supported能力由 vis/api/system.py 判定仅在 macOS/Windows 平台且服务未暴露到网络时可用Linux 上返回false。这一点也有对应测试覆盖见 tests/vis/test_app.py。核心功能五会话下载与导出你可以将会话数据导出为 ZIP 文件方便离线分析或分享。ZIP 下载在会话浏览器和会话详情页点击下载按钮即可将会话目录打包为 ZIP 下载。后端通过GET /api/vis/sessions/{work_dir_hash}/{session_id}/download接口实现见 sessions.py会递归打包会话目录下的全部文件CLI 导出使用kimi export [session_id]命令导出会话为 ZIP 文件。省略session_id时CLI 会预览当前工作目录的上一个会话并要求确认。kimi export的实现在 cli/export.py 中导出内容比简单的目录打包更丰富生成manifest.json清单包含导出时间、kimi-cli 版本、Python 版本、操作系统信息、会话活动时间范围等诊断信息打包会话目录下的所有文件包括subagents/和tasks/子目录额外收集最近 2 天内的全局日志文件~/.kimi/logs/kimi.*.log总量上限 100 MB便于问题诊断。同时支持--output, -o指定输出路径默认session-id.zip在当前目录和--yes, -y跳过确认。注意导出包含日志时 CLI 会提示归档中可能包含其他会话的文件路径、命令或配置分享前请先审阅内容。核心功能六会话导入Visualizer 支持导入 ZIP 格式的会话数据用于查看。导入的会话存储在独立的~/.kimi/imported_sessions/目录中注意~/.kimi是默认共享目录可通过环境变量KIMI_SHARE_DIR覆盖见 share.py不会与正常会话混淆。该目录结构同样在 contenteditable="false">【免费下载链接】kimi-cliKimi Code CLI is your next CLI agent.项目地址: https://gitcode.com/GitHub_Trending/ki/kimi-cli创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考