dsh-structured 0.9.1 → 0.9.2

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.9.2 — 2026-10-24
+
+- 插件详情页配置区：client 注册 `plugins.bundle.config`（键 `dsh-structured`），`theme`/`visual`/`defaultEnabled`/`tailReminder`/`includeSubagents`/`genui` 六字段在 插件板块 → dsh-structured 详情页直接编辑；写入走 configForms 的 `set`（落到 active profile 的 Cordis patch），`writable=false` 时控件只读并提示。
+- 背景：宿主不会从 Config schema 自动生成表单——配置页必须由插件自己的浏览器半侧注册（`dsh-client-ui-plugin-manager` slot 合同的 `plugins.bundle.config`/`plugins.row.config`）。0.8.2 引入 Config 起、直到 0.9.1，插件从未注册配置页，所以详情页一直没有设置项；本次按官方伴生包模式（`whileServed` + `slots.inject`）补齐。
+- 防御：宿主 describe 未服务本命名空间、`react/jsx-runtime`/`dsh-client-ui-primitives` 缺失时静默不出配置页；配置页注入与主题/视觉联动分开挂 child inject，互不影响；headless/CLI 不加载 client 半区。
+- 文档修复：README 安装节三处 `0.7.4.tgz` 过时引用改为通用写法，移除三个「（发布后）」括号，实装实测记录更新为 0.9.1；`.gitignore` 增加 `.v2c/`、`out/`。
+
 ## 0.9.1 — 2026-10-23
 
 - 代码/diff 隔离：` ```diff `/`patch` 代码块、`[data-diff]`/`.md-diff`/GenUI diff 区域不套插件的 code/table chrome；diff 行色与宿主渲染保持原样。代码/diff 回复允许代码块或 diff 卡直接作首块，不强制标题卡。

package/README.md

@@ -27,11 +27,11 @@ node scripts/desktop-check.mjs
 
 `desktop` 由 Electron 独占只影响 **CLI 的 `--profile desktop` 子命令**，不影响插件本身；推荐走插件管理入口，或退出 Desktop 后手工 pnpm（方式二）。
 
-### 方式一：插件市场（发布后）
+### 方式一：插件市场
 
 在 DSH 插件管理里搜索 `dsh-structured` 安装；市场收录后可用。桌面端由应用侧加载 client，不需要浏览器刷新。
 
-### 方式二：npm（发布后）
+### 方式二：npm
 
 ```powershell
 dsh plugin --profile <profile> add dsh-structured
@@ -39,13 +39,13 @@ dsh plugin --profile <profile> add dsh-structured
 
 desktop profile 由 Electron 独占，使用插件管理搜索/安装，不要跑 `--profile desktop`。
 
-### 方式三：GitHub Release（发布后）
+### 方式三：GitHub Release
 
-从 GitHub Releases 下载 `dsh-structured-0.7.4.tgz`，在插件管理里选择本地包；不使用 npm 时，市场 YAML 的 `tarball` 指向该 release。
+从 GitHub Releases 下载最新版的 `dsh-structured-<version>.tgz`（当前 0.9.1），在插件管理里选择本地包；不使用 npm 时，市场 YAML 的 `tarball` 指向该 release。
 
 ### 开发方式：本地 tgz / 手工 pnpm（desktop profile）
 
-本地包只用于开发验证：在 DSH 插件管理里选择 `dsh-structured-0.7.4.tgz`，或 `plugin_manager.install_bundle` 指向该文件。手工 pnpm 方式如下。
+本地包只用于开发验证：在 DSH 插件管理里选择仓库根的 `dsh-structured-<version>.tgz`，或 `plugin_manager.install_bundle` 指向该文件。手工 pnpm 方式如下。
 
 `desktop` profile 由 Electron 独占：**全局 `dsh plugin --profile desktop ...` 会被 CLI 直接拒绝**（`profile "desktop" is managed exclusively by the Electron application`）。不要用那条命令。要先**完全退出 Desktop**，再在 profile 目录里手工 pnpm：
 
@@ -56,7 +56,7 @@ Copy-Item "$dir\pnpm-lock.yaml" "$dir\pnpm-lock.yaml.bak-before-dsh-structured"
 Copy-Item "$dir\cordis.patch.yml" "$dir\cordis.patch.yml.bak-before-dsh-structured"
 
 Set-Location $dir
