用途
Cost Report 用于生成指定周期的全面成本报告，展示 token 用量、美元成本和预算利用情况。当你需要了解当前支出——每个 agent 花费多少、哪些模型消耗最多预算、以及是否能在预算内运行——时使用它。
主要能力
- 检索用量数据：对 cost-tracking 命名空间调用
mcp__plugin_ruflo-core_ruflo__memory_search（或_list/_retrieve），周期默认是今天。memory_* 工具按命名空间字符串路由；agentdb_hierarchical-* 工具不这样路由（它们按 working|episodic|semantic 层级路由），因此此处不使用它们。 - 读取实测 booster 数据：如果
docs/benchmarks/runs/latest.json存在，通过 Bash 执行node -e 'console.log(JSON.stringify(JSON.parse(require("fs").readFileSync("docs/benchmarks/runs/latest.json")).summary))'加载。这提供 Tier 1 实测值——booster cost/edit（$0）、平均延迟、胜率，以及运行过的任何 LLM 基线（Gemini、Sonnet 4.6、Opus 4.7 的延迟和每次编辑成本）。在层级细分中使用这些实测的 Tier 值而非估算值。 - 计算成本：对每条记录按模型定价计算成本：
- Haiku：$0.25/M 输入，$1.25/M 输出
- Sonnet：$3.00/M 输入，$15.00/M 输出
- Opus：$15.00/M 输入，$75.00/M 输出
- 在适用时包含缓存写入/读取成本
- 按模型聚合：汇总每个模型的成本，计算占比。
- 按层级聚合：使用三个信号（按优先级）将每条记录归类为 Tier 1 / Tier 2 / Tier 3：(a) 来自上一步的基准数据——对于映射到已测量 booster 意图的记录，直接使用 $0 / 实测延迟；(b) 由 cost-booster-route 技能存储在 cost-tracking 中的
[AGENT_BOOSTER_AVAILABLE]标志；(c) 模型名称作为兜底（haiku → Tier 2；sonnet/opus → Tier 3）。汇总每层成本、计算占比，并统计 Tier 1 绕过次数。层级细分是最具可操作性的单行信息——它告诉用户 Sonnet/Opus 支出中有多大比例属于 Tier 1 可覆盖范围。 - 按 agent 聚合：汇总每个 agent 的成本，并包含该 agent 使用的模型。
- 检查预算：通过 memory_retrieve 召回预算配置并计算利用率百分比，检查告警阈值（50%/75%/90%/100%）。
- 输出报告：展示总成本、预算余额、层级细分（Tier 1 / Tier 2 / Tier 3）、模型细分、agent 细分、活跃告警。规范布局见 REFERENCE.md 的“Cost report shape”章节。
使用方式
CLI 替代方案：
npx @claude-flow/cli@latest memory search --query "cost report for today" --namespace cost-tracking
npx @claude-flow/cli@latest memory list --namespace cost-tracking
适用场景与限制
适用于需要按 agent 和模型了解成本支出、预算利用率与告警状态的场景，尤其适合评估 Sonnet/Opus 支出中可被 Tier 1 覆盖的比例。限制方面，其层级归类依赖基准数据、[AGENT_BOOSTER_AVAILABLE] 标志或模型名称兜底；路由须使用按命名空间字符串路由的 memory_* 工具。其他价格、平台或效果细节资料暂未提供。