dsh-vscode-mode 0.5.2 → 0.5.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.5.2",
+  "version": "0.5.3",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 DSH 0.1.5+ 官方右侧 Sidebar 与对话同屏）+ 命令栏（Ctrl+Shift+P）与可扩展指令系统 + VS Code 兼容代码片段（.code-snippets 全局/项目，IntelliSense 展开）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ SVN 集成（侧栏变更面板/日志弹窗/并排差异）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车",
   "keywords": [
     "dsh",

package/src/client/compat.ts

@@ -12,7 +12,7 @@ export const SIDEBAR_PLUGIN = 'dsh-better-sidebar'
 
 /** 设置 scope 的跨组件上下文形状（与官方 settingsScope 绑定的最小面）。 */
 export interface SettingsScopeLike {
-  getSnapshot: () => { status?: string; value?: { fileOpenTool?: unknown; keybindings?: Record<string, string>; sidebarMinWidth?: unknown }; writable?: boolean }
+  getSnapshot: () => { status?: string; value?: { fileOpenTool?: unknown; keybindings?: Record<string, string>; sidebarMinWidth?: unknown; maxOpenEditors?: unknown }; writable?: boolean }
   subscribe: (listener: () => void) => () => void
   set: (field: string, value: unknown) => Promise<void>
 }

package/src/client/editorLimit.ts

@@ -0,0 +1,31 @@
+/**
+ * dsh-vscode-mode client — 页签数量上限共享状态。
+ * 设置来源：dsh-vscode-mode 命名空间的 maxOpenEditors 字段（通用设置页可调）；
+ * 客户端 settings 订阅经 editorLimitApply 写入，编辑器经 getMaxOpenEditors 读取，
+ * 变更时由 client/index.ts 派发 edrv:max-open-editors 窗口事件通知编辑器复算淘汰。
+ * 形态与 sidebarMin.ts 一致（同一设置同步链路，便于统一维护）。
+ * 作者 ddj 2026年09月18号
+ */
+import { EDITOR_LIMIT_DEFAULT, normalizeMaxOpenEditors } from '../shared/editorLimit.js'
+
+let currentLimit = EDITOR_LIMIT_DEFAULT
+
+/**
+ * 应用设置值（client/index.ts 设置订阅同步调用）。
+ * @author ddj 2026年09月18号
+ * @param value 设置文档中的 maxOpenEditors
+ * @returns 归一化后的生效值（0 = 不限制）
+ */
+export function editorLimitApply(value: unknown): number {
+  currentLimit = normalizeMaxOpenEditors(value)
+  return currentLimit
+}
+
+/**
+ * 读取当前生效的页签上限（编辑器初始/事件回调共用；0 = 不限制）。
+ * @author ddj 2026年09月18号
+ * @returns 当前上限
+ */
+export function getMaxOpenEditors(): number {
+  return currentLimit
+}

package/src/client/index.ts

@@ -50,6 +50,7 @@ import { keybindingsApply } from './keybindings.js'
 import { createCommandBridge } from './commandBridge.js'
 import { REGISTRY_GLOBAL } from './commandGlobals.js'
 import { sidebarMinApply } from './sidebarMin.js'
+import { editorLimitApply } from './editorLimit.js'
 import { log } from './log.js'
 import { setupLsp, setSession, disposeLsp } from './monaco/lsp/index.js'
 import { disposeSnippets } from './snippets/provider.js'
@@ -246,6 +247,7 @@ export function apply(ctx: any): void {
   }, 'vscode-mode: file opener setting sync')
   // 快捷键配置同步：设置提交后立即刷新键位匹配（编辑器/QuickOpen 按事件时读取）
   // 同一订阅里顺带同步侧边栏最小宽度（sidebarMinWidth）→ 派发 edrv:sidebar-min-width 通知编辑器重夹
