@alexanderfortin/pi-token-usage
分析Pi编码代理会话的Token消耗与成本
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：@alexanderfortin/pi-token-usage。 它的用途是：分析Pi编码代理会话的Token消耗与成本 完整的 Skill 内容见：https://321skill.com/skills/alexanderfortin-pi-token-usage/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'生成一份最近30天的Token使用报告，以CSV格式保存到report.csv'，它会自动扫描会话文件并输出统计结果。或者
对AI说：'清理60天前的旧会话文件，但先预览一下要删除哪些文件'，它会执行dry-run模式列出待删除文件，确认后即可安全清理。
介绍
这个Skill解决了Pi编码代理用户无法直观了解每次会话Token用量和成本的问题。在实际开发中，开发者频繁使用AI代理进行编码辅助，但会话文件不断累积，不仅占用存储空间，还难以追踪费用支出。这个扩展可以自动扫描所有会话文件，生成详细的Token用量和成本报告，并支持按需清理旧的会话文件，帮助开发者有效控制AI调用成本和管理存储空间。
使用方式很简单，你只需要通过pi install npm:@alexanderfortin/pi-token-usage安装，之后即可通过/token-report和/token-prune两个命令操作。例如输入/token-report 7可以查看最近7天的Token使用情况，支持表格、CSV、JSON、Markdown等多种输出格式，并可将结果保存到文件。清理旧会话时，输入/token-prune 30会删除30天前的文件，并支持--dry-run预览和--force强制删除，确保安全。
它非常适合需要精细化控制AI成本的个人开发者或团队，尤其是那些使用Pi编码代理进行日常开发、需要定期审计Token消耗的用户。对于项目经理或技术负责人，也可以通过报表了解团队成员的AI使用情况，优化预算分配。此外，数据分析师可以利用其CSV和JSON格式输出，将数据纳入更广泛的成本分析流程。
建议在定期（如每周或每月）生成成本报告时统一使用此工具，以便持续跟踪费用趋势。需要注意的是，它主要针对Pi编码代理的会话文件（.jsonl格式），其他AI代理的日志文件无法直接使用。在清理旧会话前，建议先使用--dry-run模式确认不会误删重要文件，避免意外丢失对话历史。
常见问题
如何查看最近几天的Token使用报告？
使用命令 /token-report 天数，例如 /token-report 7 查看最近7天。
支持哪些输出格式？
支持表格（默认）、CSV、JSON、Markdown四种格式，可通过 --format 参数切换。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/alexanderfortin-pi-token-usage/raw/index.md 读取 @alexanderfortin/pi-token-usage 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/alexanderfortin-pi-token-usage/raw/index.md（查看排版版本）