dsh-structured 0.7.4 → 0.8.2

package/src/client.js

@@ -24,15 +24,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 = [
       [/结论|总结|答案|判断/, '◆'],
       [/方案|计划|步骤|流程/, '▸'],
@@ -43,13 +43,6 @@ window.__ModuleLoader__.load({
       [/背景|原因|根因/, '◎'],
       [/指标|数据|结果/, '▦'],
     ]
-    const TONES = [
-      [/风险|注意|警告|坑/, 'warn'],
-      [/验收|通过|成功/, 'success'],
-      [/重点|关键|核心/, 'info'],
-      [/下一步|行动|待办/, 'info'],
-      [/结论|判断|答案/, 'info'],
-    ]
 
     const CSS = `
 [class*="_markdown_"]{
@@ -172,19 +165,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"]{
@@ -273,9 +253,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) {
@@ -286,11 +281,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'
@@ -298,24 +288,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) {
@@ -328,17 +321,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')
@@ -396,69 +385,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/src/index.js

@@ -22,6 +22,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'
@@ -45,6 +46,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 节（响应格式）同源，只规定形状、不另立第二套写作规则。
  * 逐条对应：首句结论（结论卡）、组件化正文、禁过程叙事与复述、结构化不等于变长、支撑信息带证据、
@@ -56,9 +75,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')
@@ -70,7 +89,7 @@ export const GENUI_ROUTING_TEXT = [
 
 /** 尾部提醒：一句话重复契约中最容易衰减的四件事，长度控制在几十个 token。 */
 export const TAIL_REMINDER_TEXT = [
-  '提醒：本轮最终回复第一段用无标签标题卡：加粗标题（≤60 字）/ 正文两行；表格前给 `**表格结论：**`；状态用 `✅ 完成` / `⚠️ 待做`；全文最多两个强调块；表格 ≤5 行，正文不超过 500 字；可复制内容用代码块。',
+  '提醒：本轮最终回复第一段用无标签标题卡：加粗标题（≤60 字）/ 正文两行；表格前给 `**表格结论：**`；状态用 `✅ 完成` / `⚠️ 待做`；全文最多两个强调块；表格优先 ≤5 行；不设硬性篇幅上限；清晰优先；可复制内容用代码块。',
 ].join('\n')
 
 /** DSH home：优先 DSH_HOME，缺省 ~/.dsh。 */
@@ -284,7 +303,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) {
@@ -294,7 +313,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',
@@ -311,7 +330,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' }
@@ -333,17 +352,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)
@@ -460,6 +481,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/test/client-cards.test.mjs

@@ -0,0 +1,140 @@
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import vm from 'node:vm'
+import { parseHTML } from 'linkedom'
+
+const clientSource = readFileSync('src/client.js', 'utf8')
+
+function render(html) {
+  const { window, document } = parseHTML(`<!doctype html><html><head></head><body>${html}</body></html>`)
+  let definition
+  const sandbox = {
+    window: {
+      __ModuleLoader__: {
+        load(value) {
+          definition = value
+        },
+      },
+    },
+    document,
+    MutationObserver: class {
+      observe() {}
+      disconnect() {}
+    },
+    requestAnimationFrame(fn) {
+      fn()
+      return 1
+    },
+    cancelAnimationFrame() {},
+    setTimeout,
+    clearTimeout,
+    console,
+  }
+  sandbox.globalThis = sandbox
+  vm.runInNewContext(clientSource, sandbox)
+  assert.ok(definition, 'client module definition captured')
+  const plugin = definition.factory()
+  plugin.apply({
+    inject(_services, callback) {
+      callback({ configForms: { get: () => null } })
+    },
+    effect() {},
+  })
+  return document
+}
+
+function block(document, id) {
+  const element = document.querySelector(`#${id}`)
+  assert.ok(element, `missing #${id}`)
+  return element
+}
+
+function assertPlain(document, id) {
+  const element = block(document, id)
+  assert.equal(element.getAttribute('data-dsh-structured-card'), null, `${id} card`)
+  assert.equal(element.getAttribute('data-dsh-structured-card-type'), null, `${id} type`)
+  assert.equal(element.getAttribute('data-dsh-structured-tone'), null, `${id} tone`)
+  assert.equal(element.getAttribute('data-dsh-structured-lead'), null, `${id} lead`)
+}
+
+function assertCard(document, id, type, tone) {
+  const element = block(document, id)
+  assert.equal(element.getAttribute('data-dsh-structured-card'), '1', `${id} card`)
+  assert.equal(element.getAttribute('data-dsh-structured-card-type'), type, `${id} type`)
+  assert.equal(element.getAttribute('data-dsh-structured-tone'), tone, `${id} tone`)
+  assert.equal(element.getAttribute('data-dsh-structured-lead'), null, `${id} lead`)
+}
+
+test('严格卡片：复合标签、普通引用不升级，完整标签才成卡', () => {
+  const document = render(`
+    <div class="_markdown_q2"><blockquote id="q2"><p><strong>风险提示</strong><br>影响：宿主升级后可能失效。</p></blockquote></div>
+    <div class="_markdown_test">
+      <blockquote id="q1"><p>风险提示：宿主升级后可能失效。</p></blockquote>
+      <blockquote id="q3"><p>结论：这是用户引用的原文。</p></blockquote>
+      <blockquote id="q4"><p>这是普通引用，没有加粗标题。</p></blockquote>
+      <blockquote id="q9"><p><strong>判断依据</strong><br>不应成卡。</p></blockquote>
+    </div>
+    <div class="_markdown_q10"><blockquote id="q10"><p>前缀 <strong>标题</strong></p></blockquote></div>
+    <div class="_markdown_q11"><blockquote id="q11"><p> <strong>标题</strong></p></blockquote></div>
+    <div class="_markdown_q18"><blockquote id="q18"><p>前缀 <strong>标题</strong>尾正文</p></blockquote></div>
+    <div class="_markdown_q16"><blockquote id="q16"><p><strong>结论性说明</strong><br>不应成卡。</p></blockquote></div>
+    <div class="_markdown_q17"><blockquote id="q17"><p><strong>指标数据</strong><br>不应成卡。</p></blockquote></div>
+    <div class="_markdown_test2">
+      <blockquote id="q5"><p><strong>Phase 1 完成</strong><br>28/28 通过。</p></blockquote>
+      <blockquote id="q5b"><p><strong>Phase 2 完成</strong><br>不应升级为 statement。</p></blockquote>
+      <blockquote id="q6"><p><strong>风险</strong><br>影响：宿主升级后可能失效。</p></blockquote>
+      <blockquote id="q7"><p><strong>下一步</strong><br>1. 安装测试 profile。</p></blockquote>
+      <blockquote id="q8"><p><strong>验收</strong><br>✅ 3/3</p></blockquote>
+      <blockquote id="q12"><p><strong>结论</strong><br>结论卡。</p></blockquote>
+      <blockquote id="q13"><p><strong>决策</strong><br>决策卡。</p></blockquote>
+      <blockquote id="q14"><p><strong>指标</strong><br>指标卡。</p></blockquote>
+      <blockquote id="q15"><p><strong>重点</strong><br>重点卡。</p></blockquote>
+      <div data-genui="1">
+        <blockquote id="gen"><p><strong>风险</strong><br>GenUI 内不处理。</p></blockquote>
+      </div>
+    </div>
+    <div class="_markdown_test5">
+      <div data-genui="1">
+        <blockquote id="genfirst"><p><strong>风险</strong><br>GenUI 内不处理，也不应阻断真实首块。</p></blockquote>
+      </div>
+      <blockquote id="real"><p><strong>Phase 9 完成</strong><br>真实首块仍应升级 statement。</p></blockquote>
+    </div>
+  `)
+
+  // 反例：前缀/复合词、普通引用、strong 前有正文或空白
+  assertPlain(document, 'q1')
+  assertPlain(document, 'q2')
+  assertPlain(document, 'q3')
+  assertPlain(document, 'q4')
+  assertPlain(document, 'q9')
+  assertPlain(document, 'q10')
+  assertPlain(document, 'q11')
+  assertPlain(document, 'q18')
+  assertPlain(document, 'q16')
+  assertPlain(document, 'q17')
+
+  // 正例：全部卡型 + 仅第一块可升级 + GenUI 前置不阻断真实首块
+  assertCard(document, 'q5', 'statement', 'info')
+  assertCard(document, 'q6', 'risk', 'warn')
+  assertCard(document, 'q7', 'next', 'info')
+  assertCard(document, 'q8', 'accept', 'success')
+  assertCard(document, 'q12', 'conclusion', 'info')
+  assertCard(document, 'q13', 'decision', 'info')
+  assertCard(document, 'q14', 'metric', 'info')
+  assertCard(document, 'q15', 'key', 'info')
+  assertCard(document, 'real', 'statement', 'info')
+  assertPlain(document, 'q5b')
+
+  // GenUI 区域跳过
+  assertPlain(document, 'gen')
+  assertPlain(document, 'genfirst')
+})
+
+test('严格卡片：不再有普通首引用 lead 与文本前缀 tone 逻辑', () => {
+  assert.doesNotMatch(clientSource, /isFirstBlockquote/)
+  assert.doesNotMatch(clientSource, /toneFor/)
+  assert.doesNotMatch(clientSource, /setAttribute\(LEAD_ATTR,\s*'lead'\)/)
+  assert.match(clientSource, /CARD_TYPES = new Map/)
+  assert.match(clientSource, /isStatementCard/)
+})