用途:回答“每日燃尽是否正在加速”这一问题,是成本追踪前瞻技术栈中负责趋势观测的一环。与 cost-budget-check(反应式)、cost-projection(预测式)、cost-counterfactual(比较式)并列。
主要能力:读取 cost-tracking 命名空间中的全部 session-* 记录,按 --bucket 指定的时长窗口分桶(默认 1d),在 --lookback 范围内回溯(默认 14d);每个桶统计 {n: 会话数, spendUsd: 总花费};计算增量 delta = 最新桶花费 - 此前非空桶均值;当设置 --alert-on-acceleration-pct N 且 deltaPct 大于 N 时以退出码 1 告警。
使用方式:实现文件为 scripts/burn.mjs。示例:cost burn --bucket 1d --lookback 7d --alert-on-acceleration-pct 50,当最新桶 0.5 美元、此前均值 0.1 美元、阈值 50% 时输出告警并 exit 1;阈值设为 500 时输出 OK 并 exit 0。CI 集成示例:cost burn --bucket 1d --lookback 7d --alert-on-acceleration-pct 100 || alert-oncall。
适用场景:告警独立于预算,按速率加速触发,即使总花费远低于预算也能发现“上线了热循环、消耗达正常 10 倍”的情况。与 cost-trend 不同:cost-trend 数据源为 docs/benchmarks/runs/*.json,回答基准(胜率、延迟)是否漂移;cost-burn 数据源为 cost-tracking 命名空间,回答生产花费是否加速。
限制与边界:历史稀疏(无此前非空桶)时跳过告警并附原因字符串,exit 0;此前桶全为 0 而最新大于 0 时,JSON 中 delta 为 Infinity/null、表中标记为 new,不触发告警;--bucket 大于 --lookback 为硬错误,exit 2。其余收费、平台等信息暂未提供。