dsh-workbuddy-connect 0.7.8 → 0.7.9

package/README.en.md

@@ -13,7 +13,7 @@ Brings the models available in your signed-in WorkBuddy / WorkBuddy AI desktop a
 ```text
 Please install and verify the DSH (DeepSeek Harness) plugin dsh-workbuddy-connect for me (project: https://github.com/corrinehu/dsh-workbuddy-connect).
 Start by reading the project README and confirming which interface I actually use (Web / Desktop / TUI) and its DSH core version — for the Desktop app, the bundled core, never the standalone CLI's version.
-Then install from the official npm package per the version mapping (0.2.1-rc.2 -> 0.7.8, 0.2.1-rc.1 -> 0.7.7, 0.2.0-rc.2 -> 0.7.6, rc.1 -> 0.7.0, 0.1.5-0.1.7 -> 0.6.5), preferring a locally supported non-market channel; on some Desktop distributions (the official Electron app in particular) the profile is app-managed and rules vary by distribution — check mine first, then explore its compliant install route, but never bypass its validation.
+Then install from the official npm package per the version mapping (0.2.1-rc.2 -> 0.7.9, 0.2.1-rc.1 -> 0.7.7, 0.2.0-rc.2 -> 0.7.6, rc.1 -> 0.7.0, 0.1.5-0.1.7 -> 0.6.5), preferring a locally supported non-market channel; on some Desktop distributions (the official Electron app in particular) the profile is app-managed and rules vary by distribution — check mine first, then explore its compliant install route, but never bypass its validation.
 Ask for my consent and make backups before changing any local files or configuration.
 After installing, verify the WorkBuddy group appears in the model picker and walk me through one short conversation.
 If the Desktop install still fails generation validation (e.g. the @types/retry false positive), report it honestly, reference upstream dataelement/dsh-desktop#688, and suggest switching to the standalone Web / TUI — do not modify dependency packages or bypass the check.
@@ -23,7 +23,7 @@ Core-to-plugin quick reference (full table in "Compatibility and release history
 
 | DSH core | Recommended plugin |
 |---|---|
-| 0.2.1-rc.2 | 0.7.8 (npm latest) |
+| 0.2.1-rc.2 | 0.7.9 (npm latest) |
 | 0.2.1-rc.1 | 0.7.7 |
 | 0.2.0-rc.2 | 0.7.6 |
 | 0.2.0-rc.1 | 0.7.0 |
@@ -33,8 +33,8 @@ Core-to-plugin quick reference (full table in "Compatibility and release history
 <summary>Manual install (command line, Web / TUI only)</summary>
 
 ```sh
-# Web (pin per your actual core — example: 0.2.1-rc.2 -> 0.7.8; or install from source via github:corrinehu/dsh-workbuddy-connect)
-dsh plugin --profile web add dsh-workbuddy-connect@0.7.8
+# Web (pin per your actual core — example: 0.2.1-rc.2 -> 0.7.9; or install from source via github:corrinehu/dsh-workbuddy-connect)
+dsh plugin --profile web add dsh-workbuddy-connect@0.7.9
 dsh web
 
 # TUI (example for a 0.1.x core; that profile needs pnpm 11, e.g. npx pnpm@11)
@@ -84,7 +84,7 @@ The same UI works unchanged inside the DSH 0.1.5 settings cards:
 
 ![Settings card showing the plugin](assets/2.png)
 
-The expanded card has three tabs: Status shows the account, token validity, total credit, catalog source, and reasoning-level detection; Context lists each model's context window, and the international version's "use the upstream's largest declared context window" switch lives here (on by default, so DSH sizes context compression to the largest declared window; turn it off to follow the upstream default instead, and the preference persists across restarts); Details shows per-package credit and model offers. The CN and international versions each get their own card.
+The expanded card has three tabs: Status shows the account, token validity, total credit, catalog source, and reasoning-level detection; Context lists each model's context window, and the international version's "use the upstream's largest declared context window" switch lives here (on by default, so DSH sizes context compression to the largest declared window; turn it off to follow the upstream default instead, and the preference persists across restarts); Details combines credit packages with the same name and shows model offers. The CN and international versions each get their own card.
 
 ![Settings card showing account and remaining credit](assets/3.png)
 
@@ -119,7 +119,7 @@ dsh plugin --profile web exec dsh-workbuddy-connect doctor --provider workbuddy-
 - **International-version environments not yet covered**: on Windows / WSL / Linux no reliable source for the international app's version has been located yet, so the saved value or the built-in default is used. On macOS, real-shim checks covered complete GPT-family replies, tool calls, and continued turns.
 - **Behaviour change with no credentials**: a version whose app was never signed in — and that left no plugin-owned copy — no longer shows a model group. The CN version used to display a built-in fallback list, but every model on it failed when selected.
 - **The enterprise credit path currently covers the CN product only**: the international enterprise billing interface is unverified, so those accounts still read through the personal endpoint pending measurement. The enterprise branch could not be tested locally (the development machine holds a personal account); it was implemented from the official app's interface contract, and reports from enterprise users are welcome.
-- **Settings entries vary with the DSH version**: on 0.1.5 / 0.1.6 the plugin installs its settings sections as before (`authFile` / `authFileAI` stay readable from `settings.yaml` and the TUI `/settings`); on 0.1.7+ / 0.2.0 the settings service no longer offers that interface, so the plugin degrades to a settings-less provider — models, the picker, model visibility, and context windows keep working; only the "use the upstream's declared maximum context window" preference stops being persistable.
+- **Settings entries vary with the DSH version**: older services use `installSection`; newer ones use SettingsForms. On DSH 0.2.1-rc.2, 0.7.9 restores the international edition's maximum-context switch, enabled by default. Turning it off uses the upstream default window, and the preference survives restarts. The switch appears only once this plugin's writable settings entry is ready; while waiting, the maximum window remains the default.
 - Relies on WorkBuddy client interfaces (not a public API); the plugin may need updates as WorkBuddy changes.
 
 ## Compatibility and release history
@@ -128,7 +128,7 @@ The plugin version must match the DSH core — a mismatched combination fails to
 
 | DSH core | Recommended plugin | Notes |
 |---|---|---|
-| `0.2.1-rc.2` | `0.7.8` | Targets this core only; `0.2.0-rc.2` and `0.2.1-rc.2` differ. Check the core bundled in your Desktop app. |
+| `0.2.1-rc.2` | `0.7.9` | Targets this core only; `0.2.0-rc.2` and `0.2.1-rc.2` differ. Check the core bundled in your Desktop app. |
 | `0.2.1-rc.1` | `0.7.7` | The core moved to `@earendil-works/pi-ai` 1.3.0, so the plugin bundles 1.3.0 too — a leftover 0.87.1 overrides entry must be removed (see the pi-ai note below). |
 | `0.2.0-rc.2` | `0.7.6` | Previous core line; fixes enterprise catalog gaps and international chat requests blocked by the upstream channel check. Avoid 0.7.2 with its registry regression. |
 | `0.2.0-rc.1` | `0.7.0` | 0.7.1 drops rc.1 support; stay on this version. |
