Add online quota mode and release v0.1.1

Author: GboyCode

.github/workflows/release.yml

@@ -37,11 +37,13 @@ jobs:
         with:
           name: CodexAuth Switch ${{ github.ref_name }}
           body: |
-            Initial open-source release.
+            CodexAuth Switch release.
 
             - Windows local Codex App account switcher
             - DPAPI-encrypted local account snapshots
-            - No OpenAI official API calls
+            - Local quota estimation by default
+            - Optional online precise quota mode for current-account limits
+            - Reviews, model-level quota cards, and quota pace hints
             - No Codex conversation history upload
             - The installer is not commercially code-signed, so Windows may show a security warning.
           files: |

README.en.md

@@ -6,7 +6,7 @@ English README | [中文说明](README.md)
 
 CodexAuth Switch is a local Windows desktop utility for quickly switching between multiple Codex App login accounts.
 
-It is designed for people who use more than one OpenAI / Codex App account. You can save each account's local login state, then switch the active Codex login through this tool. The project only operates on local files. It does not call OpenAI official APIs, does not access `chatgpt.com`, and does not upload Codex conversation history.
+It is designed for people who use more than one OpenAI / Codex App account. You can save each account's local login state, then switch the active Codex login through this tool. By default the app only operates on local files. If you manually enable online precise quota mode, it uses the current Codex access token to query the `chatgpt.com` quota endpoint. It does not upload Codex conversation history.
 
 One-line positioning: **CodexAuth Switch is a local-first Codex App multi-account switcher with `auth.json` snapshot management, Windows DPAPI encryption, quota display, and token usage statistics.**
 
@@ -17,12 +17,12 @@ One-line positioning: **CodexAuth Switch is a local-first Codex App multi-accoun
 - Users who manage multiple Codex App login accounts on Windows.
 - Users who want to switch the active OpenAI Codex / Codex App account quickly.
 - Users who want to safely save and restore local `%USERPROFILE%\.codex\auth.json` login snapshots.
-- Users who want to view local Codex quota, 5-hour quota, weekly quota, token usage, and recent sessions.
-- Users who want a local-only tool that does not call OpenAI official APIs or upload Codex conversation history.
+- Users who want to view local Codex quota, 5-hour quota, weekly quota, Reviews, model-level limits, token usage, and recent sessions.
+- Users who want local log estimation by default, with an optional online precise quota mode.
 
 ## Search Keywords
 
-Codex account switcher, Codex multi account, Codex App account manager, OpenAI Codex account switcher, Codex auth.json switcher, Codex local login manager, Codex quota viewer, Codex token usage dashboard, Codex Windows desktop app, Codex DPAPI encryption, Codex no official API calls, Codex local history read-only.
+Codex account switcher, Codex multi account, Codex App account manager, OpenAI Codex account switcher, Codex auth.json switcher, Codex local login manager, Codex quota viewer, Codex token usage dashboard, Codex Windows desktop app, Codex DPAPI encryption, Codex local quota estimate, Codex online precise quota, Codex local history read-only.
 
 ## Features
 
@@ -32,8 +32,10 @@ Codex account switcher, Codex multi account, Codex App account manager, OpenAI C
 - Encrypt saved account credentials with Windows DPAPI, readable only by the current Windows user.
 - Automatically back up the original `auth.json` before switching, reauth, or deleting the active account.
 - Provide a main window, system tray menu, and floating quick-view widget.
-- Read quota and token usage from local Codex logs.
-- Disable network requests inside the app to keep it local-only.
+- Read quota and token usage from local Codex logs by default.
+- Optionally use the current login token to read precise quota from the ChatGPT backend, falling back to local estimation on failure.
+- Show quota pace hints, Reviews, and model-level limit cards.
+- Disable network requests in renderer pages; only the main process performs an online quota request after the user enables precise mode.
 
 ## Screenshots
 
@@ -73,9 +75,10 @@ CodexAuth Switch is intentionally scoped to the local Codex login file and the a
 - It does not modify Codex conversation history.
 - It does not delete `%USERPROFILE%\.codex\sessions`.
 - It does not write to `logs_2.sqlite`.
-- It does not upload tokens, account data, session logs, or usage records.
+- By default, it does not upload tokens, account data, session logs, or usage records.
+- Online precise quota mode uses the current access token only as authentication for the `chatgpt.com` quota endpoint and does not upload local conversation history.
 - It does not refresh OpenAI tokens by itself.
-- It does not call OpenAI official APIs.
+- It does not call remote quota endpoints unless the user explicitly enables online precise quota mode.
 
 The only features that intentionally affect Codex App runtime state are account switching, reauth, deleting the active account, and restarting Codex App. These actions may replace or remove the current `auth.json` and restart Codex App so the new local login state takes effect.
 
@@ -135,9 +138,18 @@ If a saved account's refresh token becomes invalid, the app can start a reauth f
 
 This does not bypass or replace official login. The real login still happens inside Codex App.
 
+### Quota Modes
+
+The quota panel supports two modes:
+
+- Local estimate: default mode; reads only logs already written by Codex App.
+- Online precise: manually enabled; uses the access token in the current `auth.json` to request `https://chatgpt.com/backend-api/wham/usage` and read 5-hour, weekly, Reviews, model-level limits, and credits. If the request fails, the app falls back to local estimation.
+
+Online precise mode does not refresh OpenAI tokens and does not write back to `auth.json`.
+
 ### Local Quota And Usage
 
-The quota and usage panels only read logs already written by Codex App:
+Local estimate mode reads:
 
 - `codex.rate_limits` records in session JSONL files.
 - `codex.rate_limits` and usage-limit records in `logs_2.sqlite`.
@@ -147,6 +159,10 @@ The app watches local log file changes with a short debounce and uses a low-freq
 
 Quota snapshots are saved only into this app's own account metadata. They are not written back to Codex log files.
 
+### Quota Pace Hints
+
+The app uses the current used percentage, quota window length, and reset time to estimate consumption pace. It can show whether usage is light, on track, or likely to run out early. This is a trend hint, not a promise of how much quota the next request will consume.
+
 ### Network Isolation
 
 Electron windows use these security settings:
@@ -173,7 +189,7 @@ ws://
 wss://
 ```
 
-These restrictions keep the app local-only and help prevent account data or local history from being uploaded.
+These restrictions keep renderer pages local-only and help prevent account data or local history from being uploaded. Online precise quota requests are made by the main process only after the user enables that mode.
 
 ## Usage
 
@@ -268,19 +284,14 @@ QUOTA-LOGIC.md                      Quota-estimation notes
 - Windows only for now.
 - Credential encryption depends on Windows DPAPI.
 - This targets Codex App local login switching, not Codex CLI-only workflows.
-- Quota and usage display are best-effort interpretations of local logs.
+- Local estimate mode is a best-effort interpretation of local logs.
+- Online precise mode depends on the `chatgpt.com` quota endpoint, whose response shape may change with Codex backend updates.
 - Quota snapshots may stay stale until Codex writes new local rate-limit records.
 - Do not share saved credential snapshots across machines or Windows users.
 
-## Release Notes
-
-For a first GitHub release, upload the generated Windows installer from:
-
-```text
-release\CodexAuthSwitch-Setup-0.1.0.exe
-```
+## Release
 
-The installer is not commercially code-signed, so Windows may show a security warning.
+Windows installers are uploaded through GitHub Releases. The installer is not commercially code-signed, so Windows may show a security warning.
 
 ## License
 

README.md

@@ -6,7 +6,7 @@
 
 CodexAuth Switch 是一个 Windows 本地桌面工具，用来在多个 Codex App 登录账号之间快速切换。
 
-它适合同时使用多个 OpenAI / Codex App 账号的人：先把每个账号的本地登录状态保存下来，之后通过这个工具切换当前生效的 Codex 登录。项目只操作本机文件，不调用 OpenAI 官方接口，不访问 `chatgpt.com`，也不会上传 Codex 会话历史。
+它适合同时使用多个 OpenAI / Codex App 账号的人：先把每个账号的本地登录状态保存下来，之后通过这个工具切换当前生效的 Codex 登录。默认模式只操作本机文件；如果手动开启“联网精准”额度模式，应用会用当前 Codex 登录 token 请求 `chatgpt.com` 的额度接口。应用不会上传 Codex 会话历史。
 
 一句话定位：**CodexAuth Switch 是一个本地优先的 Codex App 多账号切换工具，支持 `auth.json` 快照管理、Windows DPAPI 加密、额度查看和 token 用量统计。**
 
@@ -17,12 +17,12 @@ CodexAuth Switch 是一个 Windows 本地桌面工具，用来在多个 Codex Ap
 - 想在 Windows 上管理多个 Codex App 登录账号。
 - 想快速切换 OpenAI Codex / Codex App 当前账号。
 - 想安全保存和恢复本地 `%USERPROFILE%\.codex\auth.json` 登录快照。
-- 想查看 Codex 本地额度、5 小时额度、周额度、token 用量和最近会话。
-- 想确认工具不会调用 OpenAI 官方 API、不会上传本地 Codex 会话历史。
+- 想查看 Codex 本地额度、5 小时额度、周额度、Reviews、模型级额度、token 用量和最近会话。
+- 想默认使用本地日志估算，也希望可选启用联网精准额度读取。
 
 ## 常见搜索词
 
-Codex 账号切换、Codex 多账号、Codex App 账号管理、OpenAI Codex 账号切换工具、Codex auth.json 切换、Codex 本地登录管理、Codex 额度查看、Codex token 用量统计、Codex Windows 桌面工具、Codex DPAPI 加密、Codex 不调用官方 API、Codex 本地历史只读。
+Codex 账号切换、Codex 多账号、Codex App 账号管理、OpenAI Codex 账号切换工具、Codex auth.json 切换、Codex 本地登录管理、Codex 额度查看、Codex token 用量统计、Codex Windows 桌面工具、Codex DPAPI 加密、Codex 本地预估、Codex 联网精准额度、Codex 本地历史只读。
 
 ## 功能
 
@@ -32,8 +32,10 @@ Codex 账号切换、Codex 多账号、Codex App 账号管理、OpenAI Codex 账
 - 使用 Windows DPAPI 加密保存账号凭据，仅当前 Windows 用户可解密。
 - 切换、重新登录、删除当前账号前自动备份原始 `auth.json`。
 - 提供主窗口、系统托盘菜单和悬浮快捷窗。
-- 从本地 Codex 日志读取额度和 token 使用情况。
-- 在应用内禁用网络请求，保持本地运行。
+- 默认从本地 Codex 日志读取额度和 token 使用情况。
+- 可选使用当前登录 token 联网读取 ChatGPT 后端额度，失败时回退本地估算。
+- 显示额度消耗 pace 提示、Reviews 和模型级额度。
+- 渲染页面禁用网络请求；只有用户开启联网精准模式时，主进程才会发起额度读取请求。
 
 ## 界面截图
 
@@ -73,9 +75,10 @@ CodexAuth Switch 的设计目标是把影响范围限制在本机登录文件和
 - 不修改 Codex 会话历史。
 - 不删除 `%USERPROFILE%\.codex\sessions`。
 - 不写入 `logs_2.sqlite`。
-- 不上传 token、账号信息、会话日志或用量记录。
+- 默认不上传 token、账号信息、会话日志或用量记录。
+- 联网精准额度模式只会把当前 access token 用作 `chatgpt.com` 额度接口认证，不上传本地会话历史。
 - 不自行刷新 OpenAI token。
-- 不调用 OpenAI 官方 API。
+- 默认不调用远程额度接口；联网精准模式需要用户手动开启。
 
 会影响 Codex App 当前运行状态的功能只有：切换账号、重新登录、删除当前账号、重启 Codex App。这些操作可能会替换或移除当前 `auth.json`，并重启 Codex App，让新的本地登录状态生效。
 
@@ -135,9 +138,18 @@ DataProtectionScope.CurrentUser
 
 这个过程不绕过官方登录，也不代替官方登录。真正的登录仍然发生在 Codex App 内。
 
+### 额度读取模式
+
+额度面板支持两种模式：
+
+- 本地预估：默认模式，只读取 Codex App 已经写到本机的日志。
+- 联网精准：手动开启后，使用当前 `auth.json` 里的 access token 请求 `https://chatgpt.com/backend-api/wham/usage`，读取官方返回的 5 小时、周额度、Reviews、模型级额度和 credits；读取失败会回退本地估算。
+
+联网精准模式不会自动刷新 OpenAI token，也不会写回 `auth.json`。
+
 ### 本地额度和用量统计
 
