dsh-auto-open-web 0.1.20 → 0.1.27

package/README.en.md

@@ -1,8 +1,9 @@
 # dsh-auto-open-web
 
 A persistent plugin for the `dsh web` profile that automatically opens the DSH Web GUI in an app-style
-window (or browser tab) on profile start, with a configuration card under Settings → Plugin
-configuration (manually maintained browser path, etc.).
+window (or browser tab) on profile start, with a configuration form (manually maintained
+browser path, etc.). On dsh ≥ 0.1.5 that entry point is the bundle's detail page on the
+**Plugins page**; on rc.7–0.1.4 it is the **Settings → Plugin configuration** card.
 
 ## Behavior
 
@@ -83,14 +84,33 @@ cleanup.
 
 Two equivalent ways:
 
-1. **Settings card** (recommended): Settings → Plugin configuration → the "自动打开网页"
-   (auto-open web) card. Editable fields:
+1. **Settings form** (recommended) — two supported version lines; the plugin registers for
+   both and whichever exists wins:
+   - **Newest version (dsh ≥ 0.1.6-alpha, incl. 0.1.7-alpha.1)**: **Plugins page →
+     `dsh-auto-open-web` → this plugin's row → Configure**. The form opens per **row**
+     (slot `plugins.row.config`, key `<package name>#<row id>` =
+     `dsh-auto-open-web#auto-open-web`); the page supplies the data
+     (`form = { state, mutate }` — the host-projected row Config snapshot plus atomic
+     writes) and the plugin only draws the controls. Only **Save** is offered — leaving
+     the page drops staged edits.
+   - **Latest rc line (0.1.5-rc.x)**: Settings → Plugin configuration → the "自动打开网页"
+     collapsible card (slot `settings.plugin.item`, keyed by settings namespace). Data goes
+     through the host's `settings.register` plus the client `settingsScope`.
+
+   The two lines' client services **do not coexist** (new `configForms` ↔ rc-line
+   `settingsScope`), so the plugin reads both **lazily** and declares only the shared
+   services in `inject` (`slots`/`locale`/`connection`/`remote`) — a hard inject would leave
+   the plugin pending forever on the other line and the settings UI would never appear.
+   Earlier versions (0.1.0-rc.*, 0.1.1-rc.*, 0.1.2-*, 0.1.3-alpha, 0.1.5-alpha,
+   0.1.6-alpha.1) are **no longer guaranteed**.
+
+   Both entry points edit
    `appWindow` (independent app window), `windowKind` (WebView2 host / browser app window),
    `browserPath` (browser executable, with a native "Browse" file dialog; located below the
    window-type field and enabled only when "Browser app window" is selected),
    `exitOnWindowClose` (exit DSH when the window closes, off by default).
