尧图网页设计 
ruflo-cost-tracker 实战指南Agent 成本归因、预算告警与优化闭环【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo导读本文围绕 ruflo 生态中的ruflo-cost-tracker插件系统讲解如何对每个 Agent、任务与模型做 Token 用量追踪与 USD 成本归因如何通过 50%/75%/90%/100% 四级预算告警实现软提示到硬停止的成本治理以及如何借助 Agent BoosterTier 1绕过、模型结果反馈、反事实分析与异常检测等能力构建从记账到省钱的完整闭环。读完本文你将掌握该插件的安装方式、20 个 Skill 与 23 个 CLI 子命令的完整用法、数据在 AgentDB 命名空间中的流转方式以及如何用 44 项 smoke 检查把成本契约固化进 CI。插件定位与整体数据流ruflo-cost-tracker的核心职责可以用一句话概括追踪每个 agent / task / model 的 token 用量 → 按当前模型定价折算 USD 成本 → 对照可配置预算触发分级告警 → 分析用量模式并给出可落地的优化建议。它不是一个孤立的记账工具而是与 ruflo 生态中的模型路由3-Tier Model Routing、Agent Booster、ruflo-loop-workers 后台 worker、federation 预算断路器ADR-097互相咬合的治理层。安装方式README.mdclaude --plugin-dir plugins/ruflo-cost-tracker从数据流看插件内部存在清晰的生产—消费关系生产者cost-track在每次会话结束时通过 Stop Hook 自动触发解析 Claude Code 的 session jsonl把结构化用量记录写入cost-tracking命名空间消费者cost-report、cost-optimize、cost-budget-check等所有分析型 Skill 都从cost-tracking读取数据输出层报告、告警、导出Prometheus / webhook、以及写回cost-patterns的优化模式。正如agents/cost-analyst.md所述cost track负责填充命名空间其余一切消费它。先跑cost-track否则其他 Skill 会操作在空数据上。数据模型AgentDB 命名空间与成本归因公式两个命名空间插件拥有两个 AgentDB 命名空间见 README.md Namespace coordination命名空间内容消费者cost-tracking会话级用量记录session-sessionId键与预算配置cost-report、cost-budget-check等cost-patterns优化建议模式cost-optimize两者都遵循 ruflo-agentdb 的 kebab-caseplugin-stem-intent命名约定见 ruflo-agentdb ADR-0001且必须通过memory_*工具族访问——memory_*按命名空间字符串路由而agentdb_hierarchical-*按 tierworking/episodic/semantic路由、agentdb_pattern-*按 ReasoningBank 路由它们不会按命名空间过滤。保留命名空间pattern、claude-memories、default不得被遮蔽。模型定价每 1M tokens单位 USD定价数据在 scripts/_prices.mjs 中是唯一事实来源与 REFERENCE.md 的表格保持同步模型InputOutputCache WriteCache ReadHaiku$0.25$1.25$0.30$0.03Sonnet$3.00$15.00$3.75$0.30Opus$15.00$75.00$18.75$1.50注意价格为公开列表价运行季度报告前建议对照官方定价页刷新REFERENCE.md。成本归因公式REFERENCE.md 定义了单条记录的成本计算task_cost (input_tokens / 1_000_000 * input_price) (output_tokens / 1_000_000 * output_price) (cache_write_tokens / 1_000_000 * cache_write_price) (cache_read_tokens / 1_000_000 * cache_read_price)源码中对应的实现是_prices.mjs的costForUsage(tier, usage)它对input_tokens、output_tokens、cache_creation_input_tokens、cache_read_input_tokens四个字段分别按该 tier 的单价折算后求和。modelTier(model)负责把模型 id 映射为haiku | sonnet | opus | unknown字符串包含判断costAtTier(tokens, tier)则用于反事实分析中把已经汇总的 token 总量按某个基准 tier 重新计价。一个值得注意的工程细节cache-read tokens 比全新 input 便宜 90%这正是提示缓存prompt caching高性价比的根源——Cache W 列也因此成为cost-session下钻的核心诊断维度。会话记录的捕获实现scripts/track.mjs是生产者实现默认解析~/.claude/projects/encoded-cwd/下最近修改的 session jsonl路径编码encodeProjectPath()把/、\、Windows 盘符冒号统一替换为-例如D:\project\Subcloudy→D--project-Subcloudy这是针对 Windows 路径的历史修复smoke 第 29b 项专门回归验证汇总summarizeSession()逐行解析 jsonl仅统计type assistant且带message.usage的记录按模型与 tier 累计 token 与成本持久化persistToMemory()通过spawnNpxSync显式参数调用memory store --namespace cost-tracking --key session-sessionId --value JSON避免 shell 转义问题支持CLI_CORE1走 cli-core 的 lite 路径把冷缓存墙钟时间从约 25s 降到约 2s。环境变量控制项包括TRACK_CWD覆盖扫描目录、TRACK_SESSION锁定具体 jsonl、TRACK_OUT额外写 JSON 摘要到文件、TRACK_DRY_RUN1跳过写入、TRACK_QUIET1抑制输出、TRACK_NAMESPACE默认cost-tracking。Stop Hook 自动捕获hooks/hooks.json 注册了Stophook会话结束时自动执行node -e require(require(path).join(process.env.CLAUDE_PLUGIN_ROOT,scripts,ruflo-hook.cjs))。这个node -e引导方式不依赖 shell 变量展开同一命令串在 Windows/macOS/Linux 上完全一致。ruflo-hook.cjs内部负责拉起track.mjs并保证追踪失败绝不阻塞会话结束分析数据是 best-effort不承担关键路径。TRACK_QUIET1可抑制 markdown 摘要。Skill 层20 个能力点插件为cost-analystAgent模型固定为 haiku挂载了 20 个 Skill。下表完整列出README.md SkillsSkill用法说明cost-report/cost-report [--period today]按 tier、model、agent 生成含 token 用量与 USD 成本的报告cost-optimize/cost-optimize分析用量模式、推荐优化并发出hooks_model-outcome事件cost-track/cost-track自动捕获当前会话 token 用量到cost-tracking命名空间生产者侧会话结束经 Stop Hook 自动触发无需手动调用cost-budget-check/cost-budget-check [--period today\|week\|month\|all]读取总额与预算配置发出 50/75/90/100% 告警阶梯HARD_STOP 时退出码 1cost-booster-route/cost-booster-route task经hooks_route路由任务并报告 Agent BoosterTier 1绕过利用率cost-booster-edit/cost-booster-edit intent file通过agent-booster.apply()执行Tier 1 变换亚毫秒、$0、确定性cost-benchmark/cost-benchmark [--llm] [--anthropic]运行语料基准把 measured-vs-claimed 表持久化到docs/benchmarks/runs/cost-trend/cost-trend读取所有基准 run暴露漂移win rate、latency、speedup标记二进制 smoke 门禁漏掉的回归cost-projection/cost-projection [--window 7d]前瞻性支出外推USD/天速率 × 7d/30d/90d/365d 视界 预算耗尽天数cost-budget-check的预测版对应物cost-counterfactual/cost-counterfactual [--since 7d] [--baseline all]对比性成本分析实际支出 vs always-haiku / always-sonnet / always-opus 基准。负节省标记过度升级正节省量化路由收益cost-burn/cost-burn [--bucket 1d] [--lookback 14d] [--alert-on-acceleration-pct N]趋势性烧钱速率分析窗口间 delta 可选漂移告警退出码能在预算告警之前抓住热循环烧钱 10 倍正常值cost-anomaly/cost-anomaly [--since 7d] [--threshold 3.5] [--alert-on-outliers N]点异常MAD 离群检测标记 |modified z| threshold 的会话Iglewicz-Hoaglin 3.5 默认值对离群本身稳健n10 也能工作cost-diff/cost-diff --baseline path --current path [--alert-on-pct N] [--alert-on-usd N]PR 回归检测对比两个 cost-summary JSON 快照按 |delta| 排序展示 per-tier per-model 明细可选 pct/USD 告警阈值用于 CI 门禁cost-session/cost-session [--session-id id] [--top 20] [--since iso-ts]下钻单个会话内的逐消息成本明细带 cache_write 列让 569-token 输出却花费 $16 的消息不再看起来荒谬与 cost-anomaly 配合cost-health/cost-health [--alert-acceleration 100] [--alert-outliers 1] [--skip burn,anomaly]复合 CI 门禁并行运行 budgetburnanomalyprojection返回max(exit)一次 shell-out 覆盖全部四级告警阶梯cost-conversation/cost-conversation按会话查看成本区别于 cost-report 的 per-agent / per-model 视角cost-export/cost-export [--prometheus path] [--webhook url]以 Prometheus textfile 或 webhook POST 输出成本数据cost-federation/cost-federationADR-097 Phase 3 消费者per-peer 1h/24h/7d federation_spend 滚动窗口cost-summary/cost-summary [--format json\|markdown]一次性程序化导出全部成本数据供插件间消费的稳定 JSON 契约cost-compact-context/cost-compact-context query包装getTokenOptimizer().getCompactContext()做检索压缩分析agentic-flow 未安装时优雅降级Smoke 第 41/42 项强制保证cost-analyst.md必须提及每一个 skill、README 的 skill 表格必须为每个 skill 保留一行——防止文档与实现漂移。CLI 命令层23 个子命令README 给出了完整的命令面commands/ruflo-cost.md 有逐条行为说明cost track # Auto-capture this sessions token usage (producer) cost report [--period today|week|month] # Cost report (with By-tier block, reads measured booster data) cost breakdown [--by agent|model|task] # Detailed breakdown by dimension cost optimize # Analyze usage and suggest savings ( auto-emits hooks_model-outcome via outcome.mjs) cost outcome task model outcome # Emit hooks_model-outcome (success|escalated|failure) so the router learns cost budget set amount # Set USD budget (real impl, persists to cost-tracking) cost budget get # Show current budget config cost budget check [--period ...] # Compute utilization alert; exit 1 on HARD_STOP cost benchmark [--llm] [--anthropic] # Run measured benchmark — booster optional Gemini/Sonnet/Opus baselines cost trend # Drift across bench runs (win rate, latency, regressions) cost projection [--window 7d] # Forward USD/day extrapolation days-until-budget-exhausted cost counterfactual [--since 7d] # Multi-baseline (haiku/sonnet/opus) — is routing earning its keep? cost burn [--bucket 1d] [--alert ...] # Burn-rate trend acceleration alert (exit 1 on drift) cost anomaly [--since 7d] [--alert ...] # MAD-based per-session outlier detection (exit 1 on outliers) cost diff --baseline p --current p ... # Snapshot delta — PR-level regression detection (exit 1 on N% growth) cost session [--session-id id] [--top N] # Per-message drill-down within one session (cache_write column!) cost health [--alert-acceleration N] ... # Composite CI gate: budgetburnanomalyprojection in parallel (max exit) cost conversation # Per-conversation cost view cost summary [--format json|markdown] # Programmatic JSON contract for inter-plugin consumption cost export [--prometheus] [--webhook] # External observability — Prometheus textfile webhook POST cost federation # ADR-097 Phase 3 federation_spend consumer cost workers # Inspect optimize benchmark loop-workers consumed cost history # Show cost tracking over time几个关键子命令的底层行为cost track无参运行时默认捕获当前工作目录最近一次会话输出总额、per-model 与 per-tier 明细以及持久化到的 memory keycost budget set amount真实实现运行node plugins/ruflo-cost-tracker/scripts/budget.mjs set amount把配置写入cost-tracking:budget-config默认阈值阶梯 50/75/90/100%cost budget check按BUDGET_PERIODtoday|week|month|all默认all过滤对cost-tracking中所有session-*记录累加total_cost_usd输出 OK / INFO / WARNING / CRITICAL / HARD_STOPHARD_STOP 时退出码 1——官方推荐的用法是budget check spawn ...即失败即关闭fail closedcost outcome task model outcome校验outcome ∈ {success, escalated, failure}后经outcome.mjs包装npx claude-flow/cli hooks model-outcome -t ... -m ... -o ...用显式 argv 的 spawnSync 保证引号安全。没有它路由就不会从 cost-optimize 的建议中学习Tier 1 绕过率也无法随时间收敛cost summary --format json输出total_cost_usd、sessionCount、byTier、byModel、topSession、budget、federation 聚合等字段是插件间消费的稳定 JSON 契约。summary.mjs还附带captureGitContextshaShort/isDirty用于快照可追溯性以及byTokenClass聚合让 cache_write 在聚合层不再隐身cost session通过--session-id扫描~/.claude/projects/*/定位 jsonl默认--latest输出 top-N 昂贵消息的完整 token 分解input / output / cache_write / cache_read与 p50/p90/p99 消息成本百分位并在消息成本超过 p99 的 2 倍时标记会话内离群——569-token 输出 $16的真相通常藏在 881898 cache writes 里。预算告警体系预算告警采用四级阶梯README.md Budget Alert Thresholds级别阈值动作Info50% 已消耗记录通知Warning75% 已消耗显示警告建议优化Critical90% 已消耗紧急告警建议模型降级Hard Stop100% 已消耗停止非必要的 Agent 派生预算按项目 会话维度通过插件命令配置。实现层的关键保障见 smoke.sh 第 32 项budget.mjs在计算alert之后必须执行 HARD_STOP 的process.exit(1)而不能被BUDGET_QUIET1分支的提前return吞掉——这是 iter-75 回归修复由test-health-integration.mjs做端到端断言。优化策略目录与落地ADR-0002 集成策略目录策略节省影响简单任务降级到 Haiku80-92%低复杂度工作影响极小启用提示缓存读取成本 -90%无质量不变批量相似操作15-25%轻微延迟增加使用 Agent BoosterTier 1100%仅限简单变换缩短系统提示10-20%需谨慎裁剪四条优化能力全部映射到真实工具README.md Optimization integration 明确每一条优化建议都必须对应真实工具而非启发式。四个上游能力及其落地能力位置暴露面Agent Booster 绕过Tier 1$0WASMhooks_route发出[AGENT_BOOSTER_AVAILABLE]CLInpx claude-flow/clilatest hooks route --task ...cost-booster-routeskillToken 优化器 / 压缩上下文getTokenOptimizer().getCompactContext()来自claude-flow/integration存在时使用agentic-flowcost-compact-contextskill模型结果反馈回路hooks_model-outcome旧routing-outcomes的类型化等价物cost-optimizeskill 第 8 步Optimize benchmark 后台 workerhooks_worker-status --worker optimize / --worker benchmark由 ruflo-loop-workers 声明cost workers命令 cost-analystagent事实边界声明仓库根 CLAUDE.md 中的百分比宣称retrieval -32%、booster edits -15%、352x 加速、95% 缓存命中均为上游声称、本仓库未验证。插件只把 Tier 1 绕过的结构性 $0 成本作为已测量节省上报其余数字一律打上 claimed upstream, not yet verified 标签——这正是 ADR-0002 的核心要求。Tier 1 路由与执行的完整链路cost-booster-route负责是否路由到 Tier 1对任务调用hooks_route按响应是否含[AGENT_BOOSTER_AVAILABLE]分组输出N tasks analyzed, M routed to Tier 1 (booster), avg latency 1ms, $0 cost。cost-booster-edit负责执行 Tier 1 变换包装agent-booster.apply()来自npm agent-booster经agentic-flow/agent-booster暴露。其调用契约来自node_modules/agent-booster/dist/index.d.tsbooster.apply({ code, edit, language }) → { output, success, latency, confidence, strategy, tokens }据 docs/benchmarks/0002-baseline.md 的实测基准平均延迟 1.2ms高置信案例add-error-handling、async-await走exact_replace策略模糊编辑var-to-const、add-types、remove-console走fuzzy_replace五个案例全部success: true。写入前必须检查confidence 0.5低于阈值升级到 Tier 2/3 并经hooks_model-outcome记录。Tier 感知的报告形态REFERENCE.md 定义了标准报告形状其中 By tier 块是全报告最有行动价值的一行 Cost Report (YYYY-MM-DD) Total: $12.45 / $50.00 budget (24.9%) By tier: Tier 1 (booster): $0.00 (0.0%) — 18 bypasses, $0 cost (no LLM call) Tier 2 (haiku): $0.45 (3.6%) — 1,200K input, 400K output Tier 3 (sonnetopus): $12.00 (96.4%) — 1,980K input, 348K output By model: Haiku: $0.45 (3.6%) — 1,200K input, 400K output Sonnet: $8.20 (65.9%) — 1,800K input, 320K output Opus: $3.80 (30.5%) — 180K input, 28K outputTier 分类规则优先级从高到低见 cost-report/SKILL.md基准数据docs/benchmarks/runs/latest.json中映射到已测 booster intent 的记录直接使用 $0 / 实测延迟[AGENT_BOOSTER_AVAILABLE]标志由cost-booster-route存入cost-tracking存在时为准模型名回退haiku→ Tier 2sonnet/opus→ Tier 3缺失/未知 → Tier 3保守。有了 tier 维度报告才能回答我有多少 Sonnet 花费本可以路由到 Tier 1——这是整个插件最有行动价值的一句话。高级分析预测、反事实、烧钱速率与异常检测前瞻性支出外推cost projectioncost projection --window 7d按测量窗口默认最近 7 天计算 USD/天速率线性外推到 7d/30d/90d/365d 视界--horizons可配若已设置预算输出75%/90%/100% 消耗倒计时表。可用于 CI 门禁例如jq .budget.exhaustion[2].daysUntilReached 7让距 100% 耗尽不足一周的构建失败。环境变量PROJECTION_NAMESPACE、PROJECTION_QUIET1。反事实分析cost counterfactualcost counterfactual --since 7d --baseline all把窗口内全部 token 分别按 always-haiku / always-sonnet / always-opus 三档基准定价得出假设成本与节省金额/百分比。负的 always-haiku 节省 过度升级信号路由选了 sonnet/opus 而 haiku 足以胜任正的 always-sonnet 节省 路由相对安全默认值的收益量化。CI 用法示例jq .baselines[1].savingsPct 30。烧钱速率趋势cost burncost burn --bucket 1d --lookback 14d --alert-on-acceleration-pct N把会话按--bucket时长分桶默认 1d覆盖--lookback默认 14d计算最新桶相对此前非空桶均值的 delta--alert-on-acceleration-pct N时最新桶超过前均值 N% 即退出码 1。它独立于预算——能在预算告警触发之前抓住热循环烧钱 10 倍正常值。边界处理无历史数据时告警 SKIPPED避免冷启动误报--bucket大于--lookback时退出码 2配置错误。它与cost trend有明确分工trend 跟踪基准 run 的漂移docs/benchmarks/runs/*.jsonburn 跟踪生产支出。MAD 点异常检测cost anomalycost anomaly --since 7d --threshold 3.5 --alert-on-outliers N计算median(total_cost_usd)与MAD median(|x - median|)逐会话计算修正 z 分数z 0.6745 × (x - median) / MADIglewicz-Hoaglin 1993标记|z| threshold默认 3.5的会话--alert-on-outliers N时找到 ≥N 个离群即退出码 1。MAD 优于均值σ 之处在于离群本身无法抬高它n10 也能稳健工作。边界n3 → insufficient data 退出码 0MAD0 → 解释性退出码 0。快照对比与 PR 回归cost diffcost diff --baseline path --current path --alert-on-pct N --alert-on-usd N --alert-on-class-pct class:N对两份 cost-summary JSON 快照校验必需字段total_cost_usdsessionCount计算总额 delta 与 per-tier、per-model、per-token-class含 cache_write明细按|delta|降序排列--alert-on-pct与--alert-on-usd可同时设置先触发的生效。与cost summary --format json组合即快照捕获 → 快照对比以稳定 JSON 契约为协议。复合门禁cost healthcost health --alert-acceleration 100 --alert-outliers 1 --alert-days-to-exhaust 14 --skip burn,anomaly用Promise.all并行派生 budget-check / burn / anomaly / projection 四个子检查各自--format jsonprojection 以daysUntilReached[100%] --alert-days-to-exhaust合成退出码最终返回max(exit_codes)——一次 shell-out 替代四个独立 CI 步骤。--skip list可关闭指定子检查如快速反馈的 smoke 运行跳过 burn。可观测性导出cost export --prometheus path --webhook url--prometheus path写出 node_exporter textfile-collector 格式带会话标签的 gauge counter--webhook urlPOST JSON认证通过EXPORT_WEBHOOK_HEADERK: V注入无 flag 时输出 stdout JSON。导出的指标集commands/ruflo-cost.mdcost_tracker_total_usd cost_tracker_tier_total_usd{tier...} cost_tracker_session_total_usd{session...} cost_tracker_session_messages{session...} cost_tracker_budget_usd cost_tracker_budget_utilization此外smoke 第 39a 项验证export.mjs还发出cost_tracker_tokens_total与byTierTokens/cache_creation_input_tokens把 cache_write 增长信号暴露给监控。联邦预算断路器联动ADR-097ruflo 3.6.25插件与 ADR-097 联邦预算信封 天然配对。federation_sendMCP 工具接受调用方提供的上限字段默认值作用maxHops8跨联邦 peer 递归委托的硬上限——遏制失控子 swarm 的成本级联maxTokens不设限整条 hop 链的 Σ tokens超限返回BUDGET_EXCEEDED常量字符串无 oracle 泄漏maxUsd不设限跨 hop 的 Σ USD同样强制hopCount0供转发的消息透传spent.{tokens,usd}0调用方上报的前几跳用量负数钳制为 0ADR-097 Phase 1 在send 侧执行。两个后续阶段会收紧集成Phase 2延后peer 状态机ACTIVE/SUSPENDED/EVICTED由滚动 24h 成本默认挂起阈值 $5 1h 失败率≥10 次发送中 50%驱动30 分钟冷却后自动恢复Phase 3延后federation_spend事件总线。每次federation_send完成发布{peerId, taskId, tokensUsed, usdSpent, ts}插件的 cost-tracker 聚合 per-peer 滚动窗口1h / 24h / 7d并经由现有cost-report暴露断路器查询聚合结果评估挂起阈值。重要限制Phase 3 落地前联邦支出不计入宿主 cost-tracker——只统计本地 agent 支出。使用联邦时应把cost-report数值视为下界REFERENCE.md Federation cost integration 同样强调这一点。历史教训命名空间路由修复ADR-0001ADR-0001 记录了一个真实 bug早期cost-report/cost-optimize向agentdb_hierarchical-recall传namespace: cost-tracking、向agentdb_pattern-store传namespace: cost-patterns但这两类工具根本不按命名空间路由agentdb_hierarchical-*按 tierworking|episodic|semantic路由namespace 参数被静默忽略agentdb_pattern-*经 ReasoningBank 路由namespace 参数被静默忽略回退写入保留命名空间pattern而非cost-patterns。修复方案Skill 改为memory_search/memory_list/memory_retrieve按命名空间路由cost-optimize同时记录两条写入路径ReasoningBank 路由的agentdb_pattern-store与命名空间路由的memory_store --namespace cost-patterns并新增无通配符工具授权的 smoke 契约。结论插件描述的要与实现一致且路由语义必须写进文档防止后续插件复制这个错误。验证与 CI本地验证README Verificationbash plugins/ruflo-cost-tracker/scripts/smoke.sh # Expected: 44 passed, 0 failedsmoke.sh 的 44 项检查覆盖plugin.json 版本与关键字、20 个 skill 的 frontmatter、memory_*路由而非agentdb_hierarchical-*、ADR 存在性与状态、无通配符工具授权、booster-route/compact-context 的字面量引用、worker 消费声明、corpus 规模≥18 个 Tier 1 案例 ≥6 个对抗案例总量 ≥25、latest.json的 Tier 1 winRate ≥ 0.80未运行时不阻塞、hooks.json 到 ruflo-hook.cjs 的接线、Windows 路径编码回归、以及所有scripts/*.mjs语法检查与_sessions.mjs共享加载器消费关系。CI 方面.github/workflows/cost-tracker-smoke.yml每个触碰本插件的 PR 都会运行 smoke booster-only bench 回归门禁Tier 1 winRate ≥ 0.80。LLM/Anthropic 基线不会在 CI 中运行——它们每次调用都花真金白银属于手动或定时工作流。CI 同时执行health.mjs对空输入无成本命名空间的优雅退出断言以及test-health-integration.mjs的 7 项端到端断言含 iter-75 回归目标BUDGET_QUIET1下的 HARD_STOP 必须以退出码 1 传播到复合门禁。兼容性约束README.md CompatibilityCLI 锁定claude-flow/cliv3.6 majorminorbash plugins/ruflo-cost-tracker/scripts/smoke.sh即契约。架构决策与相关插件ADR-0001 — 插件契约命名空间路由修复、联邦预算配对、smoke 即契约ADR-0002 — agentic-flow Agent Booster 集成、模型结果反馈回路、optimize-worker 消费、tier 感知报告含最冒险假设getTokenOptimizer暂无 MCP 包装cost-compact-context需 shell 一个 Node 单行程序调用若该路径被证明脆弱Decision #2 应延后其余决策不受影响ADR-0003 — 实现弧线 v0.5 → v0.15自动捕获、预算强制、模型结果反馈、可观测性、联邦消费者。相关插件生态ruflo-agentdb— 命名空间约定所有者定义了 ADR-0001 修复所违反的路由规则ruflo-observability— 经观测插桩采集 token 用量指标ruflo-neural-trader— PnL 追踪与成本调整后收益计算ruflo-federation— 出站federation_send上的预算断路器ADR-097ruflo-loop-workers—optimize与benchmark后台 worker 的调度方本插件仅消费其输出见 ruflo-loop-workers ADR-0001。总结从记账到省钱的闭环ruflo-cost-tracker的完整工作流可以归纳为五步闭环采集Stop Hook 自动运行cost-track把每次会话的 token 用量折算为 USD 后持久化到cost-tracking命名空间记账cost-report/cost-conversation/cost-summary提供 tier / model / agent / conversation 多维度视角预警cost-budget-check的四级告警阶梯 cost-projection的前瞻外推 cost-burn的速率趋势 cost-anomaly的点异常检测四个互补信号汇聚为cost-health复合门禁优化cost-optimize给出建议cost-booster-route/cost-booster-edit让 Tier 1$0、亚毫秒真正落地cost-outcome把执行结果反馈给模型路由器让路由策略随时间自我收紧治理cost-diff在 PR 层面拦截成本回归cost-federation为跨 peer 联邦支出补上断路器配套cost-export把一切输送给 Prometheus / webhook 等外部观测系统。整个闭环的每个环节都受 44 项 smoke 契约保护任何文档声称的能力与实际实现之间的漂移都会在 CI 中被拦截——这也是本插件区别于普通成本记账工具的根本所在。【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 ruflo-cost-tracker 实战指南：Agent 成本归因、预算告警与优化闭环
ruflo-cost-tracker 实战指南Agent 成本归因、预算告警与优化闭环【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo导读本文围绕 ruflo 生态中的ruflo-cost-tracker插件系统讲解如何对每个 Agent、任务与模型做 Token 用量追踪与 USD 成本归因如何通过 50%/75%/90%/100% 四级预算告警实现软提示到硬停止的成本治理以及如何借助 Agent BoosterTier 1绕过、模型结果反馈、反事实分析与异常检测等能力构建从记账到省钱的完整闭环。读完本文你将掌握该插件的安装方式、20 个 Skill 与 23 个 CLI 子命令的完整用法、数据在 AgentDB 命名空间中的流转方式以及如何用 44 项 smoke 检查把成本契约固化进 CI。插件定位与整体数据流ruflo-cost-tracker的核心职责可以用一句话概括追踪每个 agent / task / model 的 token 用量 → 按当前模型定价折算 USD 成本 → 对照可配置预算触发分级告警 → 分析用量模式并给出可落地的优化建议。它不是一个孤立的记账工具而是与 ruflo 生态中的模型路由3-Tier Model Routing、Agent Booster、ruflo-loop-workers 后台 worker、federation 预算断路器ADR-097互相咬合的治理层。安装方式README.mdclaude --plugin-dir plugins/ruflo-cost-tracker从数据流看插件内部存在清晰的生产—消费关系生产者cost-track在每次会话结束时通过 Stop Hook 自动触发解析 Claude Code 的 session jsonl把结构化用量记录写入cost-tracking命名空间消费者cost-report、cost-optimize、cost-budget-check等所有分析型 Skill 都从cost-tracking读取数据输出层报告、告警、导出Prometheus / webhook、以及写回cost-patterns的优化模式。正如agents/cost-analyst.md所述cost track负责填充命名空间其余一切消费它。先跑cost-track否则其他 Skill 会操作在空数据上。数据模型AgentDB 命名空间与成本归因公式两个命名空间插件拥有两个 AgentDB 命名空间见 README.md Namespace coordination命名空间内容消费者cost-tracking会话级用量记录session-sessionId键与预算配置cost-report、cost-budget-check等cost-patterns优化建议模式cost-optimize两者都遵循 ruflo-agentdb 的 kebab-caseplugin-stem-intent命名约定见 ruflo-agentdb ADR-0001且必须通过memory_*工具族访问——memory_*按命名空间字符串路由而agentdb_hierarchical-*按 tierworking/episodic/semantic路由、agentdb_pattern-*按 ReasoningBank 路由它们不会按命名空间过滤。保留命名空间pattern、claude-memories、default不得被遮蔽。模型定价每 1M tokens单位 USD定价数据在 scripts/_prices.mjs 中是唯一事实来源与 REFERENCE.md 的表格保持同步模型InputOutputCache WriteCache ReadHaiku$0.25$1.25$0.30$0.03Sonnet$3.00$15.00$3.75$0.30Opus$15.00$75.00$18.75$1.50注意价格为公开列表价运行季度报告前建议对照官方定价页刷新REFERENCE.md。成本归因公式REFERENCE.md 定义了单条记录的成本计算task_cost (input_tokens / 1_000_000 * input_price) (output_tokens / 1_000_000 * output_price) (cache_write_tokens / 1_000_000 * cache_write_price) (cache_read_tokens / 1_000_000 * cache_read_price)源码中对应的实现是_prices.mjs的costForUsage(tier, usage)它对input_tokens、output_tokens、cache_creation_input_tokens、cache_read_input_tokens四个字段分别按该 tier 的单价折算后求和。modelTier(model)负责把模型 id 映射为haiku | sonnet | opus | unknown字符串包含判断costAtTier(tokens, tier)则用于反事实分析中把已经汇总的 token 总量按某个基准 tier 重新计价。一个值得注意的工程细节cache-read tokens 比全新 input 便宜 90%这正是提示缓存prompt caching高性价比的根源——Cache W 列也因此成为cost-session下钻的核心诊断维度。会话记录的捕获实现scripts/track.mjs是生产者实现默认解析~/.claude/projects/encoded-cwd/下最近修改的 session jsonl路径编码encodeProjectPath()把/、\、Windows 盘符冒号统一替换为-例如D:\project\Subcloudy→D--project-Subcloudy这是针对 Windows 路径的历史修复smoke 第 29b 项专门回归验证汇总summarizeSession()逐行解析 jsonl仅统计type assistant且带message.usage的记录按模型与 tier 累计 token 与成本持久化persistToMemory()通过spawnNpxSync显式参数调用memory store --namespace cost-tracking --key session-sessionId --value JSON避免 shell 转义问题支持CLI_CORE1走 cli-core 的 lite 路径把冷缓存墙钟时间从约 25s 降到约 2s。环境变量控制项包括TRACK_CWD覆盖扫描目录、TRACK_SESSION锁定具体 jsonl、TRACK_OUT额外写 JSON 摘要到文件、TRACK_DRY_RUN1跳过写入、TRACK_QUIET1抑制输出、TRACK_NAMESPACE默认cost-tracking。Stop Hook 自动捕获hooks/hooks.json 注册了Stophook会话结束时自动执行node -e require(require(path).join(process.env.CLAUDE_PLUGIN_ROOT,scripts,ruflo-hook.cjs))。这个node -e引导方式不依赖 shell 变量展开同一命令串在 Windows/macOS/Linux 上完全一致。ruflo-hook.cjs内部负责拉起track.mjs并保证追踪失败绝不阻塞会话结束分析数据是 best-effort不承担关键路径。TRACK_QUIET1可抑制 markdown 摘要。Skill 层20 个能力点插件为cost-analystAgent模型固定为 haiku挂载了 20 个 Skill。下表完整列出README.md SkillsSkill用法说明cost-report/cost-report [--period today]按 tier、model、agent 生成含 token 用量与 USD 成本的报告cost-optimize/cost-optimize分析用量模式、推荐优化并发出hooks_model-outcome事件cost-track/cost-track自动捕获当前会话 token 用量到cost-tracking命名空间生产者侧会话结束经 Stop Hook 自动触发无需手动调用cost-budget-check/cost-budget-check [--period today\|week\|month\|all]读取总额与预算配置发出 50/75/90/100% 告警阶梯HARD_STOP 时退出码 1cost-booster-route/cost-booster-route task经hooks_route路由任务并报告 Agent BoosterTier 1绕过利用率cost-booster-edit/cost-booster-edit intent file通过agent-booster.apply()执行Tier 1 变换亚毫秒、$0、确定性cost-benchmark/cost-benchmark [--llm] [--anthropic]运行语料基准把 measured-vs-claimed 表持久化到docs/benchmarks/runs/cost-trend/cost-trend读取所有基准 run暴露漂移win rate、latency、speedup标记二进制 smoke 门禁漏掉的回归cost-projection/cost-projection [--window 7d]前瞻性支出外推USD/天速率 × 7d/30d/90d/365d 视界 预算耗尽天数cost-budget-check的预测版对应物cost-counterfactual/cost-counterfactual [--since 7d] [--baseline all]对比性成本分析实际支出 vs always-haiku / always-sonnet / always-opus 基准。负节省标记过度升级正节省量化路由收益cost-burn/cost-burn [--bucket 1d] [--lookback 14d] [--alert-on-acceleration-pct N]趋势性烧钱速率分析窗口间 delta 可选漂移告警退出码能在预算告警之前抓住热循环烧钱 10 倍正常值cost-anomaly/cost-anomaly [--since 7d] [--threshold 3.5] [--alert-on-outliers N]点异常MAD 离群检测标记 |modified z| threshold 的会话Iglewicz-Hoaglin 3.5 默认值对离群本身稳健n10 也能工作cost-diff/cost-diff --baseline path --current path [--alert-on-pct N] [--alert-on-usd N]PR 回归检测对比两个 cost-summary JSON 快照按 |delta| 排序展示 per-tier per-model 明细可选 pct/USD 告警阈值用于 CI 门禁cost-session/cost-session [--session-id id] [--top 20] [--since iso-ts]下钻单个会话内的逐消息成本明细带 cache_write 列让 569-token 输出却花费 $16 的消息不再看起来荒谬与 cost-anomaly 配合cost-health/cost-health [--alert-acceleration 100] [--alert-outliers 1] [--skip burn,anomaly]复合 CI 门禁并行运行 budgetburnanomalyprojection返回max(exit)一次 shell-out 覆盖全部四级告警阶梯cost-conversation/cost-conversation按会话查看成本区别于 cost-report 的 per-agent / per-model 视角cost-export/cost-export [--prometheus path] [--webhook url]以 Prometheus textfile 或 webhook POST 输出成本数据cost-federation/cost-federationADR-097 Phase 3 消费者per-peer 1h/24h/7d federation_spend 滚动窗口cost-summary/cost-summary [--format json\|markdown]一次性程序化导出全部成本数据供插件间消费的稳定 JSON 契约cost-compact-context/cost-compact-context query包装getTokenOptimizer().getCompactContext()做检索压缩分析agentic-flow 未安装时优雅降级Smoke 第 41/42 项强制保证cost-analyst.md必须提及每一个 skill、README 的 skill 表格必须为每个 skill 保留一行——防止文档与实现漂移。CLI 命令层23 个子命令README 给出了完整的命令面commands/ruflo-cost.md 有逐条行为说明cost track # Auto-capture this sessions token usage (producer) cost report [--period today|week|month] # Cost report (with By-tier block, reads measured booster data) cost breakdown [--by agent|model|task] # Detailed breakdown by dimension cost optimize # Analyze usage and suggest savings ( auto-emits hooks_model-outcome via outcome.mjs) cost outcome task model outcome # Emit hooks_model-outcome (success|escalated|failure) so the router learns cost budget set amount # Set USD budget (real impl, persists to cost-tracking) cost budget get # Show current budget config cost budget check [--period ...] # Compute utilization alert; exit 1 on HARD_STOP cost benchmark [--llm] [--anthropic] # Run measured benchmark — booster optional Gemini/Sonnet/Opus baselines cost trend # Drift across bench runs (win rate, latency, regressions) cost projection [--window 7d] # Forward USD/day extrapolation days-until-budget-exhausted cost counterfactual [--since 7d] # Multi-baseline (haiku/sonnet/opus) — is routing earning its keep? cost burn [--bucket 1d] [--alert ...] # Burn-rate trend acceleration alert (exit 1 on drift) cost anomaly [--since 7d] [--alert ...] # MAD-based per-session outlier detection (exit 1 on outliers) cost diff --baseline p --current p ... # Snapshot delta — PR-level regression detection (exit 1 on N% growth) cost session [--session-id id] [--top N] # Per-message drill-down within one session (cache_write column!) cost health [--alert-acceleration N] ... # Composite CI gate: budgetburnanomalyprojection in parallel (max exit) cost conversation # Per-conversation cost view cost summary [--format json|markdown] # Programmatic JSON contract for inter-plugin consumption cost export [--prometheus] [--webhook] # External observability — Prometheus textfile webhook POST cost federation # ADR-097 Phase 3 federation_spend consumer cost workers # Inspect optimize benchmark loop-workers consumed cost history # Show cost tracking over time几个关键子命令的底层行为cost track无参运行时默认捕获当前工作目录最近一次会话输出总额、per-model 与 per-tier 明细以及持久化到的 memory keycost budget set amount真实实现运行node plugins/ruflo-cost-tracker/scripts/budget.mjs set amount把配置写入cost-tracking:budget-config默认阈值阶梯 50/75/90/100%cost budget check按BUDGET_PERIODtoday|week|month|all默认all过滤对cost-tracking中所有session-*记录累加total_cost_usd输出 OK / INFO / WARNING / CRITICAL / HARD_STOPHARD_STOP 时退出码 1——官方推荐的用法是budget check spawn ...即失败即关闭fail closedcost outcome task model outcome校验outcome ∈ {success, escalated, failure}后经outcome.mjs包装npx claude-flow/cli hooks model-outcome -t ... -m ... -o ...用显式 argv 的 spawnSync 保证引号安全。没有它路由就不会从 cost-optimize 的建议中学习Tier 1 绕过率也无法随时间收敛cost summary --format json输出total_cost_usd、sessionCount、byTier、byModel、topSession、budget、federation 聚合等字段是插件间消费的稳定 JSON 契约。summary.mjs还附带captureGitContextshaShort/isDirty用于快照可追溯性以及byTokenClass聚合让 cache_write 在聚合层不再隐身cost session通过--session-id扫描~/.claude/projects/*/定位 jsonl默认--latest输出 top-N 昂贵消息的完整 token 分解input / output / cache_write / cache_read与 p50/p90/p99 消息成本百分位并在消息成本超过 p99 的 2 倍时标记会话内离群——569-token 输出 $16的真相通常藏在 881898 cache writes 里。预算告警体系预算告警采用四级阶梯README.md Budget Alert Thresholds级别阈值动作Info50% 已消耗记录通知Warning75% 已消耗显示警告建议优化Critical90% 已消耗紧急告警建议模型降级Hard Stop100% 已消耗停止非必要的 Agent 派生预算按项目 会话维度通过插件命令配置。实现层的关键保障见 smoke.sh 第 32 项budget.mjs在计算alert之后必须执行 HARD_STOP 的process.exit(1)而不能被BUDGET_QUIET1分支的提前return吞掉——这是 iter-75 回归修复由test-health-integration.mjs做端到端断言。优化策略目录与落地ADR-0002 集成策略目录策略节省影响简单任务降级到 Haiku80-92%低复杂度工作影响极小启用提示缓存读取成本 -90%无质量不变批量相似操作15-25%轻微延迟增加使用 Agent BoosterTier 1100%仅限简单变换缩短系统提示10-20%需谨慎裁剪四条优化能力全部映射到真实工具README.md Optimization integration 明确每一条优化建议都必须对应真实工具而非启发式。四个上游能力及其落地能力位置暴露面Agent Booster 绕过Tier 1$0WASMhooks_route发出[AGENT_BOOSTER_AVAILABLE]CLInpx claude-flow/clilatest hooks route --task ...cost-booster-routeskillToken 优化器 / 压缩上下文getTokenOptimizer().getCompactContext()来自claude-flow/integration存在时使用agentic-flowcost-compact-contextskill模型结果反馈回路hooks_model-outcome旧routing-outcomes的类型化等价物cost-optimizeskill 第 8 步Optimize benchmark 后台 workerhooks_worker-status --worker optimize / --worker benchmark由 ruflo-loop-workers 声明cost workers命令 cost-analystagent事实边界声明仓库根 CLAUDE.md 中的百分比宣称retrieval -32%、booster edits -15%、352x 加速、95% 缓存命中均为上游声称、本仓库未验证。插件只把 Tier 1 绕过的结构性 $0 成本作为已测量节省上报其余数字一律打上 claimed upstream, not yet verified 标签——这正是 ADR-0002 的核心要求。Tier 1 路由与执行的完整链路cost-booster-route负责是否路由到 Tier 1对任务调用hooks_route按响应是否含[AGENT_BOOSTER_AVAILABLE]分组输出N tasks analyzed, M routed to Tier 1 (booster), avg latency 1ms, $0 cost。cost-booster-edit负责执行 Tier 1 变换包装agent-booster.apply()来自npm agent-booster经agentic-flow/agent-booster暴露。其调用契约来自node_modules/agent-booster/dist/index.d.tsbooster.apply({ code, edit, language }) → { output, success, latency, confidence, strategy, tokens }据 docs/benchmarks/0002-baseline.md 的实测基准平均延迟 1.2ms高置信案例add-error-handling、async-await走exact_replace策略模糊编辑var-to-const、add-types、remove-console走fuzzy_replace五个案例全部success: true。写入前必须检查confidence 0.5低于阈值升级到 Tier 2/3 并经hooks_model-outcome记录。Tier 感知的报告形态REFERENCE.md 定义了标准报告形状其中 By tier 块是全报告最有行动价值的一行 Cost Report (YYYY-MM-DD) Total: $12.45 / $50.00 budget (24.9%) By tier: Tier 1 (booster): $0.00 (0.0%) — 18 bypasses, $0 cost (no LLM call) Tier 2 (haiku): $0.45 (3.6%) — 1,200K input, 400K output Tier 3 (sonnetopus): $12.00 (96.4%) — 1,980K input, 348K output By model: Haiku: $0.45 (3.6%) — 1,200K input, 400K output Sonnet: $8.20 (65.9%) — 1,800K input, 320K output Opus: $3.80 (30.5%) — 180K input, 28K outputTier 分类规则优先级从高到低见 cost-report/SKILL.md基准数据docs/benchmarks/runs/latest.json中映射到已测 booster intent 的记录直接使用 $0 / 实测延迟[AGENT_BOOSTER_AVAILABLE]标志由cost-booster-route存入cost-tracking存在时为准模型名回退haiku→ Tier 2sonnet/opus→ Tier 3缺失/未知 → Tier 3保守。有了 tier 维度报告才能回答我有多少 Sonnet 花费本可以路由到 Tier 1——这是整个插件最有行动价值的一句话。高级分析预测、反事实、烧钱速率与异常检测前瞻性支出外推cost projectioncost projection --window 7d按测量窗口默认最近 7 天计算 USD/天速率线性外推到 7d/30d/90d/365d 视界--horizons可配若已设置预算输出75%/90%/100% 消耗倒计时表。可用于 CI 门禁例如jq .budget.exhaustion[2].daysUntilReached 7让距 100% 耗尽不足一周的构建失败。环境变量PROJECTION_NAMESPACE、PROJECTION_QUIET1。反事实分析cost counterfactualcost counterfactual --since 7d --baseline all把窗口内全部 token 分别按 always-haiku / always-sonnet / always-opus 三档基准定价得出假设成本与节省金额/百分比。负的 always-haiku 节省 过度升级信号路由选了 sonnet/opus 而 haiku 足以胜任正的 always-sonnet 节省 路由相对安全默认值的收益量化。CI 用法示例jq .baselines[1].savingsPct 30。烧钱速率趋势cost burncost burn --bucket 1d --lookback 14d --alert-on-acceleration-pct N把会话按--bucket时长分桶默认 1d覆盖--lookback默认 14d计算最新桶相对此前非空桶均值的 delta--alert-on-acceleration-pct N时最新桶超过前均值 N% 即退出码 1。它独立于预算——能在预算告警触发之前抓住热循环烧钱 10 倍正常值。边界处理无历史数据时告警 SKIPPED避免冷启动误报--bucket大于--lookback时退出码 2配置错误。它与cost trend有明确分工trend 跟踪基准 run 的漂移docs/benchmarks/runs/*.jsonburn 跟踪生产支出。MAD 点异常检测cost anomalycost anomaly --since 7d --threshold 3.5 --alert-on-outliers N计算median(total_cost_usd)与MAD median(|x - median|)逐会话计算修正 z 分数z 0.6745 × (x - median) / MADIglewicz-Hoaglin 1993标记|z| threshold默认 3.5的会话--alert-on-outliers N时找到 ≥N 个离群即退出码 1。MAD 优于均值σ 之处在于离群本身无法抬高它n10 也能稳健工作。边界n3 → insufficient data 退出码 0MAD0 → 解释性退出码 0。快照对比与 PR 回归cost diffcost diff --baseline path --current path --alert-on-pct N --alert-on-usd N --alert-on-class-pct class:N对两份 cost-summary JSON 快照校验必需字段total_cost_usdsessionCount计算总额 delta 与 per-tier、per-model、per-token-class含 cache_write明细按|delta|降序排列--alert-on-pct与--alert-on-usd可同时设置先触发的生效。与cost summary --format json组合即快照捕获 → 快照对比以稳定 JSON 契约为协议。复合门禁cost healthcost health --alert-acceleration 100 --alert-outliers 1 --alert-days-to-exhaust 14 --skip burn,anomaly用Promise.all并行派生 budget-check / burn / anomaly / projection 四个子检查各自--format jsonprojection 以daysUntilReached[100%] --alert-days-to-exhaust合成退出码最终返回max(exit_codes)——一次 shell-out 替代四个独立 CI 步骤。--skip list可关闭指定子检查如快速反馈的 smoke 运行跳过 burn。可观测性导出cost export --prometheus path --webhook url--prometheus path写出 node_exporter textfile-collector 格式带会话标签的 gauge counter--webhook urlPOST JSON认证通过EXPORT_WEBHOOK_HEADERK: V注入无 flag 时输出 stdout JSON。导出的指标集commands/ruflo-cost.mdcost_tracker_total_usd cost_tracker_tier_total_usd{tier...} cost_tracker_session_total_usd{session...} cost_tracker_session_messages{session...} cost_tracker_budget_usd cost_tracker_budget_utilization此外smoke 第 39a 项验证export.mjs还发出cost_tracker_tokens_total与byTierTokens/cache_creation_input_tokens把 cache_write 增长信号暴露给监控。联邦预算断路器联动ADR-097ruflo 3.6.25插件与 ADR-097 联邦预算信封 天然配对。federation_sendMCP 工具接受调用方提供的上限字段默认值作用maxHops8跨联邦 peer 递归委托的硬上限——遏制失控子 swarm 的成本级联maxTokens不设限整条 hop 链的 Σ tokens超限返回BUDGET_EXCEEDED常量字符串无 oracle 泄漏maxUsd不设限跨 hop 的 Σ USD同样强制hopCount0供转发的消息透传spent.{tokens,usd}0调用方上报的前几跳用量负数钳制为 0ADR-097 Phase 1 在send 侧执行。两个后续阶段会收紧集成Phase 2延后peer 状态机ACTIVE/SUSPENDED/EVICTED由滚动 24h 成本默认挂起阈值 $5 1h 失败率≥10 次发送中 50%驱动30 分钟冷却后自动恢复Phase 3延后federation_spend事件总线。每次federation_send完成发布{peerId, taskId, tokensUsed, usdSpent, ts}插件的 cost-tracker 聚合 per-peer 滚动窗口1h / 24h / 7d并经由现有cost-report暴露断路器查询聚合结果评估挂起阈值。重要限制Phase 3 落地前联邦支出不计入宿主 cost-tracker——只统计本地 agent 支出。使用联邦时应把cost-report数值视为下界REFERENCE.md Federation cost integration 同样强调这一点。历史教训命名空间路由修复ADR-0001ADR-0001 记录了一个真实 bug早期cost-report/cost-optimize向agentdb_hierarchical-recall传namespace: cost-tracking、向agentdb_pattern-store传namespace: cost-patterns但这两类工具根本不按命名空间路由agentdb_hierarchical-*按 tierworking|episodic|semantic路由namespace 参数被静默忽略agentdb_pattern-*经 ReasoningBank 路由namespace 参数被静默忽略回退写入保留命名空间pattern而非cost-patterns。修复方案Skill 改为memory_search/memory_list/memory_retrieve按命名空间路由cost-optimize同时记录两条写入路径ReasoningBank 路由的agentdb_pattern-store与命名空间路由的memory_store --namespace cost-patterns并新增无通配符工具授权的 smoke 契约。结论插件描述的要与实现一致且路由语义必须写进文档防止后续插件复制这个错误。验证与 CI本地验证README Verificationbash plugins/ruflo-cost-tracker/scripts/smoke.sh # Expected: 44 passed, 0 failedsmoke.sh 的 44 项检查覆盖plugin.json 版本与关键字、20 个 skill 的 frontmatter、memory_*路由而非agentdb_hierarchical-*、ADR 存在性与状态、无通配符工具授权、booster-route/compact-context 的字面量引用、worker 消费声明、corpus 规模≥18 个 Tier 1 案例 ≥6 个对抗案例总量 ≥25、latest.json的 Tier 1 winRate ≥ 0.80未运行时不阻塞、hooks.json 到 ruflo-hook.cjs 的接线、Windows 路径编码回归、以及所有scripts/*.mjs语法检查与_sessions.mjs共享加载器消费关系。CI 方面.github/workflows/cost-tracker-smoke.yml每个触碰本插件的 PR 都会运行 smoke booster-only bench 回归门禁Tier 1 winRate ≥ 0.80。LLM/Anthropic 基线不会在 CI 中运行——它们每次调用都花真金白银属于手动或定时工作流。CI 同时执行health.mjs对空输入无成本命名空间的优雅退出断言以及test-health-integration.mjs的 7 项端到端断言含 iter-75 回归目标BUDGET_QUIET1下的 HARD_STOP 必须以退出码 1 传播到复合门禁。兼容性约束README.md CompatibilityCLI 锁定claude-flow/cliv3.6 majorminorbash plugins/ruflo-cost-tracker/scripts/smoke.sh即契约。架构决策与相关插件ADR-0001 — 插件契约命名空间路由修复、联邦预算配对、smoke 即契约ADR-0002 — agentic-flow Agent Booster 集成、模型结果反馈回路、optimize-worker 消费、tier 感知报告含最冒险假设getTokenOptimizer暂无 MCP 包装cost-compact-context需 shell 一个 Node 单行程序调用若该路径被证明脆弱Decision #2 应延后其余决策不受影响ADR-0003 — 实现弧线 v0.5 → v0.15自动捕获、预算强制、模型结果反馈、可观测性、联邦消费者。相关插件生态ruflo-agentdb— 命名空间约定所有者定义了 ADR-0001 修复所违反的路由规则ruflo-observability— 经观测插桩采集 token 用量指标ruflo-neural-trader— PnL 追踪与成本调整后收益计算ruflo-federation— 出站federation_send上的预算断路器ADR-097ruflo-loop-workers—optimize与benchmark后台 worker 的调度方本插件仅消费其输出见 ruflo-loop-workers ADR-0001。总结从记账到省钱的闭环ruflo-cost-tracker的完整工作流可以归纳为五步闭环采集Stop Hook 自动运行cost-track把每次会话的 token 用量折算为 USD 后持久化到cost-tracking命名空间记账cost-report/cost-conversation/cost-summary提供 tier / model / agent / conversation 多维度视角预警cost-budget-check的四级告警阶梯 cost-projection的前瞻外推 cost-burn的速率趋势 cost-anomaly的点异常检测四个互补信号汇聚为cost-health复合门禁优化cost-optimize给出建议cost-booster-route/cost-booster-edit让 Tier 1$0、亚毫秒真正落地cost-outcome把执行结果反馈给模型路由器让路由策略随时间自我收紧治理cost-diff在 PR 层面拦截成本回归cost-federation为跨 peer 联邦支出补上断路器配套cost-export把一切输送给 Prometheus / webhook 等外部观测系统。整个闭环的每个环节都受 44 项 smoke 契约保护任何文档声称的能力与实际实现之间的漂移都会在 CI 中被拦截——这也是本插件区别于普通成本记账工具的根本所在。【免费下载链接】ruflo The original agent meta-harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, RAG integration, and native Claude Code / Codex / Hermes and many more Integrated项目地址: https://gitcode.com/GitHub_Trending/cl/ruflo创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考