Metrik

Metrik 是一款桌面常驻工具，统一查看本机各个 AI 编程 Agent 的官方配额余量与 Token 消耗，支持 ChatGPT、Claude、GLM、Kimi 等主流 Agent。

下载最新版：Windows .exe、macOS 通用 .dmg。安装包未签名，首次运行需手动放行系统安全校验；Release 页附 SHA256 校验值。

完整视图截图使用浏览器演示数据，非真实用量。

平台支持

• Windows：320 × 320 桌面小组件，可收缩为横向或纵向配额胶囊条；支持深色 / 浅色 / 透明三档玻璃材质、0.75–2.0 缩放、边缘自动隐藏与置顶常驻。
• macOS：菜单栏面板，点击展开完整统计页面。

支持的 Agent

暂不支持 Gemini CLI；Cursor 待设计独立的凭据授权机制后再评估。

核心功能

1. 配额卡片：各 Agent 剩余额度、进度、重置倒计时与消耗节奏预估。主数值取余量最低的窗口，日常是 5 小时，更长周期的窗口告急时改取该窗口。
2. 配额胶囊条（Windows）：收缩成一根横条或竖条，每格只有图标、品牌色进度条与剩余占比；展示哪些 Agent、按什么排序可配置，卡片与胶囊条各自独立。
3. 统计与报表：26 周热力图、周趋势折线、Agent 占比环形图、项目走势；用量页以项目为主视图（占比环形 + 排名列表），点击项目进入该项目的会话明细，项目总表与会话明细都可导出 CSV。项目按各 Agent 记录的工作目录归集，默认向上合并到 git 仓库根，也可手动登记项目根或隐藏目录；读不到目录的用量单独列出。完整面板分概览、用量、报告、设置四页，主题可跟随系统或手动指定。
4. 多设备同步：指定共享文件夹（坚果云 / OneDrive / Syncthing 均可），各设备导出近 30 天统计事件并自动合并，无云端服务。
5. 系统能力：托盘常驻、可选开机自启、单实例运行。更新检查由设置页手动触发，是本应用唯一主动发起的网络请求；更新包经 minisign 校验，签名不符拒绝安装。

数据口径

1. 官方配额：Agent 官方接口给出的窗口剩余占比与重置时间。
2. 本地 Token：解析本机日志逐事件去重后的处理量，含未缓存输入、缓存读写与输出；推理 token 属输出子项，不重复计入。解析不全时标注「数据不完整」。
3. 估算成本：按公开 API 价目折算的参考值，不等同官方账单。无价目的模型标记「未计价」，取不到的数值显示 --。

隐私

数据库只存时间、Agent、模型、会话标识、项目工作目录与源文件路径，不写入提示词、回复正文、工具输出与凭据。项目目录只留在本机，多设备同步不导出。

同步仅依赖你指定的共享目录，项目不提供云端服务。查询配额时只读取各 Agent 已存于本机且为明文的凭据（环境变量、OpenCode auth.json、zcode v2/config.json 等），设备绑定加密的凭据不解密，也不为此开启本地端口。

Claude 配额的两种读取方式

1. 状态栏钩子（默认）：Claude Code 把配额推送至状态栏脚本，Metrik 从本地文件提取数值，不发网络请求、不使用凭据。已有自定义脚本会自动串联，卸载时恢复原状。限制是仅交互式终端会话会刷新，主要在 IDE 或网页端用 Claude 时配额不更新。
2. 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  # 读本机真实日志的烟测

已知限制

1. 安装包未做数字签名，首次运行需手动放行；Windows 未预装 WebView2 时安装程序需联网获取运行时。
2. 仅提供 Windows 与 macOS 预编译包，Linux 需自行构建。
3. Antigravity 需对应 IDE 处于运行状态才有数据。
4. 首次索引大体量日志会占用一段 CPU 与磁盘，界面可正常操作，未覆盖完整历史的数值会标注说明。

开源协议

AGPL-3.0-or-later，Copyright © 2026 keros68。分发修改版，或基于修改版对外提供网络服务时，需按 AGPL-3.0 开放对应源码。v0.10.0 及更早版本适用 MIT。

致谢

感谢 LINUX DO 社区 提供的交流氛围与开源推广支持。