Javis603/token-monitor

摘要： Token Monitor 是一款桌面小部件，可监控 46 多种 AI 编码工具（如 Claude Code、Codex、Cursor、GitHub Copilot 等）的本地日志和数据库，在一个统一界面中展示实时令牌使用量、缓存命中统计以及特定提供商的账户限制（例如 Codex 会话上限或第三方 API 余额）。

主要功能：

• 实时令牌跟踪和实时“消耗速率”读数（tok/s、tok/min）
• 详细的每个会话细分（每次提示的令牌数、使用的工具）以及每个工具/模型的缓存命中与未命中统计
• 特定提供商的速率限制和计费检测（29 多个提供商）以及多账户支持，包括一键切换活动 Codex 账户
• 使用仪表板，包含年度活动热图、连续记录和每个工具/模型的趋势图表（条形图和 K 线图视图）
• 本地使用情况归档，因此即使工具修剪其自己的记录，数据也能保留
• 多设备同步：设备将使用情况摘要发送到中心（服务器发送事件）或通过 iCloud Drive 同步，实现近乎实时的更新
• 导出为 CSV/JSON，支持 WSL 使用情况检测，以及货币显示选项（USD、TWD、HKD、CNY）

工作原理： 每个设备监控其本地文件系统工件（例如 ~/.claude/projects/、~/.codex/、VS Code globalStorage、SQLite 数据库）以提取令牌计数、会话和模型。对于账户限制，它利用 API 密钥、Cookie 或自定义余额端点（例如 OpenRouter API 密钥、阿里云控制台 Cookie）。它在本地将这些原始数据解析为指标，然后将摘要更新中继到中心。每个会话的详细信息按需从本地记录中读取，永远不会同步。

注意事项：

• 支持自定义扫描路径和环境变量覆盖以定位工具数据（例如 $CODEX_HOME、$XDG_DATA_HOME）
• 单设备使用无需服务器，但为多设备设置提供自托管同步后端
• 支持 Windows 10+、macOS 12+ 和 Linux（x64），并采用 MIT 许可证