pi-local-trace-viewer
本地只读的 Pi 编码代理 LLM 与工具调用轨迹查看器
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-local-trace-viewer。 它的用途是：本地只读的 Pi 编码代理 LLM 与工具调用轨迹查看器 完整的 Skill 内容见：https://321skill.com/skills/pi-local-trace-viewer/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
‘帮我分析一下刚才重构用户认证模块时，Pi代理的完整思考过程。’ 它会引导你运行本地轨迹查看器，并在浏览器中打开一个界面，清晰地展示出代理从理解任务、调用代码分析工具、到生成最终代码的每一步LLM推理和工具调用详情，帮助你定位某个错误重构决策的来源。
介绍
这个 Skill 旨在解决开发者在调试 Pi 编码代理时，难以直观追踪其内部 LLM 推理过程和工具调用链的问题。通过一个本地运行的、只读的 Web 界面，它可以将 Pi 代理执行任务时产生的复杂轨迹（trace）可视化，帮助开发者理解 AI 的决策路径。
使用方式非常简单，开发者只需在本地项目中安装此 npm 包，并在运行 Pi 编码代理时启用相应的日志记录功能。随后，通过启动本地服务器，即可在浏览器中查看结构化的调用树、时间线以及每一步的输入输出详情，无需依赖云端服务或复杂的日志分析工具。
它非常适合需要深度调试或优化其 AI 编码代理工作流的开发者，尤其是那些关心 AI 内部“黑盒”决策过程的用户。无论是排查代理为何选择了特定工具，还是分析 LLM 提示词的实际效果，这个查看器都能提供关键洞察。
使用建议：由于它是只读的，因此主要用于事后分析和调试，无法实时干预代理的执行。建议在开发或测试环境中使用，以捕获和分析代理的行为模式，从而优化提示词或工具配置。注意确保你的 Pi 代理版本支持生成兼容的轨迹日志格式。
核心特点
这是一个专为 Pi 编码代理设计的本地化、只读轨迹查看器，与通用的日志分析工具不同，它深度解析并可视化 Pi 代理特有的 LLM 调用和工具执行序列，提供了更贴近开发者调试需求的交互式视图。
注意事项
不适合需要实时修改代理行为或控制执行流程的场景，也不适用于分析非 Pi 编码代理或其他 AI 框架生成的日志。
常见问题
pi-local-trace-viewer 能查看哪些类型的轨迹？
主要查看 Pi 编码代理执行任务时的 LLM 推理步骤和工具（tool）调用链的详细轨迹。
使用这个查看器需要联网吗？
不需要，它是一个完全本地运行的只读查看器，所有数据来源于本地生成的轨迹日志文件。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-local-trace-viewer/raw/index.md 读取 pi-local-trace-viewer 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-local-trace-viewer/raw/index.md（查看排版版本）