dsh-vscode-mode 0.7.0 → 0.9.0

package/src/client/ui/SvnAiPlanDialog.ts

@@ -0,0 +1,293 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — AI 智能整理弹窗（11-ai-changelist-triage）。
+ *
+ * 双阶段单弹窗：
+ * - 预览（run = null）：按**整理功能**划分三个分组卡（建议分组 changelist / 建议还原 revert /
+ *   建议忽略 svn:ignore），每段段级全选 + 逐项勾选确认；默认「分组勾选（可逆无副作用）、
+ *   还原/忽略不勾（有副作用）」，未勾选项一律不动。
+ * - 执行（run 非空）：弹窗不关闭，切换为进度视图——阶段徽标 + 步骤计数 + 总进度条 +
+ *   逐步日志（✓/✗，失败红字）；「暂停」在当前 RPC 返回后的步骤边界生效（svn 子进程不可
+ *   安全中断，如实标注「等待当前步骤完成…」），「继续」从断点续跑，「取消剩余」终止未执行
+ *   步骤（已执行不回滚）。
+ * Esc/遮罩仅在预览阶段生效（= 取消零副作用）；执行阶段防误关。
+ * 作者 ddj 2026年09月23号
+ */
+import React from 'react'
+import { ModalShell } from './ModalShell.js'
+
+/**
+ * 预览勾选初值：分组默认全勾（changelist 可逆），还原/忽略默认不勾（有副作用）。
+ * @author ddj 2026年09月23号
+ * @param plan 三段方案
+ * @returns 勾选态（组级 + 逐项）
+ */
+function initPlanSel(plan) {
+  return {
+    groups: (plan.groups || []).map((group) => ({
+      name: group.name,
+      reason: group.reason || '',
+      checked: true,
+      paths: (group.paths || []).map((path) => ({ path, checked: true })),
+    })),
+    reverts: (plan.reverts || []).map((item) => ({ path: item.path, reason: item.reason || '', checked: false })),
+    ignores: (plan.ignores || []).map((item) => ({ path: item.path, reason: item.reason || '', checked: false })),
+  }
+}
+
+/**
+ * 勾选态 → 执行载荷（空段/空组剔除；保持勾选顺序）。
+ * @author ddj 2026年09月23号
+ * @param sel 勾选态
+ * @returns 执行载荷 { groups, reverts, ignores }
+ */
+function selectedOf(sel) {
+  const groups = []
+  for (const group of sel.groups) {
+    const paths = group.paths.filter((p) => p.checked).map((p) => p.path)
+    if (group.checked && paths.length) groups.push({ name: group.name, paths })
+  }
+  return {
+    groups,
+    reverts: sel.reverts.filter((item) => item.checked).map((item) => item.path),
+    ignores: sel.ignores.filter((item) => item.checked).map((item) => item.path),
+  }
+}
+
+/** 执行载荷 → 已选动作总数（「执行所选」禁用判定）。 */
+function selectedCount(selected) {
+  let n = selected.reverts.length + selected.ignores.length
+  for (const group of selected.groups) n += group.paths.length
+  return n
+}
+
+/** 复选框元素（原生 input；仓库 UI 原语无 Checkbox，此处沿用补丁对话框的原生控件口径）。 */
+function checkBoxEl(checked, onToggle, title) {
+  return React.createElement('input', {
+    type: 'checkbox',
+    checked,
+    title,
+    onChange: () => onToggle(),
+    onClick: (event) => event.stopPropagation(),
+  })
+}
+
+/** 段头（全选框 + 标题 + 计数 + 副标题）。 */
+function sectionHeadEl(title, note, allChecked, onToggleAll, countText) {
+  return React.createElement('div', { className: 'edrv-svnplan-sechead' },
+    checkBoxEl(allChecked, onToggleAll, '全选/全不选'),
+    React.createElement('span', { className: 'edrv-svnplan-sectitle' }, title),
+    React.createElement('span', { className: 'edrv-svn-count' }, countText),
+    (note ? React.createElement('span', { className: 'edrv-svnplan-note' }, note) : null))
+}
+
+/**
+ * 阶段一 · 预览确认（按整理功能三分组）。
+ * @author ddj 2026年09月23号
+ * @param sel 勾选态
+ * @param setSel 勾选态更新
+ * @param open 组卡展开集合（组名）
+ * @param toggleOpen 组卡展开切换
+ * @returns 预览主体元素
+ */
+function previewBodyEl(sel, setSel, open, toggleOpen) {
+  /** 通用段更新（reverts/ignores 共用）。 */
+  const patchItems = (key, index, checked) => setSel((old) => ({
+    ...old,
+    [key]: old[key].map((item, i) => (i === index ? { ...item, checked } : item)),
+  }))
+  const toggleItemsAll = (key, checked) => setSel((old) => ({
+    ...old,
+    [key]: old[key].map((item) => ({ ...item, checked })),
+  }))
+  /** 组级/组内更新。 */
+  const patchGroup = (index, patch) => setSel((old) => ({
+    ...old,
+    groups: old.groups.map((group, i) => (i === index ? { ...group, ...patch } : group)),
+  }))
+  const toggleGroupAll = (index, checked) => setSel((old) => ({
+    ...old,
+    groups: old.groups.map((group, i) => (i === index
+      ? { ...group, checked, paths: group.paths.map((p) => ({ ...p, checked })) }
+      : group)),
+  }))
+
+  const groupCards = sel.groups.map((group, index) => {
+    const done = group.paths.filter((p) => p.checked).length
+    const isOpen = open.has(group.name)
+    const fileRows = isOpen
+      ? group.paths.map((item, pi) => React.createElement('div', { key: item.path, className: 'edrv-svnplan-item' },
+          checkBoxEl(item.checked, () => patchGroup(index, {
+            paths: group.paths.map((p, j) => (j === pi ? { ...p, checked: !p.checked } : p)),
+          }), item.path),
+          React.createElement('span', { className: 'edrv-svnplan-path', title: item.path }, item.path)))
+      : null
+    return React.createElement('div', { key: group.name, className: 'edrv-svnplan-card' },
+      React.createElement('div', { className: 'edrv-svnplan-row' },
+        checkBoxEl(group.checked, () => toggleGroupAll(index, !group.checked), '全选该组'),
+        React.createElement('span', {
+          className: 'edrv-svnplan-groupname',
+          title: '点击展开/收起成员',
+          onClick: () => toggleOpen(group.name),
+        }, (isOpen ? '▾ ' : '▸ ') + group.name),
+        React.createElement('span', { className: 'edrv-svn-count' }, done + '/' + group.paths.length + ' 项'),
+        (group.reason ? React.createElement('span', { className: 'edrv-svnplan-reason', title: group.reason }, group.reason) : null)),
+      fileRows)
+  })
+
+  const itemRowsOf = (key) => sel[key].map((item, index) => React.createElement('div', { key: item.path, className: 'edrv-svnplan-item' },
+    checkBoxEl(item.checked, () => patchItems(key, index, !item.checked), item.path),
+    React.createElement('span', { className: 'edrv-svnplan-path', title: item.path }, item.path),
+    (item.reason ? React.createElement('span', { className: 'edrv-svnplan-reason', title: item.reason }, item.reason) : null)))
+
+  // 段级全选：取反当前全选态（checkBoxEl 的 onToggle 不回传状态，须闭包捕获）
+  const groupsAll = sel.groups.length > 0 && sel.groups.every((g) => g.checked && g.paths.every((p) => p.checked))
+  const revertsAll = sel.reverts.length > 0 && sel.reverts.every((i) => i.checked)
+  const ignoresAll = sel.ignores.length > 0 && sel.ignores.every((i) => i.checked)
+
+  return React.createElement(React.Fragment, null,
+    React.createElement('div', { className: 'edrv-svnplan-sec' },
+      sectionHeadEl('建议分组（changelist）', '无副作用、可逆', groupsAll,
+        () => setSel((old) => ({
+          ...old,
+          groups: old.groups.map((group) => ({ ...group, checked: !groupsAll, paths: group.paths.map((p) => ({ ...p, checked: !groupsAll })) })),
+        })), sel.groups.length + ' 组'),
+      React.createElement('div', { className: 'edrv-svnplan-list' }, groupCards)),
+    React.createElement('div', { className: 'edrv-svnplan-sec' },
+      sectionHeadEl('建议还原（revert）', '放弃本地改动，默认不勾', revertsAll,
+        () => toggleItemsAll('reverts', !revertsAll), sel.reverts.length + ' 项'),
+      React.createElement('div', { className: 'edrv-svnplan-list' }, itemRowsOf('reverts'))),
+    React.createElement('div', { className: 'edrv-svnplan-sec' },
+      sectionHeadEl('建议忽略（svn:ignore）', '将写入 svn:ignore 属性，随提交进仓库，默认不勾', ignoresAll,
+        () => toggleItemsAll('ignores', !ignoresAll), sel.ignores.length + ' 项'),
+      React.createElement('div', { className: 'edrv-svnplan-list' }, itemRowsOf('ignores'))))
+}
+
+/**
+ * 阶段二 · 执行进度（阶段徽标 + 计数 + 进度条 + 逐步日志）。
+ * @author ddj 2026年09月23号
+ * @param run 执行状态
+ * @returns 进度主体元素
+ */
+function progressBodyEl(run) {
+  const pct = run.total > 0 ? Math.floor((run.index / run.total) * 100) : 0
+  const statusText = run.status === 'pausing' ? '等待当前步骤完成…（暂停在步骤边界生效）'
+    : run.status === 'paused' ? '已暂停'
+    : run.status === 'cancelling' ? '正在取消剩余步骤…'
+    : run.status === 'done' ? (run.cancelled ? '已取消剩余步骤' : '执行完毕')
+    : '执行中…'
+  const logRows = run.log.map((entry, index) => React.createElement('div', {
+    key: index,
+    className: 'edrv-svnplan-log' + (entry.ok ? '' : ' edrv-svnplan-log-bad'),
+  }, (entry.ok ? '✓ ' : '✗ ') + entry.text))
+  return React.createElement(React.Fragment, null,
+    React.createElement('div', { className: 'edrv-svnplan-stage' },
+      React.createElement('span', { className: 'edrv-svnplan-badge' }, statusText),
+      (run.cur ? React.createElement('span', { className: 'edrv-svnplan-badge edrv-svnplan-badge-cur' }, run.cur) : null),
+      React.createElement('span', { className: 'edrv-svn-count' }, run.index + '/' + run.total + ' 步')),
+    React.createElement('div', { className: 'edrv-svnplan-bar' },
+      React.createElement('div', { className: 'edrv-svnplan-bar-in', style: { width: pct + '%' } })),
+    React.createElement('div', { className: 'edrv-svnplan-logwrap' }, logRows))
+}
+
+/**
+ * AI 智能整理弹窗（预览 + 进度双阶段）。
+ * @author ddj 2026年09月23号
+ * @param props.plan 三段方案（host 已归一）
+ * @param props.meta 分析元信息 { entriesCount, diffIncluded, dropped, model, source? }（source='agent' = 混合通道）
+ * @param props.run 执行状态；null = 预览阶段（shape 见 SvnPanel runPlanSteps）
+ * @param props.onExecute 预览确认（选中载荷 → 启动执行引擎）
+ * @param props.onPause 暂停（步骤边界生效）
+ * @param props.onResume 继续
+ * @param props.onCancelRest 取消剩余
+ * @param props.onClose 关闭（预览 = 取消零副作用；执行阶段按钮仅在结束后可用）
+ * @returns 弹窗元素
+ */
+export function SvnAiPlanDialog(props) {
+  const { plan, meta, run, onExecute, onPause, onResume, onCancelRest, onClose } = props
+  const [sel, setSel] = React.useState(() => initPlanSel(plan))
+  const [open, setOpen] = React.useState(() => new Set())
+  const selected = selectedOf(sel)
+  const count = selectedCount(selected)
+
+  /** 组卡展开切换（纯 UI 态）。 */
+  const toggleOpen = (name) => {
+    const next = new Set(open)
+    if (next.has(name)) next.delete(name)
+    else next.add(name)
+    setOpen(next)
+  }
+
+  const running = run !== null && run.status !== 'done'
+  const header = React.createElement('div', { className: 'edrv-svnplan-head' },
+    React.createElement('h3', { className: 'edrv-svnlog-title' }, 'AI 智能整理 SVN 变更'),
+    // 混合通道来源标注（agent 深度分析 vs 快速通道直调）
+    (meta?.source === 'agent'
+      ? React.createElement('span', { className: 'edrv-svnplan-badge', title: '会话 AI 助手深度分析（codegraph/读文件）产出' }, 'AI 助手深度分析')
+      : null),
+    (meta?.model ? React.createElement('span', { className: 'edrv-svn-count', title: '分析模型' }, meta.model) : null),
+    React.createElement('span', { style: { flex: 1 } }),
+    React.createElement('button', {
+      className: 'edrv-svn-act',
+      title: running ? '执行中不可关闭（可取消剩余）' : '关闭',
+      disabled: running,
+      onClick: onClose,
+    }, '✕'))
+
+  const metaEl = React.createElement('div', { className: 'edrv-svnplan-meta' },
+    React.createElement('span', { className: 'edrv-svn-count' }, '分析条目 ' + (meta?.entriesCount ?? 0) + ' 项'),
+    ((meta?.dropped ?? 0) > 0 ? React.createElement('span', { className: 'edrv-svn-count' }, '已丢弃 AI 无效建议 ' + meta.dropped + ' 项') : null),
+    (meta?.diffIncluded === false
+      ? React.createElement('span', { className: 'edrv-svnplan-note' }, '未含 diff 上下文，分析精度有限')
+      : null))
+
+  let body = null
+  let footer = null
+  if (run === null) {
+    body = previewBodyEl(sel, setSel, open, toggleOpen)
+    footer = React.createElement('div', { className: 'edrv-svnplan-foot' },
+      React.createElement('span', { className: 'edrv-svn-count' }, '已选 ' + count + ' 项'),
+      React.createElement('span', { style: { flex: 1 } }),
+      React.createElement('button', { className: 'edrv-svn-act', title: '不执行任何动作', onClick: onClose }, '取消'),
+      React.createElement('button', {
+        className: 'edrv-svn-act edrv-svnplan-primary',
+        title: '执行全部勾选项（未勾选不动）',
+        disabled: count === 0,
+        onClick: () => onExecute(selected),
+      }, '执行所选（' + count + ' 项）'))
+  } else {
+    body = progressBodyEl(run)
+    footer = React.createElement('div', { className: 'edrv-svnplan-foot' },
+      React.createElement('span', { style: { flex: 1 } }),
+      (run.status === 'done'
+        ? React.createElement('button', {
+            className: 'edrv-svn-act edrv-svnplan-primary',
+            title: '关闭弹窗并刷新变更列表',
+            onClick: onClose,
+          }, '关闭并刷新')
+        : React.createElement(React.Fragment, null,
+            React.createElement('button', {
+              className: 'edrv-svn-act',
+              title: run.status === 'running' || run.status === 'pausing'
+                ? '暂停（当前步骤完成后生效）'
+                : '从断点继续执行',
+              disabled: run.status === 'pausing' || run.status === 'cancelling',
+              onClick: run.status === 'paused' ? onResume : onPause,
+            }, run.status === 'paused' ? '继续' : '暂停'),
+            React.createElement('button', {
+              className: 'edrv-svn-act edrv-svn-act-danger',
+              title: '终止未执行步骤（已执行部分不回滚）',
+              disabled: run.status === 'cancelling',
+              onClick: onCancelRest,
+            }, '取消剩余'))))
+  }
+
+  return React.createElement(ModalShell, {
+    key: 'edrv-svn-plan',
+    dialogClass: 'edrv-svnplan-dialog',
+    width: 'min(680px, calc(100vw - 48px))',
+    closeOnMask: !running,
+    closeOnEsc: !running,
+    onClose,
+  }, header, metaEl, body, footer)
+}

