dsh-vscode-mode 0.7.0 → 0.8.0

package/src/client/ui/EditorView.ts

@@ -11,10 +11,12 @@ import React from 'react'
 import { dbg, rpc } from '../rpc.js'
 import { emitFileChanged, emitRefresh } from '../events.js'
 import { langOf, loadMonaco, snippetLanguageOf } from '../monaco/loader.js'
-import { dataUrlOf, isImagePath, isSvgPath } from '../imagePreview.js'
+import { clampZoom, clearZoomMem, dataUrlOf, isImagePath, isSvgPath, recallZoom, rememberZoom, zoomKeyOf, zoomStepOf } from '../imagePreview.js'
 import { isMarkdownPath } from '../markdownPreview.js'
 import { MarkdownPanel } from '../md/mdPanel.js'
-import { base64ToBytes, isPdfPath } from '../pdfPreview.js'
+import { base64ToBytes, bytesToBase64, isPdfPath } from '../pdfPreview.js'
+import { inNativePath, tryNativeOpen } from '../nativeOpenStore.js'
+import { readBinaryPreview } from '../../shared/rpc.js'
 import {
   clearBaseline,
   clearReadVersion,
@@ -121,6 +123,22 @@ function dirOfRel(relPath) {
 /** 跳转目标高亮的保留时长（LSP/搜索跳转落地后给用户的位置提示，到期自动清除）。 */
 const NAV_FLASH_MS = 1200
 
+/** 二进制通道回退日志的一次性闸（整页仅报一次，避免每次读图/读 PDF 刷屏）。 */
+let binFallbackLogged = false
+
+/**
+ * 二进制通道回退的一次性诊断日志：readBinaryPreview 本次尝试过新通道并失败时上报。
+ * 有效期：随页面生命周期仅一条；dbg 本身受诊断开关控制（关=零输出零落盘）。
+ * @author ddj 2026年09月22号
+ * @param sid 会话 id
+ * @param out readBinaryPreview 统一结果（带 probed 才说明本次尝试过新通道）
+ */
+const noteBinFallback = (sid, out) => {
+  if (binFallbackLogged || !out?.probed) return
+  binFallbackLogged = true
+  dbg(sid, 'edrv.readBinary 不可用（host 未接线/旧版或网络失败），已回退 base64', 'debug')
+}
+
 /**
  * 从 Monaco 语言目录取可选语言 id 列表（代码片段新建时的语言下拉来源）。
  * 旧版 Monaco / 目录不可读时返回 undefined，由调用方回落 shared 的内置常量。
@@ -197,6 +215,8 @@ export function EditorView(props) {
   const [imageSrc, setImageSrc] = React.useState(null) // 图片预览 data URL（图片 tab 专用，文本 tab 恒为 null）
   const [imgSize, setImgSize] = React.useState(null) // 图片自然尺寸 { w, h }（路径栏 meta）
   const [imgBroken, setImgBroken] = React.useState(false) // 图片解码失败（onError），显示占位与重试
+  const [imgZoom, setImgZoom] = React.useState(null) // 图片缩放比例（null=适应宽度；会话+路径级记忆，见 imagePreview.zoomKeyOf）
+  const imgElRef = React.useRef(null) // 预览 <img> 元素（适应宽度态下步进取实测缩放基准）
   const svgTextRef = React.useRef(new Set()) // 强制以文本打开的 SVG 路径集合（toggleSvgText 维护）
   const mdPreviewRef = React.useRef(new Set()) // 处于预览态的 Markdown 路径集合（toggleMdPreview 维护；不持久化）
   const [pdfBytes, setPdfBytes] = React.useState(null) // 当前 PDF tab 的原始字节（null=加载中/非 PDF）
@@ -828,26 +848,36 @@ export function EditorView(props) {
     setImgSize(null)
     setImgBroken(false)
     setLoadStage({ progress: monaco ? 72 : 12, message: '读取图片…' })
-    rpc('edrv.read', { sessionId: sid, path, encoding: 'base64' }).then((res) => {
+    readBinaryPreview(rpc, { sessionId: sid, path }).then((out) => {
       if (seq !== loadSeqRef.current || path !== active) return
-      if (res && res.ok && res.encoding === 'base64') {
-        if (!res.mime) {
+      if (out.ok && out.via === 'binary') {
+        // 新通道：原始字节本地组 data URL（线上省 base64，本地编码为 img src 所需不可省）
+        recordBaseline(scope, path, out.version || version)
+        clearReadVersion(scope, path) // 刚读过内容：已读版本台账失效，下一轮按新版本比对
+        setImageSrc(dataUrlOf(bytesToBase64(out.bytes), out.mime))
+        setLoadStage({ progress: 100, message: '图片已就绪' })
+        setStatus('已加载')
+        return
+      }
+      noteBinFallback(sid, out)
+      if (out.ok && out.via === 'base64') {
+        if (!out.mime) {
           setLoadError('host 版本过旧：图片响应缺少 mime')
           setError('host 版本过旧：图片响应缺少 mime')
           setStatus('读取失败')
           return
         }
-        const imgVersion = res.version ?? version
+        const imgVersion = out.version ?? version
         recordBaseline(scope, path, imgVersion)
         clearReadVersion(scope, path) // 刚读过内容：已读版本台账失效，下一轮按新版本比对
-        setImageSrc(dataUrlOf(res.content, res.mime))
+        setImageSrc(dataUrlOf(out.content, out.mime))
         setLoadStage({ progress: 100, message: '图片已就绪' })
         setStatus('已加载')
         return
       }
-      const base = res?.error ? String(res.error) : '读取失败'
+      const base = out.error ? String(out.error) : '读取失败'
       // 带出 host 解析后的真实路径：跳转失败时一眼看出是路径解析错还是目标不存在
-      const message = res?.resolvedPath ? base + '：' + String(res.resolvedPath) : base
+      const message = out.resolvedPath ? base + '：' + String(out.resolvedPath) : base
       setLoadError(message)
       setError(message)
       setStatus('读取失败')
@@ -884,21 +914,34 @@ export function EditorView(props) {
       setStatus('已加载')
       return
     }
-    rpc('edrv.read', { sessionId: sid, path, encoding: 'base64' }).then((res) => {
+    readBinaryPreview(rpc, { sessionId: sid, path }).then((out) => {
       if (seq !== loadSeqRef.current || path !== active) return
-      if (res && res.ok && res.encoding === 'base64') {
-        const pdfVersion = res.version ?? version
+      if (out.ok && out.via === 'binary') {
+        const pdfVersion = out.version || version
+        recordBaseline(scope, path, pdfVersion)
+        clearReadVersion(scope, path) // 刚读过内容：已读版本台账失效，下一轮按新版本比对
+        // 缓存仍存 base64（pdfB64CacheRef 形状不变，命中路径零改动）；字节直通面板省一次解码
+        cache.set(path, bytesToBase64(out.bytes))
+        while (cache.size > 6) cache.delete(cache.keys().next().value)
+        setPdfBytes(out.bytes)
+        setLoadStage({ progress: 100, message: 'PDF 已就绪' })
+        setStatus('已加载')
+        return
+      }
+      noteBinFallback(sid, out)
+      if (out.ok && out.via === 'base64') {
+        const pdfVersion = out.version ?? version
         recordBaseline(scope, path, pdfVersion)
         clearReadVersion(scope, path) // 刚读过内容：已读版本台账失效，下一轮按新版本比对
-        cache.set(path, res.content)
+        cache.set(path, out.content)
         while (cache.size > 6) cache.delete(cache.keys().next().value)
-        setPdfBytes(base64ToBytes(res.content))
+        setPdfBytes(base64ToBytes(out.content))
         setLoadStage({ progress: 100, message: 'PDF 已就绪' })
         setStatus('已加载')
         return
       }
-      const base = res?.error ? String(res.error) : '读取失败'
-      const message = res?.resolvedPath ? base + '：' + String(res.resolvedPath) : base
+      const base = out.error ? String(out.error) : '读取失败'
+      const message = out.resolvedPath ? base + '：' + String(out.resolvedPath) : base
       setLoadError(message)
       setError(message)
       setStatus('读取失败')
@@ -1369,6 +1412,10 @@ export function EditorView(props) {
       if (!event?.detail?.scope || event.detail.scope === scope) setSvnStatus(getSvnStatus(scope))
     }
     window.addEventListener('edrv:svn-status', onSvnStatus)
+    // 缓存命中时 ensure 直接 return、不广播事件，须同步读回当前 scope 的载荷：
+    // 否则从非 SVN 工作区切回 SVN 工作区后，状态残留上一个工作区的 managed:false，
+    // 右键菜单/页签菜单的 SVN 组会整组消失（与下方变更清单 effect 的同步语句同理）。
+    setSvnStatus(getSvnStatus(scope))
     return () => window.removeEventListener('edrv:svn-status', onSvnStatus)
   }, [sessionId, scope])
 
@@ -1908,6 +1955,7 @@ export function EditorView(props) {
     // model 不在此销毁：跨挂载缓存按作用域存活（modelCache 切作用域时统一释放）
     for (const ctl of pdfCtlRef.current.values()) ctl.destroy()
     pdfCtlRef.current.clear()
+    clearZoomMem() // 图片缩放记忆随 EditorView 卸载清空（会话级生命周期，不持久化）
     const root = editorRef.current && editorRef.current.getDomNode ? editorRef.current.getDomNode() : null
     if (root) {
       const ov = root.querySelector('.edrv-minus-overlay')
@@ -2401,15 +2449,58 @@ export function EditorView(props) {
   }
   toggleMdPreviewRef.current = toggleMdPreview
 
+  /** 当前图片的会话+路径级缩放记忆键（页签切换回来保留同一缩放）。 */
+  const imgZoomKey = zoomKeyOf(sessionId, active)
+
+  // 页签/会话切换时恢复该图片的记忆缩放（无记忆 = 初始适应宽度，等价 PDF page-width）
+  React.useEffect(() => { setImgZoom(recallZoom(imgZoomKey)) }, [imgZoomKey])
+
   /**
-   * 图片预览面板：工具条（尺寸 meta / SVG 文本切换 / 刷新）+ 棋盘底自适应图片。
-   * @author ddj 2026年09月08号
+   * 应用图片缩放并写入页签记忆（null = 适应宽度；数值经 clampZoom 收敛 25%–400%）。
+   * @author ddj 2026年09月22号
+   * @param next 目标缩放（null = 适应宽度）
+   */
+  const applyImgZoom = (next) => {
+    const value = next === null ? null : clampZoom(next)
+    setImgZoom(value)
+    rememberZoom(imgZoomKey, value)
+  }
+
+  /**
+   * 图片缩放步进（10%/档，clamp 25%–400%）；适应宽度态先按渲染尺寸实测当前缩放作基准。
+   * @author ddj 2026年09月22号
+   * @param dir 方向：1 放大 / -1 缩小
+   */
+  const stepImgZoom = (dir) => {
+    const el = imgElRef.current
+    const measured = el && el.naturalWidth ? el.clientWidth / el.naturalWidth : 1
+    applyImgZoom(zoomStepOf(imgZoom ?? measured, dir))
+  }
+
+  /**
+   * 图片预览面板：工具条（尺寸 meta / 缩放 −＋适应宽度 / SVG 文本切换 / 刷新）+ 棋盘底图片。
+   * 初始适应宽度（等价 PDF page-width，0.1.7 官方统一缩放）；按钮样式与 PDF 工具条同款。
+   * @author ddj 2026年09月08号 / 2026年09月22号
    */
   const imagePanel = () => React.createElement('div', { className: 'edrv-imgview' },
     React.createElement('div', { className: 'edrv-imgview-bar' },
       React.createElement('span', { className: 'edrv-imgview-meta' },
         imgBroken ? '图片无法显示' : (imgSize ? imgSize.w + '×' + imgSize.h : '…')),
       React.createElement('span', { style: { flex: 1 } }),
+      React.createElement('span', { className: 'edrv-pdf-page' },
+        imgZoom === null ? '适应' : Math.round(imgZoom * 100) + '%'),
+      React.createElement('button', {
+        className: 'edrv-pill edrv-pill-ghost edrv-pdf-zoom', title: '缩小（10%/档）',
+        onClick: () => stepImgZoom(-1),
+      }, '−'),
+      React.createElement('button', {
+        className: 'edrv-pill edrv-pill-ghost edrv-pdf-zoom', title: '放大（10%/档）',
+        onClick: () => stepImgZoom(1),
+      }, '＋'),
+      React.createElement('button', {
+        className: 'edrv-pill edrv-pill-ghost', title: '恢复适应宽度',
+        disabled: imgZoom === null, onClick: () => applyImgZoom(null),
+      }, '适应宽度'),
       (isSvgPath(active) ? React.createElement('button', {
         className: 'edrv-pill edrv-pill-ghost', title: '以文本方式查看/编辑（SVG 为文本格式）',
         onClick: () => toggleSvgText(active),
@@ -2422,8 +2513,12 @@ export function EditorView(props) {
             React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', onClick: () => reloadFile() }, '重试'))
         : React.createElement('img', {
             className: 'edrv-imgview-img',
+            ref: imgElRef,
             src: imageSrc,
             alt: active || '',
+            style: (imgZoom !== null && imgSize)
+              ? { width: Math.round(imgSize.w * imgZoom) + 'px', maxWidth: 'none', maxHeight: 'none' }
+              : undefined,
             onLoad: (e) => { setImgBroken(false); setImgSize({ w: e.target.naturalWidth, h: e.target.naturalHeight }) },
             onError: () => setImgBroken(true),
           }))))
@@ -2996,6 +3091,10 @@ export function EditorView(props) {
 
   const openFile = (path, focusDiff) => {
     if (!path) return
+    // 原生打开范围（nativeOpenExts 设置）：命中且非差异跳转 → 走官方渲染器
+    //（focusDiff=true 跳过：差异审查对象必为本插件编辑的文本文件，审查优先）；
+    // handler 缺失/失败（旧版无 openResource / seat 未挂）→ 回退现状页签打开，不阻断
+    if (!focusDiff && inNativePath(path) && tryNativeOpen(path)) return
     // 打开文件即离开基线差异审阅态（差异视图是「当前文件」的临时视图）
     setSvnDiff(null)
     recordNav()

package/src/client/ui/McpSettings.ts

@@ -13,6 +13,7 @@ import { SettingsContext } from '../settingsContext.js'
 import { normalizeSidebarMinWidth, SIDEBAR_MIN_DEFAULT } from '../sidebarMin.js'
 import { EDITOR_LIMIT_CEIL, EDITOR_LIMIT_DEFAULT, normalizeMaxOpenEditors } from '../../shared/editorLimit.js'
 import { TORTOISE_DIR_DEFAULT } from '../../shared/svn.js'
+import { DEFAULT_NATIVE_CSV } from '../../shared/nativeOpen.js'
 import { KeybindingsPanel } from './KeybindingsPanel.js'
 import { LspSettings } from './LspSettings.js'
 import { PerfSettings } from './PerfSettings.js'
@@ -139,6 +140,8 @@ function GeneralSettings({ registry }) {
   const [minDraft, setMinDraft] = React.useState(null) // 输入草稿（null=跟随已保存值；blur/Enter 提交）
   const [limit, setLimit] = React.useState(EDITOR_LIMIT_DEFAULT)
   const [limitDraft, setLimitDraft] = React.useState(null) // 页签上限草稿（同上提交语义）
+  const [nativeSaved, setNativeSaved] = React.useState(DEFAULT_NATIVE_CSV) // 原生打开范围已保存值
+  const [nativeDraft, setNativeDraft] = React.useState(null) // 原生打开范围草稿（同上提交语义）
   const settings = React.useContext(SettingsContext)
   const snapshot = settings?.getSnapshot?.()
   const loading = !snapshot || snapshot.status === 'loading'
@@ -151,6 +154,8 @@ function GeneralSettings({ registry }) {
       if (typeof next === 'string') setTool(next)
       setMinW(normalizeSidebarMinWidth(snap?.value?.sidebarMinWidth))
       setLimit(normalizeMaxOpenEditors(snap?.value?.maxOpenEditors))
+      const native = snap?.value?.nativeOpenExts
+      setNativeSaved(typeof native === 'string' && native.trim() ? native : DEFAULT_NATIVE_CSV)
     }
     onChange()
     return settings?.subscribe?.(onChange)
@@ -191,6 +196,18 @@ function GeneralSettings({ registry }) {
     setLimitDraft(null)
     saveLimit(limitDraft)
   }
+  /** 提交原生打开范围（逗号分隔后缀；空串回落默认让位清单后持久化）。 */
+  const saveNative = (raw) => {
+    const next = String(raw ?? '').trim() || DEFAULT_NATIVE_CSV
+    setNativeSaved(next); setNativeDraft(null); setBusy(true); setError('')
+    if (!settings?.set) { setError('设置服务不可用'); setBusy(false); return }
+    settings.set('nativeOpenExts', next).catch((e) => setError(String(e))).finally(() => setBusy(false))
+  }
+  /** 结束输入（blur/Enter）时提交原生打开范围草稿。 */
+  const commitNative = () => {
+    if (nativeDraft === null) return
+    saveNative(nativeDraft)
+  }
   const closeDevForm = () => {
     if (!window.confirm('关闭开发形态：插件将切换为正式版安装（版本依赖 + 删除工作区链接），pnpm 装配后需重启 DSH 生效。确认关闭？')) return
     setDevBusy(true)
@@ -249,6 +266,19 @@ function GeneralSettings({ registry }) {
             onKeyDown: (event) => { if (event.key === 'Enter') commitLimit() },
           }),
           React.createElement('small', null, '0 = 不限制；超限时关闭最久未使用的页签（固定页签除外）')),
+        React.createElement('label', { className: 'vsm-general-row' },
+          React.createElement('span', null, '原生打开范围'),
+          React.createElement('input', {
+            type: 'text',
+            value: nativeDraft ?? nativeSaved,
+            disabled: loading || unavailable || notReady || busy || snapshot?.writable === false,
+            title: '逗号分隔后缀（如 doc,xlsx）：文件树点击命中时用 DSH 官方预览原生打开；留空 = 默认让位清单（Office + 不可预览二进制）',
+            placeholder: 'doc,xlsx,…（留空恢复默认）',
+            onChange: (event) => setNativeDraft(event.target.value),
+            onBlur: commitNative,
+            onKeyDown: (event) => { if (event.key === 'Enter') commitNative() },
+          }),
+          React.createElement('small', null, '逗号分隔；命中的文件用 DSH 原生预览打开，留空恢复默认（Office + 二进制，csv/tsv 需显式加入）')),
       ),
     ),
     React.createElement(SvnSettingsSection, null),

package/src/client/ui/PerfSettings.ts

@@ -1,7 +1,7 @@
 // @ts-nocheck
 /**
  * dsh-vscode-mode client — PerfSettings：「性能优化」设置子页（会话卫生 + 压缩调优）。
- * - 会话盘点：全工作区/每会话体积、活跃标记，按体积排序；
+ * - 会话盘点：全工作区/每会话体积、活跃标记、官方归档/置顶徽标，按体积排序；
  * - 移出到归档（先规划→确认→执行→可恢复）与归档清除；
  * - DSH 内置压缩调优：写 profile patch（compaction-basic / tool-result-pruner 更低阈值，
  *   带备份与撤销，需重启生效）；
@@ -67,6 +67,9 @@ function SessionRow({ row, checked, disabled, onToggle }) {
     React.createElement('span', { className: 'vsm-perf-cell vsm-perf-size ' + (row.bytes >= 1024 * 1024 ? 'big' : '') }, formatBytes(row.bytes)),
     React.createElement('span', { className: 'vsm-perf-cell vsm-perf-mtime', title: new Date(row.mtime).toLocaleString() }, when),
     row.active ? React.createElement('span', { className: 'vsm-perf-cell vsm-perf-active' }, '活跃') : null,
+    // 官方侧栏归档/置顶状态徽标（旧 host 不回传字段 → undefined 按 false，不渲染；样式复用面板现有 vsm-perf-active 徽标）
+    row.archived ? React.createElement('span', { className: 'vsm-perf-cell vsm-perf-active', title: '官方侧栏已归档（持久标志位，未搬目录）' }, '已归档') : null,
+    row.pinned ? React.createElement('span', { className: 'vsm-perf-cell vsm-perf-active', title: '官方侧栏已置顶' }, '已置顶') : null,
   )
 }
 

package/src/client/ui/icons.ts

@@ -0,0 +1,72 @@
+/**
+ * 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 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'

package/src/compat.ts

@@ -133,7 +133,7 @@ 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.1'
 
 /** 版本适配机制状态行：DSH 版本探测 + 设置 section 安装策略。 */
 export function versionAdapters(dshVersion: string): CompatAdapter[] {
@@ -149,7 +149,7 @@ 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(),
   })
   return adapters

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）'