dsh-auto-open-web 0.1.22 → 0.1.27

package/README.en.md

@@ -84,23 +84,33 @@ cleanup.
 
 Two equivalent ways:
 
-1. **Settings form** (recommended):
-   - **dsh ≥ 0.1.5 (incl. 0.1.6-alpha)**: open the **Plugins page → select this bundle
-     (`dsh-auto-open-web`)**; the form renders on the bundle's detail page between its
-     description and its rows (slot `plugins.bundle.config`, routed by bundle package
-     name). In this shape only **Save** is offered — leaving the page drops unsaved
-     staged edits.
-   - **rc.7 – 0.1.4**: Settings → Plugin configuration → the "自动打开网页" collapsible card
-     (slot `settings.plugin.item`). Both slots are registered at once and whichever
-     exists wins, so one package serves both generations.
-
-   Both shapes edit
+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
@@ -193,12 +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` —
-    the client half resolves the snapshot store across generations
-    (`@deepseek-ai/dsh-client-store` → `@deepseek-ai/dsh-client-runtime` → built-in
-    fallback) and registers into both the current plugin-manager slot
-    (`plugins.bundle.config`) and the earlier settings slot (`settings.plugin.item`);
-    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,8 +3,9 @@
 > English: [README.en.md](README.en.md)
 
 dsh web profile 启动后自动打开独立应用窗口（或网页标签页）的常驻插件，并在
-设置界面提供配置表单（手动维护浏览器位置等）。dsh ≥ 0.1.5 的配置入口是
-**「插件管理」页里本 bundle 的详情页**；rc.7–0.1.4 为**设置 → 插件配置**卡片。
+设置界面提供配置表单（手动维护浏览器位置等）。**最新版**的配置入口是
+「插件管理」页里本插件**那一行**的配置页；**最新 rc 线（0.1.5-rc.x）**为
+**设置 → 插件配置**卡片。
 
 ## 行为
 
@@ -79,22 +80,30 @@ Job Object（强杀也生效）+ 退出清理结束进程树。
 
 两种途径，等价：
 
-1. **设置表单**（推荐）：
-   - **dsh ≥ 0.1.5（含 0.1.6-alpha）**：**「插件管理」页 → 选中本插件（bundle
-     `dsh-auto-open-web`）**，配置表单显示在该 bundle 详情页的说明与插件行之间
-     （插槽 `plugins.bundle.config`，按 bundle 包名路由）。此形态下只有「保存」，
-     离开页面即丢弃未保存的暂存编辑。
-   - **rc.7 – 0.1.4**：设置 → 插件配置 → 「自动打开网页」折叠卡片
-     （插槽 `settings.plugin.item`）。两代插槽**同时注册、谁存在谁生效**，
-     无需按版本切换插件。
-
-   两代都可编辑 `appWindow`（独立应用窗口）、`windowKind`（WebView2 宿主 /
+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`），首次保存后设置值优先于行配置；
-   宿主仅保留「浏览」「测试」辅助路由（官方通道无法覆盖的能力）。
+   保存后设置值优先于行配置（新版落在该行的用户层覆盖上，rc 线落在
+   `auto-open-web` 设置命名空间）；宿主仅保留「浏览」「测试」辅助路由
+   （官方通道无法覆盖的能力）。
 2. **行配置**（cordis.patch.yml）：作为启动种子，设置表单保存前生效。
 
 | 字段 | 默认 | 说明 |
