Windows 上轻盈、透明的 Codex 剩余用量监控工具
A lightweight Codex quota monitor for Windows.
界面预览使用示例数据；应用会显示当前 Codex 账号实际返回的配额周期。
Codex Quota Monitor 常驻 Windows 桌面和系统托盘，通过本机 codex app-server 读取当前 ChatGPT 账号的 Codex 配额。无需打开 Codex 窗口，也能快速看到剩余比例、配额周期和重置时间。
| 功能 | 说明 |
|---|---|
| 透明毛玻璃悬浮窗 | 浅色、圆角、始终置顶，可拖动到桌面任意位置 |
| 托盘百分比 | 系统托盘图标直接显示当前剩余百分比 |
| 双周期配额 | 显示 Codex 实际返回的短周期与长周期配额 |
| 重置倒计时 | 显示距离下一次配额重置还有多久 |
| 自动与手动刷新 | 每 60 秒自动刷新，也可从窗口或托盘立即刷新 |
| 位置记忆 | 自动记住悬浮窗位置，并适配多显示器变化 |
| 安全本地读取 | 复用 Codex CLI 登录状态，不保存账号、密码、Token 或 Cookie |
| 不干预任务 | 只监控用量，不会暂停、停止或修改任何 Codex 任务 |
- Windows 10 1809 或更高版本，64 位系统。
- 已安装 Codex CLI，并能在终端运行
codex --version。 - Codex CLI 已登录需要监控的 ChatGPT 账号；如未登录，请运行
codex login并选择 Sign in with ChatGPT。
- 前往 Releases，下载
CodexQuotaMonitor-V1.0-win-x64.zip。 - 解压 ZIP，双击
CodexQuotaMonitor.exe。 - 悬浮窗会出现在桌面，托盘区域会显示剩余百分比图标。
Important
V1.0 是未购买商业代码签名证书的开源构建，Windows 可能显示“未知发布者”。请只从本仓库 Release 下载，并核对 Release 页面提供的 SHA-256。
程序为自包含单文件绿色版，不需要另行安装 .NET，也不会写入注册表或创建开机启动项。
| 操作 | 效果 |
|---|---|
| 拖动卡片空白区域 | 移动悬浮窗 |
| 点击刷新按钮 | 立即读取最新配额 |
| 点击最小化按钮或关闭窗口 | 隐藏到系统托盘 |
| 双击托盘图标 | 显示或隐藏悬浮窗 |
| 托盘右键菜单 | 显示/隐藏、立即刷新或退出程序 |
只有托盘菜单中的“退出”会结束程序；关闭悬浮窗只是将它隐藏到托盘。
Codex Quota Monitor
│
├─ 启动本机 codex app-server --stdio
│
├─ account/read
└─ account/rateLimits/read
│
▼
悬浮窗 · 托盘 · 倒计时
程序优先从以下位置寻找 Codex CLI：
- npm 全局安装目录；
- 常见本地安装目录；
- Codex Windows 桌面版的本地程序目录；
- 系统
PATH。
Codex 返回哪些配额周期，程序就展示哪些周期；缺失的周期会显示 --，不会猜测或伪造数据。协议说明可参考 OpenAI 官方的 codex app-server README。
程序不会保存：
- ChatGPT 账号或邮箱；
- 密码、Token、Cookie 或登录凭据；
- JSON-RPC 原文或 Codex 标准错误内容；
- 配额历史记录。
本地仅保存窗口位置和经过白名单过滤的诊断事件：
%LOCALAPPDATA%\CodexQuotaMonitor\settings.json
%LOCALAPPDATA%\CodexQuotaMonitor\logs\monitor.log
诊断日志不会记录可执行文件路径、账号信息或认证数据。
本版本聚焦“稳定查看当前配额”，暂不包含：
- 历史趋势和消耗统计；
- 消耗速度与预计耗尽时间；
- Windows 阈值通知；
- 开机启动与自动更新；
- 自动暂停或停止 Codex 服务。
尤其是最后一项：本工具只读监控，不会干预你的工作流。
显示“未安装”
确认终端中执行 codex --version 能正常返回，然后重新启动监控工具。程序会检查系统 PATH、npm 全局目录、常见本地安装目录和 Codex 桌面版目录。
显示“未登录”
运行 codex login，选择 ChatGPT 登录方式，再点击立即刷新。部分 Codex 桌面版和 CLI 版本可能不共享登录状态，因此即使桌面版已登录，也可能仍需为 CLI 登录一次。
某个周期显示 --
这表示 account/rateLimits/read 没有返回该周期。不同账号、套餐或 Codex 版本可能返回不同的配额窗口。
显示“连接异常”或“数据陈旧”
先点击立即刷新；若仍然失败，请检查 codex login status，升级 Codex CLI 后重新启动本工具。app-server 仍属于 Codex 的实验性接口，未来协议变化可能需要同步更新本项目。
需要 .NET 8 SDK。在项目根目录运行：
powershell -ExecutionPolicy Bypass -File .\scripts\build.ps1生成自包含单文件 EXE 和发布 ZIP：
powershell -ExecutionPolicy Bypass -File .\scripts\publish.ps1输出位置：
artifacts\win-x64\CodexQuotaMonitor.exe
outputs\CodexQuotaMonitor-V1.0-win-x64.zip
当前测试套件包含 139 项自动化测试，覆盖 JSON-RPC、配额映射、刷新生命周期、托盘图标、窗口行为和安全日志等关键路径。
本项目使用 MIT License。
Codex Quota Monitor 是社区开源项目，与 OpenAI 不存在隶属或背书关系。Codex、ChatGPT 和 OpenAI 名称及相关商标归其各自权利人所有。
轻量监控，安心使用 Codex。