dsh-codex-connect 0.1.0-alpha.4.24 → 0.1.0-alpha.4.25

package/INSTALL.md

@@ -1,6 +1,6 @@
 # Installation Runbook for CLI Agents
 
-Alpha 4.24 is verified with DSH `0.1.2-alpha.5` and its declared pi-ai range `^0.84.2`; the verified registry installation resolves pi-ai `0.84.4`.
+Alpha 4.25 is verified with DSH `0.1.2-alpha.5` and its declared pi-ai range `^0.84.2`; the verified registry installation resolves pi-ai `0.84.4`.
 
 Install `dsh-codex-connect` into one requested DeepSeek Harness profile without changing its current default model, search route, global configuration, or OAuth state.
 
@@ -23,11 +23,11 @@ Check `dsh --version` before changing the requested profile. Use `dsh --help` to
 | `0.1.0-rc.7` | `0.1.0-alpha.4.14` |
 | `0.1.1-rc.2` | `0.1.0-alpha.4.21` |
 | `0.1.2-alpha.2` | `0.1.0-alpha.4.23` |
-| `0.1.2-alpha.5` | `0.1.0-alpha.4.24` |
+| `0.1.2-alpha.5` | `0.1.0-alpha.4.25` |
 
 If your exact DSH version is unknown or not listed, stop and verify the combination before installing. Do not blindly install `dsh-codex-connect@alpha`: `alpha` is a moving tag, not a compatibility guarantee. Do not infer support for newer DSH versions from these rows.
 
-Alpha 4.24's verified contract is DSH plugin API packages `0.1.2-alpha.5`, `@earendil-works/pi-ai` `^0.84.2` (resolved as `0.84.4` during verification), and Node.js `^22.19.0 || >=24.0.0`. Alpha 4.23 remains the verified choice for DSH `0.1.2-alpha.2`, Alpha 4.21 remains the verified choice for DSH `0.1.1-rc.2`, and staying on DSH `0.1.0-rc.7` means selecting Alpha 4.14. Upgrading DSH is a separate decision: upgrade the DSH API packages and pi-ai together, then rerun `dsh-codex-connect doctor --json` and `pnpm --silent run check:compatibility` for the selected combination.
+Alpha 4.25's verified contract is DSH plugin API packages `0.1.2-alpha.5`, `@earendil-works/pi-ai` `^0.84.2` (resolved as `0.84.4` during verification), and Node.js `^22.19.0 || >=24.0.0`. Alpha 4.24 remains an earlier verified choice for the same DSH version, Alpha 4.23 remains the verified choice for DSH `0.1.2-alpha.2`, Alpha 4.21 remains the verified choice for DSH `0.1.1-rc.2`, and staying on DSH `0.1.0-rc.7` means selecting Alpha 4.14. Upgrading DSH is a separate decision: upgrade the DSH API packages and pi-ai together, then rerun `dsh-codex-connect doctor --json` and `pnpm --silent run check:compatibility` for the selected combination.
 
 These choices reflect the repository's existing verification record, not a new installation or runtime probe. This guidance does not fix upstream DSH compatibility or resolve [Issue #64](https://github.com/franksong2702/dsh-codex-connect/issues/64).
 
@@ -52,13 +52,13 @@ These choices reflect the repository's existing verification record, not a new i
    dsh plugin --profile web add dsh-codex-connect@0.1.0-alpha.4.23
    ```
 
-   For DSH `0.1.2-alpha.5`, use Alpha 4.24:
+   For DSH `0.1.2-alpha.5`, use Alpha 4.25:
 
    ```sh
-   dsh plugin --profile web add dsh-codex-connect@0.1.0-alpha.4.24
+   dsh plugin --profile web add dsh-codex-connect@0.1.0-alpha.4.25
    ```
 
-   If npm is unavailable after the matching GitHub prerelease is created, use `dsh plugin --profile web add 'github:franksong2702/dsh-codex-connect#v0.1.0-alpha.4.21'` only for the DSH `0.1.1-rc.2` combination, `dsh plugin --profile web add 'github:franksong2702/dsh-codex-connect#v0.1.0-alpha.4.23'` only for the DSH `0.1.2-alpha.2` combination, or `dsh plugin --profile web add 'github:franksong2702/dsh-codex-connect#v0.1.0-alpha.4.24'` only for the DSH `0.1.2-alpha.5` combination.
+   If npm is unavailable after the matching GitHub prerelease is created, use `dsh plugin --profile web add 'github:franksong2702/dsh-codex-connect#v0.1.0-alpha.4.21'` only for the DSH `0.1.1-rc.2` combination, `dsh plugin --profile web add 'github:franksong2702/dsh-codex-connect#v0.1.0-alpha.4.23'` only for the DSH `0.1.2-alpha.2` combination, or `dsh plugin --profile web add 'github:franksong2702/dsh-codex-connect#v0.1.0-alpha.4.25'` only for the DSH `0.1.2-alpha.5` combination.
 
 3. Run `dsh --profile web --dump-config` and require exactly one `llm-openai-codex` row loading `dsh-codex-connect`.
 4. Confirm the effective `agent-default-model` and `web.searchProvider` values are unchanged from before installation.
@@ -70,7 +70,7 @@ These choices reflect the repository's existing verification record, not a new i
 
 6. If the user explicitly requests login, open **Settings → Plugins → Plugin configuration → Codex Connect**, or check `status` and then use `login` or `login --device-code`. OAuth approval belongs to the user.
 
-   Alpha 4.24 offers the same account actions in **Settings → Models → Openai-Codex**, plus a shared **More settings** dialog for model visibility, proxy, search, image, context-budget, and Auto-review controls. The original Plugin settings entry remains available; neither entry automatically starts login or changes model/search defaults.
+   Alpha 4.25 offers the same account actions in **Settings → Models → Openai-Codex**, plus a shared **More settings** dialog for model visibility, proxy, search, image, context-budget, and Auto-review controls. The original Plugin settings entry remains available; neither entry automatically starts login or changes model/search defaults.
 
    When signed out, select **Authorize**. When signed in, use **Sign out** or **View quota**; use **More settings** for plugin options. If authorization is abandoned, use **Reopen authorization** or **Cancel sign-in** and retry; cancellation does not delete an existing account. Pending authorization expires after 10 minutes by default (`oauthTimeoutMs` in plugin configuration, applied on load).
 

package/README.i18n.yaml

@@ -2,5 +2,5 @@
 # side as of the last confirmed-consistent state. Both languages carry equal authority;
 # after editing either side, bring the other along and re-record with:
 #   git hash-object README.md docs/README.zh.md
-README.md: 9e115087a48526ebe60bee0c22d5b27f2b81e57e
-docs/README.zh.md: d5c92989b98411b98c9ad688b2258edbcc4ec368
+README.md: 65a8d94c57ae1bd869f5247f158cb1f8d221f4c0
+docs/README.zh.md: 1bdd0641d14d6c27da312ce9ac954fbb2664beae

package/README.md

@@ -10,7 +10,7 @@ Connect your ChatGPT subscription to DeepSeek Harness with OAuth, optional GPT I
   <img src="https://raw.githubusercontent.com/franksong2702/dsh-codex-connect/main/docs/assets/en/hero.jpg" alt="Codex Connect — ChatGPT OAuth for DeepSeek Harness" width="100%">
 </p>
 
-`dsh-codex-connect` adds the `openai-codex` model catalog and a separate ChatGPT OAuth login. Models run through Harness's normal LLM service, so streaming, tool calls, reasoning replay, compaction, filesystem controls, permission gates, and approval prompts remain Harness-owned. It does not turn a ChatGPT subscription into an OpenAI Platform API credential. When an eligible GPT Codex model is selected, the Composer also shows a conversation-scoped Fast Mode toggle and a compact weekly-quota indicator.
+`dsh-codex-connect` adds the `openai-codex` model catalog and a separate ChatGPT OAuth login. Models run through Harness's normal LLM service, so streaming, tool calls, reasoning replay, compaction, filesystem controls, permission gates, and approval prompts remain Harness-owned. It does not turn a ChatGPT subscription into an OpenAI Platform API credential. When an eligible GPT Codex model is selected, the Composer also shows a conversation-scoped Fast Mode toggle and compact server-reported quota bars.
 
 Installation is additive. The bundle does not replace the current default model or search route. Standalone search, `view_image`, and image generation remain disabled until explicitly enabled.
 
@@ -18,30 +18,30 @@ The setup and image-result screenshots in this English guide are captured from t
 
 ## Quick start (about five minutes)
 
-This quick start targets DSH `0.1.2-alpha.5` with Codex Connect Alpha 4.24. Check `dsh --version` first. For DSH `0.1.2-alpha.2`, `0.1.1-rc.2`, or `0.1.0-rc.7`, select the matching plugin version in [INSTALL.md](INSTALL.md). This guide uses the `web` profile; replace `web` with the name of the Harness profile you already use. From a DeepSeek Harness source checkout, prefix the commands with `pnpm`.
+This quick start targets DSH `0.1.2-alpha.5` with Codex Connect Alpha 4.25. Check `dsh --version` first. For DSH `0.1.2-alpha.2`, `0.1.1-rc.2`, or `0.1.0-rc.7`, select the matching plugin version in [INSTALL.md](INSTALL.md). This guide uses the `web` profile; replace `web` with the name of the Harness profile you already use. From a DeepSeek Harness source checkout, prefix the commands with `pnpm`.
 
 ### 1. Install the plugin into one profile
 
 ```sh
