Token Monitor

对于重度使用 AI 辅助编程的开发者而言，管理多个工具（如 Claude Code、Cursor、Codex 等）的 Token 消耗和账户额度往往是一项繁琐的工作。大多数现有的监控工具仅限于单台设备，无法反映跨设备的整体使用情况。

Token Monitor 正是为了解决这一痛点而生。它是一款桌面小部件应用，能够实时聚合并显示各种 AI 编程工具的 Token 用量、账户上限及历史趋势，并支持多设备数据同步。

核心功能：从实时监控到深度分析

Token Monitor 不仅仅是一个数字显示器，它提供了一套完整的用量管理方案。

1. 广泛的工具支持
它覆盖了目前主流的 AI 编程助手，包括：

• CLI 类：Claude Code, Codex, OpenCode, Hermes Agent, OpenClaw, Kimi CLI, Qwen CLI, Grok Build, GitHub Copilot CLI
• IDE/编辑器集成：Cursor, Antigravity, Cline (VS Code)
• API 余额监控：DeepSeek

2. 多维度数据展示

• 实时追踪：每轮对话后数秒内刷新 UI，显示当前 Token 消耗。
• 用量上限检测：支持监控 Claude Code、Codex、Cursor 等工具的 Session、每周、账单周期或 Credits 窗口，以及 DeepSeek 的预付余额。
• 成本分项：在 Token 数量旁直接附带估算的成本统计。
• 缓存命中统计：展开查看输入 Token 的缓存命中率，帮助优化提示词策略。

3. 历史趋势与仪表板
手动开启后，独立的仪表板窗口可提供：

• GitHub 风格的活跃热力图与连续使用天数。
• 跨所有设备、按工具或模型堆叠的历史柱状图与 K 线图。

隐私优先：只传汇总，不传内容

在数据安全方面，Token Monitor 采取了严格的“本地优先”策略。

• 无原始数据上传：Hub 与代理仅传输汇总字段（如设备 ID、平台、Token 总数、成本总额、分项统计）。
• 绝对隔离：完全不会传输原始 AI 日志、提示词、源代码、对话内容、OAuth 凭据或访问令牌。
• 本地处理：Session 明细（如每条提问的 Token 拆分）仅在用户点击时实时读取本机 transcript 或数据库，绝不同步到云端或其他设备。

多设备同步：三种灵活部署方案

Token Monitor 的核心优势在于其跨设备同步能力，通过 Server-Sent Events (SSE) 实现近乎实时的数据推送。用户可根据需求选择以下三种模式：

方案 A：内置 Hub（最简单）
在一台长期开机的机器上打开小部件，选择“Host hub on this device”。其他设备通过局域网 URL（支持 Tailscale/ZeroTier）连接即可。无需命令行操作。

方案 B：自托管 Node Hub
适合拥有长期运行的无头服务器（如 NAS 或 VPS）的用户。通过 npm run hub 启动后端服务，配置 .env 文件中的 Secret 即可。

方案 C：Cloudflare Worker Hub
适合需要跨公网同步（如包含 iPhone 小部件）的场景。一键部署到 Cloudflare，通过 Worker 作为中转枢纽。

安装与使用

本地模式（单设备）
无需任何配置，直接运行：

npm install
npm start

多设备同步

1. 选择一个 Hub 后端（内置、Node 或 Worker）。
2. 在每台设备上打开小部件，进入 设置 → 多设备同步。
3. 选择 Connect to a hub 并填入 URL 与 Secret。
4. 对于没有运行小部件的设备，可单独运行 npm run agent 作为数据采集代理。

桌面安装包
用户可从 Releases 页面下载 macOS (arm64) 和 Windows (x64) 的安装包。注意发布版本未签名，首次启动需按说明解锁。

高度可定制的交互体验

• 外观控制：支持浅色/深色主题、玻璃透明度、模糊度调整，甚至完全透明窗口。
• 悬浮小窗：可将组件收缩为可拖动的紧凑小窗，支持悬停预览。
• 菜单栏/系统托盘：在 macOS 菜单栏或 Windows 托盘中显示关键指标（如最接近用完的额度百分比）。
• 全局快捷键：录制快捷键快速显示或隐藏窗口。
• Discord Rich Presence：可选将今日 Token 和花费广播到 Discord 个人资料。

Token Monitor 通过轻量级的架构和严格的隐私保护，为多设备工作的开发者提供了一个清晰、实时的 AI 资源视图，帮助用户更好地掌控成本与效率。