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”——本技能所强制执行的已记录阶梯