Skip to content

Repository files navigation

余量 · Codex Badge

余量 · Codex Badge

Codex 还剩多少,一眼就知道。

Windows 上的 Codex 额度胶囊 · Codex usage monitor for Windows

v0.3.2 正式发布 Windows 10 / 11 x64 Tauri 2 MIT license

下载 · 开始使用 · 日常操作 · 反馈 · English

把剩余额度留在眼前,把注意力留给工作。余量贴合 Codex 侧栏,根据接口返回优先显示 5 小时剩余百分比,只有周窗口时显示本周剩余;悬停展开本周剩余、重置时间和重置机会,不必切换页面。

余量 Tauri 界面示意:毛玻璃、跟随系统浅色、跟随系统深色;显示 5 小时和每周剩余额度、重置时间与重置机会
当前界面风格示意 · 示例数据 · 两个主题选项:毛玻璃 / 跟随系统

下载

v0.3.2 · Windows 10 / 11 x64 · 正式发布版本

安装版 · 推荐 便携版
下载安装器 下载 ZIP
按提示安装后运行 解压后运行 codex-badge-tauri.exe

更新说明 · SHA-256 校验

无需 .NET。需要 WebView2 Runtime、已登录的 Codex Windows 桌面客户端和可用的 Codex CLI;安装器可引导下载 WebView2。程序尚未签名,首次运行可能出现 Windows 安全提示,请确认来自本仓库。

开始使用

  1. 安装或解压,运行余量。
  2. 打开已登录的 Codex,胶囊自动出现。
  3. 右键胶囊或托盘图标开启置顶模式;在**设置 ›**中选择开机启动或系统通知。

余量在后台运行时,会随 Codex 打开而显示、退出而收起;从托盘选择“退出”后,需要手动重新启动余量。

日常操作

操作 效果
悬停胶囊 展开 5 小时、本周剩余和重置时间
点击“查看” 查看重置机会的到期时间(有可用详情时显示)
滚动鼠标滚轮 切换毛玻璃 / 跟随系统;系统主题自动适配明暗
拖动胶囊 调整位置,普通模式和置顶模式分别记忆
右键胶囊或托盘 置顶模式、设置 ›、退出;设置内可切换开机启动和系统通知
双击胶囊 恢复当前模式的默认位置

普通模式随 Codex 最小化隐藏;置顶模式可在 Codex 最小化时继续显示。Codex 退出后,两种模式都会收起。

常见问题

没有看到胶囊? 确认余量正在运行、ChatGPT/Codex 主窗口已经打开。普通模式下,客户端最小化时不会显示。v0.3.2 已适配新版 ChatGPT 的布局变化;胶囊位置不合适时可双击恢复默认位置。

显示 --%? 确认 Codex 已登录,且 Codex CLI 可用。找不到 CLI 时,可将环境变量 CODEX_BADGE_CLI 设置为 codex.exe 的完整路径。

更新或移动便携版? 先关闭开机启动,再退出正在运行的版本;运行新版本后按需重新开启。开机启动会记住程序所在路径。从 v0.2.x 升级需重新设置主题与位置。

本版重点修复新版 ChatGPT 导致的胶囊定位问题,并统一菜单与提示框绘制。125%缩放已进行实机检查;其他缩放、跨屏及安装升级仍在持续验证。查看发布说明

隐私与反馈

通过本机 codex app-server 只读获取额度,不读取 auth.json、不发送模型请求,不上传登录凭据。设置和诊断日志保存在本机 %LOCALAPPDATA%\CodexBadge。

发现问题?提交反馈,附上复现步骤、显示缩放和主题即可。截图或日志请先检查隐私,不要上传凭据。

开发与构建 · MIT License

第三方开源工具,非 OpenAI 官方产品。

v0.3.2 更新

设置 › 检查更新可查看版本与更新说明。安装版支持用户主动点击一键更新;绿色版请从发布页下载 ZIP 手动替换。不会自动检查、下载或安装。更新包使用独立签名校验,但这不等于 Windows Authenticode 代码签名。

English overview · 如果余量对你有帮助,欢迎给项目一个 Star。

About

A lightweight Windows badge for Codex usage limits, reset times, and reset credits. Tauri 2 / Rust. 余量

Topics

Resources

Stars

6 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages