Codex Quota Widget v0.2.3

v0.2.3

This release refines the 7-day pace marker so it is less sensitive to raw integer quota ticks.

Changes

• Uses 5h-assisted fractional 7d burn as the primary input for the long-window near-speed marker.
• Keeps raw official 7d integer burn as diagnostics and ratio-learning evidence instead of directly driving the blue marker.
• Adds diagnostics for raw, auxiliary, smoothed, adjusted burn, and dynamic 5h-to-7d ratio values.
• Updates README documentation for the fractional 7d velocity algorithm.
• Bumps package version to 0.2.3.

Validation

• npm.cmd test
• npm.cmd run build
• app.asar verified with version 0.2.3 and fractional long-velocity code

Artifact

• CodexQuota.exe
• SHA256: C48824040C2C92B9A56F44214A40DEFCC8C89C3260A9D125372496DAC6039D17

Codex Quota Widget v0.2.2

v0.2.2

This release adds a learned dynamic pace reference for the 7-day and 5-hour quota windows.

What's new

• Added the cyan 近速需留 reference line beside the existing ideal reference line.
• Added a lightweight learned usage model using recent burn windows plus local 168-hour usage buckets.
• The 5-hour window stays sensitive to short bursts; the 7-day window is damped by confidence so short samples do not overreact.
• Cross-reset history feeds the learned profile, but reset-boundary percentages are not subtracted directly.
• Added tray settings for the 近期偏快 breathing cycle, 接近耗尽 blinking cycle, and visible quota refresh interval.
• Updated README with the algorithm, all advice states, and signal light behavior.

Advice states and lights

• 加速蹬！: white steady signal.
• 余量充足: green steady signal.
• 节奏正常: blue steady signal.
• 近期偏快: yellow breathing signal, default 4 seconds.
• 继续放缓: yellow steady signal.
• 建议减速: red steady signal.
• 接近耗尽: red blinking signal, default 3 seconds.
• 无法判断: gray steady signal.

Validation

• node --check on changed JavaScript files.
• npm.cmd test.
• npm.cmd run build.
• Local-history simulation showed the new 7-day dynamic line avoids the previous short-sample overreaction case.

SHA256 for CodexQuota.exe:
37B75323673E554E0A207C5EAC0C561ABD88E2FCC70C131061739D7B0F45E7FF

Codex Quota Widget v0.2.1

v0.2.1

新增

• 新增 加速蹬！ 综合节奏建议：当 7 天剩余额度明显高于动态理想门槛，且 5 小时窗口不是偏快或紧张时提示可以更积极使用。
• HUD 与顶部吸附细条共用综合状态信号灯：加速蹬！ 为白色常亮提示，节奏正常 为蓝色提示。

调整

• 顶部细条收起/展开状态的状态指示统一为短竖条，保持更轻量的视觉形态。
• README 更新到 v0.2.1，补充动态节奏建议说明；截图保持 v0.2.0 新版展示图不变。

校验

• node --check 通过。
• npm.cmd test 通过：16 个节奏建议用例、5 个 quota normalization 用例，以及 quota store 缓存/刷新错误处理用例。
• dist\CodexQuota.exe 版本：0.2.1。
• SHA256：16D3CED520FF0CF4A204FAED61C3941DE2756A060DC35034C77D17A3624A60FC。

Codex Quota Widget v0.2.0

Codex Quota Widget v0.2.0

This release adds the new compact HUD pill and the top-edge strip mode for reducing browser-tab obstruction while keeping quota pace visible.

New

• Replaced the legacy compact orb with a HUD-style capsule that shows 7-day and 5-hour quota, ideal pace markers, and pace deltas.
• Added top-edge strip mode. Drag the HUD to the very top of the screen to switch into a thin black strip with two progress bars and ideal markers.
• Added hover expansion for the top strip, using a notch-style panel that shows the core HUD readings and ideal marker percentages.
• Added explicit hover state handling for transparent Electron windows so HUD and strip panels collapse correctly after the pointer leaves the visible surface.
• Added README screenshots for the v0.2.0 HUD and strip states, while marking the v0.1.1 compact orb screenshots as legacy.

Fixed

• Fixed packaged startup regression where preload failed to load a shared layout module from app.asar, leaving the renderer without the compact scale state.

Asset

• Windows x64 portable: CodexQuota.exe
• SHA256: 7C4D077057632431D69D3BE5A88CDA7DC5B112D1E31ABE1EE79F1B59A5574659

Codex Quota Widget v0.1.1

v0.1.1

本版本改造自 xicunwus2025-sys/codex-led-widget，面向 Windows 桌面日常使用整理为 Codex Quota Widget。

主要变化

• 默认紧凑悬浮球显示，区分 7 天窗口和 5 小时窗口额度。
• 增加 7 天使用节奏建议，并展示实际剩余与理想剩余液面。
• 增加系统托盘入口、应用图标、托盘图标和固定的 CodexQuota.exe 产物名。
• 收紧额度读取逻辑，只接受 Codex 明确返回的 codex rate-limit 快照。
• 删除发布前冗余代码，包括未使用 IPC、内联备用图标、空吞错和无用兼容分支。
• README 改为完整中文说明，补充改造内容、隐私边界、开发和发布说明。

Windows 提示

当前可执行文件未做代码签名，Windows 首次运行可能提示未知发布者。确认来源为本仓库 Release 后，可选择“更多信息”再选择“仍要运行”。

隐私边界

本工具只读取本机 Codex CLI 已登录状态下返回的额度信息，不要求输入 Token，不上传额度数据，不引入第三方服务。

产物校验

• 文件：CodexQuota.exe
• SHA256：FF6EAF3307E3CE7C987999E3EC966328A55589B04B152B9155CF0C49A66EC134