mcpField
C
cost-summary

cost-summary

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

关于 cost-summary

cost-summary 是一个脚本接口，可从 cost-tracking 和 federation-spend 来源读取成本状态，供插件、脚本、仪表盘和机器人使用，并支持 Markdown 或约定格式的 JSON 输出；MCP 工具注册尚未纳入。

主要功能

  1. 01汇总多个成本来源
  2. 02提供稳定的 JSON 输出
  3. 03支持 Markdown 输出
  4. 04可配置命名空间和格式

适用场景

  1. 01供其他插件读取成本状态
  2. 02为仪表盘或 Slackbot 提供数据
  3. 03获取汇总成本快照

MCP 相关

项目明确暂缓注册 MCP 工具，通过命令行脚本以 Markdown 或 JSON 输出成本数据。

安装

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

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

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

详细介绍

成本汇总

一个稳定的单次调用接口，供其他插件／脚本／仪表板通过 shell 调用并解析。ADR-0002 曾考虑将 cost_report / cost_summary 作为正式 MCP 工具公开，但暂缓了这一做法——添加 MCP 工具需要修改 @claude-flow/cli 源码，这超出了插件本地工作的范围。此脚本实现了等效功能：数据相同，通过 stdout JSON 契约公开。

适用场景

  • 其他插件需要获取成本状态快照时，可通过 shell 调用 summary.mjs --format json 并解析结果。
  • 仪表板／Slackbot 获取单行成本汇总。
  • 快速查看“我现在的情况如何？”，从所有成本跟踪来源（cost-tracking + federation-spend）获取数据。

输出契约（JSON，稳定）

{
  "exportedAt": "<ISO>",
  "total_cost_usd": 1546.36,
  "sessionCount": 1,
  "conversationCount": 1,
  "byTier": { "haiku": 0, "sonnet": 0, "opus": 1546.36, "unknown": 0 },
  "byModel": {
    "claude-opus-4-7": {
      "tier": "opus",
      "cost_usd": 1546.36,
      "messages": 1597,
      "input_tokens": 3090,
      "output_tokens": 3295940,
      "cache_creation_input_tokens": 10659599,
      "cache_read_input_tokens": 732833690
    }
  },
  "topSession": {
    "sessionId": "1dba3b8c-...",
    "total_cost_usd": 1546.36,
    "messageCount": 1597
  },
  "budget": {
    "budget_usd": 2500.00,
    "setAt": "<ISO>",
    "spent_usd": 1546.36,
    "utilization": 0.6185,
    "level": "INFO"
  },
  "federation": {
    "eventCount": 0,
    "peerCount": 0,
    "totalUsd24h": 0
  }
}

步骤

# Markdown (default)
node plugins/ruflo-cost-tracker/scripts/summary.mjs

# JSON for programmatic consumption
node plugins/ruflo-cost-tracker/scripts/summary.mjs --format json

可选环境变量：SUMMARY_NAMESPACE=cost-tracking、SUMMARY_FED_NAMESPACE=federation-spend、SUMMARY_FORMAT=json。

交叉引用

  • cost-report — 文字报告（按 Agent／模型的视角；使用相同数据）
  • cost-export — 推送到 Prometheus／webhook（此技能采用拉取方式；导出采用推送方式）
  • ADR-0002 §"Decision" — 明确将正式注册为 MCP 工具一事推迟到未来的 ADR

评论

支持 Markdown