RELEASE NOTES

每一次,让它更好用。

从菜单栏里的一个数字,到看得见的使用趋势。这里记录 macOS 正式版本与 Windows 公测版本的变化。

共 70 个发布版本 · 完整保留原始发布说明

v1.39.3最新 macOS 正式版

v1.39.3 · 重置消息 24 小时窗口与线路区智能收起

v1.39.3 — 重置消息 24 小时窗口与线路区智能收起

macOS 1.39.3(构建 86)。Windows 继续保持独立的 v1.38.6-beta.1 预发布版本。

  • 重置提醒面板只显示最近 24 小时的消息:未读计数、常驻线索和时钟历史都改用同一窗口。更早的消息仍在本机归档 30 天用于修订去重,只是不再出现在界面里。
  • 每条消息新增「消除」按钮:立即从面板移除,同一修订版本不会在下次轮询后重新出现;更新的修订仍会正常提醒。
  • 右键面板的 OpenAI 线路区默认收起:探测到 OpenAI 不可达时自动展开、恢复可达后重新收起。「跟随运行中的应用」只联动连接监控区,手动展开的线路区不再被自动收起。
  • 「输入即恢复」缺少辅助功能权限时,Dim 控制区显示橙色提示与「授权」按钮,一键跳转系统设置的辅助功能页;指针活动无需该权限仍可恢复亮度。

显示器数值、供应商凭据和输入内容都不会上传;活动监听只触发亮度恢复,不保存按键或指针数据。重置提醒仍只读取公开 feed,不发送 Codex 凭据。

双击 PKG 覆盖安装到 Applications。需要 Apple Silicon、macOS 14+。应用使用 ad-hoc 签名,安装包未签名,未经 Apple 公证。

在 GitHub 查看版本与下载附件 ↗

v1.39.2 · Dim 默认输入即恢复

v1.39.2 — Dim 默认输入即恢复

macOS 1.39.2(构建 85)。Windows 继续保持独立的 v1.38.6-beta.1 预发布版本,尚未包含分屏 Dim。

  • 右键面板中的 Dim 选项改名为「输入即恢复」;没有旧选择时默认开启。
  • 内置触控板/键盘与蓝牙鼠标/键盘的移动、点击、滚动和按键都会恢复调暗前保存的亮度,修饰键也包含在内。
  • 键盘检测需要 macOS 辅助功能权限;未授权时,触控板和鼠标活动仍可恢复。
  • 关闭选项后保留现有手动方式:点击恢复按钮,或长按菜单栏图标右键。
  • 升级时继续尊重已经明确保存的开启或关闭选择。

显示器数值、供应商凭据和输入内容都不会上传;活动监听只触发亮度恢复,不保存按键或指针数据。

双击 PKG 覆盖安装到 Applications。需要 Apple Silicon、macOS 14+。应用使用 ad-hoc 签名,安装包未签名,未经 Apple 公证。

在 GitHub 查看版本与下载附件 ↗

v1.39.1 · 黄点圆环提醒与菜单账号脱敏

v1.39.1 · 提醒保留额度圆环与菜单账号脱敏

macOS 1.39.1(构建 84)。Windows 保持独立预发布 v1.38.6-beta.1。

  • Codex 重置消息未读时保留全部额度圆环,C 改为常亮黄点,仅 Codex 单元每 0.75 秒在黄色与正常配色间交替,额度数据继续更新。开启「减少动态效果」时黄色常亮,Dim 标记仍可见。任务波纹暂停,全部已读后恢复;显示选择未包含 Codex 时临时追加其单元。
  • 「设置 → 通用 → 账号显示」新增「菜单账号脱敏」,默认关闭。左右键菜单的账号名和邮箱显示如 a****g@example.com,覆盖悬停、删除确认、外部切换详情;开启时暂停菜单重命名,操作状态使用通用文字。设置页面不在覆盖范围,邮箱域名和部分名称字符仍可见。
  • 脱敏只改变菜单显示,账号身份、切换、采集与同步保留原始数据,手机看板使用独立开关。这两项功能仅适用于 macOS。
  • 显式启动参数 --test-reset-alert 可生成标注「本机测试」的内存提醒,走真实提醒路径,确认或重启后移除,不改写真实公告。
  • 中英文官网演示同步黄点圆环提醒,并更新脱敏说明、平台能力及下载版本。

双击 PKG 覆盖安装到 Applications。需要 Apple Silicon、macOS 14+。应用使用 ad-hoc 签名,安装包未签名,未经 Apple 公证。第三方重置公告不代表个人账号额度已重置;系统通知展示受 macOS 设置影响。

在 GitHub 查看版本与下载附件 ↗

v1.39.0 — Codex 重置收件箱与清晰的 Dim 状态

v1.39.0 — Codex 重置收件箱与清晰的 Dim 状态

适用于 macOS 14+、Apple Silicon。Windows 维持独立预发布 v1.38.6-beta.1,本次 Mac 功能不会自动进入 Windows ZIP。

公开重置消息持续提醒

  • 左键菜单接入 codex-reset.com 和 codex-resets.com 的公开消息,区分线索、预告、已报告重置及 Banked 信息,保留来源和原文链接。第三方公告不能证明你的账号已经重置。
  • 未读时菜单栏显示橙色铃铛,每 0.75 秒切换明暗;系统开启「减少动态效果」时常亮。新消息尝试系统通知,仍未读时每五分钟再次提醒,直到明确确认。
  • 打开原文、关闭通知不会自动已读。菜单内逐条或全部确认后保持面板打开;原文按钮先关闭面板再打开浏览器。旧通知的确认只作用于它携带的消息版本,不会清除新消息。
  • 历史按钮始终可用,展示最近 30 天记录;更旧的未读继续保留。最新一条明确预告、已报告重置或 Banked 消息在已读后仍常驻,不重新提醒。重启保留已读和未读状态。
  • 独立轮询三个 feed,单站失败不清空未读;状态/内容升级会重新提醒。系统通知受权限和专注模式影响,菜单栏提示不依赖通知权限。正式版本不包含测试提醒入口。

远程连入也能看见 Dim 开着

「暂时离开」调暗开启时,菜单栏追加常亮的屏幕+月亮标记。额度图标、任务动画和重置铃铛显示期间都保留 Dim 状态;恢复屏幕后标记消失。标记不使用额度进度环,避免将开关状态误读为百分比。

菜单和官网同步

菜单材质圆角、尺寸变化与阴影保持一致,内容更新复用同一面板。官网和双语文档补齐近期亮度、账号来源、凭据镜像与 Windows 能力差异;Windows 介绍新增安装/更新、Codex CLI 回退、Watch、任务保护、手机看板和明确限制。官网更新日志标记独立 Windows 公测版,Mac 稳定版与 Windows 版本分别维护。

仓库发布规则新增推送前官网影响评估、双语内容与版本门禁,以及部署后的生产核验。测试、打包、校验和及实际发布结果见本版本发布清单。

安装包沿用现有 ad-hoc 应用签名;未使用 Developer ID 安装包签名或 Apple 公证。

在 GitHub 查看版本与下载附件 ↗
v1.38.6-beta.1Windows 公测版

v1.38.6-beta.1 — Windows 托盘可见性、设置排版与 Codex 关注

v1.38.6-beta.1 — Windows 托盘可见性、设置排版与 Codex 关注

适用于 64 位 Windows 10+ 的独立预发布版。已合入 macOS v1.38.5 源码,macOS 稳定版保持 v1.38.5。

  • 托盘两种模式增加深色底和浅色边框;详细模式分两行显示服务商和额度,完整信息保留在悬停提示中。
  • 设置页按内容自动计算行高,长标签支持换行;设置、路由和连接页明确使用 96 DPI 布局基准;控制中心重新读取主显示器 DPI。尚未完成所有缩放比例和多屏组合的目视验收。
  • 「Settings → Providers」新增 Codex 分享与关注操作:选择本机分享账号、添加/移除关注、校验邮箱和拦截重复、手动刷新、查看状态、全部额度窗口、云端发布时间和被查看次数。
  • Watch 修改即时保存并请求同步,不再只等待十分钟轮询;Cancel 不撤销 Watch 修改。旧版分享与关注邮箱配置会保留。
  • 分享默认关闭。知道已分享邮箱的其他用户可以读取其额度;服务商凭据不会上传。账号池中尚未获取额度的账号需要先登录并刷新。

下载 AIQuotaBar-win-x64.zip,解压运行 AIQuotaBar/AIQuotaBar.exe。内含 .NET 8,无需额外安装运行时;目前没有安装器或代码签名。覆盖程序前先退出旧进程,保留 %APPDATA%\AIQuotaBar 中的设置和凭据保险库。

验证:Windows 全套 543 项、官网 124 项测试通过,官网语法检查通过;macOS 测试未在 Windows 重跑。本次未移植服务商多账号登录管理、数据源选择和 macOS 凭据镜像。

本版本标记为预发布,不替换 macOS 稳定版 releases/latest。官网正式版更新日志按现有规则不收录预发布,Windows 下载卡片直接链接到本版本。

在 GitHub 查看版本与下载附件 ↗

v1.38.5 — 凭据守护与后台性能优化

macOS 功能版,build 81。

  • 本机见过的每一个 Codex 账号,都会在 ~/.codex 之外留一份凭据副本: ~/Library/Application Support/com.techfanseric.aiquotabar/codex-auth-mirror/<账号指纹>.json, 目录 0700、文件 0600、原子写。目录在首次写入时才创建。
  • 镜像跟随 ~/.codex/auth.json 和账号池里的每个备份,只跟随、绝不参与切换—— 切换仍然只在 auth.json 与账号池之间做原子改名,镜像永远不会被读走或移动。
  • app 常驻监听 ~/.codex 目录与 auth.json 文件本身,任一被改写就同步; 另有一条 10 秒的后台兜底轮询。外部工具(magpie 这类网关)换走登录态的那一刻, 那个账号的凭据已经留在镜像里了。
  • 登录态被外部工具改写时,账号分区会直接显示「登录态被外部改写」以及被换走、 换上的账号;本应用自己发起的切换不会算成外部改动。
  • 顺带修掉一个一直空转的隐患:URL.resourceValues(forKeys:) 在同一个 URL 实例上 会缓存资源值,实测连续三次写同一个文件、三次读到的 modificationDate 完全一样。 原来的撕裂读防护(读前读后比对 mtime 与大小)建在这上面,前后比的是同一个缓存值, 比对恒为真,防护从来没有生效过。现改用新鲜 stat,防护与版本号才真正成立。
  • 既有的账号切换、面板渲染与云同步行为不变;watch 账号与团队云同步走独立通道,不受影响。

详见凭据守护镜像。

减少后台重复工作

  • Kimi、MiniMax 改为文件事件与增量历史检查,保留漏事件恢复及周期核对。
  • Codex 复用未变化的脱敏任务元数据;菜单栏跳过无变化状态和关闭菜单的布局;显示器发现改为配置事件驱动。
  • 保持配额刷新、任务检测周期及动画播放节奏。
  • 单机活动任务测试中,五分钟平均 CPU 为 12.12%,此前一分钟基线为 21.76%。这不是空闲基准或性能保证:后续不同负载窗口测得 17.65%。尚未证明空闲低于 1%,原生菜单栏动画重绘仍是热点。
  • GPU 动画实验未随版本发布,其菜单栏副本播放和外观等价性尚未验证。

内存、方法及限制见性能复核。

在 GitHub 查看版本与下载附件 ↗

v1.38.4 — 提高低额度预警的辨识度

v1.38.4 — 提高低额度预警的辨识度

macOS 修复版,build 80。

  • 低额度预警由偏暗的黄色调整为饱和橙色:浅色外观使用深橙色,深色外观使用明亮橙色。
  • 预警不再只显示在剩余额度那一小段弧线上:顶部供应商字母、中心有效图形也使用预警色,让接近 0% 时仍能辨识预警。
  • 故障与离线状态的供应商字母同步使用红色,正常状态继续使用系统模板着色;额度和节奏的几何含义保持不变。
  • 77 项相关测试通过,覆盖浅色/深色外观、0%/1%/5%/20% 低额度可见性、故障优先级、警示解除后的模板恢复,以及两种任务动画。
在 GitHub 查看版本与下载附件 ↗

v1.38.3 — 菜单栏图标跟随系统着色

v1.38.3 — 菜单栏图标跟随系统着色

macOS 修复版,build 79。

  • 正常、加载、待配置与中性占位图标改用系统模板着色,跟随菜单栏前景色,修复深色背景下圆环仍保持深色的问题。
  • 低额度、故障、离线和自检继续保留黄色、红色警示。多个供应商合并显示时,只要存在警示就保留彩色图像;警示解除后恢复系统模板着色。
  • 两种任务动画布局使用透明缺口绘制剩余额度段上的光带,避免模板着色后动画与圆环融在一起。
  • 76 项相关测试通过,覆盖浅色/深色外观、警示颜色与恢复、两种任务动画、占位图标和周趋势。
在 GitHub 查看版本与下载附件 ↗

v1.38.2 — 修复亮度控制卡住,缩短快捷键响应

v1.38.2 — 修复亮度控制卡住,缩短快捷键响应

macOS 修复版,build 78。

  • 修复外接屏关机、切换输入源等情况下,后台显示器服务创建卡住并占用亮度控制队列的问题。服务发现移到控制队列之外,复用有效连接,并限制服务创建的等待时间。
  • 后台扫描不再被误显示为仍处于 Dim;Dim 保持任务执行期间,手动恢复按钮仍可操作。
  • 连续亮度键调节复用短期亮度读数,硬件亮度不变时只更新 Gamma,减少重复枚举、无效写入及逐次读回确认,改善按键响应。
  • 修复反复扫描显示器时遗漏释放 IORegistry 根句柄的问题,减少长时间运行后的资源累积。
  • 77 项相关测试通过,包含服务超时隔离、连接复用、连续调节的读写次数,以及保持任务执行中的手动恢复。修复版已在本机安装,用户确认重新授权后亮度键正常。

若更新后亮度键只控制内置屏,请在「系统设置 → 隐私与安全性 → 辅助功能」中,将 AI Quota Bar 关闭后重新开启,让更新后的应用重新接管亮度键。

在 GitHub 查看版本与下载附件 ↗
v1.38.2-beta.1Windows 公测版

v1.38.2-beta.1 — Windows 面板倒计时不再出现负数

v1.38.2-beta.1 — Windows 面板倒计时不再出现负数

Windows prerelease,build 77,基于 v1.38.1 的代码,只含 Windows 侧修复。

  • 修复托盘面板头部的负数倒计时:刷新因抓取缓慢或失败而逾期时,头部会显示「下次约 -17 分钟后」这样的负数;现在逾期时改显示「即将刷新」,未逾期时仍显示「下次约 N 分钟后」。
  • 发布制品修正:上一版的 AIQuotaBar-win-x64.zip 实际是改了扩展名的 tar 流,Windows 10 资源管理器无法解压;本版起是真正的 zip(目录布局不变,顶层 AIQuotaBar/ 文件夹,解压运行 AIQuotaBar.exe)。

验证

  • Windows 10 19045 本机 529 项测试全部通过。
  • 在 200% 缩放的显示器上实测托盘面板:布局无缩放错乱——标题行、图表坐标轴、用量条与底部链接行对齐正常,窗口宽 360 DIP、贴右侧悬在任务栏上方。

其余功能与 v1.38.1 相同;macOS 稳定版不受影响,releases/latest 继续指向 v1.38.1,本 prerelease 不进入更新日志订阅源。

在 GitHub 查看版本与下载附件 ↗

v1.38.1 — 修复 Dim 后外接屏无法调亮

v1.38.1 — 修复 Dim 后外接屏无法调亮

macOS 修复版,build 76。

  • 修复外接屏的硬件亮度已经升高、画面却仍停留在 Dim 压暗状态的问题。调暗后的 15% 色表不再被当作正常亮度基准,也不会形成调亮上限。
  • 兼容修复 v1.38.0 保存的错误色表基准,保留各颜色通道的相对关系与曲线形状。
  • 修复 Dim 尚在读取或写入亮度时按亮度键的竞态:等待 Dim 完成后,先恢复原亮度,再执行键盘调节。
  • 72 项相关测试通过,包含错误基准的恢复、连续调亮及 Dim 进行中按键的回归测试。两个外接屏的本地 Gamma 输出已验证可恢复到 100%。

亮度键仍控制指针所在屏幕,Dim 目标和智能还原偏好保持不变。若更新后亮度键未生效,请在「系统设置 → 隐私与安全性 → 辅助功能」中关闭后重新开启 AI Quota Bar 的授权。

在 GitHub 查看版本与下载附件 ↗

v1.38.0 — 亮度键跟随指针,Dim 支持分屏设置

v1.38.0 — 亮度键跟随指针,Dim 支持分屏设置

macOS 稳定版,build 75。本次发布包含 2026-10-19 的屏幕亮度相关更新。Windows 仍使用独立的 v1.38.0-beta.1 测试版。

亮度键控制指针所在屏幕

  • 键盘的屏幕亮度键只调节鼠标指针所在的显示器,支持长按连续调节。
  • 内置屏使用系统亮度;支持 DDC/CI 的外接屏优先调节硬件亮度,降到硬件最低后用 Gamma 继续压暗。组合范围与 MonitorControl 默认方式一致,最低保留 15% 色表输出。
  • Option + Shift + 亮度键可精细调节。普通亮度键不会改写保存的 Dim 目标。
  • 在 Dim 或设置预览期间按亮度键,先恢复原亮度,再调节所选屏幕,避免两种控制相互覆盖。
  • 「设置 → 通用」新增亮度键开关与辅助功能授权入口。使用此功能时请退出 MonitorControl,避免两个应用同时处理亮度键和 Gamma。