-额度和用量面板只读取 Codex App 已经写到本机的日志：
+本地预估模式读取以下数据：
 
 - session JSONL 文件里的 `codex.rate_limits`。
 - `logs_2.sqlite` 里的 `codex.rate_limits` 和 usage-limit 记录。
@@ -147,6 +159,10 @@ DataProtectionScope.CurrentUser
 
 额度快照只保存到本应用自己的账号元数据中，不会写回 Codex 的日志文件。
 
+### 额度 pace 提示
+
+应用会根据当前已用百分比、额度窗口长度和重置时间估算当前消耗速度，显示“消耗速度宽松 / 消耗速度正常 / 按当前速度会提前用完”。这只是趋势提示，不代表下一次对话会准确消耗多少额度。
+
 ### 网络隔离
 
 Electron 窗口启用了以下安全配置：
@@ -173,7 +189,7 @@ ws://
 wss://
 ```
 
-这些限制用于确保应用保持本地工具属性，避免账号信息或本地历史被上传。
+这些限制用于确保渲染页面保持本地工具属性，避免账号信息或本地历史被上传。联网精准额度模式的请求由主进程在用户手动开启后发起。
 
 ## 使用方法
 
@@ -268,16 +284,14 @@ QUOTA-LOGIC.md                      额度估算逻辑说明
 - 目前只支持 Windows。
 - 凭据加密依赖 Windows DPAPI。
 - 目标是 Codex App 本地登录切换，不是 Codex CLI-only 工作流。
-- 额度和用量展示来自本地日志解析，属于本地近似展示。
+- 本地预估模式来自本地日志解析，属于本地近似展示。
+- 联网精准模式依赖 `chatgpt.com` 额度接口，接口字段可能随 Codex 后端变化。
 - Codex 没有写入新的本地 rate-limit 记录时，额度快照可能暂时不更新。
 - 不要跨机器或跨 Windows 用户共享已保存的凭据快照。
 
-## 开源前建议
-
-正式公开仓库前，建议补充：
+## Release
 
-- Release 说明：解释安装包来源、版本号和校验方式。
-- 截图：展示主窗口、悬浮窗和托盘菜单。
+Windows 安装包会随 GitHub Release 上传。安装器未做商业代码签名，Windows 可能会显示安全提醒。
 
 ## License
 

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "codexauth-switch",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "private": true,
   "description": "Local Windows desktop account switcher for Codex App.",
   "author": "GboyCode",