dsh-vscode-mode 0.7.0 → 0.9.0

package/src/client/ui/EditorView.ts

@@ -11,10 +11,13 @@ 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 { clearPendingNav, putPendingNav, readPendingNav } from '../pendingNav.js'
+import { readBinaryPreview } from '../../shared/rpc.js'
 import {
   clearBaseline,
   clearReadVersion,
@@ -121,6 +124,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 +216,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 +849,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 +915,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) // 刚读过内容：已读版本台账失效，下一轮按新版本比对
-        cache.set(path, res.content)
+        // 缓存仍存 base64（pdfB64CacheRef 形状不变，命中路径零改动）；字节直通面板省一次解码
+        cache.set(path, bytesToBase64(out.bytes))
         while (cache.size > 6) cache.delete(cache.keys().next().value)
-        setPdfBytes(base64ToBytes(res.content))
+        setPdfBytes(out.bytes)
         setLoadStage({ progress: 100, message: 'PDF 已就绪' })
         setStatus('已加载')
         return
       }
-      const base = res?.error ? String(res.error) : '读取失败'
-      const message = res?.resolvedPath ? base + '：' + String(res.resolvedPath) : base
+      noteBinFallback(sid, out)
+      if (out.ok && out.via === 'base64') {
+        const pdfVersion = out.version ?? version
+        recordBaseline(scope, path, pdfVersion)
+        clearReadVersion(scope, path) // 刚读过内容：已读版本台账失效，下一轮按新版本比对
+        cache.set(path, out.content)
+        while (cache.size > 6) cache.delete(cache.keys().next().value)
+        setPdfBytes(base64ToBytes(out.content))
+        setLoadStage({ progress: 100, message: 'PDF 已就绪' })
+        setStatus('已加载')
+        return
+      }
+      const base = out.error ? String(out.error) : '读取失败'
+      const message = out.resolvedPath ? base + '：' + String(out.resolvedPath) : base
       setLoadError(message)
       setError(message)
       setStatus('读取失败')
@@ -1369,6 +1413,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 +1956,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')
@@ -2209,6 +2258,12 @@ export function EditorView(props) {
   // 「已就绪」会提前定位；随后真实内容到达触发 model 重设/内容写入，Monaco 会重置光标，
   // 落点丢失且 pendingFocus 已消费，最终停在 {1,1}。实测（v0.4.6，Ctrl+点击枚举成员）：
   // opener 正确派发 line=349，落地后编辑器实际停在 1:1 且无高亮；同文件跳转不换内容故不复现。
+  //
+  // ⚠️ 第三次事故（2026-09-23 实测取证）：并行改码触发插件 client HMR 热重载
+  // （保留 console 装配日志重复 6-7 轮为证）→ 本组件被重挂载 → 挂载级 pendingFocusRef
+  // 随旧实例销毁 → 「首开只打开文件不落行、热重载平息后第二次才正常」。
+  // 修复：openFileAt 同步写 window.__edrvPendingNav__ 槽（跨热重载存活），本 effect 取
+  // ref || 槽、成功落点后一并清；并加模型身份守卫（模型不是目标文件时不清、等重跑）。
   React.useEffect(() => {
     const ed = editorRef.current
     if (!ed || !contentReady) return
@@ -2226,11 +2281,24 @@ export function EditorView(props) {
       ed.focus()
       return
     }
-    const pf = pendingFocusRef.current
+    // 快路径 = 挂载级 ref；交接路径 = window 槽（热重载重挂载后 ref 已丢、槽仍在）
+    const refPf = pendingFocusRef.current
+    const slotNav = refPf ? null : readPendingNav()
+    const pf = refPf || (slotNav
+      ? { path: slotNav.path, region: null, line: slotNav.line ?? null, column: slotNav.column ?? 1, endLine: slotNav.endLine ?? null, endColumn: slotNav.endColumn ?? null }
+      : null)
     if (!pf || !sameFile(pf.path, active)) return
+    // 单一清除点：ref 与 window 槽一并处理，防残留二次跳
+    const dropPending = () => {
+      pendingFocusRef.current = null
+      if (pf.line != null) clearPendingNav()
+    }
+    // 模型身份守卫：编辑器模型必须已是目标文件才落点；不匹配则保留 pending（不清），
+    // 依赖变化后的下一次运行再落（model 同步 effect 声明在本 effect 之前、同帧先执行）。
     if (pf.line != null) {
+      if (!sameFile(modelPathOf(ed), pf.path)) return
       // 搜索命中 / LSP 跳转：直接定位到行/列（不依赖差异区域）并高亮目标区域
-      pendingFocusRef.current = null
+      dropPending()
       const line = Math.max(1, pf.line)
       const column = Math.max(1, pf.column ?? 1)
       ed.revealLineInCenter(line)
@@ -2241,7 +2309,8 @@ export function EditorView(props) {
     }
     const target = pf.region || pendingRegions[0]
     if (!target) return
-    pendingFocusRef.current = null
+    if (!sameFile(modelPathOf(ed), pf.path)) return
+    dropPending()
     ed.revealLineInCenter(Math.max(1, target.start ?? 1))
     ed.setPosition({ lineNumber: Math.max(1, target.start ?? 1), column: 1 })
     ed.focus()
@@ -2401,15 +2470,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 +2534,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 +3112,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()
@@ -3023,6 +3143,9 @@ export function EditorView(props) {
     const normalized = addTabNorm(path, true)
     if (!normalized) return
     pendingFocusRef.current = { path: normalized, region: null, line: line ?? null, column: column ?? 1, endLine: endLine ?? null, endColumn: endColumn ?? null }
+    // 第三次事故（2026-09-23）：插件 HMR 热重载会重挂载本组件、挂载级 ref 随旧实例销毁 →
+    // 落点意图丢失。同步落 window 槽（跨热重载存活）做交接，落点成功后与 ref 一并清。
+    putPendingNav({ path: normalized, line: line ?? null, column: column ?? 1, endLine: endLine ?? null, endColumn: endColumn ?? null })
     setFocusRequest((value) => value + 1)
   }
 
@@ -3426,6 +3549,10 @@ export function EditorView(props) {
     : null
 
   const sidebarPanels = props.sidebarPanels
+  // SVN 变更查表（文件树徽标 O(1) 查表用）：O(n) 建表只随数据/作用域变化重算，
+  // 不再随编辑区每轮渲染重建（条目多时每帧新建几千键的 Record 徒增 GC 压力）。
+  // @author ddj 2026年09月23号
+  const svnChangeMapMemo = React.useMemo(() => svnChangeMapOf(scope), [scope, svnChanges])
   const sidebarCtx = {
     sessionId,
     // 当前会话工作区（反应式 cwd；规则面板项目 Tab 自动匹配）
@@ -3445,7 +3572,7 @@ export function EditorView(props) {
     svn: svnStatus,
     // SVN 变更：面板列表 + 文件树徽标查表（客户端合成，不改 listDir 契约）
     svnChanges,
-    svnChangeMap: svnChangeMapOf(scope),
+    svnChangeMap: svnChangeMapMemo,
     openSvnDiff: (p) => runSvnDiffBase(p),
     openSvnLocalPair: runSvnDiffLocalPair,
     refreshSvnChanges: () => refreshSvnChanges(sessionId, scope),

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,
   )
 }