简体中文 | English | 繁體中文 | 日本語 | 한국어

TokenMeter

下载最新版 · 如果有帮助，请点 Star · 反馈与讨论

Windows AI 编程订阅额度、Token 用量与余额监控工具
_{Codex Subscription Quota, DeepSeek & MiMo Token Usage Monitor.}

TokenMeter 是一款轻量级 Windows 桌面 AI 用量监控工具。它以类似 CodexBar 的方式显示 Codex 订阅额度、剩余比例与重置倒计时，并从本机 Codex 会话记录生成年度 Token 活动和连续使用统计；DeepSeek 与 Xiaomi MiMo 继续展示 Token、费用、余额和历史趋势。

功能

• 首期只支持 Codex、DeepSeek 与 Xiaomi MiMo，平台缓存互不混用。
• 主面板一键切换 Provider；订阅平台展示已用/剩余比例和重置倒计时，API 平台动态展示原生币种金额。
• 悬浮球和系统托盘常驻；Codex 以深浅主题水球显示周额度水位、剩余百分比和重置倒计时，DeepSeek/MiMo 保留金额视图。
• 提供浅色、深色及跟随 Windows 的主题。
• Codex 按接口返回的窗口时长展示当前周额度与重置时间，右侧显示近 7 天 Token 使用量；同时保留年度活动、累计/峰值 Token、最长聊天和连续使用天数。
• DeepSeek 支持峰谷计价提示；MiMo Cookie 可通过专用 Chrome 会话获取和续期。
• 网络异常时保留最近成功数据；历史数据缓存在本地 SQLite。
• API Key、Bearer Token 和 Cookie 保存到 Windows 凭据管理器。
• 支持迁移应用数据目录、自动更新及单实例运行。

界面截图

浅色主题	深色主题

系统要求

• Windows 10 或 Windows 11；源码运行需要 Python 3.11+。
• 至少一个受支持平台账户；Codex 复用本机 CLI 登录，DeepSeek/MiMo 使用原有平台凭据。
• DeepSeek API Key 可选，用于官方余额接口。

Important

订阅额度依赖本机 CLI OAuth 会话或产品额度接口，DeepSeek/MiMo 用量依赖平台控制台接口。平台接口、套餐或风控变化可能暂时影响数据。请仅使用自己的账户凭据并妥善保管。

安装

1. 从 GitHub Releases 下载 TokenMeter-Setup-vX.Y.Z-x64.exe，并按需核对 SHA256SUMS.txt。
2. 双击安装包并选择安装目录；默认目录为 %LOCALAPPDATA%\Programs\TokenMeter。
3. 安装完成后通过桌面或开始菜单中的 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

首次配置

1. 启动程序并点击悬浮球展开面板。
2. 打开“设置”，选择 Codex、DeepSeek 或 Xiaomi MiMo。
3. Codex 默认读取本机 CLI 登录；DeepSeek 填写 API Key/控制台凭据；MiMo 可点击“一键获取 MiMo Cookie”。
4. 保存设置并刷新。默认刷新间隔为 60 秒。

config.example.py 仅展示配置项；无需复制为 config.py。旧版 config.py 会在首次启动时尝试迁移。

本地数据与隐私

新安装默认把数据保存在 安装目录\data。从旧版 TokenSpider 升级时，程序会将 %APPDATA%\TokenSpider 复制到新目录，验证配置和 SQLite 数据库后再原子切换；旧目录不会被移动或删除。迁移失败时继续使用旧目录，不影响启动。

Windows 凭据管理器按 TokenMeter/、TokenSpider/、TokenScope/ 顺序兼容读取，敏感凭据不会写入 config.json 或日志。也可在“设置 → 运行行为 → 应用数据目录”选择新的本地空目录；不支持网络共享路径。

自动更新

更新检查访问 zensoku142/TokenMeter 的 GitHub Releases。发现新版本后，程序只下载 TokenMeter-Setup-vX.Y.Z-x64.exe 和 SHA256SUMS.txt，校验 SHA256 后静默覆盖原安装目录。安装包使用固定 AppId，并保留 data 与现有快捷方式；失败时原版本文件仍可从原快捷方式启动。

SHA256 用于确认下载文件的完整性，不等同于由独立密钥提供的发布签名；后续可在不降低现有校验的前提下增加 Authenticode 或 Ed25519 验证。

卸载

默认卸载只删除程序文件和快捷方式，保留安装目录中的 data。如需清理配置、历史记录或浏览器会话，请在确认不再需要后手动删除该目录。

测试

python -m pytest -q

Qt 测试建议在可用的 Windows 桌面会话中运行。

构建

python -m pip install -r requirements-build.txt
.\.venv\Scripts\pyinstaller.exe --clean --noconfirm TokenMeter.spec
python scripts/build_release.py

发布脚本生成 dist\TokenMeter\ onedir 目录；安装 Inno Setup 后还会生成 dist-installer\TokenMeter-Setup-vX.Y.Z-x64.exe 和对应的 SHA256SUMS.txt。已验证发布环境为 Python 3.12、PyInstaller 6.21、PySide6 6.11；UPX 可选。

项目结构

TokenMeter/
├── api/providers/       # 各 AI 平台的 Provider 适配器
├── data/                # 聚合与 SQLite 历史缓存
├── tests/               # 单元与 Qt 测试
├── ui/                  # PySide6 界面
├── app_identity.py      # 展示品牌与兼容身份
├── config_manager.py    # 配置、凭据与日志
├── main.py              # 应用入口
└── TokenMeter.spec      # PyInstaller 配置

故障排查

• 未配置：在设置中选择平台并填写凭据。
• 凭据失效：重新获取 Cookie；MiMo 会先尝试复用专用浏览器会话。
• 请求频繁或风控：等待后再刷新，不要持续缩短间隔。
• 数据未更新：查看当前数据目录中的 TokenSpider.log；新安装通常位于 安装目录\data。
• 未出现窗口：检查系统托盘；程序只允许一个实例。

版本与 Release

当前版本：1.11.0。更新记录及校验文件见 GitHub Releases。

2.0 的 Provider 能力边界、分批计划和已执行基础见 TokenMeter 2.0 路线图。

License

本项目采用 MIT License，可在保留版权和许可声明的前提下使用、修改和分发。