Releases: keros68/metrik
Release list
Metrik v0.3.0
本版新增 macOS 安装包与 Antigravity 支持。
新增
- macOS 安装包（
.dmg，Intel + Apple Silicon 通用）。⚠️ macOS 上编译测试通过，但托盘、玻璃材质、边缘挂靠、开机启动等交互行为尚未在真机验收，欢迎反馈。 - Antigravity 支持（新 Agent）：用量来自本机 language server 的实时 RPC，IDE 需正在运行；官方配额一并读取。尚未实机验收（作者本机未安装），装了的用户请核对数字。
- 完整视图现在正常出现在 Windows 任务栏（此前无边框窗口缺 WS_EX_APPWINDOW 样式，一直不显示）。
- 报告页三种图表切换时卡片高度固定，不再忽大忽小。
安装
- Windows：
Metrik_0.3.0_x64-setup.exe（推荐）或.msi。首次运行有 SmartScreen 提示 → 更多信息 → 仍要运行。 - macOS：
Metrik_0.3.0_universal.dmg。未签名，首次打开需在「系统设置 → 隐私与安全性」放行，或右键点应用选「打开」。
已装 0.2.0 的可在设置页一键更新（0.1.0 无更新器，需手动下载本版）。
SHA256
4F874506BE5BD8896BC947ECC2BF2CE646B27F77AAC0F49A1C8D569BC766B46A Metrik_0.3.0_x64-setup.exe
F4FBA973B2773652C62D426E1FF1A8D4FE4CFA18CB87B0F683064D803662E5E6 Metrik_0.3.0_x64_en-US.msi
B4CA7122543B67B75E8FED659DE3A9F0EE803CE127D28BE3B6731885E6FA3491 Metrik_0.3.0_universal.dmg
已知边界
- 仅 Windows 10/11 x64 实机验收。macOS 有产物、CI 通过，但交互行为未真机验收。
- Kimi 与 Antigravity 未实机验收：格式经协议文档/既有工具交叉核实并有测试覆盖，但作者本机未安装。
- 安装包未代码签名。Token 统计来自本地日志，非官方账单。
Metrik v0.2.0
新增
- 应用内更新：设置页手动检查更新，不后台轮询——这是本应用唯一会主动发出的网络请求。更新包经 minisign 签名校验，签名不符直接拒绝安装。
- Kimi 支持（新 Agent）
- 开机启动（可选，默认关闭）
- 小组件位置跨重启记忆；完整视图正常出现在任务栏
- 会话明细的 CSV 导出（此前点击无反应）
- Claude 官方额度新增 OAuth 直连来源（可选，默认关闭，开启前告知条款风险）；statusLine 钩子改为与你已有的状态栏串联而非独占
修复（都是会让数字出错的真 bug）
- Codex 重复计数：fork / subagent 会话日志会先回放父线程的累计 token 计数，这些量在父会话里已经记过账，导致约 596M token 被重复计入（且显示为"未标注模型"）。
- Codex 额度窗口标错：
primary/secondary只是槽位而非窗口语义——某些套餐的primary装的是 7 天周窗，却被一律当作"5 小时窗"显示。现按窗口时长归类。 - 陈旧额度窗口滞留：套餐变更后官方不再返回的窗口，旧数据仍挂在界面上冒充当前额度。
- 报告页与用量页卡在"加载中"（只读查询误开了写事务，被扫描进程阻塞）
- 图表图例无法换行，第 5 个 Agent 被挤出可视区
安装
下载 Metrik_0.2.0_x64-setup.exe（推荐）或 .msi。
安装包没有微软代码签名证书，Windows 会弹 SmartScreen 蓝色提示。这是未签名开源软件的正常表现，不是病毒告警——点「更多信息」→「仍要运行」即可。介意的话可先用下面的校验值核对文件完整性。
SHA256
A97EE416021A367D414F3539342E37EF5AEFE33EB12575C0E14261B6C395E8D3 Metrik_0.2.0_x64-setup.exe
B8941C7677EBB1345335300863D5D2F7025FFF027DA5FF8152512ABA4896BE0A Metrik_0.2.0_x64_en-US.msi
校验：Get-FileHash .\Metrik_0.2.0_x64-setup.exe -Algorithm SHA256
已知边界
- 仅在 Windows 10/11 x64 实机验收。macOS / Linux 共用代码但无产物。
- Kimi 适配未实机验收：格式依据官方 wire 协议文档核实并有测试夹具覆盖，但作者本机未安装 Kimi。装了的用户请核对数字，有偏差欢迎提 issue。
- Token 统计来自本地日志，不是官方账单。
Metrik v0.1.0
Metrik 的首个公开版本。本地优先的 AI Agent 用量统计桌面应用：320×320 桌面小组件 + 完整统计视图。
支持的 Agent
ChatGPT / Codex、Claude、ZCode / 智谱 GLM、OpenCode、Kimi。
主要功能
- 深色 HUD 玻璃小组件，浓度可调；固定后锁位、位置跨重启记忆；屏幕上缘可挂靠
- 官方配额三行元语（窗口 / 进度条 / 已用 + 重置倒计时）+ 消耗节奏预测
- 报告页：26 周热力图、周趋势折线、Agent 构成环形
- 用量页：按天分组的会话明细，支持筛选、CSV 导出、复制会话 ID
- 成本估算（按公开价目，非账单）；无价目的模型如实标为"未计价"
- 多设备同步（共享文件夹）、托盘常驻、可选开机启动
设计原则
官方配额、本地解析 Token、估算成本三类事实分开呈现。读不到就显示"不可用"，不用零值或演示数字顶替。数据库只存统计字段，不存对话内容、Prompt、工具输出或凭据。
安装
下载 Metrik_0.1.0_x64-setup.exe（NSIS，推荐）或 Metrik_0.1.0_x64_en-US.msi。
安装包未数字签名，Windows 会弹出 SmartScreen 蓝色提示。这是未签名开源软件的正常表现，不是病毒告警。点「更多信息」→「仍要运行」即可。介意的话，可以先用下面的校验值确认文件没被篡改。
SHA256
273255E3B407B9C3BEE0A3996F219F94F8F4DFF276A7206EFBC975A2252B9039 Metrik_0.1.0_x64-setup.exe
8B098B1ACB37B442D1971D4667AC6B57DE586563767E031C1AB64FCB8F95E97E Metrik_0.1.0_x64_en-US.msi
PowerShell 校验：Get-FileHash .\Metrik_0.1.0_x64-setup.exe -Algorithm SHA256
已知边界
- 仅在 Windows 10/11 x64 实机验收。macOS / Linux 共用代码但无产物。
- Kimi 适配未实机验收：格式依据官方 wire 协议文档核实并有测试夹具覆盖，但作者本机未安装 Kimi。装了的用户请核对数字，有偏差欢迎提 issue。
- 目标机未装 WebView2 时，安装器需联网获取运行时。
- Token 统计来自本地日志，不是官方账单。