+  // 以及页签上限（maxOpenEditors）→ 派发 edrv:max-open-editors 通知编辑器复算淘汰
   ctx.effect(() => {
     if (!settings) return undefined
     const sync = (): void => {
@@ -254,6 +256,8 @@ export function apply(ctx: any): void {
       keybindingsApply(snapshot.value?.keybindings)
       const minW = sidebarMinApply(snapshot.value?.sidebarMinWidth)
       window.dispatchEvent(new CustomEvent('edrv:sidebar-min-width', { detail: { value: minW } }))
+      const limit = editorLimitApply(snapshot.value?.maxOpenEditors)
+      window.dispatchEvent(new CustomEvent('edrv:max-open-editors', { detail: { value: limit } }))
     }
     sync()
     return settings.subscribe(sync)

package/src/client/markdownPreview.ts

@@ -0,0 +1,24 @@
+/**
+ * dsh-vscode-mode client — Markdown 文件判定（编辑区预览用）。
+ * 纯函数、无 DOM/React 依赖，便于单测。
+ * @author ddj 2026年09月18号
+ */
+
+/** 可进入预览的 Markdown 扩展名（小写、无点）。 */
+const MARKDOWN_EXT_SET: Set<string> = new Set(['md', 'markdown'])
+
+/**
+ * 判断路径是否为可预览的 Markdown 文件（取 basename 扩展名，大小写不敏感）。
+ *
+ * 为什么不含 `mdx`：官方 MarkdownText 只走 GFM+KaTeX 语法，不解析 JSX；
+ * 对 .mdx 做「预览」会把 JSX 当字面文本渲染出来，比文本编辑更容易误导，故排除。
+ * @author ddj 2026年09月18号
+ * @param path 文件路径（`/` 或 `\` 分隔均可）
+ * @returns 是否 Markdown 文件
+ */
+export function isMarkdownPath(path: string): boolean {
+  const base = String(path || '').split(/[\\/]/).pop() || ''
+  const dot = base.lastIndexOf('.')
+  if (dot <= 0) return false
+  return MARKDOWN_EXT_SET.has(base.slice(dot + 1).toLowerCase())
+}

package/src/client/md/componentType.ts

@@ -0,0 +1,28 @@
+/**
+ * dsh-vscode-mode client — React 元素类型判定（纯函数，无 React/primitives 依赖）。
+ *
+ * 用途：编辑区 Markdown 预览要判断官方 `MarkdownText` 原语是否可用（旧版 DSH 可能缺该导出）。
+ *
+ * ⚠️ 为什么不能只判 `typeof value === 'function'`：
+ * 官方 `MarkdownText` 是 `React.memo(...)` 的产物（`MemoExoticComponent`），
+ * 其 `typeof` 是 **'object'** 而非 'function'。函数判据恒为 false，会让「兼容降级」分支在
+ * **所有新版 DSH 上永久生效** —— 表现是预览只显示纯文本降级提示。
+ * 该缺陷由 GUI 端到端验证捕获：纯函数单测不覆盖该守卫，手写垫片又把它声明得很宽松，
+ * 故 tsc 与既有测试都无法发现。抽出本模块正是为了让它有单测守约。
+ *
+ * 判定口径与 React 自身一致：函数（函数组件 / 类组件），或带 `$$typeof` 标记的非 null
+ * 对象（memo / forwardRef / lazy 等「外部对象类型」）。
+ * 作者 ddj 2026年09月18号
+ */
+
+/**
+ * 判断值是否可作为 React 元素类型传给 `React.createElement`。
+ * @author ddj 2026年09月18号
+ * @param value 候选组件（undefined/null 表示该导出不存在）
+ * @returns 是否可作为元素类型使用
+ */
+export function isComponentType(value: unknown): boolean {
+  if (typeof value === 'function') return true
+  if (typeof value !== 'object' || value === null) return false
+  return (value as { $$typeof?: unknown }).$$typeof !== undefined
+}

package/src/client/md/mdPanel.ts

@@ -0,0 +1,98 @@
+/**
+ * dsh-vscode-mode client — 编辑区 Markdown 预览面板。
+ *
+ * 需求 4：.md 文件支持预览。渲染复用官方 UI 原语 MarkdownText（GFM + KaTeX，走 --dsw-*
+ * 令牌自动跟随 DSH 主题与皮肤），不引入任何第三方 Markdown 依赖。
+ *
+ * 与既有图片 / PDF 面板的形态保持一致：工具条（meta + 切换按钮 + 刷新）+ 内容区。
+ * 本面板为**只读**视图（编辑仍在 Monaco 文本态完成），故不接收编辑回调、不参与脏标记。
+ *
+ * ⚠️ 兼容降级：旧版 DSH 的 primitives 可能没有 MarkdownText。此时渲染只读 <pre> 并给出
+ * 提示，绝不抛错白屏（与 pdf.js / Monaco 加载失败的降级口径一致）。
+ * 作者 ddj 2026年09月18号
+ */
+import React from 'react'
+import type { ComponentType, ReactNode } from 'react'
+import { MarkdownDelegateProvider, MarkdownText } from '@deepseek-ai/dsh-client-ui-primitives'
+import type { MarkdownLabels } from '@deepseek-ai/dsh-client-ui-primitives'
+import { isComponentType } from './componentType.js'
+
+/**
+ * 渲染 chrome 常量。必须是模块级稳定引用：MarkdownText 的 memo 以 labels 身份
+ * 参与缓存判定，每次渲染新建对象会让渲染缓存在流式场景反复失效。
+ */
+const MD_LABELS: MarkdownLabels = {
+  code: { copyLabel: '复制', copiedLabel: '已复制' },
+  footnotes: '脚注',
+}
+
+/**
+ * 官方原语声明在 client-primitives.d.ts 的手写垫片里，组件返回值只能声明为 unknown
+ * （该虚拟模块不入本地 node_modules，无法在环境声明中引用 react 类型）。
+ * 故在此把垫片面收敛成 react 可接受的组件类型，仅本文件承担这层转换；
+ * 原语在运行时缺失时由下方 hasMarkdownPrimitive 守卫降级。
+ */
+type MdTextProps = { text: string; streaming?: boolean; labels: MarkdownLabels; variant?: 'body' | 'compact' }
+type MdProviderProps = { children?: ReactNode; openFile?: (path: string, options?: { line?: number }) => void }
+
+const MdText = MarkdownText as unknown as ComponentType<MdTextProps>
+const MdProvider = MarkdownDelegateProvider as unknown as ComponentType<MdProviderProps>
+
+/** 官方 Markdown 原语是否可用（旧版 DSH 缺该导出时为 false）。 */
+const hasMarkdownPrimitive = isComponentType(MarkdownText)
+
+/** 文本行数（meta 展示用；空文本计 0 行）。 */
+function lineCountOf(text: string): number {
+  const value = String(text ?? '')
+  return value ? value.split(/\r?\n/).length : 0
+}
+
+/** 预览面板 props（面板由 EditorView 装配，故用宽松形状避免跨文件类型耦合）。 */
+interface MarkdownPanelProps {
+  /** Markdown 原文（取自编辑器已加载内容，无需额外 RPC）。 */
+  text?: string
+  /** 切回源码编辑（工具条按钮）。 */
+  onToggleSource?: () => void
+  /** 重新读取文件（工具条刷新按钮）。 */
+  onReload?: () => void
+  /** 打开 Markdown 内的本地文件链接（可空：不给则链接保持纯文本）。 */
+  onOpenFile?: (path: string, options?: { line?: number }) => void
+}
+
+/**
+ * Markdown 预览面板。
+ * @author ddj 2026年09月18号
+ * @param props 面板输入（原文与三个动作回调）
+ * @returns 预览面板元素
+ */
+export function MarkdownPanel(props: MarkdownPanelProps) {
+  const text = String(props?.text ?? '')
+  const onToggleSource = props?.onToggleSource
+  const onReload = props?.onReload
+  const onOpenFile = props?.onOpenFile
+  const chars = text.length
+  const lines = lineCountOf(text)
+
+  const body = hasMarkdownPrimitive
+    ? React.createElement(MdProvider, {
+        openFile: typeof onOpenFile === 'function' ? onOpenFile : undefined,
+      }, React.createElement(MdText, { text, streaming: false, labels: MD_LABELS, variant: 'body' }))
+    : React.createElement('div', { className: 'edrv-mdview-fallback' },
+        React.createElement('div', null, '当前 DSH 版本不含 Markdown 渲染原语，已降级为纯文本预览。'),
+        React.createElement('pre', { className: 'edrv-mdview-pre' }, text))
+
+  return React.createElement('div', { className: 'edrv-mdview' },
+    React.createElement('div', { className: 'edrv-mdview-bar' },
+      React.createElement('span', { className: 'edrv-mdview-meta' }, lines + ' 行 · ' + chars + ' 字符'),
+      React.createElement('span', { style: { flex: 1 } }),
+      React.createElement('button', {
+        className: 'edrv-pill edrv-pill-ghost', title: '切回源码编辑',
+        onClick: () => onToggleSource?.(),
+      }, '以源码打开'),
+      React.createElement('button', {
+        className: 'edrv-pill edrv-pill-ghost', title: '重新读取文件',
+        onClick: () => onReload?.(),
+      }, '⟳ 刷新')),
+    React.createElement('div', { className: 'edrv-mdview-stage' },
+      React.createElement('div', { className: 'edrv-mdview-doc' }, body)))
+}

package/src/client/searchSeed.ts

@@ -0,0 +1,64 @@
+/**
+ * dsh-vscode-mode client — 工作区搜索的「选区种子」。
+ *
+ * 需求：Ctrl+Shift+F 时若编辑器有选中，把选中文本自动填入搜索框。
+ * 链路：EditorView 从 Monaco 取选区文本 → seedQueryOf 归一 → setSearchSeed 存入一次性槽
+ * → 派发 edrv:search-focus → SearchPanel 消费（挂载时或已挂载时），填入并立即搜索。
+ *
+ * 为什么用一次性槽而不是事件 detail：
+ * 侧边栏原本收起时搜索面板**尚未挂载**，派发瞬间没有监听者；事件 detail 会丢。
+ * 槽在 EditorView 与 SearchPanel 之间充当交接点，挂载后由消费方自行取走。
+ *
+ * 为什么取首行：搜索框是单行 input，ripgrep 按字面连续匹配。多行选区（整段/整函数）
+ * 作为单条 query 永远无匹配，故按项目既有口径取首行（与 VS Code 单行选区种子行为一致）。
+ *
+ * 纯逻辑 + 模块级槽，不依赖 React/DOM，可 node 单测。
+ * 作者 ddj 2026年09月18号
+ */
+
+/** 种子最大长度（超长选区只取前 N 字符，防一次性把巨型 query 送进搜索）。 */
+export const SEED_MAX = 200
+
+/**
+ * 由选区文本推导搜索种子。
+ * @author ddj 2026年09月18号
+ * @param text 选区原文（可能含多行、前后空白；null/undefined 视为空）
+ * @returns 归一后的搜索词；无效输入返回空串（调用方据此保持原搜索词）
+ */
+export function seedQueryOf(text: unknown): string {
+  const raw = String(text ?? '')
+  if (!raw) return ''
+  const firstLine = raw.split(/\r?\n/)[0] ?? ''
+  const trimmed = firstLine.trim()
+  if (!trimmed) return ''
+  return trimmed.length > SEED_MAX ? trimmed.slice(0, SEED_MAX) : trimmed
+}
+
+/** 一次性种子槽（字符串或 null；null 表示无待消费种子）。 */
+let pendingSeed: string | null = null
+
+/**
+ * 写入待消费种子（空词等价于清除）。
+ * @author ddj 2026年09月18号
+ * @param text 选区文本（经 seedQueryOf 归一）
+ */
+export function setSearchSeed(text: unknown): void {
+  const seed = seedQueryOf(text)
+  pendingSeed = seed ? seed : null
+}
+
+/**
+ * 取走待消费种子（取后即清空，保证挂载路径与焦点路径不会重复应用同一个种子）。
+ * @author ddj 2026年09月18号
+ * @returns 种子搜索词；无待消费种子返回空串
+ */
+export function takeSearchSeed(): string {
+  const seed = pendingSeed
+  pendingSeed = null
+  return seed ?? ''
+}
+
+/** 清空待消费种子（测试隔离用）。 */
+export function clearSearchSeed(): void {
+  pendingSeed = null
+}

package/src/client/sidebar/panels/SearchPanel.ts

@@ -12,6 +12,7 @@ import { rpc } from '../../rpc.js'
 import type { SidebarCtx } from '../types.js'
 import { CACHE_KEY } from '../../paths.js'
 import { workspaceScopeOf } from '../../state/scopeStore.js'
+import { takeSearchSeed } from '../../searchSeed.js'
 
 const DEBOUNCE_MS = 250
 const INCLUDE_PLACEHOLDER = '例如 *.ts, src/**/include'
@@ -25,6 +26,23 @@ export function splitGlobs(text) {
   return String(text ?? '').split(',').map((item) => item.trim()).filter(Boolean)
 }
 
+/**
+ * 读取按作用域持久化的搜索条件（损坏/缺失返回 null）。
+ * 抽成函数而非内联：恢复 effect 内有两处消费者（填状态、同步 requestRef），
+ * 且解析必须只做一次（JSON.parse 重复调用既慢又可能两次结果不一致）。
+ * @author ddj 2026年09月18号
+ * @param key 作用域缓存键
+ * @returns 已解析的搜索条件对象；无/损坏返回 null
+ */
+export function savedSearchOf(key: string) {
+  try {
+    const parsed = JSON.parse(localStorage.getItem(key) || 'null')
+    return parsed && typeof parsed === 'object' ? parsed : null
+  } catch (e) {
+    return null
+  }
+}
+
 /**
  * 命中行文本三段切分（before/命中/after，列为 1-based UTF-16）。
  * @param text 行文本
@@ -82,20 +100,31 @@ export function SearchPanel(props) {
   // 按作用域恢复上次查询、选项与过滤模式（VSCode 记忆搜索词）
   React.useEffect(() => {
     if (!scope) return
-    try {
-      const saved = JSON.parse(localStorage.getItem(CACHE_KEY.search + String(scope)) || 'null')
-      if (saved && typeof saved === 'object') {
-        if (typeof saved.query === 'string') setQuery(saved.query)
-        if (typeof saved.matchCase === 'boolean') setMatchCase(saved.matchCase)
-        if (typeof saved.wholeWord === 'boolean') setWholeWord(saved.wholeWord)
-        if (typeof saved.regex === 'boolean') setRegex(saved.regex)
-        if (typeof saved.includeText === 'string') setIncludeText(saved.includeText)
-        if (typeof saved.excludeText === 'string') setExcludeText(saved.excludeText)
-        if (typeof saved.onlyActive === 'boolean') setOnlyActive(saved.onlyActive)
-        if (typeof saved.excludeOn === 'boolean') setExcludeOn(saved.excludeOn)
-        if (typeof saved.sectionOpen === 'boolean') setSectionOpen(saved.sectionOpen)
+    const saved = savedSearchOf(CACHE_KEY.search + String(scope))
+    if (saved) {
+      if (typeof saved.query === 'string') setQuery(saved.query)
+      if (typeof saved.matchCase === 'boolean') setMatchCase(saved.matchCase)
+      if (typeof saved.wholeWord === 'boolean') setWholeWord(saved.wholeWord)
+      if (typeof saved.regex === 'boolean') setRegex(saved.regex)
+      if (typeof saved.includeText === 'string') setIncludeText(saved.includeText)
+      if (typeof saved.excludeText === 'string') setExcludeText(saved.excludeText)
+      if (typeof saved.onlyActive === 'boolean') setOnlyActive(saved.onlyActive)
+      if (typeof saved.excludeOn === 'boolean') setExcludeOn(saved.excludeOn)
+      if (typeof saved.sectionOpen === 'boolean') setSectionOpen(saved.sectionOpen)
+      // 显式把恢复后的选项同步进 requestRef：render 期的同步要等下一次渲染才生效，
+      // 而紧随其后的「选区种子」effect 会在本次 commit 内立即搜索，读到的会是陈旧选项。
+      requestRef.current = {
+        matchCase: saved.matchCase === true,
+        wholeWord: saved.wholeWord === true,
+        regex: saved.regex === true,
+        include: saved.onlyActive === true
+          ? (activePathRef.current ? [activePathRef.current] : [])
+          : splitGlobs(typeof saved.includeText === 'string' ? saved.includeText : ''),
+        exclude: saved.excludeOn === true
+          ? splitGlobs(typeof saved.excludeText === 'string' ? saved.excludeText : '')
+          : [],
       }
-    } catch (e) { /* 损坏忽略 */ }
+    }
   }, [scope])
 
   // 查询/选项/过滤变化 → 持久化