@@ -166,8 +175,8 @@ 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` 后,配置表单出现在对应入口(dsh ≥ 0.1.5:「插件管理」页里
-`dsh-auto-open-web` bundle 的详情页;更早版本:设置 → 插件配置卡片)。
+重启 `dsh web` 后,配置表单出现在对应入口(最新版:「插件管理」页里
+`dsh-auto-open-web` 那一行的配置页;最新 rc 线:设置 → 插件配置卡片)。
 客户端 bundle 由 modules 行按 `dsh.client` 声明在启动时扫描进浏览器清单;
 插件在客户端**同时**向 `plugins.bundle.config`(新)与 `settings.plugin.item`
 (旧)两个插槽注册,由客户端插槽机制决定哪个生效(不存在者保持 pending,
@@ -182,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 / 进程校验 / 原生对话框;同样运行时
@@ -197,6 +207,16 @@ dsh plugin --profile web remove dsh-auto-open-web   # 同时移除依赖与对
   (不 require `dsh-client-ui-primitives`,不复刻官方样式表),卡片外壳、
   字段、按钮、输入框、图标全部手写;观感经官方设计令牌变量
   (`--dsw-alias-*` / `--dsw-static-*`)对齐,浅/深色自动跟随主题。
+  **维护提示(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 同款)。
@@ -205,8 +225,9 @@ dsh plugin --profile web remove dsh-auto-open-web   # 同时移除依赖与对
   同理不要引用并不存在的 `--dsw-alias-label-error`(真名是
   `--dsw-alias-state-error-primary`)。这两条已由 `smoke-client-slots.mjs`
   断言守护。
-  仅使用官方公开的数据/机制接口:`settingsScope`(settings 域)、`slots`
-  (插槽)、`locale`(文案)、快照 store(跨版本解析)。
+  仅使用官方公开的数据/机制接口:`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

@@ -4,16 +4,24 @@
 // **不** require @deepseek-ai/dsh-client-ui-primitives 等官方 UI 包。
 //
 // 依赖边界(与官方数据的对接面,均为公开接口):
-//   - settingsScope:官方 settings 域(命名空间 `auto-open-web`)
-//   - slots:**两代插槽各自注册,谁存在谁生效**(都用 slots.inject 挂载,
-//     不存在的插槽只会保持 pending,不会报错):
-//       · dsh ≥0.1.5:插件设置搬到「插件管理」页,bundle 配置槽
-//         `plugins.bundle.config`(按 **bundle 包名** keyed,只渲染 view:'page')
-//       · rc.7–0.1.4:设置页插件配置卡片 `settings.plugin.item`
-//         (按设置命名空间 keyed,label 供列表显示)
+//   支持两条版本线(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,跟随界面语言)
-//   - store:createSnapshotStore 快照 store(解析顺序 dsh-client-store →
-//     dsh-client-runtime → 内置最小实现)
+//   - store:createSnapshotStore 快照 store(dsh-client-store,缺失时内置最小实现)
+//     —— rc.8 时代的 dsh-client-runtime 回退已按兼容策略移除(0.1.2-alpha.2 起
+//     统一为 dsh-client-store)。
 //
 // 视觉(全部自产):
 //   - 卡片外壳、字段、按钮、输入框、复选/单选、徽章、图标均为手写实现;
@@ -103,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
     }
@@ -467,99 +467,56 @@ window.__ModuleLoader__.load({
       }
     }
 