@@ -138,6 +138,7 @@ The plugin version must match the DSH core — a mismatched combination fails to
 
 Release history (full records at [releases](https://github.com/corrinehu/dsh-workbuddy-connect/releases)):
 
+- **0.7.9**: restores the international edition's maximum-context switch on DSH 0.2.1-rc.2, including delayed initialization and persistent settings (PR [#172](https://github.com/corrinehu/dsh-workbuddy-connect/pull/172), by @1Dreamer666); avoids fetch-blocked local ports that could cause international-edition 502 errors (PR [#164](https://github.com/corrinehu/dsh-workbuddy-connect/pull/164), by @Xiong-Ziyi); combines credit packages with the same name to reduce repeated entries.
 - **0.7.8**: adapts to DSH 0.2.1-rc.2; bundles the official atomic-write helper instead of relying on host module exposure; refreshes the China catalog snapshot and distinguishes Hy3 / Hy3-X; improves probe result labels and fixes the credit-refresh placement and tooltip. Thanks to @chenpiyanghappy for PR [#156](https://github.com/corrinehu/dsh-workbuddy-connect/pull/156).
 - **0.7.7**: adapts to the DSH 0.2.1-rc.1 core: peers narrow to 0.2.1-rc.1 and the plugin-bundled `@earendil-works/pi-ai` moves to 1.3.0 with it (a profile-level leftover 0.87.1 overrides entry must be removed, or the plugin fails to load).
 - **0.7.6**: fixes enterprise accounts missing `glm-5.3-flashx` from the model catalog ([#123](https://github.com/corrinehu/dsh-workbuddy-connect/issues/123)), and fixes international chat requests being blocked by the upstream channel check ([#139](https://github.com/corrinehu/dsh-workbuddy-connect/issues/139) / [#142](https://github.com/corrinehu/dsh-workbuddy-connect/issues/142)).
@@ -149,9 +150,9 @@ Release history (full records at [releases](https://github.com/corrinehu/dsh-wor
 - **0.7.0**: adapts to DSH 0.2.0's settings-service rework and drops 0.1.x support.
 - **0.6.5**: final release of the 0.1.x line.
 
-Pinned-version install example: `dsh plugin --profile web add dsh-workbuddy-connect@0.7.8`.
+Pinned-version install example: `dsh plugin --profile web add dsh-workbuddy-connect@0.7.9`.
 
-**pi-ai versions are per core line and must not be mixed**: the 0.2.1-rc.1 / rc.2 core lines (plugin 0.7.7 / 0.7.8 respectively) moved to `@earendil-works/pi-ai` 1.3.0 (bundled by the plugin), so a profile-level leftover `overrides: {'@earendil-works/pi-ai': '0.87.1'}` **must be removed** or the plugin fails to load; the 0.2.0-rc.2 core line (plugin 0.7.6) still requires `^0.87.1` — on that line, **do not** upgrade the profile-level pi-ai to 1.x, and do not act on third-party plugin managers' "updatable" prompts, which do not check peer constraints ([#86](https://github.com/corrinehu/dsh-workbuddy-connect/issues/86)).
+**pi-ai versions are per core line and must not be mixed**: the 0.2.1-rc.1 / rc.2 core lines (plugin 0.7.7 / 0.7.8–0.7.9 respectively) moved to `@earendil-works/pi-ai` 1.3.0 (bundled by the plugin), so a profile-level leftover `overrides: {'@earendil-works/pi-ai': '0.87.1'}` **must be removed** or the plugin fails to load; the 0.2.0-rc.2 core line (plugin 0.7.6) still requires `^0.87.1` — on that line, **do not** upgrade the profile-level pi-ai to 1.x, and do not act on third-party plugin managers' "updatable" prompts, which do not check peer constraints ([#86](https://github.com/corrinehu/dsh-workbuddy-connect/issues/86)).
 
 ## Disclaimer
 
@@ -162,10 +163,11 @@ Pinned-version install example: `dsh plugin --profile web add dsh-workbuddy-conn
 
 ## Related Projects / Community Ecosystem
 
-- **[HanaAgent](https://github.com/liliMozi/openhanako)**: an independent personal AI Agent project.
+- **[dsh-buddy-checkin](https://github.com/corrinehu/dsh-buddy-checkin)**: a daily check-in plugin for the WorkBuddy China edition, maintained by this project's author.
+- **[dsh-workbuddy-switcher](https://github.com/ddGuo/dsh-workbuddy-switcher)**: a community-maintained WorkBuddy account management and switching plugin.
 - **[hana-workbuddy-connect](https://github.com/miaoyongxu/hana-workbuddy-connect)**: a community-maintained unofficial adapter project that reuses parts of the `dsh-workbuddy-connect` implementation to bring WorkBuddy / WorkBuddy AI models to HanaAgent.
 
-Both projects are maintained independently by third parties. The compatibility, security, and usage support of `hana-workbuddy-connect` are the responsibility of its maintainer. Listing them here is not an official endorsement, nor does it imply any stability or compatibility commitment on this plugin's internal interfaces.
+See each project's documentation for supported versions and installation requirements. Except for `dsh-buddy-checkin`, these projects are independently maintained by third parties. Listing them here is not an official endorsement or a stability or compatibility commitment for this plugin's internal interfaces.
 
 ## Acknowledgements
 

package/README.md

@@ -13,7 +13,7 @@
 ```text
 请帮我安装并验证 DSH（DeepSeek Harness）插件 dsh-workbuddy-connect（项目地址：https://github.com/corrinehu/dsh-workbuddy-connect）：
 先阅读项目 README，确认我实际使用的界面（Web / Desktop / TUI）与 DSH 内核版本，桌面版以 App 内置核心为准，不要用独立 CLI 的版本代替；
-再按版本对应关系从 npm 正式包安装（0.2.1-rc.2→0.7.8、0.2.1-rc.1→0.7.7、0.2.0-rc.2→0.7.6、rc.1→0.7.0、0.1.5–0.1.7→0.6.5），优先走本机受支持的非插件市场渠道；部分 Desktop 发行版（尤其官方 Electron 版）的 profile 由 App 管理，各发行版规则未必相同，先确认我所用的发行版，再探查其合规的安装方式，但不得绕过其校验；
+再按版本对应关系从 npm 正式包安装（0.2.1-rc.2→0.7.9、0.2.1-rc.1→0.7.7、0.2.0-rc.2→0.7.6、rc.1→0.7.0、0.1.5–0.1.7→0.6.5），优先走本机受支持的非插件市场渠道；部分 Desktop 发行版（尤其官方 Electron 版）的 profile 由 App 管理，各发行版规则未必相同，先确认我所用的发行版，再探查其合规的安装方式，但不得绕过其校验；
 任何本地文件或配置改动，先征得我同意并做好备份；
 装完后验证模型选择器里出现 WorkBuddy 分组，并陪我完成一次简短对话；
 若 Desktop 安装仍因 generation 校验失败（如 @types/retry 误报），请如实报告、参照上游 dataelement/dsh-desktop#688，并建议我改用独立的 Web / TUI，不要修改依赖包或绕过校验。
@@ -23,7 +23,7 @@
 
 | DSH 内核 | 推荐插件版 |
 |---|---|
-| 0.2.1-rc.2 | 0.7.8（npm latest） |
+| 0.2.1-rc.2 | 0.7.9（npm latest） |
 | 0.2.1-rc.1 | 0.7.7 |
 | 0.2.0-rc.2 | 0.7.6 |
 | 0.2.0-rc.1 | 0.7.0 |
@@ -33,8 +33,8 @@
 <summary>手动安装（命令行，仅 Web / TUI）</summary>
 
 ```sh
-# Web（按实际内核固定版本，示例为 0.2.1-rc.2 → 0.7.8；也可用 github:corrinehu/dsh-workbuddy-connect 从源码安装）
-dsh plugin --profile web add dsh-workbuddy-connect@0.7.8
+# Web（按实际内核固定版本，示例为 0.2.1-rc.2 → 0.7.9；也可用 github:corrinehu/dsh-workbuddy-connect 从源码安装）
+dsh plugin --profile web add dsh-workbuddy-connect@0.7.9
 dsh web
 
 # TUI（示例为 0.1.x 内核；该 profile 需用 pnpm 11 安装，如 npx pnpm@11）
@@ -84,7 +84,7 @@ dsh --profile dsh-tui
 
 ![设置卡片显示插件](assets/2.png)
 
-卡片展开后分「状态 / 上下文 / 明细」三个标签：状态页展示账号、令牌有效期、合计积分、模型列表来源与推理档位检测；上下文页列出各模型上下文窗口，国际版可在这里关闭「使用上游声明的最大上下文窗口」（默认开启，DSH 按上游最大窗口安排上下文压缩；关闭后改用上游默认窗口，偏好持久化）；明细页展示各套餐余量与模型优惠。国内版与国际版各有一张自己的卡片。
+卡片展开后分「状态 / 上下文 / 明细」三个标签：状态页展示账号、令牌有效期、合计积分、模型列表来源与推理档位检测；上下文页列出各模型上下文窗口，国际版可在这里关闭「使用上游声明的最大上下文窗口」（默认开启，DSH 按上游最大窗口安排上下文压缩；关闭后改用上游默认窗口，偏好持久化）；明细页合并展示同名积分包的余量与模型优惠。国内版与国际版各有一张自己的卡片。
 
 ![设置卡片显示账号与剩余积分](assets/3.png)
 
@@ -120,7 +120,7 @@ dsh plugin --profile web exec dsh-workbuddy-connect doctor --provider workbuddy-
 - **国际版仍未覆盖的环境**：Windows / WSL / Linux 下国际版 App 的版本读取尚未找到可靠来源，会退回最近保存的版本或内置值。macOS 上已通过真实 shim 验证 GPT 系完整回复、工具调用与续轮。
 - **无凭据时的行为变化**：某版 App 从未登录、也没留下插件自留副本时，该版模型分组不再显示。此前国内版会显示一份内置兜底列表，但那些模型选了必然报错。
 - **企业账号积分目前仅覆盖国内版**：国际版企业账号的计费接口尚未验证，仍按个人版接口读取；待有实测结论后再扩展。企业账号分支在本机无法自测（开发机为个人账号），依据官方 App 的接口契约实现，欢迎企业账号用户反馈实测结果。
-- **设置入口随 DSH 版本而异**：0.1.5 / 0.1.6 上插件照常安装 `authFile` / `authFileAI` 等设置分区（`settings.yaml` 与 TUI `/settings` 均可读写）；0.1.7+ / 0.2.0 的设置服务不再提供该接口，插件降级为无设置项的 provider——模型、选择器、模型显隐与上下文窗口照常工作，只是「使用上游声明的最大上下文窗口」这一偏好不再可持久化。
+- **设置入口随 DSH 版本而异**：旧版设置服务使用 `installSection`，新版使用 SettingsForms。0.7.9 在 DSH 0.2.1-rc.2 上恢复国际版「使用上游声明的最大上下文窗口」开关，默认开启；关闭后使用上游默认窗口，设置在重启后保留。只有本插件的可写设置入口就绪后才显示开关，等待期间仍使用默认的最大窗口。
 - 依赖 WorkBuddy 客户端接口（非官方开放 API），WorkBuddy 更新后插件可能需要随之调整。
 
 ## 版本兼容与历史版本
@@ -129,7 +129,7 @@ dsh plugin --profile web exec dsh-workbuddy-connect doctor --provider workbuddy-
 
 | DSH 内核 | 推荐插件版 | 注意事项 |
 |---|---|---|
-| `0.2.1-rc.2` | `0.7.8` | 仅适配这一内核；`0.2.0-rc.2` 与 `0.2.1-rc.2` 不同，请核对 App 内置版本。 |
+| `0.2.1-rc.2` | `0.7.9` | 仅适配这一内核；`0.2.0-rc.2` 与 `0.2.1-rc.2` 不同，请核对 App 内置版本。 |
 | `0.2.1-rc.1` | `0.7.7` | 内核升级到 `@earendil-works/pi-ai` 1.3.0，插件同步自带 1.3.0，历史遗留的 0.87.1 overrides 必须移除（见下方 pi-ai 说明）。 |
 | `0.2.0-rc.2` | `0.7.6` | 上一代内核线；修复企业账号模型目录缺项与国际版对话被渠道校验拦截，勿停留在有注册表回归的 0.7.2。 |
 | `0.2.0-rc.1` | `0.7.0` | 0.7.1 起不再支持 rc.1，请停留本版。 |
@@ -139,6 +139,7 @@ dsh plugin --profile web exec dsh-workbuddy-connect doctor --provider workbuddy-
 
 历次更新（完整记录见 [releases](https://github.com/corrinehu/dsh-workbuddy-connect/releases)）：
 
+- **0.7.9**：恢复 DSH 0.2.1-rc.2 上国际版最大上下文窗口开关，修复延迟初始化及设置持久化（PR [#172](https://github.com/corrinehu/dsh-workbuddy-connect/pull/172)，by @1Dreamer666）；避免本地服务绑定到 fetch 禁用端口导致国际版 502（PR [#164](https://github.com/corrinehu/dsh-workbuddy-connect/pull/164)，by @Xiong-Ziyi）；同名积分包合并展示，减少重复条目。
 - **0.7.8**：适配 DSH 0.2.1-rc.2；将官方原子写入工具打包到插件，避免依赖宿主暴露该模块；更新国内模型目录快照，区分 Hy3 / Hy3-X；优化推理检测结果展示，调整积分刷新按钮位置并修正悬停提示。感谢 @chenpiyanghappy 的 PR [#156](https://github.com/corrinehu/dsh-workbuddy-connect/pull/156)。
 - **0.7.7**：适配 DSH 0.2.1-rc.1 内核：peer 收窄到 0.2.1-rc.1，插件自带的 `@earendil-works/pi-ai` 随内核升级到 1.3.0（profile 级历史遗留的 0.87.1 overrides 必须移除，否则插件无法加载）；修复国际版与国内版推理档位检测停留「检测未完成」——上游把档位拒绝码改拼为 `invalid_parameter_value`（[#143](https://github.com/corrinehu/dsh-workbuddy-connect/issues/143) / [#148](https://github.com/corrinehu/dsh-workbuddy-connect/issues/148)，PR [#145](https://github.com/corrinehu/dsh-workbuddy-connect/pull/145)）；修复中文 Windows 控制台下注册表缺键诊断因 GBK 编码被误判（zh-CN 实机验证）。
 - **0.7.6**：修复企业账号模型目录缺少 `glm-5.3-flashx`（[#123](https://github.com/corrinehu/dsh-workbuddy-connect/issues/123)），修复国际版对话请求被上游渠道校验拦截（[#139](https://github.com/corrinehu/dsh-workbuddy-connect/issues/139) / [#142](https://github.com/corrinehu/dsh-workbuddy-connect/issues/142)）。
@@ -150,9 +151,9 @@ dsh plugin --profile web exec dsh-workbuddy-connect doctor --provider workbuddy-
 - **0.7.0**：适配 DSH 0.2.0 的设置服务改造，不再支持 0.1.x。
 - **0.6.5**：0.1.x 线最终版本。
 
-固定版本安装示例：`dsh plugin --profile web add dsh-workbuddy-connect@0.7.8`。
+固定版本安装示例：`dsh plugin --profile web add dsh-workbuddy-connect@0.7.9`。
 
-**pi-ai 版本按内核线区分，不能混**：0.2.1-rc.1 / rc.2 内核线（分别对应插件 0.7.7 / 0.7.8）已升级到 `@earendil-works/pi-ai` 1.3.0（由插件自带），profile 级历史遗留的 `overrides: {'@earendil-works/pi-ai': '0.87.1'}` **必须移除**，否则插件会因加载到旧一代 pi-ai 而启动失败；0.2.0-rc.2 内核线（插件 0.7.6）仍要求 `^0.87.1`，在这条线上**不要**把 profile 级的 pi-ai 升到 1.x，第三方插件管理器的「可更新」提示不校验 peer 约束、不能照做（[#86](https://github.com/corrinehu/dsh-workbuddy-connect/issues/86)）。
+**pi-ai 版本按内核线区分，不能混**：0.2.1-rc.1 / rc.2 内核线（分别对应插件 0.7.7 / 0.7.8–0.7.9）已升级到 `@earendil-works/pi-ai` 1.3.0（由插件自带），profile 级历史遗留的 `overrides: {'@earendil-works/pi-ai': '0.87.1'}` **必须移除**，否则插件会因加载到旧一代 pi-ai 而启动失败；0.2.0-rc.2 内核线（插件 0.7.6）仍要求 `^0.87.1`，在这条线上**不要**把 profile 级的 pi-ai 升到 1.x，第三方插件管理器的「可更新」提示不校验 peer 约束、不能照做（[#86](https://github.com/corrinehu/dsh-workbuddy-connect/issues/86)）。
 
 ## 免责声明
 
@@ -163,10 +164,11 @@ dsh plugin --profile web exec dsh-workbuddy-connect doctor --provider workbuddy-
 
 ## 相关项目 / 社区生态
 
-- **[HanaAgent](https://github.com/liliMozi/openhanako)**：独立的个人 AI Agent 项目。
+- **[dsh-buddy-checkin](https://github.com/corrinehu/dsh-buddy-checkin)**：本项目作者维护的 WorkBuddy 国内版每日签到插件。
+- **[dsh-workbuddy-switcher](https://github.com/ddGuo/dsh-workbuddy-switcher)**：社区维护的 WorkBuddy 账号管理与切换插件。
 - **[hana-workbuddy-connect](https://github.com/miaoyongxu/hana-workbuddy-connect)**：社区维护的非官方适配项目，复用 `dsh-workbuddy-connect` 的部分实现，为 HanaAgent 接入 WorkBuddy / WorkBuddy AI 模型。
 
-以上项目均由第三方独立维护。其中，`hana-workbuddy-connect` 的兼容性、安全性及使用支持由其维护者负责。收录不代表官方背书，也不意味着本插件对内部接口提供稳定性或兼容性承诺。
+适用版本与安装要求请参阅各项目说明。除 `dsh-buddy-checkin` 外，以上项目均由第三方独立维护；收录不代表官方背书，也不构成本插件内部接口的稳定性或兼容性承诺。
 
 ## 致谢
 

package/lib/bin.js

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { C as WORKBUDDY_VARIANTS, O as WorkBuddyUpstreamClient, Q as resolveAppVersion, S as CN_VARIANT, a as readHostHeartbeat, b as atRestKeyProviderFor, c as WORKBUDDY_CONNECT_VERSION, l as FALLBACK_WORKBUDDY_AI_MODELS, m as WorkBuddyCredentialStore, o as workbuddyHostHeartbeatPath, r as isHeartbeatProcessAlive, u as FALLBACK_WORKBUDDY_MODELS, w as variantFor } from "./host-heartbeat-sjotAEdb.js";
+import { C as WORKBUDDY_VARIANTS, O as WorkBuddyUpstreamClient, Q as resolveAppVersion, S as CN_VARIANT, a as readHostHeartbeat, b as atRestKeyProviderFor, c as WORKBUDDY_CONNECT_VERSION, l as FALLBACK_WORKBUDDY_AI_MODELS, m as WorkBuddyCredentialStore, o as workbuddyHostHeartbeatPath, r as isHeartbeatProcessAlive, u as FALLBACK_WORKBUDDY_MODELS, w as variantFor } from "./host-heartbeat-SJaZ33tR.js";
 import { realpathSync } from "node:fs";
 import { fileURLToPath } from "node:url";
 //#region src/bin.ts

package/lib/client.js

@@ -691,6 +691,25 @@ window.__ModuleLoader__.load({
 				})]
 			});
 		}
+		/** Combine same-name packages for display; expiry data stays per package upstream. */
+		function groupCreditPackages(accounts) {
+			const groups = /* @__PURE__ */ new Map();
+			for (const account of accounts) {
+				const group = groups.get(account.packageName);
+				if (group === void 0) groups.set(account.packageName, {
+					packageName: account.packageName,
+					remain: account.remain,
+					size: account.size,
+					...account.unlimited === true ? { unlimited: true } : {}
+				});
+				else {
+					group.remain += account.remain;
+					group.size = group.size > 0 && account.size > 0 ? group.size + account.size : 0;
+					if (account.unlimited === true) group.unlimited = true;
+				}
+			}
+			return [...groups.values()];
+		}
 		/**
 		* One billing package as a labeled progress bar.
 		*
@@ -1489,13 +1508,13 @@ window.__ModuleLoader__.load({
 									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
 										style: quotaTitleStyle,
 										children: t("creditsDetailHeading")
-									}), status.credits.accounts.filter((account) => account.packageName === "enterprise" || account.remain > 0 || account.unlimited === true).map((account, index) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CreditBar, {
+									}), groupCreditPackages(status.credits.accounts).filter((account) => account.packageName === "enterprise" || account.remain > 0 || account.unlimited === true).map((account) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CreditBar, {
 										label: account.packageName === "enterprise" ? t("packageEnterprise") : account.packageName,
 										remain: account.remain,
 										size: account.size,
 										unlimited: account.unlimited,
 										t
-									}, `${account.packageName}-${String(index)}`))]
+									}, account.packageName))]
 								}), status.models === void 0 || status.models.length === 0 ? null : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 									style: quotaListStyle,
 									children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
@@ -2828,7 +2847,7 @@ window.__ModuleLoader__.load({
 		};
 		//#endregion
 		//#region src/version.ts
-		const WORKBUDDY_CONNECT_VERSION = "0.7.8";
+		const WORKBUDDY_CONNECT_VERSION = "0.7.9";
 		//#endregion
 		//#region src/client/WorkBuddyConfigPage.tsx
 		/**

package/lib/{host-heartbeat-sjotAEdb.js → host-heartbeat-SJaZ33tR.js}

@@ -4542,7 +4542,7 @@ var WorkBuddyCatalog = class {
 };
 //#endregion
 //#region src/version.ts
-const WORKBUDDY_CONNECT_VERSION = "0.7.8";
+const WORKBUDDY_CONNECT_VERSION = "0.7.9";
 //#endregion
 //#region src/host-heartbeat.ts
 /**

package/lib/index.js

@@ -1,4 +1,4 @@
-import { $ as validAppVersion, A as extractDisplayErrorMessage, B as randomSentinel, C as WORKBUDDY_VARIANTS, D as WORKBUDDY_UPDATE_PATH, F as prepareCnChatBody, G as readCliVersion, H as FALLBACK_CN_APP_VERSION, I as prepareInternationalChatBody, J as WORKBUDDY_APP_VERSION_FILENAME, K as resolveChatIdentity, L as regionOf, M as normalizeCredits, N as parseModelCatalog, O as WorkBuddyUpstreamClient, P as prepareChatBody, Q as resolveAppVersion, R as PROBE_EFFORT_CANDIDATES, S as CN_VARIANT, U as chatUserAgent, V as CN_APP_VERSION_FILENAME, W as fallbackChatIdentity, X as installedAppVersion, Y as appUserAgent, Z as readBundleVersion, _ as desktopAuthCandidatesFor, a as readHostHeartbeat, b as atRestKeyProviderFor, c as WORKBUDDY_CONNECT_VERSION, d as WorkBuddyCatalog, f as WORKBUDDY_AUTH_FILENAME, g as defaultDesktopAuthPath, h as defaultDesktopAuthCandidates, i as processStartTimeMs, j as modelWithCurrentPromotion, k as classifyUpstreamError, l as FALLBACK_WORKBUDDY_AI_MODELS, m as WorkBuddyCredentialStore, n as clearHostHeartbeat, o as workbuddyHostHeartbeatPath, p as WORKBUDDY_AUTH_FILE_ENV, q as validCliVersion, r as isHeartbeatProcessAlive, s as writeHostHeartbeat, t as WORKBUDDY_HOST_HEARTBEAT_FILENAME, u as FALLBACK_WORKBUDDY_MODELS, v as parseWorkBuddyAuth, w as variantFor, x as AI_VARIANT, y as workbuddyOwnAuthPath, z as probeModel } from "./host-heartbeat-sjotAEdb.js";
+import { $ as validAppVersion, A as extractDisplayErrorMessage, B as randomSentinel, C as WORKBUDDY_VARIANTS, D as WORKBUDDY_UPDATE_PATH, F as prepareCnChatBody, G as readCliVersion, H as FALLBACK_CN_APP_VERSION, I as prepareInternationalChatBody, J as WORKBUDDY_APP_VERSION_FILENAME, K as resolveChatIdentity, L as regionOf, M as normalizeCredits, N as parseModelCatalog, O as WorkBuddyUpstreamClient, P as prepareChatBody, Q as resolveAppVersion, R as PROBE_EFFORT_CANDIDATES, S as CN_VARIANT, U as chatUserAgent, V as CN_APP_VERSION_FILENAME, W as fallbackChatIdentity, X as installedAppVersion, Y as appUserAgent, Z as readBundleVersion, _ as desktopAuthCandidatesFor, a as readHostHeartbeat, b as atRestKeyProviderFor, c as WORKBUDDY_CONNECT_VERSION, d as WorkBuddyCatalog, f as WORKBUDDY_AUTH_FILENAME, g as defaultDesktopAuthPath, h as defaultDesktopAuthCandidates, i as processStartTimeMs, j as modelWithCurrentPromotion, k as classifyUpstreamError, l as FALLBACK_WORKBUDDY_AI_MODELS, m as WorkBuddyCredentialStore, n as clearHostHeartbeat, o as workbuddyHostHeartbeatPath, p as WORKBUDDY_AUTH_FILE_ENV, q as validCliVersion, r as isHeartbeatProcessAlive, s as writeHostHeartbeat, t as WORKBUDDY_HOST_HEARTBEAT_FILENAME, u as FALLBACK_WORKBUDDY_MODELS, v as parseWorkBuddyAuth, w as variantFor, x as AI_VARIANT, y as workbuddyOwnAuthPath, z as probeModel } from "./host-heartbeat-SJaZ33tR.js";
 import z from "@deepseek-ai/schemastery";
 import { resolveImageAttachmentAccess, resolveRetryPolicy } from "@deepseek-ai/dsh-llm";
 import { dirname, join, resolve } from "node:path";
@@ -577,13 +577,6 @@ var WorkBuddyPiAiAdapter = class extends PiAiAdapter {
 };
 //#endregion
 //#region src/loopback.ts
-/**
-* Shared loopback gates for the plugin's local HTTP surfaces: the loopback
-* shim and the same-origin web-status route. Both are only ever meant to be
-* addressed through the machine's loopback interface.
-*
-* @module dsh-workbuddy-connect/loopback
-*/
 /** Loopback hostnames a local plugin surface may be addressed by. */
 const LOOPBACK_HOSTS = /* @__PURE__ */ new Set([
 	"127.0.0.1",
@@ -623,6 +616,163 @@ function originIsLoopback(origin) {
 		return false;
 	}
 }
+/**
+* Ports fetch refuses to connect to, per the fetch standard's port blocking
+* table (https://fetch.spec.whatwg.org/#port-blocking). Kept in sync with the
+* `badPorts` table undici ships: only the entries a host's ephemeral range can
+* actually reach matter, but carrying the whole list costs nothing and keeps
+* the check honest on machines with a customised range.
+*/
+const FETCH_BLOCKED_PORTS = /* @__PURE__ */ new Set([
+	1,
+	7,
+	9,
+	11,
+	13,
+	15,
+	17,
+	19,
+	20,
+	21,
+	22,
+	23,
+	25,
+	37,
+	42,
+	43,
+	53,
+	69,
+	77,
+	79,
+	87,
+	95,
+	101,
+	102,
+	103,
+	104,
+	109,
+	110,
+	111,
+	113,
+	115,
+	117,
+	119,
+	123,
+	135,
+	137,
+	139,
+	143,
+	161,
+	179,
+	389,
+	427,
+	465,
+	512,
+	513,
+	514,
+	515,
+	526,
+	530,
+	531,
+	532,
+	540,
+	548,
+	554,
+	556,
+	563,
+	587,
+	601,
+	636,
+	989,
+	990,
+	993,
+	995,
+	1719,
+	1720,
+	1723,
+	2049,
+	3659,
+	4045,
+	4190,
+	5060,
+	5061,
+	6e3,
+	6566,
+	6665,
+	6666,
+	6667,
+	6668,
+	6669,
+	6679,
+	6697,
+	10080
+]);
+/** Whether fetch (and therefore pi-ai) refuses to connect to `port`. */
+function isFetchBlockedPort(port) {
+	return FETCH_BLOCKED_PORTS.has(port);
+}
+/** Bind attempts allowed before giving up, including the first. */
+const DEFAULT_MAX_ATTEMPTS = 16;
+/**
+* Bind `server` to an ephemeral port fetch will actually connect to, and
+* resolve with the address it ended up on.
+*
+* `listen(0)` lets the OS hand out any free ephemeral port, and a handful of
+* the ports it can hand out are on the fetch standard's bad-port list: fetch
+* refuses to connect to them and fails with `TypeError: fetch failed` before a
+* socket is opened. The shim is only ever reached through fetch (pi-ai calls
+* it), so settling on one of those ports leaves the plugin with an endpoint
+* that answers raw HTTP and rejects every real request. The port is not
+* negotiable at request time, so the only fix is to bind again.
+*
+* A blocked port is closed and rebound; a listen error is fatal, as it was
+* before, because nothing about picking another port would fix it.
+*/
+async function bindToUsablePort(server, options) {
+	const maxAttempts = Math.max(1, options.maxAttempts ?? DEFAULT_MAX_ATTEMPTS);
+	const isPortBlocked = options.isPortBlocked ?? isFetchBlockedPort;
+	let lastBlockedPort = 0;
+	for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+		const address = await listenOnEphemeralPort(server, options.host);
+		if (!isPortBlocked(address.port)) return address;
+		lastBlockedPort = address.port;
+		options.onBlockedPort?.(address.port, attempt);
+		await closeQuietly(server);
+	}
+	throw new Error(`could not bind a fetch-reachable loopback port after ${maxAttempts} attempts (last blocked port: ${lastBlockedPort})`);
+}
+/** One `listen(0)` on `host`, resolving with the address the OS handed out. */
+function listenOnEphemeralPort(server, host) {
+	return new Promise((resolve, reject) => {
+		const cleanup = () => {
+			server.off("listening", onListening);
+			server.off("error", onError);
+		};
+		const onListening = () => {
+			cleanup();
+			const address = server.address();
+			if (address === null || typeof address === "string") {
+				reject(/* @__PURE__ */ new Error("workbuddy shim has no listening address"));
+				return;
+			}
+			resolve(address);
+		};
+		const onError = (error) => {
+			cleanup();
+			reject(error);
+		};
+		server.once("listening", onListening);
+		server.once("error", onError);
+		server.listen(0, host);
+	});
+}
+/** Close between attempts; a listener that already closed is not an error here. */
+function closeQuietly(server) {
+	return new Promise((resolve) => {
+		server.closeAllConnections();
+		server.close(() => resolve());
+	});
+}
 //#endregion
 //#region src/shim.ts
 /**
@@ -713,11 +863,12 @@ function createWorkBuddyShim(options) {
 	const server = createServer((req, res) => {
 		handle(req, res);
 	});
-	const ready = new Promise((resolve, reject) => {
-		server.once("listening", () => resolve());
-		server.once("error", reject);
-	});
-	server.listen(0, "127.0.0.1");
+	const ready = bindToUsablePort(server, {
+		host: "127.0.0.1",
+		onBlockedPort: (port, attempt) => {
+			logger?.warn(`dsh-workbuddy-connect: port ${port} is blocked for fetch; rebinding (attempt ${attempt})`);
+		}
+	}).then(() => void 0);
 	const baseUrl = () => {
 		const address = server.address();
 		if (address === null || typeof address === "string") throw new Error("workbuddy shim has no listening address");
@@ -1862,6 +2013,38 @@ function legacySettingsOf(settings) {
 	if (typeof candidate.update !== "function") return void 0;
 	return settings;
 }
+/**
+* Narrow one host settings service to the modern DSH 0.2.x SettingsForms API, or
+* `undefined` when this host's generation does not carry it.
+*/
+function modernSettingsOf(settings) {
+	if (typeof settings !== "object" || settings === null) return void 0;
+	const candidate = settings;
+	if (typeof candidate.installSection === "function") return void 0;
+	if (typeof candidate.describe !== "function") return void 0;
+	if (typeof candidate.update !== "function") return void 0;
+	return settings;
+}
+/**
+* Resolve this plugin's own profile entry id from SettingsForms descriptors.
+*
+* The real `describe()` (dsh-settings 0.2.1-rc.2, `SettingsForms.describe`)
+* hands out *serialized* form schemas (`volatileForm(schema).toJSON()`) and
+* no fiber reference, so neither a `desc.schema === Config` identity check
+* nor a fiber comparison can ever succeed — identity has to come from the
+* entry id the loader attached to this plugin's own fiber
+* (`ctx.fiber.entry.options.id`; the tree-qualified `entry.id` includes
+* parent prefixes that SettingsForms does not use). The package-name literal is the only fallback, for hosts where the
+* plugin was loaded programmatically and carries no entry: entry ids are
+* unique per composition, so the literal can only name this plugin. Neither
+* route matching an entry that is served answers `undefined` — never a
+* guess, because a wrong guess silently writes another plugin's
+* configuration.
+*/
+function resolveModernSettingsEntryId(descriptors, ownEntryId) {
+	if (ownEntryId !== void 0) return descriptors.find((row) => row.ns === ownEntryId)?.ns;
+	return descriptors.find((row) => row.ns === "dsh-workbuddy-connect")?.ns;
+}
 //#endregion
 //#region src/index.ts
 /** Stable Cordis plugin name. */
@@ -1940,7 +2123,7 @@ const AUTH_FILE_FIELD = z.string().description("WorkBuddy desktop auth file (def
 const AUTH_FILE_AI_FIELD = z.string().description("WorkBuddy AI desktop auth file (defaults to the app's own location)");
 /** Probe authorization (shared by the plugin schema and the CN section). */
 const PROBE_CONSENT_FIELD = z.boolean().default(false).description("Authorize reasoning-effort probes (each probe sends real requests that may consume credit)");
-const MAXIMUM_CONTEXT_WINDOW_FIELD = z.boolean().default(true).description("Use the largest context window declared by WorkBuddy AI when alternatives are available (on by default)");
+const MAXIMUM_CONTEXT_WINDOW_FIELD = z.boolean().default(true).volatile().description("Use the largest context window declared by WorkBuddy AI when alternatives are available (on by default)");
 const Config = z.object({
 	authFile: AUTH_FILE_FIELD,
 	authFileAI: AUTH_FILE_AI_FIELD,
@@ -1948,6 +2131,17 @@ const Config = z.object({
 	useMaximumContextWindow: MAXIMUM_CONTEXT_WINDOW_FIELD
 });
 /**
+* Read the context-window preference off a resolved Config. Fields marked
+* `.volatile()` materialize as cosmokit volatile containers (`{ get() }`) so
+* the host can live-update them without remounting the plugin; plain hosts
+* and values set through this plugin are plain booleans. Both spellings
+* answer here.
+*/
+function plainConfigBoolean(value) {
+	if (value !== null && typeof value === "object" && typeof value.get === "function") return plainConfigBoolean(value.get());
+	return value === void 0 ? void 0 : value === true;
+}
+/**
 * The CN side's settings section: only the fields that side edits.
 *
 * The section's namespace is what serves these fields to `settings.yaml` and
@@ -2009,7 +2203,7 @@ function createVariantRuntime(config, variant, current, identityOf, accountOf, k
 	});
 	const fallback = fallbackFor(variant);
 	const catalog = new WorkBuddyCatalog(fallback);
-	if (variant.id !== CN_VARIANT.id) catalog.setUseMaximumContextWindow(config.useMaximumContextWindow === true);
+	if (variant.id !== CN_VARIANT.id) catalog.setUseMaximumContextWindow(plainConfigBoolean(config.useMaximumContextWindow) === true);
 	catalog.setVisible(false);
 	const probeStore = new WorkBuddyProbeStore({
 		pluginVersion: WORKBUDDY_CONNECT_VERSION,
@@ -2196,6 +2390,8 @@ function apply(ctx, config) {
 	* checkbox that could not be saved.
 	*/
 	let legacySettingsAvailable = false;
+	/** Whether modern DSH 0.2.x SettingsForms service is available to persist settings. */
+	let settingsAvailable = false;
 	/**
 	* Point a variant at an account identity, invalidating whatever the previous
 	* one left behind.
@@ -2275,7 +2471,7 @@ function apply(ctx, config) {
 						disabled: runtime.visibilityStore.disabled(account)
 					};
 				},
-				...runtime.variant.id === CN_VARIANT.id ? {} : { useMaximumContextWindow: () => legacySettingsAvailable ? current().useMaximumContextWindow === true : void 0 }
+				...runtime.variant.id === CN_VARIANT.id ? {} : { useMaximumContextWindow: () => legacySettingsAvailable || settingsAvailable ? plainConfigBoolean(current().useMaximumContextWindow) === true : void 0 }
 			});
 			registerWorkBuddyProbeRoute(webCtx, {
 				path: runtime.variant.probePath,
@@ -2350,50 +2546,191 @@ function apply(ctx, config) {
 	});
 	ctx.inject(["settings"], (settingsCtx) => {
 		const legacy = legacySettingsOf(settingsCtx.settings);
-		if (legacy === void 0) {
-			ctx.logger.warn("dsh-workbuddy-connect: host settings service has no installSection API; per-variant settings and the maximum-context preference are unavailable");
+		if (legacy !== void 0) {
+			legacySettingsAvailable = true;
+			/** Section sources; each falls back to its own slice when its side unloads. */
+			const sources = {
+				cn: () => config,
+				ai: () => config
+			};
+			/** Merge both sections into the whole config the rest of the plugin reads. */
+			const merged = () => {
+				const aiMaximum = plainConfigBoolean(sources.ai().useMaximumContextWindow);
+				return {
+					...sources.cn().authFile === void 0 ? {} : { authFile: sources.cn().authFile },
+					...sources.cn().probeConsent === void 0 ? {} : { probeConsent: sources.cn().probeConsent },
+					...sources.ai().authFileAI === void 0 ? {} : { authFileAI: sources.ai().authFileAI },
+					...aiMaximum === void 0 ? {} : { useMaximumContextWindow: aiMaximum }
+				};
+			};
+			const applyMaximumContextWindow = (next) => {
+				const runtime = runtimes.find((candidate) => candidate.variant.id !== CN_VARIANT.id);
+				if (runtime?.catalog.setUseMaximumContextWindow(next.useMaximumContextWindow === true)) runtime.invalidate();
+			};
+			const repointStores = () => {
+				const next = merged();
+				applyMaximumContextWindow(next);
+				for (const runtime of runtimes) runtime.store.setDesktopPath(configuredAuthFile(next, runtime.variant));
+			};
+			legacy.installSection(ctx, WORKBUDDY_SETTINGS_NS, CN_SECTION, config, {
+				setSource(source) {
+					sources.cn = source;
+					current = merged;
+				},
+				onChange: repointStores
+			});
+			legacy.installSection(ctx, WORKBUDDY_AI_SETTINGS_NS, AI_SECTION, config, {
+				setSource(source) {
+					sources.ai = source;
+					current = merged;
+				},
+				onChange: repointStores
+			});
+			setMaximumContextWindow = async (enabled) => {
+				await legacy.update(WORKBUDDY_AI_SETTINGS_NS, { useMaximumContextWindow: enabled });
+				return { state: "updated" };
+			};
 			return;
 		}
-		legacySettingsAvailable = true;
-		/** Section sources; each falls back to its own slice when its side unloads. */
-		const sources = {
-			cn: () => config,
-			ai: () => config
-		};
-		/** Merge both sections into the whole config the rest of the plugin reads. */
-		const merged = () => ({
-			...sources.cn().authFile === void 0 ? {} : { authFile: sources.cn().authFile },
-			...sources.cn().probeConsent === void 0 ? {} : { probeConsent: sources.cn().probeConsent },
-			...sources.ai().authFileAI === void 0 ? {} : { authFileAI: sources.ai().authFileAI },
-			...sources.ai().useMaximumContextWindow === void 0 ? {} : { useMaximumContextWindow: sources.ai().useMaximumContextWindow }
-		});
-		const applyMaximumContextWindow = (next) => {
-			const runtime = runtimes.find((candidate) => candidate.variant.id !== CN_VARIANT.id);
-			if (runtime?.catalog.setUseMaximumContextWindow(next.useMaximumContextWindow === true)) runtime.invalidate();
-		};
-		const repointStores = () => {
-			const next = merged();
-			applyMaximumContextWindow(next);
-			for (const runtime of runtimes) runtime.store.setDesktopPath(configuredAuthFile(next, runtime.variant));
-		};
-		legacy.installSection(ctx, WORKBUDDY_SETTINGS_NS, CN_SECTION, config, {
-			setSource(source) {
-				sources.cn = source;
-				current = merged;
-			},
-			onChange: repointStores
-		});
-		legacy.installSection(ctx, WORKBUDDY_AI_SETTINGS_NS, AI_SECTION, config, {
-			setSource(source) {
-				sources.ai = source;
-				current = merged;
-			},
-			onChange: repointStores
-		});
-		setMaximumContextWindow = async (enabled) => {
-			await legacy.update(WORKBUDDY_AI_SETTINGS_NS, { useMaximumContextWindow: enabled });
-			return { state: "updated" };
-		};
+		const modern = modernSettingsOf(settingsCtx.settings);
+		if (modern !== void 0) {
+			/**
+			* The live preference as the host's own Config reports it.
+			*
+			* The forms layer is the single source of truth on a 0.2.x host: a write
+			* lands in the profile document and comes back through `describe()`, so
+			* nothing has to be mirrored in memory here (and a mirror is exactly how
+			* runtime and saved state drift apart). The persisted default already
+			* applies — the preference field defaults to `true` and the composition
+			* handed this plugin its resolved `config`.
+			*/
+			let liveConfig = {
+				...config,
+				useMaximumContextWindow: plainConfigBoolean(config.useMaximumContextWindow) ?? true
+			};
+			/** Whether {@link liveConfig} came from a settings descriptor (see below). */
+			let liveConfigBound = false;
+			/**
+			* Read this plugin's own entry out of the host's forms.
+			*
+			* The namespace on a 0.2.x host is the *profile entry id* — not the
+			* `SettingsNamespace` the 0.1.x sections were installed under — so it is
+			* whatever the user named this plugin in the profile composition.
+			*
+			* Identity cannot come from the descriptors themselves: `describe()`
+			* hands out *serialized* forms (`volatileForm(schema).toJSON()`), never
+			* the live Config object, and its rows carry no fiber — so
+			* `desc.schema === Config` and fiber comparisons are always false
+			* against the real service. The loader instead keys entries by id and
+			* attaches them to the fibers it runs (`ctx.fiber.entry.options.id`, unlike the tree-qualified `entry.id`), which is
+			* what {@link resolveModernSettingsEntryId} reads; the package-name
+			* literal stays as the only fallback (entry ids are unique per
+			* composition, so it can only name this plugin). Anything unmatched
+			* answers `undefined` — a wrong guess would silently write another
+			* plugin's configuration.
+			*/
+			const settingsEntryId = () => {
+				try {
+					const entry = ctx.fiber?.entry;
+					return resolveModernSettingsEntryId(modern.describe(), entry?.options?.id ?? entry?.id);
+				} catch (error) {
+					ctx.logger.warn("dsh-workbuddy-connect: reading this plugin's settings entry failed: %s", error);
+					return;
+				}
+			};
+			/**
+			* Apply whatever the settings document now says.
+			*
+			* The value read is the descriptor's `value` — the projection of the live
+			* fiber config, i.e. what the loader actually resolved — rather than
+			* `user`, which names only the profile's own section and would miss an
+			* inherited or default value that is nonetheless in effect.
+			*/
+			const applyModernConfig = () => {
+				if (!liveConfigBound) return;
+				const runtime = runtimes.find((candidate) => candidate.variant.id !== CN_VARIANT.id);
+				if (runtime?.catalog.setUseMaximumContextWindow(plainConfigBoolean(liveConfig.useMaximumContextWindow) === true)) runtime.invalidate();
+			};
+			setMaximumContextWindow = async (enabled) => {
+				const ns = settingsEntryId();
+				if (ns === void 0) return {
+					state: "failed",
+					reason: "no configurable settings entry for this plugin"
+				};
+				try {
+					await modern.update(ns, { useMaximumContextWindow: enabled });
+					if ((modern.describe().find((entry) => entry.ns === ns)?.value)?.useMaximumContextWindow !== enabled) return {
+						state: "failed",
+						reason: "the settings document did not accept the context-window preference"
+					};
+				} catch (error) {
+					return {
+						state: "failed",
+						reason: error instanceof Error ? error.message.slice(0, 300) : String(error)
+					};
+				}
+				liveConfig = {
+					...liveConfig,
+					useMaximumContextWindow: enabled
+				};
+				current = () => liveConfig;
+				applyModernConfig();
+				return { state: "updated" };
+			};
+			let retry;
+			let retryIndex = 0;
+			let bindingStopped = false;
+			const retryDelays = [
+				250,
+				500,
+				1e3,
+				2e3,
+				4e3,
+				8e3
+			];
+			const clearRetry = () => {
+				clearTimeout(retry);
+				retry = void 0;
+			};
+			const bindModernConfig = () => {
+				if (bindingStopped) return;
+				try {
+					const ns = settingsEntryId();
+					const entry = ns === void 0 ? void 0 : modern.describe().find((desc) => desc.ns === ns);
+					settingsAvailable = (entry?.schema === void 0 ? void 0 : new z(entry.schema))?.dict?.useMaximumContextWindow?.type === "boolean";
+					if (settingsAvailable) {
+						const stored = (entry?.value)?.useMaximumContextWindow;
+						liveConfig = {
+							...liveConfig,
+							useMaximumContextWindow: plainConfigBoolean(stored) ?? plainConfigBoolean(liveConfig.useMaximumContextWindow) ?? true
+						};
+						liveConfigBound = true;
+						current = () => liveConfig;
+						applyModernConfig();
+						clearRetry();
+						return;
+					}
+				} catch (error) {
+					settingsAvailable = false;
+					ctx.logger.warn("dsh-workbuddy-connect: reading the stored context-window preference failed: %s", error);
+				}
+				if (retry === void 0 && retryIndex < retryDelays.length) retry = setTimeout(() => {
+					retry = void 0;
+					bindModernConfig();
+				}, retryDelays[retryIndex++]);
+			};
+			settingsCtx.effect(() => () => {
+				bindingStopped = true;
+				clearRetry();
+				settingsAvailable = false;
+			});
+			settingsCtx.effect(() => ctx.on("settings/document-updated", () => {
+				bindModernConfig();
+			}));
+			bindModernConfig();
+			return;
+		}
+		ctx.logger.warn("dsh-workbuddy-connect: host settings service has no installSection or SettingsForms API; per-variant settings and the maximum-context preference are unavailable");
 	});
 	ctx.effect(() => () => {
 		stopped = true;

package/package.json

@@ -2,7 +2,7 @@
   "name": "dsh-workbuddy-connect",
   "displayName": "DSH WorkBuddy Connect",
   "description": "将 WorkBuddy 桌面 App 包含的模型自动接入 DeepSeek Harness — bring WorkBuddy desktop app models into DeepSeek Harness with zero configuration.",
-  "version": "0.7.8",
+  "version": "0.7.9",
   "author": "corrinehu",
   "keywords": [
     "dsh-plugin",