@agentoom/pi-spending-guard
跟踪LLM调用花费,超阈值自动暂停
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@agentoom/pi-spending-guard。 它的用途是:跟踪LLM调用花费,超阈值自动暂停 完整的 Skill 内容见:https://321skill.com/skills/agentoom-pi-spending-guard/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'帮我设置每个任务花费上限为5美元,并在达到时暂停任务',它会自动配置spending-guard,之后每次任务运行都会在状态栏显示实时花费,达到限额时弹出对话框,你可以选择继续(加倍限额)、重置计数器、优化提示词或停止任务,从而灵活控制成本。
介绍
这个Skill解决了LLM API成本失控的痛点。在实际开发中,开发者经常需要频繁调用大模型完成多轮任务或批量推理,但难以实时监控每次调用的花费,导致预算超支、月末账单惊吓。Pi-Spending-Guard 让你在任务执行过程中就能精准追踪每笔AI开销,并设置一个可配置的阈值,当累计花费达到该值时自动暂停任务,防止成本无限膨胀。
使用方式很简单,你只需要先安装扩展,然后通过自然语言指令或命令来管理花费。例如,输入 /spending 查看当前花费和限额,/spending limit 5 将阈值设为5美元。当实际花费达到限额时,系统会弹出四个选项的对话框:继续(加倍限额或重置计数器)、优化提示词、停止任务。同时,状态栏会实时显示 💵 $1.23 / $3.00 这样的花费进度条,让你随时掌握成本。
它非常适合需要精细控制LLM调用成本的团队或个人。尤其是那些已经使用 pi.dev 作为AI助手平台、频繁进行多轮对话或批量任务处理的用户,比如项目经理、全栈开发者、智能体开发者。对于需要管理多人或多项目AI预算的企业,可以通过全局配置文件和项目级配置文件实现分层管控,避免单个项目拖垮整体预算。
建议在项目启动时统一配置全局默认限额(默认3美元),并根据实际业务的复杂度和调用频率调整阈值。需要注意的是,它目前仅支持 pi.dev 平台,无法直接用于其他LLM调用框架(如OpenAI API直接调用)。此外,暂停后若选择“继续(重置计数器)”会清空累计花费,需留意预算追踪的连续性。
常见问题
如何更改默认的3美元限额?
可以通过命令 `/spending limit 5` 临时设置,或编辑项目级配置文件 `.pi/spending-guard.json` 中的 `limit` 字段永久生效。
暂停后能否恢复之前的任务?
可以。暂停后弹出的对话框支持选择“继续(加倍限额)”或“继续(重置计数器)”,不需要重新开始任务。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/agentoom-pi-spending-guard/raw/index.md 读取 @agentoom/pi-spending-guard 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/agentoom-pi-spending-guard/raw/index.md(查看排版版本)