dsh-vscode-mode 0.1.35 → 0.1.42

package/src/client/ui/PerfSettings.ts

@@ -10,6 +10,7 @@
  */
 import React from 'react'
 import { rpc } from '../rpc.js'
+import { foldLoad, foldSave, normalizeFoldKey } from '../state/workspaceFoldCache.js'
 import '../styles/mcp.css'
 
 /** 字节数人类可读。 */
@@ -23,6 +24,39 @@ function formatBytes(n) {
 /** 会话行 key：workspaceKey \u0000 sessionId。 */
 const keyOf = (ws, id) => ws + '\u0000' + id
 
+/** 工作区列表每页条数。 */
+const PAGE_SIZE = 7
+
+/**
+ * 计算分页（纯函数，可单测）。
+ * 作者 ddj 2026年09月02号
+ * @param total 总条数
+ * @param pageSize 每页条数
+ * @param page 当前页码（1 起）
+ * @returns 归一化后的分页信息（page 被夹到有效范围）
+ */
+export function paginate(total, pageSize, page) {
+  const size = Math.max(1, Math.floor(pageSize) || 1)
+  const pages = Math.max(1, Math.ceil(total / size))
+  const current = Math.min(Math.max(1, Math.floor(page) || 1), pages)
+  const start = (current - 1) * size
+  return { page: current, pages, pageSize: size, start, end: Math.min(start + size, total), total }
+}
+
+/**
+ * 取当前页切片（纯函数，可单测）。
+ * 作者 ddj 2026年09月02号
+ * @param items 全量列表
+ * @param page 当前页码（1 起）
+ * @param pageSize 每页条数
+ * @returns 当前页子数组
+ */
+export function pageSlice(items, page, pageSize) {
+  const list = items ?? []
+  const { start, end } = paginate(list.length, pageSize, page)
+  return list.slice(start, end)
+}
+
 /** 单行会话。 */
 function SessionRow({ row, checked, disabled, onToggle }) {
   const age = Math.max(0, (Date.now() - row.mtime) / (24 * 3600 * 1000))
@@ -36,6 +70,56 @@ function SessionRow({ row, checked, disabled, onToggle }) {
   )
 }
 
+/**
+ * 工作区列表分页器：顶部文案 + 上一页/下一页交互。
+ * 作者 ddj 2026年09月02号
+ * @param {object} info paginate() 的分页信息
+ * @param {Function} onPrev 上一页回调
+ * @param {Function} onNext 下一页回调
+ */
+function WorkspacePager({ info, onPrev, onNext }) {
+  const { page, pages, start, end, total } = info
+  return React.createElement('div', { className: 'vsm-perf-pager' },
+    React.createElement('span', { className: 'vsm-perf-pager-text' },
+      total ? `第 ${start + 1}–${end} 个 / 共 ${total} 个工作区（第 ${page}/${pages} 页）` : '暂无工作区',
+    ),
+    React.createElement('div', { className: 'vsm-perf-pager-actions' },
+      React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: onPrev, disabled: page <= 1 }, '‹ 上一页'),
+      React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: onNext, disabled: page >= pages }, '下一页 ›'),
+    ),
+  )
+}
+
+/**
+ * 工作区栏目（可展开/折叠），内含该工作区的会话行。
+ * 作者 ddj 2026年09月02号
+ * @param {object} ws 工作区汇总（workspaceKey / totalBytes）
+ * @param {object[]} rows 该工作区的会话行
+ * @param {boolean} expanded 是否展开
+ * @param {Function} onToggleFold 展开/折叠切换回调
+ * @param {object} selected 已选会话键集合
+ * @param {boolean} locked 会话勾选是否禁用（移出执行中）
+ * @param {Function} onToggleRow 单行勾选回调
+ */
+function WorkspaceBlock({ ws, rows, expanded, onToggleFold, selected, locked, onToggleRow }) {
+  const head = React.createElement('div', { className: 'vsm-perf-ws-head', role: 'button', tabIndex: 0, 'aria-expanded': expanded, onClick: onToggleFold, onKeyDown: (event) => {
+    if (event.key === 'Enter' || event.key === ' ') { event.preventDefault(); onToggleFold() }
+  } },
+    React.createElement('span', { className: 'vsm-perf-ws-caret ' + (expanded ? 'open' : '') }, '▸'),
+    React.createElement('span', { className: 'vsm-perf-ws-name', title: ws.workspaceKey }, ws.workspaceKey),
+    React.createElement('span', { className: 'vsm-perf-ws-meta' }, rows.length + ' 会话 · ' + formatBytes(ws.totalBytes)),
+  )
+  if (!expanded) return React.createElement('div', { className: 'vsm-perf-ws' }, head)
+  const body = rows.length ? rows.map((row) => React.createElement(SessionRow, {
+    key: keyOf(row.workspaceKey, row.sessionId),
+    row,
+    checked: !!selected[keyOf(row.workspaceKey, row.sessionId)],
+    disabled: row.active || locked,
+    onToggle: () => onToggleRow(keyOf(row.workspaceKey, row.sessionId)),
+  })) : React.createElement('div', { className: 'vsm-mcp-empty' }, '无会话')
+  return React.createElement('div', { className: 'vsm-perf-ws expanded' }, head, React.createElement('div', { className: 'vsm-perf-rows' }, body))
+}
+
 /**
  * 会话卫生 + 压缩调优设置子页。
  * @author ddj 2026年09月02号
@@ -48,6 +132,23 @@ export function PerfSettings() {
   const [confirm, setConfirm] = React.useState(null)
   const [moved, setMoved] = React.useState(null)
   const [config, setConfig] = React.useState(null)
+  const [expanded, setExpanded] = React.useState(() => foldLoad())
+  const [page, setPage] = React.useState(1)
+
+  React.useEffect(() => { foldSave(expanded) }, [expanded])
+
+  /** 数据变化后把越界页码夹回有效范围。 */
+  const workspaces = inv?.workspaces ?? []
+  const pageInfo = paginate(workspaces.length, PAGE_SIZE, page)
+  React.useEffect(() => {
+    if (page !== pageInfo.page) setPage(pageInfo.page)
+  }, [page, pageInfo.page])
+
+  /** 切换某工作区栏目的展开/折叠（默认全折叠）。 */
+  const toggleFold = (key) => setExpanded((old) => old.includes(key) ? old.filter((item) => item !== key) : old.concat(key))
+
+  /** 切换单会话勾选。 */
+  const toggleRow = (k) => setSelected((old) => { const next = { ...old }; if (next[k]) delete next[k]; else next[k] = true; return next })
 
   const load = React.useCallback(() => {
     setError('')
@@ -156,27 +257,25 @@ export function PerfSettings() {
     React.createElement('div', { className: 'vsm-perf-card' }, React.createElement('span', null, '压缩态总体积'), React.createElement('b', { className: totals.totalBytes >= 50 * 1024 * 1024 ? 'big' : '' }, formatBytes(totals.totalBytes))),
   ) : null
 
-  const workspaceBlocks = inv?.workspaces ? inv.workspaces.map((ws) => {
-    const rows = inv.sessions.filter((s) => s.workspaceKey === ws.workspaceKey)
-    return React.createElement('div', { key: ws.workspaceKey, className: 'vsm-perf-ws' },
-      React.createElement('div', { className: 'vsm-perf-ws-head' },
-        React.createElement('span', { className: 'vsm-perf-ws-name', title: ws.workspaceKey }, ws.workspaceKey),
-        React.createElement('span', { className: 'vsm-perf-ws-meta' }, rows.length + ' 会话 · ' + formatBytes(ws.totalBytes)),
-      ),
-      React.createElement('div', { className: 'vsm-perf-rows' },
-        rows.length ? rows.map((row) => React.createElement(SessionRow, {
-          key: keyOf(row.workspaceKey, row.sessionId),
-          row,
-          checked: !!selected[keyOf(row.workspaceKey, row.sessionId)],
-          disabled: row.active || busy === 'move',
-          onToggle: () => {
-            const k = keyOf(row.workspaceKey, row.sessionId)
-            setSelected((old) => { const next = { ...old }; if (next[k]) delete next[k]; else next[k] = true; return next })
-          },
-        })) : React.createElement('div', { className: 'vsm-mcp-empty' }, '无会话'),
-      ),
-    )
+  const visible = pageSlice(workspaces, pageInfo.page, PAGE_SIZE)
+  const workspacePager = workspaces.length > PAGE_SIZE ? React.createElement(WorkspacePager, {
+    info: pageInfo,
+    onPrev: () => setPage((old) => Math.max(1, old - 1)),
+    onNext: () => setPage((old) => Math.min(pageInfo.pages, old + 1)),
   }) : null
+  const workspaceBlocks = workspaces.length ? React.createElement('div', { className: 'vsm-perf-ws-list' }, visible.map((ws) => {
+    const key = normalizeFoldKey(ws.workspaceKey)
+    return React.createElement(WorkspaceBlock, {
+      key: ws.workspaceKey,
+      ws,
+      rows: inv.sessions.filter((s) => s.workspaceKey === ws.workspaceKey),
+      expanded: expanded.includes(key),
+      onToggleFold: () => toggleFold(key),
+      selected,
+      locked: busy === 'move',
+      onToggleRow: toggleRow,
+    })
+  })) : null
 
   const selCount = Object.keys(selected).length
   const confirmBody = confirm ? React.createElement('div', { className: 'vsm-perf-modal' },
@@ -192,18 +291,21 @@ export function PerfSettings() {
     ),
   ) : null
 
-  const movedBody = moved?.moved?.length ? React.createElement('div', { className: 'vsm-perf-moved' },
-    React.createElement('h3', null, '已移出 ' + moved.moved.length + ' 个会话（释放 ' + formatBytes(moved.reclaimedBytes) + '）'),
+  const movedBody = moved?.moved?.length ? React.createElement('section', { className: 'vsm-panel' },
+    React.createElement('h3', { className: 'vsm-panel-title' }, '已移出 ' + moved.moved.length + ' 个会话（释放 ' + formatBytes(moved.reclaimedBytes) + '）'),
+    React.createElement('div', { className: 'vsm-panel-body' },
     React.createElement('div', { className: 'vsm-perf-rows' }, moved.moved.map((item) => React.createElement('div', { key: item.workspaceKey + item.sessionId, className: 'vsm-perf-row' },
       React.createElement('span', { className: 'vsm-perf-cell vsm-perf-id' }, item.sessionId),
       React.createElement('span', { className: 'vsm-perf-cell vsm-perf-size' }, formatBytes(item.bytes)),
       React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: () => doRestore(item), disabled: busy === 'restore' }, '恢复'),
     ))),
     moved.failures?.length ? React.createElement('div', { className: 'vsm-mcp-error vsm-mcp-banner' }, '失败：' + moved.failures.join('；')) : null,
+    ),
   ) : null
 
-  const configBody = config ? React.createElement('div', { className: 'vsm-perf-config' },
-    React.createElement('h3', null, 'DSH 内置压缩调优'),
+  const configBody = config ? React.createElement('section', { className: 'vsm-panel' },
+    React.createElement('h3', { className: 'vsm-panel-title' }, 'DSH 内置压缩调优'),
+    React.createElement('div', { className: 'vsm-panel-body' },
     React.createElement('p', null, '调低 compaction-basic / tool-result-pruner 触发阈值，让长循环会话更早压缩，降低模型可见上下文压力（减少 token 与防 context overflow）。'),
     React.createElement('p', { className: 'vsm-perf-note' }, '注意：压缩只追加 compaction 事件，不重写已持久化会话日志（append-only），因此不会缩小已存在的会话文件——存量瘦身请用上方「移出到归档」。packChunks 已默认开启，无需配置。'),
     React.createElement('div', { className: 'vsm-perf-config-state' },
@@ -211,13 +313,16 @@ export function PerfSettings() {
       config.applied ? React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: undoConfig, disabled: busy === 'undo' }, '撤销') : React.createElement('button', { className: 'vsm-primary vsm-small', onClick: applyConfig, disabled: busy === 'apply' }, '应用建议配置（需重启）'),
     ),
     React.createElement('pre', { className: 'vsm-perf-block' }, config.block),
+    ),
   ) : null
 
-  const guideBody = React.createElement('div', { className: 'vsm-perf-guide' },
-    React.createElement('h3', null, '侧车摘要（agent/脚本取关键字段，不整份读 sidecar）'),
+  const guideBody = React.createElement('section', { className: 'vsm-panel' },
+    React.createElement('h3', { className: 'vsm-panel-title' }, '侧车摘要（agent/脚本取关键字段，不整份读 sidecar）'),
+    React.createElement('div', { className: 'vsm-panel-body' },
     React.createElement('p', null, '工作区根目录的 .dsh-edit-review.json（可能数 MB）只应通过摘要接口读取，禁止 agent 整份 read/write 进对话：'),
     React.createElement('pre', { className: 'vsm-perf-block' },
       "curl -s -X POST http://127.0.0.1:3080/edrv/rpc -H 'content-type: application/json' -d '{\"method\":\"edrv.perf.sidecarSummary\",\"args\":{}}'\n# 差异记录列表（含每文件 pending 摘要）：edrv.list\n# 历史归档：edrv.archiveList / edrv.archiveRead"),
+    ),
   )
 
   return React.createElement('section', { className: 'vsm-perf-page' },
@@ -225,15 +330,21 @@ export function PerfSettings() {
     React.createElement('p', null, 'DSH 启动会回放 ~/.dsh/sessions 全部会话（V8 展开约 10×），体积越大内存越吃紧。定期把巨型/旧会话移出到归档可显著降低启动内存。'),
     error ? React.createElement('div', { className: 'vsm-mcp-error vsm-mcp-banner' }, error) : null,
     summaryCards,
-    React.createElement('div', { className: 'vsm-perf-toolbar' },
-      React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: selectBig }, '圈选 ≥1MB 非活跃'),
-      React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: clearSel, disabled: !selCount }, '清空选择'),
-      React.createElement('span', { className: 'vsm-perf-selcount' }, '已选 ' + selCount + ' 个'),
-      React.createElement('button', { className: 'vsm-primary vsm-small', onClick: planMove, disabled: !selCount || busy === 'plan' }, busy === 'plan' ? '规划中…' : '移出所选'),
-      React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: doPurge, disabled: busy === 'purge' }, '清除归档(>30天)'),
-      React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: load, disabled: busy === 'load' }, '⟳ 刷新'),
+    React.createElement('section', { className: 'vsm-panel' },
+      React.createElement('h3', { className: 'vsm-panel-title' }, '会话盘点'),
+      React.createElement('div', { className: 'vsm-panel-body' },
+        React.createElement('div', { className: 'vsm-perf-toolbar' },
+          React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: selectBig }, '圈选 ≥1MB 非活跃'),
+          React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: clearSel, disabled: !selCount }, '清空选择'),
+          React.createElement('span', { className: 'vsm-perf-selcount' }, '已选 ' + selCount + ' 个'),
+          React.createElement('button', { className: 'vsm-primary vsm-small', onClick: planMove, disabled: !selCount || busy === 'plan' }, busy === 'plan' ? '规划中…' : '移出所选'),
+          React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: doPurge, disabled: busy === 'purge' }, '清除归档(>30天)'),
+          React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: load, disabled: busy === 'load' }, '⟳ 刷新'),
+        ),
+        workspacePager,
+        workspaceBlocks,
+      ),
     ),