-dsh plugin --profile web add dsh-codex-connect@0.1.0-alpha.4.24
+dsh plugin --profile web add dsh-codex-connect@0.1.0-alpha.4.25
 ```
 
 Expected result: the package is added to that profile. This does not change the profile's default model or global search route.
 
 Use the exact version above to keep the verified DSH and plugin pair reproducible. `alpha` is a moving npm tag, not a compatibility guarantee.
 
-### What's new in Alpha 4.24
+### What's new in Alpha 4.25
 
-- Run on the exact DSH `0.1.2-alpha.5` package set, with registry-only installation and isolated runtime checks.
-- Optionally let Codex Auto-review eligible Harness approval requests after DSH policy checks. It is off by default, requires a first-use disclosure confirmation, fails back to human approval, and supports one exact manual override after a denial.
-- Configure the optional Codex-only proxy through a clearer staged workflow: detect or enter an address, test that exact draft, explicitly activate it, and save. Editing an enabled address requires a fresh successful test; failures never silently fall back to direct access.
-- Navigate the larger plugin configuration through Account & quota, Models, Network, and Capabilities modules while preserving one shared Save/Discard draft.
+- Show the exact 5-hour and weekly quota windows returned by ChatGPT for the selected Codex model. Missing windows stay hidden, Spark remains separate, and plan names do not suppress server data.
+- Separate verified compatibility from maintainer follow-up. The settings card no longer treats missing verification as a known runtime failure or recommends a plugin downgrade.
+- Link users to the canonical tracker for their DSH version when one exists, with a prefilled compatibility-gap report as the safe fallback.
+- Track every newer DSH candidate through one Canary issue with explicit preliminary, compatibility-failure, or infrastructure-blocked state. Canary success does not declare support or publish anything.
 
 ### Version updates
 
-Codex Connect checks public package metadata and this repository's `verified-compatibility.json` periodically through the DSH Web server. The same card reads the locally loaded DSH package version, shows it beside the latest DSH version recorded by this project, and evaluates the exact installed plugin and DSH version pair. Local version detection uses package metadata already available to the plugin and does not require a DSH Core change.
+Codex Connect checks public package metadata and this repository's `verified-compatibility.json` periodically through the DSH Web server. The same card reads the locally loaded DSH package version, shows it beside the latest DSH version recorded by this project, and evaluates the exact installed plugin and DSH version pair. Local version detection uses package metadata already available to the plugin and does not require a DSH Core change. The card's optional tracker lookup sends only that public DSH version to GitHub's public search API.
 
-The compatibility record lists exact plugin and DSH versions rather than assuming every later release remains compatible. Maintainers can add a newly verified DSH version to the repository file without publishing another plugin release. A green result means the installed pair was verified; yellow means the latest plugin was verified with the installed DSH version and should be installed first; red means the installed DSH version is known but neither the installed plugin nor the latest published plugin has a matching record; gray means the installed DSH version is not recorded or the public record could not be checked. A red result includes a prefilled GitHub issue link for the installed DSH version so users can remind the maintainer without composing a report from scratch.
+The compatibility record lists exact plugin and DSH versions rather than assuming every later release remains compatible. Maintainers can add a newly verified DSH version to the repository file without publishing another plugin release. The card keeps two decisions separate: its status describes only whether the installed pair or a specific upgrade path has been verified, while its GitHub action appears only when the installed latest-or-newer DSH has no verified published plugin. Missing verification never claims that a pair is known to fail. A green result means the installed pair was verified. Yellow recommends updating the plugin when the latest plugin matches the installed DSH, or updating DSH when the latest plugin matches the latest verified DSH. Red means Codex Connect has not caught up with the installed latest-or-newer DSH; it links to the canonical compatibility tracker when one exists, or offers a prefilled compatibility-gap report when the tracker lookup is unavailable or has no match. Gray means an older DSH version is not recorded or the public record could not be checked.
 
 When a newer plugin version is available, a frame-wide DSH notice appears even if you switch conversations. It first shows the user-facing changes between your installed version and the newest version; technical release notes remain available as a secondary detail or from the release page. To update, copy the short request shown in the notice to the Agent you use for this DSH project. The Agent can inspect the project instructions and choose the appropriate install or update method; the plugin never runs an upgrade command itself.
 
@@ -65,7 +65,7 @@ Expected result: the Harness web UI opens for the selected profile.
 
 ### 3. Find the Openai-Codex account card
 
-Open **Settings → Models** and find **Openai-Codex**. This is the primary Alpha 4.24 account entry. If the profile does not expose the Models settings section, open **Settings → Plugins → Plugin configuration → Codex Connect** instead.
+Open **Settings → Models** and find **Openai-Codex**. This is the primary Alpha 4.25 account entry. If the profile does not expose the Models settings section, open **Settings → Plugins → Plugin configuration → Codex Connect** instead.
 
 The Models card carries the attribution “Powered by the Codex Connect plugin.” and provides ChatGPT authorization, reauthorization, sign-out and quota. Both settings pages share one in-memory account state and polling owner. **More settings** opens the proxy, model visibility, search, image and context-budget configuration form in a dialog; the original Plugin settings entry remains available. Both entries save to the same settings scope. Close or Escape discards unsaved dialog edits. The Models footer is optional: profiles without that settings section retain the existing Plugin entry.
 
@@ -136,11 +136,11 @@ Expected result: `status --json` reports `signed-in` and exits `0`, while `docto
 The two small controls are shown only when the current conversation is using a GPT model from the `openai-codex` provider. They are session controls, not profile-wide settings:
 
 - **Fast Mode (lightning icon)** is off by default for each conversation. Click it to request the faster `1.5×` mode; click it again to return to Standard speed. The control is bound to that conversation and does not change the selected model or other conversations. Hover or focus the icon to see the current state and its quota-consumption warning.
-- **Weekly quota bar** is the short horizontal bar beside the model selector. Its color moves from green through yellow/orange to red as the remaining amount falls. Hover or focus it to see the exact remaining percentage and the server-provided reset time. It is hidden for non-GPT models or when usage data is unavailable.
-- For the exact `gpt-5.3-codex-spark` model, the Composer reads the Spark weekly bucket. Other GPT Codex models read the standard Codex weekly bucket; these are separate limits.
+- **Quota bars** are the compact `5h` and `7d` rows beside the model selector. Each row appears only when the server returns that window for the current model bucket. Their colors move from green through yellow/orange to red as the remaining amount falls. Hover or focus the control to see each exact remaining percentage and server-provided reset time. It is hidden for non-GPT models or when no recognized usage window is available.
+- For the exact `gpt-5.3-codex-spark` model, the Composer reads the separate Spark bucket. Other GPT Codex models read the standard Codex bucket. The plugin does not infer quota windows from the ChatGPT plan name.
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/franksong2702/dsh-codex-connect/main/docs/assets/composer-capabilities.jpg" alt="DeepSeek Harness Composer with the per-conversation Fast Mode lightning control and weekly quota bar" width="820">
+  <img src="https://raw.githubusercontent.com/franksong2702/dsh-codex-connect/main/docs/assets/composer-capabilities.jpg" alt="DeepSeek Harness Composer with the per-conversation Fast Mode lightning control and quota bars" width="820">
 </p>
 
 ## Optional capabilities (off by default)
@@ -200,10 +200,10 @@ The detailed image prompt is authored by the selected GPT model. Codex Connect d
 
 After sign-in, the Codex Connect settings card can show several server-reported windows. They are separate buckets, not three views of one number:
 
-- **Codex · Weekly** is the standard Codex weekly bucket used by ordinary GPT Codex models.
-- **GPT-5.3-Codex-Spark · 5-hour** and **GPT-5.3-Codex-Spark · Weekly** are the two Spark windows returned for the Spark model.
+- The standard **Codex** bucket can contain a **5-hour** window, a **Weekly** window, or both.
+- The exact Spark model uses the separate **GPT-5.3-Codex-Spark** bucket and displays whichever windows that bucket returns.
 
-Each bar shows the remaining percentage and its local reset time. OpenAI controls the returned windows, eligibility, and reset values; missing usage data is treated as unavailable rather than guessed.
+Each bar shows the remaining percentage and its local reset time. OpenAI controls the returned windows, eligibility, and reset values; Codex Connect does not remove a returned window based on the plan name or invent a missing one.
 
 ### Change a default model or global search route separately
 
@@ -322,7 +322,7 @@ The command sends one fixed, synthetic no-op to the hidden reviewer through the
 
 ## Compatibility and security boundary
 
-- Alpha 4.24 is verified with DSH plugin API packages `0.1.2-alpha.5`, `@earendil-works/pi-ai` `^0.84.2` (resolved as `0.84.4` during verification), and Node.js `^22.19.0 || >=24.0.0`. Alpha 4.23 remains the verified choice for DSH `0.1.2-alpha.2`; Alpha 4.21 remains verified with DSH `0.1.1-rc.2` and pi-ai `0.82.1`. [verified-compatibility.json](verified-compatibility.json) records the exact pairs; see [INSTALL.md](INSTALL.md) for installation commands.
+- Alpha 4.25 is verified with DSH plugin API packages `0.1.2-alpha.5`, `@earendil-works/pi-ai` `^0.84.2` (resolved as `0.84.4` during verification), and Node.js `^22.19.0 || >=24.0.0`. Alpha 4.24 remains an earlier verified choice for the same DSH version, Alpha 4.23 remains the verified choice for DSH `0.1.2-alpha.2`, and Alpha 4.21 remains verified with DSH `0.1.1-rc.2` and pi-ai `0.82.1`. [verified-compatibility.json](verified-compatibility.json) records the exact pairs; see [INSTALL.md](INSTALL.md) for installation commands.
 - The new DSH client splits its former runtime into Session Controller, Settings, Store, and Renderer packages. Codex Connect uses those public interfaces for settings and image actions. DSH owns normalized preview encoding and dimensions; Codex Connect retains the exact original image separately.
 - Upgrade the DSH plugin API packages and `@earendil-works/pi-ai` as one group, then run `dsh-codex-connect doctor --json` and the compatibility check again. This contract does not make claims about future versions.
 - When the daily upstream check finds a new `latest` or `next` DSH candidate, it installs Codex Connect into an isolated profile, boots the installed model runtime without OAuth credentials, verifies model and reasoning-effort discovery, and confirms provider disposal. Live sign-in, quota, and model requests still require manual validation in the test profile.

package/docs/README.zh.md

@@ -10,7 +10,7 @@
   <img src="https://raw.githubusercontent.com/franksong2702/dsh-codex-connect/main/docs/assets/zh/hero.jpg" alt="Codex Connect — 通过 ChatGPT OAuth 连接 DeepSeek Harness" width="100%">
 </p>
 
-`dsh-codex-connect` 提供 `openai-codex` 模型目录和独立的 ChatGPT OAuth 登录。模型仍走 Harness 标准 LLM 服务，因此流式输出、工具调用、reasoning replay、压缩、文件系统控制、权限门禁和审批提示仍由 Harness 负责。ChatGPT 订阅不会因此变成 OpenAI Platform API 凭据。选择符合条件的 GPT Codex 模型后，Composer 还会显示按对话绑定的 Fast Mode 开关和紧凑的周额度指示条。
+`dsh-codex-connect` 提供 `openai-codex` 模型目录和独立的 ChatGPT OAuth 登录。模型仍走 Harness 标准 LLM 服务，因此流式输出、工具调用、reasoning replay、压缩、文件系统控制、权限门禁和审批提示仍由 Harness 负责。ChatGPT 订阅不会因此变成 OpenAI Platform API 凭据。选择符合条件的 GPT Codex 模型后，Composer 还会显示按对话绑定的 Fast Mode 开关和服务端返回的紧凑额度条。
 
 安装是增量的：bundle 不会替换当前主模型或搜索路由；独立搜索、`view_image` 和图片生成也默认关闭，必须显式开启。
 
