SuperAPI AI 工具集

cost-budget-check

部署与运维

查看项目

更新于 10-15 15:23

技能介绍

Cost Budget Check

读取 cost-tracking:budget-config 以获取项目的预算上限,汇总 cost-track 产生的 session-* 记录中的 total_cost_usd,计算使用率,并发出四层告警阶梯(50% INFO / 75% WARNING / 90% CRITICAL / 100% HARD_STOP)。

在 P2(本技能)落地之前,README 中记录了告警阶梯,但没有任何代码检查它。现在此技能就是关卡。

何时使用

在每次 cost-track 运行之后,用于暴露告警级别。

在启动 swarm 之前——如果使用率 ≥ 90%,先升级到 /cost-optimize。

可通过 /loop 30m 适应 Cron 式持续监控。

步骤

运行检查:

node plugins/ruflo-cost-tracker/scripts/budget.mjs check

按周期过滤:BUDGET_PERIOD=today(默认全部)。使用 BUDGET_QUIET=1 获得机器可读的 JSON。

查看 markdown 摘要——预算、已花费、剩余、使用率百分比、告警级别(🟢 OK · 🟡 INFO · 🟠 WARNING · 🔴 CRITICAL · 🛑 HARD_STOP)以及推荐操作。

设置 / 查看预算:

node plugins/ruflo-cost-tracker/scripts/budget.mjs set 50.00 node plugins/ruflo-cost-tracker/scripts/budget.mjs get

HARD_STOP 路径——当使用率 ≥ 100% 时,budget.mjs check 以退出码 1 结束。将关键 agent 启动包装为 budget.mjs check && spawn … 守卫,以实现失败关闭。

存储结构(cost-tracking:budget-config)

{ "budget_usd": 50.00, "setAt": "2026-05-05T...", "thresholds": { "info": 0.50, "warning": 0.75, "critical": 0.90, "hard_stop": 1.00 } }

告警阶梯(来自 REFERENCE.md,现已强制执行)

阈值 级别 操作

50% INFO 🟡 记录通知,不中断使用体验

75% WARNING 🟠 显示警告,建议 /cost-optimize

90% CRITICAL 🔴 紧急告警,建议降级模型

100% HARD_STOP 🛑 暂停非必要启动;退出码 1

交叉引用

cost-track(生产者)——填充 cost-tracking:session-*

cost-report——同一数据源,叙述式格式

cost-optimize——WARNING/CRITICAL 时的推荐操作

REFERENCE.md“Budget alert thresholds”——本技能所强制执行的已记录阶梯