-    workspaceBlocks,
     movedBody,
     configBody,
     guideBody,

package/src/lsp/client.ts

@@ -5,7 +5,7 @@
  * 作者 ddj 2026-08-27
  */
 import { createFrameParser, encodeMessage, requestMessage, notifyMessage } from './jsonrpc.js'
-import type { LspServerCapabilities } from '../shared/lsp.js'
+import { LSP_SEMANTIC_TOKEN_TYPES, LSP_SEMANTIC_TOKEN_MODIFIERS, type LspServerCapabilities } from '../shared/lsp.js'
 
 export interface LspClientEvents {
   onReady?: (capabilities: LspServerCapabilities) => void
@@ -54,7 +54,16 @@ export function createLspClient(
   let nextId = 1
   let alive = transport.alive
   const pending = new Map<number, { resolve: (v: unknown) => void; reject: (e: Error) => void; timer: ReturnType<typeof setTimeout> }>()
-  let serverCapabilities: LspServerCapabilities = { definition: false, references: false, documentSymbol: false, workspaceSymbol: false, hover: false }
+  let serverCapabilities: LspServerCapabilities = {
+    definition: false,
+    references: false,
+    documentSymbol: false,
+    workspaceSymbol: false,
+    hover: false,
+    semanticTokens: false,
+    semanticTokenTypes: [],
+    semanticTokenModifiers: [],
+  }
 
   const log = (line: string): void => events.onLog?.(line)
   const parser = createFrameParser()
@@ -153,6 +162,9 @@ export function createLspClient(
           documentSymbolProvider?: unknown
           workspaceSymbolProvider?: unknown
           hoverProvider?: unknown
+          semanticTokensProvider?: {
+            legend?: { tokenTypes?: unknown; tokenModifiers?: unknown }
+          }
         }
       }>('initialize', {
         processId: process.pid,
@@ -170,16 +182,31 @@ export function createLspClient(
             references: { dynamicRegistration: false },
             documentSymbol: { dynamicRegistration: false },
             hover: { dynamicRegistration: false },
+            semanticTokens: {
+              dynamicRegistration: false,
+              requests: { range: false, full: { delta: false } },
+              tokenTypes: [...LSP_SEMANTIC_TOKEN_TYPES],
+              tokenModifiers: [...LSP_SEMANTIC_TOKEN_MODIFIERS],
+              formats: ['relative'],
+            },
           },
         },
       })
       const caps = init?.capabilities ?? {}
