TokenMeter — Windows AI Token 用量与订阅额度监控工具

Windows AI 编程订阅额度、Token 用量与余额监控工具
_{Codex · Claude · Cursor · Copilot · Gemini · DeepSeek · MiMo · OpenRouter · Kimi · MiniMax · ElevenLabs · GLM · Antigravity · NayutoAI}

真实组件截图，使用演示数据。查看原图与来源。

TokenMeter 是一款适用于 Windows 10/11 的轻量级 AI 用量与额度监控工具，提供 15 个独立平台入口，按平台能力展示订阅额度、重置时间、API 费用、账户余额和历史趋势。各平台的数据范围及权限要求不同，具体支持范围见下方配置指南。

当前版本：v1.15.0 · 桌宠扩展 v0.1.4 · 产品官网（GitHub Pages）

功能

多平台总览：从顶部“切换视图”进入，同屏查看已配置平台的独立额度、余额与最后成功更新时间；打开后自动逐个采集，页面可见时每分钟更新，遵守失败退避并跳过刚刷新过的平台。离开后停止额外轮询，失效连接可从对应卡片进入账户设置。
独立账户档案：在“设置 → 多账户”为同一平台保存多个连接，“账户连接”页也提供管理入口。支持添加、编辑、删除和独立监控；明确指定凭据或登录路径，秘密字段保存在 Windows 凭据管理器。档案不覆盖默认连接或 CLI 登录，迟到请求按档案版本和实际账号身份校验；额度通知可定位对应档案。
本机统计与导出：从顶部“切换视图”打开后自动读取 Codex（含归档）/ Claude 日志，先显示缓存，再后台更新；页面可见时每分钟增量刷新。支持 Top 排行、每日模型对比、图表/表格切换、自定义日期和项目筛选，并可后台导出 Excel（.xlsx），包含统计汇总、用量明细与口径说明。可显式选择已可访问的 WSL 目录，不启动 WSL。统计仅代表所选本机日志，账户归属未知，不作为订阅额度或实际账单。
品牌识别与快速切换：离线品牌 SVG、纯图标快捷入口和“＋”管理面板，支持中英文名称搜索、已配置筛选和常用收藏。点击星形或按 Ctrl+D 收藏；当前平台始终显示，高亮标识选中状态。Nayuto 暂用通用标识。
平台配置管理：每个已配置平台卡片右下角提供“删除”，清除本应用保存的凭据并停止监控，保留本机 CLI 登录和历史记录。已移除平台可从“全部平台”重新启用，API 凭据需重新填写。
订阅额度：Codex、Claude Code、Cursor、GitHub Copilot、GLM / Z.ai、Kimi Coding、MiniMax Token Plan、Gemini CLI 和 ElevenLabs；支持范围取决于平台接口。“额度明细”展示全部窗口、账户指标和数据来源。
Antigravity CLI：通过官方状态栏快照读取实际返回的模型额度；需配置采集脚本，不执行模型请求。配置指南。
API 用量：DeepSeek / MiMo / NayutoAI 的费用、余额与历史趋势，OpenRouter 的密钥预算和费用，以及 Moonshot / Kimi API 的账户余额；不同币种和不同预算范围分别展示。
悬浮展示：额度水球或余额展示，支持拖动、滚轮缩放、贴边隐藏和系统托盘常驻。
双平台看板：顶部“切换视图”可打开独立置顶小窗口，同时查看两个平台的默认连接。选择会保留，复用总览刷新队列；每个平台优先显示最紧张的额度窗口，其余内容可进入详情查看。
外观与语言：浅色、深色及系统主题，可调整主题色和透明度；支持简中、繁中、英语、日语、韩语。
采集与缓存：默认仅刷新当前平台，可选后台同步；限流或网络故障时自动退避，手动刷新可主动重试。低额度提醒默认关闭，可在“采集与统计”中启用。支持离线缓存、DeepSeek 峰谷提示与 MiMo Cookie 获取及续期。
桌面集成：开机自启、自动更新、数据目录迁移，以及可选的 VPet 桌宠扩展。

“采集与统计”还可启用额度消耗预测、恢复提醒和额度通知静默时段。预测至少需要 10 分钟的有效同周期样本，只显示估计；恢复提醒需先启用低额度提醒，并以实际刷新确认的恢复为准。提醒状态保存在本机，重启后不会重复通知同一低额度状态。

