Metrik
Metrik 是一款桌面常驻工具，统一查看本机各个 AI 编程 Agent 的官方配额余量与 Token 消耗，支持 ChatGPT、Claude、GLM、Kimi、Grok 等主流 Agent。
下载最新版：Windows .exe、macOS 通用 .dmg。安装包未签名，首次运行需手动放行系统安全校验；Release 页附 SHA256 校验值。
Windows 实机截图，玻璃外观取透明档。
macOS 实机截图，原生 WidgetKit 桌面小组件。
完整视图截图使用浏览器演示数据，非真实用量。
更多截图（报告 / 用量 / 设置）
平台支持
- Windows：320 × 320 桌面小组件，可收缩为横向或纵向配额胶囊条；支持深色 / 浅色 / 透明三档玻璃材质、0.75–2.0 缩放、边缘自动隐藏与置顶常驻。
- macOS：菜单栏状态项与面板、原生 WidgetKit 桌面小组件，点击菜单栏项目可展开完整统计页面。
支持的 Agent
| Agent | Token 数据来源 | 官方配额 |
|---|---|---|
| ChatGPT / Codex | ~/.codex/sessions | ✅ 每周 |
| Claude | ~/.claude/projects | ✅ 5 小时、每周（状态栏钩子 / OAuth） |
| GLM / ZCode | ~/.zcode/cli/db/db.sqlite | ✅ 5 小时、每周 |
| Kimi | ~/.kimi-code、~/.kimi | ✅ 5 小时、每周、月度 |
| OpenCode | ~/.local/share/opencode/storage | ❌ |
| Antigravity | IDE 语言服务 RPC | ✅ |
| WorkBuddy / CodeBuddy | ~/.codebuddy/projects、~/.workbuddy/projects | ✅ 官方 Credits |
| Qoder | — | ✅ 官方 Credits |
| Grok Build | ~/.grok/sessions/**/updates.jsonl | ✅ 周 Credits（CLI 日志快照） |
暂不支持 Gemini CLI；Cursor 待设计独立的凭据授权机制后再评估。
核心功能
- 配额卡片：各 Agent 剩余额度、进度、重置倒计时与消耗节奏预估。主数值取余量最低的窗口，日常是 5 小时，更长周期的窗口告急时改取该窗口。
- 配额胶囊条（Windows）：收缩成一根横条或竖条，每格只有图标与剩余占比，固定、横竖切换、还原这些按钮平时收起，点「…」就地展开；展示哪些 Agent、按什么排序可配置，卡片与胶囊条各自独立。
- 统计与报表：26 周热力图、周趋势折线、Agent 占比环形图、项目走势；用量页以项目为主视图（占比环形 + 排名列表），点击项目进入该项目的会话明细，项目总表与会话明细都可导出 CSV。项目按各 Agent 记录的工作目录归集，默认向上合并到 git 仓库根，也可手动登记项目根或隐藏目录；读不到目录的用量单独列出。完整面板分概览、用量、报告、设置四页，主题可跟随系统或手动指定。
- 多设备同步：指定共享文件夹（坚果云 / OneDrive / Syncthing 均可），各设备导出近 30 天统计事件并自动合并，无云端服务。
- 系统能力：托盘常驻、可选开机自启、单实例运行。更新检查由设置页手动触发，是本应用唯一主动发起的网络请求；更新包经 minisign 校验，签名不符拒绝安装。
数据口径
- 官方配额：Agent 官方接口给出的窗口剩余占比与重置时间。
- 本地 Token：解析本机日志逐事件去重后的处理量，含未缓存输入、缓存读写与输出；推理 token 属输出子项，不重复计入。解析不全时标注「数据不完整」。
- 估算成本：按公开 API 价目折算的参考值，不等同官方账单。无价目的模型标记「未计价」，取不到的数值显示
--。
隐私
数据库只存时间、Agent、模型、会话标识、项目工作目录与源文件路径，不写入提示词、回复正文、工具输出与凭据。项目目录只留在本机，多设备同步不导出。
同步仅依赖你指定的共享目录，项目不提供云端服务。查询配额时只读取各 Agent 已存于本机且为明文的凭据（环境变量、OpenCode auth.json、zcode v2/config.json 等），设备绑定加密的凭据不解密，也不为此开启本地端口。
Claude 配额的两种读取方式
- 状态栏钩子（默认）：Claude Code 把配额推送至状态栏脚本，Metrik 从本地文件提取数值，不发网络请求、不使用凭据。已有自定义脚本会自动串联，卸载时恢复原状。限制是仅交互式终端会话会刷新，主要在 IDE 或网页端用 Claude 时配额不更新。
- OAuth 直连（可选，默认关闭）：读取 Claude Code 已保存的登录凭据直查官方接口，可覆盖网页端消耗。风险：Anthropic 2026 年 2 月的消费者条款禁止第三方工具使用订阅 OAuth 凭据，目前封禁案例集中于借订阅做推理的工具，未见只读用量查询被封，但按条款字面本功能同属违规范围，是否开启需自行判断。
开发
依赖 Node.js 22+、Rust 1.88+。
npm install
npm run desktop:dev # 桌面开发模式，读取本机真实日志
npm run dev # 浏览器预览，仅演示数据
npm run desktop:build # 构建安装包
npm run build
cd src-tauri && cargo test && cargo clippy -- -D warnings && cargo fmt --check
cargo test live_snapshot_smoke_test -- --ignored --nocapture # 读本机真实日志的烟测
已知限制
- 安装包未做数字签名，首次运行需手动放行；Windows 未预装 WebView2 时安装程序需联网获取运行时。
- 仅提供 Windows 与 macOS 预编译包，Linux 需自行构建。
- Antigravity 需对应 IDE 处于运行状态才有数据。
- 首次索引大体量日志会占用一段 CPU 与磁盘，界面可正常操作，未覆盖完整历史的数值会标注说明。
开源协议
AGPL-3.0-or-later，Copyright © 2026 keros68。分发修改版，或基于修改版对外提供网络服务时，需按 AGPL-3.0 开放对应源码。v0.10.0 及更早版本适用 MIT。
致谢
感谢 LINUX DO 社区 提供的交流氛围与开源推广支持。