核心用法
token-stats 是一款专注于 AI 助手 token 消耗监控的命令行工具，采用纯 Python 标准库实现，无需额外依赖。用户通过交互式菜单选择目标 Agent（Hermes / Claude Code / CodeX / OpenClaw / Reasonix / DeepSeek TUI），工具直接读取各 Agent 的本地数据文件（SQLite、JSONL 等格式），呈现用量统计。
显著优点
1. 零依赖轻量化：仅依赖 Python 3.11+ 标准库，安装即用，无网络请求
2. 多 Agent 统一视图：支持 6 款主流 CLI AI 工具，打破数据孤岛
3. 灵活交互模式：默认弹窗选 Agent，也支持 -a 参数直指定向输出，适配自动化场景（如 Hermes SKILL 集成）
4. 实时监控能力：--watch 模式可持续追踪消耗变化
5. 数据源透明：明确标注每款 Agent 的数据文件路径，用户可审计
潜在局限
- 覆盖范围有限：仅支持列出的 6 款 Agent，其他工具（如原生 OpenAI API 调用、第三方 GUI 客户端）无法监控
- 本地数据依赖：若 Agent 自身未持久化 token 数据（如某些轻量模式），则无法统计
- 无历史趋势分析：当前版本侧重即时/实时监控，缺乏长期用量可视化或成本预测功能
- MIT 许可证无商业支持：作者 zhy 为个人开发者，无企业级 SLA 保障
适合人群
- 多 Agent 并行使用的开发者，需要统一视角管理用量
- 关注数据隐私、拒绝联网监控工具的用户
- 需要在 CI/CD 或自动化流程中嵌入用量报告的团队
- 希望快速审计本地 AI 工具消耗的极客用户
常规风险
- 数据路径硬编码风险：Agent 升级后若变更数据文件位置，可能导致读取失败
- 敏感数据本地存储：虽然不上传云端，但各 Agent 的本地数据库可能包含对话内容，需确保文件权限安全
- 权限问题：部分 Agent 数据文件可能需特定权限读取，运行时需留意