@2008muyu/pi-stats-insight
为pi编码代理增加可观测性扩展
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@2008muyu/pi-stats-insight。 它的用途是：为pi编码代理增加可观测性扩展 完整的 Skill 内容见：https://321skill.com/skills/2008muyu-pi-stats-insight/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我查看当前会话的缓存命中率和工具调用统计'，它会在底部显示缓存命中率等级（⚡/🔋/⚠️）、工具调用次数、平均耗时和错误计数。若想深入分析，输入/stats即可选择查看Token费用明细、缓存性能、工具详情或错误日志。
介绍
这个Skill解决了pi编码代理在使用过程中缺乏细粒度观测数据的问题。pi内置的footer只显示token和上下文用量，但开发者往往还需要了解缓存命中率、工具调用统计、平均响应时间和provider错误等关键指标，这些数据对优化AI调用成本和排查性能瓶颈至关重要。
使用方式很简单，安装后无需任何配置，它会在pi的底部自动添加一条紧凑的状态栏，显示缓存命中率等级、工具调用次数、平均耗时和错误计数。同时，通过输入“/stats”命令可以打开交互式菜单，深入查看token与费用明细、缓存性能、每个工具的调用统计、上下文窗口使用情况以及HTTP错误详情。如果需要重置会话统计，只需输入“/stats reset”即可。
它非常适合正在使用pi编码代理进行日常开发的智能体开发者、后端工程师以及全栈工程师。尤其是那些已经接入多种AI provider（如Anthropic、OpenAI、Google、Mistral等）的团队，需要跨provider统一监控缓存效果和成本时，这个Skill能直接填补空白。
建议在每次重大重构或切换模型后关注缓存命中率数据，以评估缓存策略是否有效。需要注意的是，它只统计当前会话内的数据，重启会话后统计会重置，但历史数据会以JSONL格式持久化到本地文件，便于后续分析。另外，该Skill依赖pi的ctx.ui.setStatus接口，不会替换pi的原生footer，两者互不干扰。
常见问题
如何安装pi-stats-insight？
执行命令：pi install npm:pi-stats-insight，或添加到~/.pi/agent/settings.json的packages数组中。
安装后如何查看统计数据？
安装后底部会自动显示缓存、工具、耗时和错误状态条；输入/stats可打开交互式菜单查看详细数据。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/2008muyu-pi-stats-insight/raw/index.md 读取 @2008muyu/pi-stats-insight 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/2008muyu-pi-stats-insight/raw/index.md（查看排版版本）