pi-trace-extension
为pi-agent设计的单文件、零配置追踪查看器。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-trace-extension。 它的用途是：为pi-agent设计的单文件、零配置追踪查看器。 完整的 Skill 内容见：https://321skill.com/skills/pi-trace-extension/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“帮我分析一下刚才处理用户查询的完整步骤和耗时。” 它会引导你导出pi-agent的追踪日志，然后你打开pi-trace-extension的HTML文件并加载该日志，即可在浏览器中清晰地看到每一步的调用详情、耗时和输入输出，方便定位性能瓶颈或逻辑问题。
介绍
pi-trace-extension 解决了开发者在本地调试和分析 pi-agent 运行时行为时，缺乏直观、轻量级追踪可视化工具的问题。它可以直接在浏览器中打开一个独立的HTML文件，无需安装服务器或配置数据库，即可查看类似Langfuse风格的调用链追踪、耗时和输入输出详情。
使用方式极其简单。开发者只需在运行pi-agent时启用追踪日志，然后将生成的日志文件拖入或通过界面加载到这个单HTML文件中，页面便会自动解析并展示结构化的追踪视图，支持展开/折叠、搜索和细节查看。
它非常适合使用pi-agent进行AI应用开发、调试或教学演示的开发者、技术布道师以及希望理解AI Agent内部工作流程的研究者。对于追求快速、隐私安全、不想依赖云端服务的个人或小团队尤其友好。
建议在开发、测试或复盘Agent执行过程时使用。请注意，它是一个纯前端的查看器，本身不负责收集或存储数据，需要配合pi-agent的追踪日志生成功能。首次使用前请确保pi-agent已正确配置以输出追踪日志。
核心特点
核心区别在于其“单文件HTML、零依赖”的极简部署方式，以及“本地优先、无需网络”的隐私安全设计，与需要搭建服务或依赖云平台的同类追踪工具形成鲜明对比。
注意事项
不适合需要实时监控、团队协作、长期历史数据存储或复杂分析报表的生产级运维场景。
常见问题
pi-trace-extension 需要安装吗？
不需要安装，它是一个可直接在浏览器中打开的单个HTML文件。
它如何获取pi-agent的追踪数据？
需要先配置pi-agent输出追踪日志文件，然后在本工具中加载该日志文件进行查看。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-trace-extension/raw/index.md 读取 pi-trace-extension 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-trace-extension/raw/index.md（查看排版版本）