Dim 按屏幕设置与即时预览

  • 每块屏幕可独立保存目标亮度,并显示当前硬件亮度读数。
  • 拖动滑块即时预览所选屏幕;松开后移动鼠标或按任意键恢复,离开设置页也会恢复。不再等待固定的预览倒计时。
  • Dim 按钮旁的「智能还原」默认关闭:未勾选时,再次点击按钮或长按菜单栏图标右键才恢复;勾选后支持输入活动自动恢复。
  • 不创建软件遮罩,不修改显示器的对比度或 RGB 增益。恢复时使用调暗前保存的硬件亮度与原色表,并支持异常退出后的恢复。

UU 远程连接时保持本地亮度

  • 修复 UU 连入或退出时 Gamma 被重置、按钮仍显示“恢复”但本地屏幕变亮的问题。Dim 期间会检查并补回被重置的 Gamma,显示器重新连接后按稳定标识重新匹配。
  • 普通亮度键使用的 Gamma 调暗同样支持重置后的保持;从这种亮度进入 Dim 时按原始色表计算,避免重复压暗。
  • 本机短测确认:补回本地 Gamma 时,UU 远程画面保持正常。未修改 UU 配置。

验证

68 项相关 Debug 测试通过;内置屏及两块外接屏分别做过小幅调节与恢复验证。发布配置的测试编译受已有菜单栏测试调用 Debug 专用方法的问题影响;发布版应用构建正常。

在 GitHub 查看版本与下载附件 ↗
v1.38.0-beta.1Windows 公测版

v1.38.0-beta.1 — Windows 版公开测试与 Codex 链路修复

v1.38.0-beta.1 — Windows 版公开测试与 Codex 链路修复

Windows build 74,公开测试(prerelease)。这一版做两件事:Windows 版第一次开放下载——macOS 菜单栏应用用 C# / .NET 8 按原版功能规格逐模块重写为原生托盘应用;同时把 Codex 抓取链路在 Windows 上补齐到 macOS 的行为——遵循系统代理、读取 ~/.codex/config.toml 的 chatgpt_base_url 覆盖、token 到期前主动刷新。Mac 稳定版仍是 v1.37.0,不受本版影响。

Windows 版,第一次公开测试

左键托盘图标弹出配额面板(环形仪表、模型行、用量条沿用 Mac 版设计语言),右键是原生命令菜单。功能按 docs/win-migration/analysis/ 的规格逐项迁移:

  • Codex:读取 ~/.codex 的 OAuth / PAT 登录与多账号池,5h / Weekly 双窗口配额;未登录时自动隐藏
  • GLM:API key 是唯一必填项,cURL 导入为可选高级功能;MiniMax:在设置里填入 token 即接入
  • Kimi:桌面 / 网页会话与 CLI /status 解析
  • Clash / Mihomo:本地控制器自动发现、分组切换、延迟测试、连接概览与自动恢复
  • 任务防睡眠:任务运行时 PowerCreateRequest 防止休眠,带电量安全网
  • 移动看板:18765 端口只读 HTTP + SSE,复用原 PWA 资源
  • 团队:Cloudflare Worker 的建队 / 加入 / 用量上报 / 配额上传

凭据用 DPAPI(CurrentUser)加密存储在 vault.bin;支持开机静默自启、单实例保护、亮 / 暗 / 跟随系统主题、中英双语与文件日志。本机验证(Windows 10 19045):529 项单元 / 集成测试全部通过,Clash 集成测试真实执行,看板与任务→防睡眠链路真机走通。

Codex 抓取链路,对齐 macOS

三个修复,都是「Windows 版照搬了字面实现,却丢了 macOS 侧一直依赖的行为」:

  • 遵循系统代理。 Codex 配额请求与 Clash 探测现在走系统代理——需要代理才能出去的网络,不再被 .NET 默认行为绕开直连
  • 支持 chatgpt_base_url 覆盖。 ~/.codex/config.toml 顶层的 chatgpt_base_url(首个 [section] 之前)会被读取并作为 API 基址,与 macOS fetcher 同一条规则;自建网关用户不必再改配置
  • token 到期前主动刷新。 access token 的 exp 在 5 分钟以内时先刷新再请求,不等 401 才补救;401 后刷新并重试一次的旧逻辑保留。token 不带 exp claim 时按 8 天年龄兜底刷新

flyout 空态:报真错,不再误报「未配置」

已配置的供应商抓取失败时,面板现在显示「获取失败: <原因>」,对齐 macOS 菜单的 <Provider>: error 警示行;「未登录 / 未配置」的引导文案只在真正缺少凭据时出现。此前一次网络故障会被误读成「你还没登录」,排查方向从一开始就偏了。

已知边界(beta)

  • Windows 制品是自包含 zip,解压即用;暂无安装器
  • 自动更新通道(/v1/app-update)仍指向 macOS 制品,Windows 侧目前只做版本检查与提醒
  • macOS 稳定版仍是 v1.37.0,不受本版影响;releases/latest 继续指向 v1.37.0
在 GitHub 查看版本与下载附件 ↗

v1.37.0 — 关注的数据不再被丢掉,气泡也终于收得走

v1.37.0 — 关注的数据不再被丢掉,气泡也终于收得走

macOS build 73。这一版修的是同一类毛病:一个值该显示哪一个,不该由「谁先占了那个位置」决定。 上一版让本机和云端按「取较新」合了起来,这次把关注通道拉进同一套规则;顺带修掉了悬停提示在菜单里撤不掉的老毛病。

关注的那一行,不再因为位置被占而消失

你把一个邮箱加进「关注的账号」,是因为想看它。而同一时刻它很可能还有另一份数据:这台 Mac 本身就登录着它(~/.codex/accounts/<邮箱>.json),或者团队里另一台设备正在上报它。于是同一个窗口上会同时存在云端行和关注行。

原来的去重按 key 走,key 被占住的那一方直接丢掉——丢的恰好是关注那一路。实测一个真实账号:关注通道 7 秒前刚拉回来的数据被扔掉,换上一行可能两天前的云端值,眼睛图标也跟着消失,于是这行读起来变成「这是云端数据,不是你关注的」。

现在两份合成一行:采样更晚的那次胜出,和本机 vs 云端是同一条规则。两侧的来源都留着,所以既被关注、又在云端有数据的账号会同时画出云朵和眼睛,而不是二选一。

胜出那一行自己的来源标记不改写。"Cloud" 还管着跨天快照的日期显示和云端的可见周期上限,合成两行不该顺手把这些规则关掉。

悬停提示:自己接管,不借系统的

账号头、供应商标题、cycle 芯片原本都用 .help() 说明自己。在 NSMenu 里这件事从来没真正成立过:菜单的模态事件跟踪会吃掉菜单项内部的鼠标移入与移出,挂在里面的跟踪区域收不到「离开」,AppKit 于是认为指针还停在那儿,提示窗口就赖在屏幕上不撤——指针早就移开了,气泡还在。

所以悬停这条链路现在自己做。每个锚点把 id 和自己在菜单坐标系里的位置一起上报,菜单根层统一画气泡。只报 id 会把气泡钉在行里(会被 ScrollView 裁掉),只报位置就得再串一条回调链把悬停事件层层捅回根层。

  • 350 毫秒后才出现。 账号行和 cycle 芯片是紧挨着的列表,鼠标横扫过去没有延迟就是一串空泡闪个不停
  • 下方放不下就翻到上面,宁可换边也不要半个气泡被面板窗口裁掉——残缺的样子看起来同样像「卡住没消失」
  • 气泡本体不接鼠标事件,否则它会把自己脚下的悬停抢走,变成「鼠标还停在那儿,气泡却不见了」
  • 菜单关闭时清掉悬停状态,否则下次点开菜单会凭空冒出一个气泡

「多久之前」会换挡

一个两天前停止上报的关注账号,读作「888 分钟前更新」。这个数字算得对,但没法用:是 15 小时还是 3 天?两种情况该做的动作不一样,而读者得先在心里做一次除法。

现在按尺度换挡:一分钟内说「刚刚」;一小时内说分钟;一天内说小时;超过一天直接给日期和时刻。到了那个量级,「多久」已经不重要,「是哪一刻」才重要。

最后一档用显式格式串并把语言钉死,不跟系统语言跑——否则中文界面上会冒出 10/5/26, 2:32 PM 这种半中半英的串,长度还随地区变化。这里显示的是界面的语言,不是系统的语言。

已知边界

  • 合成要求两边都有采样时间;缺一边时保留原来那一行。「没法比」不等于「关注那一路更新」
  • 气泡宽度上限 248pt,长正文会换行;高度按行数估算,只用来决定翻不翻面,不追求精确
  • 悬停延迟固定 350ms,不跟随系统的辅助功能设置
  • 关注通道与团队云端是两条独立通道,账号同时在两边时仍然只画一行——但两枚图标都在
在 GitHub 查看版本与下载附件 ↗

v1.36.0 — 最新的那次采样,来源写在图标里

v1.36.0 — 最新的那次采样,来源写在图标里

macOS build 72。这一版的核心是一句话:同一个账号有两份数据时,显示采样更晚的那次,并且说清楚它从哪来。

本地和云端都有数据时,显示更新的那次

账号行以前只要本地有值就显示本地的,不管团队云端刚上传的是哪一次。于是会出现这种情况:有人刚在另一台 Mac 上刷新过,你这边看到的还是本机缓存的那个数——"明明有人刚用过"这件事,从界面上完全看不出来。

现在同一个账号、同一个窗口,两边都有数据时,采样时间晚的那次胜出。这正是采样时刻一直被记下来的意义;在此之前没有它,这个比较根本做不出来,"永远用本地"是唯一答案。

有一边缺时间时仍然本地优先(对方用的旧版本,或接口不返回时间戳)。"没法比"不等于"云端更新"——把一个可能是几天前的云端数字当作当前值显示,比永远用本地更难解释。

Kimi / GLM / MiniMax 也带上了采样时间

这三家原本都写 sampledAt: nil。和上一版修掉的那个"时间显示成未来"是同一个疏漏,只是落在当时还没人盯的区块上。

它们的接口都不返回服务端时间戳,所以用响应解析的那一刻作为采样时间:每次响应取一次,行和它所属的 UsageData 共用同一个值,两边不会差出几毫秒。没有这一步,"取更新的那次"就只是 Codex 的功能,其他三家看起来会像坏了。

来源不再是新词,图标本来就在说

账号行原本是 [图标] 标签 · 时间 · 百分比,标签可能是 本机 / 云端 / 最新 / 混合。这一版撤掉了后两个——

它们只为了让来源可见,而每一个词都要读者先查一次才知道是什么意思。"混合"更糟:这个 app 里别处从没教过读者"混合"是什么,它没有任何可以依托的直觉。

图标本来就带着同样的信息:没有图标 = 这台 Mac 自己的账号,云朵 = 团队云端,眼睛 = 按邮箱关注的账号。所以行里只留图标和数字,解释搬进 tooltip——那里可以说一整句话:这个数来自哪、什么时候量的,以及两边都有数据时说明显示的是较新的那次(不写出来,用户会对着一个"和本机不一样"的数字以为出了 bug)。

本机账号仍然显示来源名(OAuth / Codex CLI)。那个不是生造词,是这台 Mac 实际在跑的凭据,去掉它是丢信息,不是去噪音。

不用展开就能看到剩余额度

账号头现在显示所选窗口的剩余百分比,读那个数不再需要先展开账号。

选哪个窗口按账号记:一个账号想看 5h、另一个想看 Weekly 是常态,一个全局值意味着来回切。只有一个窗口时不出现切换器——一个选项的按钮按下去什么也不会发生,而最常见的情况(只有 Weekly)头部本来就显示这个数;有两个窗口时,头部下方出现一个紧凑的切换器。

还没选过的时候回落到当前正在跑的窗口,这样跨过重置点后它会自己修正,而不是指着一个刚关上的窗口。

这个选择不驱动菜单栏环。那是两个不同的意图:环是常驻的显示偏好,这里是"这一行我现在想看什么"。

供应商标题不再用计数占位

原来 Codex 显示 2/5(还有几个账号是新鲜的),其他家显示 2/2(还有几个模型有额度)。两个不同的含义挤在同一个位置,而且都不是每天会问的问题——它们是排查用的。

现在显示这一节最后一次刷新的时间,加上当前账号的剩余额度。用当前账号而不是合计,是因为菜单栏环显示的就是当前账号那个数:同一个 app 在两个地方给出不同答案,比少显示一个数字更糟。没有本地 Codex 账号时就不显示那个百分比,而不是随便挑一个——随便挑会读起来像是有意选的。整节都是陈旧数据时照样显示时间:最新的时间本身就是旧的,而每一行都带着自己的时间。

超额时,悬停画一条水平参考线

图表里原本有一条"按这个速度匀速消耗,你现在应该在这儿"的虚线对角线,但超额量要沿着斜线去目测。现在从悬停点向右边缘画一条水平线,它和对角线的交点就是这个窗口已经被提前用掉了多少。

只在超额时出现。进度正常时同一条线会让人以为出了问题——而 onTrack 带非零差值仍然是正常状态,所以判断依据是阶段本身,不是差值符号(代码里 UsagePace.deltaPercent 是实际减预期、currentIntervalPaceDeltaPercent 是预期减实际,两处符号约定相反)。线用图表的强调色而不是固定的绿色,这样它留在"预测"这一族里,不会读成数据;曲线本身转橙或转红时它也跟着保持一致。

顺带修正

  • 团队成员名常常是邮箱、常常超出可用宽度,现在截断而不是缩字号(缩了会让同一栏里各行字号不一致,远看像某个成员"特殊")
  • 菜单栏那一行的"整个团队"改成**"全部"**。原来的措辞放不下,而且把选中的成员名整个挤出可视区——那个名字正是这个控件存在的理由。它紧跟在「团队」按钮后面,读者知道它指的是团队。设置里的选择器保留完整说法(那里有宽度,也遵循"所有设备 / 所有账号"的前缀式样)
  • 账号名为空的分组(GLM、MiniMax,没有本地账号名时)不再画账号头。原本渲染成 Local | 未知账号:来源词区块标题里已经有了,"未知账号"只是把"没有名字"这件事又说了一遍。零信息,一行噪音。Kimi 没有账号名时同样处理
  • MiniMax 订阅到期日去掉前导零:2027-04-05 → 27/4/05。到期日只关心"哪一天",而右边没有宽度容纳补零的四位年份

已知边界

  • 合并要求两边都有采样时间。对方没升级时本地优先,这是刻意的保守选择
  • 水平参考线按"阶段"而不是差值正负判断,两处 delta 的符号约定在本代码库里是相反的
  • 本地 + 云端合并的行只渲染胜出的那一次,但会记住两边都参与过(mergedSourceKinds),tooltip 里能看出来
在 GitHub 查看版本与下载附件 ↗

v1.35.0 — 占位图标三选一、周趋势曲线、诚实的更新时间

v1.35.0 — 占位图标三选一、周趋势曲线、诚实的更新时间

macOS build 68。这一版同时把安装方式换成了安装包。

更新装方式:双击就好,不用挂载不用拖

之前是 DMG,下载 → 挂载 → 拖进「应用程序」。现在是安装包,双击一步到位,而且多干了两件拖拽做不到的事:

  • 替换之前会先退掉正在运行的旧版,装完再拉起来。一个菜单栏 app 更新完悄悄从菜单栏消失、要等你注意到才回来,比"多点一次"糟糕得多
  • 装完自动把安装包本身删掉,不留在下载文件夹里

两个脚本(preinstall / postinstall)都以 root 运行,都已经在真机上跑通两遍验证过。

需要知道的一件事:安装包没有开发者签名、也没有经过 Apple 公证(里面的 app 是 ad-hoc runtime 签名)。从浏览器下载后双击,macOS 会比装 DMG 时提示得更重一些。如果提示"无法验证开发者",按 Control 点击安装包选"打开",或者到「系统设置 → 隐私与安全性」里点"仍要打开",之后就正常了。

不想装安装包的话,release 里仍然附带 DMG,两者功能完全一样。

菜单栏占位图标:从开关变成三选一

原来只有一个"占位时是否显示供应商数量"的开关——那是两种形态的布尔表达,塞不进第三种。现在改成三选一:

选项 菜单栏显示
OpenAI 连通性(默认) 哑色开环 + 中心一枚连通性记号(对勾 / 叉 / 探测中)
供应商数量 哑色环 + 已启用的供应商数量
品牌字母标 复刻 App 图标构图的字母标

默认换成连通性,是因为占位的时候本来就没有额度可显示,而"现在能不能顺利拉起 ChatGPT"是那一刻唯一还成立、又真的在意的信息。没有它,占位期间菜单栏就是一个纯装饰的死环。

这个记号刻意做得不像「Codex 掉线」:掉线是整环变红 + 中心红药丸 + 呼吸脉冲三件事叠加,这里环始终保持哑色中性、完全静态,只有中心记号承载状态。缩到二十几像素也不会误读。可达状态用的是中性色而不是绿色——这个 app 的语义色只有警示琥珀和危险红,绿色会变成第三种要记住的约定。

tooltip 会追加一行说明(可达 / 不可达 / 正在探测),否则菜单栏那二十几像素里的记号没人解释。

只有周窗口的账号,环内终于有形状了

一个只有 Weekly、没有 5h 的账号,环内原本只有一个"快慢"单值——而这个值横跨好几天,说不出任何形状。现在:

  • 这种账号的外环和内圈都按 Weekly 计算。你设的是"环显示 5h",但根本没有 5h 可显示,退回 Weekly 才是你真正想问的那个额度
  • 内圈画趋势曲线,而不是原来的双向节奏扇形——周窗口跨好几天,单值没有信息量,形状才有
  • 曲线需要至少两个采样点才存在(一个点画不出线,只会在扇形位置留一个孤零零的圆点,看着像渲染坏了),最多 24 个点(菜单栏只有二十几像素宽,再多只是锯齿)
  • 横轴是采样在本窗口时间轴上的位置,不是它在数组里的序号。按序号排会让两个点横跨整个环,看上去像一周走了个来回,那是假的

