pi-pirs

追踪Bash工具Token使用情况的Pi插件

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:pi-pirs。
它的用途是:追踪Bash工具Token使用情况的Pi插件
完整的 Skill 内容见:https://321skill.com/skills/pi-pirs/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“帮我统计一下上个月所有代码审查命令的Token总消耗,并按工具分组。”,它会调用pi-pirs查询本地数据库,生成一份按Claude、Cursor等工具分类的Token使用量报表,并计算出总成本。你还可以要求它“将本周的数据导出为CSV文件”,以便进行更灵活的图表分析。

介绍

pi-pirs是一款专为Pi终端设计的扩展插件,它解决了开发者在频繁使用Bash命令行工具时,难以量化和管理Token消耗的痛点。通过自动追踪和记录每次调用AI工具(如Claude、Cursor等)的Token使用量,帮助用户清晰掌握成本分布。

使用方式非常简单,安装后该插件会在后台静默运行。每当你在Bash中执行配置好的AI工具命令时,它会自动捕获并记录本次交互的Token使用数据,包括输入和输出的Token数。所有数据会进行本地存储,无需连接外部服务器。

它非常适合经常在命令行中使用AI辅助编程、代码审查或文档生成的开发者、DevOps工程师和技术团队负责人。对于需要精确核算项目AI开销、优化提示词以控制成本,或进行团队资源分配的场景尤其有价值。

建议在团队协作项目中启用,以便统一分析AI工具的使用效率。请注意,它目前主要支持集成在Pi环境下的Bash工具链,对于其他终端环境或GUI工具的直接调用可能无法捕获。定期导出数据进行分析,可以更好地发挥其价值。

核心特点

与同类仅提供基础计数的工具相比,pi-pirs提供了按工具、项目或时间分组的详细统计视图,并支持一键导出结构化数据(如CSV),便于进行深度成本分析和报告生成。

注意事项

仅适用于Pi终端环境下的Bash工具调用追踪,无法监控其他IDE内置或图形界面AI工具的直接使用。

常见问题

pi-pirs支持追踪哪些AI工具?

支持追踪在Pi终端Bash中运行的AI命令行工具,如Claude CLI、Cursor命令行版本等。

数据存储在哪里?安全吗?

数据默认存储在本地,仅为明文日志文件,不涉及网络传输,但需注意本地文件安全。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/pi-pirs/raw/index.md 读取 pi-pirs 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。