Skill: jobzhao15/huo15-cost-tracker (version 1.1.2)

--- name: huo15-cost-tracker description: 火一五成本追踪器 - 追踪 AI API 使用量、Token 消耗和成本计算。支持 MiniMax、OpenAI 等模型。触发词：成本追踪、火一五成本追踪、火一五成本追踪器、Cost Tracker、花费了多少、token 统计。 dependencies: optional: ["huo15-memory-evolution"] --- # 💰 火一五成本追踪器 (huo15-cost-tracker) > **作者**: 火一五信息科技有限公司 > **版本**: v1.1.0 --- ## 一、简介 成本追踪器用于记录 AI API 调用统计，包括： - Token 消耗（输入/输出） - API 调用次数 - 成本计算 - 会话时长 ### 核心功能 | 功能 | 说明 | |------|------| | 📊 **Token 统计** | 记录输入/输出 Token 数量 | | 💵 **成本计算** | 基于模型定价计算 USD 成本 | | 📈 **调用统计** | 记录 API 调用次数 | | ⏱️ **时长追踪** | 记录会话/任务时长 | | 📋 **报表生成** | 生成可视化成本报表 | --- ## 二、工作原理 ``` API 调用 → 记录 Token → 计算成本 → 存储统计 → 生成报表 ``` 每次 API 调用时记录： - 输入 Token 数量 - 输出 Token 数量 - 调用时间 - 模型名称 - 响应时长 --- ## 三、使用方式 ### 3.1 查看当前成本 ```bash cd ~/.openclaw/workspace/skills/huo15-cost-tracker ./scripts/report.sh ``` ### 3.2 重置统计 ```bash ./scripts/reset.sh ``` ### 3.3 记录 API 调用 ```bash ./scripts/track.sh record \ --input-tokens 1000 \ --output-tokens 500 \ --model "MiniMax-M2.1" \ --duration 1500 ``` ### 3.4 添加到 HEARTBEAT 在 HEARTBEAT.md 中添加定时报告： ```markdown ## 💰 成本检查（每30分钟） ./scripts/report.sh ``` --- ## 四、配置说明 ### 4.1 模型定价 配置文件：`config/pricing.json` ```json { "MiniMax-M2.1": { "inputTokens": 0.01, "outputTokens": 0.01, "unit": "per 1M tokens" }, "gpt-4o": { "inputTokens": 2.5, "outputTokens": 10, "unit": "per 1M tokens" } } ``` ### 4.2 报告格式 ```bash ======================================== 💰 成本追踪报表 ======================================== 会话: 2026-04-05 02:00 ---------------------------------------- 总 API 调用: 42 次 总 Input Tokens: 125,000 总 Output Tokens: 89,500 ---------------------------------------- 预估成本: $0.42 USD ---------------------------------------- 模型使用分布: MiniMax-M2.1: 35 次 (83%) 其他: 7 次 (17%) ---------------------------------------- 最耗时调用: 3,200ms 平均响应时间: 850ms ---------------------------------------- ``` --- ## 五、成本阈值警告 当成本超过阈值时自动提醒： ```bash # 设置警告阈值（默认 $1.00） ./scripts/track.sh set-threshold 1.0 # 查看当前阈值 ./scripts/track.sh get-threshold ``` 阈值配置在 `config/threshold.json`： ```json { "thresholdUSD": 1.0, "alertEnabled": true, "alertChannel": "wecom" } ``` --- ## 六、定时报告 ### 6.1 添加到 Cron ```bash # 每小时报告 0 * * * * /Users/jobzhao/.openclaw/workspace/skills/huo15-cost-tracker/scripts/report.sh # 每天报告（早上9点） 0 9 * * * /Users/jobzhao/.openclaw/workspace/skills/huo15-cost-tracker/scripts/daily-report.sh ``` ### 6.2 每日报告功能 ```bash # 生成每日成本摘要 ./scripts/daily-report.sh ``` 输出： ``` 📅 每日成本报告 - 2026-04-05 ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ 今日 API 调用: 42 次 今日 Token: 215,000 今日成本: $0.42 USD ━━━━━━━━━━━━━━━ 较昨日: +15% 📈 ``` --- ## 七、脚本清单 | 脚本 | 功能 | |------|------| | `track.sh` | 记录 API 调用 | | `report.sh` | 生成成本报表 | | `reset.sh` | 重置统计数据 | | `config.sh` | 配置管理 | --- ## 六、集成方式 ### 6.1 集成到 API 调用层 在调用 LLM API 时自动记录： ```bash # 调用 API 前 START_TIME=$(date +%s%3N) # 调用 API... # 调用 API 后 END_TIME=$(date +%s%3N) DURATION=$((END_TIME - START_TIME)) # 记录 ./scripts/track.sh record \ --input-tokens $INPUT \ --output-tokens $OUTPUT \ --model "MiniMax-M2.1" \ --duration $DURATION ``` ### 6.2 集成到 Dream Agent 在 dream.sh 中添加成本追踪： ```bash # Dream Agent 执行后 ./scripts/track.sh record \ --input-tokens $(cat /tmp/dream_input_tokens) \ --output-tokens $(cat /tmp/dream_output_tokens) \ --model "MiniMax-M2.1" \ --duration $(cat /tmp/dream_duration) ``` --- ## 七、版本历史 | 版本 | 日期 | 更新内容 | |------|------|---------| | **v1.1.0** | 2026-04-05 | 新增中文别名：火一五成本追踪，新增阈值警告，新增每日报告 | | v1.0.1 | 2026-04-05 | 修复 shell 变量解析警告 | | v1.0.0 | 2026-04-05 | 初始版本 |


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal:  | SkillSpector: suspicious (HIGH)