-$tgz = "dsh-structured-0.7.4.tgz"   # 把 tgz 放到当前目录，或写成实际路径
+$tgz = "dsh-structured-0.9.1.tgz"   # 把 tgz 放到当前目录，或写成实际路径
 pnpm add $tgz
 ```
 
@@ -76,7 +76,7 @@ pnpm add $tgz
 
 - 预检：`node scripts/desktop-check.mjs` 全部 PASS —— desktop profile 已初始化、bundle 栈含 `dsh-base`/`dsh-web-app`、`files` 含 `cordis.patch.yml`、`main`/`exports` 指向存在文件、`dsh.client.platform: web` 与 `exports["./client"]` 就位、`engines.dsh`/`dsh.compatibility.dshReleases` 已声明、运行时只 import `node:`、无 Electron 专有 API、无 profile 分支、状态走 `DSH_HOME`。
 - **desktop 是主目标，Web 只做兼容。** 本会话本身运行在 desktop profile，`systemPrompt` 与 `commands` 由 live host 的 Service 查询确认；`dsh.client.platform: web` 是 DSH 客户端模块的格式（desktop 的 Web UI 也加载它），不代表 Web 优先。
-- desktop 实装实测：`plugin_manager install_bundle` 返回 `applied`（0.7.4），desktop `dependencies`/`bundles` 各一处；当前 desktop 会话最新 `system/message` 命中两段注入。
+- desktop 实装实测：desktop profile 已装 0.9.1（`dependencies`/`bundles` 各一处，见 `docs/MAINTENANCE-LOG.md` 2026-10-23 条目）；desktop 会话最新 `system/message` 命中注入（可用 `scripts/session-inspect.mjs` 复跑）。
 - 视觉层由 desktop 应用侧加载，验收以应用内实际渲染为准；不要求用户手动刷新。
 
 ### 兼容性门禁
@@ -125,11 +125,28 @@ Phase 2 已落地 2.1–2.4：卡片类型（结论/判断/指标/风险/下一
 
 ![窄窗](assets/screenshots/08-narrow.png)
 
-`screenshots.json` 列出全部 4 张，覆盖标题卡、表格 + 表格结论、状态列、代码块与 800px 窄窗；GenUI 截图因避免暴露工作区未收录。
+![三套主题·浅色](assets/screenshots/09-theme-light.png)
+
+![三套主题·暗色](assets/screenshots/10-theme-dark.png)
+
+`screenshots.json` 列出全部 6 张：前 4 张是实机裁图，覆盖标题卡、表格 + 表格结论、状态列、代码块与 800px 窄窗；后 2 张是按 0.9.1 实际 token 渲染的主题对照图，用于看 accent/surface/status，**不是桌面实机截图**。GenUI 截图因避免暴露工作区未收录。
 
 ### 配置
 
-在 profile 的 `cordis.patch.yml` 里覆盖同一行（注意：config 是整份替换，不是深合并）：
+**首选：插件板块 → dsh-structured → 详情页的配置区**（0.9.2 起）。插件自己的浏览器半侧把六个字段注册进宿主 `plugins.bundle.config` slot，改完立即写入 active profile 的 Cordis patch：
+
+```text
+主题 / Theme           deepseek | codex | anthropic
+视觉层 / Visual layer   开关
+新会话默认开启           开关
+尾部提醒 / Tail reminder 开关
+子代理注入 / Subagents   开关
+GenUI 联动              auto | on | off
+```
+
+宿主 describe 未服务本插件、或部署缺少前端 primitives 时，配置区自动隐藏（此时用下面的 patch 方式）。会话级开关不在这里：用 `/structured on | off`。
+
+底层方式：在 profile 的 `cordis.patch.yml` 里覆盖同一行（注意：config 是整份替换，不是深合并）：
 
 ```yaml
 - id: dsh-structured