@@ -191,9 +220,35 @@ export function SearchPanel(props) {
     })
   }
 
-  // Ctrl+Shift+F 重复触发时聚焦输入框（EditorView 派发 edrv:search-focus）
+  /**
+   * 取用一次性选区种子（需求 1：Ctrl+Shift+F 时把编辑器选中文本填入搜索框）。
+   * 有种子即填入并立即搜索（不再等 250ms 防抖），同时全选便于直接改写；无种子为 no-op。
+   * @author ddj 2026年09月18号
+   * @returns 是否消费到种子
+   */
+  const applySeed = () => {
+    const seed = takeSearchSeed()
+    if (!seed) return false
+    if (timerRef.current) clearTimeout(timerRef.current)
+    queryRef.current = seed
+    setQuery(seed)
+    runSearch(seed)
+    inputRef.current?.select?.()
+    return true
+  }
+
+  // 挂载时消费种子：侧栏原本收起 → 派发 edrv:search-focus 时本面板尚未挂载，
+  // 事件无人接收，故必须由挂载路径兜底。
+  // ⚠️ 声明在「按作用域恢复」effect 之后：React 按声明序执行 effect，恢复值先落地，
+  // 种子再覆盖，避免被记忆的旧查询词盖掉用户刚选中的内容。
+  React.useEffect(() => { applySeed() }, [])
+
+  // Ctrl+Shift+F 重复触发：消费种子（有则填入）并聚焦输入框（EditorView 派发 edrv:search-focus）
   React.useEffect(() => {
-    const onFocus = () => inputRef.current?.focus?.()
+    const onFocus = () => {
+      applySeed()
+      inputRef.current?.focus?.()
+    }
     window.addEventListener('edrv:search-focus', onFocus)
     return () => window.removeEventListener('edrv:search-focus', onFocus)
   }, [])

