CodexQuotaSafe

CodexQuotaSafe 是一款 Windows 桌面的 Codex 额度查看工具。它以常驻右下角的轻量窗口显示短周期额度、周周期额度、Credits 与 reset credits（重置券）状态，适合希望随时确认额度、又不想一直打开完整客户端的用户。

本项目是独立的社区派生项目，不是 OpenAI 官方产品，也不是 WindexBar 的官方版本；OpenAI 与 WindexBar 作者均不为本项目背书或负责。

截图

完整模式

Mini 模式

功能

• 显示短周期额度、周周期额度、Credits 与 reset credits 状态；
• 完整窗口默认置顶停靠在桌面右下角；
• 可切换为只保留核心额度与刷新按钮的 mini 模式；
• 默认每 5 分钟刷新，并阻止多个刷新任务重叠；
• 查询超时或 account/rateLimits/read 返回 RPC 错误时，会关闭本次查询进程，使用一个新的 Codex CLI 进程额外尝试一次；
• 查询失败时保留最后一次成功数据，不用错误结果覆盖已有额度。

运行

1. 完整解压便携包，不要只取出主程序。
2. 确保 CodexQuotaSafe.exe、codex-cli.exe、随附的原生运行库和许可文件位于同一目录。
3. 如尚未登录 Codex CLI，请先按 Codex CLI 的官方说明完成 ChatGPT 登录。
4. 运行 CodexQuotaSafe.exe。

程序默认每 5 分钟刷新一次。单次查询先等待 20 秒；如发生超时或额度 RPC 返回错误，程序会结束该 CLI 进程，启动一个新进程再等待 30 秒。两次均失败时才显示错误。程序不会无限等待，也不会并行叠加刷新。

mini 模式使用普通置顶窗口贴边实现，不注入或修改 Windows 任务栏，也不调用 Shell 私有接口。

Codex CLI 与数据边界

CodexQuotaSafe wrapper 本身没有实现 OpenAI HTTP/API 客户端。它启动随包提供的官方 OpenAI Codex CLI，并通过 app-server 的标准输入输出请求 account/rateLimits/read；认证和与 OpenAI 服务的网络通信由 Codex CLI 负责。

wrapper 不直接解析 Codex 的认证文件、浏览器 Cookie、API Key、对话数据库、conversation/thread 内容或会话日志。Codex CLI 在正常运行中仍会按照自身规则使用其凭据与配置。当前固定并验证的组件是 Codex CLI 0.146.0；启动前还会检查固定 SHA-256 和 Authenticode 签名主体。完整边界见 SECURITY.md。

从源码构建

要求：

• Windows x64；
• .NET SDK 10.0.301（仓库中的 global.json 会固定该版本）；
• 生成完整便携包时，需要官方 Codex CLI 0.146.0 的 Windows x64 codex.exe/codex-cli.exe 文件。

普通开发构建不强制要求 Codex CLI：

dotnet restore .\src\CodexQuotaSafe.App\CodexQuotaSafe.App.csproj -r win-x64
dotnet restore .\tests\CodexQuotaSafe.Core.Tests\CodexQuotaSafe.Core.Tests.csproj
dotnet test .\tests\CodexQuotaSafe.Core.Tests\CodexQuotaSafe.Core.Tests.csproj -c Release --no-restore
dotnet build .\src\CodexQuotaSafe.App\CodexQuotaSafe.App.csproj -c Release -r win-x64 --no-restore

完整 self-contained、single-file 发布必须显式提供 CodexCliPath。该路径必须指向官方 codex-cli.exe；构建会把它以固定文件名复制到发布目录：

dotnet publish .\src\CodexQuotaSafe.App\CodexQuotaSafe.App.csproj `
  -c Release `
  -r win-x64 `
  --self-contained true `
  -p:PublishSingleFile=true `
  -p:PublishTrimmed=false `
  -p:CodexCliPath="C:\path\to\codex-cli.exe"

来源与许可

CodexQuotaSafe 从 MIT 许可的 WindexBar v2.1.1（commit d1fb9576968febd61cdfe3bcc571d382350aaf30）派生。上游提供了重要的 Codex app-server / rate-limits 通信实现基础；本项目随后对其进行了改写和收缩，并修改了产品定位、WPF 界面、mini 模式、进程安全处理、固定 CLI 校验以及刷新与重试流程。详见 NOTICE.md。

本项目源码按 MIT License 提供。二进制便携包另含 Codex CLI 及 .NET self-contained 运行组件，它们适用各自的许可与通知；索引见 THIRD-PARTY-NOTICES.md。