信息卡

一句话定位

一款 Electron 桌面小组件，聚合监控 32+ 款 AI 编码工具的实时 token 用量与订阅额度，谁在烧你的 token、还剩多少额度，一眼看尽。

增速解读：为什么涨这么快

总星 1740、月增 757，增速比约 77%，对工具类项目属于健康的口碑爬坡曲线。增长逻辑很直白：AI 编码工具爆发式增长后，每个开发者的账单焦虑随之而来——Claude Code、Codex、Cursor、Kimi、GLM 等各自为政，用量数据散落在 JSONL 日志和 SQLite 数据库里，没人愿意逐个打开。token-monitor 用"读本地日志"这种零侵入方式把一切聚合到一个小组件，还自带四币种成本换算与多设备同步，正好切中重度订阅用户每周必有的额度检查场景。GitHub 上此前尚无覆盖如此广的同类实现，稀缺性助推了传播。

核心功能拆解

• 实时追踪：UI 数秒内更新，支持会话级明细与缓存命中率统计。
• 额度双查：完整支持 Claude Code、Codex、Cursor、Antigravity、Kimi、GitHub Copilot、ZCode/GLM 等 15+ 工具的用量+余额；Cline、Qwen CLI、Zed 等仅 token 统计；OpenRouter、Volcengine 等经 API 密钥/Cookie 查额度。
• 成本换算：USD/TWD/HKD/CNY 四种货币，汇率每日自动更新。
• 多账号管理：一键切换活跃 Codex 账号而无需重新认证。
• 趋势分析：活动热力图、连续天数、按工具/模型堆叠的柱状与 K 线趋势图。
• 数据治理：已删除会话本地归档（对抗 Claude Code 30 天清理）、CSV/JSON 导出、订阅成本记录。
• 多端同步：基于 SSE 的多设备同步，iOS 小组件经 Worker 中转。
• 形态灵活：菜单栏/系统托盘、浮动气泡、布局编辑器、主题定制、全局快捷键、可选 Discord Rich Presence。

架构与技术栈浅析

Electron 外壳调用 tokscale 二进制解析各工具本地日志（JSONL 转录、SQLite 库等），路径可通过 `$CODEX_HOME`、`$XDG_DATA_HOME` 等环境变量覆盖。同步层为 设备 agent → hub → 各设备组件：hub 可内嵌于桌面组件、独立 Node 进程或 Cloudflare Worker，SSE 推送聚合数据。隐私优先设计——提示词、回复与源码全部留在本机，无遥测。

安装与环境要求

Releases 提供已签名 macOS .dmg（Apple Silicon/Intel）、Windows 10/11 安装包与便携 exe、Linux AppImage。源码构建需 Node.js 22.15+ 且在目标系统上执行（electron-builder 不支持跨平台打包）。Qoder CN 适配需要 PATH 中有 sqlite3 或 Node ≥ 23.4。

快速上手示例

# 默认即本地模式，启动自动追踪本机，零配置
# 多设备同步方案 B：无头 hub
cp .env.example .env   # 设置 TOKEN_MONITOR_SECRET
npm run hub

LAN 直连最简单：在一台常开机器上选择 "Host hub on this device"，其他设备粘贴地址+密钥即可。

进阶使用要点

• 跨网络含 iPhone 场景选 Cloudflare Worker 方案，官方提供一键部署按钮。
• 无界面机器跑 `npm run agent` 只上报数据不渲染 UI。
• 配置优先级：CLI 参数 → 环境变量 → 默认值；GUI 与 headless 两级配置并存。
• WSL 内的 SQLite 类工具建议在 WSL 里运行无头 agent 保证路径可达。

典型应用场景

• 个人开发者月度账单审计与换汇成本估算。
• 团队管理员监控成员订阅余额，提前预警降级。
• 多工具重度用户在一处对比各 CLI 的真实消耗效率。
• 内容创作者展示"今日编码消耗"数据面板。

同类生态位对比

ccusage 等脚本只能离线统计 Claude Code 单一工具；OpenRouter 有自己的 dashboard 但只覆盖中转侧；token-monitor 以横跨 32+ 工具 + 桌面常驻 + 多端同步形成组合壁垒，缺憾是深度绑定各工具日志格式，上游一改就要跟进适配。

资源导航

仓库：https://github.com/Javis603/token-monitor ；下载页 Releases；代码签名由 SignPath.io 提供；作者 @Javis。