pi-token-tracker
Pi扩展，追踪跨会话Token用量并生成统计报告
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：pi-token-tracker。 它的用途是：Pi扩展，追踪跨会话Token用量并生成统计报告 完整的 Skill 内容见：https://321skill.com/skills/pi-token-tracker/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'生成最近7天的Token用量报告'，它会读取usage.jsonl中的逐调用记录，汇总各会话、各代理的Token消耗并输出结构化报告。
对AI说：'统计merge agents的累计Token用量'，它会筛选对应代理的调用记录，单独计算该类任务的总消耗及占比。
介绍
在Pi生态下开展多任务并行开发时，用户往往同时运行普通会话、taskplane workers、merge agents等多类任务，此前缺乏统一的Token用量统计手段，容易出现成本核算模糊、配额分配无依据、超支无法溯源的问题。 安装该扩展后，它会自动在后台静默运行，实时捕获所有会话的每一次AI调用Token数据，逐条写入本地usage.jsonl文件留存，需要查看统计结果时，直接调用内置的token-report命令即可生成汇总报告。 适合使用Pi生态进行多代理协作开发的个人开发者、有AI调用成本管控需求的研发团队、需要统筹多worker资源配额的技术负责人或运维人员。 建议定期归档历史usage.jsonl文件避免单文件体积过大影响读取效率，若需分项目统计可自行编写脚本对jsonl文件按会话标签做二次拆分，报告生成后可导出用于长期成本台账管理。
核心特点
不同于仅统计普通用户会话的Token工具，它可覆盖Pi生态下包括taskplane workers、merge agents在内的全类型会话，自动留存逐调用原始记录且提供开箱即用的报告命令，无需额外开发统计逻辑。
注意事项
仅适配Pi生态环境，无法追踪其他AI平台、工具或非Pi体系下代理的Token用量。
常见问题
Token用量记录保存在哪里？
所有逐调用的Token数据会自动写入当前工作目录下的usage.jsonl文件。
怎么生成Token用量汇总报告？
在Pi环境中直接执行内置的token-report命令即可。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/pi-token-tracker/raw/index.md 读取 pi-token-tracker 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/pi-token-tracker/raw/index.md（查看排版版本）