@@ -18,30 +18,30 @@
 
 ## 五分钟快速开始
 
-本快速指南适用于 DSH `0.1.2-alpha.5` 与 Codex Connect Alpha 4.24。请先运行 `dsh --version`。如果使用 DSH `0.1.2-alpha.2`、`0.1.1-rc.2` 或 `0.1.0-rc.7`，请在 [INSTALL.md](../INSTALL.md) 中选择匹配的插件版本。本指南使用 `web` profile；请把 `web` 替换成你已经在用的 Harness profile 名称。如果在 DeepSeek Harness 源码 checkout 中运行，请在命令前加 `pnpm`。
+本快速指南适用于 DSH `0.1.2-alpha.5` 与 Codex Connect Alpha 4.25。请先运行 `dsh --version`。如果使用 DSH `0.1.2-alpha.2`、`0.1.1-rc.2` 或 `0.1.0-rc.7`，请在 [INSTALL.md](../INSTALL.md) 中选择匹配的插件版本。本指南使用 `web` profile；请把 `web` 替换成你已经在用的 Harness profile 名称。如果在 DeepSeek Harness 源码 checkout 中运行，请在命令前加 `pnpm`。
 
 ### 1. 将插件装入一个 profile
 
 ```sh
-dsh plugin --profile web add dsh-codex-connect@0.1.0-alpha.4.24
+dsh plugin --profile web add dsh-codex-connect@0.1.0-alpha.4.25
 ```
 
 预期结果：包被加入该 profile。这个动作不会更改 profile 的默认模型或全局搜索路由。
 
 请使用上面的精确版本，确保已验证的 DSH 与插件组合可以复现。`alpha` 是会移动的 npm 标签，不是兼容性保证。
 
-### Alpha 4.24 更新内容
+### Alpha 4.25 更新内容
 
-- 在精确的 DSH `0.1.2-alpha.5` 包组上运行，并完成纯 registry 安装和隔离运行时检查。
-- 可选地让 Codex 自动审查在 DSH 策略检查之后处理符合条件的 Harness 审批请求。它默认关闭，首次启用需确认完整告知，失败会回到人工审批，拒绝后支持对完全相同的重试做一次人工覆盖。
-- 通过更清晰的分步流程配置仅作用于 Codex 的可选代理：检测或输入地址、测试当前草稿、明确启用，再保存。修改已启用地址后必须重新测试；失败绝不会静默改走直连。
-- 通过“账户与额度”“模型”“网络”和“能力”四个模块导航更长的插件配置，同时保留一份共享的保存/放弃草稿。
+- 显示 ChatGPT 为当前 Codex 模型实际返回的 5 小时和每周额度窗口。缺少的窗口不会凭空出现，Spark 额度保持独立，也不会因套餐名称而隐藏服务端数据。
+- 将“当前组合是否已验证”和“是否需要提醒维护者”分开判断。缺少验证记录不再被说成已知运行失败，也不会建议降级插件。
+- 如果已经有当前 DSH 版本的统一跟进 Issue，设置卡片会直接链接过去；否则提供预填的兼容性缺口反馈。
+- 每个更高版本的 DSH 候选只维护一个 Canary 跟进 Issue，明确区分等待完整验证、兼容性失败和基础设施阻塞。Canary 成功不会自动声明兼容或发布版本。
 
 ### 版本更新提醒
 
-Codex Connect 会通过 DSH Web 服务定期检查公开的 npm 包信息，以及本仓库维护的 `verified-compatibility.json`。同一张卡片会读取本机实际加载的 DSH 软件包版本，与本项目记录的最新 DSH 版本并列显示，并对当前安装的插件版本和 DSH 版本这一组精确组合进行判断。本机版本检测只使用插件已经能够取得的软件包元数据，不要求 DSH Core 作出任何修改。
+Codex Connect 会通过 DSH Web 服务定期检查公开的 npm 包信息，以及本仓库维护的 `verified-compatibility.json`。同一张卡片会读取本机实际加载的 DSH 软件包版本，与本项目记录的最新 DSH 版本并列显示，并对当前安装的插件版本和 DSH 版本这一组精确组合进行判断。本机版本检测只使用插件已经能够取得的软件包元数据，不要求 DSH Core 作出任何修改。卡片仅在需要兼容性跟进时查询 Issue，并且只向 GitHub 公开搜索 API 发送这个公开的 DSH 版本号。卡片将两项判断分开：状态只说明当前精确组合或明确升级路径是否已验证；只有当前安装的 DSH 等于或新于记录中的最新版、且尚无任何已验证的已发布插件时，才显示 GitHub 跟进操作。缺少验证记录不代表该组合已知不可运行。
 
-兼容性清单按插件版本和 DSH 版本精确记录，不假设后续版本天然兼容。维护者确认新的 DSH 版本后，只需更新仓库文件，不必重新发布插件。绿色表示当前安装组合已经通过验证；黄色表示最新插件已与当前 DSH 版本通过验证，应先升级插件；红色表示清单中已有当前 DSH 版本，但当前插件和最新发布的插件都没有对应记录；灰色表示清单尚未记录当前 DSH 版本，或暂时无法检查公开清单。红色状态会按当前安装的 DSH 版本提供预填内容的 GitHub Issue 链接，让用户无需自行组织报告就能提醒维护者。
+兼容性清单按插件版本和 DSH 版本精确记录，不假设后续版本天然兼容。维护者确认新的 DSH 版本后，只需更新仓库文件，不必重新发布插件。绿色表示当前安装组合已经通过验证。黄色状态下，如果最新插件适配当前 DSH，就建议升级插件；如果最新插件适配最新 DSH，就建议升级 DSH。红色表示当前 DSH 已达到或超过清单记录的最新版，但最新发布的插件仍未完成验证；如果已有该版本的统一兼容性跟进 Issue，卡片会直接链接过去，如果查询失败或没有匹配项，则提供预填的兼容性缺口反馈。灰色表示较早的 DSH 版本未被记录，或暂时无法检查公开清单。
 
 发现插件新版本后，即使你切换了对话，DSH 界面也会显示全局更新提醒。提醒会先展示从你当前版本到最新版本之间对用户有用的功能；完整技术发布说明放在次级详情或发布页面中。插件不会自动执行升级命令。
 
@@ -67,7 +67,7 @@ dsh web
 
 ### 3. 找到 Openai-Codex 账户卡
 
-打开 **设置 → 模型**，找到 **Openai-Codex**。这是 Alpha 4.24 的主要账户入口。如果当前 profile 没有模型设置分区，请改用 **设置 → 插件 → 插件配置 → Codex Connect**。
+打开 **设置 → 模型**，找到 **Openai-Codex**。这是 Alpha 4.25 的主要账户入口。如果当前 profile 没有模型设置分区，请改用 **设置 → 插件 → 插件配置 → Codex Connect**。
 
 模型页账户卡标注“由 Codex Connect 插件提供支持。”，用于 ChatGPT 授权、重新授权、退出和查看额度。两个设置页面共用同一份内存账户状态及轮询。**更多设置** 会在弹窗中打开代理、模型显示、搜索、图片和上下文预算配置表单，原插件设置入口仍保留。两处保存到同一份配置；关闭弹窗或按 Escape 会放弃弹窗内未保存的修改。模型页底部入口是可选增强：没有该设置分区的 profile 仍保留原插件入口。
 
@@ -138,11 +138,11 @@ dsh plugin --profile web exec dsh-codex-connect doctor --json
 只有当前对话选择了 `openai-codex` 提供方的 GPT 模型时，Composer 才会显示下面两个小控件。它们都是当前对话级别的控制，不是 profile 全局设置：
 
 - **Fast Mode（闪电图标）**：每个对话默认关闭。点击后请求更快的 `1.5 倍` 模式，再点一次恢复标准速度。它只绑定当前对话，不会改变模型选择，也不会影响其他对话。鼠标悬停或键盘聚焦闪电图标，可以看到当前状态和额度消耗提示。
-- **周额度进度条**：位于模型选择器旁边的短横条。剩余额度越低，颜色会从绿色经过黄色/橙色变为红色。鼠标悬停或键盘聚焦时，会显示精确剩余百分比和服务端提供的重置时间。非 GPT 模型或额度暂时不可用时不会显示。
-- 对于精确模型 `gpt-5.3-codex-spark`，Composer 读取 Spark 的每周额度；其他 GPT Codex 模型读取标准 Codex 周额度，两者是分开的额度桶。
+- **额度进度条**：位于模型选择器旁边，以紧凑的 `5h` 和 `7d` 行显示。只有服务端为当前模型额度桶返回对应窗口时，该行才会出现。剩余额度越低，颜色会从绿色经过黄色/橙色变为红色。鼠标悬停或键盘聚焦时，会显示每个窗口的精确剩余百分比和服务端提供的重置时间。非 GPT 模型或没有可识别额度窗口时不会显示。
+- 对于精确模型 `gpt-5.3-codex-spark`，Composer 读取独立的 Spark 额度桶；其他 GPT Codex 模型读取标准 Codex 额度桶。插件不会根据 ChatGPT 套餐名称猜测额度窗口。
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/franksong2702/dsh-codex-connect/main/docs/assets/composer-capabilities.jpg" alt="DeepSeek Harness Composer 中按对话绑定的 Fast Mode 闪电控件和周额度进度条" width="820">
+  <img src="https://raw.githubusercontent.com/franksong2702/dsh-codex-connect/main/docs/assets/composer-capabilities.jpg" alt="DeepSeek Harness Composer 中按对话绑定的 Fast Mode 闪电控件和额度进度条" width="820">
 </p>
 
 ## 可选能力（默认关闭）
@@ -202,10 +202,10 @@ Codex Connect 默认使用**直连**。代理是可选项，只作用于本插
 
 登录后，Codex Connect 设置卡片可能显示多个服务端额度窗口。它们是不同的额度桶，不是同一个数字重复显示：
 
-- **Codex · 每周额度**：普通 GPT Codex 模型使用的标准 Codex 周额度。
-- **GPT-5.3-Codex-Spark · 5 小时额度** 和 **GPT-5.3-Codex-Spark · 每周额度**：Spark 模型返回的两个独立窗口。
+- 标准 **Codex** 额度桶可能包含 **5 小时额度**、**每周额度**，或者同时包含两者。
+- 精确 Spark 模型使用独立的 **GPT-5.3-Codex-Spark** 额度桶，并显示该额度桶实际返回的窗口。
 
