服务对象与地域限制
PuppyIP 仅面向海外合规企业及其授权人员提供服务，不面向中国大陆地区开放或提供代理服务。本服务仅限用于中国大陆境外的合法业务活动，严禁在中国大陆境内使用本服务。
代理 IP 或服务器位于境外，不改变上述限制。不得通过中转、转接、共享或转售向中国大陆境内的最终使用者提供本服务。使用前请阅读用户服务协议。
本文要点
- 0.71.1 已于 2026 年 10 月 3 日发布，旧版用户可先检查是否命中此次显示修复。
- 按原安装来源更新，重新打开后确认实际运行版本，再比较同一账户的读数。
- 把未收到通知与额度未恢复分开排查，最终以服务商账户内的用量和限制提示为准。
先判断是不是这次修复的问题
作者在 0.71.1 发布说明中指出：确认 Codex 每周额度已重置后，如果旧快照缺少 credit inventory，新的额度、重置后的 credits 和更新时间可能未发布到界面，造成读数长期停留在约 1%。该版修复的是这个显示更新条件，并不表示所有额度异常都能通过升级解决。
排查前先问三个问题：看到的是哪一个账户，比较的是会话窗口还是每周窗口，界面的更新时间是否仍停在重置前。只记下“剩余 1%”不够，因为同一个账户可能同时受不同窗口限制。可以把待核对信息写成“账户 A／每周窗口／更新时间”，避免拿个人账户的菜单栏读数去比较工作账户的网页。
本文按作者文档整理 macOS 菜单栏版操作，未安装或实测。建议先处理一个提供商，确认数据对应关系后再启用其他订阅，减少多个账户和窗口同时出现时的误判。
按安装来源升级，再确认运行版本
macOS 版要求 macOS 14 或以上。首次安装可从文末官方 Releases 获取应用，也可使用 Homebrew 命令 brew install --cask codexbar。已有安装不要为了更新再混装另一份，先确认自己原来使用哪一种方式。
官方发布包可从菜单或 About 的 Check for Updates 检查更新；已下载更新时，按提示确认安装。Homebrew 安装不使用 Sparkle 更新，应走 Homebrew 路线；应用的 About 也提供版本检查和可用升级入口，失败时可查看其显示的升级命令。
完成后重新打开 CodexBar，在 About 查看运行版本，核对是否已到 0.71.1。不要只凭下载目录中出现新版文件就认为升级成功。如果仍显示旧版，先检查正在打开的是哪份应用，再处理安装路径；不需要为此清空账户配置。
先选数据来源，再授予所需访问
进入 Settings → Providers，只启用实际需要的提供商。Codex 支持 OAuth API 或本地 Codex CLI，网页附加数据为可选项；Claude 可使用 OAuth、浏览器 cookies 或 CLI 回退。各来源的可用条件不同，不是所有提供商都共用一种登录方式。
浏览器 cookies 按需启用，令牌保存在受限权限的配置文件中。读取 Safari 的 cookies 或本地存储时才需要 Full Disk Access；也可核对该提供商支持的其他来源。
建议先使用自己能明确识别账户的来源。若同一浏览器登录了多个账号，先核对导入的是谁。不要为了消除一个空白读数同时打开所有访问权限，也不要把 cookie、令牌或完整配置贴进公开求助帖。
手动刷新一次，比较同一窗口
打开菜单中的 Refresh now。刷新文档说明，部分暂时性网络失败会保留上次成功快照及其原更新时间；因此看到数字不等于刚刚抓取成功。认证失败与账户变化的处理不同，应结合菜单中的错误状态判断。
刷新完成后，依次核对账户、窗口名称、更新时间和数值，再打开服务商对应账户的用量页面进行比较。假设网页中的每周窗口已开始新周期，而 CodexBar 仍显示重置前时间，优先排查抓取是否成功；若两边时间都很新但窗口不同，先修正比较对象。这里是诊断方法，不是对某次实际故障的结论。
建议只刷新一次并等待结果，避免连续点击后分不清哪次请求成功。只要更新时间和状态仍未确认，就先把该数字标作待核对，不据此购买额外额度或断言订阅缩水。
在应用内开启重置通知
进入 CodexBar Settings → Notifications，开启默认关闭的 Reset notifications。它根据已确认的会话或每周重置发送提醒；能否实际显示，还受 macOS 通知权限和专注／勿扰设置影响。应用开关与系统通知设置需要分别检查。
开启后不要把“立刻收到一条通知”当作验收条件，也不要为测试提醒故意耗尽额度。下一次自然出现可核对的重置时，先确认账户数据已经更新，再观察通知。没有横幅，只能说明提醒链路还需要检查，不能单独证明服务商没有重置额度。
升级后仍不一致，按现象决定下一步
如果服务商页面本身仍提示额度不足，应先按该页面的账户、周期和限制说明处理；CodexBar 的升级或通知开关不会修改那里的规则。如果服务商已恢复，而工具更新时间仍旧，回到所选数据来源检查登录和抓取错误。如果数值已更新、只有通知缺失，就集中检查提醒设置，不要重新导入全部账户。
向作者反馈时，提供操作系统、CodexBar 版本、安装来源、提供商名称、所选数据来源、窗口类型和错误文字。用遮盖后的截图说明两边比较的是同一账户与周期，并附上观察时间。先检查截图有没有邮箱或账户标识；令牌、cookie 和配置文件内容不属于必要反馈材料。这样更容易区分显示缺陷与账户实际限制，也能避免为了复现问题暴露登录信息。
资料来源
常见问题
装了 0.71.1，所有额度不更新的问题都会消失吗？
不能这样判断。先按本文顺序确认运行版本、账户、额度窗口和更新时间；服务商实际限制、登录状态与显示更新是不同环节，需要分别核对。
为什么系统允许通知，还是没看到重置提醒？
还要检查 CodexBar 自身的 Reset notifications 开关，它默认关闭。建议先确认读数已经对应新的周期，再检查系统通知与专注设置，不用通知横幅代替额度核验。
要查询多个订阅，必须导入所有浏览器登录吗？
先逐个确认需要监控的提供商及其支持的数据来源，只接入能识别账户且愿意授权的部分。先让一个账户的读数与官方页面对应，再增加其他账户，更容易发现接错身份的问题。