TokenBar - 跨平台 AI 用量与余额监控工具

TokenBar 是一个开源的跨平台监控工具，用来集中查看各类 AI 服务的用量限制、账户余额与额度重置时间。据项目自述，它覆盖 52 家服务，包括 Codex、Claude、Cursor、OpenRouter、DeepSeek、z.ai 等，并可在 Windows、macOS、Linux、Android 与 iOS 上运行。它适合同时订阅多个 AI 服务、需要随时知道「哪个额度快用完了」的个人开发者与团队用户，也适合希望把用量快照同步到手机或浏览器查看的人。

维护者与状态

项目由 lwh0630 维护，仓库创建于 2026-10-24，最后一次提交在 2026-11-03。最新正式版本为 v1.2.7，发布于 2026-11-03。截至 2026-11-05，仓库获得 205 个星标。从创建到最新版本不足两周，属于起步阶段的项目，接口与功能仍可能随版本调整。

主要能力

以下能力均据项目 README 自述整理，未做独立验证。

• 额度窗口：展示 5 小时、每周、每月以及按模型划分的额度窗口，包含剩余百分比、重置倒计时、本地重置时间，以及一个「节奏标记」，用来说明当前消耗是快于还是慢于线性节奏，并给出按当前速度到重置时的预计用量。
• 余额与支出：以服务商自己的货币或额度单位显示信用余额、支出与上限。
• 托盘图标与面板（桌面端）：托盘图标的两条进度条跟随最紧张的那个额度窗口；点击可打开面板列出所有账户，并提供右键菜单。
• 用量历史：按时间段（24 小时 / 7 天 / 30 天）显示堆叠柱状图，可按额度窗口或按费用项拆分，并给出各项占比与合计。
• 通知：可自定义阈值的低额度提醒，以及低额度重置时的提醒。
• 界面语言与主题：界面提供简体中文与英文，可在设置中切换，默认跟随系统语言；支持浅色与深色主题，可跟随系统或手动设置。
• 手机小组件：提供原生 Android 桌面小组件；README 称 iOS 的 WidgetKit 源码已包含但尚未验证。
• 更新检查：启动时或按需检查 GitHub 上的新版本，可在应用内下载并安装，也可关闭该功能。
• 可选同步服务器：可自建，把电脑上的用量快照推送到手机或浏览器查看。
• 命令行：tokenbar usage 可在终端打印同样的数据，或以 JSON 输出。

在读取方式上，项目说明有三种：桌面端可复用本机官方客户端已保存的登录信息（只读）；也可粘贴 API key 或 token，适用于桌面、手机与网页；部分服务还支持从浏览器开发者工具复制 Cookie 请求头。README 强调应用从用户设备直接查询各服务商自己的接口，可选的同步服务器只接收用量快照，不接收凭据；应用不会索要密码，也不会代替用户登录。

使用入口

项目源码与发布版本位于 lwh0630/TokenBar。README 提到应用会在启动时检查 GitHub 上的新版本并支持应用内安装，命令行用户可运行 tokenbar usage 获取用量数据。具体的安装包形式与各平台安装步骤，请以仓库中的说明为准。

许可与限制

项目采用 MIT 许可证。

README 中列出的已知限制与适用边界包括：

• 本地登录复用仅在桌面端可用；手机与网页端需要粘贴 API key、token 或 Cookie。
• Cookie 方式依赖的接口并非公开接口，可能随时变更。
• 部分服务对密钥类型有要求，例如 OpenAI 的 30 天支出需要组织管理员密钥，xAI 需要管理密钥加团队 ID，Exa 需要 Team Management 服务密钥。
• GitHub Copilot 的用量来自非公开接口，取决于 token 的访问权限；当 GitHub 只返回已用额度时，应用只显示已用额度，不会推算剩余量或百分比；无限或占位性质的额度不会被显示为 100% 剩余。
• 小米 MiMo 需要粘贴包含特定字段的平台会话 Cookie，不支持推理 API key，也不支持自动导入浏览器 Cookie，会话过期后需更换 Cookie。
• 网页构建不支持自定义图片背景。
• 来自服务商集成的部分文本（设置提示、部分字段名与错误信息）目前仍为中文。

此外，README 中的截图使用虚构的演示数据，不能作为真实用量的参考。