面向多 AI 平台的桌面用量监测器，在同一个界面查看额度和 Token 消耗。目前支持 Codex 与 Cursor，并采用可扩展的平台切换结构。支持缓存优先切换、按秒设置自动同步，以及可贴边停靠的悬浮卡片/水波球。
从 GitHub Releases 获取最新安装包：
| 平台 | 架构 | 文件 |
|---|---|---|
| Windows | x64 | AI-Usage-Meter-64bit-Setup.exe / 便携 AI-Usage-Meter-64bit.exe |
| Windows | ARM64 | AI-Usage-Meter-ARM64-Setup.exe / 便携 AI-Usage-Meter-ARM64.exe |
| macOS | Apple Silicon | AI-Usage-Meter_arm64.dmg |
| macOS | Intel | AI-Usage-Meter_x64.dmg |
| Linux | amd64 | AI-Usage-Meter_amd64.deb / AI-Usage-Meter_amd64.AppImage |
| Linux | arm64 | AI-Usage-Meter_arm64.deb / AI-Usage-Meter_arm64.AppImage |
- 多平台统计：侧边栏切换当前平台；目前接入 Codex 与 Cursor，后续可扩展更多 AI 平台。任一时刻只显示所选平台的数据。
- 额度 / Token / 会话视角：额度视角展示当前周期用量、重置时间与账户信息；Token 视角展示累计与今日 Token；会话视角展示当前进行中的 Codex / Cursor 会话（每 5 秒刷新，结果写入本机缓存，约每分钟落盘一次）。
- 独立刷新：右上角按钮只刷新额度；Token / 会话视角各自独立刷新。
- 后台定时同步：默认每 60 秒同步，可设置为 5–86,400 秒。额度与 Token 不依赖当前打开的视角，都会按间隔自动刷新。
- 平台切换冷却：切换平台时尝试同时刷新额度与 Token；距离上次自动同步不足设定间隔时，先使用缓存，并在冷却结束后同步，避免每次切换都重复请求。
- 托盘状态：系统托盘图标悬停弹出额度 / Token / 会话摘要；主窗口最小化后隐藏到托盘。
- 悬浮显示：支持紧凑卡片或可拖动、贴边收起的悬浮球；悬浮球水波的速度和幅度可调。
- 八套主题：曜石紫罗兰、翡翠岩青、深海幽蓝、暮色玫瑰、暗夜宝石红、铂银极简、琥珀熔金、冰川暮青；字体、进度、水波等颜色随主题切换。
- 全局设置：可配置可用量/已用量显示、自动同步间隔、主题、代理和悬浮窗样式。
- Codex 平台额度通过本机 Codex App Server 的 JSON-RPC 接口读取；Codex Token 统计读取本机
~/.codex/sessions会话日志。今日用量按本机时区统计。进行中会话同样扫描本机会话 JSONL 的近期增量。 - Cursor 平台额度使用 Cursor 桌面端的本机登录状态读取账户用量；Cursor Token 统计由随应用提供的 Tokscale 组件同步并读取其本机缓存。Token 同步会复用新鲜缓存并遵守 Tokscale 的同步节流。进行中会话读取本机
~/.cursor/projects/*/agent-transcripts的近期日志增量。 - 应用不经过本项目的服务器转发统计请求。Cursor 登录凭据会从 Cursor 本机登录数据库读取，并写入当前用户目录下的 Tokscale 本地凭据文件（
.config/tokscale/cursor-credentials.json），供 Tokscale 使用；请妥善保护该用户目录。 - 应用设置、窗口位置和额度缓存保存在本机数据目录：Windows 为可执行文件旁
data/state.json，macOS 为~/Library/Application Support/AI Usage Meter，Linux 为~/.local/share/ai-usage-meter（或$XDG_DATA_HOME/ai-usage-meter）。Codex 会话日志与 Cursor 用量缓存不会上传到本项目。 - 支持系统代理、关闭代理或自定义
http、https、socks5代理。
- Windows：Windows 10/11 与 WebView2
- macOS：较新的 macOS（Apple Silicon 或 Intel）
- Linux：带 WebKitGTK 4.1 的桌面环境（deb / AppImage）
- Codex Desktop 或 Codex CLI，并已使用 ChatGPT 账号登录（API Key 登录不提供 ChatGPT 订阅额度窗口）
- 如需 Cursor 统计：安装 Cursor Desktop，并在应用中登录 Cursor 账号
应用会自动查找 Codex Desktop、npm 全局安装目录及系统 PATH 中的 Codex。自定义安装位置可通过环境变量 AI_USAGE_METER_CODEX_PATH 指定 Codex 可执行文件。
首次在电脑上配置 Codex 时，可在终端检查登录状态：
codex login
codex login statusnpm install
npm run tauri dev# 当前平台
npm run tauri build
# 指定产物（示例）
npm run tauri -- build --bundles nsis
npm run tauri -- build --bundles app,dmg
npm run tauri -- build --bundles deb,appimage安装包位于 src-tauri/target/release/bundle/。应用同时使用随包提供的 Tokscale 组件读取 Cursor Token 用量。
.github/workflows/desktop-build.yml 会在推送分支、创建 Pull Request 或手动运行时构建：
- Windows x64 / ARM64（NSIS + 独立 EXE）
- macOS x64 / arm64（DMG +
.app压缩包） - Linux amd64 / arm64（deb + AppImage）
普通工作流产物可从对应运行记录的 Artifacts 下载，保留 14 天。推送 v 开头的标签（例如 v1.0.7）时，上述产物会附加到 GitHub Release。