核心用法
token-stats 是一款 Python 命令行工具，用于统一监控多种 AI 编程助手的 Token 消耗数据。用户通过交互式菜单选择目标 Agent（Hermes/Claude Code/CodeX/OpenClaw/Reasonix/DeepSeek TUI），或直接指定 -a 参数快速查看。支持 --watch 实时刷新模式，满足持续监控需求。
显著优点
- 零依赖架构：仅使用 Python 标准库，无需额外安装包，部署极简
- 纯本地数据处理：直接读取各 Agent 本地数据库/JSONL 日志，不上传云端，隐私可控
- 跨 Agent 兼容性：覆盖 6 款主流工具，统一抽象不同数据格式
- 灵活集成：可作为 Hermes Skill 嵌入任务流程，自动输出消耗报告
潜在缺点与局限
- 数据源依赖性强：需各 Agent 已产生使用记录，且路径格式固定
- 平台覆盖有限：目前仅支持类 Unix 路径结构（
~/.agent/），Windows 兼容性未明确 - 功能单一：专注 Token 计数，无成本估算、趋势分析等进阶功能
- 版本碎片化风险：Agent 数据结构变更可能导致读取失败
适合人群
- 多 Agent 并行使用的开发者，需统一查看各工具消耗对比
- 对数据隐私敏感、倾向本地分析的技术用户
- 希望快速集成消耗追踪到自动化工作流的高级用户
常规风险
- 数据路径变更：Agent 升级可能移动存储位置，需持续维护映射表
- 隐私泄露隐患：虽不上传云端，但本地日志可能包含敏感代码片段
- MIT 授权无担保：作者不承担数据丢失或安全漏洞责任
- 未经验证的生态：ClawHub 分发渠道安全性依赖平台审核机制