dsh-vscode-mode 0.1.35 → 0.1.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.1.35",
+  "version": "0.1.42",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 dsh-better-sidebar 侧边栏与对话同屏）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车",
   "keywords": [
     "dsh",

package/src/client/monaco/loader.ts

@@ -4,6 +4,7 @@
  * 迁移自原 src/client/index.ts 的 MONACO_BASE/LANG_BY_EXT/langOf/loadMonaco，语义不改。
  * 作者 ddj 2026-08-20
  */
+import { applyTheme, registerThemes } from './theme.js'
 
 export const MONACO_BASE = '/edrv/vendor/monaco/vs'
 let monacoPromise = null
@@ -58,7 +59,12 @@ export const LANG_BY_EXT = {
   py: 'python', sh: 'shell', bash: 'shell', zsh: 'shell', ps1: 'powershell',
   lua: 'lua', java: 'java', c: 'c', h: 'c', cpp: 'cpp', cc: 'cpp', cxx: 'cpp', hpp: 'cpp',
   cs: 'csharp', go: 'go', rs: 'rust', rb: 'ruby', php: 'php', sql: 'sql',
-  swift: 'swift', kt: 'kotlin', kts: 'kotlin', dart: 'dart', dockerfile: 'dockerfile'
+  swift: 'swift', kt: 'kotlin', kts: 'kotlin', dart: 'dart', dockerfile: 'dockerfile',
+  // 工程/配置文件（拿到正确语法分色，而非 plaintext）
+  csproj: 'xml', props: 'xml', targets: 'xml', plist: 'xml',
+  lua51: 'lua', luac: 'lua',
+  gitattributes: 'ini', editorconfig: 'ini', env: 'ini', properties: 'ini',
+  json5: 'jsonc', log: 'plaintext', txt: 'plaintext',
 }
 
 /**
@@ -96,6 +102,11 @@ export function loadMonaco(onProgress) {
           publishStage('core', MONACO_STAGES.core.progress, MONACO_STAGES.core.message)
           window.require(['vs/editor/editor.main'], () => {
             publishStage('ready', MONACO_STAGES.ready.progress, MONACO_STAGES.ready.message)
+            // 分色主题注册 + 应用（rich token 配色，替掉内置基础 vs 的少层次着色）
+            try {
+              registerThemes(window.monaco)
+              applyTheme(window.monaco)
+            } catch (error) { /* 主题失败不阻塞编辑器 */ }
             resolve(window.monaco)
           }, (err) => fail(new Error('Monaco 模块加载失败：' + String(err))))
         } catch (error) {

package/src/client/monaco/lsp/lspClient.ts

@@ -113,6 +113,14 @@ export async function fetchHover(path, text, position) {
   return res.hover || null
 }
 
+/** 查询当前文档的 semantic tokens（host 已归一化 legend 与 delta data）。 */
+export async function fetchSemanticTokens(path, text) {
+  await syncDoc(path, text, true)
+  const res = await rpc('edrv.lsp.semanticTokens', { sessionId, path }).catch(() => null)
+  if (!res || !res.ok || !res.tokens || !Array.isArray(res.tokens.data)) return null
+  return res.tokens
+}
+
 /** 拉取服务器状态（带 5s 缓存）。 */
 export async function refreshStatus(force = false) {
   if (!force && Date.now() - statusCache.at < 1500) return statusCache.servers
@@ -148,6 +156,10 @@ function toClientLocation(loc) {
       Math.max(1, (end.line ?? 0) + 1),
       Math.max(1, (end.character ?? 0) + 1),
     ),
+    // 保留原始 LSP uri/root：后续跳转不能把 Monaco edrv Uri 当作磁盘路径
+    lspUri: loc.uri,
+    lspRoot: loc.root,
+    lspRange: loc.range,
   }
 }
 