package/src/client/styles/editor.css

@@ -5,7 +5,7 @@
    @author ddj 2026-09-10 */
 [data-edrv-view] { box-sizing: border-box; --edrv-tab-h: 34px; }
 
-[data-edrv-view] .edrv-tabs { display: flex; align-items: center; gap: 2px; padding: 2px 8px 0; background: var(--dsw-alias-bg-layer-1, transparent); overflow-x: auto; scrollbar-width: thin; flex-shrink: 0; }
+[data-edrv-view] .edrv-tabs { display: flex; align-items: center; gap: 2px; padding: 2px 8px 0; background: var(--dsw-alias-bg-layer-1, transparent); overflow-x: auto; overflow-y: hidden; scrollbar-width: thin; flex-shrink: 0; overscroll-behavior-x: contain; } /* overscroll-behavior-x: 横滚到边界不把滚动链传给页面（滚轮横滚接管更可控）@author ddj 2026年09月18号 */
 [data-edrv-view] .edrv-tab { display: inline-flex; align-items: center; gap: 6px; height: 28px; padding: 0 8px 0 12px; border: none; border-radius: 6px 6px 0 0; background: transparent; color: var(--dsw-alias-label-secondary, #aaa); font-size: 12px; cursor: pointer; white-space: nowrap; flex-shrink: 0; }
 [data-edrv-view] .edrv-tab:hover { background: var(--dsw-alias-interactive-bg-hover, rgba(255,255,255,.06)); }
 [data-edrv-view] .edrv-tab.edrv-tab-active { background: var(--dsw-alias-bg-base, #111); color: var(--dsw-alias-label-primary, #eee); box-shadow: inset 0 -2px 0 var(--dsw-alias-brand-primary, #4f8cff); }
@@ -84,6 +84,15 @@
 [data-edrv-view] .edrv-pdf-mode-on { background: var(--dsw-alias-interactive-bg-hover, rgba(15,157,88,.12)); color: var(--dsw-alias-brand-primary, #0f9d58); border-color: var(--dsw-alias-brand-primary, #0f9d58); }
 [data-edrv-view] .edrv-pdf-dirty { color: var(--dsw-alias-state-warn-primary, #d97706); border-color: var(--dsw-alias-state-warn-primary, #d97706); }
 [data-edrv-view] .edrv-pdf-stage { position: absolute; top: 34px; left: 0; right: 0; bottom: 0; overflow: auto; }
+/* Markdown 预览（需求 4）：工具条 + 居中阅读栏；正文排版由官方 MarkdownText 自带的 --dsw-* 样式负责 */
+[data-edrv-view] .edrv-mdview { flex: 1 1 auto; min-width: 0; min-height: 0; display: flex; flex-direction: column; overflow: hidden; }
+[data-edrv-view] .edrv-mdview-bar { display: flex; align-items: center; gap: 8px; height: 34px; padding: 0 10px; flex-shrink: 0; border-bottom: 1px solid var(--dsw-alias-border-l1, #e0e6e8); background: var(--dsw-alias-bg-layer-1, transparent); }
+[data-edrv-view] .edrv-mdview-meta { font-size: 11px; color: var(--dsw-alias-label-tertiary, #9aa5b1); white-space: nowrap; }
+[data-edrv-view] .edrv-mdview-stage { flex: 1 1 auto; min-height: 0; overflow: auto; padding: 14px 20px 28px; }
+[data-edrv-view] .edrv-mdview-doc { max-width: 880px; margin: 0 auto; width: 100%; }
+[data-edrv-view] .edrv-mdview-fallback { font-size: 12px; line-height: 1.7; color: var(--dsw-alias-label-secondary, #52606d); }
+[data-edrv-view] .edrv-mdview-pre { margin: 8px 0 0; padding: 10px 12px; border-radius: 8px; background: var(--dsw-alias-bg-layer-2, #f0f4f4); color: var(--dsw-alias-label-primary, #1f2933); font-family: var(--ds-font-family-code, ui-monospace, monospace); font-size: 11px; line-height: 1.6; white-space: pre-wrap; word-break: break-word; }
+[data-edrv-view] .edrv-pb-mdbtn { height: 20px; padding: 0 8px; font-size: 11px; flex-shrink: 0; }
 [data-edrv-view] .edrv-pdf-stage .edrv-pdf-viewer { margin: 0 auto; }
 [data-edrv-view] .edrv-empty { display: flex; flex-direction: column; align-items: center; justify-content: center; gap: 10px; height: 100%; color: var(--dsw-alias-label-tertiary, #777); font-size: 13px; }
 [data-edrv-view] .edrv-diffbar { position: absolute; left: 0; right: 0; bottom: 10px; margin: 0 auto; z-index: 25; width: fit-content; max-width: calc(100% - 20px); border-radius: 12px; background: var(--dsw-specific-tip, var(--dsw-alias-bg-layer-2, #f0f4f4)); border: 1px solid var(--dsw-alias-border-l1, #e0e6e8); box-shadow: none; overflow: visible; display: flex; flex-direction: column; }

package/src/client/tabActions.ts

@@ -255,6 +255,60 @@ export function pickActive(tabs: TabLike[], wanted: unknown): string | null {
 }
 // --endregion
 
+// --region 上限淘汰
+
+/** 淘汰判定输入：活动页签、使用序、额外保留集。 */
+export interface EvictOptions {
+  /** 当前活动页签路径（**绝不被淘汰**）。 */
+  active: string | null
+  /** 路径 → 最近使用序号（单调递增；越大越新）。缺记录按最久未用处理。 */
+  used: Record<string, number>
+  /** 额外保留集（调用方按需保护，如「恢复中刚载入的页签」）。 */
+  keep?: ReadonlySet<string>
+}
+
+/**
+ * 计算超限时应淘汰的页签路径（最久未使用者优先）。
+ *
+ * 保护规则（不满足则允许溢出而非强关，调用方据此保持「溢出态」：
+ * 用户显式固定过、或正在查看的页签，都不该被上限悄悄夺走）：
+ * - `limit <= 0` → 上限关闭，返回空数组；
+ * - 未超限 → 返回空数组；
+ * - 固定页签（`pinned === true`）不是候选；
+ * - 活动页签不是候选；
+ * - `keep` 命中的路径不是候选。
+ *
+ * 脏页签**仍是候选**：其未保存内容的落盘由调用方在关闭前完成（EditorView 走
+ * closeTabs → persistDirty），本函数不感知磁盘，避免把 IO 语义掺进纯判定。
+ *
+ * @author ddj 2026年09月18号
+ * @param tabs 当前页签
+ * @param limit 页签上限（0 = 不限制）
+ * @param options 活动页签、使用序与额外保留集
+ * @returns 待淘汰路径（按最久未用在前）；无需淘汰时为 `[]`
+ */
+export function evictPlan(tabs: TabLike[], limit: number, options: EvictOptions): string[] {
+  if (!Array.isArray(tabs) || !Number.isFinite(limit) || limit <= 0) return []
+  const excess = tabs.length - Math.floor(limit)
+  if (excess <= 0) return []
+  const active = options?.active ?? null
+  const used = options?.used ?? {}
+  const keep = options?.keep
+  const candidates: Array<{ path: string; at: number; at0: number }> = []
+  for (let i = 0; i < tabs.length; i += 1) {
+    const tab = tabs[i]
+    if (tab.pinned === true) continue
+    if (tab.path === active) continue
+    if (keep?.has(tab.path) === true) continue
+    const order = used[tab.path]
+    candidates.push({ path: tab.path, at: Number.isFinite(order) ? order : -1, at0: i })
+  }
+  // 使用序升序 = 最久未用在前；同序（含全部无记录）按页签原下标，保证确定性
+  candidates.sort((a, b) => (a.at === b.at ? a.at0 - b.at0 : a.at - b.at))
+  return candidates.slice(0, excess).map((item) => item.path)
+}
+// --endregion
+
 // --region 路径推导
 
 /** Windows 盘符 / UNC / POSIX 根：视为工作区外的绝对路径。 */