@master0071/dsh-systemone 0.7.0 → 0.7.2

package/README.md

@@ -432,7 +432,7 @@ refs:
 
 ## 添加自定义场景
 
-**推荐用图形配置页**：插件 → @master0071/dsh-systemone → systemone → 「自定义场景」卡片，粘贴 JSON 即可。编辑框会实时校验（JSON 语法、`id`/`title`/`questions`、问题类型与选项数量），不通过时保存按钮禁用并给出具体原因；保存后场景库立即重建，新场景的 id 也会自动出现在「固定场景」的候选列表里。
+**推荐用图形配置页**：插件 → @master0071/dsh-systemone → systemone → 「自定义场景」卡片，粘贴 JSON 即可。编辑框会实时校验（JSON 语法、`id`/`title`/`questions`、问题类型与选项数量、`patch` 的目标是否存在），不通过时保存按钮禁用并给出具体原因；保存后场景库立即重建，新场景的 id 也会自动出现在「固定场景」的候选列表里。
 
 卡片右上角的**「插入意图识别模板」**会填入下面这个通用意图识别场景，改 `criteria` 即可用。
 
@@ -440,6 +440,7 @@ refs:
 
 覆盖与别名的解析规则：
 
+- **patch 的目标必须已存在**：内置 11 个场景，或**本数组中更早出现**的自定义场景。宿主按数组顺序登记（与 `indexById` 语义一致），指向不存在或更晚出现的 id 会被**整条跳过**——配置页会提前报“patch 目标不存在”，不必等日志。
 - **patch 式覆盖**：默认同 `id` 是**整体替换**。只想改一两个字段时，给条目加 `"patch": true` 即可做**字段级合并**——`title`/`description`/`recommendation` 给了才覆盖；`questions` 按 qid 合并（只换给出的字段，如只覆盖某个问题的 `criteria`，其余问题原样保留，新 qid 追加）；`derive` 同名覆盖；`aliases` 求并集。例如给 `customer_service` 的部门问题加一个 VIP 通道：
 
   ```json
@@ -586,7 +587,7 @@ SystemOne 是「结构化问题 → 概率分布」的决策模型，**不是开
 
 ```powershell
 npm run check   # 9 个 lib/*.js 语法检查通过
-npm run test    # 195 项测试：
+npm run test    # 203 项测试：
                 # - 场景库完整性、11 大场景端到端（有断言强制 sample 覆盖全部内置场景）、
                 #   自定义场景合并/覆盖/patch/非法跳过
                 # - params 覆盖语义、确定性、失败路径（无网络、无 Key）
@@ -595,7 +596,9 @@ npm run test    # 195 项测试：
                 #   缓存与"改配置即失效"、去重、跳过规则、历史捕获、自动路由、
                 #   路由复用与热失效、失败熔断、卸载）
                 # - 用量台账（累计、跨日、重启后从文件恢复、坏行容错、日限判定）
