dsh-structured 0.7.4 → 0.8.2

package/lib/client.js

@@ -26,15 +26,15 @@ window.__ModuleLoader__.load({
     const STYLE_ID = 'dsh-structured-skin-style'
     const LEGACY_STYLE_ID = 'dsh-structured-card-style'
 
-    const CARD_TYPES = [
-      [/^结论|^总结|^答案/, 'conclusion'],
-      [/^判断|^决策/, 'decision'],
-      [/^指标|^数据/, 'metric'],
-      [/^风险|^注意|^警告/, 'risk'],
-      [/^下一步|^行动|^待办/, 'next'],
-      [/^验收|^通过|^完成/, 'accept'],
-      [/^重点|^关键/, 'key'],
-    ]
+    const CARD_TYPES = new Map([
+      ['结论', 'conclusion'], ['总结', 'conclusion'], ['答案', 'conclusion'],
+      ['判断', 'decision'], ['决策', 'decision'],
+      ['指标', 'metric'], ['数据', 'metric'],
+      ['风险', 'risk'], ['注意', 'risk'], ['警告', 'risk'],
+      ['下一步', 'next'], ['行动', 'next'], ['待办', 'next'],
+      ['验收', 'accept'], ['通过', 'accept'], ['完成', 'accept'],
+      ['重点', 'key'], ['关键', 'key'],
+    ])
     const ICONS = [
       [/结论|总结|答案|判断/, '◆'],
       [/方案|计划|步骤|流程/, '▸'],
@@ -45,13 +45,6 @@ window.__ModuleLoader__.load({
       [/背景|原因|根因/, '◎'],
       [/指标|数据|结果/, '▦'],
     ]
-    const TONES = [
-      [/风险|注意|警告|坑/, 'warn'],
-      [/验收|通过|成功/, 'success'],
-      [/重点|关键|核心/, 'info'],
-      [/下一步|行动|待办/, 'info'],
-      [/结论|判断|答案/, 'info'],
-    ]
 
     const CSS = `
 [class*="_markdown_"]{
@@ -174,19 +167,6 @@ window.__ModuleLoader__.load({
   margin:14px 0;padding:10px 14px;border-left:3px solid var(--ds-accent);
   background:color-mix(in srgb,var(--ds-accent) 6%,transparent);border-radius:0 10px 10px 0;
 }
-[class*="_markdown_"] blockquote[${LEAD_ATTR}="lead"]{
-  position:relative;border-left:4px solid var(--ds-accent);border-radius:12px;
-  padding:14px 16px 14px 38px;
-  background:linear-gradient(135deg,color-mix(in srgb,var(--ds-accent) 7%,var(--ds-surface)),var(--ds-surface) 62%);
-  box-shadow:0 1px 2px rgba(0,0,0,.04),0 12px 32px -24px color-mix(in srgb,var(--ds-accent) 32%,transparent);
-}
-[class*="_markdown_"] blockquote[${LEAD_ATTR}="lead"]::before{
-  content:"◆";position:absolute;left:14px;top:15px;
-  color:var(--ds-accent);font-size:13px;line-height:1;
-}
-[class*="_markdown_"] blockquote[${LEAD_ATTR}="lead"]>p:first-child{
-  margin-top:0;font-size:16.5px;line-height:1.6;font-weight:600;color:var(--ds-text);
-}
 [class*="_markdown_"] blockquote[${TONE_ATTR}="warn"]{--ds-accent:var(--dsw-alias-state-warn-primary,#d97706)}
 [class*="_markdown_"] blockquote[${TONE_ATTR}="success"]{--ds-accent:var(--dsw-alias-state-success-primary,#16a34a)}
 [class*="_markdown_"] blockquote[${CARD_ATTR}="1"]{
@@ -275,9 +255,24 @@ window.__ModuleLoader__.load({
       return null
     }
 
-    function cardTypeFor(text) {
-      for (const [pattern, type] of CARD_TYPES) if (pattern.test(text)) return type
-      return null
+    function firstParagraph(block) {
+      return [...(block.children ?? [])].find((element) => element.tagName === 'P') ?? null
+    }
+
+    function labelOf(block) {
+      const first = firstParagraph(block)
+      const strong = first?.firstElementChild
+      if (!strong || strong.tagName !== 'STRONG') return null
+      return (strong.textContent ?? '').replace(/[：:]\s*$/u, '').trim()
+    }
+
+    function cardTypeFor(block) {
+      const label = labelOf(block)
+      return label === null ? null : (CARD_TYPES.get(label) ?? null)
+    }
+
+    function isLabelLike(text) {
+      return [...CARD_TYPES.keys()].some((label) => text.startsWith(label) && text !== label)
     }
 
     function inGenui(element) {
@@ -288,11 +283,6 @@ window.__ModuleLoader__.load({
       }
     }
 
-    function toneFor(text) {
-      for (const [pattern, tone] of TONES) if (pattern.test(text)) return tone
-      return null
-    }
-
     function statusFor(text) {
       if (/^✅/.test(text)) return 'success'
       if (/^⚠/.test(text)) return 'warn'
@@ -300,24 +290,27 @@ window.__ModuleLoader__.load({
       return null
     }
 
-    function isFirstBlockquote(block) {
-      const markdown = block.closest?.('[class*="_markdown_"]')
-      return Boolean(markdown && markdown.querySelector('blockquote') === block)
-    }
-
     function isStatementCard(block) {
       const markdown = block.closest?.('[class*="_markdown_"]')
-      if (!markdown || markdown.querySelector('blockquote') !== block) return false
+      if (!markdown) return false
+      const first = [...markdown.querySelectorAll('blockquote')].find((element) => !inGenui(element))
+      if (first !== block) return false
       const paragraphs = [...block.children].filter((element) => element.tagName === 'P')
-      if (paragraphs.length < 2) {
-        const first = paragraphs[0]
-        const strong = first?.firstElementChild
-        if (!strong || strong.tagName !== 'STRONG') return false
-        const rest = first.textContent.slice(strong.textContent.length).trim()
-        return rest.length > 0 || Boolean(first.querySelector('br'))
+      const firstParagraph = paragraphs[0]
+      const strong = firstParagraph?.firstElementChild
+      if (!strong || strong.tagName !== 'STRONG') return false
+      let previous = strong.previousSibling
+      while (previous) {
+        if (previous.nodeType === 1) return false
+        if (previous.nodeType === 3 && (previous.textContent ?? '').trim() !== '') return false
+        previous = previous.previousSibling
       }
-      const first = paragraphs[0]
-      return Boolean(first?.firstElementChild && first.firstElementChild.tagName === 'STRONG')
+      const title = (strong.textContent ?? '').trim()
+      if (title.length === 0 || isLabelLike(title)) return false
+      let rest = ''
+      for (let node = strong.nextSibling; node; node = node.nextSibling) rest += node.textContent ?? ''
+      const secondBody = paragraphs.slice(1).some((element) => (element.textContent ?? '').trim().length > 0)
+      return rest.trim().length > 0 || secondBody
     }
 
     function decorate(root) {
@@ -330,17 +323,13 @@ window.__ModuleLoader__.load({
 
       for (const block of root.querySelectorAll('blockquote')) {
         if (inGenui(block)) continue
-        const text = (block.textContent ?? '').trimStart()
-        let type = cardTypeFor(text)
+        let type = cardTypeFor(block)
         if (type === null && isStatementCard(block)) type = 'statement'
         if (type === null) {
           block.removeAttribute(CARD_ATTR)
           block.removeAttribute(CARD_TYPE_ATTR)
-          if (isFirstBlockquote(block)) block.setAttribute(LEAD_ATTR, 'lead')
-          else block.removeAttribute(LEAD_ATTR)
-          const tone = toneFor(text)
-          if (tone === null) block.removeAttribute(TONE_ATTR)
-          else block.setAttribute(TONE_ATTR, tone)
+          block.removeAttribute(LEAD_ATTR)
+          block.removeAttribute(TONE_ATTR)
           continue
         }
         block.setAttribute(CARD_ATTR, '1')
@@ -398,69 +387,123 @@ window.__ModuleLoader__.load({
       }
     }
 
-    return {
-      inject: [],
-      apply(ctx) {
-        if (typeof document === 'undefined' || typeof MutationObserver === 'undefined') return
-        if (document.body === null) return
+    let active = false
+    let disposeLayer = null
+
+    const enable = () => {
+      if (active) return
+      if (typeof document === 'undefined' || typeof MutationObserver === 'undefined') return
+      if (document.body === null) return
+      active = true
 
-        document.getElementById(LEGACY_STYLE_ID)?.remove()
-        document.getElementById(STYLE_ID)?.remove()
-        const style = document.createElement('style')
-        style.id = STYLE_ID
-        style.textContent = CSS
-        document.head.appendChild(style)
-        document.documentElement.setAttribute(ROOT_ATTR, 'active')
+      document.getElementById(LEGACY_STYLE_ID)?.remove()
+      document.getElementById(STYLE_ID)?.remove()
+      const style = document.createElement('style')
+      style.id = STYLE_ID
+      style.textContent = CSS
+      document.head.appendChild(style)
+      document.documentElement.setAttribute(ROOT_ATTR, 'active')
+      try {
+        console.info('[dsh-structured] visual layer active')
+      } catch {
+        // console 不可用时忽略。
+      }
+
+      let disposed = false
+      let scheduled = false
+      let pending = null
+      const run = () => {
+        if (disposed) return
+        scheduled = false
+        pending = null
+        decorate(document)
+      }
+      const schedule = () => {
+        if (disposed || scheduled) return
+        scheduled = true
+        if (typeof requestAnimationFrame === 'function') pending = requestAnimationFrame(run)
+        else pending = setTimeout(run, 16)
+      }
+      const observer = new MutationObserver(schedule)
+      observer.observe(document.body, { childList: true, subtree: true, characterData: true })
+      run()
+
+      disposeLayer = () => {
+        if (disposed) return
+        disposed = true
+        active = false
+        disposeLayer = null
+        observer.disconnect()
+        if (pending !== null) {
+          if (typeof cancelAnimationFrame === 'function') cancelAnimationFrame(pending)
+          else clearTimeout(pending)
+        }
+        style.remove()
+        document.documentElement.removeAttribute(ROOT_ATTR)
+        for (const attr of [CARD_ATTR, CARD_TYPE_ATTR, ICON_ATTR, TONE_ATTR, LANG_ATTR, STATUS_ATTR, STATUS_TABLE_ATTR, LEAD_ATTR, ROW_ATTR]) {
+          for (const element of document.querySelectorAll('[' + attr + ']')) element.removeAttribute(attr)
+        }
         try {
-          console.info('[dsh-structured] visual layer active')
+          console.info('[dsh-structured] visual layer disposed')
         } catch {
           // console 不可用时忽略。
         }
+      }
+    }
 
-        let disposed = false
-        let scheduled = false
-        let pending = null
-        const run = () => {
-          if (disposed) return
-          scheduled = false
-          pending = null
-          decorate(document)
-        }
-        const schedule = () => {
-          if (disposed || scheduled) return
-          scheduled = true
-          if (typeof requestAnimationFrame === 'function') pending = requestAnimationFrame(run)
-          else pending = setTimeout(run, 16)
-        }
-        const observer = new MutationObserver(schedule)
-        observer.observe(document.body, { childList: true, subtree: true, characterData: true })
-        run()
+    const disable = () => {
+      const layer = disposeLayer
+      disposeLayer = null
+      if (typeof layer === 'function') layer()
+      if (typeof document === 'undefined') return
+      document.getElementById(STYLE_ID)?.remove()
+      document.documentElement.removeAttribute(ROOT_ATTR)
+      for (const attr of [CARD_ATTR, CARD_TYPE_ATTR, ICON_ATTR, TONE_ATTR, LANG_ATTR, STATUS_ATTR, STATUS_TABLE_ATTR, LEAD_ATTR, ROW_ATTR]) {
+        for (const element of document.querySelectorAll('[' + attr + ']')) element.removeAttribute(attr)
+      }
+    }
+
+    const applyVisual = (on) => {
+      if (on) enable()
+      else disable()
+    }
 
-        const dispose = () => {
-          if (disposed) return
-          disposed = true
-          observer.disconnect()
-          if (pending !== null) {
-            if (typeof cancelAnimationFrame === 'function') cancelAnimationFrame(pending)
-            else clearTimeout(pending)
-          }
-          style.remove()
-          document.documentElement.removeAttribute(ROOT_ATTR)
-          for (const attr of [CARD_ATTR, CARD_TYPE_ATTR, ICON_ATTR, TONE_ATTR, LANG_ATTR, STATUS_ATTR, STATUS_TABLE_ATTR, LEAD_ATTR, ROW_ATTR]) {
-            for (const element of document.querySelectorAll('[' + attr + ']')) element.removeAttribute(attr)
-          }
-          try {
-            console.info('[dsh-structured] visual layer disposed')
-          } catch {
-            // console 不可用时忽略。
-          }
+    return {
+      inject: [],
+      apply(ctx) {
+        // 默认开启，保持 0.8.1 的现有观感；随后由插件设置里的 visual 覆盖。
+        enable()
+        try {
+          ctx?.inject?.(['configForms'], (child) => {
+            try {
+              const form = child.configForms?.get('dsh-structured')
+              if (!form || typeof form.getSnapshot !== 'function') return
+              const read = () => {
+                try {
+                  const raw = form.getSnapshot()?.value?.visual
+                  const visual = raw && typeof raw.get === 'function' ? raw.get() : raw
+                  applyVisual(visual !== false)
+                } catch {
+                  // 读取失败时保持当前状态，不打断回复。
+                }
+              }
+              read()
+              if (typeof form.subscribe === 'function') {
+                child.effect?.(() => form.subscribe(read), 'dsh-structured: visual preference')
+              }
+            } catch {
+              // configForms 不可用时保持默认开启。
+            }
+          })
+        } catch {
+          // 无 ctx.inject 的宿主保持默认开启。
         }
         try {
-          ctx?.effect?.(() => dispose, 'dsh-structured: visual layer')
+          ctx?.effect?.(() => disable, 'dsh-structured: visual layer')
         } catch {
-          dispose()
+          // 没有 effect 释放器时，视觉层保持到页面卸载。
         }
-        return dispose
+        return disable
       },
     }
   },

package/lib/index.js

@@ -24,6 +24,7 @@ import {
 } from 'node:fs'
 import { homedir } from 'node:os'
 import { dirname, join } from 'node:path'
+import Schema from '@deepseek-ai/schemastery'
 
 /** Cordis 插件名。 */
 export const name = 'dsh-structured'
@@ -47,6 +48,24 @@ const REMINDER_ORDER = 10300
 /** 会话条目上限：按最近使用淘汰，防止 state.json 无界增长。 */
 export const MAX_SESSION_ENTRIES = 500
 
+/** 把字段标记为 volatile，让 DSH 设置表单可以实时读写。 */
+const k = (x) => (typeof x.volatile === 'function' ? x.volatile() : x)
+
+/** volatile 字段在 host 侧是可读信号；普通字段原样返回。 */
+const readConfig = (x) => (x && typeof x.get === 'function' ? x.get() : x)
+
+/**
+ * DSH 插件配置 schema：设置表单据此渲染，并持久化到 active profile 的 Cordis patch。
+ * 不把 visual 写进 state.json，避免 structured-test 与 desktop 共享同一状态文件。
+ */
+export const Config = Schema.object({
+  visual: k(Schema.boolean().default(true)),
+  defaultEnabled: k(Schema.boolean().default(true)),
+  tailReminder: k(Schema.boolean().default(true)),
+  includeSubagents: k(Schema.boolean().default(false)),
+  genui: k(Schema.union(['auto', 'on', 'off']).default('auto').loose()),
+})
+
 /**
  * 内置规则文本：中文，与 `~/.dsh/AGENTS.md` 第 7 节（响应格式）同源，只规定形状、不另立第二套写作规则。
  * 逐条对应：首句结论（结论卡）、组件化正文、禁过程叙事与复述、结构化不等于变长、支撑信息带证据、
@@ -58,9 +77,9 @@ export const BUILTIN_STYLE_TEXT = [
   '面向用户的实质回复按下面的形状组织。这是硬约束，不是风格建议。',
   '',
   '1. **首句给结论，并把它做成卡片**：第一段固定两行——`> **一句标题**`（加粗放大，≤60 个汉字或一句短句）→ `> 1–2 行正文`；标题即结论，细节放正文，不要写「结论」标签，不要再用普通段落重复。',
-  '2. **按内容选卡，最多两个强调块**：3 条以上要点用清单或表格；每条实质回复 1 个主卡（首段标题无标签）；判断/指标/重点卡用 `> **判断**` / `> **指标**` / `> **重点**`；最多再 1 个行动卡（`风险` / `下一步` / `验收`）；表格前先给一行 `**表格结论：** ...`；状态行/状态单元格用 `✅ 完成` / `⚠️ 待做` / `❌ 阻塞` 开头；表格 ≤5 行，正文 ≤500 字（含表格）；短答不套卡，其余保持中性。',
+  '2. **按信息类型选组件**：3 条以上要点用清单或表格；每条实质回复 1 个主卡（首段标题无标签）；判断/指标/重点卡用 `> **判断**` / `> **指标**` / `> **重点**`；最多再 1 个行动卡（`风险` / `下一步` / `验收`）；表格前先给一行 `**表格结论：** ...`；状态行/状态单元格用 `✅ 完成` / `⚠️ 待做` / `❌ 阻塞` 开头；表格优先 ≤5 行；信息确实多时拆表或使用宿主支持的大表，不硬砍内容；不为了格式加内容，也不为了字数删信息；短答不套卡，其余保持中性。',
   '3. **一段一个主题**：同一信息只出现一次，不要正文和组件各说一遍；不写过程叙事（我先…／已经…／接下来…），不写收尾总结，不加「还需要我…吗？」。',
-  '4. **结构化不等于变长**：组件是压缩阅读时间的工具，不是加信息的借口；对话汇报正文不超过 500 字，超出的细节写进文件，回复只留结论加文件路径。',
+  '4. **清晰优先，不设硬性篇幅上限**：组件是帮读者快速定位结论的工具，不是加信息的借口；短答不套卡，长答按信息量组织；判断标准是读者只看首段标题 + 表格首列/列表首句，就能知道结论和下一步；细节写文件，回复保留结论与路径。',
   '5. **支撑信息带证据**：每条支撑尽量带数字、路径或结果；没有证据的判断明确标成推断。',
   '6. **可复制内容用代码块**：提示词、命令、配置、JSON、SQL 等需要复制的文本，用带语言标签的代码块包裹（如 `text` / `powershell`），不要用引用块或普通段落；代码块右上角有复制按钮。',
 ].join('\n')
@@ -72,7 +91,7 @@ export const GENUI_ROUTING_TEXT = [
 
 /** 尾部提醒：一句话重复契约中最容易衰减的四件事，长度控制在几十个 token。 */
 export const TAIL_REMINDER_TEXT = [
-  '提醒：本轮最终回复第一段用无标签标题卡：加粗标题（≤60 字）/ 正文两行；表格前给 `**表格结论：**`；状态用 `✅ 完成` / `⚠️ 待做`；全文最多两个强调块；表格 ≤5 行，正文不超过 500 字；可复制内容用代码块。',
+  '提醒：本轮最终回复第一段用无标签标题卡：加粗标题（≤60 字）/ 正文两行；表格前给 `**表格结论：**`；状态用 `✅ 完成` / `⚠️ 待做`；全文最多两个强调块；表格优先 ≤5 行；不设硬性篇幅上限；清晰优先；可复制内容用代码块。',
 ].join('\n')
 
 /** DSH home：优先 DSH_HOME，缺省 ~/.dsh。 */
@@ -286,7 +305,7 @@ export function setEnabledFor(sessions, defaultEnabled, sessionId, enabled) {
 
 /**
  * 生成 /structured 的状态文本（不含副作用）。
- * @param {{ sessionId: string | null, sessions: Record<string, { enabled: boolean, at: number }>, defaultEnabled: boolean, genui?: boolean }} input
+ * @param {{ sessionId: string | null, sessions: Record<string, { enabled: boolean, at: number }>, defaultEnabled: boolean, genui?: boolean, visual?: boolean }} input
  * @returns {string}
  */
 export function statusText(input) {
@@ -296,7 +315,7 @@ export function statusText(input) {
     '结构化提示词：' + (enabled ? '已开启' : '已关闭') + '（本会话）',
     '新会话默认：' + (input.defaultEnabled ? '开启' : '关闭'),
     '规则来源：' + (style.source === 'custom' ? '自定义 ' + styleFile() : '内置（无标签标题卡 + 结构化组件）'),
-    '视觉层：始终开启（/structured 只控制提示词注入，视觉样式不随开关关闭）',
+    '视觉层：' + (input.visual === false ? '已关闭' : '已开启') + '（由插件设置 visual 控制；/structured 只控制提示词）',
     'GenUI 联动：' + (input.genui ? '已检测（图表/交互走 dsh-ui，普通卡片走 fallback）' : '未检测（纯 markdown fallback）'),
     '状态文件：' + stateFile(),
     '用法：/structured on | off | status',
@@ -313,7 +332,7 @@ export function handleCommand(invocation, api) {
   const sessionId = sessionIdOf(invocation)
   const arg = String(invocation?.rawInput ?? '').trim().toLowerCase()
   if (arg === '' || arg === 'status') {
-    return { kind: 'success', text: statusText({ sessionId, sessions: api.sessions, defaultEnabled: api.defaultEnabled, genui: api.genui }) }
+    return { kind: 'success', text: statusText({ sessionId, sessions: api.sessions, defaultEnabled: api.defaultEnabled, genui: api.genui, visual: api.visual }) }
   }
   if (arg !== 'on' && arg !== 'off') {
     return { kind: 'error', text: '未知参数：' + arg + '\n用法：/structured on | off | status' }
@@ -335,17 +354,19 @@ export function handleCommand(invocation, api) {
 /**
  * 挂载结构化输出：提示词 section + 尾部提醒 + 会话开关 + /structured 命令。
  * @param {import('@deepseek-ai/cordis').Context} ctx host 根上下文。
- * @param {{ defaultEnabled?: boolean, tailReminder?: boolean, includeSubagents?: boolean, genui?: 'auto' | 'on' | 'off' }} [config]
+ * @param {{ defaultEnabled?: boolean, tailReminder?: boolean, includeSubagents?: boolean, genui?: 'auto' | 'on' | 'off', visual?: boolean }} [config]
  */
 export function apply(ctx, config = {}) {
-  const defaultEnabled = config?.defaultEnabled !== false
-  const tailReminder = config?.tailReminder !== false
-  const includeSubagents = config?.includeSubagents === true
-  const genui = detectGenui(config, ctx)
+  const defaultEnabled = readConfig(config?.defaultEnabled) !== false
+  const visualNow = () => readConfig(config?.visual) !== false
+  const tailReminder = readConfig(config?.tailReminder) !== false
+  const includeSubagents = readConfig(config?.includeSubagents) === true
+  const genuiConfig = { genui: readConfig(config?.genui) }
+  const genui = detectGenui(genuiConfig, ctx)
   let genuiKnown = genui
   const genuiNow = () => {
     if (genuiKnown) return true
-    genuiKnown = detectGenui(config, ctx)
+    genuiKnown = detectGenui(genuiConfig, ctx)
     return genuiKnown
   }
   const builtinStyleText = () => (genuiNow() ? BUILTIN_STYLE_TEXT + '\n\n' + GENUI_ROUTING_TEXT : BUILTIN_STYLE_TEXT)
@@ -462,6 +483,7 @@ export function apply(ctx, config = {}) {
                 sessions,
                 defaultEnabled,
                 genui: genuiNow(),
+                visual: visualNow(),
                 onChange: (sessionId, enabled, result) => {
                   warn(
                     'session ' + sessionId + ' structured ' + (enabled ? 'on' : 'off') + (result.ok ? '' : '（持久化失败）'),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-structured",
-  "version": "0.7.4",
+  "version": "0.8.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",
@@ -39,7 +39,9 @@
     },
     "client": {
       "platform": "web",
-      "inject": [],
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-settings"
+      ],
       "immediately": true
     },
     "compatibility": {
@@ -61,6 +63,7 @@
     "!docs/RE-AUDIT-REPORT.md",
     "!docs/PUBLISH-READY.md",
     "!docs/RELEASE-NOTES-0.7.4.md",
+    "!docs/MAINTENANCE*.md",
     "assets/screenshots",
     "screenshots.json",
     "test",
@@ -81,5 +84,12 @@
   "engines": {
     "node": ">=22",
     "dsh": ">=0.1.7-rc.2 <0.3.0-0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/schemastery": "^3.18.0"
+  },
+  "devDependencies": {
+    "@deepseek-ai/schemastery": "^3.18.0",
+    "linkedom": "0.18.14"
   }
 }

package/scripts/desktop-check.mjs

@@ -73,6 +73,8 @@ check('files 含 lib / src', files.includes('lib') && files.includes('src'), fil
 check('main 指向 lib/index.js', pkg.main === 'lib/index.js', pkg.main ?? '缺失')
 check('exports . 指向 lib/index.js', pkg.exports?.['.'] === './lib/index.js', String(pkg.exports?.['.'] ?? '缺失'))
 check('桌面 client 半区已声明', pkg?.dsh?.client?.platform === 'web', 'dsh.client.platform = web')
+check('client 半区注入 settings', (pkg?.dsh?.client?.inject ?? []).includes('@deepseek-ai/dsh-client-ui-settings'), 'visual 通过 configForms 读取')
+check('声明 schemastery peer', typeof pkg?.peerDependencies?.['@deepseek-ai/schemastery'] === 'string', pkg?.peerDependencies?.['@deepseek-ai/schemastery'] ?? '缺失')
 check('exports ./client 指向 lib/client.js', pkg.exports?.['./client'] === './lib/client.js', String(pkg.exports?.['./client'] ?? '缺失'))
 check('engines.dsh 声明兼容范围', typeof pkg?.engines?.dsh === 'string', pkg?.engines?.dsh ?? '缺失')
 check('dsh.compatibility 声明兼容版本', Boolean(pkg?.dsh?.compatibility?.dshReleases), JSON.stringify(pkg?.dsh?.compatibility?.dshReleases ?? {}))
@@ -105,8 +107,10 @@ try {
 check('client 模块 id 与包名一致', /id:\s*'dsh-structured'/.test(clientText), '')
 check('client 模块是纯 DOM 增强（无 React 强依赖）', !/require\(['"]react['"]\)/.test(clientText), '')
 const imports = [...libText.matchAll(/from\s+['"]([^'"]+)['"]/g)].map((match) => match[1])
-const nonNodeImports = imports.filter((spec) => !spec.startsWith('node:'))
-check('运行时只 import node: 内置模块', nonNodeImports.length === 0, nonNodeImports.join(', ') || 'ok')
+const allowedRuntimeImports = new Set(['@deepseek-ai/schemastery'])
+const nonNodeImports = imports.filter((spec) => !spec.startsWith('node:') && !allowedRuntimeImports.has(spec))
+check('运行时只 import node: + 宿主 schemastery', nonNodeImports.length === 0, nonNodeImports.join(', ') || 'ok')
+check('导出 Config（设置表单）', /export const Config =/.test(libText), 'theme/visual 等字段由插件设置页渲染')
 check('inject 只硬依赖 systemPrompt', /export const inject = \['systemPrompt'\]/.test(libText), 'commands 缺失时只降级命令')
 check('没有 desktop/structured-test 分支', !/['"](?:desktop|structured-test)['"]/.test(libText), '')
 check('状态目录走 DSH_HOME', /process\.env\.DSH_HOME/.test(libText), '')