Releases: Asher-XunZhang/codex-usage
Release list
v1.0.2 · macOS 与 Windows 桌面版
macOS 与 Windows v1.0.2 均可在下方下载。macOS 两种芯片的安装包于 2026 年 9 月 15 日补充发布，已有 Windows 资产保持不变。
macOS v1.0.2 更新
- 任务监控：主面板新增监控页，支持本轮／持续提醒、未读消息与系统通知；关闭主面板后继续运行。
- 预算与设置：预算提醒、缺价诊断、官方额度窗口选择、统一设置、主题继承与菜单栏详情。
- 浮窗交互：圆环连续变为展开面板，整个可见区域可拖动，按位置选择展开方向；四边及两屏接缝可贴合隐藏，持续拖动仍可跨屏。
- 修正与优化：修复收起按钮重叠导致重开、鼠标移出不收起及光晕遮挡，后端事件等待减少闲置轮询。监控和预算不新增闲置常驻 Python 进程。
macOS 下载与安装
| 芯片 | 安装包 |
|---|---|
| Apple Silicon（M 系列） | Apple Silicon ZIP |
| Intel | Intel ZIP |
可下载独立 install.sh，在终端交互运行以自动选择芯片并核对固定摘要；无需另装 Python、Homebrew 或管理员权限。手动安装请完整解压，将 Codex用量.app 放入应用程序目录。更新前退出并移走旧 App，保留支持目录、偏好与 Codex 日志。
安装指南 · macOS 使用指南 · 两端差异
验证与源码
macOS 最低构建目标为 11，App 版本为 1.0.2 / 102，采用 ad hoc 签名，未经 Developer ID 签名或 Apple 公证。两种架构经过独立构建、签名完整性、运行时及 ZIP 源码资源校验。本机完整检查 401 项，348 通过、53 按平台条件跳过；用户已确认收起重叠修复、两屏接缝贴合隐藏与跨屏拖动正常。最终 CI 与源码链接见下方。
系统通知横幅已观察到；正文点击／冷启动、实体 Intel 和完整拔屏／Spaces／休眠路径尚未全部实机验收。未给出整机耗电收益百分比。
原有 v1.0.2 标签继续对应 Windows 源码，未移动。 新 macOS 包对应下方独立列出的源码提交；每个 ZIP 自带 source/，App 内 Contents/Resources/BUILD-INFO.json 记录编译来源与源码摘要。GitHub 自动生成的旧标签 Source code 不包含此次新增 macOS 实现。安装助手在最终 ZIP 定稿后独立固定摘要，因此包内旧脚本可能指向 v1.0.1，安装请使用本页独立脚本。
macOS source commit · PR #13 · CI
SHA-256
| File | SHA-256 |
|---|---|
codex-usage-desktop-v1.0.2-AppleSilicon.zip |
630118772effc4272fb7a2f0ff757e9507a57b89be154f976b940deddc4286af |
codex-usage-desktop-v1.0.2-Intel.zip |
9566a571450977b14b56f119cdd9cc2165d0ca20cbeb6070dc737b6daa84f695 |
install.sh |
47c9d771d093a93d6adf0a801f777e26bbf87a366466d6df264a88e0a709761b |
Apple Silicon .sha256 · Intel .sha256 · install.sh.sha256
Windows v1.0.2 (original release)
Windows 桌面版现已发布，可通过主面板、浮窗和托盘查看 Codex 用量、管理预算并监控任务。
主要功能
- 用量概览：查看账号额度、本地 Token 用量与每日趋势，按时间、模型和任务筛选，支持明细搜索及 CSV 导出。
- 预算管理：设置用量预算与提醒阈值，随时编辑、暂停或恢复。
- 任务监控：选择本轮或持续监控，查看执行状态与未读消息，支持取消监控和清理已结束任务。
- 桌面浮窗：支持圆环与展开面板切换、自由拖动、贴边隐藏，以及深浅主题；收起时也能查看额度和监控状态。
问题修复
修复了先启动 Codex 任务、数分钟后再打开本应用时，部分正在执行的任务呈灰色、提示无法确认开始记录，因而无法加入监控的问题。现在可从已有记录识别这类任务，并自动重新核对旧的异常状态，无需重新执行任务。
Windows 下载包已于 2026 年 9 月 13 日更新，版本号仍为 v1.0.2。此前下载过此版本的用户，请重新下载下方 ZIP，以获得该修复。
下载与使用
下载 codex-usage-desktop-v1.0.2-windows-x64.zip，完整解压后运行 CodexUsage.exe。请保留解压后的完整目录；无需另行安装 Python 或 .NET。
Windows 使用说明 · 任务监控 · 预算管理
使用说明与已知限制
- 任务监控依赖本机可读取的任务记录；“本轮结束”不代表整个需求已完成。
- 系统通知横幅及点击跳转尚未完成实机验证，请同时关注应用内状态与未读标记。
- 当前 Windows 应用尚未进行代码签名。
文件校验与源码信息
ZIP 的 SHA-256（也可下载同名 .sha256 文件）：
3fe05cda4cd7c672c823b828ebda2a25da88d5c13e9c6d7919d1aff3417e9ab0
v1.0.2 源码标签已同步更新至包含修复的提交；此前获取过该标签的开发者需重新获取。
修复详情（PR #12） · 构建与验证记录 · 验证范围
v1.0.1 · 额度弧线配色与安装文档更新
v1.0.1 为 macOS 桌面版更新，包含已合入的额度弧线配色及配套文档。
- 收起浮窗的额度弧线随剩余额度由绿经黄、橙连续转为红色，深浅主题分别适配；5% 及以下保持警示红，0% 或未知额度显示中性底环。
- 颜色复用现有额度动画，不增加常驻刷新计时器。
- 更新 README、配色说明与示意图，并提供完整的 使用文档站。
- 独立安装助手自动选择 Apple Silicon / Intel，使用固定 SHA-256 验证本版 ZIP。
下载与安装：
- M 系列 Mac：下载
codex-usage-desktop-v1.0.1-AppleSilicon.zip。 - Intel Mac：下载
codex-usage-desktop-v1.0.1-Intel.zip。 - 安装助手：下载本页的
install.sh，阅读后在终端运行/bin/bash ./install.sh；或按 安装指南 操作。已有 App 时助手会停止，请先按迁移说明退出并移走旧副本。 - 两个 ZIP 均附同名
.zip.sha256；install.sh.sha256用于核对独立脚本。GitHub 自动生成的 Source code 文件不包含可直接运行的 App。
验证：自动化测试 179 项（177 通过、2 项 Windows 专用测试跳过）；两个架构包的逐文件清单、摘要、权限、架构、嵌套签名及运行组件校验通过。文档站构建与 9 页链接检查通过。具体范围见 验证记录。
本版使用 ad hoc 签名，未进行 Developer ID 签名或 Apple 公证；最低构建目标为 macOS 11。Apple Silicon 本机验证、历史 Intel 启动反馈及交叉编译不等同于全部 Intel 设备或 macOS 版本的完整验收。
发行 ZIP 内的 source/ 固定于本版 tag；其中安装器是打包时快照。请使用本页单独提供的 install.sh 安装本版，固定摘要在 ZIP 定稿后生成，不回写已发布 ZIP。
| 文件 | SHA-256 |
|---|---|
codex-usage-desktop-v1.0.1-AppleSilicon.zip |
f2dbe256370a57bebea4c9573192305b7fbe84aaa629cd79d9df86c3c2c9e2e3 |
codex-usage-desktop-v1.0.1-Intel.zip |
72dba2fb47328e601928d7a9f53a89ea91ddce60ca2dce686eca7bd2bb14e1e8 |
install.sh |
44495f90b8ab473fe2b0e87b9a88b9defb592ef053df9c824108926195052076 |
v1.0.0 · 首次公开发布
首次公开发布：原生 macOS Codex 用量工具，支持主面板、菜单栏与可悬停展开的圆形浮窗。
下载后直接使用
- M 系列 Mac：下载
codex-usage-desktop-v1.0.0-AppleSilicon.zip。 - Intel Mac：下载
codex-usage-desktop-v1.0.0-Intel.zip。 - 完整解压，将
Codex用量.app拖入「应用程序」后打开。ZIP 内已包含对应运行组件，无需安装 Python 或开发环境。 .zip.sha256为可选的完整下载校验文件。GitHub 自动生成的 Source code 包供开发使用。
应用读取使用者本机的 Codex 记录，账号额度需要本机 Codex 已登录。发行包不包含开发者的账号、聊天记录或用量数据库。
本版功能
- 主面板的时间、模型、任务筛选与柱状图悬停明细。
- 稳定菜单栏宿主与按需独立主面板；关闭主面板释放它自己的 GUI 和 Python 进程。
- 76×76 圆形浮窗、加宽额度弧线、深浅主题、独立筛选与可调自动刷新。
- 鼠标悬停、点击、右键和拖动分工；主题切换保持同一浮窗。
- 可构建源码、自动化测试、离屏预览工具、内存采样工具，以及可选 Token 统计技能与 Stop hook。
验证与兼容范围
完整测试 160 项：158 项通过、2 项按平台跳过。两种架构均重新编译，发行 ZIP 已校验架构、嵌套签名、执行权限、运行组件与逐文件 SHA-256。Apple Silicon 上宿主及主面板分别通过空目录离线启动检查。
构建最低目标 macOS 11；实体设备验收为 Apple Silicon / macOS 26.5，实体 Intel 及其它 macOS 版本尚未逐一验证。当前采用 ad hoc 签名，未经过 Developer ID 签名或 Apple 公证；首次互联网下载可能需要按 Apple 官方说明确认来源。