Repository navigation
v0.8.0 · macOS / Windows 公开测试版
Pre-release
Pre-release
首次公开预发布版本,包含 macOS 和 Windows 独立安装包。
下载与安装
- macOS:下载
CodexUsageBadge-macOS-0.8.0.zip,完整解压后运行安装.command。 - Windows:下载
CodexUsageBadge-Windows-0.8.0.zip,完整解压后运行Install.cmd。 - 安装完成后完全退出客户端,再使用桌面「Codex 用量条」入口打开。
- 需要已登录的 Codex 桌面客户端及 Node.js 24+。优先使用可用的客户端内置 Node;找不到时请安装 Node.js 24 LTS。
- 请下载上面的专用 ZIP,不要使用下方自动生成的 Source code 包进行安装。
功能
Plus 双额度圆环、Pro 周额度、按剩余比例变色;七种项目文件夹颜色;会话 Token 蓝色色块,悬停使用亿/千万/万单位显示累计数量。后台刷新不会打开、重启或激活客户端。
公开发布处理
移除个人目录、账号信息、聊天标题、截图、日志、数据库及安装状态;改为自动寻找用户自己的客户端和数据目录。源码可独立构建,运行包使用 Node.js 标准库,不捆绑第三方库或客户端二进制。提供安装、诊断、卸载、失败回滚和 MIT 许可。
验证
该版本的 macOS / Windows CI 均已通过。包含界面与数据回归、脱敏扫描、压缩包校验,以及 Windows PowerShell 5.1 真实 COM 快捷方式、隐藏后台、单实例、停止/重启和卸载测试。修复了实际测试暴露的 PowerShell 5.1 配置更新与中文路径快捷方式问题。
当前仍为预发布版:Windows CI 使用合成客户端夹具,不能代替各版本已登录 Codex 客户端的 UI 和长期运行验收。依赖客户端内部结构;WSL、远程和云端会话暂不跨环境读取 Token 数据。调试端口仅供本机使用,请勿转发到网络。
校验文件:SHA256SUMS.txt。详细步骤及隐私说明见仓库 README / SECURITY.md。