-每条进度条都会显示剩余百分比和按本地时区格式化的重置时间。额度窗口、模型资格和重置时间由 OpenAI 返回；数据缺失时界面会显示不可用，不会自行猜测。
+每条进度条都会显示剩余百分比和按本地时区格式化的重置时间。额度窗口、模型资格和重置时间由 OpenAI 返回；Codex Connect 不会根据套餐名称删除已返回的窗口，也不会虚构缺失窗口。
 
 ### 单独更改默认模型或全局搜索路由
 
@@ -324,7 +324,7 @@ dsh plugin --profile web exec dsh-codex-connect auto-review-probe --json
 
 ## 兼容性与安全边界
 
-- Alpha 4.24 已与 DSH 插件 API packages `0.1.2-alpha.5`、`@earendil-works/pi-ai` `^0.84.2`（验证时解析为 `0.84.4`）和 Node.js `^22.19.0 || >=24.0.0` 完成验证。Alpha 4.23 仍是 DSH `0.1.2-alpha.2` 的已验证选择；Alpha 4.21 仍与 DSH `0.1.1-rc.2` 和 pi-ai `0.82.1` 保持已验证状态。[verified-compatibility.json](../verified-compatibility.json) 记录精确组合；安装命令见 [INSTALL.md](../INSTALL.md)。
+- Alpha 4.25 已与 DSH 插件 API packages `0.1.2-alpha.5`、`@earendil-works/pi-ai` `^0.84.2`（验证时解析为 `0.84.4`）和 Node.js `^22.19.0 || >=24.0.0` 完成验证。Alpha 4.24 仍是同一 DSH 版本较早的已验证选择；Alpha 4.23 仍是 DSH `0.1.2-alpha.2` 的已验证选择；Alpha 4.21 仍与 DSH `0.1.1-rc.2` 和 pi-ai `0.82.1` 保持已验证状态。[verified-compatibility.json](../verified-compatibility.json) 记录精确组合；安装命令见 [INSTALL.md](../INSTALL.md)。
 - 新版 DSH 将原来的 client runtime 拆分为 Session Controller、Settings、Store 和 Renderer 包。Codex Connect 通过这些公开接口接入设置和图片操作。规范化预览的编码与尺寸由 DSH 决定；Codex Connect 另行保留字节完全一致的原图。
 - 升级时请将 DSH 插件 API packages 与 `@earendil-works/pi-ai` 作为一组升级，再运行 `dsh-codex-connect doctor --json` 和兼容性检查。本契约不对未来版本作判断。
 - 每日上游检查发现新的 DSH `latest` 或 `next` 候选版本时，会把 Codex Connect 安装到隔离 Profile 中，在没有 OAuth 凭据的情况下启动已安装的模型运行时，验证模型与推理强度发现，并确认提供方可被正确卸载。真实登录、额度和模型请求仍需在测试 Profile 中人工验证。

package/docs/design.i18n.yaml

@@ -1,4 +1,4 @@
 # Bilingual-pair consistency record for the design document. Re-record with:
 #   git hash-object docs/design.md docs/design.zh.md
-design.md: b1ce6b106a81c0e035db3f87c87748bbcc60a743
-design.zh.md: 821df671587a95baba65dd5e874f4d1d535a52a2
+design.md: 86c383527dad511eb3458fb6c6389d5f8e9e9c16
+design.zh.md: f6112594d2c88ebab0f35e5f8f8dd2e949e611b5

package/docs/design.md

@@ -26,4 +26,4 @@ Before registration the plugin checks current provider ids. An existing `openai-
 
 ## Compatibility boundary
 
-Alpha 4.24 pins Harness `0.1.2-alpha.5` development dependencies and follows its pi-ai range `^0.84.2`; the verified release lockfile selects pi-ai `0.84.4`. Supported Node.js remains `^22.19.0 || >=24.0.0`. The keyed `settings.plugin.item` integration remains, while client types come from their Session Controller, Settings, Store, and Renderer owners. The published compatibility record lists the exact Alpha 4.24 and DSH `0.1.2-alpha.5` pair. Backend eligibility, quotas, models, service-side context capacity, and protocol details remain controlled upstream. Tests use temporary OAuth documents and mocked network responses; CI does not perform real authentication.
+Alpha 4.25 pins Harness `0.1.2-alpha.5` development dependencies and follows its pi-ai range `^0.84.2`; the verified release lockfile selects pi-ai `0.84.4`. Supported Node.js remains `^22.19.0 || >=24.0.0`. The keyed `settings.plugin.item` integration remains, while client types come from their Session Controller, Settings, Store, and Renderer owners. The published compatibility record lists the exact Alpha 4.25 and DSH `0.1.2-alpha.5` pair. Backend eligibility, quotas, models, service-side context capacity, and protocol details remain controlled upstream. Tests use temporary OAuth documents and mocked network responses; CI does not perform real authentication.

package/docs/design.zh.md

@@ -22,4 +22,4 @@ Host 将 `llm-openai-codex` 注册为插件自有的能力 settings namespace。
 
 注册前检查现有 provider id；发现 `openai-codex` 已被占用时，给出旧 bundle 或手动 provider 配置的定向迁移提示。boot-free CLI doctor 只报告包/运行时版本、OAuth 路径元数据、能力默认值和安全提示。
 
-Alpha 4.24 固定使用 Harness `0.1.2-alpha.5` 开发依赖，并跟随其 pi-ai 版本范围 `^0.84.2`；已验证的发布锁文件选择 pi-ai `0.84.4`。Node.js 支持范围仍为 `^22.19.0 || >=24.0.0`。keyed `settings.plugin.item` 集成保持不变，客户端类型继续从 Session Controller、Settings、Store 和 Renderer 的所属包导入。已发布兼容性记录列出 Alpha 4.24 与 DSH `0.1.2-alpha.5` 的精确组合。资格、额度、模型、服务端上下文容量和后端协议仍由上游控制。测试仅使用临时 OAuth 文档和模拟网络响应，CI 不执行真实认证。
+Alpha 4.25 固定使用 Harness `0.1.2-alpha.5` 开发依赖，并跟随其 pi-ai 版本范围 `^0.84.2`；已验证的发布锁文件选择 pi-ai `0.84.4`。Node.js 支持范围仍为 `^22.19.0 || >=24.0.0`。keyed `settings.plugin.item` 集成保持不变，客户端类型继续从 Session Controller、Settings、Store 和 Renderer 的所属包导入。已发布兼容性记录列出 Alpha 4.25 与 DSH `0.1.2-alpha.5` 的精确组合。资格、额度、模型、服务端上下文容量和后端协议仍由上游控制。测试仅使用临时 OAuth 文档和模拟网络响应，CI 不执行真实认证。

package/lib/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { At as logoutOpenAICodex, Ft as OpenAICodexCredentialStore, H as DSH_PLUGIN_API_PACKAGES, It as openAICodexAuthPath, Mt as openAICodexModelCatalog, N as CODEX_CONNECT_VERSION, Pt as OPENAI_CODEX_PROVIDER, Tt as normalizeTrustedOrigin, X as readInstalledPackageVersion, Y as evaluateCompatibility, c as migrateOpenAICodexSearchHistory, d as OPENAI_CODEX_BASE_URL, gt as normalizeOpenAICodexProxyUrl, j as diagnoseOpenAICodex, jt as openAICodexAuthStatus, kt as loginOpenAICodex, l as CODEX_AUTO_REVIEW_MODEL, u as probeCodexAutoReview, wt as OpenAICodexTrustedOriginsStore } from "./src-NE6c_5P4.js";
+import { At as logoutOpenAICodex, Ft as OpenAICodexCredentialStore, H as DSH_PLUGIN_API_PACKAGES, It as openAICodexAuthPath, Mt as openAICodexModelCatalog, N as CODEX_CONNECT_VERSION, Pt as OPENAI_CODEX_PROVIDER, Tt as normalizeTrustedOrigin, X as readInstalledPackageVersion, Y as evaluateCompatibility, c as migrateOpenAICodexSearchHistory, d as OPENAI_CODEX_BASE_URL, gt as normalizeOpenAICodexProxyUrl, j as diagnoseOpenAICodex, jt as openAICodexAuthStatus, kt as loginOpenAICodex, l as CODEX_AUTO_REVIEW_MODEL, u as probeCodexAutoReview, wt as OpenAICodexTrustedOriginsStore } from "./src-Di2xxpDv.js";
 import { createHash } from "node:crypto";
 import { Agent, ProxyAgent, fetch } from "undici";
 import { fileURLToPath } from "node:url";

package/lib/client.js

@@ -2019,6 +2019,9 @@ window.__ModuleLoader__.load({
 		function releaseUrl(version) {
 			return `${OPENAI_CODEX_RELEASE_PAGE_BASE}${version}`;
 		}
+		function validCanaryTrackerUrl(value) {
+			return typeof value === "string" && /^https:\/\/github\.com\/franksong2702\/dsh-codex-connect\/issues\/[1-9]\d*$/u.test(value);
+		}
 		/** Validate a route response before it is rendered by the browser. */
 		function parseOpenAICodexUpdateResult(value) {
 			if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
@@ -2091,9 +2094,14 @@ window.__ModuleLoader__.load({
 			if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
 			const record = value;
 			const status = record["status"];
-			if (status !== "compatible" && status !== "plugin-update-required" && status !== "not-yet-compatible" && status !== "unverified") return void 0;
+			if (status !== "compatible" && status !== "plugin-update-required" && status !== "dsh-update-required" && status !== "not-yet-compatible" && status !== "unverified") return void 0;
 			if (record["latestPluginVersion"] !== latestPluginVersion) return void 0;
 			const latestDshVersion = record["latestDshVersion"];
+			const reportCompatibilityGap = record["reportCompatibilityGap"];
+			const trackerUrl = record["trackerUrl"];
+			if (reportCompatibilityGap !== void 0 && reportCompatibilityGap !== true) return void 0;
+			if (reportCompatibilityGap === true && status !== "not-yet-compatible") return void 0;
+			if (trackerUrl !== void 0 && (reportCompatibilityGap !== true || !validCanaryTrackerUrl(trackerUrl))) return void 0;
 			if (status === "unverified") {
 				if (latestDshVersion === void 0) return {
 					status,
@@ -2110,7 +2118,9 @@ window.__ModuleLoader__.load({
 			return {
 				status,
 				latestPluginVersion,
-				latestDshVersion
+				latestDshVersion,
+				...reportCompatibilityGap === true ? { reportCompatibilityGap: true } : {},
+				...trackerUrl === void 0 ? {} : { trackerUrl }
 			};
 		}
 		//#endregion
@@ -2468,18 +2478,21 @@ window.__ModuleLoader__.load({
 		const compatibilityTitleKeys = {
 			compatible: "compatibilityCompatibleTitle",
 			"plugin-update-required": "compatibilityPluginUpdateTitle",
+			"dsh-update-required": "compatibilityDshUpdateTitle",
 			"not-yet-compatible": "compatibilityNotReadyTitle",
 			unverified: "compatibilityUnverifiedTitle"
 		};
 		const compatibilityBodyKeys = {
 			compatible: "compatibilityCompatibleBody",
 			"plugin-update-required": "compatibilityPluginUpdateBody",
+			"dsh-update-required": "compatibilityDshUpdateBody",
 			"not-yet-compatible": "compatibilityNotReadyBody",
 			unverified: "compatibilityUnverifiedBody"
 		};
 		const compatibilityIcons = {
 			compatible: "🟢",
 			"plugin-update-required": "🟡",
+			"dsh-update-required": "🟡",
 			"not-yet-compatible": "🔴",
 			unverified: "⚪"
 		};
@@ -2499,10 +2512,10 @@ window.__ModuleLoader__.load({
 				latest
 			});
 		}
-		function compatibilityIssueUrl(currentVersion, latestPluginVersion, currentDshVersion) {
+		function compatibilityIssueUrl(currentVersion, latestPluginVersion, currentDshVersion, latestDshVersion) {
 			const params = new URLSearchParams({
-				title: `Verify Codex Connect compatibility with DSH ${currentDshVersion}`,
-				body: `The compatibility card reports that Codex Connect ${currentVersion} is not verified with DSH ${currentDshVersion}. The latest published plugin version shown is ${latestPluginVersion}. Please verify or update the public compatibility record.`
+				title: `Support Codex Connect on DSH ${currentDshVersion}`,
+				body: `The compatibility card could not find a verified Codex Connect release for DSH ${currentDshVersion}. Installed Codex Connect: ${currentVersion}. Latest published Codex Connect: ${latestPluginVersion}. Latest DSH version in the compatibility record: ${latestDshVersion ?? "unavailable"}. This reports a verification or adaptation gap; it does not claim that the installed combination is known to fail.`
 			});
 			return `${OPENAI_CODEX_REPOSITORY_URL}/issues/new?${params.toString()}`;
 		}
@@ -2639,8 +2652,8 @@ window.__ModuleLoader__.load({
 				compatibilityTitleKey = "compatibilityCurrentDshNewerTitle";
 				compatibilityBodyKey = "compatibilityCurrentDshNewerBody";
 			}
-			const compatibilityWarning = compatibility?.status === "plugin-update-required" || compatibility?.status === "not-yet-compatible";
-			const noticeKey = latestVersion === void 0 ? void 0 : `${snapshot.currentVersion}:${latestVersion}:${snapshot.currentDshVersion ?? "unknown"}:${compatibility?.latestDshVersion ?? "unknown"}:${compatibility?.status ?? "none"}`;
+			const compatibilityWarning = compatibility?.status === "plugin-update-required" || compatibility?.status === "dsh-update-required" || compatibility?.status === "not-yet-compatible";
+			const noticeKey = latestVersion === void 0 ? void 0 : `${snapshot.currentVersion}:${latestVersion}:${snapshot.currentDshVersion ?? "unknown"}:${compatibility?.latestDshVersion ?? "unknown"}:${compatibility?.status ?? "none"}:${compatibility?.reportCompatibilityGap === true ? "report" : "no-report"}`;
 			if (overlay && (!compatibilityWarning && snapshot.status !== "update-available" || noticeKey === void 0 || snapshot.dismissedNotice === noticeKey)) return null;
 			const available = snapshot.status === "update-available";
 			const technicalDetails = available && technicalDetailsOpen;
@@ -2697,14 +2710,21 @@ window.__ModuleLoader__.load({
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
 								style: bodyStyle$1,
-								children: t(compatibilityBodyKey ?? compatibilityBodyKeys[compatibility.status])
+								children: compatibility.status === "dsh-update-required" ? t("compatibilityDshUpdateBody", { latestDshVersion: compatibility.latestDshVersion ?? "" }) : t(compatibilityBodyKey ?? compatibilityBodyKeys[compatibility.status])
 							}),
-							compatibility.status === "not-yet-compatible" && snapshot.currentDshVersion !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
-								href: compatibilityIssueUrl(snapshot.currentVersion, compatibility.latestPluginVersion, snapshot.currentDshVersion),
+							compatibility.status === "dsh-update-required" && compatibility.latestDshVersion !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
+								href: `https://github.com/deepseek-ai/deepseek-harness/releases/tag/dsh-v${compatibility.latestDshVersion}`,
 								target: "_blank",
 								rel: "noopener noreferrer",
 								style: textButtonStyle,
