Windows v0.10.1 — 自动更新与客户端更新恢复

Windows v0.10.1（预发布）

• 默认每 6 小时检查本仓库的 Windows Release，下载更高版本并自动更新插件后台。
• 下载前后验证 SHA-256、包内文件清单和解压路径；安装失败自动恢复旧版本，保留自定义路径和更新设置。
• 新增 Update.cmd 手动立即检查；Status.cmd 可查看更新状态，管理脚本的 UpdatesOff / UpdatesOn 可关闭或开启自动更新。
• 修复 Microsoft Store 更新删除旧客户端路径后，插件后台无法识别新客户端的问题。
• 补充系统拒绝正常退出时的诊断信息。

安装

完整解压 CodexUsageBadge-Windows-0.10.1.zip，运行 Install.cmd。已经安装 v0.10.0 或更早版本的用户，需要手动升级这一次；之后即可自动更新。

后续发布方式

发布标签 vX.Y.Z-windows，并附上生成的 CodexUsageBadge-Windows-X.Y.Z.zip 和同一批 SHA256SUMS.txt。仅推送源码或保存 Release 草稿不会触发自动更新。

本次只发布 Windows 安装包。无需 GitHub 登录令牌或管理员权限。

macOS v0.9.4 · 自动更新

macOS 安装包新增自动更新。安装后每 6 小时检查本仓库的 macOS Release，发现更高版本后，校验安装包并在后台升级。

• 校验 GitHub SHA-256、包内文件清单、版本与来源，拒绝降级和不安全 ZIP 路径。
• 安装失败恢复原文件与后台服务，更新期间不重开 Codex。
• 保留容量显示、Token 对齐修复、深浅主题和原图标自动加载。
• 提供检查、开启和关闭自动更新脚本；关闭设置随升级保留。

旧用户请先手动安装一次本版本。下载 CodexUsageBadge-macOS-0.9.4.zip，完整解压后运行 安装.command。之后可继续从原 Codex 图标启动。

维护者发布更高版本的 macOS Release 并上传对应 ZIP，即可让已启用更新器的用户自动升级。只推送源码不会触发更新。

本次仅更新 macOS，Windows 安装包仍为 v0.10.0。

macOS v0.9.3 · 文件夹容量

本地项目名称旁新增文件夹容量显示，按 KB、MB、GB 等单位显示，自动计算并缓存刷新。

• 保留 GPT/Codex 模式下的 Token 对齐修复和深浅主题配色。
• 后台只读统计目录占用；路径失效或访问失败时显示 —，停止插件会取消扫描。
• 沿用原 Codex 应用图标自动加载。
• 已通过完整自动化测试、macOS 原生启动测试和源码/安装包隐私检查。

下载 CodexUsageBadge-macOS-0.9.3.zip，完整解压后运行 安装.command。支持 Apple Silicon 和 Intel，升级方式与首次安装一致。

本次更新 macOS 安装包；Windows 下载仍为 v0.10.0。

macOS v0.9.2 · Token 色块对齐修复

修复 GPT 模式下侧栏 Token 色块换行、与会话标题错位的问题（#2）。色块与标题保持同排居中，长标题正常缩略，保留行高、状态点、时间和第二行说明。

本次仅更新 macOS，支持 Apple Silicon 和 Intel。Windows 下载仍为 v0.10.0。

下载 CodexUsageBadge-macOS-0.9.2.zip，完整解压后运行 安装.command 即可安装或升级。校验值见 SHA256SUMS.txt。

Windows v0.10.0 · 原生图标自动加载

本次仅更新 Windows。macOS 保持 v0.9.1。

Windows 更新

• 安装后可直接使用原来的 Codex 图标，后台自动完成加载。
• 支持 Microsoft Store 原生应用激活，修复重开时的“拒绝访问”。
• 浅色/深色额度圆环、项目颜色与 Token 显示沿用 v0.9.1 的主题适配。
• 移动鼠标不会阻止加载；开始点击、滚动或输入时会跳过自动重开，避免打断操作。
• 改进旧桌面入口迁移、后台就绪检查、失败回滚和诊断信息。

安装或升级

1. 下载 CodexUsageBadge-Windows-0.10.0.zip 并完整解压。
2. 运行 Install.cmd。首次安装前请先打开并登录 Codex，让客户端准备好内置运行组件。
3. 从菜单或托盘完全退出 Codex，再使用原来的 Codex 图标打开。窗口可能短暂消失并重开一次，等待加载完成后再点击或输入。

需要 Windows 10/11、Windows PowerShell 5.1 和 Node.js 24+。安装器优先使用客户端自带运行环境。详见 Windows 使用说明。

验证与限制

已通过 Windows 安装、升级、卸载、原生退出/拒绝和界面回归测试，并完成 Windows 10 / Microsoft Store Codex 的原生激活、自动重开和三个界面组件加载实测。

此版本仍为预发布：已有窗口、背景启动、用户已操作、特殊启动参数、端口占用或短时间重复启动时，自动加载会跳过。关闭窗口但仍驻留托盘不等于完全退出。其他设备、任务栏入口和客户端更新后的兼容性仍需验证。

本次附件只有 Windows 安装包及其 SHA-256 校验文件。下方 GitHub 自动生成的 Source code 是源码，不是安装包。

v0.9.1 · 浅色主题优化

浅色主题配色优化。

• 额度条改为浅灰白底、深色文字，绿／黄／红圆环更清晰。
• 调整 Token 色块和文件夹颜色，提高浅色界面的辨识度。
• 配色跟随客户端或系统主题切换，兼容 Plus 双圆环。

下载对应系统的 ZIP，完整解压后运行 安装.command（macOS）或 Install.cmd（Windows）即可安装或升级。校验值见 SHA256SUMS.txt。

v0.9.0 · 原图标自动加载

macOS 现可从原来的 Codex 图标启动并自动加载插件，不再需要独立启动入口。升级时会清理旧快捷方式，并加入用户操作检测、退出超时和防循环重开保护。

项目首页已精简，详细安装说明按系统拆分。macOS 包内含 Apple Silicon / Intel 通用启动助手；Windows 保留现有桌面入口。

下载对应系统的 ZIP，完整解压后运行 安装.command（macOS）或 Install.cmd（Windows）。校验值见 SHA256SUMS.txt。

v0.8.0 · macOS / Windows 公开测试版

首次公开预发布版本，包含 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。