故障排查
先确认平台与版本：Windows 当前下载为 v1.0.2，macOS 为 v1.0.2。首次运行步骤见安装指南。
Windows 无法打开或找不到入口
| 现象 | 下一步 |
|---|---|
| 提示缺少 DLL、Python 或后端文件 | 退出后重新完整解压 Windows ZIP，保留所有随包目录；不要单独复制 EXE。 |
| 双击 ZIP 内的程序失败 | 先将整个包解压到自己可写的目录，再打开 CodexUsage.exe。 |
| Windows 提示来源未知 | 核对发行页、文件名和 SHA-256。当前包未作发布者数字签名；遵守本机策略，不关闭全局安全检查。 |
| 关闭主面板后看不到程序 | 查看系统托盘及隐藏图标区；关闭主面板不会退出整个工具。 |
| 浮窗不见了 | 从托盘菜单或主面板设置检查显示方式；隐藏浮窗至托盘会保留托盘入口。 |
| 旧版本仍在运行 | 在旧版菜单明确退出，再运行新解压目录中的程序，避免混用副本。 |
Windows 任务通知没有出现
- 确认已选择监控任务，在任务提醒设置中使用「系统通知＋应用内标记」，且没有暂停任务通知。
- 保存设置后使用「发送测试通知」，查看应用返回的状态，区分未提交、系统限制和提交成功。
- 从同一页面打开「Windows 通知设置」，检查系统总开关及对应应用通知；检查勿扰、专注和全屏自动规则。
- 在可以显示通知的桌面状态下再次测试；也可按 Win+N 查看通知中心。系统若没有保留这条通知，通知中心也可能没有记录。
- 如果应用内消息已到达，可以继续从监控页查看。另一个 Codex 或 ChatGPT 应用的横幅，不能证明本工具的通知成功。
系统忙碌或暂停期间仍记录任务消息，恢复后不会补弹全部旧消息。「已提交」不代表用户已看到；本工具不会用自定义弹窗绕过勿扰。
Windows 任务无法选择或状态待确认
只选择来源能确认正在执行的主任务。检查数据目录是否与任务一致，再点击「检查任务」查看结果与更新时间。事件不完整或来源不可用时保留「状态待确认」，不把没有新日志当作已结束。
当前来源不可靠支持等待审批与失败事件，因此相应提醒不可选。查看消息、标为已读或取消监控都不会继续、停止或批准 Codex 中的任务。任务监控说明 →
Windows 浮窗没有自动收起
检查是否启用了「保持展开」，或菜单仍打开、键盘焦点仍在浮窗操作中。这些状态会保留面板。立即收回可点击「收起」或按 Esc；置顶与保持展开分别设置。
侧签只在有效外边缘启用，显示器连接的接缝不作为隐藏边缘。若位置或交互仍异常，请记录缩放比例、屏幕排列、抓取位置与完整操作顺序。浮窗操作 →
Windows 预算、草稿或设置异常
缺少价格时补齐模型价格并明确选择是否重算本期；官方窗口失效时重新选择有效窗口。预算、设置或任务监控文件损坏时，使用恢复入口先备份再恢复，避免直接删除文件。保存失败时保留草稿并按提示重试，不把旧规则当作修改成功。
macOS Intel 提示“应用程序无法打开”
一个 Intel/macOS 15.7.9 (24G830) 案例中，主程序确认为 x86_64，执行权限和 App 签名完整性均正常，但终端启动报 Operation not permitted。用户移除该 App 的隔离属性后确认能够打开。这支持“此次启动被隔离触发的执行检查阻止”，不代表所有 Intel 启动失败都具有相同原因。
推荐先检查下载包是否匹配芯片，确认从正式发行页下载了原始 Intel ZIP。再按照安装指南尝试系统“仍要打开”或快捷安装助手；已有 App 先按迁移步骤处理。
下载渠道也可能影响隔离标记。Apple 记录过某些下载助手生成的特殊标记阻止已经签名、公证的应用执行的案例。让接收者通过 Safari 直接下载原始发行 ZIP，有助于排除中间传输工具引入的情况，但不会使本项目自动获得公证。Apple 技术讨论
只读诊断
把第一行改为实际安装位置；安装助手默认用 $HOME/Applications，Finder 手动安装可能是 /Applications。
usage_app="$HOME/Applications/Codex用量.app"
sw_vers
uname -m
file "$usage_app/Contents/MacOS/CodexUsage"
ls -l "$usage_app/Contents/MacOS/CodexUsage"
codesign --verify --deep --strict --verbose=2 "$usage_app"
xattr -p com.apple.quarantine "$usage_app"
spctl --assess --type execute --verbose=2 "$usage_app"| 输出或现象 | 如何理解与处理 |
|---|---|
Intel 机器上的可执行文件只有 arm64 | 安装包选错，重新下载 Intel ZIP；Rosetta 不能让 Intel 运行 arm64 App |
codesign 校验失败、ZIP 摘要不符 | 停止安装并重新下载；不要直接修改或重新签名损坏的副本 |
codesign 通过，spctl 拒绝 | 完整性与系统信任是不同检查；当前版本未公证，不代表下载一定损坏 |
xattr 提示没有这个属性 | 该层文件没有此属性，本身不代表 App 损坏 |
Operation not permitted | 结合隔离和策略检查判断，不能只凭此句确定唯一原因 |
Permission denied、缺失动态库或启动后崩溃 | 保留完整错误，继续排查权限、依赖或运行兼容性 |
系统若明确提示检测到恶意软件，请停止使用该副本。公司管理的 Mac 可能存在额外策略，应联系管理员处理，不能依赖安装脚本越过组织策略。
macOS 安装助手停止了
| 提示 | 下一步 |
|---|---|
| 已有 App，未覆盖 | 先退出并移走旧 App，或指定独立测试目录；无需删除 Codex 数据 |
| 安装包校验失败 | 使用对应架构的原始 v1.0.2 ZIP，不能重新压缩或使用 Source code 包 |
| 没有交互终端 | 在 macOS「终端」中先下载脚本到文件，再用 /bin/bash 执行 |
| 不要使用 sudo | 以当前用户运行，使用 ~/Applications 或其他可写目录 |
| 下载失败 | 检查网络，或预先下载 ZIP 后使用 --archive |
| 安装锁目录已存在 | 确认另一个安装已结束；若上次被强行中止，再删除提示的空锁目录重试 |
安装助手已通过 PR #1 于 2026-09-11 合并到 main。当前助手下载 v1.0.2 App；版本更新不代表新增 Apple 公证，也不代表所有实体 Intel 设备均已验收。
没有统计、数字没变或额度为“—”
- 确认这台电脑已安装并使用过 Codex，应用选中的日志目录正确。
- 检查主面板和浮窗各自的时间、模型、任务筛选，避免用不同范围进行比较。
- 首次历史索引需要等待；手动刷新只能读取已经落盘的记录。
- 账号额度另行查询。确认本机 Codex 登录状态；未知或旧快照不等于额度为零。
完整说明见统计口径与隐私。
macOS 菜单栏或浮窗不见了
先检查是否选择了「仅状态栏」「仅保留胶囊」或「退出」，并区分隐藏窗口和退出整个应用。也可以确认系统是否隐藏了对应菜单栏项目。若状态没有恢复，先退出整个 App，再从确定的安装路径重新打开，避免混用两个副本。
正常情况下，普通打开/关闭/隐藏主面板不应连带退出菜单栏或浮窗；如果仍可复现，请记录操作顺序和 App 版本反馈。鼠标行为与快捷键见使用指南。
内存为何超过 10 MB
常驻界面虽没有闲置常驻 Python，仍有原生框架、字体、菜单、绘图与系统缓存成本。历史负载、是否打开过主面板及短时额度查询都会改变观察值。Windows 工作集与 macOS physical footprint 不是同一口径，不应直接比较；项目没有承诺所有状态低于 10 MB。详见架构和验证记录。
提交可复现的问题
请提供 macOS 版本与芯片、App 版本、下载来源与文件名、复现步骤、预期/实际结果及必要的错误信息。提交前检查并隐藏个人用户名或敏感路径；不要上传聊天日志、凭据、auth.json 或整个数据目录。
为什么安装后圆弧仍是绿色
先确认 App 已更新到 v1.0.2；v1.0.0 使用固定绿色。v1.0.2 在高剩余额度时仍显示绿色，额度降低后才逐渐转黄、橙、红；颜色对应账号额度，并不由筛选后的 Token 数决定。具体规则见额度弧线配色。