-   After saving, values persist through the **official settings domain** (client `settingsScope`)
-   to the settings document (namespace `auto-open-web`); once saved,
+   After saving, values take precedence over row configuration (on the newest version they land
+   in that row's user layer; on the rc line in the `auto-open-web` settings namespace); once saved,
    settings take precedence over row configuration. The host keeps only the "Browse" / "Test"
    helper routes (capabilities the official channel cannot cover).
 2. **Row configuration** (`cordis.patch.yml`): acts as the startup seed, effective until the
@@ -166,8 +186,12 @@ dsh plugin --profile web remove dsh-auto-open-web   # removes the dependency and
 After installation: pnpm adds the package to `profiles/web/node_modules`, and `dsh` appends
 `dsh-auto-open-web` to `dsh.profile.bundles`; at startup the bundle's `cordis.patch.yml` inserts the
 plugin row (`name: auto-open-web`, resolved by package name). After restarting `dsh web`, the
-"自动打开网页" card appears in the settings page (the client bundle is scanned into the browser
-manifest at startup via the modules line, per the `dsh.client` declaration).
+configuration form shows up at the matching entry point (dsh ≥ 0.1.5: the `dsh-auto-open-web`
+bundle's detail page on the Plugins page; earlier versions: the Settings → Plugin configuration
+card). The client bundle is scanned into the browser manifest at startup via the modules line,
+per the `dsh.client` declaration; on the client the plugin registers into **both**
+`plugins.bundle.config` (new) and `settings.plugin.item` (old), and the slot machinery decides
+which one takes effect (a slot that does not exist stays pending — no error, no interference).
 
 The effective configuration is composed layer by layer in this order (later layers win per row,
 replacing the whole row's config rather than deep-merging): each bundle's patch (in bundles list
@@ -179,10 +203,14 @@ without touching the package.
 
 - **Zero dependencies**: every runtime dependency is provided by the **DSH deployment** and
   declared as an optional peer (no install warnings):
-  - `@deepseek-ai/dsh` (the host; declares the compatibility range `>=0.1.0-rc.8 <0.2.0` —
-    rc.8 removed `dsh-client-schema-form` from the client frozen table and introduced
-    `dsh-client-runtime`; the plugin's settings card and opening behavior depend on that
-    release; no runtime version check is performed)
+  - `@deepseek-ai/dsh` (the host; declares the compatibility range **`>=0.1.5-rc.1 <0.2.0`** —
+    covering the **latest rc line (0.1.5-rc.x)** and the **newest version (≥0.1.6-alpha,
+    incl. 0.1.7-alpha.1)**; older 0.1.0-rc.*/0.1.1-rc.*/0.1.2-*/0.1.3-alpha/0.1.5-alpha
+    releases are no longer guaranteed. The snapshot store uses
+    `@deepseek-ai/dsh-client-store` only — the rc.8-era `dsh-client-runtime` fallback was
+    removed; the client registers the newest version's row slot (`plugins.row.config`) and
+    the rc line's settings slot (`settings.plugin.item`); no runtime version check is
+    performed)
   - `@deepseek-ai/schemastery` (config schema validator; resolved at runtime: normal import
     first, then the DSH deployment copy under the Windows global npm layout)
   - `koffi` (Windows only: Job Object / process verification / native file dialog; same runtime

package/README.md

@@ -3,7 +3,9 @@
 > English: [README.en.md](README.en.md)
 
 dsh web profile 启动后自动打开独立应用窗口（或网页标签页）的常驻插件，并在
-设置 → 插件配置中提供配置卡片（手动维护浏览器位置等）。
+设置界面提供配置表单（手动维护浏览器位置等）。**最新版**的配置入口是
+「插件管理」页里本插件**那一行**的配置页；**最新 rc 线（0.1.5-rc.x）**为
+**设置 → 插件配置**卡片。
 
 ## 行为
 
@@ -78,15 +80,31 @@ Job Object（强杀也生效）+ 退出清理结束进程树。
 
 两种途径，等价：
 
-1. **设置页卡片**（推荐）：设置 → 插件配置 → 「自动打开网页」卡片。可编辑
-   `appWindow`（独立应用窗口）、`windowKind`（WebView2 宿主 / 浏览器应用窗口）、
-   `browserPath`（浏览器可执行文件，支持「浏览」原生对话框选择；位于窗口类型
-   下方，仅选择「浏览器应用窗口」时使能）、
+1. **设置表单**（推荐）——两条受支持的版本线，插件**同时**注册、哪条存在就哪条生效：
+   - **最新版（dsh ≥ 0.1.6-alpha，含 0.1.7-alpha.1）**：**「插件管理」页 →
+     `dsh-auto-open-web`（bundle 详情页）**，表单直接显示在该页说明与组件行之间
+     （插槽 `plugins.bundle.config`，key = **bundle 包名**）—— 与 `dsh-harness-tags`
+     同款席位。页面只传 `{ view: 'page' }`，**数据由插件自绑**：命名空间 = 本条目 id，
+     经客户端服务 `configForms` 取 ConfigForm（快照 + `set`/`unset`/订阅）。
+     此形态只有「保存」，**离开页面即丢弃暂存**。
+   - **最新 rc 线（0.1.5-rc.x）**：设置 → 插件配置 → 「自动打开网页」折叠卡片
+     （插槽 `settings.plugin.item`，按设置命名空间 keyed）。数据走宿主
+     `settings.register` + 客户端 `settingsScope`。
+
+   两条线的**客户端服务互不存在**（新版的 `configForms` ↔ rc 线的
+   `settingsScope`），因此插件把这两个服务都改为**惰性读取**、`inject` 只声明
+   两线共有的服务（`slots`/`locale`/`connection`/`remote`）——否则硬注入会让插件
+   在另一条线上永远 pending、设置界面完全不出现。更早的版本（0.1.0-rc.*、
+   0.1.1-rc.*、0.1.2-*/0.1.3-alpha/0.1.5-alpha/0.1.6-alpha.1）**不再保证**。
+
+   两种入口都可编辑 `appWindow`（独立应用窗口）、`windowKind`（WebView2 宿主 /
+   浏览器应用窗口）、`browserPath`（浏览器可执行文件，支持「浏览」原生对话框
+   选择；位于窗口类型下方，仅选择「浏览器应用窗口」时使能）、
    `exitOnWindowClose`（窗口关闭时退出 DSH，默认关闭）。
-   保存后经**官方 settings 域**（客户端 settingsScope）持久化到
-   settings 文档（命名空间 `auto-open-web`），首次保存后设置值优先于行配置；
-   宿主仅保留「浏览」「测试」辅助路由（官方通道无法覆盖的能力）。
-2. **行配置**（cordis.patch.yml）：作为启动种子，设置卡片保存前生效。
+   保存后设置值优先于行配置（新版落在该行的用户层覆盖上，rc 线落在
+   `auto-open-web` 设置命名空间）；宿主仅保留「浏览」「测试」辅助路由
+   （官方通道无法覆盖的能力）。
+2. **行配置**（cordis.patch.yml）：作为启动种子，设置表单保存前生效。
 
 | 字段 | 默认 | 说明 |
 | --- | --- | --- |
@@ -157,8 +175,12 @@ dsh plugin --profile web remove dsh-auto-open-web   # 同时移除依赖与对
 安装后:pnpm 将包加入 `profiles/web/node_modules`,`dsh` 把
 `dsh-auto-open-web` 追加到 `dsh.profile.bundles`;启动时 bundle 的
 `cordis.patch.yml` 插入插件行(`name: auto-open-web`,按包名解析)。
-重启 `dsh web` 后设置页出现「自动打开网页」卡片(客户端 bundle 由 modules
-行按 `dsh.client` 声明在启动时扫描进浏览器清单)。
+重启 `dsh web` 后,配置表单出现在对应入口(最新版:「插件管理」页里
+`dsh-auto-open-web` 那一行的配置页;最新 rc 线:设置 → 插件配置卡片)。
+客户端 bundle 由 modules 行按 `dsh.client` 声明在启动时扫描进浏览器清单;
+插件在客户端**同时**向 `plugins.bundle.config`(新)与 `settings.plugin.item`
+(旧)两个插槽注册,由客户端插槽机制决定哪个生效(不存在者保持 pending,
+不报错、不影响另一者)。
 
 生效配置按以下顺序逐层组合(后应用的层按行胜出,整行替换 config 而非深合并):
 每个 bundle 的 patch(按 bundles 列表顺序)→ profile 自己的
@@ -169,10 +191,11 @@ dsh plugin --profile web remove dsh-auto-open-web   # 同时移除依赖与对
 
 - **本包零 dependencies**:所有运行时依赖均由 **DSH 部署提供**,以 optional
   peer 声明(安装无警告):
-  - `@deepseek-ai/dsh`(宿主,声明兼容范围 `>=0.1.0-rc.8 <0.2.0`:
-    自 rc.8 起客户端冻结表移除 `dsh-client-schema-form`、引入
-    `dsh-client-runtime`,本插件的设置卡片与打开行为均依赖该版本;
-    不做运行时版本检测)
+  - `@deepseek-ai/dsh`(宿主,声明兼容范围 **`>=0.1.5-rc.1 <0.2.0`**:
+    覆盖**最新 rc 线(0.1.5-rc.x)**与**最新版(≥0.1.6-alpha,含 0.1.7-alpha.1)**;
+    更早的 0.1.0-rc.*/0.1.1-rc.*/0.1.2-*/0.1.3-alpha/0.1.5-alpha 不再保证。
+    快照 store 统一走 `@deepseek-ai/dsh-client-store`(自 0.1.2-alpha.2 起,
+    rc.8 时代的 `dsh-client-runtime` 回退已移除);不做运行时版本检测)
   - `@deepseek-ai/schemastery`(配置 schema 校验器;运行时解析:常规 import
     优先,其次 Windows 全局 npm 布局下的 DSH 部署副本)
   - `koffi`(仅 Windows 的 Job Object / 进程校验 / 原生对话框;同样运行时
@@ -184,8 +207,27 @@ dsh plugin --profile web remove dsh-auto-open-web   # 同时移除依赖与对
   (不 require `dsh-client-ui-primitives`,不复刻官方样式表),卡片外壳、
   字段、按钮、输入框、图标全部手写;观感经官方设计令牌变量
   (`--dsw-alias-*` / `--dsw-static-*`)对齐,浅/深色自动跟随主题。
-  仅使用官方公开的数据/机制接口:`settingsScope`(settings 域)、`slots`
-  (插槽)、`locale`(文案)、`dsh-client-runtime`(快照 store)。
+  **维护提示(0.1.26,新版设置投影)**:dsh 0.1.7 起宿主只把**标记为
+  `volatile` 的 Config 字段**投影成设置表单(`dsh-settings` 的 `volatileForm()`
+  对非 volatile 字段直接返回 undefined → `describe()` 里没有本条目 → 页面显示
+  "本部署未提供该设置命名空间")。因此 `lib/index.js` 的 `Config` 四个字段都必须
+  链上 schemastery 的 **`.volatile()`**(官方 `dsh-agent-loop` 同款写法);
+  **不要**写成 `.set('volatile', true)` —— `Schema.prototype.set` 是写 dict 子字段,
+  会把 schema 弄坏、条目 import 失败。
+  0.1.7 把设置命名空间改为"**每 profile 条目一个**"（= 本条目 id），与 bundle
+  席位配套：页面只给 `view`，插件自己经惰性读取的 `configForms` 绑定该命名空间
+  （rc 线同理，用惰性读取的 `settingsScope`）。
+  **维护提示(0.1.22)**:主按钮(保存)必须用**随主题反转**的令牌对
+  `background:var(--dsw-alias-label-primary)` +
+  `color:var(--dsw-alias-bg-layer-3)`(与官方 `PluginConfigForm` 的 save 同款)。
+  深色模式下 `--dsw-alias-brand-primary` 是**近白色**,若沿用不存在的
+  `--dsw-alias-label-inverse`(回退 #fff)会渲染成白字白底、按钮不可见;
+  同理不要引用并不存在的 `--dsw-alias-label-error`(真名是
+  `--dsw-alias-state-error-primary`)。这两条已由 `smoke-client-slots.mjs`
+  断言守护。
+  仅使用官方公开的数据/机制接口:`slots`(插槽)、`locale`(文案)、
+  行 Config 表单(新版,页面下发 `form`)、rc 线的 `settingsScope`
+  (惰性读取)、快照 store。
 - **npm 包已含 WebView2 宿主编译产物**(prepack 编译后发布);**GitHub
   main 分支与源码 checkout 方式不含** `host-publish/`(构建产物被
   .gitignore 忽略):webview2 模式需先在 `node_modules/dsh-auto-open-web`

package/lib/client.js

@@ -1,14 +1,27 @@
-// dsh-auto-open-web — Client bundle(设置卡片;UI 完全自绘,不依赖官方组件/CSS 模板)
+// dsh-auto-open-web — Client bundle(设置表单;UI 完全自绘,不依赖官方组件/CSS 模板)
 // 格式:window.__ModuleLoader__.load({ id, factory });factory(require) 的
-// require 解析浏览器端模块表(react 为壳层静态模块,@deepseek-ai/dsh-client-runtime
-// 为动态包)。**不** require @deepseek-ai/dsh-client-ui-primitives 等官方 UI 包。
+// require 解析浏览器端冻结模块表(react、@deepseek-ai/dsh-client-store 等)。
+// **不** require @deepseek-ai/dsh-client-ui-primitives 等官方 UI 包。
 //
-// 依赖边界(与官方数据的对接面,均为公开接口;本插件声明 dsh ≥0.1.0-rc.8):
-//   - settingsScope:官方 settings 域(命名空间 `auto-open-web`;第三方命名空间
-//     白名单自 rc.7 起已取消,rc.8 下无限制)
-//   - slots:settings.plugin.item 插槽(keyed 注册,rc.7 起要求 options.key)
+// 依赖边界(与官方数据的对接面,均为公开接口):
+//   支持两条版本线(0.1.26 起;更早的 alpha/rc 不再保证):
+//     · 最新版(dsh ≥0.1.6-alpha,含 0.1.7-alpha.1):插件设置位于「插件管理」页,
+//       配置注册在 **bundle 详情页** —— 槽 `plugins.bundle.config`,key = bundle
+//       包名(`dsh-auto-open-web`),与 dsh-harness-tags 同款席位。页面只传
+//       `{ view:'page' }`,没有 form,故组件自己经客户端服务 `configForms` 绑命名
+//       空间(条目 id `auto-open-web`);宿主只在 Config 字段标了 `.volatile()`
+//       时才投影该命名空间。
+//     · 最新 rc 线(0.1.5-rc.x):设置页插件配置卡片 —— 槽 `settings.plugin.item`
+//       (按设置命名空间 keyed),数据走宿主 `settings.register` + 客户端
+//       `settingsScope`。
+//   两条线的客户端服务互不存在(settingsScope ↔ configForms),因此:
+//     - `exports.inject` 只声明两线共有的服务(slots/locale/connection/remote);
+//     - settingsScope / configForms 都用 `ctx.get` **惰性读取**;
+//     - 两个槽都用 slots.inject 挂载,不存在的插槽只保持 pending(不报错)。
 //   - locale:文案注册(zh/en/ja/ko/fr/de/ru,跟随界面语言)
-//   - dsh-client-runtime:createSnapshotStore 快照 store(缺失时内置兜底实现)
+//   - store:createSnapshotStore 快照 store(dsh-client-store,缺失时内置最小实现)
+//     —— rc.8 时代的 dsh-client-runtime 回退已按兼容策略移除(0.1.2-alpha.2 起
+//     统一为 dsh-client-store)。
 //
 // 视觉(全部自产):
 //   - 卡片外壳、字段、按钮、输入框、复选/单选、徽章、图标均为手写实现;
@@ -44,13 +57,17 @@ window.__ModuleLoader__.load({
       '.aow-cardReadOnly{color:var(--dsw-alias-label-tertiary,var(--dsw-alias-label-secondary));margin:12px 0 0;font-size:12px;line-height:1.5}' +
       '.aow-pending{white-space:nowrap;background:var(--dsw-alias-bg-module-platform,var(--dsw-alias-bg-layer-2));color:var(--dsw-alias-label-secondary);border-radius:999px;flex:none;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}' +
       '.aow-cardFooter{border-top:1px solid var(--dsw-alias-border-l2);justify-content:flex-end;align-items:center;gap:8px;padding:12px 0 4px;display:flex}' +
-      '.aow-cardFailed{min-width:0;color:var(--dsw-alias-label-error,var(--dsw-alias-state-error-primary));flex:1;margin:0;font-size:12px;line-height:1.5}' +
+      '.aow-cardFailed{min-width:0;color:var(--dsw-alias-state-error-primary);flex:1;margin:0;font-size:12px;line-height:1.5}' +
       // 按钮:描边(outline)与主色(save)两种,禁用半透明。
       '.aow-btn{appearance:none;font:inherit;cursor:pointer;border-radius:8px;padding:5px 14px;font-size:13px;line-height:1.5;border:1px solid transparent}' +
       '.aow-btn:disabled{opacity:.55;cursor:default}' +
       '.aow-btnOutline{border-color:var(--dsw-alias-border-l2);color:var(--dsw-alias-label-secondary);background:0 0}' +
       '.aow-btnOutline:hover:not(:disabled){color:var(--dsw-alias-label-primary)}' +
-      '.aow-btnPrimary{background:var(--dsw-alias-brand-primary);color:var(--dsw-alias-label-inverse,#fff);border-color:var(--dsw-alias-brand-primary);font-weight:600}' +
+      // 主按钮(保存):与官方 PluginConfigForm 的 save 同款配色 ——
+      // 底色 label-primary、文字 bg-layer-3,深色模式下这对令牌自动反转
+      // (浅色=近黑底白字,深色=近白底深字);不再引用并不存在的 label-inverse
+      // (深色下它会退化成 #fff,造成白字白底、保存按钮看不见)。
+      '.aow-btnPrimary{background:var(--dsw-alias-label-primary);color:var(--dsw-alias-bg-layer-3,#fff);font-weight:600}' +
       '.aow-btnPrimary:hover:not(:disabled){filter:brightness(.95)}'
     // 字段区:label 行 + 控件 + hint;相邻字段以 l2 分隔;徽章/恢复默认同观感。
     var FIELDS_CSS =
@@ -66,8 +83,8 @@ window.__ModuleLoader__.load({
       '.aow-input{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);height:34px;font:inherit;color:var(--dsw-alias-label-primary);border-radius:8px;padding:0 12px;font-size:13px;line-height:1.5}' +
       '.aow-input:focus-visible{border-color:var(--dsw-alias-brand-primary);outline:none}' +
       '.aow-input:disabled{color:var(--dsw-alias-label-tertiary,var(--dsw-alias-label-secondary));cursor:default}' +
-      '.aow-inputInvalid{border-color:var(--dsw-alias-label-error,var(--dsw-alias-state-error-primary))}' +
-      '.aow-invalid{color:var(--dsw-alias-label-error,var(--dsw-alias-state-error-primary));margin:0;font-size:12px;line-height:1.5}' +
+      '.aow-inputInvalid{border-color:var(--dsw-alias-state-error-primary)}' +
+      '.aow-invalid{color:var(--dsw-alias-state-error-primary);margin:0;font-size:12px;line-height:1.5}' +
       '.aow-hint{color:var(--dsw-alias-label-tertiary,var(--dsw-alias-label-secondary));margin:0;font-size:12px;line-height:1.5}'
     // 布局与杂项:行排列、复选/单选、测试结果状态。
     var CONTROLS_CSS =
@@ -76,7 +93,7 @@ window.__ModuleLoader__.load({
       '.aow-check input{accent-color:var(--dsw-alias-brand-primary);width:15px;height:15px;margin:0;flex:none}' +
       '.aow-check input:disabled{cursor:default}' +
       '.aow-test-ok{color:var(--dsw-alias-state-success-primary);margin:4px 0 0;font-size:12px;line-height:1.5}' +
-      '.aow-test-fail{color:var(--dsw-alias-label-error,var(--dsw-alias-state-error-primary));margin:4px 0 0;font-size:12px;line-height:1.5}'
+      '.aow-test-fail{color:var(--dsw-alias-state-error-primary);margin:4px 0 0;font-size:12px;line-height:1.5}'
     var CARD_TAG = 'dsh-auto-open-web/Card.module.css'
     var FIELDS_TAG = 'dsh-auto-open-web/Fields.module.css'
     var CONTROLS_TAG = 'dsh-auto-open-web/Controls.module.css'
@@ -94,23 +111,15 @@ window.__ModuleLoader__.load({
     injectCss(CONTROLS_TAG, CONTROLS_CSS)
 
     // ── 共享模块 ─────────────────────────────────────────────────────────
-    // 快照 store 解析顺序(与 gowin 插件同款,双版本兼容):
-    //   @deepseek-ai/dsh-client-store(当前壳层静态模块,dsh >= 0.1.2-alpha.1)
-    //   → @deepseek-ai/dsh-client-runtime(rc8 动态包) → 内置最小实现。
-    // 缺失或版本不含 createSnapshotStore 时退化为内置实现,绝不抛错。
+    // 快照 store:@deepseek-ai/dsh-client-store(壳层静态模块,自 dsh 0.1.2-alpha.2
+    // 起提供;最新 rc 线与最新版都包含它)。rc.8 时代的 dsh-client-runtime 回退
+    // 已按兼容策略移除;若该模块缺失(异常部署)退化为内置最小实现,绝不抛错。
     var createSnapshotStore = null
     try {
       createSnapshotStore = require('@deepseek-ai/dsh-client-store').createSnapshotStore
     } catch (e) {
       console.error('[auto-open-web] dsh-client-store require failed:', e !== null && e !== undefined && e.message !== undefined ? e.message : String(e))
     }
-    if (createSnapshotStore === undefined || createSnapshotStore === null) {
-      try {
-        createSnapshotStore = require('@deepseek-ai/dsh-client-runtime').createSnapshotStore
-      } catch (e) {
-        console.error('[auto-open-web] dsh-client-runtime require failed:', e !== null && e !== undefined && e.message !== undefined ? e.message : String(e))
-      }
-    }
     if (createSnapshotStore === undefined || createSnapshotStore === null) {
       createSnapshotStore = fallbackSnapshotStore
     }
@@ -458,14 +467,90 @@ window.__ModuleLoader__.load({
       }
     }
 
-    // ── 设置卡片页面(自绘组件拼装) ─────────────────────────────────────
-    function AutoOpenSettingsPage(props) {
-      const { t } = props
-      const state = props.useAutoOpenCard((snapshot) => snapshot)
+    // ── 两代插槽共用的字段构件 ───────────────────────────────────────────
+    /** 字段规格(两代共用:schema 字段名 → 文本格式化/解析规则)。 */
+    function fieldSpecs() {
+      return [
+        boolField('appWindow'),
+        windowKindField('windowKind'),
+        textField('browserPath'),
+        boolField('exitOnWindowClose')
+      ]
+    }
+    /** 字段头部"已覆盖 + 恢复默认"徽章(静态徽章可选)。 */
+    function badgesFor(t, state, field, resetField, staticLabel) {
+      return React.createElement(FieldBadges, {
+        static: staticLabel,
+        overridden: state[field].overridden,
+        disabled: !state.writable,
+        overriddenLabel: t('overridden'),
+        resetLabel: t('reset'),
+        onReset: () => resetField(field)
+      })
+    }
+    /**
+     * 四个字段的节点(两代插槽共用同一份 UI 与文案)。
+     * @param t - 文案
+     * @param state - 每字段 { text, overridden, invalid } + writable
+     * @param edit - (field, value) 暂存编辑
+     * @param resetField - (field) 恢复默认(清除用户层)
+     * @param ui - useBrowserTools 的返回值(浏览/测试按钮与结果)
+     */
+    function buildFieldNodes(t, state, edit, resetField, ui) {
+      return [
+        React.createElement(Field, {
+          key: 'appWindow',
+          label: t('appWindow'),
+          badges: badgesFor(t, state, 'appWindow', resetField),
+          control: React.createElement(Checkbox, { checked: state.appWindow.text === true, disabled: !state.writable, onChange: (v) => edit('appWindow', v) }, t('appWindowHint'))
+        }),
+        React.createElement(Field, {
+          key: 'windowKind',
+          label: t('windowKind'),
+          badges: badgesFor(t, state, 'windowKind', resetField),
+          control: React.createElement(React.Fragment, null,
+            React.createElement(Radio, { checked: state.windowKind.text === 'webview2', disabled: !state.writable, value: 'webview2', onChange: (v) => edit('windowKind', v) }, t('windowKindWebview2')),
+            React.createElement(Radio, { checked: state.windowKind.text === 'browser', disabled: !state.writable, value: 'browser', onChange: (v) => edit('windowKind', v) }, t('windowKindBrowser'))
+          )
+        }),
+        React.createElement(Field, {
+          key: 'browserPath',
+          label: t('browserPath'),
+          badges: badgesFor(t, state, 'browserPath', resetField),
+          hint: t('browserPathHint'),
+          invalid: state.browserPath.invalid,
+          invalidLabel: t('browserPathInvalid'),
+          control: React.createElement('div', { className: 'aow-row' },
+            React.createElement(TextInput, {
+              id: 'auto-open-web-browser-path',
+              value: state.browserPath.text,
+              placeholder: t('browserPathPlaceholder'),
+              disabled: ui.browserDisabled,
+              invalid: state.browserPath.invalid,
+              onChange: (text) => edit('browserPath', text)
+            }),
+            React.createElement(Btn, { disabled: !state.writable || ui.picking, onClick: ui.browse }, ui.picking ? t('browsePicking') : t('browse')),
+            React.createElement(Btn, { disabled: ui.testing || state.windowKind.text !== 'browser', onClick: ui.testBrowser }, ui.testing ? t('testRunning') : t('test'))
+          ),
+          footer: ui.testResult !== null
+            ? React.createElement('p', { className: ui.testResult.ok ? 'aow-test-ok' : 'aow-test-fail', role: 'status' },
+                (ui.testResult.ok ? '✓ ' : '✗ ') + ui.testResult.text
+              )
+            : null
+        }),
+        React.createElement(Field, {
+          key: 'exitOnWindowClose',
+          label: t('exitOnWindowClose'),
+          badges: badgesFor(t, state, 'exitOnWindowClose', resetField, t('experimental')),
+          control: React.createElement(Checkbox, { checked: state.exitOnWindowClose.text === true, disabled: !state.writable, onChange: (v) => edit('exitOnWindowClose', v) }, t('exitOnWindowCloseHint'))
+        })
+      ]
+    }
+    /** 宿主辅助路由(原生浏览对话框 / 拉起测试):两代插槽共用。 */
+    function useBrowserTools(t, state, edit) {
       const [picking, setPicking] = React.useState(false)
       const [testing, setTesting] = React.useState(false)
       const [testResult, setTestResult] = React.useState(null) // { ok, text } | null
-
       const browse = () => {
         if (!state.writable || picking) return
         setPicking(true)
@@ -473,13 +558,12 @@ window.__ModuleLoader__.load({
           .then((response) => response.json())
           .then((result) => {
             if (result !== null && result !== undefined && result.ok === true && typeof result.path === 'string') {
-              props.edit('browserPath', result.path)
+              edit('browserPath', result.path)
             }
           })
           .catch(() => { /* 选择失败静默;用户可重试 */ })
           .then(() => { setPicking(false) })
       }
-
       const testBrowser = () => {
         if (testing) return
         setTesting(true)
@@ -487,7 +571,7 @@ window.__ModuleLoader__.load({
         fetch('/auto-open-web/test-browser', {
           method: 'POST',
           headers: { 'content-type': 'application/json' },
-          body: JSON.stringify({ browserPath: state.browserPath.text }),
+          body: JSON.stringify({ browserPath: state.browserPath.text })
         })
           .then((response) => response.json())
           .then((result) => {
@@ -500,17 +584,182 @@ window.__ModuleLoader__.load({
           .catch((error) => { setTestResult({ ok: false, text: t('testFail') + ': ' + String(error !== null && error !== undefined && error.message !== undefined ? error.message : error) }) })
           .then(() => { setTesting(false) })
       }
+      return {
+        picking,
+        testing,
+        testResult,
+        browse,
+        testBrowser,
+        browserDisabled: !state.writable || state.windowKind.text !== 'browser'
+      }
+    }
 
-      const browserDisabled = !state.writable || state.windowKind.text !== 'browser'
-
-      const badgesFor = (field) => React.createElement(FieldBadges, {
-        overridden: state[field].overridden,
-        disabled: !state.writable,
-        overriddenLabel: t('overridden'),
-        resetLabel: t('reset'),
-        onReset: () => props.resetField(field)
-      })
+    // ── 新版(dsh ≥ 0.1.6-alpha):插件管理页 → 行配置页 ───────────────────
+    // 页面下发 `form = { state, mutate }`:state 是宿主投影的行 Config 快照
+    // (value/base/user/status/writable/revision),mutate(ops, revision) 原子写入。
+    // 与官方同一约定:只有保存会写入,离开页面即丢弃暂存(暂存只在本组件 state)。
+    function rowFieldStored(snapshot, field) {
+      const user = snapshot.user
+      return user !== undefined && user !== null && Object.prototype.hasOwnProperty.call(user, field)
+    }
+    /** 单字段视图(staged 优先,否则取快照值);与 FormModel.field 同语义。 */
+    function rowFieldView(snapshot, staged, spec) {
+      const edit = staged.get(spec.field)
+      const value = snapshot.value !== undefined && snapshot.value !== null ? snapshot.value[spec.field] : undefined
+      if (edit === undefined) {
+        return { text: spec.format(value), overridden: rowFieldStored(snapshot, spec.field), invalid: false }
+      }
+      const write = edit.clear ? { kind: 'clear' } : spec.parse(edit.text)
+      return { text: edit.text, overridden: write !== undefined && write.kind === 'set', invalid: write === undefined }
+    }
+    /** 暂存草稿 → 写入计划(与 FormModel.plan 同语义,产物是 path op)。 */
+    function rowPlan(snapshot, staged, specs) {
+      const plan = []
+      for (const [field, edit] of staged) {
+        const spec = specs.find((item) => item.field === field)
+        const value = snapshot.value !== undefined && snapshot.value !== null ? snapshot.value[field] : undefined
+        if (edit.clear) {
+          if (rowFieldStored(snapshot, field)) plan.push({ field, op: { op: 'unset', path: [field] } })
+          continue
+        }
+        if (edit.text === spec.format(value)) continue
+        const write = spec.parse(edit.text)
+        if (write === undefined) plan.push({ field, op: undefined })
+        else if (write.kind === 'clear') plan.push({ field, op: { op: 'unset', path: [field] } })
+        else plan.push({ field, op: { op: 'set', path: [field], value: write.value } })
+      }
+      return plan
+    }
+    /**
+     * bundle 配置页的数据源解析(按优先级):
+     *   1. 页面下发的 `props.form`(官方路径:页面把宿主投影的 Config 作为
+     *      `{ state, mutate }` 传入——`plugins.item`/`plugins.row.config` 会这样传);
+     *   2. 页面**只传 view**(0.1.7-alpha.1 的 `plugins.bundle.config` 正是如此)时,
+     *      自行经客户端服务 `configForms` 按命名空间(= 本条目 id)解析,拿到
+     *      ConfigForm(getSnapshot/subscribe/set/unset,与本插件 FormModel 的 scope
+     *      接口一致);候选顺序:行 id → 包名。
+     * 两者都没有才返回 null(组件显示"该命名空间未提供"——通常意味着 Config
+     * 字段没标 `.volatile()`,宿主压根没投影出命名空间)。
+     * @param props - 插槽 owner props(可能带 form)
+     * @param forms - configForms 服务(惰性读取,rc 线上为 undefined)
+     * @returns {{ state, mutate, subscribe }} 或 null
+     */
+    function resolveRowForm(props, forms) {
+      const supplied = props.form
+      if (supplied !== undefined && supplied !== null && supplied.state !== undefined && supplied.state !== null) {
+        return {
+          state: supplied.state,
+          mutate: (ops, revision) => supplied.mutate(ops, revision),
+          subscribe: null
+        }
+      }
+      if (forms === undefined || forms === null || typeof forms.get !== 'function') return null
+      for (const ns of ROW_FORM_NS_CANDIDATES) {
+        let bound = null
+        try {
+          bound = forms.get(ns)
+        } catch (e) {
+          bound = null
+        }
+        if (bound === undefined || bound === null || typeof bound.getSnapshot !== 'function') continue
+        const snapshot = bound.getSnapshot()
+        if (snapshot === undefined || snapshot === null || snapshot.status !== 'ready') continue
+        return {
+          state: snapshot,
+          mutate: (ops, revision) => bound.mutate(ops, revision),
+          subscribe: typeof bound.subscribe === 'function' ? (listener) => bound.subscribe(listener) : null
+        }
+      }
+      return null
+    }
+    function AutoOpenRowForm(props) {
+      const { t } = props
+      const form = resolveRowForm(props, props.configForms)
+      const [, forceTick] = React.useState(0)
+      const subscribe = form !== null ? form.subscribe : null
+      // 命名空间后续才就绪 / 值被外部改动时跟新(revision 变化即重渲染)。
+      React.useEffect(() => {
+        if (subscribe === null || subscribe === undefined) return undefined
+        return subscribe(() => forceTick((n) => n + 1))
+      }, [subscribe])
+      const snapshot = form !== null && form.state !== undefined && form.state !== null ? form.state : null
+      const [staged, setStaged] = React.useState(() => new Map())
+      const [saving, setSaving] = React.useState(false)
+      const [failed, setFailed] = React.useState(false)
+      const stagedRef = React.useRef(staged)
+      stagedRef.current = staged
+      const specs = React.useMemo(() => fieldSpecs(), [])
+      const available = snapshot !== null && snapshot.status === 'ready'
+      const writable = snapshot !== null && snapshot.writable === true
+      const plan = available ? rowPlan(snapshot, staged, specs) : []
+      const invalid = plan.some((item) => item.op === undefined)
+      const dirty = plan.length > 0
+      const state = {
+        available,
+        writable,
+        dirty,
+        invalid,
+        saving,
+        failed,
+        appWindow: { text: true, overridden: false, invalid: false },
+        windowKind: { text: 'webview2', overridden: false, invalid: false },
+        browserPath: { text: '', overridden: false, invalid: false },
+        exitOnWindowClose: { text: false, overridden: false, invalid: false }
+      }
+      if (snapshot !== null) {
+        for (const spec of specs) state[spec.field] = rowFieldView(snapshot, staged, spec)
+      }
+      const edit = (field, text) => {
+        const next = new Map(stagedRef.current)
+        next.set(field, { text, clear: false })
+        setStaged(next)
+        setFailed(false)
+      }
+      const resetField = (field) => {
+        const spec = specs.find((item) => item.field === field)
+        const base = snapshot !== null && snapshot.base !== undefined && snapshot.base !== null ? snapshot.base[field] : undefined
+        const next = new Map(stagedRef.current)
+        next.set(field, { text: spec.format(base), clear: true })
+        setStaged(next)
+        setFailed(false)
+      }
+      const save = () => {
+        if (!available || saving) return
+        const ops = plan.filter((item) => item.op !== undefined).map((item) => item.op)
+        if (plan.length === 0 || ops.length !== plan.length) return
+        setSaving(true)
+        setFailed(false)
+        Promise.resolve(form.mutate(ops, snapshot.revision))
+          .then((accepted) => {
+            if (accepted === true) setStaged(new Map())
+            setFailed(accepted !== true)
+          })
+          .catch(() => { setFailed(true) })
+          .then(() => { setSaving(false) })
+      }
+      const ui = useBrowserTools(t, state, edit)
+      // 行缺描述时页面取一行摘要。
+      if (props.view === 'summary') return t('description')
+      if (!available) return React.createElement('p', { className: 'aow-hint', role: 'status' }, t('unavailable'))
+      return React.createElement('div', null,
+        !writable ? React.createElement('p', { className: 'aow-cardReadOnly', role: 'status' }, t('readOnly')) : null,
+        ...buildFieldNodes(t, state, edit, resetField, ui),
+        React.createElement('div', { className: 'aow-cardFooter' },
+          failed ? React.createElement('p', { className: 'aow-cardFailed', role: 'status' }, t('saveFailed')) : null,
+          React.createElement(Btn, { variant: 'primary', disabled: !dirty || invalid || saving, onClick: save }, saving ? t('saving') : t('save'))
+        )
+      )
+    }
 
+    // ── 最新 rc 线(0.1.5-rc.x):设置页 → 插件配置卡片 ─────────────────────
+    // 宿主用 settings.register(ns, schema) 注册命名空间,客户端经 settingsScope
+    // 读写(该服务在新版已被 configForms 取代,故在 apply 里惰性读取)。
+    function AutoOpenSettingsPage(props) {
+      const { t } = props
+      const state = props.useAutoOpenCard((snapshot) => snapshot)
+      const ui = useBrowserTools(t, state, props.edit)
+      if (props.view === 'summary') return t('description')
+      const fields = buildFieldNodes(t, state, props.edit, props.resetField, ui)
       return React.createElement(Card, {
         t,
         titleKey: 'title',
@@ -518,71 +767,26 @@ window.__ModuleLoader__.load({
         state,
         onSave: props.save,
         onDiscard: props.discard
-      },
-        // ---- 独立应用窗口 ----
-        React.createElement(Field, {
-          label: t('appWindow'),
-          badges: badgesFor('appWindow'),
-          control: React.createElement(Checkbox, { checked: state.appWindow.text === true, disabled: !state.writable, onChange: (v) => props.edit('appWindow', v) }, t('appWindowHint'))
-        }),
-        // ---- 窗口类型 ----
-        React.createElement(Field, {
-          label: t('windowKind'),
-          badges: badgesFor('windowKind'),
-          control: React.createElement(React.Fragment, null,
-            React.createElement(Radio, { checked: state.windowKind.text === 'webview2', disabled: !state.writable, value: 'webview2', onChange: (v) => props.edit('windowKind', v) }, t('windowKindWebview2')),
-            React.createElement(Radio, { checked: state.windowKind.text === 'browser', disabled: !state.writable, value: 'browser', onChange: (v) => props.edit('windowKind', v) }, t('windowKindBrowser'))
-          )
-        }),
-        // ---- 浏览器可执行文件(输入 + 浏览/测试按钮) ----
-        React.createElement(Field, {
-          label: t('browserPath'),
-          badges: badgesFor('browserPath'),
-          hint: t('browserPathHint'),
-          invalid: state.browserPath.invalid,
-          invalidLabel: t('browserPathInvalid'),
-          control: React.createElement('div', { className: 'aow-row' },
-            React.createElement(TextInput, {
-              id: 'auto-open-web-browser-path',
-              value: state.browserPath.text,
-              placeholder: t('browserPathPlaceholder'),
-              disabled: browserDisabled,
-              invalid: state.browserPath.invalid,
-              onChange: (text) => props.edit('browserPath', text)
-            }),
-            React.createElement(Btn, { disabled: !state.writable || picking, onClick: browse }, picking ? t('browsePicking') : t('browse')),
-            React.createElement(Btn, { disabled: testing || state.windowKind.text !== 'browser', onClick: testBrowser }, testing ? t('testRunning') : t('test'))
-          ),
-          footer: testResult !== null
-            ? React.createElement('p', { className: testResult.ok ? 'aow-test-ok' : 'aow-test-fail', role: 'status' },
-                (testResult.ok ? '✓ ' : '✗ ') + testResult.text
-              )
-            : null
-        }),
-        // ---- 窗口关闭时退出 DSH(实验性) ----
-        React.createElement(Field, {
-          label: t('exitOnWindowClose'),
-          badges: React.createElement(FieldBadges, {
-            static: t('experimental'),
-            overridden: state.exitOnWindowClose.overridden,
-            disabled: !state.writable,
-            overriddenLabel: t('overridden'),
-            resetLabel: t('reset'),
-            onReset: () => props.resetField('exitOnWindowClose')
-          }),
-          control: React.createElement(Checkbox, { checked: state.exitOnWindowClose.text === true, disabled: !state.writable, onChange: (v) => props.edit('exitOnWindowClose', v) }, t('exitOnWindowCloseHint'))
-        })
-      )
+      }, ...fields)
     }
 
     // ---- 文案(locale 机制,zh/en/ja/ko/fr/de/ru) ----
     const NS = 'auto-open-web'
+    /** bundle 包名(manifest 名,与安装名一致)。 */
+    const BUNDLE_NAME = 'dsh-auto-open-web'
+    /** 本插件在 cordis.patch.yml 里声明的行 id;新版 settings 命名空间 = 本条目 id。 */
+    const ROW_ID = 'auto-open-web'
+    /** rc 线的设置命名空间(设置页卡片按它派发)。 */
+    const SETTINGS_NS = 'auto-open-web'
+    /** 自行解析 ConfigForm 时的命名空间候选(条目 id 通常是行 id,兜底包名)。 */
+    const ROW_FORM_NS_CANDIDATES = [ROW_ID, BUNDLE_NAME]
     const en = {
       title: 'Auto-open web',
       description: 'Open the DSH Web GUI in an app-style window on profile start; the browser path can be configured manually.',
       save: 'Save', saving: 'Saving…', discard: 'Discard', unsaved: 'Unsaved',
       readOnly: 'This deployment stores settings read-only.',
       saveFailed: 'The deployment did not accept these values; they were left for you to correct.',
+      unavailable: 'This deployment does not serve these settings, so nothing can be configured here.',
       expand: 'Show settings', collapse: 'Hide settings',
       overridden: 'Overridden', reset: 'Reset to default',
       appWindow: 'Independent app window',
@@ -606,6 +810,7 @@ window.__ModuleLoader__.load({
       save: '保存', saving: '保存中…', discard: '放弃修改', unsaved: '未保存',
       readOnly: '本部署的设置为只读。',
       saveFailed: '本部署没有接受这些值，已保留供你修改。',
+      unavailable: '本部署未提供该设置命名空间，暂时无法在此配置。',
       expand: '展开设置', collapse: '收起设置',
       overridden: '已覆盖', reset: '恢复默认',
       appWindow: '独立应用窗口',
@@ -629,6 +834,7 @@ window.__ModuleLoader__.load({
       save: '保存', saving: '保存中…', discard: '変更を破棄', unsaved: '未保存',
       readOnly: 'このデプロイメントの設定は読み取り専用です。',
       saveFailed: 'デプロイメントがこの値を受け入れませんでした。修正用に保持されています。',
+      unavailable: 'このデプロイメントはこの設定を提供していないため、ここでは構成できません。',
       expand: '設定を表示', collapse: '設定を隠す',
       overridden: '上書き済み', reset: 'デフォルトに戻す',
       appWindow: '独立アプリウィンドウ',
@@ -652,6 +858,7 @@ window.__ModuleLoader__.load({
       save: '저장', saving: '저장 중…', discard: '변경 취소', unsaved: '저장 안 됨',
       readOnly: '이 배포의 설정은 읽기 전용입니다.',
       saveFailed: '배포가 이 값을 수락하지 않았습니다. 수정할 수 있도록 유지됩니다.',
+      unavailable: '이 배포는 이 설정을 제공하지 않아 여기에서 구성할 수 없습니다.',
       expand: '설정 표시', collapse: '설정 숨기기',
       overridden: '재정의됨', reset: '기본값으로 재설정',
       appWindow: '독립 앱 창',
@@ -675,6 +882,7 @@ window.__ModuleLoader__.load({
       save: 'Enregistrer', saving: 'Enregistrement…', discard: 'Annuler les modifications', unsaved: 'Non enregistré',
       readOnly: 'Les paramètres de ce déploiement sont en lecture seule.',
       saveFailed: "Le déploiement n'a pas accepté ces valeurs; elles ont été conservées pour correction.",
+      unavailable: "Ce déploiement ne fournit pas ces paramètres ; ils ne peuvent pas être configurés ici.",
       expand: 'Afficher les paramètres', collapse: 'Masquer les paramètres',
       overridden: 'Remplacé', reset: 'Rétablir la valeur par défaut',
       appWindow: "Fenêtre d'application indépendante",
@@ -698,6 +906,7 @@ window.__ModuleLoader__.load({
       save: 'Speichern', saving: 'Speichern…', discard: 'Änderungen verwerfen', unsaved: 'Nicht gespeichert',
       readOnly: 'Die Einstellungen dieser Bereitstellung sind schreibgeschützt.',
       saveFailed: 'Die Bereitstellung hat diese Werte nicht akzeptiert; sie wurden zur Korrektur beibehalten.',
+      unavailable: 'Diese Bereitstellung stellt diese Einstellungen nicht bereit; sie können hier nicht konfiguriert werden.',
       expand: 'Einstellungen anzeigen', collapse: 'Einstellungen ausblenden',
       overridden: 'Überschrieben', reset: 'Standard wiederherstellen',
       appWindow: 'Eigenständiges App-Fenster',
@@ -721,6 +930,7 @@ window.__ModuleLoader__.load({
       save: 'Сохранить', saving: 'Сохранение…', discard: 'Отменить изменения', unsaved: 'Не сохранено',
       readOnly: 'Настройки этого развёртывания доступны только для чтения.',
       saveFailed: 'Развёртывание не приняло эти значения; они оставлены для исправления.',
+      unavailable: 'Это развёртывание не предоставляет эти настройки; здесь их настроить нельзя.',
       expand: 'Показать настройки', collapse: 'Скрыть настройки',
       overridden: 'Переопределено', reset: 'Вернуть по умолчанию',
       appWindow: 'Независимое окно приложения',
@@ -742,20 +952,42 @@ window.__ModuleLoader__.load({
     function apply(ctx) {
       // 文案(locale 机制,跟随界面语言)
       ctx.effect(() => ctx.locale.register(NS, { zh, en, ja, ko, fr, de, ru }), 'auto-open-web: card dictionary')
-      // 数据通道:settingsScope(官方 settings 域)
-      const scope = ctx.settingsScope.bind({ namespace: 'auto-open-web' })
-      const controller = new AutoOpenCardController(scope)
-      // 插槽:keyed 注册 + inject 面(hooks + 表单动作)
-      ctx.slots.inject('settings.plugin.item', () =>
+      // ── 新版(dsh ≥0.1.6-alpha):插件管理页 → **bundle 详情页**配置 ────────
+      // 与 dsh-harness-tags 同款席位:插槽 `plugins.bundle.config`,key = **bundle 包名**
+      // (页面按 ledger.bundles.has(pkg.name) 判定是否渲染该区块,位置在说明与组件行之间)。
+      // 页面只传 `{ view: 'page' }` —— 数据要**自己绑**:命名空间 = 本条目 id,
+      // 由客户端服务 configForms 提供 ConfigForm(getSnapshot/subscribe/set/unset,
+      // 与 FormModel 的 scope 接口一致);页面若哪天也下发 form,则优先用它。
+      // 注意 configForms 必须**惰性读取**且不在 exports.inject 里:rc 线没有这个服务,
+      // 硬注入会让插件在那条线上永远 pending(harness-tags 只在 0.1.7+ 上跑,所以它
+      // 可以直接在 manifest 的 inject 里点名 plugin-manager,我们不能)。
+      const configForms = typeof ctx.get === 'function' ? ctx.get('configForms') : undefined
+      ctx.slots.inject('plugins.bundle.config', () =>
         ctx.slots.register(
-          { name: 'settings.plugin.item', key: 'auto-open-web', label: '自动打开网页', locale: NS, inject: () => controller.inject() },
-          AutoOpenSettingsPage
+          { name: 'plugins.bundle.config', key: BUNDLE_NAME, locale: NS },
+          (props) => AutoOpenRowForm(Object.assign({}, props, { configForms }))
         )
       )
+      // ── 最新 rc 线(0.1.5-rc.x):设置页 → 插件配置卡片 ───────────────────
+      // 该线仍走旧的 settings 域:宿主 settings.register(ns, schema) 注册命名空间,
+      // 客户端经 settingsScope 读写。该服务在新版已被 configForms 取代,故惰性读取:
+      // 缺失时只跳过这条注册,不影响新版路径(硬注入会让插件在新版永远 pending)。
+      const settingsScope = typeof ctx.get === 'function' ? ctx.get('settingsScope') : undefined
+      if (settingsScope !== undefined && settingsScope !== null && typeof settingsScope.bind === 'function') {
+        const controller = new AutoOpenCardController(settingsScope.bind({ namespace: SETTINGS_NS }))
+        ctx.slots.inject('settings.plugin.item', () =>
+          ctx.slots.register(
+            { name: 'settings.plugin.item', key: SETTINGS_NS, label: '自动打开网页', locale: NS, inject: () => controller.inject() },
+            AutoOpenSettingsPage
+          )
+        )
+      }
     }
 
-    // 代码级服务依赖(cordis):数据/机制服务,不含任何 UI 包
-    var clientInject = ['slots', 'locale', 'connection', 'remote', 'settingsScope']
+    // 代码级服务依赖(cordis):两代共有的服务,不含任何 UI 包。
+    // 注意:settingsScope(rc 线)/ configForms(新版)互不存在,二者都必须惰性读取,
+    // 否则硬注入会让插件在另一条线上永远 pending。
+    var clientInject = ['slots', 'locale', 'connection', 'remote']
 
     exports.apply = apply
     exports.inject = clientInject

package/lib/index.js

@@ -74,17 +74,28 @@ export const name = 'auto-open-web';
  */
 export const inject = ['webServer', 'settings'];
 
+/**
+ * 配置 schema。
+ *
+ * **每个字段都带 `meta.volatile`**(schemastery `.volatile()`):
+ * dsh 0.1.7 起,宿主只把**标记为 volatile** 的 Config 字段投影成设置表单
+ * (`dsh-settings` 的 `volatileForm()`:非 volatile 字段直接返回 undefined,
+ * 于是 `describe()` 里根本没有本条目 → 客户端拿不到 form,页面显示
+ * "本部署未提供该设置命名空间")。volatile 的语义是"改动无需重挂载即可生效",
+ * 与本插件的四个字段一致(它们都在下次打开/窗口关闭时才起作用,见下)。
+ * 宿主据此把用户层覆盖写回本条目,`config` 在 apply 时即含最终值。
+ */
 export const Config = z.object({
   /** 启动时自动打开独立应用窗口;false 时与官方相同:默认浏览器打开(普通标签页)。 */
-  appWindow: z.boolean().default(true),
+  appWindow: z.boolean().default(true).volatile(),
   /** 窗口类型:webview2 = WebView2 宿主(独立进程,任务栏 DSH 图标,随 DSH 退出);
    *  browser = 浏览器 --app 专用实例(--user-data-dir 隔离)。所选类型不可用时
    *  降级为最后的兜底:默认浏览器打开(官方 dsh web 同款,普通标签页)。 */
-  windowKind: z.union([z.const('webview2'), z.const('browser')]).default('webview2'),
+  windowKind: z.union([z.const('webview2'), z.const('browser')]).default('webview2').volatile(),
   /** 手动维护的浏览器可执行文件路径(单条;优先于内置候选 Edge → Chrome;仅 browser 模式使用)。 */
-  browserPath: z.string().default(''),
+  browserPath: z.string().default('').volatile(),
   /** 关闭自动打开的窗口时随之退出 DSH(默认关闭;仅 appWindow 开启时生效)。 */
-  exitOnWindowClose: z.boolean().default(false),
+  exitOnWindowClose: z.boolean().default(false).volatile(),
 });
 
 const PICK_API_PATH = '/auto-open-web/pick-browser';
@@ -336,6 +347,13 @@ function removeLegacyState() {
   }
 }
 
+/**
+ * 本进程已为哪个 GUI URL 打开过窗口。
+ * 新版设置是 live 应用的(行 Config 投影 + settings 文档),用户保存配置会让
+ * 本条目重新 apply;没有这道守卫就会重复弹窗。进程重启后自然重置。
+ */
+let openedForUrl = null;
+
 /** 把任意输入规范化为完整配置(类型收紧 + 默认值;兼容旧 browsers 列表迁移)。 */
 function normalizeState(next) {
   const obj = next !== null && typeof next === 'object' ? next : {};
@@ -619,6 +637,14 @@ export function apply(ctx, config) {
       return;
     }
 
+    // 每进程每端口只打开一次:新版设置是 live 应用的(行 Config 投影),
+    // 用户保存配置会让本条目重新 apply —— 没有这道守卫就会再弹一个窗口。
+    if (openedForUrl === url) {
+      console.log('[auto-open-web] already opened for this process; skipping re-open (entry re-applied by a config change)');
+      return;
+    }
+    openedForUrl = url;
+
     // 独立应用窗口:按 windowKind 显式选择(webview2 | browser),直接加载 GUI 根地址。
     // 所选类型不可用时降级到最后兜底:默认浏览器打开(官方 dsh web 同款,
     // 普通标签页),保证用户至少能打开 GUI。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-auto-open-web",
-  "version": "0.1.20",
+  "version": "0.1.27",
   "description": "Open the DSH Web GUI in an app-style WebView2 window on profile start, with a settings card for browser paths",
   "repository": {
     "type": "git",
@@ -27,7 +27,6 @@
         "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-api-remotes",
         "@deepseek-ai/dsh-client-ui-settings",
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-locale"
       ]
     }
@@ -46,7 +45,7 @@
     "README.en.md"
   ],
   "peerDependencies": {
-    "@deepseek-ai/dsh": ">=0.1.0-rc.8 <0.2.0",
+    "@deepseek-ai/dsh": ">=0.1.5-rc.1 <0.2.0",
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "peerDependenciesMeta": {