+      const legend = caps.semanticTokensProvider?.legend
       serverCapabilities = {
         definition: Boolean(caps.definitionProvider),
         references: Boolean(caps.referencesProvider),
         documentSymbol: Boolean(caps.documentSymbolProvider),
         workspaceSymbol: Boolean(caps.workspaceSymbolProvider),
         hover: Boolean(caps.hoverProvider),
+        semanticTokens: Boolean(caps.semanticTokensProvider),
+        semanticTokenTypes: Array.isArray(legend?.tokenTypes)
+          ? legend.tokenTypes.filter((item): item is string => typeof item === 'string')
+          : [...LSP_SEMANTIC_TOKEN_TYPES],
+        semanticTokenModifiers: Array.isArray(legend?.tokenModifiers)
+          ? legend.tokenModifiers.filter((item): item is string => typeof item === 'string')
+          : [...LSP_SEMANTIC_TOKEN_MODIFIERS],
       }
       client.notify('initialized', {})
       events.onReady?.(serverCapabilities)

package/src/lsp/manager.ts

@@ -25,6 +25,10 @@ export interface LspManager {
   release(root: string, languageId: string): void
   /** 释放工作区下全部语言（session/disposed 用）。 */
   releaseRoot(root: string): void
+  /** 重置单个工作区语言 server（重新检测 provider 用）。 */
+  reset(root: string, languageId: string): void
+  /** 重置全部工作区的指定语言 server。 */
+  resetLanguage(languageId: string): void
   /** 状态快照。 */
   statusAll(): LspServerStatus[]
   /** 查询已注册的工作区+语言服务器，不增加引用计数。 */
@@ -110,6 +114,17 @@ export function createLspManager(logger?: (line: string) => void): LspManager {
       }
     },
 