内圈是独立设置项。如果你把内环指向了别的窗口,扇形就保住那块地盘——周窗口超额 10% 恰恰是最该被看见的信号,不该被趋势曲线挤掉。

关注账号显示的时间,以前是错的

账号行右边那个时间读的是最后一次采样的时刻。它显示成 Watch · 10/11 23:59,而数据其实是五分钟前抓的。

原因是两跳接力:CodexUsageDataMapper 把真实抓取时刻丢掉了(sampledAt: nil),发布投影于是拿 endTime 兜底——而 Codex 的 endTime 就是 resetsAt,是窗口的结束时刻,可能在好几天之后。数据是新的,时间是错的,这比没有时间更糟:你会以为是坏了或者没同步。

修了四层:

  • 源头 —— 每行 Codex 额度带上真实的抓取时刻
  • 发布 —— 不再拿窗口边界兜底
  • 读侧 —— 采样时刻晚于"现在"就不是时间,是故障报告,退回发布时刻
  • 服务端 —— publish 时把落在未来的采样时刻收敛到发布时刻

后两层是为了对方不升级 app 也能正确显示。已经在服务器上验证过:对方那台还是老版本、照旧发来未来的时间,服务端当场改写,所有读侧拿到的都是对的时间。resetsAt 是独立字段,不受影响——"超额 35% · 10/11 23:59"那行重置时间照常显示。

顺带修正

  • 账号名放不下时截断而不是缩字号。缩了会让同一区块里各行字号不一致,远看像某个账号"特殊"
  • 宽度不够时先让套餐名让位——套餐名是装饰,账号名才是身份
  • 时间戳是原子的,不会被截成半个 10/5 11:1
  • 跨天的时间戳补上日期(9/28 11:50),管理后台也一样。只有 11:50 读不出是哪天的快照
在 GitHub 查看版本与下载附件 ↗

v1.34.0 — 关注账号:只填邮箱,不要团队也不要密钥

v1.34.0 — 关注账号:只填邮箱,不要团队也不要密钥

macOS build 64。

关注账号:现在只要知道邮箱

前两版都把「知道账号就能看」这件事做复杂了。v1.32.1 做成局域网点对点,要手填 IP、端口和一份自建密钥;v1.33.0 改走团队云同步,传输对了,但仍要求两台 Mac 先用邀请码加入同一个团队。

这一版把中间那一层也去掉:只要知道邮箱,任何装了 AI Quota Bar 的 Mac 都能读到那个账号的额度。

  • 不需要建团队、不需要邀请码、不需要访问密钥、不需要 IP 和端口
  • 两台 Mac 不需要在同一个网络 —— 传输走 app 自带的云端服务
  • 关注方不需要在自己机器上登录 Codex
  • 分享方只需要:打开「允许其他 Mac 关注我的账号」→ 勾选那个邮箱

入口还是「设置 → 服务商 → Codex → 关注账号」。

数据流

登录了账号的那台 Mac                         关注方那台 Mac
┌────────────────────────────┐             ┌──────────────────────────────┐
│ 本机 Codex 凭据 → 抓额度    │             │ 「我关注的账号」填一个邮箱    │
│            ↓               │             │            ↓                 │
│ 只发布勾选的账号             │  POST       │ GET /v1/watch/quota?email=…  │
│  百分比 / 重置时刻 / 套餐名  │ ──────────► │  邮箱本身就是查找键           │
│            ↓               │             │            ↓                 │
│ /v1/watch/publish          │             │ 菜单里按账号分组显示            │
│  整体替换:空数组=全部取消   │             └──────────────────────────────┘
└────────────────────────────┘

Codex 登录凭据永远不离开登录它的那台机器。线上只有额度百分比、重置时刻和套餐名。

这条链路的边界,说在前面

读路径对「知道这个邮箱的人」是开放的。 这是「不要团队、不要密钥」的直接后果,不是疏漏:不要求团队、不要求密钥,就意味着服务端没有可以核对的秘密。真正的授权是 owner 在设置里逐个勾选那个邮箱 —— 勾了就是「知道这个地址的 Mac 可以看我的额度」,取消勾选立刻从云端删除。

服务端存的是 sha256(归一后的邮箱),表里没有明文邮箱。但要说清楚:哈希只保证服务端不存明文地址,不构成访问控制 —— 任何人都能算出一个地址的查找键。