package/src/client/ui/icons.ts

@@ -0,0 +1,91 @@
+/**
+ * dsh-vscode-mode client — UI 原语图标跨版本出口（消费方导出名保持 ≤0.1.6 旧名）。
+ * 背景：DSH 0.1.7 图标命名重构——`Icon<Name>16`（0.1.6 及更旧）→
+ * `Icon<Name>Regular/Medium`（0.1.7+，size 参数化 + 双笔画档），旧名在 0.1.7
+ * 全树已不存在（整树 grep 实证）。解析策略：namespace import 属性探测，旧名优先
+ * （现网 0.1.6）→ 新名次之（0.1.7+）→ 皆缺走通用占位（第三态不炸渲染）；
+ * 打包期 external 不校验成员存在性，两代运行时均稳（能力探测，不做版本判定）。
+ * 调用点零语义变化：导出名与旧垫片一致，仅改 import 来源。
+ * @author ddj 2026年09月22号
+ */
+import React from 'react'
+import * as primitives from '@deepseek-ai/dsh-client-ui-primitives'
+import { classifyFileType, FileTypeIcon } from '@deepseek-ai/dsh-client-ui-primitives'
+import type { EdrvIconProps } from '@deepseek-ai/dsh-client-ui-primitives'
+
+/** 图标组件形状（与垫片 EdrvIconProps 兼容）。 */
+type IconComponent = (props: EdrvIconProps) => unknown
+
+/**
+ * 通用占位图标（两代皆缺的第三态兜底：空态方框，不抛错不白屏）。
+ * @author ddj 2026年09月22号
+ * @param props 图标 props（size/className 透传）
+ * @returns React 元素
+ */
+function fallbackIcon(props: EdrvIconProps): unknown {
+  return React.createElement('svg', {
+    width: props.size ?? 16,
+    height: props.size ?? 16,
+    viewBox: '0 0 16 16',
+    className: props.className,
+    'aria-hidden': true,
+    focusable: false,
+  }, React.createElement('rect', {
+    x: 3.5, y: 3.5, width: 9, height: 9, rx: 2,
+    fill: 'none', stroke: 'currentColor', strokeWidth: 1.2, opacity: 0.45,
+  }))
+}
+
+/**
+ * 按候选名序列解析图标组件（首个存在的函数命中；皆缺返回占位）。
+ * @author ddj 2026年09月22号
+ * @param names 候选导出名（旧名在前、新名在后）
+ * @returns 图标组件
+ */
+function iconOf(...names: string[]): IconComponent {
+  const table = primitives as unknown as Record<string, unknown>
+  for (const name of names) {
+    const hit = table[name]
+    if (typeof hit === 'function') return hit as IconComponent
+  }
+  return fallbackIcon
+}
+
+// 两代语义等价的图标对（旧名 → 0.1.7 Regular 档；Medium 档不用于本插件 16px 场景）
+/** 目录闭合图标（官方文件树同款）。 */
+export const IconFolderClose16 = iconOf('IconFolderClose16', 'IconFolderCloseRegular')
+/** 目录展开图标（官方文件树同款）。 */
+export const IconFolderOpen16 = iconOf('IconFolderOpen16', 'IconFolderOpenRegular')
+/** 目录轮廓图标（活动栏「文件管理」）。 */
+export const IconFolderOpenOutline16 = iconOf('IconFolderOpenOutline16', 'IconFolderOpenOutlineRegular')
+/** 刷新图标（面板工具条）。 */
+export const IconRefreshOutline16 = iconOf('IconRefreshOutline16', 'IconRefreshOutlineRegular')
+/** 搜索图标（活动栏「搜索」）。 */
+export const IconSearchOutline16 = iconOf('IconSearchOutline16', 'IconSearchOutlineRegular')
+/** 列表+笔图标（活动栏「规则」）。 */
+export const IconListPenOutline16 = iconOf('IconListPenOutline16', 'IconListPenOutlineRegular')
+/** 代码图标（活动栏「大纲」）。 */
+export const IconCodeOutline16 = iconOf('IconCodeOutline16', 'IconCodeOutlineRegular')
+/** 分支图标（SVN 面板）。 */
+export const IconBranchOutline16 = iconOf('IconBranchOutline16', 'IconBranchOutlineRegular')
+
+// 两代同名存活的原语：直通再导出（0.1.6/0.1.7 实证均在）
+export { FileTypeIcon, classifyFileType } from '@deepseek-ai/dsh-client-ui-primitives'
+
+/**
+ * 文件图标元素（官方 FileTypeIcon + classifyFileType 分类，未知类型为 other）。
+ * 文件树与 SVN 变更行共用（原为 FileExplorer 私有副本，上移共享防两处漂移）。
+ * @author ddj 2026年09月23号
+ * @param name 文件名（含扩展名；目录由调用方走目录图标）
+ * @returns 图标元素；原语缺失或分类异常返回 null
+ */
+export function fileIconEl(name: string): React.ReactElement | null {
+  if (typeof FileTypeIcon !== 'function' || typeof classifyFileType !== 'function') return null
+  try {
+    // FileTypeIcon 签名为 (props) => ReactNode（非 ReactElement），createElement 重载不认——
+    // 纯函数组件直接调用并收窄返回类型（与 FileExplorer 原 createElement 等效）。
+    return FileTypeIcon({ kind: classifyFileType(String(name ?? '')), size: 16, className: 'edrv-tree-icon' }) as React.ReactElement
+  } catch (error) {
+    return null
+  }
+}