+    reset(root: string, languageId: string): void {
+      const entry = entries.get(keyOf(root, languageId))
+      if (entry) dropEntry(entry)
+    },
+
+    resetLanguage(languageId: string): void {
+      for (const entry of [...entries.values()]) {
+        if (entry.server.languageId === languageId) dropEntry(entry)
+      }
+    },
+
     statusAll(): LspServerStatus[] {
       return [...entries.values()].map((entry) => entry.server.status())
     },

package/src/lsp/providers.ts

@@ -5,12 +5,12 @@
  * 供 manager 启动服务器。
  * 作者 ddj 2026-08-27
  */
-import { existsSync, readdirSync, type Dirent } from 'node:fs'
+import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, rmSync, type Dirent } from 'node:fs'
 import { homedir } from 'node:os'
-import { join, sep } from 'node:path'
+import { dirname, join, sep } from 'node:path'
 import { isAbsolute } from 'node:path'
 import { extensionsRoot } from './extmgr.js'
-import { dshHome } from '../paths.js'
+import { dshHome, lspSpecCacheFile } from '../paths.js'
 
 /** provider 来源标记（与 shared/lsp.ts 的 status.source 一致）。 */
 export type LspProviderKind = 'extension' | 'discover' | 'manual' | 'none'
@@ -22,6 +22,8 @@ export interface LspProviderSpec {
   cwd?: string
   ready: boolean
   reason?: string
+  version?: string
+  providerName?: string
 }
 
 /** 语言 → 扩展名（用于判断哪些文件触发该语言服务器）。 */
