中文 | English
一个原生 macOS 菜单栏仪表盘：把 Codex 本机额度、使用节奏、Model IQ、Radar 信号和重置卡状态 放进一个随时可看的紧凑面板。
不用再在多个页面之间来回确认“还有多少额度、现在该不该继续用、模型状态怎么样”。 Codex Radar Sentinel 将本机 Codex 的权威额度数据与 CodexRadar 的公开质量和雷达信号合并展示，同时把敏感凭证留在本机。
- 从 最新 GitHub Release 下载
.dmg。 - 打开镜像，将 Codex Radar Sentinel.app 拖入
Applications。 - 启动应用。首次运行时，macOS 可能询问通知权限；允许后才能收到额度、Model IQ 和重置卡自动使用提醒。
.zip 包含同一个应用，适合手动复制或自动化安装。
把下面这段文字交给 Codex 桌面版，它可以完成下载、SHA256 校验、安装、启动和版本确认：
请安装 Codex Radar Sentinel 的最新稳定版。
Release 页面：
https://github.com/WineChord/codex-radar/releases/latest
下载 macOS 安装包和 SHA256 校验文件，校验通过后将应用安装到 /Applications，启动应用，并确认菜单栏中显示的版本与最新 Release 一致。遇到需要我处理的 macOS 权限提示时，请说明用途后让我确认。
安装需要网络访问和
/Applications写入权限。
- 额度一眼可见：周额度常驻菜单栏；Codex 明确返回 5h 短窗时同步展示。
- 知道“该不该继续用”：多种节奏策略把当前剩余量和目标剩余量放在一起比较。
- 模型状态不靠猜：聚合 Model IQ、多模型费用/耗时/通过数、社区体感与降智预警。
- 雷达信息集中：重置雷达、额度雷达、Fast 雷达、场景推荐和公告统一收口。
- 本机优先：额度历史和脱敏缓存留在 Mac；登录凭证不会上传到 CodexRadar。
- 可控自动化：更新包先做 SHA256 校验；重置卡到期前自动使用严格默认关闭，只有明确授权后才会执行。
- 自动重建持有过期凭证的独立额度连接；Codex 已正常登录时，不再直接要求重新登录。
- 读取失败时明确标记保存的额度，暂缓用量建议；成功刷新后恢复实时显示。
- 跟随洞察服务的新地址；服务暂不可用时显示状态、保留已有数据并自动重试，本机额度继续独立刷新。
- 兼容 Fast 雷达当前的测试方法说明格式。
- 固定路径失效时，自动发现 macOS 已运行或已登记的 Codex / ChatGPT 应用，并在应用包内查找 CLI，兼容应用改名、移动和内部目录变化。
- “Codex”按钮使用系统定位的应用位置；保留自定义 CLI 路径优先级，应用包查找限定范围与工作量。
- 自动识别 Codex / ChatGPT 新版内嵌 CLI，修复桌面应用更新后“找不到 Codex”及当前额度未知的问题。
- 保留旧版安装路径、独立 CLI、PATH 与自定义路径兼容；旧快捷链接失效时仍可找到可用程序。
更早版本
- v0.1.73：尊重 Codex 服务端明确的用量限制，并兼容 Fast 雷达卡片布局。
- v0.1.72：完整同步重要公告标题、多段正文与安全的同源图片链接，并保留旧版重置公告兼容。
- v0.1.71：兼容 Fast 雷达紧凑对比布局，完整同步速览摘要与测试方法，并保留旧格式支持。
- v0.1.70：兼容分层的官方重置公告，保留标题、预计时间、说明和安全来源链接。
完整历史见 GitHub Releases。
| 能力 | 作用 |
|---|---|
| 本机额度 | 显示 Codex 周额度；接口明确返回 5h 短窗时也可显示短窗额度。 |
| 额度历史 | 在本机保留 24 小时、7 天和 30 天周额度余量曲线，可逐点查看变化、重置与数据断档。 |
| 用量节奏 | 对比当前实际剩余与建议剩余，直观提示“可多用”“接近节奏”或“超用”。 |
| Model IQ | 展示当前 IQ、质量状态，以及公开的多模型费用、耗时、通过数和体感分。 |
| 雷达信号 | 汇总重置雷达、额度雷达、Fast 雷达、场景推荐和降智预警。 |
| 重置卡状态 | 低频查询每张重置卡的状态与到期时间，只缓存脱敏结果。 |
| 到期前自动使用 | 严格默认关闭；明确开启后，才会在卡片临近到期时尝试使用目标卡。 |
| 通知与更新 | 提醒低额度、额度恢复、低 IQ 和自动使用结果；自动更新包会先校验 SHA256。 |
| 个性化 | 支持中英文、字体大小、菜单模块与子项的排序、显示及默认展开状态，以及状态栏片段和显示格式。 |
默认标题刻意保持简短：
96%/112/正常
| 片段 | 含义 |
|---|---|
96% |
本机 Codex 周额度剩余。 |
112 |
Codex IQ；默认显示整数，下拉菜单保留精确值。 |
正常 |
CodexRadar 的模型质量状态；IQ 偏低时显示 低。 |
还可以按需打开：
5h：本机 Codex 返回 5 小时短窗时可用；短窗暂停时自动隐藏。应剩：显示当前时间点建议保留的周额度，例如应80%。状态栏 IQ 小数：在菜单栏里保留精确 IQ。状态栏高级：调整分隔符、左右留白、字体比例、/10样式和百分号。
以下图片由应用在隔离预览环境中直接渲染，不包含真实账户数据或其他菜单栏内容。
| 正常 | IQ 偏低 | 本机限额 | 自定义 |
|---|---|---|---|
|
 |
 |
 |
