Codex Toolbox 是一款原生 macOS 菜单栏工具。它保留 Show Codex IQ 的模型智商、费用、耗时和综合排名，同时提供本机用量分析与账户额度、重置卡只读查询。三个模块各自刷新、各自缓存，任一数据源失败都不会清空其他结果。
Tip
v1.4.0 / Build 58 已正式发布，新增多菜单栏与账户额度，并改进每日任务用量。 前往 正式发布页 下载安装包，或查看 1.4.0 更新日志。
Important
本项目与 OpenAI、ChatGPT 和 Codex 雷达均无官方隶属关系。模型排名来自 codexradar.com，详见数据来源与授权说明。
现有截图来自此前版本；1.4.0 的界面变化以正式版与发布说明为准。
- 从稳定的数据接口读取由 Codex 雷达适配的模型档位；保留来源 IQ、计分样本、实际费用聚合方式及平均耗时，兼容的公开历史用于趋势。
- 第四榜单默认是本地 IQ/费用/耗时加权百分位，也可切换为 Codex Radar 发布的“成本效率”（只含费用和耗时，越低越好）；两者不混称。
- 可选站长推荐默认关闭，开启后支持日常开发、困难任务、后台自动化和龙虾类任务四类场景，并可选择放在四宫格上方或下方。
- 完整保留四类榜单、前三/前五展开、趋势图与离线快照。模型趋势图默认不显示，可开启并选择 7/14/30/90 天范围。
- 模型可按提供商或家族显示/隐藏；默认仅显示 GPT，也可显示全部模型。家族简称统一用于菜单栏、榜单、趋势和站长推荐。
- 菜单栏可切换智商、综合、费用或耗时，并支持序号、图标、详细数值和模型别名。
- 失败时继续展示最后一次成功数据，不会用空榜单覆盖有用状态。
- 只读解析
~/.codex/state_*.sqlite和本机 rollout JSONL，不调用模型，不上传任务内容。 - Token 内容分为上下两张独立卡片：当日总量与根任务 Top 3、每日用量趋势。点击趋势柱可切换到该日任务明细，并可“返回今日”；每次关闭弹窗都会清除日期选择。任务榜单可按设置展开为 Top 5 或 Top 10，悬停柱子仍可查看精确 Token。
- Token 卡显示本机原始 Token 与任务每日额度：完整原生记录使用
=，快照差值和校准估算使用≈。本机 Credits、API 等值成本和相关设置集中在默认关闭的实验性功能中。 - 可选 API 等值成本按输入、缓存读取、缓存写入与输出分项估算，支持每日成本趋势、任务成本和定价覆盖率；它不是 ChatGPT/Codex 订阅账单，菜单栏默认不显示。
- 计算会跟踪中途模型、推理强度与 Standard/Fast 切换，区分缓存命中与免费缓存写入，且不重复计算已包含在输出中的 reasoning Token。字段不完时显示近似或上界，API Key 模式不套用 ChatGPT Credits。
- 活动任务期间每分钟采样账户窗口，原生任务快照每 5 分钟刷新；快照按账户隔离并独立保存。跨日缺测不会归入今天，无可靠基线或校准时额度显示不可用。
- 任务按根任务及全部子任务聚合，标题使用 Codex 在本机保存的具体对话或任务名称；趋势支持 7/14/30/90 天。
- 以累计
total_token_usage.total_tokens去重，把last_token_usage.total_tokens按系统时区记账。cached_input_tokens已属于 input，reasoning_output_tokens已属于 output，不另行重复相加。 - 历史账本默认永久保留；源文件缺失或损坏时保留已记录数据并标记为“不完整”。
- 通过已安装且登录的 Codex/ChatGPT 启动短生命周期
codex app-server --listen stdio://。 - 只请求
account/rateLimits/read，展示权威可用数量、最近过期时间和脱敏详情，并只保留额度窗口的时长、已用百分比与重置时间用于估算。 - 逐卡只缓存并展示发放时间和过期时间，统一转换为北京时间。
- 不保存或输出 access token、refresh token、cookie、说明文字或完整唯一 ID，永不发送
account/rateLimitResetCredit/consume。 - 未安装、未登录、超时或协议不兼容时给出可操作的恢复提示；有缓存时仍显示最后成功状态。
弹窗是一个连续的纵向看板。三个模块默认全部显示，用量分析和重置卡默认折叠，折叠标题显示今日 Token，以及优先选取的周剩余额度与重置卡数量。标题整行都是至少 44pt 高的展开/折叠按钮，刷新按钮仍保持独立。模块可隐藏、拖动排序或用键盘上移/下移。
设置页包含“通用与看板”、“菜单栏”、“智商显示”、“用量分析”、“账户额度&重置卡”和“关于”。模型榜单与 Token 选项按功能分组，数据访问说明集中在“关于 → 数据与隐私详情”。通用页可调整模块顺序、登录启动，以及每小时或每天自动检查更新。新版本会在后台下载；准备完成后设置齿轮显示红点，点击“立即更新”即可让应用自动退出、替换并重新打开。
macOS 26+ 使用原生 Liquid Glass，macOS 14–15 回退为系统 Material。实验性入口可选彩色玻璃、清透玻璃与扁平中性主题，默认不显示且不改变系统设置窗口。动效采用无弹跳的临界阻尼过渡；Reduced Motion 下只保留短交叉淡化。
-
从 Releases 下载 PKG 或 DMG，并下载对应
.sha256。 -
校验文件：
shasum -a 256 -c Codex-Toolbox-1.3.1-universal.pkg.sha256 # 或 shasum -a 256 -c Codex-Toolbox-1.3.1-universal.dmg.sha256 -
**PKG（升级推荐）：**双击安装。它会在新应用验证成功后精确删除
/Applications/Show Codex IQ.app。 -
**DMG（手动拖拽）：**升级前先退出并删除“应用程序”中的
Show Codex IQ.app，再把Codex Toolbox.app拖入 Applications，避免新旧两个应用并存。DMG 内附中文升级说明。
Bundle ID 保持为 io.github.zzzzzzjw.ShowCodexIQ，因此原设置与登录启动偏好可直接继承。旧版累计口径榜单缓存会保留用于回滚，但新版本使用独立的聚合快照缓存，不会混入旧费用和耗时历史。PKG 会请求已运行的旧应用退出；新应用的目标路径、Bundle ID、签名与 Universal 2 架构全部验证成功后，才会删除精确路径 /Applications/Show Codex IQ.app。详见升级与回滚说明。
Note
v1.0.0 尚未内置 Sparkle，因此从 v1.0.0 升级到 v1.1.0 仍需手动安装一次。从 v1.1.0 开始，后续正式版本会通过 Ed25519 与 Apple 代码签名校验，并可在应用内完成更新。
Warning
不要对非官方、未签名或未公证的 PKG 绕过 Gatekeeper。仓库中的本地开发包只用于测试，不是可发布产物。
- macOS 14.0 或更高版本
- Apple Silicon 或 Intel Mac（Universal 2）
- 模型排名需要联网访问公共数据接口
- Token 模块需要当前 Mac 上可读取的 Codex 本地数据
- 重置卡模块需要已安装并登录的 Codex 或 ChatGPT；其他模块不受影响
榜单、兼容历史、站长推荐、官方费率及 API 价格统一通过稳定的数据接口提供，支持动态调整数据与适配上游变化。现有协议范围内的数据和来源调整无需通过软件更新适配。客户端保留有效缓存和用户偏好，区分历史成绩、同步异常和暂无数据。Build 63 修复缓存恢复与推荐回退边界，账户额度、Token 统计及实验功能的默认开关保持不变。详见1.4.1 发布说明。
- 菜单栏固定三个独立槽位，可启停、自选内容并允许重复；新装默认综合榜单、今日 Token、账户剩余额度，仅开启第一项。升级保留已有设置；位置由 macOS 的 Command 拖动管理。
- 即时预览固定在设置顶部，未开启项目呈灰色。榜单、Token 和额度拥有独立样式，Token 支持完整数字或 K/M/B 缩写，额度可选择进度条、圆圈或关闭及彩色/单色。
- “用量分析”保留本机任务排行和每日趋势，不再提供单独账户分析页面。本机所有可读取账户与 API 历史继续保留；不同统计口径不会互相替换或重复累计。
- “账户额度&重置卡”展示套餐、剩余额度、中文北京时间与重置卡；看板样式独立于菜单栏。不查询套餐用量历史。
- 固定版本只读组件区分 ChatGPT、API 与未登录，并读取当前账户的任务累计额度来建立日快照。缓存按账户隔离、拒收旧请求；历史 rollout 身份保持未知，近似校准不会回填账户归属。协议见 NativeAnalytics。
- 当时榜单直连 metrics schema 3；1.4.1 已改用稳定的数据接口，见上节。
Token 总量仅代表当前 Mac 仍可读取的日志；归档或删除的 rollout、未落盘记录、云端及其他设备都不在其中。Credits 是本机事件按公开费率的计算值；API 等值成本来自 OpenAI 官方价格与 models.dev 快照；账户已用比例来自账户接口；任务完整当日原生数据使用 =，部分差值及估算使用 ≈，覆盖范围见悬停提示。
应用级数据存放在：
~/Library/Application Support/CodexToolbox/
旧版 radar-latest.json 和 Application Support/ShowCodexIQ/latest.json 不会被删除，便于回滚；新聚合口径使用独立的 radar-intelligence-efficiency-v2.json，不会迁移旧累计费用和耗时。更完整的边界见隐私说明。
项目使用 SwiftUI、AppKit NSStatusItem、Swift Charts、Observation、URLSession、SQLite3 和 ServiceManagement；应用内更新使用 Sparkle 2。Xcode 工程由 XcodeGen 生成。
brew install xcodegen
xcodegen generate
open CodexToolbox.xcodeproj核心和完整 Xcode 测试：
bash scripts/test_all.shtest_all.sh 会把 SwiftPM 与 Xcode 产物隔离到 /private/tmp，并在结束时终止、注销和清理临时 Debug 应用，不会在 Spotlight 中留下第二个 Codex Toolbox。真实界面手测只安装 PKG，由安装器替换 /Applications/Codex Toolbox.app；不直接启动 DerivedData/Build/Products 中的应用。
本地安装验收使用与正式包相同的 Developer ID 嵌套签名链，但不执行公证、staple 或发布：
bash scripts/build_local_test_pkg.shPKG 安装成功后会始终以当前控制台用户自动启动 Codex Toolbox；是否在安装前运行不影响这一行为。
build_pkg.sh 缺少 Developer ID Application 或 Developer ID Installer 时会立即失败，防止把不可运行的 ad-hoc Hardened Runtime 产物交给用户。正式发布必须使用两类独立证书显式重建：
APP_SIGN_IDENTITY='Developer ID Application: ...' \
INSTALLER_SIGN_IDENTITY='Developer ID Installer: ...' \
bash scripts/build_pkg.sh
NOTARY_PROFILE='codex-toolbox-notary' \
bash scripts/notarize_pkg.sh
APP_SIGN_IDENTITY='Developer ID Application: ...' \
bash scripts/build_dmg.sh
NOTARY_PROFILE='codex-toolbox-notary' \
bash scripts/notarize_dmg.sh证书和公证凭据只存在钥匙串，不写入脚本、环境文件或仓库。PKG 和 DMG 都必须签名、公证并 staple 后才能进入普通（非 Pre-release）GitHub Release。详见发布指南与 DMG 安装说明。
Codex Toolbox 的前身 Show Codex IQ 在 OpenAI Build Week 期间是一个可运行的菜单栏模型榜单原型。仓库保留了用户原有的提交资料与人机协作记录：
- Pre-period baseline: 前六个提交，截止
fb4219f，包含初始骨架、排名/缓存核心、最初的菜单栏 UI 和打包。 - In-period extension: 后续工作增加了三段式权重、趋势、自适应弹窗与菜单栏、模型别名、开源文档、静态链接启动修复与端到端 DMG 验证。
- Primary in-period
/feedbackSession ID:019f60dc-d23e-7ad2-84a2-a739947f1277 - Codex accelerated: 功能实现、截图驱动的 UI 优化、测试、Universal 2 打包、已安装应用诊断和发布验证。
- Human decisions: 紧凑的两行菜单栏体验、用户可调的质量/成本/延迟权重、非破坏性失败行为，以及对界面与打包结果的审阅。
当时的评委指南和完整提交包作为历史资料继续保留，其中的 Show Codex IQ 名称与 DMG 命令反映当时版本。
欢迎提交 Issue 和 Pull Request。开始前请阅读 CONTRIBUTING.md，并确保核心验证器、Swift 测试与完整 Xcode 测试全部通过。
项目代码采用 MIT License发布。第三方数据仍受其来源方条款约束。