@@ -88,7 +90,7 @@ export function registerExtensionProvider(languageId: string, argv: string[], cw
 export function extensionProviderFor(languageId: string): LspProviderSpec | null {
   const p = extProviders.get(languageId)
   if (!p || !p.argv.length) return null
-  return { languageId, kind: 'extension', argv: p.argv, cwd: p.cwd, ready: true }
+  return { languageId, kind: 'extension', argv: p.argv, cwd: p.cwd, ready: true, version: p.version, providerName: p.version ? 'EmmyLua' : '语言服务器扩展' }
 }
 
 /** 清空全部扩展源注册（插件卸载/扩展目录重建时）。 */
@@ -123,6 +125,25 @@ export function findDotnet(): string | null {
   return null
 }
 
+/** EmmyLua 自动发现候选（tangzx.emmylua-* / server/emmylua_ls）。 */
+export function candidateEmmyLua(home = dshHome()): { path: string; version?: string } | null {
+  const candidates: { path: string; version?: string }[] = []
+  for (const dir of vscodeExtensionsDirs(home)) {
+    for (const extDir of listMatchingDirs(dir, 'tangzx.emmylua-')) {
+      const server = join(extDir, 'server', 'emmylua_ls' + exeSuffix())
+      if (!existsSync(server)) continue
+      let version: string | undefined
+      try {
+        const manifest = JSON.parse(readFileSync(join(extDir, 'package.json'), 'utf8')) as { version?: unknown }
+        if (typeof manifest.version === 'string') version = manifest.version
+      } catch (error) { /* 清单读取失败不影响入口使用 */ }
+      candidates.push({ path: server, version })
+    }
+  }
+  candidates.sort((a, b) => (b.version ?? '').localeCompare(a.version ?? '', undefined, { numeric: true }) || a.path.localeCompare(b.path))
+  return candidates[0] ?? null
+}
+
 /** LuaLS 自动发现候选（VSCode 扩展目录 + extmgr 目录下 sumneko.lua-* 的 server/bin 可执行）。 */
 export function candidateLuaServers(home = dshHome()): string[] {
   const plat = platformServerDir()
@@ -186,13 +207,17 @@ export function resolveLuaProvider(manual?: { command?: string; path?: string },
   const base = { languageId: 'lua' }
   const manualResolved = manualSpec(manual)
   if (manualResolved.ready) return { ...base, kind: 'manual', argv: manualResolved.argv, cwd: manualResolved.cwd, ready: true }
-  const ext = extensionProviderFor('lua')
-  if (ext) return ext
-  const candidates = candidateLuaServers(home)
-  if (candidates.length) return { ...base, kind: 'discover', argv: [candidates[0]], cwd: undefined, ready: true }
-  const inPath = findInPath('lua-language-server' + exeSuffix())
-  if (inPath) return { ...base, kind: 'discover', argv: [inPath], ready: true }
-  return { ...base, kind: 'none', argv: [], ready: false, reason: manualResolved.reason ?? '未发现 lua-language-server（可安装 LuaLS 或手动指定路径）' }
+  return resolveCached('lua', manual, home, (h) => {
+    const ext = extensionProviderFor('lua')
+    if (ext) return ext
+    const emmy = candidateEmmyLua(h)
+    if (emmy) return { ...base, kind: 'extension', argv: [emmy.path], ready: true, version: emmy.version, providerName: 'EmmyLua' }
+    const candidates = candidateLuaServers(h)
+    if (candidates.length) return { ...base, kind: 'discover', argv: [candidates[0]], cwd: undefined, ready: true }
+    const inPath = findInPath('lua-language-server' + exeSuffix())
+    if (inPath) return { ...base, kind: 'discover', argv: [inPath], ready: true }
+    return { ...base, kind: 'none', argv: [], ready: false, reason: manualResolved.reason ?? '未发现 lua-language-server（可安装 LuaLS 或手动指定路径）' }
+  })
 }
 
 /**
@@ -206,19 +231,21 @@ export function resolveCSharpProvider(manual?: { command?: string; path?: string
   const base = { languageId: 'csharp' }
   const manualResolved = manualSpec(manual)
   if (manualResolved.ready) return { ...base, kind: 'manual', argv: manualResolved.argv, cwd: manualResolved.cwd, ready: true }
-  const ext = extensionProviderFor('csharp')
-  if (ext) return ext
-  const discovered = candidateCSharpServers(home)
-  if (discovered.roslynDll && discovered.dotnet) {
-    return { ...base, kind: 'discover', argv: [discovered.dotnet, discovered.roslynDll, '--stdio'], ready: true }
-  }
-  if (discovered.omnisharpExe) {
-    return { ...base, kind: 'discover', argv: [discovered.omnisharpExe, '--stdio'], ready: true }
-  }
-  const reasons: string[] = []
-  if (!discovered.dotnet) reasons.push('未找到 dotnet')
-  if (!discovered.roslynDll && !discovered.omnisharpExe) reasons.push('未发现 ms-dotnettools.csharp 扩展')
-  return { ...base, kind: 'none', argv: [], ready: false, reason: reasons.join('；') + '（可手动指定 Roslyn/OmniSharp 入口）' }
+  return resolveCached('csharp', manual, home, (h) => {
+    const ext = extensionProviderFor('csharp')
+    if (ext) return ext
+    const discovered = candidateCSharpServers(h)
+    if (discovered.roslynDll && discovered.dotnet) {
+      return { ...base, kind: 'discover', argv: [discovered.dotnet, discovered.roslynDll, '--stdio'], ready: true }
+    }
+    if (discovered.omnisharpExe) {
+      return { ...base, kind: 'discover', argv: [discovered.omnisharpExe, '--stdio'], ready: true }
+    }
+    const reasons: string[] = []
+    if (!discovered.dotnet) reasons.push('未找到 dotnet')
+    if (!discovered.roslynDll && !discovered.omnisharpExe) reasons.push('未发现 ms-dotnettools.csharp 扩展')
+    return { ...base, kind: 'none', argv: [], ready: false, reason: reasons.join('；') + '（可手动指定 Roslyn/OmniSharp 入口）' }
+  })
 }
 
 /** 语言 → provider 解析器（可扩展；Phase 2 由 extmgr 注册扩展源 provider）。 */
@@ -233,3 +260,155 @@ export const PROVIDER_RESOLVERS: Record<string, ProviderResolver> = {
 export function looksAbsolute(value: string): boolean {
   return isAbsolute(value)
 }
+
+// --region provider 发现结果缓存（进程级 + 磁盘持久化）
+/**
+ * 发现结果缓存：只缓存"自动发现/扩展源"结论，不缓存 manual（用户改配置要立即生效）。
+ * 进程内 Map 命中优先；未命中读磁盘缓存（跨会话/跨重启共享）；仍无才真扫描。
+ * 缓存条目按"配置签名 + 扩展目录指纹"校验，任一变化即失效重扫。
+ * 作者 ddj 2026年08月28号
+ */
+
+/** 缓存条目：spec + 生成时的环境指纹。 */
+interface SpecCacheEntry {
+  spec: LspProviderSpec
+  fingerprint: string
+  at: number
+}
+
+/** 进程级缓存（home|languageId → 条目），同一 DSH home 的不同会话共享。 */
+const specCache = new Map<string, SpecCacheEntry>()
+/** 磁盘缓存是否已载入本进程（home → loaded），不同 profile 不串缓存。 */
+const diskLoaded = new Set<string>()
+/** 自动发现成功结果的复用时长；过期后才检查目录指纹。 */
+const SPEC_CACHE_TTL_MS = 30 * 60 * 1000
+/** 未发现结果的短缓存时长，避免缺失服务器时反复扫描 PATH。 */
+const SPEC_NEGATIVE_CACHE_MS = 60 * 1000
+
+/** 生成带 home 的缓存键，避免不同 profile 的 provider 结果串用。 */
+function cacheEntryKey(home: string, languageId: string): string {
+  return home + '|' + languageId
+}
+
+/**
+ * 构造缓存 key：语言 + 手动配置（manual 结果不缓存，故只参与"是否走缓存"判定）。
+ * @author ddj 2026年08月28号
+ * @param languageId 语言 id
+ * @param manual 手动配置
+ * @returns 缓存 key（manual 有效时返回空串表示跳过缓存）
+ */
+function cacheKeyOf(languageId: string, manual?: { command?: string; path?: string }): string {
+  const pathValue = manual?.path?.trim() ?? ''
+  const commandValue = manual?.command?.trim() ?? ''
+  if (pathValue || commandValue) return '' // 手动配置：不缓存，立即生效
+  return languageId
+}
+
+/**
+ * 环境指纹：扩展目录清单 + 平台。目录增删/换平台即失效（防缓存陈旧指向已删扩展）。
+ * @author ddj 2026年08月28号
+ * @param home DSH home
+ * @returns 指纹串
+ */
+function fingerprintOf(home: string): string {
+  const dirs = vscodeExtensionsDirs(home)
+  const marks = dirs.map((dir) => {
+    try {
+      return readdirSync(dir).sort().join(',')
+    } catch (error) {
+      return '?'
+    }
+  })
+  return process.platform + '|' + marks.join('|')
+}
+
+/**
+ * 读取磁盘缓存（幂等：每进程只载一次；schema 文件名已隔离版本）。
+ * @author ddj 2026年08月28号
+ * @param home DSH home
+ */
+function loadDiskCache(home: string): void {
+  if (diskLoaded.has(home)) return
+  diskLoaded.add(home)
+  const file = lspSpecCacheFile(home)
+  try {
+    const raw = JSON.parse(readFileSync(file, 'utf8')) as Record<string, SpecCacheEntry>
+    for (const [languageId, entry] of Object.entries(raw)) {
+      if (entry && typeof entry === 'object' && entry.spec && typeof entry.fingerprint === 'string') {
+        specCache.set(cacheEntryKey(home, languageId), entry)
+      }
+    }
+  } catch (error) { /* 首次运行/损坏：静默降级为真扫描 */ }
+}
+
+/**
+ * 写回磁盘缓存（best-effort；写失败不影响本次解析结果）。
+ * @author ddj 2026年08月28号
+ * @param home DSH home
+ */
+function saveDiskCache(home: string): void {
+  const file = lspSpecCacheFile(home)
+  try {
+    mkdirSync(dirname(file), { recursive: true })
+    const out: Record<string, SpecCacheEntry> = {}
+    const prefix = home + '|'
+    for (const [key, entry] of specCache) if (key.startsWith(prefix)) out[key.slice(prefix.length)] = entry
+    writeFileSync(file, JSON.stringify(out), 'utf8')
+  } catch (error) { /* 写入失败静默 */ }
+}
+
+/**
+ * 带缓存执行 provider 解析（自动发现路径专用）。
+ * @author ddj 2026年08月28号
+ * @param languageId 语言 id
+ * @param manual 手动配置
+ * @param home DSH home
+ * @param resolve 真解析函数（未命中时调用）
+ * @returns provider 规格
+ */
+function resolveCached(
+  languageId: string,
+  manual: { command?: string; path?: string } | undefined,
+  home: string,
+  resolve: (h: string) => LspProviderSpec,
+): LspProviderSpec {
+  const key = cacheKeyOf(languageId, manual)
+  if (!key) return resolve(home) // 手动配置：不走缓存
+  loadDiskCache(home)
+  const fullKey = cacheEntryKey(home, key)
+  const hit = specCache.get(fullKey)
+  if (hit && isCacheFresh(hit)) return hit.spec
+  const fingerprint = fingerprintOf(home)
+  if (hit && hit.fingerprint === fingerprint) {
+    hit.at = Date.now()
+    return hit.spec
+  }
+  const spec = resolve(home)
+  specCache.set(fullKey, { spec, fingerprint, at: Date.now() })
+  saveDiskCache(home)
+  return spec
+}
+
+/** 判断缓存条目是否仍可直接复用，不触发扩展目录扫描。 */
+function isCacheFresh(entry: SpecCacheEntry): boolean {
+  const age = Date.now() - entry.at
+  const ttl = entry.spec.kind === 'none' ? SPEC_NEGATIVE_CACHE_MS : SPEC_CACHE_TTL_MS
+  if (age < 0 || age >= ttl) return false
+  const executable = entry.spec.argv[0]
+  return !entry.spec.ready || !executable || existsSync(executable)
+}
+
+/**
+ * 清空 provider 发现缓存（扩展安装/卸载、配置变更后调用；进程级 + 删磁盘文件）。
+ * @author ddj 2026年08月28号
+ * @param home DSH home（缺省真实）
+ */
+export function clearProviderCache(home = dshHome()): void {
+  const prefix = home + '|'
+  for (const key of specCache.keys()) if (key.startsWith(prefix)) specCache.delete(key)
+  diskLoaded.delete(home)
+  try {
+    rmSync(lspSpecCacheFile(home), { force: true })
+  } catch (error) { /* 删除失败静默 */ }
+}
+// --endregion