面板默认依次展示当前结论、本机额度、Codex IQ、重置卡摘要、用量节奏和智能洞察。公告、社区知识、雷达明细和低频设置默认折叠，需要时仍可在原位展开；关键告警保持可见，需要处理的重置卡或更新状态会自动展开。刷新、Radar、Codex、GitHub、布局和退出入口固定在底部；首次展示布局功能时，工具栏上方会显示一条可关闭的轻提示。
点击底部 布局 可统一调整顶层模块：拖动手柄或使用上移、下移按钮改变顺序，通过 显示 决定它是否出现在菜单中，并为显示的模块选择是否默认展开。模块内还有可折叠子项时，会在所属模块下方缩进显示，例如 Codex 额度 下的 额度历史 和 Codex IQ 下的 全部模型 IQ；子项也可以独立显示、隐藏或设置默认展开。所有选择都会在重新打开菜单和重启应用后保留。恢复默认布局 会恢复全部模块和子项，并重置它们的顺序与展开状态，不会改变语言、字号、提醒或自动更新设置。
首次显示时，底部工具栏上方会用一条轻提示说明布局能力。点击提示会直接进入布局编辑器；直接点击 布局 或关闭提示后，它都不会重复出现。
隐藏只改变菜单展示，不会停止额度历史记录、提醒或重置卡自动使用。当前结论、紧急提示和连接错误不参与排序，也不能隐藏；重置卡或更新遇到需要处理的状态时，对应模块会临时显示并锁定展开，问题解除后再恢复用户原来的显示与展开偏好。
Codex 额度 中的 额度历史 默认显示但保持折叠；可以在 布局 中设为默认展开，也可以完全隐藏。它提供 24 小时、7 天和 30 天三个范围；将鼠标移到曲线上，或在曲线上拖动，即可查看最接近时间的剩余量和相对上次记录的变化。隐藏曲线不会停止本机采样。
应用只在成功读到本机周额度后记录真实采样点。连续运行时至少间隔 5 分钟保留一次记录；余额发生明显变化或重置时间变化时会立即保留。曲线不会跨过长时间断档补线，可靠的向上跳变只标记为“观察到重置”，不会推断是周期重置、重置卡还是其他服务端修正。
历史从启用该版本后开始积累，不会伪造或倒推此前数据；本机最多保留 31 天。区间底部的“观测消耗”只汇总实际观测到的余额下降，不能替代服务端用量账单。
应剩计算策略 默认折叠，点击整行即可展开并切换：
按时间：在整个 reset 窗口内平滑使用。每日：按本机日历的天级预算推进。留余：前期保留 20% 缓冲。工作日：工作日多用、周末和法定节假日少用。先用：前半程更积极，降低 reset 前剩余过多的概率。
节奏卡片使用无符号百分比表达方向。例如实际用量比建议多 33% 时显示 超用 33%，不会显示容易误读的负数。
重置卡与自动使用 默认折叠，并在折叠行显示可用数量或当前执行状态。展开后可查看完整明细、开关和恢复操作。重置卡到期时间会在应用启动后或缓存超过 6 小时时低频刷新，也可以关闭自动查询或手动刷新；查询失败时会保留旧缓存，并给出未登录、登录过期、网络或数据格式等可操作提示。
重置卡到期前自动使用 是独立开关，并且严格默认关闭。开启前会展示不可撤销说明并要求明确确认；启用后只覆盖确认时可见、受支持且有明确到期时间的卡片。计划检查是只读操作，不会消耗卡。
只有最早到期的目标卡距离到期约 30 分钟时，应用才会自动尝试使用。如果已核对的本机会话在写入请求前中断，本次不会消耗卡片，应用会保留同一份显式授权并自动重新核对后重试。账号、卡片集合或时间连续性发生无法安全确认的变化时，该功能仍会自动关闭，并在本机安全记录中保留关闭原因和时间，不保存原始账号或卡号。断网、关机、休眠、退出应用或服务端没有可重置用量都可能导致未执行，因此这是尽力执行的功能，而不是绝对保证；建议同时开启 登录时启动。
应用可在以下情况发送 macOS 通知：
- 周额度低于 30% 或 15%。
- 周额度从低位恢复。
- Codex IQ 进入 red 或低于 80。
- 重置卡自动使用成功，或需要检查账号、授权卡片、时间连续性和未决结果。
- 兼容接口未来重新报告明确的旧版窗口或 reset 事件。
通知声音默认关闭，可在菜单中单独开启。
自动更新默认开启。应用启动后会检查一次，之后每 6 小时检查最新 GitHub Release。下载完成后先校验发布资产中的 SHA256，再替换应用并重新启动。
更新失败时保留当前版本并显示原因；同一版本的自动重试会短暂冷却，检查更新 仍可立即手动重试。
- 本机额度优先通过当前用户专属、已经登录的 Codex 受管会话读取；不可用时回退到独立的本机 app-server。额度读取链路不会读取、复制或缓存登录凭证，也不会把额度上传到 CodexRadar。
- 额度历史只在本机保存采样时间、周额度剩余百分比和服务端 reset 时间，最多保留 31 天；不保存账号身份、访问令牌或请求内容，也不会上传。
- 重置卡到期查询需要使用本机 Codex 登录态访问 ChatGPT 对应接口；凭证只用于该请求，不会写入缓存、日志或发送给 CodexRadar、GitHub。
- 本地缓存只保存卡片状态、发放时间、到期时间和脱敏标识，不保存访问令牌、Cookie、邮箱或完整卡片 ID。
- 到期前自动使用只在明确开启后工作，并将授权绑定到当时的账号与卡片集合。每次写入前会再次核对目标、授权和时间连续性。
- 不确定的执行结果会优先只读对账；同一次未决操作使用同一个幂等键，避免重复使用。
- 关闭自动使用后，不会继续重试或切换到其他卡片。重新开启前必须先确认上一笔未决结果。
- CodexRadar 首页：公告、重置雷达、社区知识、额度雷达和模型质量摘要。
- CodexRadar current.json：公开权益事件、Model IQ、额度雷达和兼容字段。
- CodexRadar 智力效率数据：多模型 IQ、费用、耗时和通过数。
- CodexRadar 社区体感数据：模型社区评分。
- CodexRadar 智能洞察：场景推荐和降智预警。
- CodexRadar RSS：公开权益事件的兼容来源。
- 本机 Codex 受管会话或独立 app-server：周额度、短窗额度、登录身份和重置卡自动使用所需的权威明细。
公开端点暂时不可用或返回未知格式时，应用会保留最后一次有效数据，并让本机额度继续独立刷新。
构建普通 macOS 应用：
./scripts/build_app.sh
open ".build/Codex Radar Sentinel.app"开发时也可以直接运行：
swift run CodexRadarSentinel如果 Codex 不在默认位置：
CODEX_RADAR_CODEX_PATH=/path/to/codex swift run CodexRadarSentinel云端 macOS 测试、双架构安装包与发布草稿流程见维护指南。
swift test
swift build -c release
./scripts/check_release_readiness.sh 0.1.73构建发布包：
./scripts/build_app.sh
./scripts/package_release.sh 0.1.73更新中英文状态栏与菜单截图：
./scripts/update_readme_screenshots.sh截图脚本使用隔离的非实时预览，不读取真实账户数据，也不会改变正在运行的正式应用设置。
感谢 CodexRadar 持续提供公开的 Codex 雷达、模型质量和社区信号。本应用将这些公开信息与本机 Codex 状态整合为一个 macOS 菜单栏界面。
Codex Radar Sentinel 与 CodexRadar 或 OpenAI 没有关联。