keros68/metrik

# Metrik Metrik 是一款桌面常驻工具，统一查看本机各个 AI 编程 Agent 的官方配额余量与 Token 消耗，支持 ChatGPT、Claude、GLM、Kimi 等主流 Agent。 [](https://github.com/keros68/metrik/releases/latest) [](LICENSE) [](https://tauri.app/) [](#已知限制) [下载最新版](https://github.com/keros68/metrik/releases/latest)：Windows `.exe`、macOS 通用 `.dmg`。安装包未签名，首次运行需手动放行系统安全校验；Release 页附 SHA256 校验值。

_{Windows 实机截图，玻璃外观取透明档。}


更多截图（报告 / 用量 / 设置）

  

## 平台支持 - Windows：320 × 320 桌面小组件，可收缩为横向或纵向配额胶囊条；支持深色 / 浅色 / 透明三档玻璃材质、0.75–2.0 缩放、边缘自动隐藏与置顶常驻。 - macOS：菜单栏面板，点击展开完整统计页面。 ## 支持的 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 | 暂不支持 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](LICENSE)，Copyright © 2026 keros68。分发修改版，或基于修改版对外提供网络服务时，需按 AGPL-3.0 开放对应源码。v0.10.0 及更早版本适用 MIT。 ## 致谢 感谢 [LINUX DO 社区](https://linux.do/) 提供的交流氛围与开源推广支持。

标签：AI编程, MITM代理, Tauri, 可视化界面, 小部件, 桌面工具, 通知系统, 额度监控