在这个前提下仍然守住的:

  1. 默认拒绝。 打开开关后只有逐个勾选的 Codex 账号会被发布;没勾的一个都不发。账号名为空的未归属额度同样不发 —— 它没法被按邮箱关注。
  2. 只发百分比。 对外只有额度百分比、重置时刻和套餐名。没有 token、没有 API key、没有绝对用量(绝对量会暴露这个人真实烧了多少)。
  3. 撤销立即生效。 发布是整体替换语义,所以取消勾选会立刻从云端删除该行,不需要等下一轮刷新,也不需要单独的撤销接口。
  4. 过期数据不冒充现值。 超过 3 小时没更新的快照会标成「数字可能是旧的」,而不是把旧数字当现值渲染。行仍然保留 —— 你点名要看的账号不该凭空消失。
  5. 被读取是可查的。 分享侧能看到每个账号被读取过几次、最后一次是什么时候。只含计数与时间,不含读取者身份;owner 的手段是「取消勾选」,不是拉黑某个读取者。
  6. 不转发别人的账号。 分享名单来自本机登录着的账号,不是从菜单那份已经和团队云端合并过的数据里取的 —— 后者混着别人上报的账号,从那里取会让本机把同事的额度当自己的转发出去。
  7. 不碰团队体系。 /v1/watch/* 是独立命名空间,读不到团队数据、设备凭据或后台。团队隔离的既有约束一条都没有放松。
  8. 有速率限制。 读取按来源 IP 限流(120 次/小时),发布按发布方限流(120 次/小时)。
  9. 一个地址只能被一个发布方占用。 第二个发布方会被拒绝(409),否则原发布方后续的「取消分享」会删不掉这一行,账号会永久留在云端。

端点鉴权用的是 app 自带的内置 key(服务端叫 SYNC_TOKEN),每个安装都自带、零配置。它不是秘密 —— 就写在二进制里。它的作用是挡住随手 curl 的探查、给读取一个归属桶、让限流有依据;真正的授权是上面第 1 条的勾选。

打开开关就会自己去抓数据

分享侧要发布的内容来自本机这一轮抓到的额度。刚打开开关时通常一帧数据都还没有,所以开关打开时会先跑一次用量刷新,拿到数据再发布 —— 不需要你手动点刷新。

同时把误导性的空态文案改了:列表为空时不再说「这台 Mac 还没有登录任何 Codex 账号」(可能是根本没抓到,不是没登录,两者用户动作完全相反),改成「还没有拿到这台 Mac 的 Codex 额度数据」并给一个重试按钮。

修掉的三个问题

  • 抓取失败会误删云端快照。 Codex 抓取失败那一轮本机没有数据,原本会发布一个空集,而发布是整体替换语义 —— 一次网络抖动就等于把这个账号取消分享。现在没有本机数据时根本不发。
  • 过期数字被当成现值。 状态判定里先检查了「有没有快照」再检查「过不过期」,而缓存快照在过期时是故意保留的(行不该消失),于是 2.5 小时前的数字会以「云端 · N 条」的形式显示为现值。现在过期判定优先。
  • 可分享账号列表是陈旧的。 它原本是 @State,只在打开面板和账号增删时刷新 —— 用量刷新后不会更新。改成计算属性,永远跟着最新一次抓取走。

与前两版的差别

v1.32.1(build 62):局域网点对点。owner 端自己起明文 HTTP 服务,对端手填 IP、端口、自建密钥。只能同一 Wi-Fi 用。已删除:局域网端点、七个 CodexWatch* 类型、手机看板为此多起来的「被关注也要监听」分支。

v1.33.0(build 63):改走团队云同步通道。该版本对团队通道做的上报过滤与启动读取改动,在本版本全部撤回 —— 团队同步行为回到与关注功能无关的原有状态。

从 v1.32.1 升级的用户,之前勾过的账号会自动迁移(读 codexWatch.isServing / codexWatch.grants.v1),不用重新勾。

在 GitHub 查看版本与下载附件 ↗

v1.33.0 — 关注账号改走云端,只填邮箱

v1.33.0 — 关注账号改走云端,只填邮箱

macOS build 63。

关注账号:只填一个邮箱

上一版(v1.32.1)把这个功能做成了局域网点对点:登录了账号的那台 Mac 自己起一个明文 HTTP 服务,想看的那台 Mac 要手填 IP、端口和一份访问密钥。结果是操作步骤重、只能在同一个 Wi-Fi 下用,还得先去「手机看板」里翻密钥。

这一版整个换掉。传输改走 app 早就有的团队云端通道,后端一行代码没改,鉴权沿用现有的设备凭据。

现在关注方要填的只有一个邮箱:不需要地址、不需要端口、不需要访问密钥,也不需要在关注方登录 Codex。

  • 打开「允许其他 Mac 关注我的账号」,勾选要分享的账号,它就跟着「共享账号额度」一起同步到团队云端。
  • 关注方在「我关注的账号」里填那个邮箱、点添加,菜单里就出现该账号的分组行,状态行显示「团队云端 · N 条 · 更新于 …」。
  • Codex 登录凭据仍然永远不离开登录它的那台机器,线上只有额度百分比、重置时刻和套餐名。

现在的完整步骤

  1. 两台 Mac 都在「设置 → 团队」里,创建或用邀请码加入同一个团队(一次性,成员口令存本机钥匙串,之后不用再填)。
  2. 登录了那个 Codex 账号的 Mac:打开「允许其他 Mac 关注我的账号」,勾选该账号,并确认「团队」区块的共享账号额度是开着的。
  3. 想看的那台 Mac:在「我关注的账号」里填邮箱,点添加。

团队是这条通道的鉴权边界,不是可用性上的将就:云端按团队隔离数据,没有加入团队就什么都读不到。

分享侧默认一个都不共享

打开开关后,只有逐个勾选的 Codex 账号会被上报;没勾的一个都不传。账号名为空的未归属额度同样不上报——它没法被按邮箱关注,留着只会让人以为在共享。

开关关着的时候完全不做任何过滤:所有 Codex 额度照旧按「共享账号额度」的原有行为上报。已经开了团队同步的老用户升级后行为一个字都不变。这个开关也只管 Codex,不影响 Kimi / GLM / MiniMax 原有的共享行为。

不转发别人的账号

分享名单取自本机登录着的账号仓库,不是从菜单用的那份合并数据里取的。后者已经和团队云端合并过了,里面混着别人上报的账号——从那里取会让本机把同事的额度当自己的再转发一次。本机只是「看」了它,没有资格替它分享。

三种「看不到数据」分开显示

  • 没加入团队 → 「还没加入团队,暂时读不到别人的账号」
  • 通道正常但云端没有这个邮箱的快照 → 「还没数据。让对方勾选这个邮箱,并确认那台 Mac 在运行」
  • 有数据 → 「团队云端 · N 条 · 更新于 …」

这三种对应的用户动作完全相反,混成一句「无数据」会让人以为该重装点什么。

顺带修正

  • 只想看别人账号、不想共享自己额度的机器,现在也会正常拉取云端数据。之前启动时和「共享账号额度」开关绑死,导致纯关注的机器启动后关注行要空到下一次刷新才有内容。
  • 「添加」按钮只在输入为空时禁用。输入不合法或已关注过时保持可点并给出具体原因——一个不解释自己为什么灰着的按钮,比点一下看到一句「格式不对」更让人卡住。

移除的内容

v1.32.1 的局域网通道整条删掉:

  • HTTP 端点 /api/v1/watch/quota,以及手机看板服务为此多起来的「被关注也要监听」的分支——手机看板回到「只有自己打开才监听」的原有语义。
  • CodexWatchPeerClient / CodexWatchPeerStore / CodexWatchResponseBox / CodexWatchPeerModel / CodexWatchProjector / CodexWatchPayload / CodexWatchGrantStore。
  • 钥匙串里按 codexWatch.peer.<uuid> 存放的对端令牌(新增关注时不再产生)。

原来那套的自建访问密钥、地址白名单、拒绝重定向、令牌只进 Authorization 头等约束随通道一起消失——因为不再有需要跨进程分发的凭据。团队隔离(docs/team-isolation.md)的既有约束一条都没有放松,也没有新增任何公开端点或 app 级共享密钥。

从 v1.32.1 升级的用户,之前勾选过的账号会自动迁移过来(读取 codexWatch.isServing / codexWatch.grants.v1),不用重新勾。

其它

  • 手机看板回到「只有自己打开才监听」:v1.32.1 里为了分享额度,会在只开关注开关时也把局域网服务拉起来。
在 GitHub 查看版本与下载附件 ↗

v1.32.1 — 跨设备关注 Codex 账号、菜单栏环逐服务商取数

v1.32.1 — 跨设备关注 Codex 账号、菜单栏环逐服务商取数

macOS build 62。

关注另一台 Mac 的 Codex 账号

  • 一台 Mac 登录的 Codex 账号,现在可以在另一台 Mac 的菜单栏里直接看到——不必、也不需要在第二台机器上登录它。
  • owner 那台机器自己抓额度,再把结果按白名单吐给局域网内被授权的对端。Codex 登录凭据始终不离开 owner 那台机器,也不经过任何服务器;线上只有额度百分比和重置时刻。
  • 入口在「设置 → 服务商 → Codex → 关注账号」,一个区块两半:
    • 「允许其他 Mac 关注我的账号」:全局开关 + 逐账号勾选,默认全关,未列出的邮箱一律不外发。
    • 「我关注的账号」:添加 / 移除对端,填局域网地址、端口与访问密钥。
  • 访问密钥复用「手机看板」那一把,不用额外分发第二套凭据;分享额度不要求打开手机看板,只开关注开关时局域网服务照常起来,但看板与账号名掩码策略不受影响。
  • 添加对端会先握手再入库:地址写错、对方没开分享、密钥不对,当场给出一句明确的话,而不是加进去之后菜单里永远挂一个连不上的条目。
  • 访问密钥有三重限制:只发往回环 / 私有网 / 链路本地地址(粘公网地址进来本地就拒)、拒绝一切重定向(否则一个 302 就能把令牌骗去别的主机)、令牌只进 Authorization 头不进 URL。密钥存在钥匙串,删除对端时真删。
  • 授权可随时收紧并立即生效;对方撤销后,关注侧会清掉本地缓存,不会继续显示一份已经不获授权的额度。
  • 对端不可达、额度窗口已过这两种「没有新数据」会分开显示,不会混成一个看不懂的错误。

被关注的账号不会自己消失

云端账号数据超过时效阈值后会被整条隐藏——对云端团队数据这是对的,但对你明确点名要看的账号是错的:账号会因为对方机器安静下来而从菜单里凭空消失。关注来的账号走另一条路:窗口过期时把显示区间撑到当下,行还在并标 stale;对端断线时保留上一份数据,而不是让数字清零。

另外,从别的 Mac 关注来的账号不会被这台机器再分享出去:本机只是「看」了它,没有资格替它做二次传播。

菜单栏环:逐服务商选取数窗口

  • 菜单栏圆环的外环与中心此前共用一个全局窗口选择,想让 Codex 读 Weekly 就没法同时让 Kimi 读它自己的当前窗口。
  • 现在可以逐服务商设置外环与中心的取数窗口;未单独设置的跟随全局默认。
  • 该服务商不支持所选窗口时(例如 MiniMax 没有周窗口)自动回落到当前窗口,不会画出无意义的数据。
  • General 页新增每个服务商各自的窗口选择器,改动即时反映到菜单栏。

管理后台:额度明细可追溯

  • 后台此前只显示每个账号的最新快照,无法看出这个数字怎么变成现在这样——一个错误的数字和一次真实飙升看起来一模一样。
  • 新增单账号的原始采样历史查询,带显式行数预算;返回被截断时明确告知,避免把一份残缺数据当成完整数据渲染。
  • 预算优先保留最新数据:取最旧的一段会让繁忙账号静默显示几天前的数字,却没有任何提示。
  • 支持按模型过滤,宽账号不会把预算浪费在马上会被过滤掉的兄弟模型上。
  • 不认识的查询参数直接拒绝而不是忽略——一个拼错的参数会返回 200 加默认区间,看起来像「筛选生效了」。
  • 后台明细页改为按模型列展示,历史数据按需加载。

其它

  • 本机用量清理逻辑改名:pruneDelivered 只删云端已确认的行,但这个 helper 也会删掉已无消费方的本机行,旧名字让第二个调用点看起来像误用。
在 GitHub 查看版本与下载附件 ↗

v1.32.0 — 暂时离开一键调暗、合盖调暗与 Clash 面板自适应

v1.32.0 — 暂时离开一键调暗、合盖调暗与 Clash 面板自适应

macOS build 61。

暂时离开:一键调暗所有屏幕

  • 右键保护面板新增「暂时离开 · 调暗所有屏幕」:点击后所有屏幕瞬间盖上一层黑色遮罩(屏幕保护级别窗口),同时内置屏背光归零、外接显示器通过 DDC/CI 压暗;移动鼠标或按任意键立即恢复。
  • 长按右键状态栏图标 0.6 秒可直接触发调暗,快速右键仍打开面板。
  • 遮罩黑度可在设置窗口 General 页调节(60–100%,默认 90% 半透明):低于 100% 为纯遮罩模式、不动背光,100% 全黑才做真实调暗。
  • 键盘恢复依赖辅助功能权限的 listen-only 事件监听,未授权时静默降级为仅鼠标恢复。
  • App 启动时会恢复上次崩溃/强退遗留的调暗状态,不会让屏幕一直黑着。

合盖工作期间自动调暗内置屏幕

  • 合盖保护运行期间(有任务保持唤醒时)自动把内置屏幕压到最低亮度,外接显示器不受影响;系统自动亮度回升会被持续对抗。
  • 内置屏亮度值会持久化,异常退出后下次启动可恢复原亮度。

Clash 面板高度自适应屏幕

  • 右键 Clash 面板从固定基准高度改为按所在屏幕的可用高度自适应:小屏上先压缩账号区(内部滚动),再让连接列表让位,最后账号区收起为标题行,不再出现连接列表被挤死或尾部被裁的问题。
  • 显示器插拔、重排时自动按新屏幕重新计算。

检测准确性

  • Kimi 桌面 agent 改用会话状态账本作为权威生命周期来源:任务结束立即判不活跃(不再滞留最长 120 秒),开始立即亮起;心跳仅作为崩溃兜底。CLI 的静默窗放宽到 10 分钟,长工具调用不再闪烁掉出活跃集。
  • 新增 Kimi Work(daimon)桌面运行时检测,以「Kimi Work」标签出现在任务列表中。
  • Codex hook 任务新增 10 分钟 TTL 回收:进程被 kill -9 或 Stop hook 丢失时不再留下把保护环永久钉在工作态的「幽灵任务」。
  • Claude Code 的模型归因改为跟随转录中最新一条 assistant 消息:会话切回官方模型后立即不再计入 GLM/MiniMax。
  • 切换或重新登录 Codex 账号后,左键菜单的当前账号立即刷新,不再等最长 60 秒。

管理控制台

  • 账号额度详情重构为与 App 左键菜单同款的「供应商 → 账号 → 模型列」层级,同一账号每个模型并排一列;新增搜索、全部展开/收起、重置视图。
  • 展开账号时按需懒加载最长 168 小时的额度历史;时间显示在中文界面使用 UTC+8(英文保持 UTC)。
  • 图表按容器实际宽度绘制,窄列自动做减法;新增 MiniMax、智谱 provider 图标。

本地数据

  • 本机用量数据库自动瘦身:已确认上云的事件在本地保留 40 天(覆盖图表读取的 35 天窗口)后自动清除,空闲页超过 64 MB 时压缩回收;待上传、被拒和纯本地记录永不自动删除。
  • 任务检测轮询的日志只在活跃任务数变化时记录,MiniMax 检测器跳过过期后台目录,显著降低每日日志与磁盘扫描开销。

要求 macOS 14+;DMG 面向 Apple Silicon,沿用 ad-hoc 签名,未经过 Apple 公证。

在 GitHub 查看版本与下载附件 ↗

v1.31.0 — 左键菜单用量卡片支持团队视角

v1.31.0 — 左键菜单用量卡片支持团队视角

macOS build 60。

菜单里的用量卡片可以切到团队视角了

  • 左键菜单的 Codex 用量卡片新增「本机 / 团队」切换(存在团队连接时出现):本机视图仍读取本地扫描;团队视图读取服务端聚合的当月用量与近 24 小时分时。
  • 团队视图自带成员选择器:默认「整个团队」,也可下拉切换到单个成员,查看他/她的当月热力图与 24 小时分布。
  • 团队视角不要求本机登录 Codex——没有本地 Codex 登录时卡片依然可用,只读成员上报的「共享本机用量」;尚无上报时显示空态提示。
  • 服务端聚合的变化远慢于菜单的每分钟重绘,因此一次拉取结果复用五分钟;重新打开菜单、切换成员或团队会立即刷新。成员离开团队后选择自动回退到「整个团队」,断开团队连接则回到本机视图。
  • 拉取前的空态也保持「近 24h」标题,与服务端固定返回 24 小时分时一致,避免布局跳动。

要求 macOS 14+;DMG 面向 Apple Silicon,沿用 ad-hoc 签名,未经过 Apple 公证。

在 GitHub 查看版本与下载附件 ↗

v1.30.0 — Codex 账号免登录切换

v1.30.0 — Codex 账号免登录切换

macOS build 59。

切换 Codex 账号不再需要重新登录

  • 右键面板新增「Codex 账号」分区:列出当前账号与账号池里的所有备份,点「切换」即对 ~/.codex/auth.json 与账号池(~/.codex/accounts/)做一次原子改名换位——没有登录弹窗,也不用扫码。
  • 「登录新账号」会把当前凭据先存入账号池,然后自动打开 ChatGPT 让你登录一次;此后新账号永远只有一键之遥。
  • 守卫原则:绝不代替你退出应用。ChatGPT/Codex 桌面版或 codex 命令行在运行时,切换请求会挂起并显示横幅(「退出 ChatGPT 后将自动完成切换」),你用正常方式退出后几秒内自动接力完成;文件搬动前的最后一刻还会再查一次运行状态,防止竞态。
  • 账号池就地管理:重命名、删除(移入废纸篓)、把以前手动改名的 auth *.json 旧备份一键收编。同一账号重新登录会以较新凭据替换旧备份而不是生成重复项;API Key 模式的 auth 文件绝不会被自动处理。
  • 每个账号行显示该账号「上次获取到的配额」:5 小时短周期与 Weekly 长周期的剩余百分比及重置时间(悬停查看完整时间戳)。配额快照在每次成功刷新时按账号指纹记录。
  • 实现层面:auth 文件解析下沉到本地用量共享内核(与用量账号观测同一套判定);切换是两次保持 0600 权限的原子改名,全程不读取、不存储任何 token 内容——只用账号指纹和邮箱。

要求 macOS 14+;DMG 面向 Apple Silicon,沿用 ad-hoc 签名,未经过 Apple 公证。

在 GitHub 查看版本与下载附件 ↗

v1.29.0 — 任务结束即时落波,空闲负载大幅降低

v1.29.0 — 任务结束即时落波,空闲负载大幅降低

macOS build 58。

GLM/ZCode 任务结束即时识别

  • 现场实验证实:ZCode 的 turn_usage 账本只在回合到达终态(completed/error/cancelled,含用户取消)时才插入一行,执行期间没有可观察的 running 行。
  • 检测改为混合式:开始与进行中仍由 time_updated 新鲜度驱动;每次轮询按 rowid 游标消费新落账的终态行,立即把该会话移出活跃集。
  • 任务结束/取消的识别延迟从最长约 120 秒缩短到一个轮询周期(2–3 秒),取消语义首次可感知。取消后立即继续的回合受终态时间门控保护,不会被误杀。
  • 表结构变化时自动回退为纯新鲜度检测,行为与旧版一致。

空闲占用修复(两处单核打满)

  • Kimi CLI:wire 转录改为增量解析,从上次消费的换行处续读。此前空闲状态下每轮全量重读数百份历史转录,单核被打满。
  • MiniMax:bg_* 目录的修改时间随目录列举一次取回,探针文件改用原生 stat——此前 FileManager 对每个缺失文件抛接一次 ObjC 异常,数千个历史任务目录即可占满一个核。

任务波:追逐队列布局(新默认)

  • 新增「追逐队列」布局并设为默认:所有任务波在可见弧上首尾相接列队行进,波头恒亮成珠,任意任务数下每道波同时可见、可数。
  • 设置中可切回「均匀分布」(原全轨道行为)。
  • 环境动画(任务波、离线脉冲)的重绘节奏从 30fps 降至 12fps:每次重绘都是一次完整的 CPU 位图渲染,降帧后空闲渲染负载减半以上,慢速运动在视觉上依然平滑。「减弱动态」时队列以静止姿态停在可见弧上。

官网管理台

  • /admin 新增「打开面板」:平台管理员可免密进入任意团队面板(含早于 usage_teams 的仅设备团队),全程不触碰团队密码。
  • 仅设备团队轮换邀请码现在明确返回 404,不再静默发出从未持久化的邀请码。

要求 macOS 14+;DMG 面向 Apple Silicon,沿用 ad-hoc 签名,未经过 Apple 公证。

在 GitHub 查看版本与下载附件 ↗

v1.28.1 — 任务检测可靠性修复,启动不再冻结

v1.28.1 — 任务检测可靠性修复,启动不再冻结

macOS build 57。

MiniMax 任务检测修复

  • 检测信号从会话 manifest.json(实测会落后实际写入数分钟)改为会话目录内文件的活动时间:转录仍在写,任务就计为进行中。
  • 新增对桌面版 MiniMax Code 后台任务(~/.minimax/background-tasks)的检测——此前这类任务完全不可见,是"任务在跑却计为 0"的主要原因。

Kimi 任务检测修复

  • 旧检测依赖的 session_index.jsonl(新版运行时已停止维护)和按进程工作目录匹配的门控在新版 Kimi 桌面端下全部失效,导致任务时有时无。
  • 现在从桌面 agent 的 conversation-context-usage.json 读取每个会话自带的 updatedAt,更新中的会话计为进行中。
  • CLI 的 wire 转录仍受支持:turn 开启且文件仍在更新才算活跃,进程被杀后自动衰减,不会永久误保护。

启动不再被钥匙串阻塞

  • 重签名安装后的首次钥匙串授权弹窗,此前会让整个应用冻结在启动线上(无状态栏、感知不到任何应用退出/启动)。
  • 凭证库预加载改为异步:状态栏立即出现、全部功能即刻可用;弹窗回答后自动校正已配置缓存并刷新一次。

要求 macOS 14+;DMG 面向 Apple Silicon,沿用 ad-hoc 签名,未经过 Apple 公证。

在 GitHub 查看版本与下载附件 ↗

v1.28.0 — AI 任务保护覆盖全部四家供应商

v1.28.0 — AI 任务保护覆盖全部四家供应商

macOS build 56。

AI 任务保护扩展到 GLM 与 MiniMax

  • 「AI 任务保护」此前只在 Codex 和 Kimi 任务期间阻止休眠;现在 GLM 与 MiniMax 的本机编程任务同样参与保护,四家供应商的任务计数、保护弹窗与手机看板任务列表全部合并展示。
  • 新增三个只读、被动的本机检测器(不读取任何消息内容):
    • GLM(ZCode):读取 ZCode 桌面版与 CLI 共用的会话数据库,交互式会话保持更新即视为工作中;
    • MiniMax CLI:读取 ~/.minimax/v2/sessions 各会话 manifest.json 的更新时间;
    • Claude Code 桥接:通过自定义端点在 Claude Code 里跑的 GLM / MiniMax 任务,按转录文件中响应模型的名称自动归属到对应供应商(其他模型,例如官方 Anthropic 端点,不会误触发)。
  • 检测统一以「会话约 2 分钟内有更新」为工作信号,配合原有 5 分钟收尾宽限期;任务结束或 App 退出时立即释放全部断言的行为不变。
  • 供应商是否纳入保护仍按本地实际存在判定:GLM 需要 Keychain 凭证或装有 ZCode;MiniMax 需要 Keychain 凭证或存在 MiniMax CLI 会话目录。
  • 菜单状态行会随本地可检测的供应商动态列出(例如"已就绪 · 正在等待 Codex、Kimi、GLM 与 MiniMax 任务");系统电源断言名称改为中性的"AI task is working"。

说明:MiniMax CLI 检测基于会话清单的更新时间,任务计数的边界仍在持续校准中。

要求 macOS 14+;DMG 面向 Apple Silicon,沿用 ad-hoc 签名,未经过 Apple 公证。

在 GitHub 查看版本与下载附件 ↗

v1.27.0 — 左键菜单收起跟随应用,钥匙串一次授权

v1.27.0 — 左键菜单收起跟随应用,钥匙串一次授权

macOS build 55。

左键菜单供应商区可收起

  • 「跟随运行中的应用」在左键菜单改为自动收起/展开:应用未打开的供应商不再整块移除,而是把该区收起成一行标题,数据仍在原地。
  • 标题行可点击手动展开或收起;自动切换与手动操作都记入同一状态,菜单重开、App 重启后保持。
  • 菜单栏圆环仍按应用运行状态自动显隐,与 v1.26.0 一致。

启动钥匙串授权合并为一次

  • 启动时不再分别请求「AI Quota Bar 凭证库」和「kimi-desktop Safe Storage」两个授权:首次交互授权后,Kimi 桌面端密钥缓存进自家凭证库,之后只访问一个条目。
  • 后台刷新完全不触碰其他应用的钥匙串条目(macOS 的分区检查在后台也会弹窗);Kimi 轮换密钥时静默跳过,下次在设置里点「允许读取桌面登录」自动重取。
  • 历史遗留条目只在凭证库不存在时才探测,迁移成功后自动删除。

Kimi 月计划柱图按天切分

  • 「Total usage」只有到期日没有开始日,柱图现在按到期日回推一个自然月:每天一条分隔线,悬停显示日期标签(抽稀到最多 6 个)。
  • 节奏指针、reserve/deficit 提示和菜单栏圆环的盈余/透支扇形也按该窗口估算。

要求 macOS 14+;DMG 面向 Apple Silicon,沿用 ad-hoc 签名,未经过 Apple 公证。

在 GitHub 查看版本与下载附件 ↗

v1.26.0 — 菜单跟随运行中的应用

v1.26.0 — 菜单跟随运行中的应用

macOS build 54。

跟随运行中的应用

  • 设置 → 显示新增「跟随运行中的应用」开关(默认关闭)。开启后,菜单栏与左键菜单只显示对应桌面应用已打开的供应商:ChatGPT(Codex)、ZCode(GLM)、Kimi、MiniMax Code。
  • 应用启动或退出时自动出现或隐藏,无需手动调整;应用都未打开时菜单栏保留占位显示,确保状态栏入口始终可点。
  • 左键菜单被全部隐藏时会给出提示卡片,可一键改回「显示全部供应商」。

范围

本次仅为显示层功能:配额后台刷新、数据来源、账号处理与手机看板均不受影响;供应商的暂停、排序与单项隐藏设置照常生效。

要求 macOS 14+;DMG 面向 Apple Silicon,沿用 ad-hoc 签名,未经过 Apple 公证。

在 GitHub 查看版本与下载附件 ↗

v1.25.0 — 左键菜单供应商可排序,月度周期标签修正

v1.25.0 — 左键菜单供应商可排序,月度周期标签修正

macOS build 53。

左键菜单

  • 设置 → 显示新增「菜单供应商顺序」:供应商按当前顺序排成一行,用箭头逐位调整。默认顺序为 Codex、Kimi、GLM、MiniMax;调回默认顺序会自动清除自定义设置,旧版本保存的偏好正常加载。
  • 顺序只影响菜单展示,额度采集、历史、告警与同步不受影响。

月度周期标签

  • Kimi 月度「Total usage」行的历史柱图此前标注为「Week cycles」,现改为「Monthly cycles」。手机看板快照新增明确的周期种类字段(short / weekly / monthly),没有该字段的旧快照回退到原有推断逻辑。

范围

本次仅为展示层调整。Kimi、Codex、MiniMax、GLM 的数据来源、刷新门槛与账号处理逻辑均未改变。

要求 macOS 14+;DMG 面向 Apple Silicon,沿用 ad-hoc 签名,未经过 Apple 公证。

在 GitHub 查看版本与下载附件 ↗

v1.24.0 — 自动识别 Kimi 桌面与网页登录

v1.24.0 — 自动识别 Kimi 桌面与网页登录

macOS build 52。

Kimi 额度来源

  • 默认自动检测有效的 Kimi 桌面登录、已保存网页登录、CLI 和可读取的浏览器登录,无需手动选择来源;已保存的 API Key 保持最高优先级。
  • 支持新版桌面客户端的加密登录存储,只读凭证,不修改客户端文件或接管 refresh token。
  • 设置页显示最近成功的数据来源;手动来源选择、浏览器导入和授权入口收进高级选项。
  • 分别展示 Code 短窗口、7 天额度及可获得的会员总额度,保留各自重置时间和账号归属。
  • 后台浏览器检测不弹出钥匙串授权,缓存检测结果;多个不同账号不会自动任选一个。选定有效桌面或网页登录后的网络错误不会切换账号。

使用与验证范围

桌面自动读取已在本机实测。浏览器导入和海外账号尚未完成实机验证;来源是否可用取决于登录有效期和本机读取权限。桌面登录过期时,请在官方客户端恢复有效登录,App 不自行刷新官方凭证。

要求 macOS 14+;DMG 面向 Apple Silicon,沿用 ad-hoc 签名,未经过 Apple 公证。MiniMax 继续直接使用 API Key,不依赖桌面客户端。

在 GitHub 查看版本与下载附件 ↗

v1.23.1 — 菜单到期行更简洁,官网团队预览对齐

v1.23.1 — 菜单到期行更简洁,官网团队预览对齐

macOS build 50。

左键菜单

  • MiniMax 套餐到期行去掉「到期 / expires」字样,只保留日期,减少重复文案。
  • 供应商表头右侧的套餐副标题过长时按最多 10% 轻微缩小,不再直接截断。

官网

  • 首页「谁用了多少」面板预览卡复现真实 /team 页面:页头标题与范围工具行同款,控件统一 32px 高、6px 圆角,成员条形图与小时图分列样式一致。
  • 移除旧版 hero 演示遗留的 .activity-* 规则:这些类名与 /team 真实前端同名,残留样式会把首页嵌入的小时图压成约 20px 高。
  • 预览卡位于宽度随视口连续变化的栏目内,窄版布局改用容器查询按卡片自身宽度触发,并为不支持的引擎保留视口媒体查询兜底。

范围

本版本不改变监测、上报、数据保留或签名方式;v1.23.0 的性能与上传修复不受影响。性能审查记录见 docs/performance-audit-2026-09-20.md。

在 GitHub 查看版本与下载附件 ↗

v1.23.0 — 降低常驻负载,看清存储与上传状态

v1.23.0 — 降低常驻负载,看清存储与上传状态

macOS build 49。

持续监测,减少重复计算

  • 修复菜单栏外观回调反复生成整套动画帧的问题。仅在可见内容、主题、尺寸或显示缩放变化时重建,保留原有 30 fps 动画与监测频率。
  • 本机用量改为增量处理变化会话及其关联分支,持久化轻量索引;界面只加载最近 35 天,无变化时复用统计结果。磁盘上的旧记录不删除。
  • 一台 10 核、16 GiB Mac 的现场测量中,进程平均 CPU 从旧版约 95.39%(61 秒)降至约 9.07%(新版 10 分钟);100% 表示一个核心。新版物理内存采样约 121–177 MiB,旧版重启后约 346 MiB。结果取决于机器、日志规模与活跃任务,不是所有设备的保证。

存储与上传可核查

  • 用量设置显示本地数据库及日志占用、原始 Codex 日志大小、额度重试队列大小,以及已确认、待上传、拒绝和仅本地记录数。
  • 显示最近上传回执、最早待传记录与重试时间;提供只读云端核验,按当前成员、设备和固定时间范围比较记录数及各项 token 总量。
  • 修复额度快照包含不被服务端使用的完整利用率历史,导致请求过大、HTTP 413 和重试积压的问题。新请求和旧队列重试均按团队接口精简;失败继续保留待重试文件,旧绑定数据保持隔离。
  • 未绑定上传目标的历史不等于已备份,不会自动补传。现有额度队列容量上限不变,长期断网仍可能淘汰最旧快照;本机 token 事件使用独立持久化队列。

数据保留边界

本次只减少内存加载,不启用自动删除或有损历史汇总。最近明细、较早按日、更远按月的分级保留仍是后续方案;未确认上传记录应保留原始事件。Codex 管理的原始日志不由本软件清理。

在 GitHub 查看版本与下载附件 ↗

v1.22.0 — 更清楚的菜单栏图标与准确的 GLM 状态

v1.22.0 — 更清楚的菜单栏图标与准确的 GLM 状态

本次包含 v1.21.0 以来的全部改动,macOS 构建号 48。

小尺寸也能分清状态

  • 菜单栏中心改为双向扇形:上方亮表示余量,下方亮表示透支,只有中心点亮表示节奏正常。未知节奏保持灰色,避免被误认为正常。
  • 中心覆盖面积增大,顶部开口扩大到 104°,服务商字母略微上移;C / K / M / G 始终可见,小尺寸下不再与环端头挤在一起。
  • 外环继续显示所选周期的剩余额度。黄色表示低额度;获取失败、数据不可用或 Codex 网络不通时显示红色横杠,有最后已知额度时保留该数值的外环。
  • 分档与连续节奏模式继续可用。自检演示透支、正常与余量;活跃任务光带沿外环运动,避开顶部字母,悬停时继续显示节奏和动画。
  • 修复最终菜单栏图片被系统模板化后丢失警告颜色的问题,并为自检与断网脉冲生成完整动画帧。浅色、深色及屏幕倍率变化会重新生成图标;遵循系统“减少动态效果”设置。
  • 修正任务光带在顶部缺口处跳接的问题:按完整圆周运动,在字母开口处遮挡;30 fps、16 段平滑渐变,外环不再整体淡化。
  • 每帧同时携带原生 1× / 2× 图像,跨屏显示不放大低分辨率缓存;位置对齐像素,按真实时间播放并保留刷新前后的运动相位。
  • 修复 GLM 外环和中心节奏未跟随所选周周期的问题;5h 缺少重置时间时,按最近五小时的实际采样绘制曲线并正确归为短周期,不虚构重置时间或节奏。
  • GLM 个人网页凭证可读取独立的可用重置次数与最近到期时间;只读展示,过期次数不计入额度,不执行兑换,查询失败不影响常规额度。

统一应用和网站图形

  • 启动图标采用 A 标识与同一套扇形语言;警告弹窗、移动仪表盘主屏幕图标、官网品牌图标、favicon 和首页动态演示同步更新。
  • 中英文设置说明及 README 同步解释余量、透支、警告和不可用状态。

团队网页细节

  • 简化团队页顶部区域,退出登录移入面板工具行,页脚补充首页链接。
  • 筛选与工具控件统一高度、圆角与背景;小时图列间距和轨道底色调整,空闲格保持透明,减少视觉粘连。
在 GitHub 查看版本与下载附件 ↗

v1.21.0 — 月历标注额度重置,悬停即见具体时间

v1.21.0 — 用量月历标注额度重置

本次包含 v1.20.0 以来的全部发布改动,macOS 构建号 47。

额度重置,一眼可见

  • 用量月历用深绿框标出 Codex 额度重置的日期,悬停即见「09/12 16:09 已重置」这样的具体日期与时间(本地时区,取当天最近一次)。
  • 重置记录来自 codex-resets.com 的公开数据,App 在后台自动获取,成功后 6 小时内不重复请求;离线或获取失败时完全不影响用量矩阵。数据仅用于显示,不会上传任何本机信息。

悬停气泡贴着格子

  • 用量月历和最近 24 小时矩阵的悬停气泡改为跟随所在格子:默认在格子正上方,顶部放不下时自动移到下方,不再遮挡「近 24h」「每格 5m」等标题文字。
  • 官网首页的用量演示同步了以上全部改进。

官网:团队界面真实复现

  • 首页「共享账号」板块改为复现 App「设置 → 团队」的真实界面,不再使用截图。
  • 「谁用了多少」板块直接嵌入 /team 面板同款的前端图表组件与示例数据,展示成员对比、月历与 5 分钟矩阵。
在 GitHub 查看版本与下载附件 ↗

v1.20.0 — 成员用量图表与团队一键直达

v1.20.0 — 成员用量图表,建团与团队面板一键直达

本次包含 v1.19.0 以来的全部发布改动,macOS 构建号 46。

创建、加入和切换

  • 「设置 → 用量与团队」默认展示创建团队;已有团队也能直接创建或加入其他团队。
  • 切换成功前保留原连接;原团队历史和已归属用量不会转移。创建后加入失败时保留恢复信息,重试不会重复建团。
  • 新建团队的管理密码安全保存到 macOS 钥匙串,请另存备份,仅分享邀请码给普通成员。

看清每个人用了多少

  • App 设置和团队网页新增成员横向对比图,可切换 Tokens、记录数、缓存命中率和估算成本,直接选择成员进入明细。
  • 原生设置复用左键菜单的日历与 24 小时绘图组件;网页同样提供 288 格、每格 5 分钟的矩阵。
  • 点击日历日期或选择历史日期,查看那一天的五分钟用量;可叠加成员、设备和账号筛选。
  • 展示输入、输出、缓存、推理与价格覆盖;未完整定价不会冒充完整成本。团队图表明确使用 UTC,且仅统计已上报数据。
  • 服务端按时间桶、价格生效区间和团队聚合,不把原始日志或对话发送到浏览器。

成员与管理员的完整入口

  • 所有成员点击「查看团队」直接打开只读团队面板,无需手动输入登录信息;可互相查看本团队成员、设备、用量及账号额度记录。
  • 「管理团队」使用已保存的管理凭据直达。旧版本没有保存管理密码,已有管理员需要首次补录一次,验证后后续无需重复输入。
  • 设置内团队用量默认展开并自动加载,提供 7 / 30 / 90 天范围、刷新、更新时间、加载/错误/空状态,成员行补充记录数、缓存命中率和估算成本。
  • 成员只能读取本团队数据;更新邀请码、撤销成员设备和删除额度历史仍仅限管理员。跨团队管理仍在独立认证的 /admin。

登录和隔离

  • App 签发 120 秒有效、只能兑换一次的网页登录票据,服务端仅保存票据哈希。长期设备凭据和管理密码不会放入链接。
  • 页面兑换前立即清除地址栏票据;Cookie 使用 Secure、HttpOnly、SameSite=Strict,有效期 8 小时。
  • 成员会话持续检查设备授权,设备撤销、退出或 token 轮换即失效;管理票据必须验证同一个团队的管理密码。
  • 多标签页登录不同团队时,旧页面操作携带团队校验,避免误操作新登录团队。延迟响应不会覆盖退出或切换后的页面/统计。

官网 UI 与发布流程

  • 根据真实原生组件重新核对官网:月历、最近 24 小时矩阵、账号切换、未定价状态、统计说明、菜单与配额图、历史周期、设置和移动预览。
  • 修复 hero 热力图列宽受小时标签撑开,造成格子交叉的问题;390 / 768 / 1440 宽度验证每张矩阵 288 格,零重叠与越界。
  • 官网新增团队网页预览,使用真实成员图表截图;原生团队区域使用真实 SwiftUI 渲染截图,并同步本版中英文 README、入口说明和图片。
  • 合并此前未提交的团队/管理页中英文切换、英文反馈页、更新日志中英文排版、站点导航及历史 Release 翻译;修复语言脚本被生产 CSP 拦截的问题。
  • 修复更新接口版本字符串规范化依赖遗漏,并验证 GitHub 不可用时的版本回退;同步此前发布记录。

验证与部署

  • 后端 71 项测试通过。
  • Swift 完整回归 386 项,0 失败,5 项环境相关跳过;另有 2 项真实 HTTP 联调通过,覆盖创建、加入、成员/管理直达、票据重放和退出撤销。
  • 浏览器验证成员只读视图、管理员视图和无效票据提示;原生中英文创建及已连接状态渲染通过。
  • 自部署先执行 cloudflare/migrations/0008_team_handoff.sql,再部署 Pages;仅新增短时票据表和索引,不修改用量历史。

macOS 14+,Apple Silicon。公开应用为 ad-hoc 签名,未进行 Apple 公证。

完整差异

在 GitHub 查看版本与下载附件 ↗

v1.19.0 — 用量与团队,多团队隔离

v1.19.0 — 用量与团队,多团队隔离

本次覆盖 v1.18.0 之后的全部发布改动。

App:一个入口管理一个团队

  • 合并 Usage 和 Sync 为「用量与团队」,在设置内直接创建或加入团队,保存一次性邀请与管理凭据。
  • 集中查看团队成员、设备、账号与 7 / 30 / 90 天汇总;本机统计继续独立可用。
  • 本机用量上报与账号配额共享分别开关,集中展示同步状态和日志。
  • 成员通过口令在另一台 Mac 加入;退出时撤销当前设备凭证并暂停共享。

多团队的数据与权限边界

  • 配额与用量统一使用团队设备凭证;服务端强制团队作用域,其他团队不能读取或删除数据。
  • 团队隔离覆盖数据库主键、设备身份、缓存、上传队列和异步响应;切换团队时丢弃旧请求结果,旧的无归属队列不会上传。
  • 防止仅凭设备 ID 接管已有成员身份;阻止带凭证请求自动跟随重定向。
  • 团队管理员在 /team 清理本团队账号、撤销成员设备;删除记录进入审计。普通设备凭证不能删除云端账号数据。
  • 跨团队数据、D1、旧版历史记录与删除审计集中到独立认证的 /admin,从普通设置移除。
  • 新增团队配额表与审计表;旧表保留只读,不根据邮箱或账号名称猜测数据归属。团队配额历史按服务端时间保留 90 天。

官网、文档与质量

  • 中英文 README 更新团队创建、加入、数据边界、管理职责及真实设置截图;补充部署与隔离说明。
  • 官网新增英文首页、语言切换与演示文案本地化,更新站点地图、版本和团队入口说明;菜单栏配额环、指标间距、账号选择器和统计排版优化。
  • 同步上次发布说明到官网。
  • 新增跨团队读写/删除、成员身份、队列、请求与会话切换、原生创建/加入/退出及中英文界面回归覆盖;修复设置窗口测试的动画生命周期问题。

验证

后端 64 项测试通过;Swift 完整回归共 384 项,0 失败、5 项环境相关跳过;2 项真实 HTTP 集成测试通过。线上已验证匿名访问被拒绝,以及管理员登录、团队列表、旧数据和审计接口正常。

发布后线上核验补充:修复更新检查接口的版本字符串依赖遗漏,并验证 GitHub 不可用时的版本回退。此修复仅涉及服务端,不改变 DMG。

升级须知

旧版共享同步凭证不再接受。升级后在「设置 → 用量与团队」创建或加入团队继续共享;已有团队设备凭证可继续使用。本机统计不受影响,旧云端数据保留在管理员后台只读,不能自动归入新团队。创建或加入会启用两类共享,之后可以分别暂停。上报包含账号标签(可能含邮箱)和统计元数据,不包含供应商凭证或对话内容。

macOS 14+,Apple Silicon。应用使用 ad-hoc 签名,未进行 Apple 公证,首次打开可能需要按 README 的系统设置说明允许打开。

在 GitHub 查看版本与下载附件 ↗

v1.18.0 — 反馈、自助组队与更完整的用量视图

AI Quota Bar v1.18.0 — 反馈、自助组队与更完整的用量视图

汇总自 v1.17.1 发布以来的全部改动。macOS 14+,Apple Silicon,构建 40。

团队自助加入

  • 成员不再需要管理员逐台签发凭据:队长在官网 /team 页面创建团队并把邀请码发给成员,成员在"设置 → Codex 本机用量"里填入邀请码和名字即可加入。
  • 支持可选的成员口令:同一名字加入第二台 Mac 时需要口令;已加入的设备可以随时设置或更新口令。
  • 邀请码忽略大小写和空格;邀请码无效、名字被占用、设备已绑定、团队已满和触发限速时给出明确错误提示。
  • 加入后与原有绑定完全一致:可选把尚未归属的本机历史归属此成员,历史与上报行为不变。

App 内反馈

  • "设置 → 关于"新增反馈表单:昵称与联系方式可选,联系方式仅开发者可见,不会公开展示。
  • 提交后实时出现在官网反馈墙(/feedback),表单下方提供直达链接;网络错误、限速和内容校验均有明确提示。

Codex 订阅与账号

  • 每月日历在订阅续费/到期当天显示标记:虚线框表示自动续费,实线框表示到期不续费;仅接受与登录观测一致的网页账单元数据,不落盘、不上传,24 小时内有效。
  • 左键菜单把当前 Codex 账号固定在账号分组首位,并直接显示账号名;其余账号保持原有顺序。

用量视图

  • 趋势改为"本月 + 最近 24 小时":完整自然月日历(未来日期保留空位),最近 24 小时按 5 分钟一格共 288 格;菜单打开时每分钟自动推进,跨小时、跨月自动更新。
  • 估算成本仅在全部用量记录都有定价时显示,避免把未定价数据误读为零成本。
  • 本机用量卡片标签精简为"本机";设置页汇总数字对应本月。

服务商图标

  • 左键菜单分组名和设置侧栏改用各服务商真实品牌标识(Codex、GLM、Kimi、MiniMax),单色版本跟随菜单深浅色渲染,替代原来的通用符号。

官网与服务端

  • 新增公开反馈墙 /feedback 与 POST/GET /v1/feedback 接口:网页同源与 App Bearer 双入口,每小时每 IP 限 5 次,联系方式仅运营后台可见。
  • 新增 /team 自助团队页面与配套接口;运营后台新增反馈管理(完整列表、隐藏/恢复/删除)。
  • 首页演示与样式微调;sitemap 收录反馈页。

发布验证

  • App 测试:342 项,3 项依赖外部环境的测试跳过,0 失败。
  • 本机用量核心测试随 App 测试一并执行;Cloudflare 服务端测试 57 项通过;手机看板前端测试 35 项通过(其中横屏字号断言与 v1.17.1 的"大横屏限制字体继续放大"行为对齐)。
  • 构建使用 CodexBar revision b6e65a83dc471817b7ff7678e68e0204c9dd604f,与 v1.17.0 起固定的版本一致。

安装与范围

  • 下载 DMG 后将 App 替换到"应用程序"。公开版仍为 ad-hoc 签名,更新提示提供下载入口,不自动安装。
  • 已有设置、本机用量历史和云端绑定保留;尚未连接团队服务的设备不受影响。
在 GitHub 查看版本与下载附件 ↗

v1.17.1 — 趋势、任务与更轻的菜单

AI Quota Bar v1.17.1 — 趋势、任务与更轻的菜单

汇总自 v1.17.0 发布以来的全部改动。macOS 14+,Apple Silicon,构建 39。

用量与首次使用

  • Codex 本机用量改为固定近 30 天日历矩阵,下方展示今日小时小柱图;保留 Tokens、用量记录、缓存命中率、估算成本切换。
  • 左键菜单标题缩短为“本机用量 / Local usage”;仍只统计当前登录账号,历史账号选择保留在设置页。
  • 悬停沿用周期柱图的浮层样式,不再显示竖向选中线;未定价、零用量、日历空位及未来小时分别呈现。
  • 新设备未添加供应商时显示连接引导和可选示例预览,不自动请求未配置的 Codex。示例只在视图内生成,不进入存储、上报或告警。
  • 尚未生成 Codex 日志目录时视为正常空状态;实际读取故障继续报告。Codex 暂未运行时引导打开应用,保留历史查看入口。

凭据与更新

  • 成员上报凭据迁入共享钥匙串字典,与供应商、云同步和看板访问凭据共用缓存;旧凭据兼容迁移。
  • 缺失的旧条目缓存查询结果,拒绝访问和损坏数据不再触发后台重复读取;供应商设置的“连接帮助”提供显式重试。
  • 左键菜单 Settings 与 Quit 之间增加低强调新版提示;设置同步展示更新状态、下载和日志链接。
  • 发现的新版跨重启保留;并发检查去重,检查失败允许 15 分钟后重试,通知提交失败不记录为已提醒。
  • 下载仍使用 DMG 手动替换安装,不宣称自动安装。

图标与官网

  • App 图标采用菜单栏额度圆环和中央节奏指示的黑白灰设计。
  • 官网采用中性灰白背景,数据图表保留有意义的状态颜色。
  • 增加完整历史版本更新日志与搜索,并提供从 GitHub 同步发布说明的构建脚本。
  • 增加按 App 绘制规则实现的自检、空闲、单任务、多任务图标演示,可暂停并尊重减少动态效果设置。
  • 看板介绍扩展到同局域网可访问 Mac 的手机、平板、车机及其他电脑浏览器。

菜单与同步诊断

  • 移除左键菜单的服务商快捷暂停入口;暂停与恢复仍在供应商设置中管理。
  • 云端读取错误不再占据菜单空间;设置 → 同步显示当前状态,并增加本机同步日志入口。
  • 日志保留最近 200 条读取/上传结果,连续相同结果合并计数,可清空;记录错误代码,不保存 Token、请求地址或响应正文。
  • 仅启用云同步的新设备继续等待云端历史,不错误要求添加本机供应商。

更完整的官网与跨屏演示

  • 首页同时呈现左右键面板,独立介绍任务睡眠保护、可选合盖工作、线路测速切换及活跃连接。
  • 首页与更新日志统一使用 App 图标;圆环以真实菜单栏尺寸自动轮换自检、空闲、单任务和多任务,保留手动探索与暂停。
  • 官网本机用量演示同步为 30 天矩阵和今日小时柱,移除旧时间范围切换与暂停入口。
  • 浏览器看板同时展示横屏亮色与竖屏暗色,使用 App 的实际前端及独立示例数据。
  • 大横屏限制字体继续放大,为额度、任务与连接数据留出更多空间;手机原有自适应保留。
  • 仓库 About 补充官网链接与功能介绍。

安装与范围

  • 下载 DMG 后将 App 替换到“应用程序”。公开版仍为 ad-hoc 签名,更新提示提供下载入口,不自动安装。
  • 自助创建团队、邀请设备加入仍在规划中;本次不把已有的成员归属上报描述为完整自助团队系统。
在 GitHub 查看版本与下载附件 ↗

AI Quota Bar v1.17.0

AI Quota Bar v1.17.0

本次发布汇总 v1.16.0 发布以来的全部改动:从只看共享账号额度,扩展到本机 Codex 消耗与历史账号统计,并整合菜单、设置、云服务、运营后台和产品官网。

Codex 本机用量与历史

  • 从本机 Codex 的 sessions / archived_sessions 日志增量统计 Tokens、有效用量记录、缓存命中率与 API 等价值估算成本;支持今天按小时、7 天 / 30 天按天查看趋势。
  • 展示输入、输出、缓存读写、模型分布、解析异常和价格覆盖情况。SQLite 持久化解析缓存与待上传队列,重启后继续处理,避免每次重扫全部历史。
  • 对重复快照、归档副本、续页、分叉继承及累计值回退进行去重或异常处理;缺失父会话时暂缓统计,不猜测缺失用量。
  • 优先使用日志中的账号信息,缺失时参考连续的本机登录观测;无法确认归属的历史单独保留为“账号未知”,不会全部归到当前登录账号。
  • 支持导入带生效日期的模型单价。未知价格保留“未定价”,不伪装成零成本;估算并非供应商账单,记录数也不等于全部 HTTP 请求数。

菜单与设置

  • Codex 供应商置顶,本机统计与额度信息集中在同一组;左键菜单聚焦当前 Codex 账号,去掉历史账号选择器,历史账号在设置中查看。
  • 保留历史趋势,支持切换 Tokens / 用量记录 / 缓存命中率 / 成本并悬停查看时段数据;交互控件使用统一的中性色。
  • 新增统一“显示”设置,将菜单显隐、手机模型选择和图表样式整合为账号 / 模型矩阵,减少重复设置。
  • 账号总开关保留各模型的选择;手机维持 1–2 项限制;隐藏不影响采集、历史、告警或同步,暂不可用模型的已有选择仍保留。

成员与设备用量上报

  • 新增独立的成员 / 设备绑定和用量上报开关,设备凭据保存在钥匙串;后台支持设备凭据签发、轮换和撤销。
  • 支持按成员、设备、账号及时间范围查看统计;同一事件重复上传不重复计数,跨成员归属冲突隔离处理。
  • 持久化补传、网络失败退避和绑定切换保护;历史用量是否归属、补传由用户明确选择。
  • 当前仍需要管理员配置设备绑定。自助创建团队、一次性加入码和邀请加入流程尚未发布。

云服务与运营后台

  • 默认云端入口迁移到 https://ai-quota-bar.pages.dev,现有额度历史和用量数据保留;云端独立于旧部署资源运行。
  • 新增 /admin 运营后台,支持独立管理员登录、匿名安装设备数、日 / 周 / 月活、7 / 30 / 90 天趋势及 App / macOS 版本分布。
  • 匿名运营统计默认关闭,可在“设置 → 通用 → 隐私”开启或停止并删除本机统计;不采集 Codex 邮箱、对话内容或用量成本。
  • 启动或打开菜单 / 设置计为活跃,后台心跳不计入日活。匿名安装数不等于真实用户数,也不包含旧版本和未开启统计的设备。

官网与手机看板修复

  • 官网新增产品介绍和可交互的菜单、用量、显示设置及连接监控局部复现,全部用前端绘制,不使用截图。
  • 手机演示直接复用 App 的前端组件,以示例数据展示任务、配额、线路、连接及保护状态;演示不会读取访问者的 App 数据。
  • 重新梳理跨周期趋势、共享账号下的本机消耗、任务保护和连接诊断等核心功能,完善桌面和窄屏布局。
  • 修复手机看板状态条条目数量变化时的渲染异常,避免额度 / 保护信息更新导致后续线路和连接区域空白。

下载与升级

下载 AIQuotaBar.dmg,将 App 拖入“应用程序”替换旧版。系统要求 macOS 14+,发布制品为 Apple Silicon(arm64),版本 1.17.0(build 35)。原有设置和本地历史保留;首次读取大量 Codex 历史可能需要数分钟。

公开 DMG 延续 ad-hoc 签名,未经过 Apple 公证。如首次打开被 macOS 拦截,可在“系统设置 → 隐私与安全性”按系统提示允许。升级后读取原钥匙串凭据可能需要再次授权。

更新检查仍采用现有的定期检查 / 系统通知与设置中的手动检查,下载跳转到 GitHub Release;本次没有引入自动安装器或左键菜单更新横幅。

发布验证

  • App 测试:319 项,3 项依赖外部环境的测试跳过,0 失败。
  • 本机用量核心测试:28 项,未启动本地 HTTP 测试服务时跳过 1 项,0 失败。
  • Cloudflare 服务端:36 项通过;手机看板前端:35 项通过。
  • 构建使用 CodexBar revision b6e65a83dc471817b7ff7678e68e0204c9dd604f,源码构建说明已固定该版本。
  • 另行启动本地 Worker 后,Swift 客户端真实 HTTP 集成测试通过(身份绑定、重复上传去重和汇总)。
  • DMG 挂载后版本、build、二进制一致性、深度签名和镜像完整性均验证通过。
  • AIQuotaBar.dmg SHA-256:a5707c7c4affb4407cb84f7f82800eda3c55f6397e03cd28e9e0d0a45eeadafc。
在 GitHub 查看版本与下载附件 ↗

AI Quota Bar v1.16.0

AI Quota Bar v1.16.0

本版本支持自由组合菜单栏 Ring 服务商,并补齐 MiniMax 与 GLM 的额度环显示。

Ring 自由组合

  • 将显示方式与服务商选择分开:常驻显示或工作感知,搭配 Codex、Kimi、MiniMax、GLM 多选。
  • 支持仅显示 MiniMax + GLM、单独 GLM 等组合,并提供全选操作。
  • 原“全部”和“工作感知”迁移为全部服务商;原单家选择保留为对应组合。
  • 关闭的供应商从 Ring 选项及全选中排除,重新启用后恢复为可选项。
  • 至少保留一家已启用的选择,关闭的供应商不再错误计入这一检查。

额度与活动显示

  • MiniMax 和 GLM 无需任务检测即可显示最新剩余额度,随现有额度刷新机制更新。
  • GLM 优先显示 5 小时额度,避免误取周窗口;耗尽至 0% 时仍保留空环。
  • 工作感知下,选中的 MiniMax、GLM 常驻;Codex/Kimi 显示活跃服务商,空闲时保留选中范围内剩余额度最少的一家。
  • 没有可展示额度时保留状态入口,不将缺失数据误报为正常额度。
  • 中英文设置文案与项目说明同步更新,并补充 GLM Ring 能力调研记录。

安装说明

要求 macOS 14 或更高版本,预编译 DMG 面向 Apple Silicon。

公开 DMG 使用 ad-hoc 签名,未经过 Apple 公证。首次打开如被 Gatekeeper 拦截,请按住 Control 点击应用并选择“打开”,或前往“系统设置 → 隐私与安全性”允许打开。不要全局关闭 Gatekeeper。

发布校验

  • Swift 完整测试:311 项执行,3 项跳过,0 失败。
  • Mobile Dashboard 前端测试:34 项通过。
  • Cloudflare Worker 测试:10 项通过。
  • 制品版本:1.16.0(build 33)。
  • 架构:Apple Silicon(arm64)。
  • 应用深度签名与 DMG 完整性校验通过。
  • AIQuotaBar.dmg SHA-256:765f7fbc56f0a4d85b8709b50e4e10bbadd8d1b89e2a49cc08d270bec08f2582。
在 GitHub 查看版本与下载附件 ↗

AI Quota Bar v1.15.0

AI Quota Bar v1.15.0

本版本新增 GLM Coding Plan 配额监控,并重新整理服务商凭据输入体验。

GLM Coding Plan

  • 在服务商设置中新增 GLM,可与 Codex、Kimi 和 MiniMax 一起刷新和展示。
  • 个人套餐可直接填写 Coding Plan API Key;也兼容从用量页面复制的 quota/limit cURL 请求。
  • 支持新版 5 小时与周积分额度,正确区分周期、剩余积分、套餐等级和重置时间。
  • 兼容旧版 Tokens 与 MCP/Search 额度响应;空数据和无效响应不会被误报为连接成功。
  • 凭据继续保存在 macOS 钥匙串,历史网页凭据可无损编辑和重新保存。

服务商凭据设置

  • API Key 输入统一为原生密码框,尺寸、间距和按钮层级更符合 macOS 设置界面。
  • 新增显示或隐藏凭据、从剪贴板粘贴和撤销修改操作。
  • 仅在内容发生变化时启用保存按钮;保存后自动恢复隐藏状态。
  • 测试进度与成功或错误反馈采用稳定的独立布局,不再挤压操作按钮。

安装说明

要求 macOS 14 或更高版本,预编译 DMG 面向 Apple Silicon。

公开 DMG 使用 ad-hoc 签名,未经过 Apple 公证。首次打开如被 Gatekeeper 拦截,请按住 Control 点击应用并选择“打开”,或前往“系统设置 → 隐私与安全性”允许打开。不要全局关闭 Gatekeeper。

发布校验

  • Swift 完整测试:309 项执行,3 项跳过,0 失败。
  • Mobile Dashboard 前端测试:34 项通过。
  • Cloudflare Worker 测试:10 项通过。
  • 制品版本:1.15.0(build 32)。
  • 架构:Apple Silicon(arm64)。
  • 应用深度签名与 DMG 完整性校验通过。
  • AIQuotaBar.dmg SHA-256:82739d36b2b727587a52a3f694c643fba8203d8918d8957eed3b70b1774cd787。
在 GitHub 查看版本与下载附件 ↗

AI Quota Bar v1.14.0

AI Quota Bar v1.14.0

本版本新增服务商暂停能力,并统一手机仪表盘的状态信息展示。暂停服务商不会删除凭据,可随时恢复使用。

暂停单个服务商

  • 在服务商设置中可关闭「使用此服务商」,暂停该服务商的配额刷新、菜单显示、阈值提醒和任务合盖保护,同时保留已有凭据。
  • 菜单中的服务商标题旁新增快捷暂停按钮;设置列表会用暂停图标标记已停用项。
  • 暂停状态会持久保存;重新启用后立即刷新数据。
  • 固定菜单栏服务商被暂停时自动回退到其他启用中的服务商;所有已配置服务商均暂停时显示明确的恢复指引。
  • 正在刷新时发生的重复刷新请求会在当前请求完成后补跑一次;请求途中被暂停的服务商结果不会重新写回界面。

手机仪表盘状态整合

  • 「Protection / 保护」区块更名为「Status / 状态」,更准确地覆盖任务保护和配额状态。
  • 配额错误改为红色状态项并入滚动状态栏,不再占用配额卡片上方的独立空间。
  • 无标签的状态项自动隐藏空标签,保持紧凑排版。

安装说明

要求 macOS 14 或更高版本,预编译 DMG 面向 Apple Silicon。

公开 DMG 使用 ad-hoc 签名,未经过 Apple 公证。首次打开如被 Gatekeeper 拦截,请按住 Control 点击应用并选择“打开”,或前往“系统设置 → 隐私与安全性”允许打开。不要全局关闭 Gatekeeper。

发布校验

  • Swift 完整测试:301 项执行,3 项跳过,0 失败。
  • Mobile Dashboard 前端测试:34 项通过。
  • Cloudflare Worker 测试:10 项通过。
  • 制品版本:1.14.0(build 31)。
  • 架构:Apple Silicon(arm64)。
  • 应用深度签名与 DMG 完整性校验通过。
  • AIQuotaBar.dmg SHA-256:1a77199eb5fc672d68f54f17f2a1483a82b4727f1bc455112c35149a26496d3a。
在 GitHub 查看版本与下载附件 ↗

AI Quota Bar v1.13.0

AI Quota Bar v1.13.0

本版本汇总 v1.12.2 之后的周期结束对齐刷新、菜单面板图表修复、手机仪表盘按任务来源适配、云同步读取重试与合盖模式可观测性增强。

周期结束自动对齐刷新

  • 5 小时窗 / 周窗的结束时间很少恰好落在 10 分钟轮询点上:现在任一周期结束后 15 秒会自动刷新一次,随后常规轮询从该时刻重新起算,新周期数据第一时间到位。
  • 仅对当前可实际拉取的本地 provider 生效(如 Codex 未运行时其模型不参与排程),云端同步来的模型数据不触发该机制。

菜单面板图表修复

  • 云端数据瞬时拉取失败时保留上次样本,曲线图不再突然消失。
  • 曲线图无数据时不再保留固定高度的空白容器,面板高度随内容自适应收缩。
  • 悬停历史周期的曲线预览按该周期自身用量着色;当前周期余量不足触发的橙色警示不再串到历史周期预览上。

手机仪表盘按任务来源适配

  • 只有 Kimi 任务在跑时:Kimi 配额卡片自动前置,隐藏仅统计 OpenAI 域名的连接区块和代理路由区块,标题改为「Kimi 活动」。
  • 仅 Codex 任务或混合任务时保持原有完整展示;无任务运行时全部区块照常展示。
  • 快照 schema 升级至 v4,新增 activeProviders 字段,旧版快照兼容解析。

云同步读取自动重试

  • 读取路径对超时、DNS 失败、TLS 中断、连接丢失等瞬态网络错误按指数退避自动重试,与写入路径行为对齐;4xx/5xx 服务端错误不可自愈,立即报错。
  • 网络错误提示统一为明确的中文文案(如"请求超时:到同步服务器的链路不通,请检查代理是否覆盖该域名")。

合盖模式可观测性

  • App 与特权 helper 增加 OSLog 日志:租约获取 / 释放 / 过期、SleepDisabled 被外部工具清除后重新断言等关键事件均可在控制台检索(subsystem com.techfanseric.aiquotabar / .sleep-helper)。
  • helper 租约清扫周期由 15 秒缩短为 5 秒,外部电源管理工具改写 disablesleep 造成的冲突窗口更短。

安装说明

要求 macOS 14 或更高版本,预编译 DMG 面向 Apple Silicon。

公开 DMG 使用 ad-hoc 签名,未经过 Apple 公证。首次打开如被 Gatekeeper 拦截,请按住 Control 点击应用并选择“打开”,或前往“系统设置 → 隐私与安全性”允许打开。不要全局关闭 Gatekeeper。

发布校验

  • Swift 完整测试:301 项执行,3 项跳过,0 失败。
  • Mobile Dashboard 前端测试:33 项通过。
  • Cloudflare Worker 测试:10 项通过。
  • 制品版本:1.13.0(build 30)。
  • 架构:Apple Silicon(arm64)。
  • 应用深度签名与 DMG 完整性校验通过。
  • AIQuotaBar.dmg SHA-256:5ac5811523f756de59e774968f6d86b3941f5a9dd7ddc95c5e48dd19408f3c67。
在 GitHub 查看版本与下载附件 ↗

AI Quota Bar v1.12.2

AI Quota Bar v1.12.2

本版本汇总 v1.11.0 之后的图表时间轴规范统一、本地样本缓存、历史周期预览、云端状态诊断与睡眠保护加固。

图表时间轴按自然边界对齐

  • 多日窗口的分隔线按本地 0:00 对齐(原为周期起点 + 24 小时),一眼看出是哪一天。
  • 单日窗口(如 5 小时)的分隔线按本地自然整点对齐(原为起点 + N 小时)。
  • 悬停时只给完整落在窗口内的时段标注:多日窗口在当天正午居中显示 MM/dd,单日窗口在该小时半点居中显示 3PM 式标签;窗口两端不完整的时段不标注。
  • 跨天进度条(周窗口)悬停时同样只标注完整自然日,居中于当天正午。

本地样本缓存

  • 消耗样本改为合并式写入并保留 90 天,重装新版或重启后历史曲线不再丢失。
  • 每个模型的样本量设上限并自动裁剪最旧数据,缓存体积可控。

历史周期悬停预览

  • 悬停跨周期 utilization 柱图中的任意历史周期,曲线图即时切换为该周期的消耗曲线预览;移开即恢复当前周期。

云端同步状态诊断

  • 云同步错误分类提示:网络超时、DNS/连接失败与 D1 配额耗尽分别给出明确文案,不再笼统显示"请求超时"。
  • 同步设置页新增 D1 当日用量状态行(读取行数 / 每日限额),按 50% / 80% 阈值显示绿 / 黄 / 红。
  • 配套 Worker 新增 /v1/d1-usage 只读用量接口(Cloudflare GraphQL 分析数据源,5 分钟边缘缓存),默认云端已部署;自托管用户需要按 cloudflare/README.md 配置 CF_API_TOKEN 等开关,单独更新 Mac App 不会升级自托管后端。

睡眠保护加固

  • 任务结束后保留电源断言和合盖租约 5 分钟宽限期,回合间隙和活动检测抖动不再导致任务中途睡眠。
  • XPC 瞬时断连不再立即释放合盖租约,改为依赖租约自然过期。
  • 发现内核 SleepDisabled 标志被外部清除(如其他工具或电源切换)时自动重新断言。
  • 心跳租约按协商超时延长,屏保用户活动每 45 秒刷新。

安装说明

要求 macOS 14 或更高版本,预编译 DMG 面向 Apple Silicon。

公开 DMG 使用 ad-hoc 签名,未经过 Apple 公证。首次打开如被 Gatekeeper 拦截,请按住 Control 点击应用并选择“打开”,或前往“系统设置 → 隐私与安全性”允许打开。不要全局关闭 Gatekeeper。

发布校验

  • Swift 完整测试:293 项执行,3 项跳过,0 失败。
  • Mobile Dashboard 前端测试:32 项通过。
  • Cloudflare Worker 测试:10 项通过。
  • 制品版本:1.12.2(build 29)。
  • 架构:Apple Silicon(arm64)。
  • 应用深度签名与 DMG 完整性校验通过。
  • AIQuotaBar.dmg SHA-256:bf1bea33cbaf4d14099f528d4e893714e68d42fec47fd54773caf77235691723。
在 GitHub 查看版本与下载附件 ↗

AI Quota Bar v1.11.0

AI Quota Bar v1.11.0

本版本汇总 v1.10.0 之后的图表样式设置、云同步重试修复与 D1 读写优化。

按模型选择图表样式

  • 在用量设置中,为每个模型选择自动、面积图或进度条。
  • 设置保存在本机,重启后保留;切回自动会清除该模型的手动覆盖。
  • Mac 菜单与 Mobile Dashboard 使用同一套偏好,并提供中英文文案。

云同步客户端

  • 修复客户端错误被通用异常处理重新捕获、导致无效重试的问题。
  • 遇到明确的 D1 每日读写配额错误时,停止同一轮重试;临时网络故障和普通服务端错误保留原有退避重试。
  • 账号摘要仅在接口返回 404 时回退读取最新快照;空结果、格式错误或普通服务端错误不再触发额外读取。
  • 正常刷新频率、上传内容与历史保留策略不变。

配套后端降读写

  • 通过触发器维护小型最新快照指针表,避免最新数据查询扫描全部历史。
  • 全局历史查询先按设备限量,再合并选取最新结果;过期清理使用已有设备/时间索引。
  • 完全相同的快照上传不再重复写入样本或设备心跳。
  • 默认云端已完成迁移与发布。自托管用户需要按 cloudflare/README.md 执行迁移并配置开关;单独更新 Mac App 不会升级自托管后端。

生产环境验证中,最新数据 SQL 读取 176 行、写入 0 行,API 返回 24 个样本。本地 20 万行基准的全扫描步数从 399,998 降到 838,约减少 99.79%;这是本地查询基准,不代表生产账单同比降幅。

已有的账号级 D1 当日用量不会因升级清零;配额耗尽时,历史查询仍可能受限,需要等待重置或另行调整配额。本版本不变更套餐。

安装说明

要求 macOS 14 或更高版本,预编译 DMG 面向 Apple Silicon。

公开 DMG 使用 ad-hoc 签名,未经过 Apple 公证。首次打开如被 Gatekeeper 拦截,请按住 Control 点击应用并选择“打开”,或前往“系统设置 → 隐私与安全性”允许打开。不要全局关闭 Gatekeeper。

发布校验

  • Swift 完整测试:280 项执行,3 项跳过,0 失败。
  • Mobile Dashboard 前端测试:32 项通过。
  • Cloudflare Worker 测试:6 项通过。
  • 制品版本:1.11.0(build 26)。
  • 架构:Apple Silicon(arm64)。
  • 应用深度签名与 DMG 完整性校验通过。
  • AIQuotaBar.dmg SHA-256:dcaa6f3210746aea1c86e8d269282a41e9e54a5c227f5f72ba534e002859c026。
在 GitHub 查看版本与下载附件 ↗

AI Quota Bar v1.10.0

AI Quota Bar v1.10.0

v1.10.0 重点解决紧凑菜单栏在任务动画期间的持续高 CPU,同时完善多 Provider、配额预测和 Clash 线路筛选体验。

紧凑菜单栏性能与视觉

  • 活跃任务动画保持 15 FPS。
  • 使用预渲染的完整多 Provider 帧和 NSStatusBarButton.image 专用路径,避免每帧重绘、快照整个自定义视图。
  • 发布机器实测活跃动画 CPU 从约 54–62% 降至多数 8–10%。
  • Retina 离屏绘制使用正确的 2× 坐标变换,圆环恢复原始点尺寸、间距与对齐。
  • 悬停继续显示 Provider 首字母;悬停期间使用静态预渲染帧,不产生额外持续绘制。
  • 对角 pace 分隔线与竖向小时/天状态使用一致的颜色。

多 Provider 与配额判断

  • 工作感知选择可同时展示 Codex 与 Kimi 的独立圆环。
  • Kimi 活跃任务纳入菜单栏工作状态与睡眠保护。
  • 新增配额消耗预测,并完善 reserve / deficit 周期表达。

Clash 线路筛选

  • 已保存的线路筛选默认以只读摘要展示,避免打开面板后误编辑。
  • 主动点击后进入编辑模式,可切换正则表达式并明确完成编辑。
  • 中英文文案、关闭面板后的编辑状态复位及对应测试均已补齐。

安装说明

本版本要求 macOS 14 或更高版本,预编译 DMG 面向 Apple Silicon。

公开 DMG 使用 ad-hoc 签名,未经过 Apple 公证。首次打开时如被 Gatekeeper 拦截,请按住 Control 点击应用并选择“打开”,或前往“系统设置 → 隐私与安全性”允许打开。不要全局关闭 Gatekeeper。

发布校验

  • 完整测试:266 项执行,3 项跳过,0 失败。
  • 制品版本:1.10.0(build 25)。
  • 架构:Apple Silicon(arm64)。
  • DMG 与应用深度签名校验通过。
  • AIQuotaBar.dmg SHA-256:d2006caae4684b7ab4f4a688ffff692140038da7a128ea076cd1d9c58238c726。
在 GitHub 查看版本与下载附件 ↗

AI Quota Bar v1.9.0

本次更新

v1.9.0 加入 Kimi Code 配额支持、左键菜单展示自定义,并修复超大 Codex 日志可能导致活跃任务少计的问题;同时优化了 Mobile Dashboard 的紧凑布局与 OLED 空闲屏。

Kimi Code 配额

  • 新增 Kimi Code 供应商,展示 5 小时与 Weekly 配额、重置倒计时和配额曲线。
  • 未配置 API Key 时,在本地 PTY 中启动真实 Kimi Code CLI 并发送 /status;不使用 kimi -p,不会创建模型对话或消耗上下文 Token。
  • 短期 OAuth 凭证的刷新继续交给官方 CLI,避免应用直接操作轮换中的 access/refresh token。
  • 首次运行时只信任应用专用的空状态查询目录,不要求信任用户项目目录。
  • 仍支持可选的 Kimi Code API Key,并安全保存在 macOS 钥匙串。
  • Kimi 可固定在菜单栏,也可由自动模式按需展示。

配额菜单与曲线

  • 可按账户、按具体配额周期控制左键菜单显示内容。
  • 隐藏仅影响左键菜单,不会关闭后台刷新、历史记录、提醒、云同步或菜单栏固定展示。
  • 可一键恢复显示全部项目。
  • 改进配额曲线回退逻辑:供应商周期元数据不完整时,明确存在的 5 小时额度仍会保留并优先展示。

Codex 活跃任务可靠性

  • 修复 rollout 日志很大时偶发少计一个活跃任务的问题。
  • 检测器现在会先以有界内存恢复日志生命周期状态,再读取最近 16 MB 的详细尾部数据;即使任务开始事件落在尾部窗口之外,也能正确识别。
  • 超长单行会跳过而不会造成内存失控,并新增超大日志回归测试。

Mobile Dashboard

  • 重新收紧移动端布局,尤其改善小尺寸横屏下的空间利用率。
  • Activity、Route 与 Connections 状态区在横屏下更均衡地使用可用高度。
  • 确认空闲后切换到独立的纯黑 OLED 屏保,以单个超大 IDLE 字样缓慢变换位置,减少静态烧屏风险。
  • 空闲屏、遥测轨道、事件流和动画继续采用有界生命周期,并兼容“减少动态效果”。

文档与质量

  • 更新中英文 README、Kimi 配置方式、隐私边界与 v1.9.0 说明。
  • 新增 Kimi /status 解析、现场凭证、左键菜单偏好、Codex 超大日志和 5 小时曲线回退测试。
  • 版本升级至 v1.9.0 (build 24)。

验证

  • Swift:241 项测试,3 项按环境跳过,0 失败。
  • Mobile Dashboard:32/32 前端测试通过。
  • Kimi 现场测试:真实 CLI /status 成功,0 失败。
  • DMG 校验、挂载、版本、arm64 架构及深度签名验证均通过。

安装要求

  • macOS 14 Sonoma 或更高版本。
  • 本次预编译 DMG 面向 Apple Silicon。
  • 公开构建采用 ad-hoc 签名,未经过 Apple 公证;首次启动可能需要按住 Control 点击应用并选择“打开”,或在“系统设置 → 隐私与安全性”中允许。

SHA-256

9e6b025634b6a120adc9e2e59b028e1dc157ac0ca12d0a98d7c1ce6e5a8e3ef1

在 GitHub 查看版本与下载附件 ↗

AI Quota Bar v1.8.1

AI Quota Bar v1.8.1

v1.8.1 修复 Mobile Dashboard 的全屏 IDLE 弹幕布局,让字幕轨道真正覆盖整个视口。

修复内容

  • 将 7 条 IDLE 字幕轨道改为稳定的全屏网格布局,从顶部到底部均匀铺开。
  • 修复部分 Chrome 版本不支持 calc() 除法、导致所有轨道回落并堆叠在顶部的问题。
  • 保留不同字号、速度、透明度、错峰动画与“减少动态效果”支持。
  • 增加回归测试,防止再次使用不兼容的轨道定位方式。

安装说明

本版本要求 macOS 14 或更高版本,预编译 DMG 面向 Apple Silicon。

公开 DMG 使用 ad-hoc 签名,未经过 Apple 公证。首次打开时如被 Gatekeeper 拦截,请按住 Control 点击应用并选择“打开”,或前往“系统设置 → 隐私与安全性”允许打开。

发布验证

  • Swift 测试执行 228 项,其中 2 项按环境条件跳过、零失败。
  • Mobile Dashboard 前端测试 32/32 通过。
  • Release 构建、Hook、特权辅助程序和 DMG 制作成功。
  • DMG 完整性及应用深度签名验证通过。
  • 镜像内版本:1.8.1 (23);架构:arm64。
  • DMG SHA-256:89b169adae848581d6ee4d807e706ea51eb73eede0f6999776ef03bf9a4830ba。
在 GitHub 查看版本与下载附件 ↗

AI Quota Bar v1.8.0

AI Quota Bar v1.8.0

v1.8.0 新增了安全、可安装的 Mobile Dashboard,让手机或同一局域网内的另一块屏幕可以持续观察配额、Codex 任务、线路、连接与睡眠保护状态。

从手机查看完整运行状态

  • 在“Settings → Mobile Dashboard”启用本地仪表盘,通过二维码打开并安装 PWA。
  • 最多选择两个配额模型,复用 Mac 端的配额曲线、重置周期和节奏判断。
  • Codex Activity、Route 与 Connections 在横屏和竖屏下接近三等分,并随分辨率整体缩放。
  • 页面通过实时事件流更新,同时显示当前保护状态、活跃连接、最近线路和最长连接时长。
  • 支持自动、浅色和深色外观、OLED 位移保护,以及需要用户主动开启的实验性屏幕唤醒媒体。

更真实、更可读的 Task telemetry barrage

  • 1 至 5 个活跃 Task 精确对应 1 至 5 行弹幕,每一行只显示同一个任务的信息。
  • 可逐项选择标题、状态、阶段、项目、Git 分支、来源、模型、模型提供商、推理强度、沙箱、审批模式、Token、子任务、时间、CLI 版本、工具、最近事件和进展等字段。
  • 每个任务的字段顺序独立随机,但实时数据更新时保持稳定,不会引起字幕跳动。
  • 五档速度为 48 / 40 / 34 / 29 / 25 px/s:新任务更快,运行时间更久的任务更慢,差异清楚但仍便于阅读。
  • 新字幕接入当前轨道队列,不会重置滚动位置;单任务时字号会接近 Codex Activity 区块高度。
  • 确认进入 IDLE 后,可切换为纯黑白、多行、大小和速度各异的全屏字幕屏保。

本地访问与隐私安全

  • 提供稳定本地主机名和明确的 IP 备用地址,并支持当前网络地址变化后的重新连接。
  • 可选启用五分钟过期的手动配对码;配对后换取可撤销、绑定 Origin 的安装凭证,凭证不会留在保存的 URL 中。
  • 默认隐藏账户名称;Task 进展文字只有在要求手动配对并再次明确开启共享后才会离开 Mac。
  • 本地服务器采用严格 Host/Origin/CORS/CSP 校验、请求大小限制、配对速率限制和有上限的查看器数量。
  • 供应商凭证、云同步 Token 与 Mobile Dashboard Token 统一迁移到带版本、可恢复的 Keychain 凭证保险库。

长时间运行与兼容性

  • Codex 生命周期读取扩展为逐任务遥测,并覆盖 38 个 CLI 版本族的代表性记录格式。
  • 弹幕字段更新保留动画相位;任务数量变化时显式释放旧 Animation 和 DOM 节点。
  • 轨道队列、IDLE 特效、SSE 连接、定时器、连接轮询与重连状态均采用有界生命周期。
  • 浏览器压力测试连续 30 轮 5 → 1 → 5 后,DOM 节点保持 772 → 772、事件监听保持 32 → 32,并维持精确的 5 条轨道动画。
  • 遵循系统“减少动态效果”设置。

安装说明

本版本要求 macOS 14 或更高版本,预编译 DMG 面向 Apple Silicon。

公开 DMG 使用 ad-hoc 签名,未经过 Apple 公证。首次打开时如被 Gatekeeper 拦截,请按住 Control 点击应用并选择“打开”,或前往“系统设置 → 隐私与安全性”允许打开。不要全局关闭 Gatekeeper。

发布验证

  • Swift 测试执行 228 项,其中 2 项按环境条件跳过、零失败。
  • Mobile Dashboard 前端测试 32/32 通过。
  • Release 构建、Hook、特权辅助程序和 DMG 制作成功。
  • DMG 完整性及应用深度签名验证通过。
  • 镜像内版本:1.8.0 (22);架构:arm64。
  • DMG SHA-256:5c839ede27ee124c15c2a5cbc5614e89a7a782c8683200600bf2828a95c81932
在 GitHub 查看版本与下载附件 ↗

AI Quota Bar v1.7.0

AI Quota Bar v1.7.0

v1.7.0 的重点,是让菜单栏用更少的信息、更清楚地告诉你两件事:Codex 任务是否仍在工作,以及 OpenAI 当前应该换线路还是继续等待。

不打开菜单,也知道 Codex 还在工作

  • 没有活跃任务时,剩余配额环保持 100% 实色,方便判断配额。
  • 有任务运行时,基础环降为 60%,更容易看到沿剩余配额部分逆时针流动的能量波。
  • 每个活跃任务对应一道波,最多显示五道;五个以上任务仍保持五道,避免 22pt 菜单栏图标变得拥挤。
  • 波头最实,顺时针方向的长尾逐渐透明,既能看出运动方向,也不会变成突兀的圆点。
  • 能量波绝不会进入已经消耗的配额段。
  • 开启 macOS“减少动态效果”时,应用会保留静态任务提示。

左键配额面板恢复真正的 macOS 原生体验

  • 左键面板重新使用系统 NSMenu,恢复原生半透明材质、阴影、圆角和菜单行为。
  • 面板会根据当前菜单栏图标所在的显示器计算可用高度,减少外接屏、上下排列屏幕或不同菜单栏尺寸造成的错位。
  • 左键与右键入口会在打开另一侧前主动收起,避免两个面板重叠。

右键控制中心更紧凑、更容易扫读

  • 右键面板采用统一宽度、圆角和无三角箭头的边界,不再依赖不同系统环境下位置不稳定的 Popover 箭头。
  • 自动恢复开关固定靠右,说明文字保持靠左。
  • 线路改为单行布局,并用 H2、VL、TLS、SS 等标识快速区分协议。
  • 线路和活跃连接列表保留最小浏览高度,数据较少时不会缩成几乎看不见的一行。
  • 最近三次换线记录把“从哪里切到哪里”放在左侧;一小时内使用 59m ago 这类相对时间,较早记录显示具体时间。
  • 没有换线记录时,历史区域自动收起,不浪费空间。

更快判断 OpenAI 连接是否健康

  • 下载、上传和连接总数保持在图表上方,打开面板即可确认是否真的有数据流动。
  • 连接年龄图例直接放进图表标题行,以 New → Old 表示从新连接到长连接的颜色变化。
  • 活跃连接详情从 TCP 等协议字段开始,不再显示没有判断价值的未知进程占位文本。
  • 监控仍然只读取 openai.com 与 chatgpt.com 的活跃连接,不会关闭连接或修改 Clash 配置。

界面预览

AI Quota Bar v1.7.0 控制中心

安装说明

本版本要求 macOS 14 或更高版本,预编译 DMG 面向 Apple Silicon。

公开 DMG 使用 ad-hoc 签名,未经过 Apple 公证。首次打开时如被 Gatekeeper 拦截,请按住 Control 点击应用并选择“打开”,或前往“系统设置 → 隐私与安全性”允许打开。不要全局关闭 Gatekeeper。

发布验证

  • 默认测试套件执行 119 项,其中 117 项通过、2 项按环境跳过、零失败。
  • 2 项默认关闭的本机 Clash 实时流与界面测试已额外启用并通过。
  • Release 构建、Hook、特权辅助程序和 DMG 制作成功。
  • DMG 完整性及应用深度签名验证通过。
  • 镜像内版本:1.7.0 (21);架构:arm64。
  • DMG SHA-256:ec8e8b9b4a4e6e8a1b05ddbd0c86d60576201a83502eba9d3f43128e7a5abac4
在 GitHub 查看版本与下载附件 ↗

AI Quota Bar v1.6.0

AI Quota Bar v1.6.0

v1.6.0 的重点,是让长时间使用 Codex 和 ChatGPT 变得更省心:任务运行时不再担心 Mac 意外睡眠,连接变慢或中断时也不用来回切换 Clash 查原因。

让 Codex 长任务安心跑完

  • AI Quota Bar 会显示当前正在工作的 Codex 任务数量。
  • 只在任务运行期间保持显示器、阻止屏保和系统空闲睡眠;任务全部完成后自动恢复正常。
  • 多个任务同时运行时会分别计数,不会因为其中一个先结束就提前停止保护。
  • 如果偶尔需要合上 MacBook 仍让任务继续,可以单独开启合盖模式。第一次使用需要管理员授权,但不要求 Apple Developer 身份。
  • 合盖模式会在任务完成、应用失去联系、电量过低、机器过热、用户关闭或达到 12 小时上限时恢复原来的睡眠设置。

更快判断 OpenAI 为什么慢

  • 右键面板只展示 openai.com 与 chatgpt.com 的活跃连接,其他流量不会干扰判断。
  • 可以直接看到总下载速度、总上传速度和当前连接数。
  • 最近 60 分钟图表让连接高峰、空白时段和持续较久的连接更容易被发现。
  • 每个连接对应一个色块:新连接为绿色,持续越久越接近橙色。
  • 连接列表会在数据可用时展示域名、应用、线路、持续时间和速度。
  • 所有连接监控都是只读的,不会关闭连接或改动 Clash 配置。

OpenAI 断线时少做几步

  • 线路和活跃连接现在直接上下排列,不需要切换标签页。
  • 右键面板更窄,但线路与连接列表仍保留足够的浏览空间。
  • 最近三次换线记录会简短显示;没有记录时不会浪费高度。
  • 继续支持 🇯🇵、日本、JP 等国家筛选,也可以用正则精确匹配线路名。
  • 可以手动选择线路,也可以在真正断线时,让应用从筛选结果中选择延迟最低的线路。

自动恢复仍然很克制:打开面板、点击测速或打开开关都不会换线。只有 openai.com 与 chatgpt.com 连续两轮同时不可达时才会开始恢复;连接成功后立即停止并发送系统通知。

日常使用更稳定

  • 减少启动时等待系统钥匙串的情况,让菜单更快出现。
  • 升级应用时会先停止旧版本,再完整替换应用包并重新启动,降低覆盖运行中应用造成异常的概率。
  • 补充了任务检测、睡眠保护、连接历史、线路历史和界面布局等自动化测试。
  • README 现已提供完整中英文说明,并清楚解释安装方式、隐私边界和合盖使用注意事项。

安装说明

本版本要求 macOS 14 或更高版本,预编译 DMG 面向 Apple Silicon。

公开 DMG 使用 ad-hoc 签名,未经过 Apple 公证。首次打开时如被 Gatekeeper 拦截,请按住 Control 点击应用并选择“打开”,或前往“系统设置 → 隐私与安全性”允许打开。不要全局关闭 Gatekeeper。

界面预览

AI Quota Bar v1.6.0 控制中心

发布验证

  • 101 项自动化测试通过,零失败。
  • 2 项默认关闭的本机 Clash 实时流与界面测试已额外启用并通过。
  • Release 构建、Hook、特权辅助程序和 DMG 制作成功。
  • DMG 完整性及应用深度签名验证通过。
  • 镜像内版本:1.6.0 (20);架构:arm64。
  • DMG SHA-256:b518eebfcb4c5bb9fb6ed2c052e96d6f3d647594f77c825ba0b87628a4116632
在 GitHub 查看版本与下载附件 ↗

AI Quota Bar v1.5.0

重磅更新:OpenAI 路由自动恢复

右键菜单栏图标即可直接管理 OpenAI 路由,无需切回 Clash:

  • 自动发现 Clash Verge Rev、Mihomo 或 Clash 的本地控制器。
  • 自动定位承载 openai.com / chatgpt.com 规则的可切换策略组。
  • 打开面板后自动测速,按延迟从低到高排列线路。
  • 支持国家别名筛选,例如 🇯🇵、日本、JP;也可启用正则表达式进行锚点、开头结尾和或关系匹配。
  • 可在列表中手动切换任意线路。

OpenAI 路由面板

保守的自动恢复逻辑

自动切换只会在 openai.com 与 chatgpt.com 连续两轮同时不可达时触发。触发后会测速筛选结果,从最低延迟候选开始切换,并在每次切换后重新检查连通性;恢复成功后发送 macOS 系统通知。

打开面板、点击“重新测速”或勾选自动恢复开关都不会主动切换线路,从而避免频繁换线。自动恢复必须设置非空且有效的筛选条件。

兼容与安全

  • 支持 Clash Verge Rev、Mihomo 与 Clash 的标准 external controller API。
  • 只接受绑定到 127.0.0.1、localhost 或 ::1 的控制器;远程控制器地址会被拒绝。
  • 要求 macOS 14 或更高版本。

验证

  • 从标签对应的干净提交构建。
  • 57 项自动化测试全部通过。
  • DMG 完整性、应用代码签名及镜像内外二进制一致性均已验证。
  • DMG SHA-256:251a0e3ccac9751e74e9d9e2aacbacaf6b8226f4ff8d1e56e65c5ba0d8970977
在 GitHub 查看版本与下载附件 ↗

v1.4.10

更新内容

  • 重做 Codex 紧凑环:外环显示 Weekly 剩余,内圆区分 deficit、on pace 与 reserve。
  • 偏差按两天量程呈现;一天填充半侧,两天填满,超过两天才显示活动侧边框。
  • OpenAI 双域名不可达时显示持续脉冲的禁止图标,并将外环显示为已耗尽状态。
  • 启动和手动刷新时运行完整状态自检;可在设置中选择连续百分比或节奏分级。
  • Codex 缺少可用短周期时,自动将 Weekly 提升为带日刻度的曲线图。
  • 更新 README 与菜单栏状态预览,并补充渲染、曲线回退和时间刻度测试。

验证:45 项测试全部通过。

在 GitHub 查看版本与下载附件 ↗

v1.4.9

更新内容

  • 新增 Codex 紧凑配额环:外环显示 Weekly 消耗,分隔内圆区分透支 / 节奏正常 / 余量。
  • 新增菜单栏服务商、外观与节奏细节偏好,包括连续百分比与分级两种方式。
  • 启动与手动刷新时运行完整图标自检,后台刷新保持视觉安静。
  • 以带抖动的探测检查 chatgpt.com 与 openai.com 的可达性,双域名均不可达时中心形变为禁止状态。
  • 防止不活跃的 Codex Weekly 0% 占位样本在真正重置前替换仍然活跃的更高可信度样本。
  • 应用版本升级至 1.4.9(build 17)。

验证

  • 42 项测试通过。
  • Release 应用签名与 DMG 校验和验证通过。
  • 已从 /Applications/AIQuotaBar.app 安装并启动。
在 GitHub 查看版本与下载附件 ↗

v1.4.8

更新内容

  • Codex 多账号表头优先展示账号身份,Mix/Cloud 仍保留在同一行。
  • “节奏正常”标签保持中性色;仅可见的透支标签显示红色。
  • 应用版本升级至 1.4.8(16)。
在 GitHub 查看版本与下载附件 ↗

v1.4.7

更新内容

  • 显示 Weekly 节奏状态,元信息行不再留空。
  • 节奏正常的小幅周偏差在四舍五入到可见百分比时显示为余量/透支。
  • 透支节奏标签显示红色,包括小幅节奏正常的透支。
  • 应用版本升级至 1.4.7(15)。
在 GitHub 查看版本与下载附件 ↗

v1.4.6

更新内容

  • 收紧配额历史行:移除图表下方重复的 left 文本,周期标签移入元信息行。
  • 修复 Codex 周期悬停文本,正确显示日期范围与当前剩余配额。
  • 规范化 Codex 利用周期悬停范围,5h 周期使用实际 5h 窗口而非相邻重置时间的推算。
  • 忽略空闲 Codex 利用率样本,滚动产生未使用的 5h 窗口不再显示为大量虚假的 100% left 周期。

验证

  • swift build
  • swift test --filter ModelUtilizationCycleMergerTests

SHA-256:9d020a31d855f51b70a0211af8868974e3d06977ce871bc5006e0f0980acb086

在 GitHub 查看版本与下载附件 ↗

v1.4.5

修复

  • 云同步保留 MiniMax 短窗口图表数据点:基于百分比的配额样本按 total=100、remaining=<百分比>、valueSuffix=% 上传。
  • 有百分比字段时,云恢复的图表数据保持百分比模式。
  • 新安装的默认刷新间隔调整为 600 秒。

发布

  • 应用版本:1.4.5(build 13)
  • DMG SHA-256:0e8c90e4f57d0d9fc899cfa63497da581288f5e389c71536eb19cdd9c661a6c4

验证

  • swift build
  • swift test --filter CloudSyncPayloadTests
  • swift test --filter ModelQuotaSampleStoreTests
  • node --check cloudflare/src/worker.js
  • git diff --check
  • make package

说明:本机发起的 Cloudflare API 部署尝试超时,但此 MiniMax 修复与已部署的 Worker 客户端兼容,因为它沿用现有 quota_samples 字段。

在 GitHub 查看版本与下载附件 ↗

v1.4.4

修复

  • 短窗口图表样本本地持久化,曲线数据点在应用重启后保留。
  • 开启云数据时,从云同步历史恢复图表曲线。
  • 配额样本新增云历史查询模式(history=1),保持现有每模型最新值 API 行为不变。
  • 数据报告更新为检查云刷新历史样本。

发布

  • 应用版本:1.4.4(build 12)
  • DMG SHA-256:9521b14b422e143015a113a6e91e0d830434f6fe1281a6bc34f8c76579c7cd90
  • Cloudflare Worker 已部署:76cfe627-4c71-4945-9718-c86cf557a232

验证

  • swift build
  • swift test --filter ModelQuotaSampleStoreTests
  • node --check cloudflare/src/worker.js
  • git diff --check
  • make package

说明:完整 swift test 仍存在已知的 MenuBarBrandIconTests 失败,原因是测试运行时无法加载供应商 SVG 资源(MenuBarBrandIcon.image(for:) 目前是返回 nil 的占位实现);本版本未改变该行为。

在 GitHub 查看版本与下载附件 ↗

v1.4.3

修复

  • 恢复全新安装时的 MiniMax 服务商配置流程。
  • 从活跃服务商列表移除 GLM,当前应用仅支持 MiniMax 与 Codex。
  • 服务商凭据新增“保存更改”操作。
  • 仅显示一个服务商时,菜单栏文本改用首行展示服务商名称。

验证

  • swift build
  • make package
在 GitHub 查看版本与下载附件 ↗

v1.4.2

要点

  • 新增远程账号管理功能与更新检查改进。
  • 新增云数据可见范围限制与云数据保留管理。
  • 新的用量、同步与云数据设置全面支持中英文。
  • 新增用量与同步设置标签页。

验证

  • npm --prefix cloudflare run check
  • make package
  • swift test(MenuBarBrandIconTests 失败,原因是测试运行时无法加载供应商 SVG 资源;其余 19 项通过)
在 GitHub 查看版本与下载附件 ↗

v1.4.1

要点

  • Codex 菜单分组重构为 服务商 → 账号 → 配额 层级。
  • 新增内置 Cloud/Mix 账号展示、纯云端历史回退与数据管理改进。
  • Codex Spark 配额与常规 Codex 5h/Weekly 历史和周期保持独立。
  • Codex 应用未运行时跳过 OAuth/CLI/Web 刷新。
  • 隐藏空的 Spark 行,默认折叠未使用的满额度模型,并在服务商表头显示 Codex 账号健康计数。
  • Cloudflare Worker 配额样本查询改为返回每个模型的最新样本,而非仅最近几行。

验证

  • swift test --filter CodexUsageDataMapperTests
  • npm run check (cloudflare)
  • make package
在 GitHub 查看版本与下载附件 ↗

AI Quota Bar v1.4.0

要点

  • 新增可选的 Cloudflare Worker + D1 云端备份,用于配额快照。
  • 设置中新增快捷入口,可把云端存储的配额数据查看为本地 HTML 报告。
  • 供应商凭据继续保存在本机钥匙串,远端仅存储精简的配额历史。
  • 新增登录启动偏好,并改进耗尽 / 满额度行的模型分组。

验证

  • swift build
  • node --check cloudflare/src/worker.js
  • make package
在 GitHub 查看版本与下载附件 ↗

v1.3.2

要点

  • 右键菜单栏图标可在已用完的短周期配额窗口间轮换显示。
  • 改进菜单栏自动回退:过期或耗尽的选择会轮换到活跃且已用过的模型中最早重置的一个。
  • 活跃模型轮换时跳过未使用的满额度窗口。
  • 补充多账号 ChatGPT 配置说明与 v1.3.1 的 ChatGPT 短窗口图表修复说明。

验证

  • 构建并打包 dist/AIQuotaBar.dmg,应用版本 1.3.2 build 7。
在 GitHub 查看版本与下载附件 ↗

AI Quota Bar v1.3.1

修复内容

  • ChatGPT/Codex 5h 配额按短重置窗口处理,使用与其他当日以内配额相同的配额图表。
  • Weekly ChatGPT/Codex 配额保持标准进度条,因其重置窗口超过一天。
  • 更新下拉菜单截图以匹配新的 ChatGPT/Codex 配额展示。
在 GitHub 查看版本与下载附件 ↗

AI Quota Bar v1.3.0

新增内容

  • 通过 ChatGPT Codex 用量端点接入 ChatGPT/Codex GPT 编码配额监控。
  • Codex 主/次配额窗口按 5h 与 Weekly 展示,含剩余百分比和重置时间 / 日期。
  • 供应商凭据存储为单个钥匙串 JSON 项,减少迁移后反复弹出授权。
  • ChatGPT、GLM 等基于百分比的供应商在菜单栏保留百分比后缀。
  • 更新下拉菜单截图与 README 配置指引。
在 GitHub 查看版本与下载附件 ↗

v1.2.1

修复

  • 菜单栏下拉高度扩展至最多占用可视屏幕高度的 90%。
  • 菜单布局高度上限保留在 AppKit 宿主视图层级,长服务商 / 模型列表保持可滚动,不再被人为截短。

构建

  • 版本 1.2.1,build 4。
在 GitHub 查看版本与下载附件 ↗

v1.2.0

更新内容

  • 应用与仓库由 MiniMax Usage Monitor 更名为 AI Quota Bar。
  • 应用定位调整为跨服务商监控 AI 模型编码套餐配额。
  • 更新 Swift package、应用包元数据、更新检查器、文档与构建打包以匹配新名称。
  • 迁移旧包名 / 服务标识下的历史偏好与钥匙串凭据。
  • 更新 README 用量文档,包括 GLM/Z.ai 的登录、打开配额页面、使用浏览器开发者工具并将 quota/limit 请求复制为 curl 的流程。
  • 从仓库移除旧的已提交调试应用与 DMG 产物。

验证

  • 使用 make build 构建发布产物。
  • 使用 make package 打包并 ad-hoc 签名 AIQuotaBar.app。
  • 验证应用签名与 Info.plist 元数据。

下载

下载附件中的 DMG,将 AIQuotaBar.app 拖入“应用程序”。

在 GitHub 查看版本与下载附件 ↗

MiniMax Usage Monitor v1.1.1

问题修复

  • 面积图填充路径修复:修复面积填充渲染错误——左侧竖边未从第一个数据点正确绘制到 x 轴(y=0)。旧实现依赖的 closeSubpath() 不会绘制线段,导致图表左缘缺少面积填充。

文档

  • 新增运行体验指南,便于调试与测试
在 GitHub 查看版本与下载附件 ↗

v1.1.0

要点

  • 新增自动更新检查(每 24 小时一次)。
  • 有新版本可用时发送更新通知。
  • 修复可能导致应用被报告为“已损坏”的打包问题。
  • 修复打包 .app 中的应用图标显示。
  • .dmg 安装窗口新增 Applications 快捷方式。

更新行为

  • 应用每天最多在后台执行一次更新检查。
  • 发现新版本时弹出 macOS 通知。
  • 点击通知会打开发布页面。
  • 设置中的手动检查更新仍然可用。

安装

  • 从本版本下载 MiniMaxUsageMonitor.dmg。
  • 将 MiniMaxUsageMonitor.app 拖入 Applications。
在 GitHub 查看版本与下载附件 ↗

v1.0.0

v1.0.0 - 首个版本

MiniMax Usage Monitor 是一款 macOS 菜单栏应用,用于监控 MiniMax API 的用量与配额。

功能

  • 菜单栏小组件显示剩余配额
  • 详细的用量视图,按模型拆分
  • 短周期模型的配额趋势图表
  • 可配置的刷新间隔
  • 配额不足时发出警告通知
  • 通过钥匙串安全存储 API Key

系统要求

  • macOS 14+
  • MiniMax API Key

安装步骤

  1. 下载 MiniMaxUsageMonitor.dmg
  2. 打开 DMG 文件
  3. 将应用拖入“应用程序”文件夹
  4. 从“应用程序”启动应用
  5. 点击菜单栏图标,选择 Settings 配置你的 API Key
在 GitHub 查看版本与下载附件 ↗