Repository navigation
Releases
Releases · SummerXaa-Z/tokenmeter-mac
TokenMeter v3.84.0
TokenMeter v3.84.0 — 验证基建:离屏渲染时间冻结 · CI 渲染确定性闸门
v3.83.0 之后的验证基建集中发布:离屏渲染夹具时间全面冻结,CI 新增渲染确定性闸门——同构建两轮渲染逐字节可比对,任何把活钟带回渲染路径的回归都会被自动拦截。
新增与改进
- 渲染夹具时间冻结:新增渲染钟(真实今天的中午),夹具数据与展示时钟全部对齐同一拍;settings「检查于」、配额重置时刻、总览「数据截至」等分钟级元素不再随渲染时刻漂移
- 展示侧活钟迁移:总览 Codex 剩余判定、Kimi/智谱「上次成功 N 分钟前」、Cursor 周期进度、Dashboard 今日行、设置页来源健康时间戳等,统一消费注入的展示钟(真实 app 行为不变,仍 30 秒一拍)
- CI 渲染确定性闸门:
make ui-render-determinism进入 CI——两轮渲染逐字节比较 + 第三轮仲裁(区分 macOS 字形光栅抖动与真实非确定性);失败产物三跑齐全作为 artifact 上传 - 闸门落地修掉的四个真问题:榜单迷你趋势改确定性 Shape 绘制(Canvas 走 Metal 光栅化跨进程不确定);Codex 配额卡与订阅额度卡的自带 30 秒活钟绕过展示钟,配额新鲜度曾随真实渲染时刻翻转;pace 夹具漏传渲染钟;比对脚本兼容 macOS 自带 bash 3.2
- 测试 746 项;本地闸门 116 张夹具 112 张两跑逐字节一致、其余经三跑共识排除抖动
安装说明
- 本包为 ad-hoc 签名构建(本机未配置 Developer ID 与自签证书),未经 Apple 公证;首次打开如遇 Gatekeeper 拦截,请右键 App 选择「打开」,或到「系统设置 → 隐私与安全性」手动放行。
- 覆盖安装即可,数据与 Keychain 凭据不受影响(应用为纯本地只读监控,凭据只存本机)。
TokenMeter v3.83.0
TokenMeter v3.83.0 — 前端审计三批收口:数据语义 · 中级 · 低级
v3.82.0 之后的前端整体审计全部收口:三批共 22 处修复集中发布,读取失败保留上次成功结果的范围进一步扩大,统计口径与渲染纪律全面对齐。
新增与改进
- 数据语义(7 项):菜单栏「Claude/合计」文本档未知不再当 0——live 优先、当日历史兜底、不可用显「—」,Claude 日用量告警改用实时值不再被跨天旧缓存误报;Codex 官方实时配额、DeepSeek 用量、方舟套餐额度读取失败一律保留上次成功快照(瞬态与永久故障区分,凭据移除仍清空);周环比锚点强制 ISO 周一,不再随系统区域设置漂移;模型榜 CSV 导出做公式中和,防表格软件把模型名重释为公式。
- 中级(6 处):周报通知门控修复——总开关关闭不尝试不留痕、重开当周可补发,周键留痕移到通知实际入队成功后;用量导出自定义区间起止双向约束,不再静默导出空 CSV;总览周日均分母改为滚动窗与本机留存的交集天数,新装机首周不再虚低;热力图周档分位改用全历史周合计,翻页换档颜色不再漂移;Claude 页周环比改 ISO 日历周口径并明示口径脚注;设置页凭据徽章缓存,渲染不再同步读 Keychain。
- 低级(9 处):余额告警在阈值关闭或清 Key 后重新布防(读取失败保留 last-good 不复位);「已复制」提示二连点不再闪灭;环比卡来源名列加宽放得下「GitHub Copilot」全名;趋势悬停说明与 X 轴刻度同口径;Qwen 今日卡配色对齐全局约定、未确认显示「—」不冒充 0;数字缩写补千→百万进位边界;设置页来源探测与订阅解码移出渲染路径;网页登录窗改 app 级共享,设置页重建不再丢登录窗口。
- 测试自 726 项增至 741 项;每批修复均经新旧四轮隔离渲染逐页对照;10 月前端审计旧清单(F01–F12)逐条复核确认全部已被修复。
安装说明
- 本包为 ad-hoc 签名构建(本机未配置 Developer ID 与自签证书),未经 Apple 公证;首次打开如遇 Gatekeeper 拦截,请右键 App 选择「打开」,或到「系统设置 → 隐私与安全性」手动放行。
- 覆盖安装即可,数据与 Keychain 凭据不受影响(应用为纯本地只读监控,凭据只存本机)。
TokenMeter v3.82.0 — 可靠性与口径收敛
TokenMeter v3.82.0 — 可靠性与口径收敛:时间范围贯通 · 未知不冒充零 · 历史写入调度
v3.81.0 之后合入的六轮可靠性整理集中发布:统计口径贯通收敛,读取失败不再丢数据,未知与零不再混淆。
新增与改进
- 时间范围贯通:总览、来源详情与模型详情统一 1D/7D/30D/90D/全部切换;模型空数据状态保留范围切换并引导换范围,独立周比较与平台账期明确标注口径。
- 未知与零严格区分:今日未确认与缺价不再冒充零用量/零费用,模型金额趋势保留缺口,1D 查值注明今日等价合计;订阅窗口过期显示未知、观测时间与刷新提示,不再依据旧比例发低额度告警;总览、来源费用、ROI、周报与 CSV 统一计价覆盖率口径,缺价金额只作下限。
- 更可靠的本机采集:各来源读取失败一律保留上次成功结果,来源换代与账户变化后的旧响应不再写入;跨午夜数据按实际日期归属;Codex fork 累计基线、Claude 跨午夜流式副本、Gemini 空会话去重(仅凭稳定元数据识别,不猜缺失父链)。
- 历史存储升级:历史读写由后台调度器顺序执行,换代期间禁止旧快照导出;90 天回填同时保存两份历史;坏文件不再被覆盖,支持跨月部分提交幂等重试;保存失败保留可信实时结果。
- 设置与图表:设置拆为六个职责分区完整平铺,返回原入口;来源可见性管理与安全重读;图表日期刻度统一抽样,导出/翻页按钮标准化,图例与查值可换行,补齐时间、来源与迷你趋势的辅助功能状态。
- 自动更新加固:增加发布者签名、版本、架构与完整安装包校验,替换失败自动验证并恢复旧应用。
- 测试自 607 项增至 726 项;隔离渲染 116 张明暗截图抽查关键界面。
安装说明
- 本包为 ad-hoc 签名构建(本机未配置 Developer ID 与自签证书),未经 Apple 公证;首次打开如遇 Gatekeeper 拦截,请右键 App 选择「打开」,或到「系统设置 → 隐私与安全性」手动放行。
- 本版发布者签名与 v3.81.0 及更早版本不同,应用内自动更新校验到发布者变化时会引导到本 Release 页手动下载,覆盖安装即可;数据与 Keychain 凭据不受影响(应用为纯本地只读监控,凭据只存本机)。
TokenMeter v3.81.0 — 导出全覆盖收尾三件套
TokenMeter v3.81.0 — 导出全覆盖收尾三件套:分时图 · Cursor 趋势 · 缓存命中
导出能力收尾一轮:至此全库每张主图表都有一键导出 CSV(余下仅为周内节律小柱图、回本走势折线等辅助小图)。
新增与改进
- 24 小时分时图导出 CSV:Claude / Codex / Kimi / Qwen 四个来源页的「今日分时(Token)」卡头新增导出按钮(四页同构卡收拢为共用组件,一处实现全部受益)——逐小时一行(0-23 升序、无用量小时照列 0),合计行 + 口径行;Qwen 的「小时按 Session 结束时间归属」脚注原样带进文件。文件名如
TokenMeter-hours-Qwen-Code-2026-10-03.csv。 - Cursor 历史趋势卡导出 CSV:Cursor 页「近 7|30 天 Token」卡头新增导出按钮——按日合计单系列(Cursor 仅有订阅周期聚合,无逐请求分量,不设分量列),逐日一行附星期几、零天照列 0,合计行 + 口径行。文件名如
TokenMeter-trend-Cursor-7d-2026-10-03.csv。 - DeepSeek 缓存命中图导出 CSV:DeepSeek 页「缓存命中明细」卡头新增导出按钮(摘要右侧,未配置/加载中置灰)——近 7 天滚动窗口含今天逐日一行,命中/未命中/输出三列与图例同口径(V4 Flash + Pro 合并),合计行 + 口径行(命中率 = 命中 ÷(命中 + 未命中),输出不计入分母,窗口合计命中率写进口径行)。文件名如
TokenMeter-deepseek-cache-2026-10-03.csv。 - 三处新导出均带「已导出 <文件名> · 时刻」卡内反馈行;新增 8 个单元测试(合计 464),渲染套件新增 export-final 夹具页并以 HEAD 基线全量回归比对,无未解释差异。
安装说明
- 本包为 Developer ID 缺席时的自签构建,未经过 Apple 公证;首次打开如遇 Gatekeeper 拦截,请右键 App 选择「打开」,或到「系统设置 → 隐私与安全性」手动放行。
- 升级用户直接覆盖安装即可,数据与 Keychain 凭据不受影响(应用为纯本地只读监控,凭据只存本机)。
TokenMeter v3.80.0
TokenMeter v3.80.0 — 图表导出补全三件套:总览趋势 · 来源页趋势 · 环比卡
图表导出补全一轮:至此总览与来源页的主要图表(趋势 / 热力图 / 环比 / 模型榜 / Skills 榜 / 各详情页)都可一键导出 CSV。
新增与改进
- 总览趋势卡导出 CSV:卡头新增导出按钮——当前范围逐桶一行(1D 档今日逐时、7D/30D 档逐日、「全部」随历史长度自动按日/周/月降采样),来源分列、列序与图例一致(点暗隐藏的来源不导,与所见一致);API 等价列与悬停金额同口径、无金额留空,小时档无逐时金额不设该列(今日合计写进口径行)。
- 来源页 7|30 天趋势卡导出 CSV:该卡为七个来源页共用组件,一处加按钮全部受益——逐日一行(附星期几),Token 分量列与图例同名同序(Codex 输出含推理、Gemini/Qwen 推理单列、其余推理并入输出),补零日照列 0,合计行与口径行随文件自带。
- 总览环比卡导出 CSV:「周|近7天|月」卡头新增导出按钮——合计行 + 各来源行(本期/上期/环比),行序与卡片一致;环比带符号百分比,上期为 0(无基期)留空不冒充 0%。
- 三处新导出均带 v3.79 的「已导出 <文件名> · 时刻」卡内反馈行;文件名自带档位与日期(如
TokenMeter-trend-30d-2026-10-03.csv、TokenMeter-trend-Claude-7d-2026-10-03.csv、TokenMeter-compare-week-2026-10-03.csv)。
安装说明
- 本包为 Developer ID 缺席时的自签构建,未经过 Apple 公证;首次打开如遇 Gatekeeper 拦截,请右键 App 选择「打开」,或到「系统设置 → 隐私与安全性」手动放行。
- 升级用户直接覆盖安装即可,数据与 Keychain 凭据不受影响(应用为纯本地只读监控,凭据只存本机)。
TokenMeter v3.79.0
TokenMeter v3.79.0 — 反馈与对照三件套:导出反馈统一 · 周档上周对照 · 周报通知快捷动作
反馈与读数对照一轮:导出完看得见落盘结果、周档悬停补齐上周对照、周报横幅上直接导出。
新增与改进
- 导出反馈统一:全库各导出按钮(热力图、模型榜、Skills 榜、Skill 详情、Coding 模型详情、DeepSeek 模型详情共六处卡)保存面板点完「存储」后,卡内出现一行反馈——「已导出 <文件名> · 14:32」,与设置页推样例反馈同款式样;落到了哪个文件、什么时候,不用去目标文件夹翻找,导出失败仍走系统错误框。反馈行有文案才占位,不导出版面不变。
- 热力图周档悬停附上周对照:与月档上月对照对称——完整周比周合计(如「9/21周 · 42M · 上周 36M(+17%)」);进行中的本周先折日均并注明已过天数,再与上周日均比,避免「周还没过完」误读成骤降。涨跌带正负百分比、不足半个百分点记「持平」;上周早于本机留存起点时不附对照段。
- 周报通知快捷动作:周报通知横幅展开即可点「导出上周 CSV」——不开面板、不弹保存面板,直接把与设置页周报导出同口径的上周明细(含汇总、价格覆盖率与订阅回本行)写入「下载」文件夹,并回执一条结果通知(成功带文件名、失败给手动导出指引)。仅周报挂该动作,配额/告警通知保持系统默认形态;快捷动作就地执行、不抢焦点弹面板。
安装说明
- 本包为 Developer ID 缺席时的自签构建,未经过 Apple 公证;首次打开如遇 Gatekeeper 拦截,请右键 App 选择「打开」,或到「系统设置 → 隐私与安全性」手动放行。
- 升级用户直接覆盖安装即可,数据与 Keychain 凭据不受影响(应用为纯本地只读监控,凭据只存本机)。
TokenMeter v3.78.0 — 隐藏冗余图例 · 空态统一 · 图例悬停附排名占比
TokenMeter v3.78.0 — 图表清理三件套:隐藏冗余图例 · 空态统一 · 图例悬停附排名占比
图表读数清理一轮:去掉重复图例、零数据不再画空图、悬停读数补齐排名与占比。
新增与改进
- 隐藏冗余内置图例:总览趋势图此前在来源图例 chips 之下还叠着一套 Swift Charts 自动图例(全部来源、与 chips 重复)——现在只保留可点选、可悬停读数的自定义 chips,页面少一排重复信息。
- 图表零数据空态统一:零数据的图统一显示占位说明(口径消息 + 一句引导),不再画全零柱或一排暗柱——总览趋势卡、来源页 7|30 天趋势卡与今日分时图三处统一。
- 图例悬停附排名与占比:悬停来源图例时说明行在范围内合计之外再附榜内名次与占比(如「Claude · 范围内合计 · 第 1 名 · 占 50%」),与金额同屏读。
安装说明
- 本包为 Developer ID 缺席时的自签构建,未经过 Apple 公证;首次打开如遇 Gatekeeper 拦截,请右键 App 选择「打开」,或到「系统设置 → 隐私与安全性」手动放行。
- 升级用户直接覆盖安装即可,数据与 Keychain 凭据不受影响(应用为纯本地只读监控,凭据只存本机)。
TokenMeter v3.77.0 — 图例悬停合计 · 推样例反馈 · 月档上月对照 · DeepSeek 模型导出
TokenMeter v3.77.0 — 图例悬停合计 · 推样例反馈 · 月档上月对照 · DeepSeek 模型导出
悬停与反馈四件套:读数更直接、推送可查证、月度可对照、DeepSeek 详情页补齐导出。
新增与改进
- 趋势图图例悬停看合计:总览趋势图的来源图例悬停时,说明行临时切到该来源的「范围内合计」Token 与 API 等价美元——多来源横比不必来回点开图例,被隐藏的来源也照样读数。
- 推样例行内反馈:设置里「推样例」与周报「预览」点击后,按钮下方出现「已推 8 条样例(周报 1 + 告警 7) · 14:32」——条数拆分与通知中心分组同口径,推送有没有生效一眼可查。
- 热力图月档悬停附上月对照:完整月比月合计(如「上月 36M(-17%)」),进行中的当月比日均(完整上月 vs 进行中本月才公平);涨跌带百分比、不足半个百分点记「持平」,上月早于留存起点时不附。
- DeepSeek 模型详情页导出 CSV:V4 Flash / V4 Pro 详情页新增近 7 天逐日 Token 导出(附星期几),口径行自带汇总、Token 构成与费用口径(平台返回人民币,与 API 等价估算区分)。
安装说明
- 本包为 Developer ID 缺席时的自签构建,未经过 Apple 公证;首次打开如遇 Gatekeeper 拦截,请右键 App 选择「打开」,或到「系统设置 → 隐私与安全性」手动放行。
- 升级用户直接覆盖安装即可,数据与 Keychain 凭据不受影响(应用为纯本地只读监控,凭据只存本机)。
TokenMeter v3.76.0
TokenMeter v3.76.0 — 周报样例 · Skills 来源筛选 · 榜单说明行带排序档
通知样例闭环 + 榜单两处小改,一次打包三件。
新增与改进
- 周报样例进「推样例」:设置里的「推样例」由七条变八条——新增周报样例(id 与真实周报同构造、按所述周派生,文案前缀【样例】),一键验证留痕、分组与点击回总览三件事。
- Skills 榜来源徽标可点筛选:点行内来源徽标只看该来源的 Skill 调用(榜单顺序不变),再点同徽标或点头部「来源 ×」胶囊还原;激活徽标加深底色自证状态;筛选中导出 Skills 榜 CSV 与所见一致(口径行注明已筛)。
- 模型榜说明行带排序档名:未悬停的占位说明行末尾附「当前按用量/等价/近7天排序」——切档后悬停数字的排序口径自证,不用回头核对分段控件。
安装说明
- 本包为 Developer ID 缺席时的自签构建,未经过 Apple 公证;首次打开如遇 Gatekeeper 拦截,请右键 App 选择「打开」,或到「系统设置 → 隐私与安全性」手动放行。
- 升级用户直接覆盖安装即可,数据与 Keychain 凭据不受影响(应用为纯本地只读监控,凭据只存本机)。
TokenMeter v3.75.0
TokenMeter v3.75.0 — 通知按类分组 · 模型明细导出 · 单日悬停附周几日均
一次打包三件事:通知中心更清爽、模型明细可带走、热力图悬停更能对照。
新增与改进
- 通知按类分组:系统通知在通知中心按组折叠——周报一组(按周留痕后逐周堆积也收拢)、配额/用量/余额告警一组、节奏预警一组;点击跳转路由不受影响。
- 模型下钻页导出 CSV:模型详情页「API 等价」卡头新增导出按钮——7/30 天档逐日一行(附星期几、无用量日照列 0),90 天档按自然周聚合(与页内趋势同桶);Token 为五类合计原始整数,API 等价无金额留空;末尾附口径行(价格覆盖不足时点名)。文件名
TokenMeter-model-<模型名>-<日期>.csv。 - 单日悬停附同周几日均:热力图日档单格悬停再附「周X日均 N」——如「9/25 · 1.2M · $12.50 · 周五日均 80M」,来自周内节律同一条窗口口径,单日数字与「这一天通常用多少」直接对照。
安装说明
- 本包为 Developer ID 缺席时的自签构建,未经过 Apple 公证;首次打开如遇 Gatekeeper 拦截,请右键 App 选择「打开」,或到「系统设置 → 隐私与安全性」手动放行。
- 升级用户直接覆盖安装即可,数据与 Keychain 凭据不受影响(应用为纯本地只读监控,凭据只存本机)。