dsh-vscode-mode 0.5.1 → 0.5.3

package/src/client/ui/EditorView.ts

@@ -12,6 +12,8 @@ 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 { isMarkdownPath } from '../markdownPreview.js'
+import { MarkdownPanel } from '../md/mdPanel.js'
 import { base64ToBytes, isPdfPath } from '../pdfPreview.js'
 import {
   clearBaseline,
@@ -30,6 +32,7 @@ import { createDiffRenderer } from '../monaco/diffRender.js'
 import { ST, callIdAttr, noopHunk, summarize } from '../state/records.js'
 import { diffRegions } from '../state/regions.js'
 import { QuickOpen } from './QuickOpen.js'
+import { attachHorizontalWheel } from './horizontalWheel.js'
 import { CommandPalette } from './CommandPalette.js'
 import { closeCommandPalette } from '../commandPaletteStore.js'
 import { DiffLauncher } from './DiffLauncher.js'
@@ -47,6 +50,7 @@ import { bindingsOf, chordOf, matchEvent, useKeybindingsVersion } from '../keybi
 import { getSidebarMinWidth } from '../sidebarMin.js'
 import { navHistoryFor } from '../navHistory.js'
 import { statusOfAdd } from '../addToConversation.js'
+import { setSearchSeed } from '../searchSeed.js'
 import { CACHE_KEY } from '../paths.js'
 import { runGoToDefinition, runFindReferences, hideReferencesOverlay } from '../monaco/lsp/providers.js'
 import { bindLspUnderline } from '../monaco/lsp/underline.js'
@@ -56,8 +60,9 @@ import { SnippetsPicker } from './SnippetsPicker.js'
 import { invalidateSnippets, setSnippetsSession, setupSnippets } from '../snippets/provider.js'
 import {
   absoluteOf, ancestorDirsOf, applyClose, baseNameOf, closeAll, closeOthers, closeRight, closeSaved,
-  insertTab, isTreeRevealable, normalizeTabs, pickActive, relativeOf, tabPathOf, togglePin,
+  evictPlan, insertTab, isTreeRevealable, normalizeTabs, pickActive, relativeOf, tabPathOf, togglePin,
 } from '../tabActions.js'
+import { getMaxOpenEditors } from '../editorLimit.js'
 import { buildTabMenu } from '../tabMenu.js'
 import { ensureSvnChanges, ensureSvnStatus, getSvnChanges, getSvnStatus, refreshSvnChanges, svnAdd, svnChangeMapOf, svnDiffBase, svnEditorActions, svnRevert, svnTortoise, svnUpdate } from '../svnStatus.js'
 import { ensureSvnLog, getSvnLog, refreshSvnLog, svnDiffPair, svnDiffRev, svnDiffWorking, svnLogKeyOf, svnLogLoadedLimit, svnLogTruncated, svnWcRev, SVN_LOG_SHOW_ALL_LIMIT } from '../svnLog.js'
@@ -165,6 +170,7 @@ export function EditorView(props) {
   const [imgSize, setImgSize] = React.useState(null) // 图片自然尺寸 { w, h }（路径栏 meta）
   const [imgBroken, setImgBroken] = React.useState(false) // 图片解码失败（onError），显示占位与重试
   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）
   const pdfB64CacheRef = React.useRef(new Map()) // path → base64（tab 切回免重读；FIFO 上限防内存膨胀）
   const pdfCtlRef = React.useRef(new Map()) // path → PDF 面板控制器（mount 产出，关闭/卸载销毁）
@@ -229,6 +235,7 @@ export function EditorView(props) {
   const navBackRef = React.useRef(null) // 后退动作最新闭包（窗口级键盘监听读取）
   const navForwardRef = React.useRef(null) // 前进动作最新闭包（窗口级键盘监听读取）
   const cycleTabRef = React.useRef(null) // 页签循环动作最新闭包（Ctrl+Alt+←/→、Ctrl+PgUp/PgDn）
+  const toggleMdPreviewRef = React.useRef(null) // Markdown 预览切换动作最新闭包（窗口键位监听读取，防陈旧闭包）
   const rowNavColRef = React.useRef(null) // 整行上下移动的期望列（连续移动保持列位）
   const rowNavMoveRef = React.useRef(false) // 本次光标变化是否由整行移动触发（否则清空期望列）
   const activeRef = React.useRef(null) // 当前活动文件的最新值（空依赖闭包/指令回调读取）
@@ -240,6 +247,9 @@ export function EditorView(props) {
   const dirtyRef = React.useRef({}) // 脏标记最新值（菜单禁用判定与关闭时落盘读）
   dirtyRef.current = dirtyMap
   const tabsHostRef = React.useRef(null) // 页签栏容器（切换后把当前页签滚入可见区）
+  // 页签上限与 LRU 使用序（超限淘汰最久未用者；见下方 tabTouchEffect / tabEvictEffect）
+  const [tabLimit, setTabLimit] = React.useState(() => getMaxOpenEditors())
+  const tabUseRef = React.useRef({ seq: 0, used: {} })
   const [navTick, setNavTick] = React.useState(0) // 历史可用性版本（按钮 disabled 重渲染）
   const hoverRegionsRef = React.useRef([]) // 当前 pending 区域镜像（稳定回调读取）
   const lineRegionMapRef = React.useRef(new Map()) // 行 → 区域 映射（hover 命中）
@@ -282,6 +292,9 @@ export function EditorView(props) {
   const isImageActive = !!active && isImagePath(active) && !svgTextRef.current.has(active)
   // 当前 tab 是否为 PDF 面板（与 loadContent 分派条件同源）
   const isPdfActive = !!active && isPdfPath(active)
+  // 当前 tab 是否为可预览的 Markdown，以及是否正处于预览态（预览态替换 Monaco host，只读）
+  const isMdActive = !!active && isMarkdownPath(active)
+  const mdPreviewing = isMdActive && mdPreviewRef.current.has(active)
   const regions = React.useMemo(() => diffRegions(currentRecords, contentReady ? content : null).filter((r) => !r.superseded), [currentRecords, content, contentPath, active])
   // useMemo 稳定引用：否则 hover 等重渲染会让 view zone effect 反复重建（- 号闪烁）
   const pendingRegions = React.useMemo(() => regions.filter((r) => r.status === ST.PENDING && !r.stale), [regions])
@@ -972,10 +985,18 @@ export function EditorView(props) {
         // G9：迁移历史持久化里的绝对路径页签（旧版差异入口写入），并顺带按新形态去重
         const restored = normalizeTabs(saved?.tabs, cwd)
         if (restored.length) {
-          setTabs(restored)
           // 活动路径同形态归一，否则恢复后匹配不到任何页签（pickActive 回退首个）
           const wanted = typeof saved?.active === 'string' ? tabPathOf(saved.active, cwd) : saved?.active
-          setActive(pickActive(restored, wanted))
+          const activePath = pickActive(restored, wanted)
+          // 上限已下调过（或历史存档超限）：恢复即收敛。此时页签均未编辑、无脏数据，
+          // 故只做纯计算裁剪，不走 closeTabs（避免无谓的落盘探测与状态栏提示）。
+          // evictPlan 已保护活动页签，无需额外 keep。
+          const limit = getMaxOpenEditors()
+          const plan = evictPlan(restored, limit, { active: activePath, used: {} })
+          const dropped = new Set(plan)
+          const kept = plan.length ? restored.filter((tab) => !dropped.has(tab.path)) : restored
+          setTabs(kept)
+          setActive(kept.some((tab) => tab.path === activePath) ? activePath : (kept[0]?.path ?? null))
         }
       }
     } catch (e) { /* 损坏忽略 */ }
@@ -999,6 +1020,45 @@ export function EditorView(props) {
     catch (e) { /* 忽略 */ }
   }, [tabs, active, sessionId, scope])
 
+  /**
+   * 标记页签为「最近使用」（LRU 序号单调递增；编辑动作也算使用，见 onEdit）。
+   * @author ddj 2026年09月18号
+   * @param path 页签路径
+   */
+  const touchTab = (path) => {
+    if (!path) return
+    const state = tabUseRef.current
+    state.seq += 1
+    state.used[path] = state.seq
+  }
+
+  // 页签上限设置变更（edrv:max-open-editors）→ 更新上限态并触发下方淘汰 effect 复算
+  React.useEffect(() => {
+    const onLimit = () => setTabLimit(getMaxOpenEditors())
+    window.addEventListener('edrv:max-open-editors', onLimit)
+    return () => window.removeEventListener('edrv:max-open-editors', onLimit)
+  }, [])
+
+  // LRU 使用序维护：活动页签变化即标记；顺带把 used 表裁剪到当前页签集合，
+  // 否则长会话中已关闭页签的条目会永久堆积（内存无界增长）。
+  // ⚠️ 本 effect 必须声明在淘汰 effect 之前：先标记再淘汰，才能保证「刚打开/刚切到的
+  // 页签」不会在同一次 commit 里被当作最久未用者淘汰。
+  React.useEffect(() => {
+    if (active) touchTab(active)
+    const alive = new Set(tabs.map((t) => t.path))
+    const used = tabUseRef.current.used
+    for (const path of Object.keys(used)) if (!alive.has(path)) delete used[path]
+  }, [tabs, active])
+
+  // 页签超限淘汰：关闭最久未使用的页签（固定页签与活动页签受保护；见 tabActions.evictPlan）。
+  // 复用 closeTabs：它已实现 flushSave + persistDirty（脏页签先静默落盘）+ releaseTab + commitClose，
+  // 故「超限淘汰脏页签」不会丢用户编辑。淘汰后 tabs 变化 → 本 effect 复算 evictPlan 返回空 → 自然收敛。
+  React.useEffect(() => {
+    const plan = evictPlan(tabsRef.current, tabLimit, { active: activeRef.current, used: tabUseRef.current.used })
+    if (!plan.length) return
+    closeTabs(applyClose(tabsRef.current, new Set(plan), activeRef.current), '已关闭最久未使用的页签')
+  }, [tabs, tabLimit, active])
+
   // 侧边栏状态：恢复（显隐/宽度/激活面板）；侧栏形态独立键（默认收起，不共享页签形态偏好）
   // 宽度下限来自通用设置 sidebarMinWidth（默认 300），恢复值按其重夹
   const sidebarKey = CACHE_KEY.sidebar + (layout === 'side' ? 'side.' : '') + String(scope)
@@ -1056,14 +1116,51 @@ export function EditorView(props) {
     return () => window.removeEventListener('keydown', onKey, true)
   }, [])
 
-  // Ctrl+Shift+F 全局搜索：展开侧边栏 + 激活搜索页签，随后聚焦搜索输入框
+  /**
+   * 打开搜索面板（Ctrl+Shift+F 与命令栏「在工作区中搜索」的唯一动作）。
+   *
+   * 若编辑器有选区，把选区文本作为一次性种子交给搜索面板自动填入（需求 1）；
+   * 无选区/无编辑器时种子为空，行为与改动前一致（仅展开并聚焦）。
+   * 种子经 searchSeed 模块交棒而非事件 detail：侧栏原本收起时搜索面板尚未挂载，
+   * 事件 detail 会丢；面板挂载后自行取走槽内种子。
+   * @author ddj 2026年09月18号
+   */
+  const openSearchPanel = () => {
+    const ed = editorRef.current
+    const model = ed?.getModel?.()
+    const sel = ed?.getSelection?.()
+    let selected = ''
+    if (model && sel && (sel.startLineNumber !== sel.endLineNumber || sel.startColumn !== sel.endColumn)) {
+      // 选中区间文本（多行时 seedQueryOf 只取首行）
+      selected = model.getValueInRange?.(sel) ?? ''
+    }
+    setSearchSeed(selected)
+    setSidebarOn(true)
+    setActivePanel('search')
+    setTimeout(() => window.dispatchEvent(new CustomEvent('edrv:search-focus')), 0)
+  }
+
+  // Ctrl+Shift+F 全局搜索：展开侧边栏 + 激活搜索页签，随后聚焦搜索输入框（有选中则填入）
   React.useEffect(() => {
     const onKey = (e) => {
       if (!matchEvent(e, bindingsOf('edrv.searchInFiles'))) return
       e.preventDefault(); e.stopPropagation()
-      setSidebarOn(true)
-      setActivePanel('search')
-      setTimeout(() => window.dispatchEvent(new CustomEvent('edrv:search-focus')), 0)
+      openSearchPanel()
+    }
+    window.addEventListener('keydown', onKey, true)
+    return () => window.removeEventListener('keydown', onKey, true)
+  }, [])
+
+  // Ctrl+Shift+V 切换 Markdown 预览：仅活动文件是 Markdown 时吞键；
+  // 其余情况直接放行（不 preventDefault），保留浏览器/输入框原生的「无格式粘贴」语义
+  // ——与 closeTab / addSelectionRef「不可用时放行按键」同款约定。
+  React.useEffect(() => {
+    const onKey = (e) => {
+      if (!matchEvent(e, bindingsOf('edrv.toggleMarkdownPreview'))) return
+      const path = activeRef.current
+      if (!isMarkdownPath(path)) return
+      e.preventDefault(); e.stopPropagation()
+      toggleMdPreviewRef.current?.(path)
     }
     window.addEventListener('keydown', onKey, true)
     return () => window.removeEventListener('keydown', onKey, true)
@@ -1181,10 +1278,11 @@ export function EditorView(props) {
       ['edrv.command.save', () => { if (editorRef.current?.getModel?.()) { flushSave(); doSaveRef.current?.(false) } }],
       // 快速打开由 QuickOpen 自己接该事件（它持有搜索框 ref），此处不重复实现
       ['edrv.command.toggleSidebar', () => setSidebarOn((v) => !v)],
-      ['edrv.command.searchInFiles', () => {
-        setSidebarOn(true)
-        setActivePanel('search')
-        setTimeout(() => window.dispatchEvent(new CustomEvent('edrv:search-focus')), 0)
+      ['edrv.command.searchInFiles', () => openSearchPanel()],
+      ['edrv.command.toggleMarkdownPreview', () => {
+        const path = activeRef.current
+        if (!isMarkdownPath(path)) { setStatus('当前文件不是 Markdown'); return }
+        toggleMdPreviewRef.current?.(path)
       }],
       ['edrv.command.navigateBack', () => navBackRef.current?.()],
       ['edrv.command.navigateForward', () => navForwardRef.current?.()],
@@ -1265,6 +1363,10 @@ export function EditorView(props) {
     else if (right > host.scrollLeft + host.clientWidth) host.scrollLeft = right - host.clientWidth
   }, [active, tabs.length])
 
+  // 页签栏滚轮横向滚动（需求 3）：页签栏溢出时，鼠标滚轮（含触控板纵向手势）横滚页签栏，
+  // 不溢出时不接管（保持页面垂直滚动）；Shift+滚轮交由浏览器原生横滚。详见 horizontalWheel.ts。
+  React.useEffect(() => attachHorizontalWheel(tabsHostRef.current), [])
+
   // 鼠标侧键后退/前进：Logitech 官方默认「后退/前进」= XButton 鼠标事件（button 3/4），不产生键盘事件。
   // pointerdown 触发导航（preventDefault 后兼容 mousedown 可能不再触发，避免双触发）；
   // mousedown 兜底仅取消浏览器历史导航默认动作（MDN：preventDefault mousedown/pointerdown 可抑制）。
@@ -1550,6 +1652,9 @@ export function EditorView(props) {
     const ed = editorRef.current
     if (!ed || !active) return
     setDirtyMap((d) => Object.assign({}, d, { [active]: true }))
+    // 编辑即「使用」：需求 2 的淘汰口径是「最近没有改动」，故有改动时刷新 LRU 序号，
+    // 使长时间只在某文件里编辑的页签不会被其它文件的打开动作挤出。
+    touchTab(active)
     setStatus('编辑中…')
     // 外部改动尚未处理（冲突/文件被删）：抑制自动保存，避免用陈旧缓冲反复覆盖磁盘；
     // 手工 Ctrl+S 不受抑制（doSave 会走版本守卫并给冲突提示）。
@@ -1564,6 +1669,9 @@ export function EditorView(props) {
   // ⚠️ 必须以 contentReady（contentPath === active）为门，不能用 `content !== null`：
   // 切页签的那一帧 content 仍是**上一个文件**的内容，据此建 model 会先塞入陈旧文本，
   // 待真实内容到达再由 getModel→setValue 覆盖，光标随之被重置（见下方跳转 effect 注释）。
+  // ⚠️ 依赖必须含 mdPreviewing：Markdown 预览态不渲染 Monaco host（见 body 分派的 mdPreviewing 分支），
+  // 切回源码时 ensureEditor 会**新建**编辑器实例，而 active/content 都没变；缺此依赖则本 effect
+  // 不重跑 → 空 model、行内差异标记消失。同款原因见下方差异自绘 effect。
   React.useEffect(() => {
     if (!monaco || !editorRef.current || !active || !contentReady) return
     const ed = editorRef.current
@@ -1571,7 +1679,7 @@ export function EditorView(props) {
     if (ed.getModel() !== model) ed.setModel(model)
     restoreViewState(active)
     setLoadStage((prev) => ({ progress: Math.max(96, prev.progress), message: '创建编辑器视图…' }))
-  }, [monaco, active, content, contentReady])
+  }, [monaco, active, content, contentReady, mdPreviewing])
 
   // PDF 面板外壳 ref 回调（div 仅在 PDF 分支渲染，refs 先于 effect 就绪）
   const ensurePdfHost = (node) => { pdfHostRef.current = node }
@@ -1598,11 +1706,13 @@ export function EditorView(props) {
   }, [isPdfActive, pdfBytes, active])
 
   // 行内差异自绘（decorations / view zones / minus overlay）→ diffRenderer
+  // ⚠️ 依赖含 mdPreviewing：切回源码时编辑器实例被重建（见上方 model 同步 effect 的说明），
+  // 不重跑则新实例上没有任何差异装饰，表现为「差异标记全部消失」。
   React.useEffect(() => {
     if (!monaco || !editorRef.current || !active || content === null) return
     diffRendererRef.current.render(monaco, editorRef.current, pendingRegions, sessionId)
     setLoadStage({ progress: 100, message: '编辑器已就绪' })
-  }, [monaco, active, content, pendingRegions])
+  }, [monaco, active, content, pendingRegions, mdPreviewing])
 
   React.useEffect(() => () => {
     flushSave()
@@ -1982,6 +2092,32 @@ export function EditorView(props) {
     loadContent(path, sessionId, true)
   }
 
+  /**
+   * Markdown 在源码编辑与预览之间切换（按路径记忆，不持久化）。
+   *
+   * ⚠️ 进入预览前必须 flushSave()：预览态会替换 Monaco host，切回时编辑器实例是新建的；
+   * 若此刻还有未到期的 700ms 防抖保存，定时器到点时 editorRef.current 已被清空
+   * （见 EditorView 卸载清理），doSave 会静默 return —— 用户改动永不落盘。
+   * 同时保存视图状态，保证切回源码后光标/滚动位置不丢。
+   * @author ddj 2026年09月18号
+   * @param path Markdown 文件路径
+   */
+  const toggleMdPreview = (path) => {
+    if (!path) return
+    const next = new Set(mdPreviewRef.current)
+    const entering = !next.has(path)
+    if (entering) {
+      flushSave()
+      saveViewState(path)
+      next.add(path)
+    } else {
+      next.delete(path)
+    }
+    mdPreviewRef.current = next
+    setStatus(entering ? '已切换为 Markdown 预览' : '已切换为源码编辑')
+  }
+  toggleMdPreviewRef.current = toggleMdPreview
+
   /**
    * 图片预览面板：工具条（尺寸 meta / SVG 文本切换 / 刷新）+ 棋盘底自适应图片。
    * @author ddj 2026年09月08号
@@ -2598,6 +2734,13 @@ export function EditorView(props) {
   const pathBar = React.createElement('div', { className: 'edrv-pathbar', title: active || '' },
     React.createElement('span', { className: 'edrv-pb-name' }, active ? String(active).split(/[\\/]/).pop() : '未打开文件'),
     React.createElement('span', { className: 'edrv-pb-full' }, active || '使用右上搜索框 (' + (chordOf('edrv.quickOpen') ?? 'Ctrl+P') + ') 打开文件'),
+    // Markdown 预览/源码切换（需求 4）：仅 .md 文件出现；命令栏与 Ctrl+Shift+V 为同一动作
+    (isMdActive ? React.createElement('button', {
+      className: 'edrv-pill edrv-pill-ghost edrv-pb-mdbtn',
+      title: (mdPreviewing ? '切回源码编辑' : '预览 Markdown') + '（' + (chordOf('edrv.toggleMarkdownPreview') ?? '未绑定') + '）',
+      onClick: () => toggleMdPreview(active),
+    }, mdPreviewing ? '源码' : '预览') : null),
+    (mdPreviewing ? React.createElement('span', { className: 'edrv-pb-meta' }, '预览') : null),
     (active && !isImageActive && langOf(active) ? React.createElement('span', { className: 'edrv-pb-meta' }, langOf(active)) : null),
     (isImageActive && imgSize ? React.createElement('span', { className: 'edrv-pb-meta' }, imgSize.w + '×' + imgSize.h) : null),
     (cursor ? React.createElement('span', { className: 'edrv-pb-meta' }, cursor) : null),
@@ -2786,6 +2929,17 @@ export function EditorView(props) {
     body = React.createElement('div', { className: 'edrv-pdf-host', ref: ensurePdfHost, key: active })
   } else if (isPdfActive) {
     body = loadingBody(loadStage.message || '读取 PDF…', loadStage.progress)
+  } else if (mdPreviewing && contentReady) {
+    // Markdown 预览（需求 4）：复用已加载的文本内容渲染，不额外请求；编辑仍在源码态完成
+    body = React.createElement(MarkdownPanel, {
+      key: 'edrv-md-' + active,
+      text: content,
+      onToggleSource: () => toggleMdPreview(active),
+      onReload: () => reloadFile(),
+      onOpenFile: (path, line) => openFileAt(path, line ?? 1),
+    })
+  } else if (mdPreviewing) {
+    body = loadingBody(loadStage.message || '读取 Markdown…', loadStage.progress)
   } else if (content === null) {
     body = loadingBody(loadStage.message || '读取文件内容…', loadStage.progress)
   } else {

package/src/client/ui/McpSettings.ts

@@ -11,6 +11,7 @@ import '../styles/mcp.css'
 import { availableOpeners, AUTO_OPEN_TOOL } from '../fileOpeners.js'
 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 { KeybindingsPanel } from './KeybindingsPanel.js'
 import { LspSettings } from './LspSettings.js'
@@ -136,6 +137,8 @@ function GeneralSettings({ registry }) {
   const [devMessage, setDevMessage] = React.useState('')
   const [minW, setMinW] = React.useState(SIDEBAR_MIN_DEFAULT)
   const [minDraft, setMinDraft] = React.useState(null) // 输入草稿（null=跟随已保存值；blur/Enter 提交）
+  const [limit, setLimit] = React.useState(EDITOR_LIMIT_DEFAULT)
+  const [limitDraft, setLimitDraft] = React.useState(null) // 页签上限草稿（同上提交语义）
   const settings = React.useContext(SettingsContext)
   const snapshot = settings?.getSnapshot?.()
   const loading = !snapshot || snapshot.status === 'loading'
@@ -147,6 +150,7 @@ function GeneralSettings({ registry }) {
       const next = snap?.value?.fileOpenTool
       if (typeof next === 'string') setTool(next)
       setMinW(normalizeSidebarMinWidth(snap?.value?.sidebarMinWidth))
+      setLimit(normalizeMaxOpenEditors(snap?.value?.maxOpenEditors))
     }
     onChange()
     return settings?.subscribe?.(onChange)
@@ -174,6 +178,19 @@ function GeneralSettings({ registry }) {
     setMinDraft(null)
     saveMinW(minDraft)
   }
+  /** 提交页签数量上限（归一化夹取 0–50 后持久化；0 = 不限制）。 */
+  const saveLimit = (raw) => {
+    const next = normalizeMaxOpenEditors(raw)
+    setLimit(next); setBusy(true); setError('')
+    if (!settings?.set) { setError('设置服务不可用'); setBusy(false); return }
+    settings.set('maxOpenEditors', next).catch((e) => setError(String(e))).finally(() => setBusy(false))
+  }
+  /** 结束输入（blur/Enter）时提交页签上限草稿。 */
+  const commitLimit = () => {
+    if (limitDraft === null) return
+    setLimitDraft(null)
+    saveLimit(limitDraft)
+  }
   const closeDevForm = () => {
     if (!window.confirm('关闭开发形态：插件将切换为正式版安装（版本依赖 + 删除工作区链接），pnpm 装配后需重启 DSH 生效。确认关闭？')) return
     setDevBusy(true)
@@ -220,6 +237,18 @@ function GeneralSettings({ registry }) {
             onKeyDown: (event) => { if (event.key === 'Enter') commitMinW() },
           }),
           React.createElement('small', null, '180–560 px；拖拽低于该宽度自动隐藏')),
+        React.createElement('label', { className: 'vsm-general-row' },
+          React.createElement('span', null, '页签数量上限'),
+          React.createElement('input', {
+            type: 'number', min: 0, max: EDITOR_LIMIT_CEIL, step: 1,
+            value: limitDraft ?? limit,
+            disabled: loading || unavailable || notReady || busy || snapshot?.writable === false,
+            title: '0 = 不限制；超出上限时自动关闭最久未使用的页签（固定页签不受影响）',
+            onChange: (event) => setLimitDraft(event.target.value),
+            onBlur: commitLimit,
+            onKeyDown: (event) => { if (event.key === 'Enter') commitLimit() },
+          }),
+          React.createElement('small', null, '0 = 不限制；超限时关闭最久未使用的页签（固定页签除外）')),
       ),
     ),
     React.createElement(SvnSettingsSection, null),

package/src/client/ui/commandCatalog.ts

@@ -197,6 +197,11 @@ export const EDITOR_COMMANDS: readonly CommandDef[] = [
     keybinding: 'Ctrl+Shift+F', available: alwaysAvailable,
     run: () => emit('searchInFiles'),
   },
+  {
+    id: 'edrv.toggleMarkdownPreview', label: '切换 Markdown 预览', category: '视图', order: 25,
+    keybinding: 'Ctrl+Shift+V', available: alwaysAvailable,
+    run: () => emit('toggleMarkdownPreview'),
+  },
   {
     id: 'edrv.showLogs', label: '查看诊断日志', category: '视图', order: 30,
     available: alwaysAvailable,

package/src/client/ui/horizontalWheel.ts

@@ -0,0 +1,85 @@
+/**
+ * dsh-vscode-mode client — 溢出容器的滚轮横向滚动（页签栏用）。
+ *
+ * 需求 3：页签栏出现水平滚动条时，用鼠标滚轮（垂直滚动轮）也能横向滚动。
+ * 浏览器对 `overflow-x: auto` 的容器**不会**把垂直滚轮折算成横向滚动（只有原生横向
+ * 滚轮/触控板横滑或 Shift+滚轮才横滚），故需要显式接管。
+ *
+ * 设计取舍：
+ * - **不溢出就不接管**：内容放得下时滚轮必须保持页面垂直滚动语义，绝不能 preventDefault。
+ * - **Shift+滚轮不接管**：Chrome/Edge 对横向溢出容器原生支持 Shift+滚轮横滚，
+ *   我们再次处理会导致位移翻倍。
+ * - 触控板的横向手势（deltaX）与纵向手势（deltaY）都按主分量取用。
+ *
+ * `wheelScrollStep` 为纯函数（node 可测）；`attachHorizontalWheel` 只做 DOM 装配。
+ * 作者 ddj 2026年09月18号
+ */
+
+/** 行模式（deltaMode === 1）下一「行」折算的像素数（主流浏览器约 16px 行高）。 */
+const LINE_HEIGHT_PX = 16
+
+/** 滚轮输入（DOM WheelEvent 的相关字段子集，便于单测构造）。 */
+export interface WheelInput {
+  deltaX: number
+  deltaY: number
+  /** 0 = 像素 / 1 = 行 / 2 = 页。 */
+  deltaMode: number
+  shiftKey: boolean
+}
+
+/** 容器几何（只需可滚宽度与可视宽度）。 */
+export interface WheelGeometry {
+  scrollWidth: number
+  clientWidth: number
+}
+
+/**
+ * 计算一次滚轮事件应产生的横向位移。
+ * @author ddj 2026年09月18号
+ * @param input 滚轮事件字段
+ * @param geometry 容器几何（未溢出时返回 0，即不接管）
+ * @returns 横向位移（px，带符号）；0 表示本事件不处理（调用方不得 preventDefault）
+ */
+export function wheelScrollStep(input: WheelInput, geometry: WheelGeometry): number {
+  const scrollable = Number(geometry?.scrollWidth) - Number(geometry?.clientWidth)
+  if (!Number.isFinite(scrollable) || scrollable <= 0) return 0
+  // Shift+滚轮交给浏览器原生横滚（处理两次会翻倍）
+  if (input?.shiftKey === true) return 0
+  const dx = Number(input?.deltaX) || 0
+  const dy = Number(input?.deltaY) || 0
+  const raw = Math.abs(dx) >= Math.abs(dy) ? dx : dy
+  if (!raw) return 0
+  const mode = input?.deltaMode | 0
+  if (mode === 1) return Math.round(raw * LINE_HEIGHT_PX)
+  if (mode === 2) return Math.round(raw * Number(geometry.clientWidth || 0))
+  return Math.round(raw)
+}
+
+/** 可挂载滚轮的节点最小形状（浏览器元素或测试替身）。 */
+export interface WheelTarget {
+  addEventListener: (type: string, listener: (event: unknown) => void, options?: unknown) => void
+  removeEventListener: (type: string, listener: (event: unknown) => void, options?: unknown) => void
+}
+
+/**
+ * 给横向溢出容器挂上「垂直滚轮驱动横向滚动」。
+ * 监听器为 `passive: false`（需要 preventDefault 阻止页面滚动），仅在需要位移时阻止默认行为。
+ * @author ddj 2026年09月18号
+ * @param node 目标元素（空则返回空注销器，不做任何事）
+ * @returns 注销函数（幂等调用安全）
+ */
+export function attachHorizontalWheel(node: WheelTarget | null | undefined): () => void {
+  if (!node || typeof node.addEventListener !== 'function') return () => {}
+  const onWheel = (event: unknown): void => {
+    const e = event as WheelInput & { preventDefault?: () => void }
+    const step = wheelScrollStep(
+      { deltaX: e.deltaX, deltaY: e.deltaY, deltaMode: e.deltaMode, shiftKey: e.shiftKey },
+      { scrollWidth: (node as unknown as { scrollWidth: number }).scrollWidth, clientWidth: (node as unknown as { clientWidth: number }).clientWidth },
+    )
+    if (!step) return
+    e.preventDefault?.()
+    ;(node as unknown as { scrollLeft: number }).scrollLeft += step
+  }
+  node.addEventListener('wheel', onWheel, { passive: false })
+  return () => node.removeEventListener('wheel', onWheel, { passive: false })
+}

package/src/client-primitives.d.ts

@@ -34,4 +34,38 @@ declare module '@deepseek-ai/dsh-client-ui-primitives' {
   export const IconListPenOutline16: (props: EdrvIconProps) => unknown
   /** 代码图标（活动栏「大纲」）。 */
   export const IconCodeOutline16: (props: EdrvIconProps) => unknown
+
+  /** 代码块复制按钮文案（MarkdownText 的 labels.code）。 */
+  export interface MarkdownCodeLabels {
+    /** 复制按钮空闲态文案。 */
+    copyLabel: string
+    /** 复制后确认窗口期文案。 */
+    copiedLabel: string
+  }
+
+  /** Markdown 渲染的本地化 chrome（labels 引用须稳定，否则流式渲染缓存失效）。 */
+  export interface MarkdownLabels {
+    code: MarkdownCodeLabels
+    /** 脚注段落标题。 */
+    footnotes: string
+  }
+
+  /**
+   * Markdown 渲染原语（GFM + KaTeX；raw HTML 与不安全协议被禁用）。
+   * `streaming: false` 走一次性完整解析；`variant: 'body'` 为文档级排版。
+   * 旧版 DSH 可能无此导出，调用方须做 typeof 守卫并降级。
+   */
+  export const MarkdownText: (props: {
+    text: string
+    streaming?: boolean
+    labels: MarkdownLabels
+    variant?: 'body' | 'compact'
+  }) => unknown
+
+  /** Markdown 导航作用域：普通外链与本地文件链接的打开能力（不提供则保持原生/纯文本）。 */
+  export function MarkdownDelegateProvider(props: {
+    children?: unknown
+    openExternalLink?: (href: string) => void
+    openFile?: (path: string, options?: { line?: number }) => void
+  }): unknown
 }

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, settingsInstallNote, settingsInstallStrategy } from './fileOpenSettings.js'
+import { loadSettingsDeps, schemaLibName, settingsInstallNote, settingsInstallStrategy } from './fileOpenSettings.js'
 import { readDevForm } from './devForm.js'
 import { compareDshVersions, detectDshVersion, familyLabel, parseDshVersion } from './dshVersion.js'
 import { SKILL_PREFIXES, skillGroupState } from './skills.js'
@@ -59,7 +59,7 @@ export function detectExternal(ctx: Ctx, depsAvailable: boolean): CompatAdapter[
   const skills = skillGroupState()
   return [
     { name: MCP_PACKAGE, active: mcpCount > 0, note: mcpCount > 0 ? mcpCount + ' 个 MCP 服务条目' : '未检测到 MCP 条目（MCP 管理页显示为空）' },
-    { name: '设置持久化（@deepseek-ai/dsh-settings）', active: depsAvailable, note: depsAvailable ? '设置 section 已安装' : '未安装：fileOpenTool 持久化降级为配置值' },
+    { name: '设置持久化（@deepseek-ai/dsh-settings）', active: depsAvailable, note: depsAvailable ? '设置 section 已安装（schema: ' + (schemaLibName() || '未知') + '）' : '未安装：fileOpenTool 持久化降级为配置值' },
     { name: 'settings 服务', active: hasSettings, note: hasSettings ? '可读写设置' : '不可用（设置读写走配置回退）' },
     { name: '文件浏览器打开（subprocess 服务）', active: typeof sub?.spawn === 'function', note: typeof sub?.spawn === 'function' ? '可定位/打开 OS 文件浏览器' : '不可用（右键「在文件浏览器中打开」将提示失败）' },
     // 新增项一律追加在末尾：既有下标被 tests/compat.test.ts 断言，不得前插。