核心用法
token-stats 是一款轻量级跨 Agent Token 消耗监控工具，专为多 AI 助手用户设计。采用纯 Python 标准库实现，零第三方依赖，安装后即可使用。
主要功能
1. 交互式菜单选择 - 每次运行弹出菜单，自主选择要监控的 Agent（Hermes / Claude Code / CodeX / OpenClaw / Reasonix / DeepSeek TUI）
2. 直接指定查看 - 通过 -a <agent> 参数跳过菜单，快速查看特定 Agent
3. 实时监控模式 - --watch 支持持续追踪消耗变化
4. 本地数据源 - 直接读取各 Agent 本地数据文件（SQLite、JSONL 等），无需联网
显著优点
- 零依赖极简设计：仅用 Python 标准库，无 pip 安装烦恼
- 隐私优先：数据完全本地处理，不上传任何信息
- 广泛兼容：覆盖 6 款主流 AI 编程助手
- 灵活集成：可被其他工具（如 Hermes SKILL）调用，实现自动化统计
潜在局限
- 需各 Agent 已产生使用记录，无历史数据则无法统计
- 仅支持预设的 6 种 Agent，小众工具需自行扩展
- 实时监控依赖文件系统轮询，精度受限于 Agent 写入频率
适合人群
- 同时使用多款 AI 编程助手，需统一监控成本
- 对数据隐私敏感，拒绝云端统计方案
- 希望将 Token 消耗集成到自动化工作流的开发者
常规风险
- 工具需读取其他 Agent 的本地数据库，需确保来源可信
- 若 Agent 更新数据格式，可能导致读取失败
- 无内置数据校验，极端情况下可能统计误差
安全与可信评估
| 维度 | 评估 |
|------|------|
| 来源可信 | 开源项目（MIT 许可），GitHub 可审计 |
| 隐私安全 | 纯本地运行，无网络请求，S+ 级隐私保护 |
| 代码风险 | 标准库实现，无供应链攻击面 |
| 数据安全 | 只读操作，不修改 Agent 原始数据 |