-    // ── 设置表单(同一组件服务两代插槽) ──────────────────────────────────
-    // · 新版 plugins.bundle.config:页面传 view:'page',只出表单本体
-    //   (标题/面包屑/图标由页面自绘),无折叠外壳、无"放弃"按钮,
-    //   离开页面即丢弃暂存编辑 —— 与官方 PluginConfigForm 的约定一致。
-    // · 旧版 settings.plugin.item:无 view,渲染自带折叠外壳的卡片
-    //   (标题/描述/未保存标记/放弃/保存)。
-    function AutoOpenSettingsPage(props) {
-      const { t } = props
-      const state = props.useAutoOpenCard((snapshot) => snapshot)
-      const [picking, setPicking] = React.useState(false)
-      const [testing, setTesting] = React.useState(false)
-      const [testResult, setTestResult] = React.useState(null) // { ok, text } | null
-      const isPage = props.view === 'page'
-      // 新版页面表单:卸载即丢弃暂存编辑(官方同约定);用 ref 持有最新 discard。
-      const discardRef = React.useRef(props.discard)
-      discardRef.current = props.discard
-      React.useEffect(() => () => {
-        if (isPage) discardRef.current()
-      }, [])
-
-      const browse = () => {
-        if (!state.writable || picking) return
-        setPicking(true)
-        fetch('/auto-open-web/pick-browser', { method: 'POST' })
-          .then((response) => response.json())
-          .then((result) => {
-            if (result !== null && result !== undefined && result.ok === true && typeof result.path === 'string') {
-              props.edit('browserPath', result.path)
-            }
-          })
-          .catch(() => { /* 选择失败静默;用户可重试 */ })
-          .then(() => { setPicking(false) })
-      }
-
-      const testBrowser = () => {
-        if (testing) return
-        setTesting(true)
-        setTestResult(null)
-        fetch('/auto-open-web/test-browser', {
-          method: 'POST',
-          headers: { 'content-type': 'application/json' },
-          body: JSON.stringify({ browserPath: state.browserPath.text }),
-        })
-          .then((response) => response.json())
-          .then((result) => {
-            if (result !== null && result !== undefined && result.ok === true) {
-              setTestResult({ ok: true, text: typeof result.message === 'string' ? result.message : t('testOk') })
-            } else {
-              setTestResult({ ok: false, text: t('testFail') + ': ' + (result !== null && result !== undefined && typeof result.error === 'string' ? result.error : 'unknown') })
-            }
-          })
-          .catch((error) => { setTestResult({ ok: false, text: t('testFail') + ': ' + String(error !== null && error !== undefined && error.message !== undefined ? error.message : error) }) })
-          .then(() => { setTesting(false) })
-      }
-
-      const browserDisabled = !state.writable || state.windowKind.text !== 'browser'
-
-      const badgesFor = (field) => React.createElement(FieldBadges, {
+    // ── 两代插槽共用的字段构件 ───────────────────────────────────────────
+    /** 字段规格(两代共用: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: () => props.resetField(field)
+        onReset: () => resetField(field)
       })
-
-      // 插件管理页要一行摘要时(summary 视图;bundle 配置通常只取 page,
-      // 此处按官方卡片同约定兜底)。
-      if (props.view === 'summary') return t('description')
-
-      // ---- 字段(两代插槽共用;key 供列表渲染) ----
-      const fields = [
-        // 独立应用窗口
+    }
+    /**
+     * 四个字段的节点(两代插槽共用同一份 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('appWindow'),
-          control: React.createElement(Checkbox, { checked: state.appWindow.text === true, disabled: !state.writable, onChange: (v) => props.edit('appWindow', v) }, t('appWindowHint'))
+          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('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) => 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(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('browserPath'),
+          badges: badgesFor(t, state, 'browserPath', resetField),
           hint: t('browserPathHint'),
           invalid: state.browserPath.invalid,
           invalidLabel: t('browserPathInvalid'),
@@ -568,54 +525,241 @@ window.__ModuleLoader__.load({
               id: 'auto-open-web-browser-path',
               value: state.browserPath.text,
               placeholder: t('browserPathPlaceholder'),
-              disabled: browserDisabled,
+              disabled: ui.browserDisabled,
               invalid: state.browserPath.invalid,
-              onChange: (text) => props.edit('browserPath', text)
+              onChange: (text) => 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'))
+            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: testResult !== null
-            ? React.createElement('p', { className: testResult.ok ? 'aow-test-ok' : 'aow-test-fail', role: 'status' },
-                (testResult.ok ? '✓ ' : '✗ ') + testResult.text
+          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
         }),
-        // 窗口关闭时退出 DSH(实验性)
         React.createElement(Field, {
           key: 'exitOnWindowClose',
           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'))
+          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)
+        fetch('/auto-open-web/pick-browser', { method: 'POST' })
+          .then((response) => response.json())
+          .then((result) => {
+            if (result !== null && result !== undefined && result.ok === true && typeof result.path === 'string') {
+              edit('browserPath', result.path)
+            }
+          })
+          .catch(() => { /* 选择失败静默;用户可重试 */ })
+          .then(() => { setPicking(false) })
+      }
+      const testBrowser = () => {
+        if (testing) return
+        setTesting(true)
+        setTestResult(null)
+        fetch('/auto-open-web/test-browser', {
+          method: 'POST',
+          headers: { 'content-type': 'application/json' },
+          body: JSON.stringify({ browserPath: state.browserPath.text })
+        })
+          .then((response) => response.json())
+          .then((result) => {
+            if (result !== null && result !== undefined && result.ok === true) {
+              setTestResult({ ok: true, text: typeof result.message === 'string' ? result.message : t('testOk') })
+            } else {
+              setTestResult({ ok: false, text: t('testFail') + ': ' + (result !== null && result !== undefined && typeof result.error === 'string' ? result.error : 'unknown') })
+            }
+          })
+          .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'
+      }
+    }
 