本机统计的图例可点击显示/隐藏模型，右键可只看该模型；悬停使用与今日分时相同的分项提示，滚轮缩放、拖动横移，“重置视图”恢复全部模型和坐标范围。表格悬停和导出保留精确 Token 数。日志目录和导出入口位于统计页右上角“更多操作”。

安装与配置

需要 Windows 10 / 11 和至少一个受支持的平台账户。

从 GitHub Releases 下载 TokenMeter-Setup-vX.Y.Z-x64.exe，安装后启动；校验文件为 SHA256SUMS.txt。
点击悬浮球打开面板，在“设置”中选择平台。Codex / Cursor 可读取本机登录；DeepSeek 填写凭据或可选 API Key，MiMo 可一键获取 Cookie，NayutoAI 使用其平台凭据。
设置自动保存，默认每 60 秒刷新。主题和语言位于“外观”，启动与贴边选项位于“悬浮与启动”。

数据依赖平台接口与登录状态，接口变化或风控可能暂时影响获取。请仅使用自己的账户凭据。

主面板和“设置 → 账户连接”共用品牌卡片选择器，支持名称搜索与已配置/常用筛选。OpenRouter 的密钥预算不代表全账户余额；Kimi API 余额与 Kimi Coding 订阅使用不同的密钥和独立入口；Copilot 需要有权访问额度的登录令牌。Claude Code 默认只读本机 OAuth 登录，也可手动填写 Access Token；显式指定状态栏快照文件仍优先使用快照。平台未提供的明细显示为不可用；本程序不自动续期或改写其他客户端的 OAuth 登录。

平台支持范围与来源 · Kimi / MiniMax / ElevenLabs 配置 · Gemini / Claude 接入指南 · 首批迭代规划

VPet 桌宠（可选）

主安装包不含桌宠。在“设置 → 桌宠”下载扩展，完整安装后再启用；无需另装 .NET。启用后桌宠替代悬浮球，关闭或卸载后恢复球体，不影响账户与面板。

支持轻触互动、拖动缩放、自主活动和贴边额度气泡；双击气泡打开用量面板。
右键菜单可设置额度气泡展示方式，以及默认关闭的喝水、休息提醒；桌宠菜单目前为中文。
主程序 v1.15.0 配合桌宠 v0.1.4，可同步额度气泡与独立额度窗口的明暗底色、文字和低额度提示色；旧版仍可连接。
精简版不含投喂、工作、养成、Steam 或联机功能。扩展可单独更新，主程序退出时桌宠一同退出。

实现细节和独立构建见桌宠开发说明，使用素材前请阅读来源与授权。

数据、隐私与更新

数据默认保存在 安装目录\data，可在设置中迁移。旧版升级采用复制迁移，保留原目录；历史缓存在本地 SQLite。
API Key、Bearer Token 与 Cookie 存入 Windows 凭据管理器，不写入配置或日志；桌宠只接收展示字段，不接收凭据。
更新包通过 SHA256 校验后安装，保留数据与快捷方式。默认卸载也保留 data，请确认不再需要后再手动删除。SHA256 校验不等同于发布签名。

从源码运行

需要 Python 3.11+。源码版与安装版共用单实例限制，请先退出已运行的 TokenMeter。

git clone https://github.com/zensoku142/TokenMeter.git
cd TokenMeter
python -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade "pip>=26.1.2"
python -m pip install -r requirements.txt
python main.py

开发、测试与构建

python -m pip install -r requirements-dev.txt
python -m pytest -q
python -m ruff check .
pyright
python -m pip install -r requirements-build.txt
python scripts/build_release.py

Qt 测试需要可用的 Windows 桌面会话；生成安装器需要 Inno Setup。桌宠构建需要 .NET SDK 8+，详见桌宠开发说明。

项目结构 · 配置示例（无需复制为 config.py）

常见问题

无窗口：检查系统托盘，并确认未重复启动。
凭据失效或请求受限：更新登录 / Cookie，或等待后再刷新。
数据异常：查看当前数据目录的 TokenSpider.log；提交反馈前请移除敏感信息。

版本

主程序 1.15.0，可选桌宠扩展 0.1.4。更新记录与校验文件见 GitHub Releases。

许可与致谢

TokenMeter 自有代码采用 MIT License。

桌宠核心及默认角色、动画来源于 LorisYounger/VPet，感谢上游作者及贡献者。核心采用 Apache-2.0；角色与动画版权归虚拟主播模拟器制作组所有，适用单独授权，不属于本项目的 MIT 授权范围。详见第三方声明。