-								children: t("compatibilityReport")
+								children: t("compatibilityDshUpdateAction", { version: compatibility.latestDshVersion })
+							}) : null,
+							compatibility.reportCompatibilityGap === true && snapshot.currentDshVersion !== void 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("a", {
+								href: compatibility.trackerUrl ?? compatibilityIssueUrl(snapshot.currentVersion, compatibility.latestPluginVersion, snapshot.currentDshVersion, compatibility.latestDshVersion),
+								target: "_blank",
+								rel: "noopener noreferrer",
+								style: textButtonStyle,
+								children: compatibility.trackerUrl === void 0 ? t("compatibilityReport") : t("compatibilityViewTracker")
 							}) : null
 						]
 					}),
@@ -3503,8 +3523,9 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/OpenAICodexQuotaIndicator.tsx
-		/** Compact weekly Codex quota indicator for the Composer tool row. */
+		/** Compact server-driven Codex quota indicator for the Composer tool row. */
 		const WEEK_SECONDS = 604800;
+		const FIVE_HOUR_SECONDS = 18e3;
 		const USAGE_POLL_INTERVAL_MS = 6e4;
 		const CODEX_PROVIDER$1 = "openai-codex";
 		const SPARK_MODEL = "gpt-5.3-codex-spark";
@@ -3530,9 +3551,9 @@ window.__ModuleLoader__.load({
 			}
 			return usage;
 		}
-		function weeklyQuotaOf(usage, model) {
+		function quotaOf(usage, model, windowSeconds) {
 			const quotaId = model === SPARK_MODEL ? SPARK_QUOTA_ID : "codex";
-			return usage.rateLimits.find((limit) => limit.id === quotaId)?.windows.find((window) => window.windowSeconds === WEEK_SECONDS);
+			return usage.rateLimits.find((limit) => limit.id === quotaId)?.windows.find((window) => window.windowSeconds === windowSeconds);
 		}
 		function isGptModel(state) {
 			const current = state.current;
@@ -3568,7 +3589,7 @@ window.__ModuleLoader__.load({
 		function subscribeDirectory$1(directory, listener) {
 			return directory.subscribe(listener);
 		}
-		/** Render nothing until an eligible GPT Codex session has a usable weekly quota. */
+		/** Render the recognized quota windows returned for the current model bucket. */
 		function OpenAICodexQuotaIndicator({ directory, t }) {
 			const directoryState = (0, react.useSyncExternalStore)((listener) => subscribeDirectory$1(directory, listener), () => directory.getSnapshot(), () => directory.getSnapshot());
 			const eligible = isGptModel(directoryState);
@@ -3618,18 +3639,32 @@ window.__ModuleLoader__.load({
 				};
 			}, [eligible]);
 			if (!eligible || request.status !== "ready" || request.usage === void 0) return null;
-			const weekly = weeklyQuotaOf(request.usage, directoryState.current?.model);
-			if (weekly === void 0) return null;
-			const summary = t("composerWeeklyQuotaSummary", {
-				percent: formatPercent(weekly.remainingPercent),
-				time: formatOpenAICodexResetAt(weekly.resetAt) ?? t("resetUnavailable")
-			});
-			const boundedPercent = boundedQuotaPercent(weekly.remainingPercent);
-			const progressColor = quotaProgressColor(weekly.remainingPercent);
+			const model = directoryState.current?.model;
+			const fiveHour = quotaOf(request.usage, model, FIVE_HOUR_SECONDS);
+			const weekly = quotaOf(request.usage, model, WEEK_SECONDS);
+			const quotas = [...fiveHour === void 0 ? [] : [{
+				kind: "five-hour",
+				shortLabel: t("composerFiveHourShort"),
+				summary: t("composerFiveHourQuotaSummary", {
+					percent: formatPercent(fiveHour.remainingPercent),
+					time: formatOpenAICodexResetAt(fiveHour.resetAt) ?? t("resetUnavailable")
+				}),
+				window: fiveHour
+			}], ...weekly === void 0 ? [] : [{
+				kind: "weekly",
+				shortLabel: t("composerWeeklyShort"),
+				summary: t("composerWeeklyQuotaSummary", {
+					percent: formatPercent(weekly.remainingPercent),
+					time: formatOpenAICodexResetAt(weekly.resetAt) ?? t("resetUnavailable")
+				}),
+				window: weekly
+			}]];
+			if (quotas.length === 0) return null;
+			const summary = quotas.map((quota) => quota.summary).join("; ");
 			const tooltipVisible = isHovered || isFocused;
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 				role: "status",
-				"data-openai-codex-quota": "weekly",
+				"data-openai-codex-quota": quotas.map((quota) => quota.kind).join(","),
 				"aria-label": summary,
 				"aria-describedby": tooltipVisible ? tooltipId : void 0,
 				tabIndex: 0,
@@ -3647,39 +3682,59 @@ window.__ModuleLoader__.load({
 				},
 				style: {
 					display: "inline-flex",
-					width: `${QUOTA_PROGRESS_WIDTH_PX}px`,
-					height: "28px",
+					width: `70px`,
+					minHeight: "28px",
 					position: "relative",
 					alignItems: "center",
-					justifyContent: "center"
+					justifyContent: "center",
+					flexDirection: "column",
+					gap: "3px"
 				},
-				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-					"aria-hidden": "true",
-					"data-openai-codex-quota-track": "weekly",
-					style: {
-						display: "block",
-						width: `${QUOTA_PROGRESS_WIDTH_PX}px`,
-						height: `${QUOTA_PROGRESS_TRACK_HEIGHT_PX}px`,
-						borderRadius: "999px",
-						backgroundColor: "var(--dsw-alias-border-l2)",
-						overflow: "hidden"
-					},
-					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				children: [quotas.map((quota) => {
+					const progressColor = quotaProgressColor(quota.window.remainingPercent);
+					return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
 						"aria-hidden": "true",
-						"data-openai-codex-quota-progress": "weekly",
-						"data-openai-codex-quota-color": progressColor.name,
 						style: {
-							display: "block",
-							width: `${boundedPercent}%`,
-							height: "100%",
-							borderRadius: "inherit",
-							backgroundColor: progressColor.value
-						}
-					})
+							display: "inline-flex",
+							alignItems: "center",
+							gap: 4
+						},
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							style: {
+								width: 18,
+								color: "var(--dsw-alias-label-tertiary)",
+								fontSize: 9,
+								lineHeight: "10px",
+								textAlign: "right"
+							},
+							children: quota.shortLabel
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+							"data-openai-codex-quota-track": quota.kind,
+							style: {
+								display: "block",
+								width: `${QUOTA_PROGRESS_WIDTH_PX}px`,
+								height: `${QUOTA_PROGRESS_TRACK_HEIGHT_PX}px`,
+								borderRadius: "999px",
+								backgroundColor: "var(--dsw-alias-border-l2)",
+								overflow: "hidden"
+							},
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+								"data-openai-codex-quota-progress": quota.kind,
+								"data-openai-codex-quota-color": progressColor.name,
+								style: {
+									display: "block",
+									width: `${boundedQuotaPercent(quota.window.remainingPercent)}%`,
+									height: "100%",
+									borderRadius: "inherit",
+									backgroundColor: progressColor.value
+								}
+							})
+						})]
+					}, quota.kind);
 				}), tooltipVisible ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 					id: tooltipId,
 					role: "tooltip",
