@agentoom/pi-spending-guard

跟踪LLM调用花费,超阈值自动暂停

开发流程 控制费用支出监控AI调用成本防止API滥用 通用 更新于 2026-09-13

安装使用

复制下面这段提示词发给你的 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 格式),按其中说明在我的环境里完成安装和配置。