package/src/compat.ts

@@ -10,7 +10,7 @@ import { readFileSync } from 'node:fs'
 import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { entriesOf } from './mcp.js'
-import { loadSettingsDeps, schemaLibName, settingsInstallNote, settingsInstallStrategy } from './fileOpenSettings.js'
+import { loadSettingsDeps, schemaLibName, settingsInstallNote, settingsInstallStrategy, configVolatileState } from './fileOpenSettings.js'
 import { readDevForm } from './devForm.js'
 import { compareDshVersions, detectDshVersion, familyLabel, parseDshVersion } from './dshVersion.js'
 import { SKILL_PREFIXES, skillGroupState } from './skills.js'
@@ -133,9 +133,12 @@ export function detectGuards(ctx: Ctx): CompatAdapter[] {
 }
 
 /** 已实测覆盖的最高 DSH 版本（适配矩阵上界，超过则提示，见 buildReport）。 */
-const TESTED_DSH_MAX = '0.1.6-alpha.2'
+const TESTED_DSH_MAX = '0.1.7-alpha.2'
 
-/** 版本适配机制状态行：DSH 版本探测 + 设置 section 安装策略。 */
+/** Config volatile 标记起效的版本线（此前设置走 section 安装，与 volatile 无关）。 */
+const CONFIG_VOLATILE_MIN = '0.1.7-alpha.1'
+
+/** 版本适配机制状态行：DSH 版本探测 + 设置 section 安装策略 + Config volatile 标记。 */
 export function versionAdapters(dshVersion: string): CompatAdapter[] {
   const adapters: CompatAdapter[] = []
   const parsed = parseDshVersion(dshVersion)
@@ -149,15 +152,27 @@ export function versionAdapters(dshVersion: string): CompatAdapter[] {
   const strategy = settingsInstallStrategy()
   adapters.push({
     name: '设置 section 安装（版本适配）',
-    active: strategy === 'legacy' || strategy === 'service',
+    active: strategy === 'legacy' || strategy === 'service' || strategy === 'forms',
     note: settingsInstallNote(),
   })
+  // 追加在末尾（既有下标有断言）；仅 Config 按 volatile 语义构建过才展示该行
+  const volatileState = configVolatileState()
+  if (volatileState.requested) {
+    const volatileOk = volatileState.total > 0 && volatileState.marked === volatileState.total
+    adapters.push({
+      name: 'Config volatile 字段（0.1.7 设置页）',
+      active: volatileOk,
+      note: volatileOk
+        ? volatileState.marked + '/' + volatileState.total + ' 已标记（SettingsForms 可下发本插件 ns）'
+        : volatileState.marked + '/' + volatileState.total + ' 已标记：schemastery 依赖过旧无 .volatile()，0.1.7 设置页不可用',
+    })
+  }
   return adapters
 }
 
 /**
  * 构建完整兼容性报告（RPC 与启动日志共用）。
- * @author ddj 2026年08月24号 / 2026年09月02号
+ * @author ddj 2026年08月24号 / 2026年09月02号 / 2026年09月23号
  * @param ctx DSH host 上下文
  * @param options 测试注入：depsAvailable 跳过动态导入、version 固定插件版本、dshVersion 固定 DSH 版本
  * @returns 兼容性报告
@@ -180,6 +195,12 @@ export async function buildReport(
   if (parsed && testedMax && compareDshVersions(parsed, testedMax) > 0) {
     warnings.push('DSH ' + dshVersion + ' 高于已实测版本（' + TESTED_DSH_MAX + '）：设置 API 按能力探测运行，异常时请回报适配矩阵')
   }
+  // 0.1.7 线上 Config 未完成 volatile 标记 = 设置页不可用（ns 不下发），显式告警而非静默
+  const volatileState = configVolatileState()
+  const volatileMin = parseDshVersion(CONFIG_VOLATILE_MIN)
+  if (volatileState.requested && volatileState.marked < volatileState.total && parsed && volatileMin && compareDshVersions(parsed, volatileMin) >= 0) {
+    warnings.push('插件 Config volatile 标记不完整（' + volatileState.marked + '/' + volatileState.total + '）：@deepseek-ai/schemastery 依赖过旧，0.1.7 设置页不可用（重装插件依赖后重启 DSH）')
+  }
   for (const guard of guards) {
     if (!guard.active && guard.note) warnings.push(guard.note)
   }

package/src/dshVersion.ts

@@ -85,13 +85,14 @@ export function inDshRange(version: DshVersion | null | undefined, range: DshRan
 /**
  * 版本线标签：报告与文档展示版本归属；不可解析返回 '未知'。
  * 逐线自新到旧匹配，先命中先返回（区间无上界，故顺序即优先级）。
- * @author ddj 2026年09月02号 / 2026年09月18号
+ * @author ddj 2026年09月02号 / 2026年09月18号 / 2026年09月22号
  * @param input 版本串（如 '0.1.6-alpha.2'）
  * @returns 版本线标签
  */
 export function familyLabel(input: string): string {
   const version = parseDshVersion(input)
   if (!version) return '未知'
+  if (inDshRange(version, { from: '0.1.7-alpha.1' })) return '0.1.7-alpha.1 及更新（设置=profile Config + configForms 客户端面 + 会话 V4）'
   if (inDshRange(version, { from: '0.1.6-alpha.2' })) return '0.1.6-alpha.2 及更新（会话多实例共存 + 回合改动卡片 + Office 侧栏预览 + 侧栏浏览器）'
   if (inDshRange(version, { from: '0.1.6-alpha.1' })) return '0.1.6-alpha 及更新（MCP SDK v2 + Web 侧边栏终端 + 文件链接默认侧栏预览）'
   if (inDshRange(version, { from: '0.1.5-alpha.1' })) return '0.1.5-alpha 及更新（官方右侧 Sidebar 编辑区 + sidebar.panellist）'