-					"data-openai-codex-quota-tooltip": "weekly",
+					"data-openai-codex-quota-tooltip": quotas.map((quota) => quota.kind).join(","),
 					style: {
 						position: "absolute",
 						bottom: "calc(100% + 6px)",
@@ -3966,6 +4021,9 @@ window.__ModuleLoader__.load({
 			resetAt: "Resets {time}",
 			resetUnavailable: "Reset time unavailable",
 			composerWeeklyQuota: "Codex weekly quota",
+			composerFiveHourShort: "5h",
+			composerWeeklyShort: "7d",
+			composerFiveHourQuotaSummary: "Codex 5-hour quota: {percent}% remaining; resets {time}",
 			composerWeeklyQuotaSummary: "Codex weekly quota: {percent}% remaining; resets {time}",
 			fastModeEnabledTitle: "Current: 1.5× speed, with faster quota consumption. Click to switch to Standard speed.",
 			fastModeDisabledTitle: "Current: Standard speed. Click to enable 1.5× speed.",
@@ -4147,8 +4205,11 @@ window.__ModuleLoader__.load({
 			compatibilityCurrentDshNewerBody: "Compatibility has not been confirmed for this running DSH version yet.",
 			compatibilityPluginUpdateTitle: "Update Codex Connect first",
 			compatibilityPluginUpdateBody: "Your installed plugin is not verified with this DSH version, but the latest plugin is. Update the plugin before DSH.",
-			compatibilityNotReadyTitle: "Wait before updating DSH",
-			compatibilityNotReadyBody: "Neither your installed plugin nor the latest published plugin has been verified with this DSH version.",
+			compatibilityDshUpdateTitle: "Current combination is not verified; update DSH",
+			compatibilityDshUpdateBody: "This exact Codex Connect and DSH combination has not been verified. The latest Codex Connect is verified with DSH {latestDshVersion}; move to that verified pair instead of installing an older plugin.",
+			compatibilityDshUpdateAction: "Open DSH {version} release",
+			compatibilityNotReadyTitle: "Codex Connect has not caught up with this DSH version",
+			compatibilityNotReadyBody: "Neither your installed plugin nor the latest published plugin has been verified with this DSH version. This does not prove the combination will fail; report the gap so the maintainer can verify and adapt it.",
 			compatibilityUnverifiedTitle: "Compatibility is not confirmed",
 			compatibilityUnverifiedBody: "The compatibility information maintained by this project is temporarily unavailable. Check again later.",
 			compatibilityDshSame: "DSH: {version} · Up to date",
@@ -4159,7 +4220,8 @@ window.__ModuleLoader__.load({
 			compatibilityPluginSame: "Codex Connect: {version} · Up to date",
 			compatibilityPluginDifferent: "Codex Connect: Current {current} · Latest {latest}",
 			compatibilityPluginCurrentOnly: "Codex Connect: Current {current} · Latest version unavailable",
-			compatibilityReport: "Remind the author to verify compatibility",
+			compatibilityReport: "Report a Codex Connect compatibility gap",
+			compatibilityViewTracker: "View compatibility progress",
 			currentVersion: "Current version: {version}",
 			checkForUpdates: "Check for updates",
 			checkingForUpdates: "Checking for updates…",
@@ -4252,6 +4314,9 @@ window.__ModuleLoader__.load({
 			resetAt: "{time} 重置",
 			resetUnavailable: "重置时间不可用",
 			composerWeeklyQuota: "Codex 周额度",
+			composerFiveHourShort: "5h",
+			composerWeeklyShort: "7d",
+			composerFiveHourQuotaSummary: "Codex 5 小时额度：剩余 {percent}%；重置时间 {time}",
 			composerWeeklyQuotaSummary: "Codex 周额度：剩余 {percent}%；重置时间 {time}",
 			fastModeEnabledTitle: "当前：1.5 倍速度，额度消耗更快。点击切换到标准速度",
 			fastModeDisabledTitle: "当前：标准速度。点击开启 1.5 倍速度",
@@ -4433,8 +4498,11 @@ window.__ModuleLoader__.load({
 			compatibilityCurrentDshNewerBody: "当前运行的 DSH 版本尚未确认兼容性。",
 			compatibilityPluginUpdateTitle: "请先升级 Codex Connect",
 			compatibilityPluginUpdateBody: "当前插件尚未通过该 DSH 版本的验证，但最新插件已经通过。请先升级插件，再升级 DSH。",
-			compatibilityNotReadyTitle: "暂缓升级 DSH",
-			compatibilityNotReadyBody: "当前插件和最新发布的插件都尚未通过该 DSH 版本的兼容性验证。",
+			compatibilityDshUpdateTitle: "当前版本组合尚未验证，请升级 DSH",
+			compatibilityDshUpdateBody: "当前 Codex Connect 与 DSH 的精确组合尚未验证。最新版 Codex Connect 已与 DSH {latestDshVersion} 完成验证；请升级到这组已验证版本，不必安装旧版插件。",
+			compatibilityDshUpdateAction: "打开 DSH {version} 发布页",
+			compatibilityNotReadyTitle: "Codex Connect 尚未跟上此 DSH 版本",
+			compatibilityNotReadyBody: "当前插件和最新发布的插件都尚未通过该 DSH 版本的兼容性验证。这不代表它一定无法运行；请反馈此适配缺口，让维护者尽快验证并更新。",
 			compatibilityUnverifiedTitle: "兼容性尚未确认",
 			compatibilityUnverifiedBody: "暂时无法取得本项目维护的兼容性信息，请稍后重新检查。",
 			compatibilityDshSame: "DSH：{version} · 已是最新",
@@ -4445,7 +4513,8 @@ window.__ModuleLoader__.load({
 			compatibilityPluginSame: "Codex Connect：{version} · 已是最新",
 			compatibilityPluginDifferent: "Codex Connect：当前 {current} · 最新 {latest}",
 			compatibilityPluginCurrentOnly: "Codex Connect：当前 {current} · 无法取得最新版本",
-			compatibilityReport: "提醒作者验证兼容性",
+			compatibilityReport: "反馈 Codex Connect 兼容性缺口",
+			compatibilityViewTracker: "查看兼容性跟进",
 			currentVersion: "当前版本：{version}",
 			checkForUpdates: "检查更新",
 			checkingForUpdates: "正在检查更新…",
@@ -5656,7 +5725,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/version.ts
-		const CODEX_CONNECT_VERSION = "0.1.0-alpha.4.24";
+		const CODEX_CONNECT_VERSION = "0.1.0-alpha.4.25";
 		//#endregion
 		//#region src/client/OpenAICodexModelsCard.tsx
 		/** Compact Models account entry with quota disclosure and shared configuration. */

package/lib/index.d.ts

@@ -582,11 +582,13 @@ interface OpenAICodexUpdateHighlight {
   version: string;
   kind: OpenAICodexUpdateHighlightKind;
 }
-type OpenAICodexDshCompatibilityStatus = 'compatible' | 'plugin-update-required' | 'not-yet-compatible' | 'unverified';
+type OpenAICodexDshCompatibilityStatus = 'compatible' | 'plugin-update-required' | 'dsh-update-required' | 'not-yet-compatible' | 'unverified';
 interface OpenAICodexDshCompatibilityAdvice {
   status: OpenAICodexDshCompatibilityStatus;
   latestPluginVersion: string;
   latestDshVersion?: string;
+  reportCompatibilityGap?: true;
+  trackerUrl?: string;
 }
 type OpenAICodexUpdateResult = {
   status: 'up-to-date';

package/lib/index.js

@@ -1,2 +1,2 @@
-import { $ as OPENAI_CODEX_LOCAL_PROXY_CANDIDATES, A as assertNoOpenAICodexProviderConflict, At as logoutOpenAICodex, B as COMPATIBILITY_PACKAGES, C as OPENAI_CODEX_TRANSPORT_ERROR_CODES, Ct as isFastModeSessionId, D as isOpenAICodexTransportError, Dt as parseOpenAICodexUsage, E as OpenAICodexTransportError, Et as OPENAI_CODEX_USAGE_URL, F as checkForOpenAICodexUpdate, Ft as OpenAICodexCredentialStore, G as SUPPORTED_NODE_RANGE, H as DSH_PLUGIN_API_PACKAGES, I as compareOpenAICodexVersions, It as openAICodexAuthPath, J as detectCompatibility, K as SUPPORTED_PI_AI_RANGE, L as parseOpenAICodexUpdateResult, M as openAICodexConflictMessage, Nt as OPENAI_CODEX_AUTH_FILENAME, O as VIEW_IMAGE_TOOL_NAME, Ot as readOpenAICodexRateLimits, P as OPENAI_CODEX_UPDATE_PATH, Pt as OPENAI_CODEX_PROVIDER, Q as OPENAI_CODEX_PROXY_TEST_PATH, R as parseOpenAICodexVersion, S as OPENAI_CODEX_TRANSPORT_API_VERSION, St as OPENAI_CODEX_FAST_MODE_MAX_SESSION_ID_LENGTH, T as OpenAICodexTransport, U as PI_AI_PACKAGE, V as COMPATIBILITY_SCHEMA_VERSION, W as SUPPORTED_DSH_PLUGIN_API_VERSION, Y as evaluateCompatibility, Z as OPENAI_CODEX_PROXY_DETECT_PATH, _ as OPENAI_CODEX_IMAGE_MAX_COUNT, _t as resolveOpenAICodexProxyUrl, a as name, at as listOpenAICodexProxyCandidates, b as OPENAI_CODEX_IMAGE_PROMPT_MAX_LENGTH, bt as FastModeRegistry, c as migrateOpenAICodexSearchHistory, ct as DEFAULT_OPENAI_CODEX_SEARCH_MAX_OUTPUT_TOKENS, d as OPENAI_CODEX_BASE_URL, dt as DEFAULT_OPENAI_CODEX_SETTINGS, et as OPENAI_CODEX_PROXY_CANDIDATE_LIMIT, f as OPENAI_CODEX_SEARCH_PROVIDER, ft as OPENAI_CODEX_SETTINGS_NAMESPACE, g as OPENAI_CODEX_IMAGE_GENERATION_URL, h as mapOpenAICodexSearchResponse, ht as isValidOpenAICodexProxyUrl, i as inject, it as detectOpenAICodexProxies, j as diagnoseOpenAICodex, jt as openAICodexAuthStatus, k as IMAGE_GENERATE_TOOL_NAME, kt as loginOpenAICodex, lt as DEFAULT_OPENAI_CODEX_SEARCH_MODE, m as OpenAICodexSearchProvider, mt as isValidOpenAICodexContextWindowOverrides, n as OPENAI_CODEX_SETTINGS_NS, nt as OPENAI_CODEX_PROXY_PROBE_URL, o as OPENAI_CODEX_HISTORY_BACKUP_SUFFIX, ot as DEFAULT_OPENAI_CODEX_PROXY_URL, p as OPENAI_CODEX_SEARCH_URL, pt as decodeOpenAICodexSettings, q as assessCompatibility, r as apply, rt as OpenAICodexProxyManager, s as OPENAI_CODEX_SEARCH_MODEL_REQUEST_EVENT, st as DEFAULT_OPENAI_CODEX_SEARCH_CONTEXT_SIZE, t as Config, tt as OPENAI_CODEX_PROXY_PROBE_TIMEOUT_MS, ut as DEFAULT_OPENAI_CODEX_SEARCH_MODEL, v as OPENAI_CODEX_IMAGE_MAX_ERROR_BYTES, vt as resolveOpenAICodexSettings, w as OPENAI_CODEX_TRANSPORT_SERVICE, x as OPENAI_CODEX_IMAGE_REQUEST_TIMEOUT_MS, xt as OPENAI_CODEX_FAST_MODE_MAX_SESSIONS, y as OPENAI_CODEX_IMAGE_MAX_RESPONSE_BYTES, yt as OPENAI_CODEX_FAST_MODE_PATH, z as COMPATIBILITY_CONTRACT } from "./src-NE6c_5P4.js";
+import { $ as OPENAI_CODEX_LOCAL_PROXY_CANDIDATES, A as assertNoOpenAICodexProviderConflict, At as logoutOpenAICodex, B as COMPATIBILITY_PACKAGES, C as OPENAI_CODEX_TRANSPORT_ERROR_CODES, Ct as isFastModeSessionId, D as isOpenAICodexTransportError, Dt as parseOpenAICodexUsage, E as OpenAICodexTransportError, Et as OPENAI_CODEX_USAGE_URL, F as checkForOpenAICodexUpdate, Ft as OpenAICodexCredentialStore, G as SUPPORTED_NODE_RANGE, H as DSH_PLUGIN_API_PACKAGES, I as compareOpenAICodexVersions, It as openAICodexAuthPath, J as detectCompatibility, K as SUPPORTED_PI_AI_RANGE, L as parseOpenAICodexUpdateResult, M as openAICodexConflictMessage, Nt as OPENAI_CODEX_AUTH_FILENAME, O as VIEW_IMAGE_TOOL_NAME, Ot as readOpenAICodexRateLimits, P as OPENAI_CODEX_UPDATE_PATH, Pt as OPENAI_CODEX_PROVIDER, Q as OPENAI_CODEX_PROXY_TEST_PATH, R as parseOpenAICodexVersion, S as OPENAI_CODEX_TRANSPORT_API_VERSION, St as OPENAI_CODEX_FAST_MODE_MAX_SESSION_ID_LENGTH, T as OpenAICodexTransport, U as PI_AI_PACKAGE, V as COMPATIBILITY_SCHEMA_VERSION, W as SUPPORTED_DSH_PLUGIN_API_VERSION, Y as evaluateCompatibility, Z as OPENAI_CODEX_PROXY_DETECT_PATH, _ as OPENAI_CODEX_IMAGE_MAX_COUNT, _t as resolveOpenAICodexProxyUrl, a as name, at as listOpenAICodexProxyCandidates, b as OPENAI_CODEX_IMAGE_PROMPT_MAX_LENGTH, bt as FastModeRegistry, c as migrateOpenAICodexSearchHistory, ct as DEFAULT_OPENAI_CODEX_SEARCH_MAX_OUTPUT_TOKENS, d as OPENAI_CODEX_BASE_URL, dt as DEFAULT_OPENAI_CODEX_SETTINGS, et as OPENAI_CODEX_PROXY_CANDIDATE_LIMIT, f as OPENAI_CODEX_SEARCH_PROVIDER, ft as OPENAI_CODEX_SETTINGS_NAMESPACE, g as OPENAI_CODEX_IMAGE_GENERATION_URL, h as mapOpenAICodexSearchResponse, ht as isValidOpenAICodexProxyUrl, i as inject, it as detectOpenAICodexProxies, j as diagnoseOpenAICodex, jt as openAICodexAuthStatus, k as IMAGE_GENERATE_TOOL_NAME, kt as loginOpenAICodex, lt as DEFAULT_OPENAI_CODEX_SEARCH_MODE, m as OpenAICodexSearchProvider, mt as isValidOpenAICodexContextWindowOverrides, n as OPENAI_CODEX_SETTINGS_NS, nt as OPENAI_CODEX_PROXY_PROBE_URL, o as OPENAI_CODEX_HISTORY_BACKUP_SUFFIX, ot as DEFAULT_OPENAI_CODEX_PROXY_URL, p as OPENAI_CODEX_SEARCH_URL, pt as decodeOpenAICodexSettings, q as assessCompatibility, r as apply, rt as OpenAICodexProxyManager, s as OPENAI_CODEX_SEARCH_MODEL_REQUEST_EVENT, st as DEFAULT_OPENAI_CODEX_SEARCH_CONTEXT_SIZE, t as Config, tt as OPENAI_CODEX_PROXY_PROBE_TIMEOUT_MS, ut as DEFAULT_OPENAI_CODEX_SEARCH_MODEL, v as OPENAI_CODEX_IMAGE_MAX_ERROR_BYTES, vt as resolveOpenAICodexSettings, w as OPENAI_CODEX_TRANSPORT_SERVICE, x as OPENAI_CODEX_IMAGE_REQUEST_TIMEOUT_MS, xt as OPENAI_CODEX_FAST_MODE_MAX_SESSIONS, y as OPENAI_CODEX_IMAGE_MAX_RESPONSE_BYTES, yt as OPENAI_CODEX_FAST_MODE_PATH, z as COMPATIBILITY_CONTRACT } from "./src-Di2xxpDv.js";
 export { COMPATIBILITY_CONTRACT, COMPATIBILITY_PACKAGES, COMPATIBILITY_SCHEMA_VERSION, Config, DEFAULT_OPENAI_CODEX_PROXY_URL, DEFAULT_OPENAI_CODEX_SEARCH_CONTEXT_SIZE, DEFAULT_OPENAI_CODEX_SEARCH_MAX_OUTPUT_TOKENS, DEFAULT_OPENAI_CODEX_SEARCH_MODE, DEFAULT_OPENAI_CODEX_SEARCH_MODEL, DEFAULT_OPENAI_CODEX_SETTINGS, DSH_PLUGIN_API_PACKAGES, FastModeRegistry, FastModeRegistry as OpenAICodexFastModeRegistry, IMAGE_GENERATE_TOOL_NAME, OPENAI_CODEX_AUTH_FILENAME, OPENAI_CODEX_BASE_URL, OPENAI_CODEX_FAST_MODE_MAX_SESSIONS, OPENAI_CODEX_FAST_MODE_MAX_SESSION_ID_LENGTH, OPENAI_CODEX_FAST_MODE_PATH, OPENAI_CODEX_HISTORY_BACKUP_SUFFIX, OPENAI_CODEX_IMAGE_GENERATION_URL, OPENAI_CODEX_IMAGE_MAX_COUNT, OPENAI_CODEX_IMAGE_MAX_ERROR_BYTES, OPENAI_CODEX_IMAGE_MAX_RESPONSE_BYTES, OPENAI_CODEX_IMAGE_PROMPT_MAX_LENGTH, OPENAI_CODEX_IMAGE_REQUEST_TIMEOUT_MS, OPENAI_CODEX_LOCAL_PROXY_CANDIDATES, OPENAI_CODEX_PROVIDER, OPENAI_CODEX_PROXY_CANDIDATE_LIMIT, OPENAI_CODEX_PROXY_DETECT_PATH, OPENAI_CODEX_PROXY_PROBE_TIMEOUT_MS, OPENAI_CODEX_PROXY_PROBE_URL, OPENAI_CODEX_PROXY_TEST_PATH, OPENAI_CODEX_SEARCH_MODEL_REQUEST_EVENT, OPENAI_CODEX_SEARCH_PROVIDER, OPENAI_CODEX_SEARCH_URL, OPENAI_CODEX_SETTINGS_NAMESPACE, OPENAI_CODEX_SETTINGS_NS, OPENAI_CODEX_TRANSPORT_API_VERSION, OPENAI_CODEX_TRANSPORT_ERROR_CODES, OPENAI_CODEX_TRANSPORT_SERVICE, OPENAI_CODEX_UPDATE_PATH, OPENAI_CODEX_USAGE_URL, OpenAICodexCredentialStore, OpenAICodexProxyManager, OpenAICodexSearchProvider, OpenAICodexTransport, OpenAICodexTransportError, PI_AI_PACKAGE, SUPPORTED_DSH_PLUGIN_API_VERSION, SUPPORTED_NODE_RANGE, SUPPORTED_PI_AI_RANGE, VIEW_IMAGE_TOOL_NAME, apply, assertNoOpenAICodexProviderConflict, assessCompatibility, checkForOpenAICodexUpdate, compareOpenAICodexVersions, decodeOpenAICodexSettings, detectCompatibility, detectOpenAICodexProxies, diagnoseOpenAICodex, evaluateCompatibility, inject, isFastModeSessionId, isOpenAICodexTransportError, isValidOpenAICodexContextWindowOverrides, isValidOpenAICodexProxyUrl, listOpenAICodexProxyCandidates, loginOpenAICodex, logoutOpenAICodex, mapOpenAICodexSearchResponse, migrateOpenAICodexSearchHistory, name, openAICodexAuthPath, openAICodexAuthStatus, openAICodexConflictMessage, parseOpenAICodexUpdateResult, parseOpenAICodexUsage, parseOpenAICodexVersion, readOpenAICodexRateLimits, resolveOpenAICodexProxyUrl, resolveOpenAICodexSettings };

package/lib/{src-NE6c_5P4.js → src-Di2xxpDv.js}

@@ -1831,10 +1831,12 @@ const OPENAI_CODEX_RELEASE_API_BASE = "https://api.github.com/repos/franksong270
 const OPENAI_CODEX_RELEASE_PAGE_BASE = "https://github.com/franksong2702/dsh-codex-connect/releases/tag/v";
 const OPENAI_CODEX_UPDATE_HIGHLIGHTS_URL = "https://raw.githubusercontent.com/franksong2702/dsh-codex-connect/main/update-highlights.json";
 const OPENAI_CODEX_VERIFIED_COMPATIBILITY_URL = "https://raw.githubusercontent.com/franksong2702/dsh-codex-connect/main/verified-compatibility.json";
+const OPENAI_CODEX_CANARY_TRACKER_SEARCH_API_URL = "https://api.github.com/search/issues";
 const OPENAI_CODEX_UPDATE_MAX_METADATA_BYTES = 65536;
 const OPENAI_CODEX_UPDATE_MAX_HIGHLIGHTS_BYTES = 65536;
 const OPENAI_CODEX_UPDATE_MAX_COMPATIBILITY_BYTES = 65536;
 const OPENAI_CODEX_UPDATE_MAX_RELEASE_BYTES = 32768;
+const OPENAI_CODEX_UPDATE_MAX_TRACKER_BYTES = 32768;
 const HIGHLIGHT_KINDS = [
 	"trusted-origins",
 	"runtime-compatibility",
@@ -1988,11 +1990,18 @@ function evaluateOpenAICodexDshCompatibility(currentVersion, latestPluginVersion
 		latestPluginVersion,
 		latestDshVersion: catalog.latestDshVersion
 	};
-	return {
-		status: currentDshVersion === catalog.latestDshVersion || catalog.pluginVersions.some((plugin) => plugin.verifiedDshVersions.includes(currentDshVersion)) ? "not-yet-compatible" : "unverified",
+	if (catalog.pluginVersions.some((plugin) => plugin.version === latestPluginVersion && plugin.verifiedDshVersions.includes(catalog.latestDshVersion)) && compareOpenAICodexVersions(currentDshVersion, catalog.latestDshVersion) < 0) return {
+		status: "dsh-update-required",
 		latestPluginVersion,
 		latestDshVersion: catalog.latestDshVersion
 	};
+	const currentDshAtOrBeyondLatest = compareOpenAICodexVersions(currentDshVersion, catalog.latestDshVersion) >= 0;
+	return {
+		status: currentDshAtOrBeyondLatest ? "not-yet-compatible" : "unverified",
+		latestPluginVersion,
+		latestDshVersion: catalog.latestDshVersion,
+		...currentDshAtOrBeyondLatest ? { reportCompatibilityGap: true } : {}
+	};
 }
 function boundedText(value, maxBytes) {
 	if (new TextEncoder().encode(value).byteLength > maxBytes) throw new RangeError("update response is too large");
@@ -2097,12 +2106,49 @@ async function releaseDetails(version, fetchImpl, timeoutMs) {
 	}
 }
 async function dshCompatibilityAdvice(currentVersion, latestPluginVersion, currentDshVersion, fetchImpl, timeoutMs) {
+	let catalog;
 	try {
 		const { response, text } = await fetchBounded(fetchImpl, OPENAI_CODEX_VERIFIED_COMPATIBILITY_URL, OPENAI_CODEX_UPDATE_MAX_COMPATIBILITY_BYTES, timeoutMs, { accept: "application/json" });
-		if (!response.ok) return evaluateOpenAICodexDshCompatibility(currentVersion, latestPluginVersion, currentDshVersion);
-		return evaluateOpenAICodexDshCompatibility(currentVersion, latestPluginVersion, currentDshVersion, parseOpenAICodexVerifiedCompatibility(JSON.parse(text)));
+		if (response.ok) catalog = parseOpenAICodexVerifiedCompatibility(JSON.parse(text));
 	} catch {
-		return evaluateOpenAICodexDshCompatibility(currentVersion, latestPluginVersion, currentDshVersion);
+		catalog = void 0;
+	}
+	const advice = evaluateOpenAICodexDshCompatibility(currentVersion, latestPluginVersion, currentDshVersion, catalog);
+	if (advice.reportCompatibilityGap !== true || currentDshVersion === void 0) return advice;
+	const trackerUrl = await findOpenAICodexCanaryTracker(currentDshVersion, fetchImpl, timeoutMs);
+	return trackerUrl === void 0 ? advice : {
+		...advice,
+		trackerUrl
+	};
+}
+function canaryTrackerSearchUrl(version) {
+	const params = new URLSearchParams({
+		q: `repo:franksong2702/dsh-codex-connect is:issue in:title "compatibility: track DSH ${version}"`,
+		per_page: "5"
+	});
+	return `${OPENAI_CODEX_CANARY_TRACKER_SEARCH_API_URL}?${params.toString()}`;
+}
+function validCanaryTrackerUrl(value) {
+	return typeof value === "string" && /^https:\/\/github\.com\/franksong2702\/dsh-codex-connect\/issues\/[1-9]\d*$/u.test(value);
+}
+async function findOpenAICodexCanaryTracker(version, fetchImpl, timeoutMs) {
+	try {
+		const { response, text } = await fetchBounded(fetchImpl, canaryTrackerSearchUrl(version), OPENAI_CODEX_UPDATE_MAX_TRACKER_BYTES, timeoutMs, { accept: "application/vnd.github+json" });
+		if (!response.ok) return void 0;
+		const value = JSON.parse(text);
+		if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
+		const items = value["items"];
+		if (!Array.isArray(items) || items.length > 5) return void 0;
+		const expectedTitle = `compatibility: track DSH ${version}`;
+		const expectedMarker = `<!-- dsh-canary:${version} -->`;
+		for (const item of items) {
+			if (typeof item !== "object" || item === null || Array.isArray(item)) continue;
+			const issue = item;
+			if (issue["title"] === expectedTitle && typeof issue["body"] === "string" && issue["body"].includes(expectedMarker) && issue["pull_request"] === void 0 && validCanaryTrackerUrl(issue["html_url"])) return issue["html_url"];
+		}
+		return;
+	} catch {
+		return;
 	}
 }
 /** Check npm's public dist-tags and enrich an available update with public release notes. */
@@ -2242,9 +2288,14 @@ function parseOpenAICodexDshCompatibilityAdvice(value, latestPluginVersion) {
 	if (typeof value !== "object" || value === null || Array.isArray(value)) return void 0;
 	const record = value;
 	const status = record["status"];
-	if (status !== "compatible" && status !== "plugin-update-required" && status !== "not-yet-compatible" && status !== "unverified") return void 0;
+	if (status !== "compatible" && status !== "plugin-update-required" && status !== "dsh-update-required" && status !== "not-yet-compatible" && status !== "unverified") return void 0;
 	if (record["latestPluginVersion"] !== latestPluginVersion) return void 0;
 	const latestDshVersion = record["latestDshVersion"];
+	const reportCompatibilityGap = record["reportCompatibilityGap"];
+	const trackerUrl = record["trackerUrl"];
+	if (reportCompatibilityGap !== void 0 && reportCompatibilityGap !== true) return void 0;
+	if (reportCompatibilityGap === true && status !== "not-yet-compatible") return void 0;
+	if (trackerUrl !== void 0 && (reportCompatibilityGap !== true || !validCanaryTrackerUrl(trackerUrl))) return void 0;
 	if (status === "unverified") {
 		if (latestDshVersion === void 0) return {
 			status,
@@ -2261,7 +2312,9 @@ function parseOpenAICodexDshCompatibilityAdvice(value, latestPluginVersion) {
 	return {
 		status,
 		latestPluginVersion,
-		latestDshVersion
+		latestDshVersion,
+		...reportCompatibilityGap === true ? { reportCompatibilityGap: true } : {},
+		...trackerUrl === void 0 ? {} : { trackerUrl }
 	};
 }
 //#endregion
@@ -2510,7 +2563,7 @@ function registerOpenAICodexOriginalImageRoute(ctx, trustedOrigins, assets) {
 }
 //#endregion
 //#region src/version.ts
-const CODEX_CONNECT_VERSION = "0.1.0-alpha.4.24";
+const CODEX_CONNECT_VERSION = "0.1.0-alpha.4.25";
 //#endregion
 //#region src/doctor.ts
 /** Secret-free diagnostics and duplicate-provider guidance. */

package/package.json

@@ -2,7 +2,7 @@
   "name": "dsh-codex-connect",
   "displayName": "Codex Connect",
   "description": "ChatGPT OAuth and Codex models for DeepSeek Harness.",
-  "version": "0.1.0-alpha.4.24",
+  "version": "0.1.0-alpha.4.25",
   "author": "Frank Song",
   "contributors": [
     "Yan-Zero (original dsh-codex author)"
@@ -195,7 +195,7 @@
     "@types/node": "^22.20.0",
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3.1",
-    "@vitest/browser-playwright": "4.1.10",
+    "@vitest/browser-playwright": "4.1.11",
     "jsdom": "29.1.1",
     "playwright": "1.62.1",
     "react": "^18.2.0",