-                # - 配置页（场景 JSON 校验、数字范围、保存被拒的冲突/校验区分、
+                # - 配置页（场景 JSON 校验、patch 目标存在性与顺序语义、数字范围、
+                #   保存被拒的冲突/校验区分、
+                #   三张卡各自保存（提交的 ops 只含本卡字段）、清除 Key 的 unset 语义、
                 #   加载态与"为什么不能保存"的渲染冒烟）
 ```
 

package/lib/client.js

@@ -42,7 +42,7 @@ window.__ModuleLoader__.load({
       tabCustom: '自定义场景',
       tabCustomHint: '用 JSON 定义自己的场景（含「通用意图识别」）。保存后场景库立即重建，无需重启。',
       customScenarios: '场景定义（JSON 数组）',
-      customScenariosHint: '同 id 默认整体覆盖内置场景；加 "patch": true 则只改给出的字段。留空 [] 表示只用内置 11 个。每个场景最多 16 个问题，choice 选项 2~26 个。',
+      customScenariosHint: '同 id 默认整体覆盖内置场景；加 "patch": true 则只改给出的字段。patch 的目标必须是内置场景，或本数组中更早出现的自定义场景。留空 [] 表示只用内置 11 个。每个场景最多 16 个问题，choice 选项 2~26 个。',
       customScenariosPlaceholder: '[\n  {\n    "id": "intent",\n    "title": "通用意图识别",\n    "questions": {\n      "intent": {\n        "type": "choice",\n        "instructions": "用户最想做什么？",\n        "criteria": { "query": "查询", "action": "执行操作", "chat": "闲聊" }\n      }\n    }\n  }\n]',
       insertTemplate: '插入意图识别模板',
       jsonEmpty: '（空 = 只用内置场景）',
@@ -137,7 +137,7 @@ window.__ModuleLoader__.load({
       tabCustom: 'Custom scenarios',
       tabCustomHint: 'Define your own scenarios in JSON (including general intent recognition). Saving rebuilds the library immediately.',
       customScenarios: 'Scenario definitions (JSON array)',
-      customScenariosHint: 'An id matching a built-in overrides it; add "patch": true to merge only the given fields. Empty [] keeps only the 11 built-ins. Max 16 questions per scenario, 2~26 choice options.',
+      customScenariosHint: 'An id matching a built-in overrides it; add "patch": true to merge only the given fields. A patch target must be a built-in, or a custom scenario declared earlier in this array. Empty [] keeps only the 11 built-ins. Max 16 questions per scenario, 2~26 choice options.',
       customScenariosPlaceholder: '[\n  {\n    "id": "intent",\n    "title": "General intent",\n    "questions": {\n      "intent": {\n        "type": "choice",\n        "instructions": "What does the user want?",\n        "criteria": { "query": "Look up", "action": "Do something", "chat": "Small talk" }\n      }\n    }\n  }\n]',
       insertTemplate: 'Insert intent template',
       jsonEmpty: '(empty = built-in scenarios only)',
@@ -359,8 +359,9 @@ window.__ModuleLoader__.load({
      * 客户端侧校验自定义场景 JSON。
      *
      * 只做「能立刻发现」的检查：JSON 语法 + 每条的 id/title/questions 与
-     * 问题类型/选项数量。宿主侧 `resolveScenarios` 还会做一遍同样的校验，
-     * 语义问题（非法条目）宿主会跳过并写入日志；这里提前拦住，用户不必去翻日志。
+     * 问题类型/选项数量，以及 `patch` 的目标是否存在。宿主侧 `resolveScenarios`
+     * 还会做一遍同样的校验，语义问题（非法条目）宿主会跳过并写入日志；
+     * 这里提前拦住，用户不必去翻日志。
      *
      * @param {string} text - 编辑框里的原始文本
      * @returns {{ ok: boolean, error?: string, ids: string[], count: number }}
@@ -378,6 +379,9 @@ window.__ModuleLoader__.load({
       if (!Array.isArray(parsed)) return { ok: false, error: 'notArray', ids: [], count: 0 }
 
       const ids = []
+      // patch 只能改「已有」场景：内置 11 个，或本数组里**更早**出现的自定义条目。
+      // 与宿主 `resolveScenarios` 的 indexById 语义一致（内置先行、按数组顺序登记）。
+      const known = new Set(SCENARIO_OPTIONS.map((option) => option.id.toLowerCase()))
       for (let i = 0; i < parsed.length; i += 1) {
         const spec = parsed[i]
         const at = i + 1
@@ -387,6 +391,11 @@ window.__ModuleLoader__.load({
         const issues = []
         const isPatch = spec.patch === true
         if (typeof spec.id !== 'string' || spec.id.trim() === '') issues.push('缺少 id')
+        // 目标不存在时宿主会整条跳过（只写日志），界面若仍报「JSON 有效」，
+        // 用户会以为改好了——所以这里必须提前拦住。
+        else if (isPatch && !known.has(spec.id.trim().toLowerCase())) {
+          issues.push('patch 目标不存在（只能是内置场景，或本数组中更早出现的自定义场景）')
+        }
         if (!isPatch && (typeof spec.title !== 'string' || spec.title.trim() === '')) issues.push('缺少 title')
         const questions = spec.questions
         if (!isPatch || questions !== undefined) {
@@ -442,7 +451,11 @@ window.__ModuleLoader__.load({
         if (issues.length > 0) {
           return { ok: false, error: `issues:${at}:${spec.id ?? '?'}:${issues.join('；')}`, ids, count: 0 }
         }
-        if (typeof spec.id === 'string') ids.push(spec.id.trim())
+        if (typeof spec.id === 'string') {
+          ids.push(spec.id.trim())
+          // 后续条目的 patch 可以指向它（与宿主按顺序登记一致）
+          known.add(spec.id.trim().toLowerCase())
+        }
       }
       return { ok: true, ids, count: ids.length }
     }
@@ -532,6 +545,45 @@ window.__ModuleLoader__.load({
       return latestRevision !== revision ? t('conflict') : t('saveRefused')
     }
 
+    /**
+     * 构造一张卡片需要提交的写操作（纯函数）。
+     *
+     * 只取**该卡片内**、且与当前快照不同的字段——这是"三张卡各自保存"的核心：
+     * 保存「模型服务」时，不能顺手把「自动决策」卡里还没填完的草稿一起写下去。
+     *
+     * 规则与保存路径保持一致：数字从字符串转回 number（非法值不发写操作）、
+     * `redact` 下拉从字符串转布尔、`apiKey` 留空表示"不修改已保存的值"（清空走 unset）。
+     *
+     * @param {string} cardKey - service / custom / auto
+     * @param {object} input
+     * @param {string[]} input.fields - 该卡片的字段 key 列表
+     * @param {object} input.draft - 草稿（只含用户改过的键）
+     * @param {object} input.current - 当前快照（已 toDraft）
+     * @param {object[]} input.allFields - 全部字段元数据（用于判断类型）
+     * @param {boolean} input.clearApiKey - 是否点了「清除已保存的 Key」
+     * @returns {object[]} SettingsPathOpView 数组
+     */
+    function cardOps(cardKey, { fields, draft, current, allFields, clearApiKey }) {
+      const ops = []
+      for (const [key, value] of Object.entries(draft ?? {})) {
+        if (!fields.includes(key)) continue
+        if (value === current[key]) continue
+        // apiKey 留空表示「保持已保存的值」，不发写操作（清空见下面的 unset）
+        if (key === 'apiKey' && value === '') continue
+        const field = allFields.find((item) => item.key === key)
+        let next = value
+        if (field?.kind === 'number') {
+          const parsed = Number(value)
+          if (!Number.isFinite(parsed)) continue
+          next = parsed
+        }
+        if (key === 'redact') next = value === 'true'
+        ops.push({ op: 'set', path: [key], value: next })
+      }
+      if (cardKey === 'service' && clearApiKey) ops.push({ op: 'unset', path: ['apiKey'] })
+      return ops
+    }
+
     /* ────────────────────────────── 组件 ────────────────────────────── */
 
     /**
@@ -750,69 +802,73 @@ window.__ModuleLoader__.load({
         numberExtras[key] = { error }
       }
 
-      const dirty = clearApiKey || (draft !== null && Object.keys(draft).some((key) => draft[key] !== current[key]))
-      const canSave = dirty && !busy && writable && customCheck.ok && Object.keys(numberErrors).length === 0
+      const changedKeys = Object.keys(draft ?? {}).filter((key) => draft[key] !== current[key])
 
-      // 保存按钮为什么是灰的，必须写在界面上：三张卡共用一个 canSave，
-      // 而错误只出现在出问题的那张卡里（「自定义场景」卡还默认折叠）。
-      // 否则用户看到的是一个没有任何解释的灰按钮。
-      const blockers = []
-      if (!customCheck.ok && customErrorText) blockers.push(`${t('tabCustom')}：${customErrorText}`)
-      for (const [key, error] of Object.entries(numberErrors)) blockers.push(`${t(key)}：${error}`)
-      const blockedText = blockers.length > 0
-        ? t('saveBlocked', { count: blockers.length, reason: blockers[0] })
-        : undefined
+      const CARD_FIELDS = {
+        service: SERVICE_FIELDS.map((f) => f.key),
+        custom: CUSTOM_FIELDS.map((f) => f.key),
+        auto: AUTO_FIELDS.map((f) => f.key),
+      }
 
-      // 「固定场景」候选 = 11 个内置 + 当前生效的自定义场景 id（patch 条目指向已有 id，去重避免重复项）
-      const scenarioOptions = [
-        ...SCENARIO_OPTIONS,
-        ...(customCheck.ok
-          ? [...new Set(customCheck.ids)]
-              .filter((id) => !SCENARIO_OPTIONS.some((option) => option.id === id))
-              .map((id) => ({ id, label: id }))
-          : []),
-      ]
+      /** 单张卡片的脏态：该卡片内有字段被改过，或服务卡的 Key 被清空 */
+      const cardDirty = (cardKey) =>
+        (cardKey === 'service' && clearApiKey) ||
+        changedKeys.some((key) => CARD_FIELDS[cardKey].includes(key))
 
-      const onFieldChange = (key, value) => {
-        setNotice(null)
-        // 用户开始输入新 Key 时，「清除」这个意图就作废了——否则会先 set 再 unset。
-        if (key === 'apiKey' && clearApiKey) setClearApiKey(false)
-        setDraft((previous) => ({ ...(previous ?? {}), [key]: value }))
+      /** 单张卡片的错误提示：该卡片内字段的数字越界，或自定义场景卡的 JSON 问题 */
+      const cardErrors = (cardKey) => {
+        const errors = []
+        if (cardKey === 'custom' && !customCheck.ok && customErrorText) {
+          errors.push(`${t('tabCustom')}：${customErrorText}`)
+        }
+        for (const [fieldKey, error] of Object.entries(numberErrors)) {
+          if (CARD_FIELDS[cardKey].includes(fieldKey)) errors.push(`${t(fieldKey)}：${error}`)
+        }
+        return errors
       }
 
-      const onSave = async () => {
-        if (!canSave) return
+      /** 单张卡片的保存状态行文案 */
+      const cardBlockedText = (cardKey) => {
+        const errors = cardErrors(cardKey)
+        return errors.length > 0 ? t('saveBlocked', { count: errors.length, reason: errors[0] }) : undefined
+      }
+
+      /** 单张卡片能否保存：本卡有改动、非忙、可写、且本卡内无校验错误 */
+      const cardCanSave = (cardKey) =>
+        cardDirty(cardKey) && !busy && writable && cardErrors(cardKey).length === 0
+
+      /** 把某张卡片的键从草稿里移除（撤销、或保存成功后）；空草稿归一成 null */
+      const dropCardDraft = (cardKey) => {
+        setDraft((prev) => {
+          const next = { ...prev }
+          for (const key of Object.keys(prev)) {
+            if (CARD_FIELDS[cardKey].includes(key)) delete next[key]
+          }
+          return Object.keys(next).length ? next : null
+        })
+      }
+
+      /** 单张卡片保存：只提交该卡片内改过的字段，保存后只清掉该卡片的草稿 */
+      const onSaveCard = async (cardKey) => {
+        if (!cardCanSave(cardKey)) return
         setBusy(true)
         setNotice(null)
         try {
-          // 数字字段在草稿里保持字符串，这里再转数字（合法性已由上方 numberErrors 拦截）
-          const ops = []
-          for (const [key, value] of Object.entries(draft ?? {})) {
-            if (value === current[key]) continue
-            // apiKey 留空表示「保持已保存的值」，不发写操作
-            if (key === 'apiKey' && value === '') continue
-            const field = ALL_FIELDS.find((item) => item.key === key)
-            let next = value
-            if (field?.kind === 'number') {
-              const parsed = Number(value)
-              if (!Number.isFinite(parsed)) continue
-              next = parsed
-            }
-            // redact 下拉在草稿里是字符串，schema 要的是布尔
-            if (key === 'redact') next = value === 'true'
-            ops.push({ op: 'set', path: [key], value: next })
-          }
-          // 「清除已保存的 Key」是独立意图：schema 的 unset 才是"取消覆盖、回到默认"，
-          // 用空字符串 set 只会写进一个空值。
-          if (clearApiKey) ops.push({ op: 'unset', path: ['apiKey'] })
+          const ops = cardOps(cardKey, {
+            fields: CARD_FIELDS[cardKey],
+            draft,
+            current,
+            allFields: ALL_FIELDS,
+            clearApiKey,
+          })
           if (ops.length === 0) {
-            setDraft(null)
+            dropCardDraft(cardKey)
             return
           }
           const ok = await form.mutate(ops, revision)
           if (ok) {
-            setDraft(null)
-            setClearApiKey(false)
+            dropCardDraft(cardKey)
+            if (cardKey === 'service') setClearApiKey(false)
             setNotice({ kind: 'ok', text: t('saved') })
           } else {
             setNotice({
@@ -827,6 +883,30 @@ window.__ModuleLoader__.load({
         }
       }
 
+      /** 单张卡片撤销：只撤销该卡片里的改动 */
+      const onRevertCard = (cardKey) => {
+        dropCardDraft(cardKey)
+        if (cardKey === 'service') setClearApiKey(false)
+      }
+
+      // 「固定场景」候选 = 11 个内置 + 当前生效的自定义场景 id（patch 条目指向已有 id，去重避免重复项）
+      const scenarioOptions = [
+        ...SCENARIO_OPTIONS,
+        ...(customCheck.ok
+          ? [...new Set(customCheck.ids)]
+              .filter((id) => !SCENARIO_OPTIONS.some((option) => option.id === id))
+              .map((id) => ({ id, label: id }))
+          : []),
+      ]
+
+      const onFieldChange = (key, value) => {
+        setNotice(null)
+        // 用户开始输入新 Key 时，「清除」这个意图就作废了——否则会先 set 再 unset。
+        if (key === 'apiKey' && clearApiKey) setClearApiKey(false)
+        setDraft((previous) => ({ ...(previous ?? {}), [key]: value }))
+      }
+
+
       /** 渲染字段；可按 key 附加错误提示、候选、右上角附加元素。 */
       const renderFields = (fields, extras = {}) =>
         fields.map((field) => {
@@ -844,34 +924,41 @@ window.__ModuleLoader__.load({
           })
         })
 
-      const statusLine = hs(Fragment, {
+      // 每张卡片自己的 footer：保存只提交该卡片内改过的字段，撤销也只撤销该卡片
+      const renderFooter = ({ cardKey, showRevert, extra }) => hs('div', {
+        key: 'footer',
+        style: footerStyle,
         children: [
-          h('span', { key: 'now', children: t('current', { provider: values.provider || 'unisound', model: values.model || 'u2-decision' }) }),
-          notice !== null
-            ? h('span', { key: 'notice', style: notice.kind === 'ok' ? statusStyle : errorStyle, children: notice.text })
-            : null,
-          blockedText !== undefined
-            ? h('span', { key: 'blocked', style: errorStyle, children: blockedText })
+          h('button', { key: 'save', type: 'button', style: { ...primaryButton, opacity: cardCanSave(cardKey) ? 1 : 0.5 }, disabled: !cardCanSave(cardKey), onClick: () => onSaveCard(cardKey), children: busy ? t('saving') : t('save') }),
+          ...(showRevert ? [h('button', { key: 'revert', type: 'button', style: ghostButton, disabled: !cardDirty(cardKey) || busy, onClick: () => onRevertCard(cardKey), children: t('revert') })] : []),
+          ...(extra ? [extra] : []),
+          cardBlockedText(cardKey) !== undefined
+            ? h('span', { key: 'blocked', style: errorStyle, children: cardBlockedText(cardKey) })
             : null,
-          !writable ? h('span', { key: 'ro', style: statusStyle, children: t('readOnly') }) : null,
         ],
       })
 
-      // 三张卡片共用同一套 footer：save（可选 revert / 额外状态）+ 状态行
-      const renderFooter = ({ showRevert, extra }) => hs('div', {
-        key: 'footer',
-        style: footerStyle,
+      // 全局状态（当前提供商 / 保存结果 / 只读）只显示一次；
+      // 每张卡自己的"为什么不能保存"由各自的 footer 渲染（见 renderFooter）。
+      const globalStatus = hs(Fragment, {
+        key: 'status',
         children: [
-          h('button', { key: 'save', type: 'button', style: { ...primaryButton, opacity: canSave ? 1 : 0.5 }, disabled: !canSave, onClick: onSave, children: busy ? t('saving') : t('save') }),
-          ...(showRevert ? [h('button', { key: 'revert', type: 'button', style: ghostButton, disabled: !dirty || busy, onClick: () => { setDraft(null); setNotice(null); setClearApiKey(false) }, children: t('revert') })] : []),
-          ...(extra ? [extra] : []),
-          statusLine,
+          h('span', { key: 'now', children: t('current', { provider: values.provider || 'unisound', model: values.model || 'u2-decision' }) }),
+          notice !== null
+            ? h('span', { key: 'notice', style: notice.kind === 'ok' ? statusStyle : errorStyle, children: notice.text })
+            : null,
+          !writable ? h('span', { key: 'ro', style: statusStyle, children: t('readOnly') }) : null,
         ],
       })
 
       return hs('ul', {
         style: listStyle,
         children: [
+          h('li', {
+            key: 'global-status',
+            style: { ...statusStyle, display: 'flex', gap: 10, flexWrap: 'wrap' },
+            children: globalStatus,
+          }),
           h(ConfigCard, {
             key: 'service',
             title: t('tabService'),
@@ -898,7 +985,7 @@ window.__ModuleLoader__.load({
                     }),
                   },
                 }),
-                renderFooter({ showRevert: true }),
+                renderFooter({ cardKey: 'service', showRevert: true }),
               ],
             }),
           }),
@@ -961,6 +1048,7 @@ window.__ModuleLoader__.load({
                   },
                 }),
                 renderFooter({
+                  cardKey: 'custom',
                   showRevert: true,
                   extra: customCheck.ok
                     ? h('span', {
@@ -984,7 +1072,7 @@ window.__ModuleLoader__.load({
             children: hs(Fragment, {
               children: [
                 ...renderFields(AUTO_FIELDS, numberExtras),
-                renderFooter({ showRevert: false }),
+                renderFooter({ cardKey: 'auto', showRevert: false }),
               ],
             }),
           }),
@@ -1036,6 +1124,8 @@ window.__ModuleLoader__.load({
       describeCustomError,
       numberErrorFor,
       saveResultText,
+      cardOps,
+      SCENARIO_OPTIONS,
       SERVICE_FIELDS,
       CUSTOM_FIELDS,
       AUTO_FIELDS,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@master0071/dsh-systemone",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "description": "DeepSeek Harness 插件：将 SystemOne 决策模型（默认云知声 u2-decision，可切换提供商）接入软件开发、需求预检、客服、内容审核、路由、销售线索、风控、招聘、数据治理、教育、需求变更等 11 大业务场景，为 Agent 返回带概率分布的决策与处置建议。",
   "license": "MIT",
   "type": "module",