@@ -142,7 +159,7 @@ Phase 2 已落地 2.1–2.4：卡片类型（结论/判断/指标/风险/下一
     genui: auto            # auto | on | off；auto 检测到 GenUI 才追加 dsh-ui 路由
 ```
 
-`theme`、`visual`、`defaultEnabled`、`tailReminder`、`includeSubagents`、`genui` 都是 `.volatile()` 配置，插件设置页（bundle 详情表单）可编辑；写入走 active profile 的 Cordis patch，home patch / CLI overlay 优先。若表单快照的 `writable` 为 false，说明当前配置被上层覆盖，设置页不会静默写入成功；请改上层配置或接受只读。`/structured on|off` 只影响 `state.json` 里的按会话提示词开关，不影响 `theme`/`visual`。
+`theme`、`visual`、`defaultEnabled`、`tailReminder`、`includeSubagents`、`genui` 都是 `.volatile()` 配置：插件板块详情页的配置区（0.9.2 起，见上）与标准 bundle 表单都可编辑，写入走 active profile 的 Cordis patch，home patch / CLI overlay 优先。若快照的 `writable` 为 false，说明当前配置被上层覆盖，配置区控件只读并提示，不会静默写入成功；请改上层配置或接受只读。`/structured on|off` 只影响 `state.json` 里的按会话提示词开关，不影响 `theme`/`visual`。
 
 ## 验证注入生效
 

package/lib/client.js

@@ -12,7 +12,7 @@
  */
 window.__ModuleLoader__.load({
   id: 'dsh-structured',
-  factory() {
+  factory(require) {
     const CARD_ATTR = 'data-dsh-structured-card'
     const CARD_TYPE_ATTR = 'data-dsh-structured-card-type'
     const ICON_ATTR = 'data-dsh-structured-icon'
@@ -30,6 +30,20 @@ window.__ModuleLoader__.load({
     const STYLE_ID = 'dsh-structured-skin-style'
     const LEGACY_STYLE_ID = 'dsh-structured-card-style'
 
+    /** 配置页常量：宿主插件详情页的 bundle 配置 slot（键 = 包名）。 */
+    const CONFIG_NS = 'dsh-structured'
+    const BUNDLE_CONFIG_SLOT = 'plugins.bundle.config'
+
+    /** 六个配置字段的界面文案；field 与 host Config schema 对齐，fallback 为 schema 默认值。 */
+    const CONFIG_FIELDS = [
+      { field: 'theme', kind: 'segmented', fallback: 'deepseek', label: '主题 / Theme', hint: '回复区配色，改完立即生效', options: [['deepseek', 'DeepSeek'], ['codex', 'Codex'], ['anthropic', 'Anthropic']] },
+      { field: 'visual', kind: 'switch', fallback: true, label: '视觉层 / Visual layer', hint: '关闭后不加载回复区样式（标题卡、表格、代码块皮肤）' },
+      { field: 'defaultEnabled', kind: 'switch', fallback: true, label: '新会话默认开启 / Default on', hint: '新会话默认注入结构化提示词' },
+      { field: 'tailReminder', kind: 'switch', fallback: true, label: '尾部提醒 / Tail reminder', hint: '在 system prompt 末尾追加一句结构化提醒' },
+      { field: 'includeSubagents', kind: 'switch', fallback: false, label: '子代理注入 / Subagents', hint: '子代理会话也注入（其产出不直接面向用户）' },
+      { field: 'genui', kind: 'segmented', fallback: 'auto', label: 'GenUI 联动 / GenUI routing', hint: 'auto：检测到 dsh-genui 才追加 dsh-ui 路由规则', options: [['auto', 'auto'], ['on', 'on'], ['off', 'off']] },
+    ]
+
     const CARD_TYPES = new Map([
       ['结论', 'conclusion'], ['总结', 'conclusion'], ['答案', 'conclusion'],
       ['判断', 'decision'], ['决策', 'decision'],
@@ -454,6 +468,115 @@ body[data-ds-dark-theme][data-dsh-structured-theme="anthropic"] [class*="_markdo
       }
     }
 
+    /**
+     * 在插件板块的插件详情页注册配置区（plugins.bundle.config，键 = 包名）。
+     * 宿主不会从 Config schema 自动生成表单——配置页必须由插件自己的浏览器半侧注册；
+     * 宿主 describe 未服务本命名空间（whileServed 不触发）或 primitives 缺失时不出配置页，
+     * 且任何失败都不影响视觉层与消息渲染。
+     */
+    function setupConfigPage(child, form) {
+      if (typeof require !== 'function') return
+      if (typeof child?.configForms?.whileServed !== 'function') return
+      if (typeof child?.slots?.inject !== 'function' || typeof child?.slots?.register !== 'function') return
+      if (typeof form?.set !== 'function') return
+      let jsx
+      let jsxs
+      let ui
+      try {
+        const runtime = require('react/jsx-runtime')
+        jsx = runtime.jsx
+        jsxs = runtime.jsxs
+        ui = require('@deepseek-ai/dsh-client-ui-primitives')
+        if (typeof ui?.Switch !== 'function' || typeof ui?.SegmentedControl !== 'function') return
+      } catch {
+        // primitives 不可用（非 desktop 表层）：不出配置页。
+        return
+      }
+
+      const labelStyle = { fontSize: '14px', lineHeight: '20px', color: 'var(--dsw-alias-label-primary, inherit)' }
+      const hintStyle = { fontSize: '12.5px', lineHeight: '18px', color: 'var(--dsw-alias-label-tertiary, inherit)', marginTop: '2px' }
+      const rowStyle = { display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: '16px', padding: '10px 0', borderBottom: '1px solid var(--dsw-alias-border-l2, rgba(127,127,127,.18))' }
+      const noteStyle = { fontSize: '12.5px', lineHeight: '18px', color: 'var(--dsw-alias-label-tertiary, inherit)', margin: '6px 0 2px' }
+
+      const fieldValue = (value, spec) => {
+        const raw = value?.[spec.field]
+        if (raw && typeof raw.get === 'function') return raw.get()
+        return raw === undefined || raw === null ? spec.fallback : raw
+      }
+
+      const renderRow = (state, setField, spec) => {
+        const writable = state.writable !== false
+        const control = spec.kind === 'switch'
+          ? jsx(ui.Switch, {
+              checked: fieldValue(state.value, spec) === true,
+              disabled: !writable,
+              label: spec.label,
+              onChange: (next) => setField(spec.field, next === true),
+            })
+          : jsx(ui.SegmentedControl, {
+              id: 'dsh-structured-' + spec.field,
+              value: String(fieldValue(state.value, spec)),
+              options: spec.options.map(([value, text]) => ({ value, label: text })),
+              disabled: !writable,
+              label: spec.label,
+              onChange: (next) => setField(spec.field, next),
+            })
+        return jsxs('div', {
+          style: rowStyle,
+          children: [
+            jsxs('div', { style: { minWidth: 0 }, children: [
+              jsx('div', { style: labelStyle, children: spec.label }),
+              jsx('div', { style: hintStyle, children: spec.hint }),
+            ] }),
+            control,
+          ],
+        })
+      }
+
+      const StructuredConfigCard = (props) => {
+        if (props.view !== undefined && props.view !== 'page') return null
+        const read = props.useStructuredConfig ?? props.structuredConfig
+        const state = typeof read === 'function' ? read((snapshot) => snapshot) : null
+        if (!state || state.status !== 'ready' || typeof state.value !== 'object' || state.value === null) {
+          return jsx('p', { style: noteStyle, children: '插件未加载或配置暂不可用。' })
+        }
+        const setField = typeof props.setField === 'function' ? props.setField : () => {}
+        return jsxs('div', {
+          'data-dsh-structured-config': '1',
+          children: [
+            state.writable === false
+              ? jsx('p', { style: noteStyle, children: '当前配置被更高层覆盖（home patch / CLI overlay），此处只读。' })
+              : null,
+            jsx('div', { children: CONFIG_FIELDS.map((spec) => renderRow(state, setField, spec)) }),
+            jsx('p', { style: noteStyle, children: '会话级开关请用 /structured on | off（按会话生效，不写入这里）。' }),
+          ],
+        })
+      }
+
+      child.effect?.(
+        () =>
+          child.configForms.whileServed([CONFIG_NS], () =>
+            child.slots.inject(BUNDLE_CONFIG_SLOT, () =>
+              child.slots.register({
+                name: BUNDLE_CONFIG_SLOT,
+                key: 'dsh-structured',
+                inject: () => ({
+                  hooks: { structuredConfig: form },
+                  setField: (field, value) => {
+                    try {
+                      form.set(field, value)
+                    } catch {
+                      // 写入失败不打断页面；快照未变化即用户可见的反馈。
+                    }
+                  },
+                }),
+              }, StructuredConfigCard),
+            ),
+          ),
+        'dsh-structured: bundle config page',
+      )
+    }
+
     let active = false
     let disposeLayer = null
     let currentTheme = 'deepseek'
@@ -548,7 +671,7 @@ body[data-ds-dark-theme][data-dsh-structured-theme="anthropic"] [class*="_markdo
 
     return {
       inject: [],
-      __test: { inDiff, isDiffCode, decorate },
+      __test: { inDiff, isDiffCode, decorate, setupConfigPage },
       apply(ctx) {
         // 默认主题/视觉先启用；随后由 profile Config 的 theme/visual 覆盖。
         enable()
@@ -578,6 +701,19 @@ body[data-ds-dark-theme][data-dsh-structured-theme="anthropic"] [class*="_markdo
         } catch {
           // 无 ctx.inject 的宿主保持默认开启。
         }
+        try {
+          // 插件详情页配置区与视觉层分开注入：配置页失败不影响主题/视觉联动。
+          ctx?.inject?.(['configForms', 'slots'], (child) => {
+            try {
+              const form = child.configForms?.get('dsh-structured')
+              if (form) setupConfigPage(child, form)
+            } catch {
+              // 配置页不可用不影响视觉层与注入。
+            }
+          })
+        } catch {
+          // 无 ctx.inject 的宿主没有配置页，视觉层照常。
+        }
         try {
           ctx?.effect?.(() => disable, 'dsh-structured: visual layer')
         } catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-structured",
-  "version": "0.9.1",
+  "version": "0.9.2",
   "description": "Structured output for DSH: no-label title card first, then tables/lists/steps; per-session switch and style.md override. 让 DSH 的每条实质回复默认结构化。",
   "type": "module",
   "main": "lib/index.js",

package/screenshots.json

@@ -2,5 +2,7 @@
   "assets/screenshots/01-title-card.png",
   "assets/screenshots/06-status-table.png",
   "assets/screenshots/07-code-block.png",
-  "assets/screenshots/08-narrow.png"
+  "assets/screenshots/08-narrow.png",
+  "assets/screenshots/09-theme-light.png",
+  "assets/screenshots/10-theme-dark.png"
 ]

package/src/client.js

@@ -10,7 +10,7 @@
  */
 window.__ModuleLoader__.load({
   id: 'dsh-structured',
-  factory() {
+  factory(require) {
     const CARD_ATTR = 'data-dsh-structured-card'
     const CARD_TYPE_ATTR = 'data-dsh-structured-card-type'
     const ICON_ATTR = 'data-dsh-structured-icon'
@@ -28,6 +28,20 @@ window.__ModuleLoader__.load({
     const STYLE_ID = 'dsh-structured-skin-style'
     const LEGACY_STYLE_ID = 'dsh-structured-card-style'
 
+    /** 配置页常量：宿主插件详情页的 bundle 配置 slot（键 = 包名）。 */
+    const CONFIG_NS = 'dsh-structured'
+    const BUNDLE_CONFIG_SLOT = 'plugins.bundle.config'
+
+    /** 六个配置字段的界面文案；field 与 host Config schema 对齐，fallback 为 schema 默认值。 */
+    const CONFIG_FIELDS = [
+      { field: 'theme', kind: 'segmented', fallback: 'deepseek', label: '主题 / Theme', hint: '回复区配色，改完立即生效', options: [['deepseek', 'DeepSeek'], ['codex', 'Codex'], ['anthropic', 'Anthropic']] },
+      { field: 'visual', kind: 'switch', fallback: true, label: '视觉层 / Visual layer', hint: '关闭后不加载回复区样式（标题卡、表格、代码块皮肤）' },
+      { field: 'defaultEnabled', kind: 'switch', fallback: true, label: '新会话默认开启 / Default on', hint: '新会话默认注入结构化提示词' },
+      { field: 'tailReminder', kind: 'switch', fallback: true, label: '尾部提醒 / Tail reminder', hint: '在 system prompt 末尾追加一句结构化提醒' },
+      { field: 'includeSubagents', kind: 'switch', fallback: false, label: '子代理注入 / Subagents', hint: '子代理会话也注入（其产出不直接面向用户）' },
+      { field: 'genui', kind: 'segmented', fallback: 'auto', label: 'GenUI 联动 / GenUI routing', hint: 'auto：检测到 dsh-genui 才追加 dsh-ui 路由规则', options: [['auto', 'auto'], ['on', 'on'], ['off', 'off']] },
+    ]
+
     const CARD_TYPES = new Map([
       ['结论', 'conclusion'], ['总结', 'conclusion'], ['答案', 'conclusion'],
       ['判断', 'decision'], ['决策', 'decision'],
@@ -452,6 +466,115 @@ body[data-ds-dark-theme][data-dsh-structured-theme="anthropic"] [class*="_markdo
       }
     }
 
+    /**
+     * 在插件板块的插件详情页注册配置区（plugins.bundle.config，键 = 包名）。
+     * 宿主不会从 Config schema 自动生成表单——配置页必须由插件自己的浏览器半侧注册；
+     * 宿主 describe 未服务本命名空间（whileServed 不触发）或 primitives 缺失时不出配置页，
+     * 且任何失败都不影响视觉层与消息渲染。
+     */
+    function setupConfigPage(child, form) {
+      if (typeof require !== 'function') return
+      if (typeof child?.configForms?.whileServed !== 'function') return
+      if (typeof child?.slots?.inject !== 'function' || typeof child?.slots?.register !== 'function') return
+      if (typeof form?.set !== 'function') return
+      let jsx
+      let jsxs
+      let ui
+      try {
+        const runtime = require('react/jsx-runtime')
+        jsx = runtime.jsx
+        jsxs = runtime.jsxs
+        ui = require('@deepseek-ai/dsh-client-ui-primitives')
+        if (typeof ui?.Switch !== 'function' || typeof ui?.SegmentedControl !== 'function') return
+      } catch {
+        // primitives 不可用（非 desktop 表层）：不出配置页。
+        return
+      }
+
+      const labelStyle = { fontSize: '14px', lineHeight: '20px', color: 'var(--dsw-alias-label-primary, inherit)' }
+      const hintStyle = { fontSize: '12.5px', lineHeight: '18px', color: 'var(--dsw-alias-label-tertiary, inherit)', marginTop: '2px' }
+      const rowStyle = { display: 'flex', alignItems: 'center', justifyContent: 'space-between', gap: '16px', padding: '10px 0', borderBottom: '1px solid var(--dsw-alias-border-l2, rgba(127,127,127,.18))' }
+      const noteStyle = { fontSize: '12.5px', lineHeight: '18px', color: 'var(--dsw-alias-label-tertiary, inherit)', margin: '6px 0 2px' }
+
+      const fieldValue = (value, spec) => {
+        const raw = value?.[spec.field]
+        if (raw && typeof raw.get === 'function') return raw.get()
+        return raw === undefined || raw === null ? spec.fallback : raw
+      }
+
+      const renderRow = (state, setField, spec) => {
+        const writable = state.writable !== false
+        const control = spec.kind === 'switch'
+          ? jsx(ui.Switch, {
+              checked: fieldValue(state.value, spec) === true,
+              disabled: !writable,
+              label: spec.label,
+              onChange: (next) => setField(spec.field, next === true),
+            })
+          : jsx(ui.SegmentedControl, {
+              id: 'dsh-structured-' + spec.field,
+              value: String(fieldValue(state.value, spec)),
+              options: spec.options.map(([value, text]) => ({ value, label: text })),
+              disabled: !writable,
+              label: spec.label,
+              onChange: (next) => setField(spec.field, next),
+            })
+        return jsxs('div', {
+          style: rowStyle,
+          children: [
+            jsxs('div', { style: { minWidth: 0 }, children: [
+              jsx('div', { style: labelStyle, children: spec.label }),
+              jsx('div', { style: hintStyle, children: spec.hint }),
+            ] }),
+            control,
+          ],
+        })
+      }
+
+      const StructuredConfigCard = (props) => {
+        if (props.view !== undefined && props.view !== 'page') return null
+        const read = props.useStructuredConfig ?? props.structuredConfig
+        const state = typeof read === 'function' ? read((snapshot) => snapshot) : null
+        if (!state || state.status !== 'ready' || typeof state.value !== 'object' || state.value === null) {
+          return jsx('p', { style: noteStyle, children: '插件未加载或配置暂不可用。' })
+        }
+        const setField = typeof props.setField === 'function' ? props.setField : () => {}
+        return jsxs('div', {
+          'data-dsh-structured-config': '1',
+          children: [
+            state.writable === false
+              ? jsx('p', { style: noteStyle, children: '当前配置被更高层覆盖（home patch / CLI overlay），此处只读。' })
+              : null,
+            jsx('div', { children: CONFIG_FIELDS.map((spec) => renderRow(state, setField, spec)) }),
+            jsx('p', { style: noteStyle, children: '会话级开关请用 /structured on | off（按会话生效，不写入这里）。' }),
+          ],
+        })
+      }
+
+      child.effect?.(
+        () =>
+          child.configForms.whileServed([CONFIG_NS], () =>
+            child.slots.inject(BUNDLE_CONFIG_SLOT, () =>
+              child.slots.register({
+                name: BUNDLE_CONFIG_SLOT,
+                key: 'dsh-structured',
+                inject: () => ({
+                  hooks: { structuredConfig: form },
+                  setField: (field, value) => {
+                    try {
+                      form.set(field, value)
+                    } catch {
+                      // 写入失败不打断页面；快照未变化即用户可见的反馈。
+                    }
+                  },
+                }),
+              }, StructuredConfigCard),
+            ),
+          ),
+        'dsh-structured: bundle config page',
+      )
+    }
+
     let active = false
     let disposeLayer = null
     let currentTheme = 'deepseek'
@@ -546,7 +669,7 @@ body[data-ds-dark-theme][data-dsh-structured-theme="anthropic"] [class*="_markdo
 
     return {
       inject: [],
-      __test: { inDiff, isDiffCode, decorate },
+      __test: { inDiff, isDiffCode, decorate, setupConfigPage },
       apply(ctx) {
         // 默认主题/视觉先启用；随后由 profile Config 的 theme/visual 覆盖。
         enable()
@@ -576,6 +699,19 @@ body[data-ds-dark-theme][data-dsh-structured-theme="anthropic"] [class*="_markdo
         } catch {
           // 无 ctx.inject 的宿主保持默认开启。
         }
+        try {
+          // 插件详情页配置区与视觉层分开注入：配置页失败不影响主题/视觉联动。
+          ctx?.inject?.(['configForms', 'slots'], (child) => {
+            try {
+              const form = child.configForms?.get('dsh-structured')
+              if (form) setupConfigPage(child, form)
+            } catch {
+              // 配置页不可用不影响视觉层与注入。
+            }
+          })
+        } catch {
+          // 无 ctx.inject 的宿主没有配置页，视觉层照常。
+        }
         try {
           ctx?.effect?.(() => disable, 'dsh-structured: visual layer')
         } catch {

package/test/client-config-page.test.mjs

@@ -0,0 +1,273 @@
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import test from 'node:test'
+import vm from 'node:vm'
+
+// 插件板块详情页配置区：宿主不会从 Config schema 自动生成表单，
+// 配置页必须由插件 client 注册进 plugins.bundle.config（键 = 包名）。
+// 本文件验证：注册条件、slot 键、注入面、卡片渲染与字段控件。
+
+function makeDom() {
+  const element = () => ({
+    children: [],
+    appendChild() {},
+    remove() {},
+    setAttribute() {},
+    removeAttribute() {},
+    querySelectorAll() {
+      return []
+    },
+    closest() {
+      return null
+    },
+  })
+  return {
+    body: element(),
+    documentElement: { setAttribute() {}, removeAttribute() {} },
+    head: { children: [], appendChild() {} },
+    createElement: () => element(),
+    getElementById: () => null,
+    querySelectorAll: () => [],
+  }
+}
+
+function fakeRuntime() {
+  const node = (type, props) => ({ type, props })
+  return {
+    require(spec) {
+      if (spec === 'react/jsx-runtime') {
+        return { jsx: (type, props) => node(type, props), jsxs: (type, props) => node(type, props) }
+      }
+      if (spec === '@deepseek-ai/dsh-client-ui-primitives') {
+        return {
+          Switch: function Switch(props) {
+            return { type: Switch, props }
+          },
+          SegmentedControl: function SegmentedControl(props) {
+            return { type: SegmentedControl, props }
+          },
+        }
+      }
+      throw new Error('unexpected require: ' + spec)
+    },
+    node,
+  }
+}
+
+function loadClient(dom, fakeRequire) {
+  const code = readFileSync(new URL('../src/client.js', import.meta.url), 'utf8')
+  let module = null
+  const window = {
+    __ModuleLoader__: {
+      load(definition) {
+        module = definition.factory(fakeRequire)
+      },
+    },
+  }
+  vm.runInNewContext(code, {
+    window,
+    document: dom,
+    MutationObserver: class {
+      observe() {}
+      disconnect() {}
+    },
+    requestAnimationFrame: (fn) => fn(),
+    cancelAnimationFrame() {},
+    setTimeout: (fn) => fn(),
+    clearTimeout() {},
+    console: { info() {}, warn() {}, error() {} },
+  }, { filename: 'src/client.js' })
+  assert.ok(module, 'client module should register')
+  return module
+}
+
+function makeChild(form, slots) {
+  return {
+    configForms: {
+      get(id) {
+        return id === 'dsh-structured' ? form : undefined
+      },
+      whileServed(namespaces, register) {
+        if (served) register()
+        return () => {}
+      },
+    },
+    slots,
+    effect(fn) {
+      return fn()
+    },
+  }
+}
+
+let served = true
+
+function collectRegistration() {
+  let registered = null
+  const slots = {
+    inject(name, factory) {
+      assert.equal(name, 'plugins.bundle.config')
+      factory()
+    },
+    register(options, component) {
+      registered = { options, component }
+      return () => {}
+    },
+  }
+  return { slots, get: () => registered }
+}
+
+test('config page：宿主服务 describe 命名空间时注册 bundle 配置页', () => {
+  served = true
+  const { require: fakeRequire } = fakeRuntime()
+  const module = loadClient(makeDom(), fakeRequire)
+  const snapshot = { status: 'ready', writable: true, value: { theme: 'deepseek' } }
+  const form = {
+    setCalls: [],
+    set(field, value) {
+      this.setCalls.push([field, value])
+      return Promise.resolve(true)
+    },
+    getSnapshot() {
+      return snapshot
+    },
+    subscribe() {
+      return () => {}
+    },
+  }
+  const { slots, get } = collectRegistration()
+  module.__test.setupConfigPage(makeChild(form, slots), form)
+
+  const registration = get()
+  assert.ok(registration, 'should register into plugins.bundle.config')
+  assert.equal(registration.options.name, 'plugins.bundle.config')
+  assert.equal(registration.options.key, 'dsh-structured')
+
+  const face = registration.options.inject()
+  assert.equal(face.hooks.structuredConfig, form)
+  assert.equal(typeof face.setField, 'function')
+  face.setField('visual', false)
+  assert.deepEqual(form.setCalls[0], ['visual', false])
+})
+
+test('config page：describe 未服务命名空间时不注册', () => {
+  served = false
+  const { require: fakeRequire } = fakeRuntime()
+  const module = loadClient(makeDom(), fakeRequire)
+  const form = { getSnapshot() { return null }, subscribe() { return () => {} } }
+  const { slots, get } = collectRegistration()
+  module.__test.setupConfigPage(makeChild(form, slots), form)
+  assert.equal(get(), null)
+  served = true
+})
+
+test('config page：primitives 或 require 缺失时静默跳过', () => {
+  const module = loadClient(makeDom(), undefined)
+  const form = { getSnapshot() { return null }, subscribe() { return () => {} } }
+  const { slots, get } = collectRegistration()
+  module.__test.setupConfigPage(makeChild(form, slots), form)
+  assert.equal(get(), null)
+})
+
+test('config page：卡片渲染六字段，switch/segmented 值来自快照', () => {
+  served = true
+  const { require: fakeRequire, node } = fakeRuntime()
+  const module = loadClient(makeDom(), fakeRequire)
+  const snapshot = {
+    status: 'ready',
+    writable: true,
+    value: {
+      theme: 'codex',
+      visual: false,
+      defaultEnabled: true,
+      tailReminder: true,
+      includeSubagents: false,
+      genui: 'auto',
+    },
+  }
+  const form = {
+    set() {
+      return Promise.resolve(true)
+    },
+    getSnapshot() {
+      return snapshot
+    },
+    subscribe() {
+      return () => {}
+    },
+  }
+  const { slots, get } = collectRegistration()
+  module.__test.setupConfigPage(makeChild(form, slots), form)
+  const { component } = get()
+
+  const tree = component({
+    view: 'page',
+    useStructuredConfig: (selector) => selector(snapshot),
+    setField: () => {},
+  })
+  assert.equal(tree.props['data-dsh-structured-config'], '1')
+
+  const flat = []
+  const walk = (value) => {
+    if (!value || typeof value !== 'object') return
+    flat.push(value)
+    if (Array.isArray(value.props?.children)) value.props.children.forEach((child) => walk(child))
+    else walk(value.props?.children)
+  }
+  walk(tree)
+
+  const switches = flat.filter((element) => element.type?.name === 'Switch')
+  const segmented = flat.filter((element) => element.type?.name === 'SegmentedControl')
+  assert.equal(switches.length, 4)
+  assert.equal(segmented.length, 2)
+
+  const visual = switches.find((element) => element.props.label.includes('视觉层'))
+  assert.equal(visual.props.checked, false)
+  const includeSubagents = switches.find((element) => element.props.label.includes('子代理'))
+  assert.equal(includeSubagents.props.checked, false)
+  const theme = segmented.find((element) => element.props.id === 'dsh-structured-theme')
+  assert.equal(theme.props.value, 'codex')
+  // 卡片在 vm 沙箱里构建：数组跨 realm，序列化后比较。
+  assert.equal(JSON.stringify(theme.props.options.map((option) => option.value)), JSON.stringify(['deepseek', 'codex', 'anthropic']))
+  const genui = segmented.find((element) => element.props.id === 'dsh-structured-genui')
+  assert.equal(genui.props.value, 'auto')
+})
+
+test('config page：插件未就绪与只读态的降级渲染', () => {
+  served = true
+  const { require: fakeRequire } = fakeRuntime()
+  const module = loadClient(makeDom(), fakeRequire)
+  const form = {
+    set() {
+      return Promise.resolve(true)
+    },
+    getSnapshot() {
+      return null
+    },
+    subscribe() {
+      return () => {}
+    },
+  }
+  const { slots, get } = collectRegistration()
+  module.__test.setupConfigPage(makeChild(form, slots), form)
+  const { component } = get()
+
+  const unavailable = component({ view: 'page', useStructuredConfig: (selector) => selector({ status: 'unavailable' }) })
+  assert.match(String(unavailable.props.children), /暂不可用/)
+
+  const readonly = component({
+    view: 'page',
+    useStructuredConfig: (selector) => selector({ status: 'ready', writable: false, value: { theme: 'deepseek' } }),
+    setField: () => {},
+  })
+  const flat = []
+  const walk = (value) => {
+    if (!value || typeof value !== 'object') return
+    flat.push(value)
+    if (Array.isArray(value.props?.children)) value.props.children.forEach((child) => walk(child))
+    else walk(value.props?.children)
+  }
+  walk(readonly)
+  const switches = flat.filter((element) => element.type?.name === 'Switch')
+  assert.equal(switches.length, 4)
+  for (const element of switches) assert.equal(element.props.disabled, true)
+})