-      // ---- 新版:插件管理页的 bundle 配置表单(view:'page') ----
-      // 页面自绘标题/面包屑,这里只出表单本体:只读提示 + 控件 + 保存
-      // (失败提示),无折叠外壳、无"放弃"按钮(离开页面自动丢弃)。
-      if (isPage) {
-        if (!state.available) {
-          return React.createElement('p', { className: 'aow-hint', role: 'status' }, t('unavailable'))
+    // ── 新版(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
         }
-        const blockedPage = !state.dirty || state.invalid || state.saving
-        return React.createElement('div', null,
-          !state.writable ? React.createElement('p', { className: 'aow-cardReadOnly', role: 'status' }, t('readOnly')) : null,
-          ...fields,
-          React.createElement('div', { className: 'aow-cardFooter' },
-            state.failed ? React.createElement('p', { className: 'aow-cardFailed', role: 'status' }, t('saveFailed')) : null,
-            React.createElement(Btn, { variant: 'primary', disabled: blockedPage, onClick: props.save }, state.saving ? t('saving') : t('save'))
-          )
-        )
+        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',
@@ -628,8 +772,14 @@ window.__ModuleLoader__.load({
 
     // ---- 文案(locale 机制,zh/en/ja/ko/fr/de/ru) ----
     const NS = 'auto-open-web'
-    /** bundle 包名:新版插件管理页按包名路由 bundle 配置,即 plugins.bundle.config 的 key。 */
+    /** 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.',
@@ -802,30 +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)
-      // ── 新版(dsh ≥0.1.5):插件管理页 → bundle 配置槽 ──────────────────
-      // 页面按包名路由(ledger.bundles.has(pkg.name)),故 key 必须是 **bundle 包名**;
-      // 只渲染 view:'page'(标题/图标/面包屑由页面自绘),组件见 AutoOpenSettingsPage。
+      // ── 新版(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: 'plugins.bundle.config', key: BUNDLE_NAME, locale: NS, inject: () => controller.inject() },
-          AutoOpenSettingsPage
+          { name: 'plugins.bundle.config', key: BUNDLE_NAME, locale: NS },
+          (props) => AutoOpenRowForm(Object.assign({}, props, { configForms }))
         )
       )
-      // ── 旧版(rc.7–0.1.4):设置页 → 插件配置卡片 ───────────────────────
-      // 新版已移除该插槽,此处 inject 永不触发(两代互不干扰)。
-      ctx.slots.inject('settings.plugin.item', () =>
-        ctx.slots.register(
-          { name: 'settings.plugin.item', key: 'auto-open-web', label: '自动打开网页', locale: NS, inject: () => controller.inject() },
-          AutoOpenSettingsPage
+      // ── 最新 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.22",
+  "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",
@@ -45,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": {