mcpField
C
cost-report

cost-report

github.com/ruvnetAgent 工作流80.0k729 次安装今天更新
代码仓库

关于 cost-report

用于 Ruflo 的 Agent 技能，可汇总指定时段的令牌用量、美元成本和预算使用率，并按模型、层级及 Agent 展示支出。

主要功能

  1. 01检索 cost-tracking 记录
  2. 02计算令牌及缓存成本
  3. 03按模型、层级和 Agent 汇总支出
  4. 04检查预算使用率及预警阈值
  5. 05使用实测 booster 基准数据

适用场景

  1. 01查看指定时段的支出
  2. 02找出成本较高的 Agent 或模型
  3. 03检查预算使用率和支出预警

MCP 相关

通过 Ruflo memory 工具检索 cost-tracking 记录和预算配置。也可使用 Ruflo CLI 检索记录。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/ruvnet/ruflo --skill cost-report

安装后在 Claude Code 中输入/cost-report确认已加载。

详细介绍

成本报告

生成一份全面的成本报告，显示指定时段内的 Token 用量、USD 成本和预算使用情况。

适用场景

当你需要了解当前支出时——每个 Agent 的成本、哪些模型消耗的预算最多，以及你的支出是否有望控制在预算内。

步骤

  1. 获取用量——针对指定时段（默认：今天），在 cost-tracking 命名空间调用 mcp__plugin_ruflo-core_ruflo__memory_search（或 _list / _retrieve）。memory_* 工具根据命名空间字符串路由；agentdb_hierarchical-* 工具则不会（它们按层级 working|episodic|semantic 路由），因此不要在此处使用。路由约定请参见 ruflo-agentdb ADR-0001 §“Namespace convention”。 1a. 读取实测的 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 成本/编辑次数（$0）、平均延迟、胜率，以及任何已运行的 LLM 基线（Gemini、Sonnet 4.6、Opus 4.7 的延迟和每次编辑成本）。在步骤 4 中使用这些数据，得出实测的层级细分，而非估算值。
  2. 计算成本——根据模型定价计算每条记录的成本：
    • Haiku：输入 $0.25/M，输出 $1.25/M
    • Sonnet：输入 $3.00/M，输出 $15.00/M
    • Opus：输入 $15.00/M，输出 $75.00/M
    • 在适用时计入缓存写入/读取成本
  3. 按模型汇总——对每个模型的成本求和，并计算占比
  4. 按层级汇总——按优先级使用以下三个信号，将每条记录归类为 Tier 1 / Tier 2 / Tier 3：(a) 步骤 1a 中的基准测试数据——对于映射到实测 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 的使用条件。
  5. 按 Agent 汇总——对每个 Agent 的成本求和，并注明其使用的模型
  6. 检查预算——通过 memory_retrieve 读取预算配置并计算使用率，检查预警阈值（50%/75%/90%/100%）
  7. 生成报告——显示：总成本、剩余预算、层级细分（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

评论

支持 Markdown