Codex 额度小组件

English

Codex 额度小组件是一个桌面悬浮工具。它通过本机已登录的 Codex 读取额度信息，并用面板或悬浮球展示 5 小时额度、周额度、上周与本周额度估算、剩余重置次数、刷新时间和重置时间。

功能介绍

• 面板模式：三个数据栏可分别选择 5 小时窗口、周窗口、重置次数或额度估算，并允许重复。
• 套餐默认：Plus 为“5 小时窗口 / 周窗口 / 额度估算”，其他或未知套餐为“额度估算 / 周窗口 / 重置次数”。
• 仪表与悬浮球：可在设置中选择展示 5 小时额度或周额度，新配置默认周额度。
• 边缘吸附：悬浮球可贴靠屏幕左右边缘，减少遮挡。
• 状态颜色：正常为绿色，偏低为黄色，不足、耗尽或错误为红色，读取中为蓝色。
• 自动刷新：默认每 5 分钟刷新一次，也会根据额度重置时间补充刷新。
• 自动更新：默认开启，通过 GitHub Releases 下载并安装更新。
• 开机自启：默认关闭，可在设置中开启，仅对当前用户生效。
• macOS 菜单栏模式：可隐藏 Dock 图标，仅保留顶部菜单栏图标作为应用入口。
• 主题切换：设置中可选择主题。
• 中英文界面：设置中可切换中文和 English，默认中文。

主题展示

默认主题

基础主题 1

基础主题 2

基础主题 3

使用教程

1. 安装并登录 Codex。
2. 启动本应用。
3. 首次启动后，应用会自动探测本机 codex 或 codex.exe。
4. 如果读取失败，打开设置，手动选择 codex 或 codex.exe 路径。
5. 查看主面板中的三个数据栏；需要时可在设置中调整每栏内容和仪表窗口。
6. 点击圆形按钮切换悬浮球模式；双击悬浮球可回到面板。

设置说明

• Codex 路径：留空时自动探测；填写后优先使用该路径。
• 自动更新：关闭后不会检查、下载或安装 GitHub Releases 更新 (可能需要配置本地代理)。
• 自动更新代理：用于 GitHub 自动更新和 ChatGPT 额度过期时间接口，不影响 Codex CLI 主额度读取。支持 http://、https://、socks5://。
• 开机自启：登录系统后自动启动本应用，仅当前用户生效。
• 隐藏 Dock 图标：仅 macOS 显示。保存后立即隐藏或恢复 Dock 图标，隐藏时仍可通过顶部菜单栏图标显示窗口或退出。
• 刷新分钟：自动刷新间隔，范围为 1-1440。
• 主题：可选择默认主题、基础主题 1、基础主题 2、基础主题 3，保存后重启仍保留。
• 语言：可选择中文或 English。
• 仪表窗口：选择仪表和悬浮球展示 5 小时额度或周额度，默认周额度。
• 数据栏 1/2/3：每栏可选择 5 小时窗口、周窗口、重置次数或额度估算，允许重复。未自定义时按套餐采用默认布局；保存自定义后不再随套餐变化。
• 数据缺失：所选 5 小时窗口或其他数据不可用时显示 --，不会自动替换成另一项。

额度估算与计算公式

额度估算表示“100% 周额度对应的 Token API 等价值”，用于观察周额度的大致价值，不是 OpenAI 实际账单。界面将达到样本和跨度门槛的结果四舍五入为整数美元；门槛不足时显示 --。

数据来源与周期

应用首次流式扫描 CODEX_HOME/sessions 和 CODEX_HOME/archived_sessions 最近 16 天的本地会话日志，后续刷新在进程内复用未变化的 rollout。文件增长时会流式重读整个旧前缀并校验内容摘要，一致时只解析新增部分；因此增量刷新仍有旧内容的读取开销，但省去重复解析。文件被截断、重写或尾行不完整时自动完整重读。读取失败或提前结束时不提交不完整缓存。摘要仅用于检测普通日志重写，不作为安全认证机制。

扫描只提取模型、Token 用量、周额度百分比、重置时间及本机 reserve 活动时间，跨文件事件排序保留亚秒时间精度。同一 rollout 在归档移动期间出现重复副本时只读取较新的文件。累计 Token 指纹用于文件内费用去重：首次有效事件计费一次，缺少有效时间或周额度的记录不占用指纹；同一用量后补的百分比或重置时间变化仍保留，已计价用量不重复计费，原费用未知时仍保持未知。完全重复的额度记录忽略。event_msg/token_count 的 rate_limits.limit_name（兼容 limitName）严格等于 gpt-reserve 时，只保存有效活动时间，不计费、不占用主额度去重指纹、不形成估算周期；无需可计价模型或周窗口，重复计量记录仍可提供活动证据。

周窗口按 10080 分钟识别；30 分钟内漂移的重置时间视为同一周期，当前周期允许与实时重置时间相差 2 小时，上周期取此前最近的有效周期。本周期尚无本地事件时，仍可展示上周期估值；此时候选重置时间须早于实时重置时间超过 2 小时，再按最近活动时间选择。

codex-auto-review 按 GPT-5.4 价格估算，正常参与费用累计和候选计算。其他无法公开计价的模型不会猜价，并会切断当前样本段。新样本段从新的额度百分比和费用基线开始，避免未知模型影响后续估算。

内置价格表

价格表日期：2026-10-08。价格单位均为“美元 / 百万 Token”，列顺序为输入、缓存输入、输出。