@@ -161,32 +173,74 @@ export function toEdrvUri(uri, root) {
 
 /** 将 LSP 目标解析为当前工作区相对路径（跨文件跳转与 model URI 对齐）。 */
 export function targetOpenPath(loc) {
-  return relativeLspPath(loc?.uri, loc?.root)
+  return relativeLspPath(loc?.lspUri ?? loc?.uri, loc?.lspRoot ?? loc?.root)
 }
 
-/** file URI/裸路径 → root 下的 / 分隔相对路径；root 不匹配时保留规范化绝对路径。 */
-function relativeLspPath(uri, root) {
+/**
+ * 归一化 Location 的 uri → 工作区路径（剥离 scheme，不补盘符）。
+ * 三种输入形态（缺一即导致 scheme 泄漏进文件路径 → 跳转"文件不存在"）：
+ * - Monaco Uri 对象（toClientLocation 产物，scheme=edrv）→ 取 .path（已是工作区相对路径）
+ * - 'edrv:///x' 字符串 → 取路径部分
+ * - 'file:///D:/x' → 去 authority 空段保留盘符
+ * @author ddj 2026年08月28号
+ * @param uri Monaco Uri 对象 / file:// 或 edrv:// URI / 裸路径
+ * @returns / 分隔的路径（edrv 相对路径 或 带盘符绝对路径）
+ */
+export function lspUriToAbs(uri) {
   if (!uri) return ''
-  let path = String(uri)
+  const isObject = typeof uri === 'object'
+  // Monaco Uri 对象：优先取其 path（已剥离 scheme）
+  const raw = isObject && typeof uri.path === 'string' ? uri.path : String(uri)
+  let path = raw
   if (path.startsWith('file://')) {
-    try { path = decodeURIComponent(path.replace(/^file:\/\//, '')) } catch (error) { path = path.replace(/^file:\/\//, '') }
+    try { path = decodeURIComponent(path.replace(/^file:\/\/\/?/, '')) } catch (error) { path = path.replace(/^file:\/\/\/?/, '') }
+    // file:///D:/x → D:/x（去 authority 空段保留盘符）；/home/x 保留前导 /（Unix 绝对路径）
+    return path.replace(/\\/g, '/').replace(/^\/([A-Za-z]:)/, '$1')
+  }
+  if (path.startsWith('edrv://')) {
+    try { path = decodeURIComponent(path.replace(/^edrv:\/\/\/?/, '')) } catch (error) { path = path.replace(/^edrv:\/\/\/?/, '') }
   }
-  path = path.replace(/\\/g, '/').replace(/^\/([A-Za-z]:)/, '$1')
+  // edrv Uri（对象或字符串）→ 工作区相对路径：必须剥前导 /，否则 host 按绝对路径解析丢 cwd
+  if (isObject ? uri.scheme === 'edrv' : raw.startsWith('edrv://')) {
+    return path.replace(/\\/g, '/').replace(/^\/+/, '')
+  }
+  return path.replace(/\\/g, '/').replace(/^\/([A-Za-z]:)/, '$1')
+}
+
+/**
+ * file URI/裸路径 → root 下的 / 分隔相对路径。
+ * root 匹配返回工作区相对路径；root 不匹配返回完整绝对路径（保留盘符），
+ * 供 edrv.read 按绝对路径解析（原先错误剥掉首个 / 导致跳转"文件不存在"）。
+ * @author ddj 2026年08月28号
+ * @param uri file:// URI 或裸路径
+ * @param root 工作区根（可选）
+ * @returns 可 edrv.read 的路径
+ */
+function relativeLspPath(uri, root) {
+  if (!uri) return ''
+  const path = lspUriToAbs(uri)
   const normalizedRoot = root ? String(root).replace(/\\/g, '/').replace(/^\/([A-Za-z]:)/, '$1').replace(/\/+$/, '') : ''
   const lowerPath = path.toLowerCase()
   const lowerRoot = normalizedRoot.toLowerCase()
   if (normalizedRoot && (lowerPath === lowerRoot || lowerPath.startsWith(lowerRoot + '/'))) {
     return path.slice(normalizedRoot.length).replace(/^\/+/, '')
   }
-  return path.replace(/^\/+/, '')
+  return path
 }
 
 /** 目标行/列（0-based LSP → 1-based Monaco）。 */
 export function targetMonoPosition(loc) {
-  const range = loc.range || {}
-  const start = range.start || {}
+  // 优先使用原始 LSP range（0-based）；无原始值时兼容 Monaco Range（1-based）
+  const lspRange = loc?.lspRange
+  if (lspRange?.start) {
+    return {
+      line: Math.max(1, (lspRange.start.line ?? 0) + 1),
+      column: Math.max(1, (lspRange.start.character ?? 0) + 1),
+    }
+  }
+  const range = loc?.range ?? {}
   return {
-    line: Math.max(1, (start.line ?? 0) + 1),
-    column: Math.max(1, (start.character ?? 0) + 1),
+    line: Math.max(1, range.startLineNumber ?? 1),
+    column: Math.max(1, range.startColumn ?? 1),
   }
 }

package/src/client/monaco/lsp/providers.ts

@@ -8,10 +8,16 @@
  */
 import {
   pathOfModel, syncDoc, closeDoc, findDefinition, findReferences,
-  fetchDocumentSymbols, fetchHover, targetOpenPath, targetMonoPosition, lspStatusFor,
+  fetchDocumentSymbols, fetchHover, fetchSemanticTokens,
+  targetOpenPath, targetMonoPosition, lspStatusFor, refreshStatus,
 } from './lspClient.js'
+import { LSP_SEMANTIC_TOKEN_MODIFIERS, LSP_SEMANTIC_TOKEN_TYPES } from '../../../shared/lsp.js'
 
 const LSP_LANGS = ['lua', 'csharp']
+const SEMANTIC_LEGEND = {
+  tokenTypes: [...LSP_SEMANTIC_TOKEN_TYPES],
+  tokenModifiers: [...LSP_SEMANTIC_TOKEN_MODIFIERS],
+}
 let registered = false
 const disposables = []
 let overlayEl = null
@@ -48,6 +54,22 @@ export function registerLspProviders(monaco) {
   disposables.push(monaco.editor.onDidCreateModel(attachModel))
   for (const model of monaco.editor.getModels()) attachModel(model)
 
+  // —— 重新检测事件：保存配置/切换启用/手动重检测后，把已打开模型重新同步给 host ——
+  // （host 已重置该语言 server，下一次 sync 会按最新配置重新 acquire，无需重开文件）
+  const onRedetect = (event) => {
+    const languageId = event?.detail?.languageId
+    if (!languageId) return
+    for (const model of monaco.editor.getModels()) {
+      const path = pathOfModel(model)
+      if (!path) continue
+      if (model.getLanguageId && model.getLanguageId() !== languageId) continue
+      void syncDoc(path, model.getValue(), true)
+    }
+    void refreshStatus(true)
+  }
+  window.addEventListener('edrv:lsp-redetect', onRedetect)
+  disposables.push(() => window.removeEventListener('edrv:lsp-redetect', onRedetect))
+
   // —— 数据 provider ——
   disposables.push(
     monaco.languages.registerDefinitionProvider(LSP_LANGS, {
@@ -87,6 +109,17 @@ export function registerLspProviders(monaco) {
         }
       },
     }),
+    monaco.languages.registerDocumentSemanticTokensProvider(LSP_LANGS, {
+      getLegend: () => SEMANTIC_LEGEND,
+      provideDocumentSemanticTokens: async (model, token) => {
+        const path = pathOfModel(model)
+        if (!path || token?.isCancellationRequested) return { data: new Uint32Array() }
+        const result = await fetchSemanticTokens(path, model.getValue())
+        if (!result || token?.isCancellationRequested) return { data: new Uint32Array() }
+        return { data: Uint32Array.from(result.data) }
+      },
+      releaseDocumentSemanticTokens: () => {},
+    }),
   )
 }
 

package/src/client/monaco/theme.ts

@@ -0,0 +1,229 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — Monaco 语法分色主题（rich token 配色）。
+ * 编辑器原先硬编码 'vs'（内置基础主题），token 分色层次少；
+ * 这里定义 edrv-dark / edrv-light 两套完整 token 配色（对齐 VSCode Dark+ 语义分层），
+ * 并随 DSH 明暗主题自动切换（跟随文档根 data 主题属性 / prefers-color-scheme）。
+ * 作者 ddj 2026-08-28
+ */
+
+export const EDRV_DARK = 'edrv-dark'
+export const EDRV_LIGHT = 'edrv-light'
+export const EDRV_FALLBACK = 'vs'
+
+/** 语法分色（语义分层：关键字/字符串/数字/注释/函数/变量/类型/运算符/正则/标签/属性…）。 */
+const DARK_RULES = [
+  { token: '', foreground: 'd4d4d4', background: '1e1e1e' },
+  { token: 'comment', foreground: '6a9955', fontStyle: 'italic' },
+  { token: 'comment.doc', foreground: '7ca97c', fontStyle: 'italic' },
+  { token: 'keyword', foreground: 'c586c0' },
+  { token: 'keyword.control', foreground: 'c586c0' },
+  { token: 'keyword.operator', foreground: 'd4d4d4' },
+  { token: 'keyword.json', foreground: '9cdcfe' },
+  { token: 'string', foreground: 'ce9178' },
+  { token: 'string.escape', foreground: 'd7ba7d' },
+  { token: 'string.key.json', foreground: '9cdcfe' },
+  { token: 'string.value.json', foreground: 'ce9178' },
+  { token: 'string.yaml', foreground: 'ce9178' },
+  { token: 'number', foreground: 'b5cea8' },
+  { token: 'number.hex', foreground: 'b5cea8' },
+  { token: 'regexp', foreground: 'd16969' },
+  { token: 'type', foreground: '4ec9b0' },
+  { token: 'type.identifier', foreground: '4ec9b0' },
+  { token: 'identifier', foreground: 'd4d4d4' },
+  { token: 'variable', foreground: '9cdcfe' },
+  { token: 'variable.global', foreground: 'ff6699' },
+  { token: 'variable.local', foreground: '9cdcfe' },
+  { token: 'variable.mutable', foreground: '9cdcfe' },
+  { token: 'variable.predefined', foreground: '4fc1ff' },
+  { token: 'variable.parameter', foreground: '00bfae' },
+  { token: 'parameter', foreground: '00bfae' },
+  { token: 'function', foreground: 'dcdcaa' },
+  { token: 'method', foreground: 'dcdcaa' },
+  { token: 'property', foreground: '9cdcfe' },
+  { token: 'function.identifier', foreground: 'dcdcaa' },
+  { token: 'member', foreground: 'dcdcaa' },
+  { token: 'constant', foreground: '4fc1ff' },
+  { token: 'constant.numeric', foreground: 'b5cea8' },
+  { token: 'constant.language', foreground: '569cd6' },
+  { token: 'tag', foreground: '569cd6' },
+  { token: 'tag.xml', foreground: '569cd6' },
+  { token: 'metatag', foreground: '808080' },
+  { token: 'attribute.name', foreground: '9cdcfe' },
+  { token: 'attribute.value', foreground: 'ce9178' },
+  { token: 'delimiter', foreground: 'd4d4d4' },
+  { token: 'delimiter.bracket', foreground: 'ffd700' },
+  { token: 'delimiter.html', foreground: '808080' },
+  { token: 'operator', foreground: 'd4d4d4' },
+  { token: 'namespace', foreground: '4ec9b0' },
+  { token: 'class', foreground: '4ec9b0' },
+  { token: 'interface', foreground: '4ec9b0' },
+  { token: 'enum', foreground: '4ec9b0' },
+  { token: 'struct', foreground: '4ec9b0' },
+  { token: 'annotation', foreground: 'dcdcaa' },
+  { token: 'punctuation', foreground: 'd4d4d4' },
+  { token: 'invalid', foreground: 'f44747' },
+]
+
+const LIGHT_RULES = [
+  { token: '', foreground: '1e1e1e', background: 'ffffff' },
+  { token: 'comment', foreground: '008000', fontStyle: 'italic' },
+  { token: 'comment.doc', foreground: '2e7d32', fontStyle: 'italic' },
+  { token: 'keyword', foreground: '0000ff' },
+  { token: 'keyword.control', foreground: 'af00db' },
+  { token: 'keyword.operator', foreground: '1e1e1e' },
+  { token: 'keyword.json', foreground: '0451a5' },
+  { token: 'string', foreground: 'a31515' },
+  { token: 'string.escape', foreground: 'ee0000' },
+  { token: 'string.key.json', foreground: '0451a5' },
+  { token: 'string.value.json', foreground: 'a31515' },
+  { token: 'string.yaml', foreground: 'a31515' },
+  { token: 'number', foreground: '098658' },
+  { token: 'number.hex', foreground: '098658' },
+  { token: 'regexp', foreground: '811f3f' },
+  { token: 'type', foreground: '267f99' },
+  { token: 'type.identifier', foreground: '267f99' },
+  { token: 'identifier', foreground: '1e1e1e' },
+  { token: 'variable', foreground: '001080' },
+  { token: 'variable.global', foreground: 'c2185b' },
+  { token: 'variable.local', foreground: '001080' },
+  { token: 'variable.mutable', foreground: '001080' },
+  { token: 'variable.predefined', foreground: '001080' },
+  { token: 'variable.parameter', foreground: '008577' },
+  { token: 'parameter', foreground: '008577' },
+  { token: 'function', foreground: '795e26' },
+  { token: 'method', foreground: '795e26' },
+  { token: 'function.identifier', foreground: '795e26' },
+  { token: 'member', foreground: '795e26' },
+  { token: 'property', foreground: '001080' },
+  { token: 'constant', foreground: '0070c1' },
+  { token: 'constant.numeric', foreground: '098658' },
+  { token: 'constant.language', foreground: '0000ff' },
+  { token: 'tag', foreground: '800000' },
+  { token: 'tag.xml', foreground: '800000' },
+  { token: 'metatag', foreground: '6b6b6b' },
+  { token: 'attribute.name', foreground: 'e50000' },
+  { token: 'attribute.value', foreground: '0451a5' },
+  { token: 'delimiter', foreground: '1e1e1e' },
+  { token: 'delimiter.bracket', foreground: 'b46400' },
+  { token: 'delimiter.html', foreground: '800000' },
+  { token: 'operator', foreground: '1e1e1e' },
+  { token: 'namespace', foreground: '267f99' },
+  { token: 'class', foreground: '267f99' },
+  { token: 'interface', foreground: '267f99' },
+  { token: 'enum', foreground: '267f99' },
+  { token: 'struct', foreground: '267f99' },
+  { token: 'annotation', foreground: '795e26' },
+  { token: 'punctuation', foreground: '1e1e1e' },
+  { token: 'invalid', foreground: 'cd3131' },
+]
+
+/** 编辑器 UI 配色（与语法配色同套，保证 gutter/minimap/selection 一致）。 */
+const DARK_COLORS = {
+  'editor.background': '#1e1e1e',
+  'editor.foreground': '#d4d4d4',
+  'editorLineNumber.foreground': '#6e7681',
+  'editorLineNumber.activeForeground': '#c6c6c6',
+  'editor.selectionBackground': '#264f78',
+  'editor.inactiveSelectionBackground': '#3a3d41',
+  'editor.lineHighlightBackground': '#2a2d2e',
+  'editorCursor.foreground': '#aeafad',
+  'editorIndentGuide.background1': '#404040',
+  'editorIndentGuide.activeBackground1': '#707070',
+  'editorWidget.background': '#252526',
+  'editorHoverWidget.background': '#252526',
+  'editorGutter.background': '#1e1e1e',
+  'minimap.background': '#1e1e1e',
+  'scrollbarSlider.background': '#79797966',
+  'scrollbarSlider.hoverBackground': '#646464b3',
+  'scrollbarSlider.activeBackground': '#bfbfbf66',
+}
+
+const LIGHT_COLORS = {
+  'editor.background': '#ffffff',
+  'editor.foreground': '#1e1e1e',
+  'editorLineNumber.foreground': '#6c6c6c',
+  'editorLineNumber.activeForeground': '#171184',
+  'editor.selectionBackground': '#add6ff',
+  'editor.inactiveSelectionBackground': '#e5ebf1',
+  'editor.lineHighlightBackground': '#f0f0f0',
+  'editorCursor.foreground': '#000000',
+  'editorIndentGuide.background1': '#d3d3d3',
+  'editorIndentGuide.activeBackground1': '#939393',
+  'editorWidget.background': '#f3f3f3',
+  'editorHoverWidget.background': '#f3f3f3',
+  'editorGutter.background': '#ffffff',
+  'minimap.background': '#ffffff',
+  'scrollbarSlider.background': '#64646466',
+  'scrollbarSlider.hoverBackground': '#646464b3',
+  'scrollbarSlider.activeBackground': '#00000099',
+}
+
+/**
+ * 注册 edrv 双套主题（幂等；Monaco 未加载时静默跳过）。
+ * @author ddj 2026年08月28号
+ * @param monaco Monaco 实例（window.monaco）
+ */
+export function registerThemes(monaco) {
+  if (!monaco?.editor?.defineTheme) return
+  try {
+    monaco.editor.defineTheme(EDRV_DARK, {
+      base: 'vs-dark',
+      inherit: true,
+      rules: DARK_RULES,
+      colors: DARK_COLORS,
+    })
+    monaco.editor.defineTheme(EDRV_LIGHT, {
+      base: 'vs',
+      inherit: true,
+      rules: LIGHT_RULES,
+      colors: LIGHT_COLORS,
+    })
+  } catch (error) {
+    /* 主题注册失败保留内置 vs */
+  }
+}
+
+/**
+ * 探测当前 DSH 明暗（文档根 data 主题属性 → prefers-color-scheme → 暗）。
+ * @author ddj 2026年08月28号
+ * @returns 'dark' | 'light'
+ */
+export function detectColorScheme() {
+  try {
+    const attr = document.documentElement?.getAttribute?.('data-theme')
+      ?? document.body?.getAttribute?.('data-theme')
+    const value = String(attr ?? '').toLowerCase()
+    if (value.includes('light') || value.includes('catppuccin-latte')) return 'light'
+    if (value.includes('dark') || value.includes('frappe') || value.includes('macchiato') || value.includes('mocha')) return 'dark'
+    if (typeof window.matchMedia === 'function') {
+      return window.matchMedia('(prefers-color-scheme: light)').matches ? 'light' : 'dark'
+    }
+  } catch (error) {
+    /* 探测失败回落暗色 */
+  }
+  return 'dark'
+}
+
+/**
+ * 主题名：按当前明暗返回已注册主题（未注册回落 vs）。
+ * @author ddj 2026年08月28号
+ * @returns 主题 id
+ */
+export function themeNameOf() {
+  return detectColorScheme() === 'light' ? EDRV_LIGHT : EDRV_DARK
+}
+
+/**
+ * 应用主题到 Monaco（全局切换；新建编辑器也用该主题）。
+ * @author ddj 2026年08月28号
+ * @param monaco Monaco 实例
+ */
+export function applyTheme(monaco) {
+  if (!monaco?.editor?.setTheme) return
+  try {
+    monaco.editor.setTheme(themeNameOf())
+  } catch (error) {
+    /* setTheme 失败忽略 */
+  }
+}

package/src/client/paths.ts

@@ -22,6 +22,8 @@ export const CACHE_KEY = {
   search: 'edrv.search.v1.',
   /** 侧边栏提示已关闭标记（全局，无会话）。 */
   sideHint: 'edrv.side-hint-dismissed',
+  /** 「性能优化」页工作区栏目展开状态（workspaceFoldCache v1，全局不按会话）。 */
+  workspaceFold: 'edrv.ws-fold.v1.',
 } as const
 
 /** 按前缀拼会话键（侧边栏/编辑器等需要布局段时自行拼接后传入）。 */

package/src/client/state/workspaceFoldCache.ts

@@ -0,0 +1,95 @@
+/**
+ * dsh-vscode-mode client — 「性能优化」页工作区栏目展开状态持久化（纯函数，可单测）。
+ * 只持久化「已展开」的工作区键集合（默认全部折叠），对齐 explorerCache 的做法：
+ * 不缓存会话条目本身，条目由 edrv.perf.inventory 实时返回。
+ * 键前缀统一走 paths.ts PathConst（CACHE_KEY.workspaceFold）。
+ * 作者 ddj 2026-09-02
+ */
+import { CACHE_KEY } from '../paths.js'
+
+/** localStorage 键（全局，不按会话隔离）。 */
+const STORE_KEY = CACHE_KEY.workspaceFold
+
+/** 展开键容量上限：超出丢弃尾部，防止无限增长撑爆配额。 */
+export const FOLD_CAP = 300
+
+/**
+ * 归一化工作区键：仅去首尾空白（工作区键非文件系统路径，不做斜杠转换）。
+ * @author ddj 2026年09月02号
+ * @param key 工作区标识
+ * @returns 归一化键，空值返回 ''
+ */
+export function normalizeFoldKey(key: string | undefined | null): string {
+  return String(key ?? '').trim()
+}
+
+/**
+ * 裁剪展开键集：去重、丢弃空值、超容量丢弃尾部（保持传入顺序）。
+ * @author ddj 2026年09月02号
+ * @param expanded 原始展开键集合
+ * @returns 规范化后的键数组
+ */
+export function sanitizeFolded(expanded: unknown): string[] {
+  if (!Array.isArray(expanded)) return []
+  const seen = new Set<string>()
+  const out: string[] = []
+  for (const item of expanded) {
+    const key = normalizeFoldKey(typeof item === 'string' ? item : '')
+    if (!key || seen.has(key)) continue
+    seen.add(key)
+    out.push(key)
+    if (out.length >= FOLD_CAP) break
+  }
+  return out
+}
+
+/**
+ * 序列化展开状态（JSON，带 schema 版本号）。
+ * @author ddj 2026年09月02号
+ * @param expanded 已展开的项目键集合
+ * @returns JSON 字符串
+ */
+export function serializeFold(expanded: string[]): string {
+  return JSON.stringify({ v: 1, expanded: sanitizeFolded(expanded) })
+}
+
+/**
+ * 解析缓存文本；损坏/格式不符 → 空集合。
+ * @author ddj 2026年09月02号
+ * @param text localStorage 原文
+ * @returns 已展开键集合
+ */
+export function parseFold(text: string | null): string[] {
+  if (!text) return []
+  try {
+    const data = JSON.parse(text)
+    if (!data || typeof data !== 'object') return []
+    return sanitizeFolded(data.expanded)
+  } catch (error) {
+    return []
+  }
+}
+
+/**
+ * 读取展开状态（localStorage 不可用 → 空集合）。
+ * @author ddj 2026年09月02号
+ * @returns 已展开键集合
+ */
+export function foldLoad(): string[] {
+  try {
+    return parseFold(window.localStorage.getItem(STORE_KEY))
+  } catch (error) {
+    return []
+  }
+}
+
+/**
+ * 写入展开状态（配额满/隐私模式失败静默）。
+ * @author ddj 2026年09月02号
+ * @param expanded 已展开键集合
+ */
+export function foldSave(expanded: string[]): void {
+  try {
+    window.localStorage.setItem(STORE_KEY, serializeFold(expanded))
+  } catch (error) { /* 配额满/隐私模式忽略 */ }
+}

package/src/client/styles/mcp.css

@@ -10,18 +10,36 @@
 .vsm-primary:hover{background:var(--dsw-alias-button-primary-hover,#5a46e6)}
 .vsm-primary:disabled{opacity:.55;cursor:default}
 
-/* 子 Tab：我的 MCP / MCP 市场 */
+/* MCP 管理下的二级子页签：我的 MCP / 项目 MCP / MCP 市场 */
+.vsm-mcp-subhead{display:flex;align-items:center;justify-content:space-between;gap:16px;margin-top:-4px}
+.vsm-mcp-subtabs{display:flex;gap:18px;border-bottom:1px solid var(--dsw-alias-border-l1,#2e2e2e);flex:1}
+.vsm-mcp-subtabs button{border:0;background:none;color:var(--dsw-alias-label-tertiary,#9aa5b1);padding:7px 2px 9px;cursor:pointer;font-size:13px;position:relative}
+.vsm-mcp-subtabs button:hover{color:var(--dsw-alias-label-secondary,#c8c8c8)}
+.vsm-mcp-subtabs button.active{color:var(--dsw-alias-label-primary,#fff);font-weight:500}
+.vsm-mcp-subtabs button.active::after{content:"";position:absolute;left:0;right:0;bottom:-1px;height:2px;background:var(--dsw-alias-brand-primary,#6d55ff);border-radius:2px}
+
+/* 顶层 Tab：通用 / 快捷键 / MCP 管理 / 语言服务器 / 性能优化 / 兼容性 */
 .vsm-mcp-tabs{display:flex;gap:24px;border-bottom:1px solid var(--dsw-alias-border-l2,#3a3a3a)}
 .vsm-mcp-tabs button{border:0;background:none;color:var(--dsw-alias-label-tertiary,#9aa5b1);padding:9px 2px 11px;cursor:pointer;font-size:14px;position:relative}
 .vsm-mcp-tabs button:hover{color:var(--dsw-alias-label-secondary,#c8c8c8)}
 .vsm-mcp-tabs button.active{color:var(--dsw-alias-label-primary,#fff);font-weight:500}
 .vsm-mcp-tabs button.active::after{content:"";position:absolute;left:0;right:0;bottom:-1px;height:2px;background:var(--dsw-alias-brand-primary,#6d55ff);border-radius:2px}
 
+/* 统一线框面板：圆角矩形边框圈住各设置分区，提升可读性。
+   用法：<section class="vsm-panel"> + 可选 <h3 class="vsm-panel-title">。 */
+.vsm-panel{border:1px solid var(--dsw-alias-border-l2,#3a3a3a);border-radius:12px;background:var(--dsw-alias-bg-layer-2,transparent);overflow:hidden}
+.vsm-panel-pad{padding:14px 16px}
+.vsm-panel-title{margin:0;padding:10px 16px;font-size:13px;font-weight:600;color:var(--dsw-alias-label-secondary,#c8c8c8);background:var(--dsw-alias-bg-mask-1,#ffffff0a);border-bottom:1px solid var(--dsw-alias-border-l1,#333)}
+.vsm-panel-body{padding:6px 16px}
+.vsm-panel-body>*:first-child{margin-top:8px}
+.vsm-panel-body>*:last-child{margin-bottom:10px}
+
 /* 通用设置 */
-.vsm-general-page{display:flex;flex-direction:column;gap:10px;max-width:720px}
+.vsm-general-page{display:flex;flex-direction:column;gap:14px;max-width:720px}
 .vsm-general-page h2{margin:0;font-size:20px;color:var(--dsw-alias-label-primary,#e6e6e6)}
-.vsm-general-page p{margin:0 0 8px;color:var(--dsw-alias-label-tertiary,#9aa5b1);font-size:13px}
+.vsm-general-page p{margin:0;color:var(--dsw-alias-label-tertiary,#9aa5b1);font-size:13px}
 .vsm-general-row{display:flex;align-items:center;justify-content:space-between;gap:20px;padding:14px 0;border-bottom:1px solid var(--dsw-alias-border-l1,#333);color:var(--dsw-alias-label-primary,#eee);font-size:14px}
+.vsm-general-row:last-child{border-bottom:0}
 .vsm-general-row select{min-width:220px;padding:8px 10px;border:1px solid var(--dsw-alias-border-l2,#555);border-radius:6px;background:var(--dsw-alias-bg-layer-1,#2b2b2b);color:var(--dsw-alias-label-primary,#eee);font:inherit}
 .vsm-general-row small{color:var(--dsw-alias-label-tertiary,#9aa5b1)}
 
@@ -94,8 +112,7 @@
 .vsm-mcp-dialog-actions button{padding:8px 14px;border:1px solid var(--dsw-alias-border-l2,#555);border-radius:6px;background:none;color:var(--dsw-alias-label-primary,#eee);cursor:pointer;font-size:13px}
 .vsm-mcp-dialog-actions button:hover{background:var(--dsw-alias-interactive-bg-hover,#ffffff14)}
 
-/* 兼容性小节 */
-.vsm-compat-h3{margin:16px 0 2px;font-size:14px;font-weight:600;color:var(--dsw-alias-label-secondary,#c8c8c8)}
+/* 兼容性条目（面板标题改用 .vsm-panel-title） */
 .vsm-compat-item{display:flex;align-items:baseline;justify-content:space-between;gap:16px;padding:10px 0;border-bottom:1px solid var(--dsw-alias-border-l1,#333);font-size:13px;color:var(--dsw-alias-label-primary,#eee)}
 .vsm-compat-item.ok .vsm-compat-name::before{content:"● ";color:var(--dsw-alias-state-success-primary,#38bd75)}
 .vsm-compat-item.warn .vsm-compat-name::before{content:"● ";color:var(--dsw-alias-state-warn-primary,#e5b93f)}
@@ -139,6 +156,7 @@
 
 /* 会话性能（PerfSettings 子 Tab） */
 .vsm-perf-page{display:flex;flex-direction:column;gap:14px;max-width:920px}
+.vsm-perf-page>.vsm-panel-body>*:first-child{margin-top:0}
 .vsm-perf-page h2{margin:0;font-size:20px;color:var(--dsw-alias-label-primary,#e6e6e6)}
 .vsm-perf-page p{margin:0;color:var(--dsw-alias-label-tertiary,#9aa5b1);font-size:13px;line-height:1.5}
 .vsm-perf-cards{display:flex;gap:12px;flex-wrap:wrap}
@@ -148,8 +166,19 @@
 .vsm-perf-card b.big{color:var(--dsw-alias-state-error-primary,#e05252)}
 .vsm-perf-toolbar{display:flex;align-items:center;gap:8px;flex-wrap:wrap}
 .vsm-perf-selcount{font-size:12px;color:var(--dsw-alias-label-tertiary,#9aa5b1);margin:0 4px}
+/* 工作区列表分页器 */
+.vsm-perf-pager{display:flex;align-items:center;justify-content:space-between;gap:12px;flex-wrap:wrap;margin-top:4px}
+.vsm-perf-pager-text{font-size:12px;color:var(--dsw-alias-label-tertiary,#9aa5b1)}
+.vsm-perf-pager-actions{display:flex;gap:8px}
+.vsm-perf-ws-list{display:flex;flex-direction:column;gap:8px}
 .vsm-perf-ws{border:1px solid var(--dsw-alias-border-l2,#3a3a3a);border-radius:10px;overflow:hidden}
-.vsm-perf-ws-head{display:flex;justify-content:space-between;align-items:center;gap:12px;padding:10px 14px;background:var(--dsw-alias-bg-layer-1,#262626);border-bottom:1px solid var(--dsw-alias-border-l2,#3a3a3a)}
+.vsm-perf-ws-head{display:flex;align-items:center;gap:10px;padding:10px 14px;background:var(--dsw-alias-bg-layer-1,#262626);cursor:pointer;user-select:none}
+.vsm-perf-ws-head:hover{background:var(--dsw-alias-interactive-bg-hover,#ffffff14)}
+.vsm-perf-ws-head:focus-visible{outline:1px solid var(--dsw-alias-brand-primary,#6d55ff);outline-offset:-1px}
+.vsm-perf-ws.expanded .vsm-perf-ws-head{border-bottom:1px solid var(--dsw-alias-border-l2,#3a3a3a)}
+.vsm-perf-ws-caret{color:var(--dsw-alias-label-tertiary,#9aa5b1);font-size:12px;flex-shrink:0;transition:transform .15s;display:inline-block}
+.vsm-perf-ws-caret.open{transform:rotate(90deg)}
+.vsm-perf-ws .vsm-perf-ws-name{flex:1}
 .vsm-perf-ws-name{font-size:13px;font-weight:600;color:var(--dsw-alias-label-primary,#e6e6e6);font-family:var(--ds-font-family-code,ui-monospace,monospace);overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
 .vsm-perf-ws-meta{font-size:12px;color:var(--dsw-alias-label-tertiary,#9aa5b1);flex-shrink:0}
 .vsm-perf-rows{display:flex;flex-direction:column}
@@ -163,15 +192,9 @@
 .vsm-perf-size.big{color:var(--dsw-alias-state-error-primary,#e05252);font-weight:600}
 .vsm-perf-mtime{width:44px;flex-shrink:0;color:var(--dsw-alias-label-tertiary,#9aa5b1)}
 .vsm-perf-active{width:44px;flex-shrink:0;font-size:11px;color:var(--dsw-alias-state-warn-primary,#e5b93f);text-align:right}
-.vsm-perf-moved{border:1px solid var(--dsw-alias-border-l2,#3a3a3a);border-radius:10px;padding:12px 14px;background:var(--dsw-alias-bg-layer-2,transparent)}
-.vsm-perf-moved h3{margin:0 0 8px;font-size:14px;color:var(--dsw-alias-label-primary,#e6e6e6)}
-.vsm-perf-config{border:1px solid var(--dsw-alias-border-l2,#3a3a3a);border-radius:10px;padding:12px 14px;background:var(--dsw-alias-bg-layer-2,transparent)}
-.vsm-perf-config h3{margin:0 0 8px;font-size:14px;color:var(--dsw-alias-label-primary,#e6e6e6)}
 .vsm-perf-config-state{display:flex;align-items:center;gap:12px;margin:10px 0}
 .vsm-perf-note{font-size:12px;color:var(--dsw-alias-state-warn-primary,#e5b93f)}
 .vsm-perf-block{margin:8px 0 0;padding:10px 12px;border:1px solid var(--dsw-alias-border-l2,#3a3a3a);border-radius:8px;background:var(--dsw-alias-bg-base,#111);color:var(--dsw-alias-label-secondary,#c8c8c8);font-size:11px;line-height:1.5;font-family:var(--ds-font-family-code,ui-monospace,monospace);white-space:pre-wrap;overflow-x:auto;max-width:100%}
-.vsm-perf-guide{border:1px solid var(--dsw-alias-border-l2,#3a3a3a);border-radius:10px;padding:12px 14px;background:var(--dsw-alias-bg-layer-2,transparent)}
-.vsm-perf-guide h3{margin:0 0 8px;font-size:14px;color:var(--dsw-alias-label-primary,#e6e6e6)}
 .vsm-perf-modal{position:fixed;inset:0;display:flex;align-items:center;justify-content:center;background:var(--dsw-alias-bg-mask-1,#000000aa);z-index:1000;padding:20px}
 .vsm-perf-modal-card{width:min(560px,92vw);max-height:72vh;display:flex;flex-direction:column;gap:12px;padding:18px 20px;border:1px solid var(--dsw-alias-border-l2,#3a3a3a);border-radius:12px;background:var(--dsw-alias-bg-layer-2,#1f1f1f);color:var(--dsw-alias-label-primary,#e6e6e6)}
 .vsm-perf-modal-card h3{margin:0;font-size:16px}