dsh-vscode-mode 0.1.49 → 0.1.51

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/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

@@ -7,7 +7,7 @@ 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 { clearProviderCache, candidatesFor } from './providers.js'
 import { onRuntimeProvisioned, envInstallStates } from './dotnetProvision.js'
 import { envRequirementsFor, installRequirement } from './envRequirements.js'
 import type { LspManager } from './manager.js'
@@ -147,10 +147,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 missingEnv = envRequirementsFor(languageId, dshHome())
+    const candidates = candidatesFor(languageId, spec)
     return {
       languageId,
       source: spec.kind,
@@ -160,6 +161,7 @@ export function createLspRpc(deps: LspRpcDeps): { handlers: Partial<RpcHandlerMa
       providerName: spec.providerName,
       root,
       missingEnv: missingEnv.length ? missingEnv : undefined,
+      candidates: candidates.length ? candidates : undefined,
     }
   }
 
@@ -199,6 +201,11 @@ 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)
@@ -209,7 +216,7 @@ export function createLspRpc(deps: LspRpcDeps): { handlers: Partial<RpcHandlerMa
 
     '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)

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 }