【💰】三个月后，回来分享一下 CodexBar 的近况

三个月前，我在这里分享了自己做的 CodexBar

当时我自己用的 Codex 5x，用得很爽，就是查看额度有点麻烦。于是做了一个符合自己审美的 macOS 菜单栏小工具，方便随时看一眼还剩多少额度。

之后一直在用，也一直在改。三个月里，一共发布了超过 80 次版本，回来整理一下这三个月都做了什么。

最初主要关心的是额度。随着 Codex 用得越来越多，需要知道的事情也变多了：几个任务同时跑的时候，哪个还在工作？哪个正在等我批准？切出去做别的事以后，任务什么时候结束？长任务跑到一半，电脑会不会睡着？

这三个月增加的功能，主要就是围绕这些问题展开的。

现在不用打开面板，菜单栏就能看到所选额度窗口的剩余比例。人物图标上的徽章也会随任务状态变化，区分运行中、等待批准、刚刚完成和刚刚终止。鼠标悬停还能查看项目、持续时间和并发任务数量。

打开主面板后，除了账户、套餐、各个额度窗口和重置时间，还能看到当前任务使用的模型、推理强度、执行阶段、运行时间和活跃子 Agent 数量。多个项目一起跑时，可以打开新增的任务中心，集中查看运行中、等待批准以及最近结束的任务，少在几个窗口之间来回找。

为了不用一直盯着 Codex，我也补全了通知。任务结束、需要批准、额度不足、额度恢复，都可以按需提醒。任务完成通知可以设置最短运行时长，减少短任务的打扰；不同类型的通知可以选择音效，也可以静音。喜欢触觉反馈的话，还可以打开触摸板震动。

另一个花了不少时间的功能是跟随任务状态防睡眠。

开启后，有符合条件的 Codex 任务在运行，Mac 就保持唤醒；任务结束后，自动恢复系统睡眠。也可以选择在等待批准时继续保持，或者同时保持屏幕常亮。

这里还补了最长防睡眠时间、低电量保护和异常会话保护。比如某个任务长时间没有任何进展，就让它退出防睡眠判定，避免一个残留的运行状态让电脑一直醒着。后续任务恢复进展时，再恢复显示和判断。

额度方面，除了展示更完整，也增加了可用积分、留存重置次数和过期时间。如果账户有即将过期的留存重置，可以开启临期自动重置，设置提前多久使用，默认提前 30 分钟。需要时会安排系统唤醒，并在执行前重新检查是否仍然可用。这个功能默认关闭，由自己决定是否启用。

原来的 Token 热力图也继续完善了。现在除了近 30 周的每日用量，还能查看累计 Token、单日峰值、连续使用天数和最长任务时长。

开启 CodexBar Hook 后，日期详情里会进一步显示当天的会话数、对话轮次、工具调用、权限请求、上下文压缩、子 Agent 和最常用模型。用了一段时间后，能更直观地看到自己使用 Codex 的节奏。

如果在多台 Mac 上使用，还可以通过 iCloud 合并每日 Hook 统计。这里同步的是日级活动统计，包含项目显示名和模型等信息；实时任务留在本机，Token 用量和账户额度也不通过这套同步传输。Hook 不保存提问、回复或工具输入输出正文。

日常交互也陆续补了一些东西：

• 全局快捷键，随时打开或收起主面板
• 主面板区域排序和显隐，按自己的习惯安排内容
• 邮箱模糊显示，截图或共享屏幕时更方便
• 简体中文和英文界面，以及对应的使用文档
• Codex 来源选择和重新连接，方便处理 CLI 与 App 内置版本并存的情况
• 为 CodexBar 的 Codex 服务连接单独配置 HTTP/HTTPS 代理
• Hook 配置自动检查与修复，保留用户已有的其他 Hook

除了加功能，这三个月也修了不少不太容易在截图里展示的问题：窗口焦点、跨桌面显示、侧边面板收起、重复通知、并发任务状态、睡眠与唤醒恢复，以及统计同步和数据重建。

最近又专门补了自动化性能采集和可视化报告，修复了隐藏面板的内存增长和窗口隐藏后持续动画的问题。最新一次测试中，正常使用电脑、持续使用 Codex、全程没有打开主面板，约 30 分钟采集里主进程平均 CPU 为 0.91%，内存常态约 183 MB

回头看，三个月前做它，是想让查看额度这件事更顺手。现在它还能帮忙跟进任务、在需要操作时提醒，以及让长任务跑完后电脑正常休息。平时放在菜单栏，需要的时候看一眼，这仍然是我最在意的使用方式。

项目继续开源，支持 macOS 15 及以上版本。实时任务、任务通知和按任务防睡眠需要在设置里开启 CodexBar Hook，其他功能可以按需选择。

项目地址： bob-zebedy/CodexBar