dsh-vscode-mode 0.1.50 → 0.1.52

package/package.json

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

package/src/client/ui/LspSettings.ts

@@ -2,17 +2,38 @@
 /**
  * dsh-vscode-mode client — 「语言服务器」设置子 Tab。
  * 四视图：服务器（状态 + 每语言启用/命令/路径）｜已安装（卸载/更新）｜市场（Open VSX 搜索/安装 + 本地 vsix）｜更新。
- * 状态经 edrv.lsp.status，配置经 edrv.lsp.configGet/Update，扩展经 edrv.lsp.ext.*。
- * 作者 ddj 2026-08-27
+ * 状态经 edrv.lsp.detect（检测结果驱动卡片动态显示），配置经 edrv.lsp.configGet/Update，扩展经 edrv.lsp.ext.*。
+ * 作者 ddj 2026-08-27 / 2026-09-03
  */
 import React from 'react'
 import { rpc } from '../rpc.js'
 import '../styles/mcp.css'
 
-const LANGUAGES = [
-  { id: 'lua', label: 'Lua（EmmyLua / LuaLS）', hint: '优先使用已安装 EmmyLua；未安装时回退 LuaLS 或 PATH 中的 lua-language-server' },
-  { id: 'csharp', label: 'C#（Roslyn / DotRush / OmniSharp）', hint: '优先自动发现 ms-dotnettools.csharp / DotRush 扩展（DotRush 需 .NET 10 运行时）；也可手动指定' },
-]
+/** 支持语言的展示元数据（卡片显示由检测结果驱动；未知 id 走 langMeta 兜底）。 */
+const LANG_META = {
+  lua: { label: 'Lua（EmmyLua / LuaLS）', hint: '优先使用已安装 EmmyLua；未安装时回退 LuaLS 或 PATH 中的 lua-language-server' },
+  csharp: { label: 'C#（Roslyn / DotRush / OmniSharp）', hint: '优先自动发现 ms-dotnettools.csharp / DotRush 扩展（DotRush 需 .NET 10 运行时）；也可手动指定' },
+}
+
+/** 语言展示元数据（含未知 id 兜底）。 */
+function langMeta(id) {
+  return LANG_META[id] || { label: id + '（语言服务器）', hint: '' }
+}
+
+/** 该语言是否已存配置（禁用开关或手动命令/路径）。 */
+function hasStoredConfig(cfg) {
+  if (!cfg || typeof cfg !== 'object') return false
+  if (cfg.enabled === false) return true
+  return Boolean((cfg.command && cfg.command.trim()) || (cfg.path && cfg.path.trim()))
+}
+
+/** 该语言是否显示卡片：检测到可用 LSP、已存配置、或存在待安装的缺失环境。 */
+function langVisible(status, config) {
+  if (!status) return false
+  if (status.source && status.source !== 'none') return true
+  if (hasStoredConfig(config[status.languageId])) return true
+  return Array.isArray(status.missingEnv) && status.missingEnv.length > 0
+}
 
 const PHASE_LABEL = {
   idle: '未启动', starting: '启动中', ready: '就绪', indexing: '索引中', unavailable: '不可用', stopped: '已停止',
@@ -54,6 +75,11 @@ function LangCard({ lang, config, status, busy, envStates, onInstallEnv, onToggl
       status?.version ? ' · v' + status.version : '',
       (phase === 'ready' && status?.root) ? ' · ' + String(status.root).split(/[\\/]/).pop() : ''),
     status?.reason ? React.createElement('div', { className: 'vsm-mcp-error' }, status.reason) : null,
+    Array.isArray(status?.candidates) && status.candidates.length > 1
+      ? React.createElement('div', { className: 'vsm-lsp-hint' },
+        '候选（' + status.candidates.length + '）：' + status.candidates.map((c) =>
+          c.name + (c.version ? ' v' + c.version : '') + (c.chosen ? '（当前）' : '')).join(' · '))
+      : null,
     Array.isArray(status?.missingEnv) && status.missingEnv.length
       ? React.createElement('div', { className: 'vsm-lsp-hint' },
         '缺少运行环境（一键安装后自动生效）：',
@@ -125,10 +151,10 @@ export function LspSettings() {
   const [envLang, setEnvLang] = React.useState('')
 
   const refreshServers = React.useCallback(() => {
-    Promise.all([rpc('edrv.lsp.configGet', {}), rpc('edrv.lsp.status', {})])
-      .then(([cfg, st]) => {
+    Promise.all([rpc('edrv.lsp.configGet', {}), rpc('edrv.lsp.detect', {})])
+      .then(([cfg, det]) => {
         if (cfg?.ok) setConfig(cfg.config ?? {})
-        if (st?.ok) setServers(st.servers ?? [])
+        if (det?.ok) setServers(det.servers ?? [])
         setError('')
       })
       .catch((e) => setError(String(e)))
@@ -282,6 +308,7 @@ export function LspSettings() {
       .then((res) => {
         if (!res?.ok) { setError(res?.error ?? '安装失败'); return }
         void refreshExt()
+        void refreshServers() // 新装 LSP 使对应语言卡片出现
       })
       .catch((e) => setError(String(e)))
       .finally(() => setBusy(''))
@@ -296,6 +323,7 @@ export function LspSettings() {
         if (!res?.ok) { setError(res?.error ?? '安装失败'); return }
         setVsixPath('')
         void refreshExt()
+        void refreshServers() // 新装 LSP 使对应语言卡片出现
       })
       .catch((e) => setError(String(e)))
       .finally(() => setBusy(''))
@@ -309,6 +337,7 @@ export function LspSettings() {
       .then((res) => {
         if (!res?.ok) setError(res?.error ?? '卸载失败')
         void refreshExt()
+        void refreshServers() // 卸载后对应语言卡片按最新检测隐匿
       })
       .catch((e) => setError(String(e)))
       .finally(() => setBusy(''))
@@ -321,6 +350,7 @@ export function LspSettings() {
       .then((res) => {
         if (!res?.ok) setError(res?.error ?? '更新失败')
         void refreshExt()
+        void refreshServers() // 更新后选用版本随之变化
       })
       .catch((e) => setError(String(e)))
       .finally(() => setBusy(''))
@@ -344,14 +374,24 @@ export function LspSettings() {
 
   let body = null
   if (tab === 'servers') {
+    // 动态显示：检测结果（detect 全量）驱动卡片可见性；未检出语言灰字列出
+    const detected = Array.isArray(servers) ? servers : []
+    const visible = detected.filter((s) => langVisible(s, config))
+    const hidden = detected.filter((s) => !visible.includes(s))
     body = panel('语言服务器', React.createElement(React.Fragment, null,
-      LANGUAGES.map((lang) => React.createElement(LangCard, {
-        key: lang.id, lang,
-        config: config[lang.id] ?? {},
-        status: servers.find((s) => s.languageId === lang.id),
-        busy, envStates, onInstallEnv: installEnv, onToggle: toggleLang, onSave: saveLang, onRedetect: redetectLang,
-      })),
-      React.createElement('div', { className: 'vsm-lsp-hint' }, '提示：打开 Lua/C# 文件即自动（惰性）启动对应语言服务器；未配置时编辑器功能不受影响，大纲回退内置解析。')))
+      visible.length ? visible.map((status) => {
+        const meta = langMeta(status.languageId)
+        return React.createElement(LangCard, {
+          key: status.languageId, lang: { id: status.languageId, label: meta.label, hint: meta.hint },
+          config: config[status.languageId] ?? {},
+          status,
+          busy, envStates, onInstallEnv: installEnv, onToggle: toggleLang, onSave: saveLang, onRedetect: redetectLang,
+        })
+      }) : React.createElement('div', { className: 'vsm-mcp-empty' },
+        '未检测到已安装的语言服务器；可切换到「市场」搜索安装（如 sumneko.lua），或安装本地 .vsix 后刷新。'),
+      hidden.length ? React.createElement('div', { className: 'vsm-lsp-hint' },
+        '未检测到：' + hidden.map((s) => langMeta(s.languageId).label).join('、') + ' —— 可在「市场」安装后刷新。') : null,
+      React.createElement('div', { className: 'vsm-lsp-hint' }, '提示：打开对应语言的文件即自动（惰性）启动语言服务器；未配置时编辑器功能不受影响，大纲回退内置解析。')))
   } else if (tab === 'installed') {
     body = panel('已安装扩展', React.createElement(React.Fragment, null,
       React.createElement('div', { className: 'vsm-lsp-hint' }, '已安装的语言服务器扩展（存于 ~/.dsh/dsh-vscode-mode/extensions/）。语言服务器被自动发现为「扩展」源。'),

package/src/index.ts

@@ -20,7 +20,6 @@ import { sweepTreeCache } from './paths.js'
 import { PLUGIN_NAME, buildReport } from './compat.js'
 import { createLspManager } from './lsp/manager.js'
 import { createLspRpc } from './lsp/rpc.js'
-import { installLspSettingsSection } from './lsp/settings.js'
 import { disposeAllServers } from './lsp/transport.js'
 import { installRulesSection } from './rules.js'
 import type { RpcHandlerMap } from './shared/rpc.js'
@@ -45,7 +44,7 @@ export function apply(ctx: Ctx, config?: unknown): void {
   /** 兼容性警告收集（route 护栏等写入，启动日志一并输出）。 */
   const warnings: string[] = []
   setupOpenSettings(ctx, config, () => {})
-  void installLspSettingsSection(ctx, {})
+  /** LSP 配置为配置值模式：插件组合配置 + 会话内运行时覆盖（原 settings section 命名空间不合法，见 lsp/config.ts）。 */
   /** 规则注入 section（~/.dsh/rules 与 <工作区>/.dsh/rules；旧版 DSH 无 systemPrompt 时静默降级）。 */
   const rulesInstalled = installRulesSection(ctx)
   if (!rulesInstalled) ctx.logger?.warn?.('[' + name + '] 未检测到 systemPrompt 服务，规则仅可管理不注入')

package/src/lsp/config.ts

@@ -1,9 +1,11 @@
 /**
  * dsh-vscode-mode host — LSP 配置读取与 provider 解析装配。
- * 配置来源优先级：settings 持久化（ns dsh-vscode-mode.languageServers）> 插件组合配置 > 默认。
- * 作者 ddj 2026-08-27
+ * 配置来源优先级：运行时覆盖（设置页保存，重启失效）> 插件组合配置 > 默认。
+ * 原 settings section（ns dsh-vscode-mode.languageServers）命名空间不合法
+ * （DSH settings 仅允许 /^[a-z][a-z0-9-]*$/，点号命名空间永久不可注册），
+ * 已降级为配置值（插件组合配置 + 会话内运行时覆盖），不再尝试 settings 安装。
+ * 作者 ddj 2026-08-27 / 2026-09-02
  */
-import type { Ctx } from '../store.js'
 import { PROVIDER_RESOLVERS, type LspProviderSpec } from './providers.js'
 import { provisionRuntime } from './dotnetProvision.js'
 
@@ -21,10 +23,10 @@ export interface LspConfig {
   [languageId: string]: LspLangConfig | undefined
 }
 
-export const LSP_SETTINGS_NS = 'dsh-vscode-mode.languageServers'
 export const LSP_LANGUAGES = ['lua', 'csharp'] as const
 
-function sanitizeLang(raw: unknown): LspLangConfig | undefined {
+/** 清洗单语言配置：仅保留合法字段并剥离 undefined（稀疏覆盖语义，清空字段即回落组合配置）。 */
+export function sanitizeLang(raw: unknown): LspLangConfig | undefined {
   if (!raw || typeof raw !== 'object') return undefined
   const obj = raw as Record<string, unknown>
   const out: LspLangConfig = {}
@@ -46,25 +48,7 @@ export function configFromPlugin(config: unknown): LspConfig {
   return out
 }
 
-/** 从 settings 描述符读取（无 settings 服务/无该 section → {}）。 */
-export function configFromSettings(ctx: Ctx): LspConfig {
-  try {
-    const settings = ctx.get('settings')
-    const descriptor = settings?.describe?.({ redactSecrets: true })?.find((item: { ns?: string }) => item.ns === LSP_SETTINGS_NS)
-    const value = descriptor?.value
-    if (!value || typeof value !== 'object') return {}
-    const out: LspConfig = {}
-    for (const lang of LSP_LANGUAGES) {
-      const v = sanitizeLang((value as Record<string, unknown>)[lang])
-      if (v) out[lang] = v
-    }
-    return out
-  } catch (error) {
-    return {}
-  }
-}
-
-/** 合并配置：settings 覆盖插件配置。 */
+/** 合并配置：上层（运行时覆盖/settings）覆盖插件组合配置。 */
 export function mergeConfig(a: LspConfig, b: LspConfig): LspConfig {
   const out: LspConfig = { ...a }
   for (const lang of LSP_LANGUAGES) {
@@ -77,17 +61,17 @@ export function mergeConfig(a: LspConfig, b: LspConfig): LspConfig {
 }
 
 /**
- * 解析某语言的 provider spec（合并配置后）。
- * @author ddj 2026年08月27号
- * @param ctx DSH 上下文
+ * 解析某语言的 provider spec（插件组合配置 + 运行时覆盖层合并后）。
+ * @author ddj 2026年08月27号 / 2026年09月02号
  * @param pluginConfig 插件组合配置
  * @param languageId 语言 id
+ * @param override 运行时覆盖层（设置页保存值，重启失效；缺省为空）
  * @returns provider 规格
  */
-export function resolveProviderSpec(ctx: Ctx, pluginConfig: unknown, languageId: string): LspProviderSpec {
+export function resolveProviderSpec(pluginConfig: unknown, languageId: string, override?: LspConfig): LspProviderSpec {
   const resolver = PROVIDER_RESOLVERS[languageId]
   if (!resolver) return { languageId, kind: 'none', argv: [], ready: false, reason: '不支持的语言：' + languageId }
-  const merged = mergeConfig(configFromPlugin(pluginConfig), configFromSettings(ctx))
+  const merged = mergeConfig(configFromPlugin(pluginConfig), override ?? {})
   const lang = merged[languageId]
   if (lang && lang.enabled === false) {
     return { languageId, kind: 'none', argv: [], ready: false, reason: '已在设置中禁用' }

package/src/lsp/providers.ts

@@ -12,6 +12,7 @@ import { dirname, join, sep } from 'node:path'
 import { isAbsolute } from 'node:path'
 import { extensionsRoot } from './extmgr.js'
 import { dshHome, lspSpecCacheFile } from '../paths.js'
+import type { LspCandidate } from '../shared/lsp.js'
 
 /** provider 来源标记（与 shared/lsp.ts 的 status.source 一致）。 */
 export type LspProviderKind = 'extension' | 'discover' | 'manual' | 'none'
@@ -237,26 +238,33 @@ export function candidateEmmyLua(home = dshHome()): { path: string; version?: st
   return candidates[0] ?? null
 }
 
-/** LuaLS 自动发现候选（VSCode 扩展目录 + extmgr 目录下 sumneko.lua-* 的 server/bin 可执行）。 */
-export function candidateLuaServers(home = dshHome()): string[] {
+/**
+ * LuaLS 自动发现候选（VSCode 扩展目录 + extmgr 目录下 sumneko.lua-* 的 server/bin 可执行）。
+ * 多版本并存时按清单版本降序、路径升序排序（与 EmmyLua/DotRush 发现的排序策略一致）。
+ * @author ddj 2026年09月03号
+ * @param home DSH home（缺省真实；测试可注入临时目录）
+ * @returns 排序后的候选列表（首个为建议选用者）
+ */
+export function candidateLuaServers(home = dshHome()): { path: string; version?: string }[] {
   const plat = platformServerDir()
   const suffix = exeSuffix()
-  const out: string[] = []
+  const out: { path: string; version?: string }[] = []
   for (const dir of vscodeExtensionsDirs(home)) {
     for (const extDir of listMatchingDirs(dir, 'sumneko.lua-')) {
       const binDir = join(extDir, 'server', 'bin')
       const binName = 'lua-language-server' + suffix
       // 新布局（3.x 平台变体 vsix）：server/bin/xxx.exe；旧布局：server/bin/<平台>/xxx.exe
       const bin = existsSync(join(binDir, binName)) ? join(binDir, binName) : join(binDir, plat, binName)
-      if (existsSync(bin) && !out.includes(bin)) out.push(bin)
+      if (existsSync(bin) && !out.some((c) => c.path === bin)) out.push({ path: bin, version: manifestVersionOf(extDir) })
     }
   }
-  return out
+  return out.sort((a, b) => (b.version ?? '').localeCompare(a.version ?? '', undefined, { numeric: true }) || a.path.localeCompare(b.path))
 }
 
-/** C# 服务器发现结果（ms-Roslyn / DotRush / OmniSharp + 系统 dotnet）。 */
+/** C# 服务器发现结果（ms-Roslyn / DotRush / OmniSharp + 系统 dotnet；各取清单版本最高者）。 */
 export interface CSharpCandidates {
   roslynDll?: string
+  roslynVersion?: string
   dotrushDll?: string
   dotrushVersion?: string
   omnisharpExe?: string
@@ -266,31 +274,44 @@ export interface CSharpCandidates {
 /**
  * C# 自动发现候选：ms-dotnettools.csharp 的 Roslyn dll（需 dotnet）/ OmniSharp 可执行，
  * 以及 DotRush 扩展自带服务器（extension/bin/LanguageServer/DotRush.dll，需对应 .NET 运行时）。
+ * 同类多版本并存时取清单版本最高者（与 EmmyLua/DotRush 发现的排序策略一致）。
  * @author ddj 2026年09月03号
  * @param home DSH home（缺省真实；测试可注入临时目录）
  * @returns 发现结果
  */
 export function candidateCSharpServers(home = dshHome()): CSharpCandidates {
   const out: CSharpCandidates = {}
-  const dotrushHits: { dll: string; version?: string }[] = []
+  /** 命中收集 → 清单版本降序取最高（平级按路径稳定排序）。 */
+  const bestOf = (hits: { entry: string; version?: string }[]): { entry: string; version?: string } | null =>
+    hits.sort((a, b) => (b.version ?? '').localeCompare(a.version ?? '', undefined, { numeric: true }) || a.entry.localeCompare(b.entry))[0] ?? null
+  const roslynHits: { entry: string; version?: string }[] = []
+  const omniHits: { entry: string; version?: string }[] = []
+  const dotrushHits: { entry: string; version?: string }[] = []
   for (const dir of vscodeExtensionsDirs(home)) {
     for (const extDir of listMatchingDirs(dir, 'ms-dotnettools.csharp-')) {
+      const version = manifestVersionOf(extDir)
       const roslyn = join(extDir, '.roslyn', 'Microsoft.CodeAnalysis.LanguageServer.dll')
-      if (!out.roslynDll && existsSync(roslyn)) out.roslynDll = roslyn
+      if (existsSync(roslyn)) roslynHits.push({ entry: roslyn, version })
       const omni = join(extDir, '.omnisharp', 'OmniSharp' + exeSuffix())
-      if (!out.omnisharpExe && existsSync(omni)) out.omnisharpExe = omni
+      if (existsSync(omni)) omniHits.push({ entry: omni, version })
     }
     for (const extDir of listMatchingDirs(dir, 'nromanov.dotrush-')) {
       const dll = join(extDir, 'extension', 'bin', 'LanguageServer', 'DotRush.dll')
       if (!existsSync(dll)) continue
-      dotrushHits.push({ dll, version: manifestVersionOf(extDir) })
+      dotrushHits.push({ entry: dll, version: manifestVersionOf(extDir) })
     }
   }
-  // 多版本并存时取清单版本最高者（与 EmmyLua 发现的排序策略一致）
-  const best = dotrushHits.sort((a, b) => (b.version ?? '').localeCompare(a.version ?? '', undefined, { numeric: true }) || a.dll.localeCompare(b.dll))[0]
-  if (best) {
-    out.dotrushDll = best.dll
-    out.dotrushVersion = best.version
+  const roslynBest = bestOf(roslynHits)
+  if (roslynBest) {
+    out.roslynDll = roslynBest.entry
+    out.roslynVersion = roslynBest.version
+  }
+  const omniBest = bestOf(omniHits)
+  if (omniBest) out.omnisharpExe = omniBest.entry
+  const dotrushBest = bestOf(dotrushHits)
+  if (dotrushBest) {
+    out.dotrushDll = dotrushBest.entry
+    out.dotrushVersion = dotrushBest.version
   }
   const dotnet = findDotnet()
   if (dotnet) out.dotnet = dotnet
@@ -367,7 +388,8 @@ export function resolveLuaProvider(manual?: { command?: string; path?: string },
     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 best = candidates[0]
+    if (best) return { ...base, kind: 'discover', argv: [best.path], cwd: undefined, ready: true, version: best.version, providerName: 'LuaLS' }
     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 或手动指定路径）' }
@@ -429,6 +451,44 @@ export const PROVIDER_RESOLVERS: Record<string, ProviderResolver> = {
   csharp: resolveCSharpProvider,
 }
 
+/**
+ * 汇总某语言当前检测到的候选服务器（每类服务器一条、取该类最高版本；设置页展示用）。
+ * chosen 以候选路径命中 spec.argv 判定；未选用（kind=none/manual 不匹配）时不标记。
+ * @author ddj 2026年09月03号
+ * @param languageId 语言 id
+ * @param spec 已解析的 provider 规格
+ * @param home DSH home（缺省真实；测试可注入临时目录）
+ * @returns 候选列表（不支持的语言/检测异常返回空）
+ */
+export function candidatesFor(languageId: string, spec: LspProviderSpec, home = dshHome()): LspCandidate[] {
+  /** 候选路径命中 spec.argv 时补 chosen 标记。 */
+  const markChosen = (candidate: LspCandidate): LspCandidate =>
+    spec.ready && candidate.path && spec.argv.includes(candidate.path) ? { ...candidate, chosen: true } : candidate
+  try {
+    if (languageId === 'lua') {
+      const out: LspCandidate[] = []
+      const emmy = candidateEmmyLua(home)
+      if (emmy) out.push(markChosen({ name: 'EmmyLua', version: emmy.version, path: emmy.path }))
+      const lua = candidateLuaServers(home)[0]
+      if (lua) out.push(markChosen({ name: 'LuaLS（sumneko.lua）', version: lua.version, path: lua.path }))
+      const inPath = findInPath('lua-language-server' + exeSuffix())
+      if (inPath) out.push(markChosen({ name: 'lua-language-server（PATH）', path: inPath }))
+      return out
+    }
+    if (languageId === 'csharp') {
+      const out: LspCandidate[] = []
+      const found = candidateCSharpServers(home)
+      if (found.roslynDll) out.push(markChosen({ name: 'Roslyn（ms-dotnettools.csharp）', version: found.roslynVersion, path: found.roslynDll }))
+      if (found.dotrushDll) out.push(markChosen({ name: 'DotRush', version: found.dotrushVersion, path: found.dotrushDll }))
+      if (found.omnisharpExe) out.push(markChosen({ name: 'OmniSharp', path: found.omnisharpExe }))
+      return out
+    }
+    return []
+  } catch (error) {
+    return []
+  }
+}
+
 /** 手动配置是否为绝对路径可执行（供设置页判断输入类型）。 */
 export function looksAbsolute(value: string): boolean {
   return isAbsolute(value)

package/src/lsp/rpc.ts

@@ -1,13 +1,15 @@
 /**
  * dsh-vscode-mode host — edrv.lsp.* RPC handlers。
  * 文档跟踪（openDocs 集合 + root|lang 引用计数）→ 懒启动服务器、用完释放。
- * 作者 ddj 2026-08-27
+ * LSP 配置降级为配置值：插件组合配置 + 会话内运行时覆盖层（原 settings section
+ * 命名空间不合法，永久不可注册，见 lsp/config.ts 头注释）。
+ * 作者 ddj 2026-08-27 / 2026-09-02
  */
 import type { Ctx } from '../store.js'
 import { searchRoot } from '../search/ripgrep.js'
 import { sessionOf, cwdOf } from '../registry.js'
-import { resolveProviderSpec, langOfPath, configFromPlugin, configFromSettings, LSP_LANGUAGES, LSP_SETTINGS_NS, type LspConfig } from './config.js'
-import { clearProviderCache } from './providers.js'
+import { resolveProviderSpec, langOfPath, configFromPlugin, mergeConfig, sanitizeLang, LSP_LANGUAGES, type LspConfig, type LspLangConfig } from './config.js'
+import { clearProviderCache, candidatesFor } from './providers.js'
 import { onRuntimeProvisioned, envInstallStates } from './dotnetProvision.js'
 import { envRequirementsFor, installRequirement } from './envRequirements.js'
 import type { LspManager } from './manager.js'
@@ -116,6 +118,8 @@ function createDocTracker() {
 export function createLspRpc(deps: LspRpcDeps): { handlers: Partial<RpcHandlerMap>; disposeSession: (sessionId: string) => void } {
   const { ctx, pluginConfig, manager } = deps
   const tracker = createDocTracker()
+  /** 运行时覆盖层：设置页保存值（内存态，重启回落组合配置值；每 apply 新建，插件重载自动复位）。 */
+  const runtimeConfig: LspConfig = {}
 
   // 运行时自动配置成功：清 provider 缓存并重置 C# 服务器，下一次文档同步即用新运行时重启
   onRuntimeProvisioned(() => {
@@ -139,7 +143,7 @@ export function createLspRpc(deps: LspRpcDeps): { handlers: Partial<RpcHandlerMa
   }
 
   const acquireServer = (root: string, lang: string) =>
-    manager.acquire(root, lang, (languageId: string) => resolveProviderSpec(ctx, pluginConfig, languageId))
+    manager.acquire(root, lang, (languageId: string) => resolveProviderSpec(pluginConfig, languageId, runtimeConfig))
 
   const serverOf = (root: string, lang: string) =>
     manager.peek(root, lang)
@@ -147,10 +151,11 @@ export function createLspRpc(deps: LspRpcDeps): { handlers: Partial<RpcHandlerMa
   const rootLocations = (locations: LspLocation[], root: string): LspLocation[] =>
     locations.map((location) => ({ ...location, root }))
 
-  /** 当前 provider 检测结论 → 设置页 idle 状态（不启动 server）；附带未满足的环境需求。 */
+  /** 当前 provider 检测结论 → 设置页 idle 状态（不启动 server）；附带未满足的环境需求与候选服务器。 */
   const detectedStatus = (languageId: string, root?: string): LspServerStatus => {
-    const spec = resolveProviderSpec(ctx, pluginConfig, languageId)
+    const spec = resolveProviderSpec(pluginConfig, languageId, runtimeConfig)
     const missingEnv = envRequirementsFor(languageId, dshHome())
+    const candidates = candidatesFor(languageId, spec)
     return {
       languageId,
       source: spec.kind,
@@ -160,6 +165,7 @@ export function createLspRpc(deps: LspRpcDeps): { handlers: Partial<RpcHandlerMa
       providerName: spec.providerName,
       root,
       missingEnv: missingEnv.length ? missingEnv : undefined,
+      candidates: candidates.length ? candidates : undefined,
     }
   }
 
@@ -199,34 +205,32 @@ export function createLspRpc(deps: LspRpcDeps): { handlers: Partial<RpcHandlerMa
       return { ok: true, servers: manager.statusAll().filter((status) => status.root === sc.root) }
     },
 
+    'edrv.lsp.detect': async () => {
+      // 全支持语言的检测结果（不启动服务器）：设置页动态渲染卡片 + 候选展示
+      return { ok: true, servers: LSP_LANGUAGES.map((lang) => detectedStatus(lang)) }
+    },
+
     'edrv.lsp.configGet': async () => {
-      const settings = configFromSettings(ctx)
-      const plugin = configFromPlugin(pluginConfig)
-      const merged: LspConfig = { ...plugin }
-      for (const lang of Object.keys(settings)) merged[lang] = { ...plugin[lang], ...settings[lang] }
+      // 配置值降级：插件组合配置 + 运行时覆盖层（原 settings section 已废弃）
+      const merged = mergeConfig(configFromPlugin(pluginConfig), runtimeConfig)
       return { ok: true, config: merged as unknown as Record<string, unknown> }
     },
 
     'edrv.lsp.configUpdate': async (args) => {
       const lang = args.languageId
-      if (!lang || !resolveProviderSpec(ctx, pluginConfig, lang).languageId) {
+      if (!lang || !(LSP_LANGUAGES as readonly string[]).includes(lang)) {
         return { ok: false, error: '不支持的语言：' + lang }
       }
-      const current = configFromSettings(ctx)
-      const next: LspConfig = { ...current, [lang]: { ...(current[lang] ?? {}) } }
-      const target = next[lang]!
+      // 覆盖层基于当前运行时值增量修改；清空字段剥离 undefined → 回落组合配置
+      const target: LspLangConfig = { ...(runtimeConfig[lang] ?? {}) }
       if (args.enabled !== undefined) target.enabled = args.enabled
       if (args.command !== undefined) target.command = args.command || undefined
       if (args.path !== undefined) target.path = args.path || undefined
+      runtimeConfig[lang] = sanitizeLang(target) ?? {}
       try {
-        const settings = ctx.get('settings')
-        if (!settings?.update) return { ok: false, error: '设置服务不可用' }
-        await settings.update(LSP_SETTINGS_NS, { [lang]: target })
         // 保存/切换后立即重新检测：清缓存 + 重置旧 server，旧状态不残留
         const servers = await redetectLanguage(lang)
-        const descriptor = settings.describe?.({ redactSecrets: true })?.find((item: { ns?: string }) => item.ns === LSP_SETTINGS_NS)
-        const stored = descriptor?.value as Record<string, unknown> | undefined
-        const merged: LspConfig = { ...configFromPlugin(pluginConfig), ...(stored as LspConfig) }
+        const merged = mergeConfig(configFromPlugin(pluginConfig), runtimeConfig)
         return { ok: true, config: merged as unknown as Record<string, unknown>, servers }
       } catch (error) {
         return { ok: false, error: '配置保存失败：' + String(error) }

package/src/shared/lsp.ts

@@ -164,6 +164,14 @@ export interface LspEnvInstallState {
   message?: string
 }
 
+/** 同语言检测到的候选服务器（candidates 元素；chosen 标记当前选用者）。 */
+export interface LspCandidate {
+  name: string      // 显示名（如 EmmyLua / LuaLS / Roslyn）
+  version?: string  // 扩展清单版本
+  path?: string     // 服务器入口路径（argv 比对用）
+  chosen?: boolean  // 是否为当前解析选用的服务器
+}
+
 /** 单语言服务器状态（edrv.lsp.status 载荷元素）。 */
 export interface LspServerStatus {
   languageId: string
@@ -176,6 +184,7 @@ export interface LspServerStatus {
   root?: string     // 绑定工作区根（相对显示）
   providerName?: string // provider 名称（如 EmmyLua / LuaLS）
   missingEnv?: LspMissingEnv[] // 未满足的环境需求（无则省略）
+  candidates?: LspCandidate[] // 同语言检测到的候选服务器（设置页展示用，无则省略）
 }
 
 /**

package/src/shared/rpc.ts

@@ -137,6 +137,7 @@ export interface RpcRequestMap {
   'vscode.devFormSet': { enabled: boolean; path?: string }
   'compat': {}
   'edrv.lsp.status': { sessionId?: string }
+  'edrv.lsp.detect': {}
   'edrv.lsp.sync': { sessionId?: string; path: string; text: string; version: number }
   'edrv.lsp.close': { sessionId?: string; path: string }
   'edrv.lsp.definition': { sessionId?: string; path: string; position: LspPosition }
@@ -208,6 +209,7 @@ export interface RpcOkMap {
   'vscode.devFormSet': { devForm: DevFormInfo; restart: boolean }
   'compat': { report: CompatReport }
   'edrv.lsp.status': { servers: LspServerStatus[] }
+  'edrv.lsp.detect': { servers: LspServerStatus[] }
   'edrv.lsp.sync': object
   'edrv.lsp.close': object
   'edrv.lsp.definition': { locations: LspLocation[]; truncated?: boolean }

package/src/lsp/settings.ts

@@ -1,50 +0,0 @@
-/**
- * dsh-vscode-mode host — LSP 配置设置 section 安装（版本自适应；缺失/失败不抛错）。
- * ns：dsh-vscode-mode.languageServers；每语言 { enabled, command, path }。
- * 安装策略分派见 fileOpenSettings.runSettingsInstall（rc 线 legacy / alpha 线服务方法）。
- * 作者 ddj 2026-08-27 / 2026-09-02
- */
-import type { Ctx } from '../store.js'
-import { LSP_LANGUAGES, LSP_SETTINGS_NS, type LspConfig } from './config.js'
-import { loadSettingsDeps, runSettingsInstall, type SettingsDeps } from '../fileOpenSettings.js'
-
-/**
- * 安装 LSP 设置 section。
- * @author ddj 2026年08月27号
- * @param ctx DSH 上下文
- * @param entry 初始配置
- * @returns 是否成功安装
- */
-export async function installLspSettingsSection(ctx: Ctx, entry: LspConfig): Promise<boolean> {
-  let deps: SettingsDeps | null = null
-  try {
-    deps = await loadSettingsDeps()
-  } catch {
-    /* 装载失败按缺失处理 */
-  }
-  if (!deps) return false
-  try {
-    // schemastery 无 .optional()，对象字段默认即可选；.default 必给避免 undefined 覆盖
-    const z = deps.z
-    const langShape: Record<string, unknown> = {}
-    for (const lang of LSP_LANGUAGES) {
-      langShape[lang] = z.object({
-        enabled: z.boolean(),
-        command: z.string(),
-        path: z.string(),
-      }).default({})
-    }
-    const schema = z.object(langShape).default({})
-    const strategy = await runSettingsInstall(ctx, LSP_SETTINGS_NS, schema, entry, {
-      setSource: () => {},
-      onChange: () => {},
-    })
-    return strategy === 'legacy' || strategy === 'service'
-  } catch (error) {
-    // 设置 section 安装失败不致命：降级为无设置 UI，LSP 核心功能不受影响
-    console.error('[dsh-vscode-mode] LSP 设置 section 安装失败：' + String(error))
-    return false
-  }
-}
-
-export type { SettingsDeps }