QuotaDock

把 Codex 余量放在刘海旁，
一眼可见。

写代码时，偶尔想确认还剩多少额度、什么时候重置。QuotaDock 把这些信息放在桌面边缘，平时看一眼，需要时再展开。

起点

少一次切换，心里更有数。

使用 Codex 时，额度会影响接下来安排什么工作。我想把反复打开页面查询的过程省下来：让余量和重置时间留在视线边缘，抬眼就能看到，也不占用正在工作的窗口。

使用

带刘海的 MacBook 可以把圆环放在刘海左侧或右侧，圆弧和数字一起表示剩余比例。没有刘海的显示器则使用小胶囊，四个屏幕边缘都能停靠。

右键可以刷新、打开设置或退出；也可以用全局快捷键，在其他应用里呼出 QuotaDock。

重置提醒

周额度快重置时，提示色会逐渐从黄变红。你可以按剩余额度设置提醒门槛，开启定时免打扰，或临时暂停提醒。

详情页会把周余量按距离重置的实际天数均摊，供你安排每天的使用节奏。它只是参考，不能换算成还能完成多少任务，五小时额度等限制仍然独立生效。

倒计时归零后，应用会重新同步。只有服务端确认进入新周期，才会提示重置完成。

实现

缺失的额度显示为“—”，不会被算成 0%；到了预计重置时间，也不会直接把余量改成 100%。本地趋势只记录实际观察到的数据，不补造离线时段的消耗，也不换算成 token。

QuotaDock 使用独立的 Codex 数据目录和钥匙串存储，不读取或修改主 Codex 的登录凭证。它只请求账户与额度信息，不发起模型推理；趋势、偏好和提醒记录保存在本机。

实现方式

SwiftUI 绘制界面，AppKit 处理窗口与桌面交互，通过 Codex app-server 同步额度。项目以 Swift Package 组织，没有第三方 Swift 依赖；额度计算、停靠定位和提醒策略放在可独立测试的 QuotaCore 中。

外观与习惯

深浅外观、字号、颜色、透明度和停靠位置，都可以按桌面习惯调整。登录后启动是可选项，需要时也可以设置全局快捷键。

本地趋势保留最近七天的观测。内置的使用建议可以分类浏览、收藏、隐藏或复制。

如果同时使用 NotchNook，可以手动留出间距；QuotaDock 独立运行，不会自动跟随它的展开宽度。

当前进展 / 2026.10.02

当前为 0.2.0 / build 14 开发预览。

刘海圆环、边缘胶囊、额度同步、重置提醒、免打扰、本地趋势和使用建议。已有真实账户同步与部分桌面交互的验收记录。

多显示器、全屏、睡眠跨越重置、重新登录后的自动启动，以及协议进程异常和长期运行的稳定性。

预编译包面向 Apple Silicon，要求 macOS 14+ 和可用的 Codex CLI。目前使用 ad-hoc 签名，尚未完成 Developer ID 签名与 Apple 公证，首次打开可能被系统拦截；也可按仓库说明从源码构建。

QuotaDock 是独立第三方工具，与 OpenAI、Apple 或 NotchNook 无隶属关系。