dsh-vscode-mode 0.1.45 → 0.1.47

package/src/lsp/envRequirements.ts

@@ -0,0 +1,92 @@
+/**
+ * dsh-vscode-mode host — LSP 环境需求检测注册表。
+ * 每个语言注册一个检测器：扫描当前环境，返回未满足的需求清单（含一键安装与官网链接信息）。
+ * 新接入 LSP：在 CHECKERS 加一个检测器条目；需要内置安装器时在 INSTALLERS 注册同前缀安装函数。
+ * 检测在 status/redetect/configUpdate 时执行（不缓存），保证安装完成后状态即时刷新。
+ * 作者 ddj 2026年09月03号
+ */
+import { dirname } from 'node:path'
+import { candidateCSharpServers, dotnetWithRuntime, runtimeMajorOf } from './providers.js'
+import { startEnvInstall } from './dotnetProvision.js'
+import type { LspMissingEnv } from '../shared/lsp.js'
+
+/** dotnet 运行时需求构造（DotRush / ms-Roslyn 共用）。 */
+function dotnetRuntimeRequirement(major: number, detail: string): LspMissingEnv {
+  return {
+    id: 'dotnet-runtime:' + major,
+    label: '.NET 运行时 ' + major + '.0',
+    detail,
+    installable: true,
+    manualUrl: 'https://dotnet.microsoft.com/download/dotnet/' + major + '.0',
+    manualLabel: '官网下载',
+  }
+}
+
+/** csharp 检测器：DotRush 缺运行时 / ms-Roslyn 缺 dotnet。 */
+function checkCSharp(home: string): LspMissingEnv[] {
+  const found = candidateCSharpServers(home)
+  const missing: LspMissingEnv[] = []
+  if (found.dotrushDll) {
+    const major = runtimeMajorOf(dirname(found.dotrushDll))
+    if (major !== null && dotnetWithRuntime(major) === null) {
+      missing.push(dotnetRuntimeRequirement(major, 'DotRush 语言服务器运行所需'))
+    }
+    return missing
+  }
+  if (found.roslynDll && !found.dotnet) {
+    // 官方 Roslyn 服务器分支未实测，保守按 LTS 8 基线提示
+    missing.push(dotnetRuntimeRequirement(8, 'Roslyn 语言服务器运行所需'))
+  }
+  return missing
+}
+
+/** lua 检测器：EmmyLua/LuaLS 自带运行时，无外部依赖。 */
+function checkLua(): LspMissingEnv[] {
+  return []
+}
+
+/** 检测器注册表（按 languageId；新 LSP 在此加条目即可）。 */
+const CHECKERS: Record<string, (home: string) => LspMissingEnv[]> = {
+  lua: checkLua,
+  csharp: checkCSharp,
+}
+
+/** 安装器注册表（按需求 id 前缀匹配；新依赖类型在此加条目）。 */
+const INSTALLERS: { prefix: string; run: (id: string) => boolean }[] = [
+  {
+    prefix: 'dotnet-runtime:',
+    run: (id) => {
+      const major = Number.parseInt(id.slice('dotnet-runtime:'.length), 10)
+      return Number.isInteger(major) ? startEnvInstall(major) : false
+    },
+  },
+]
+
+/**
+ * 检测某语言未满足的环境需求（仅返回缺失项；检测器异常按无需求处理）。
+ * @author ddj 2026年09月03号
+ * @param languageId 语言 id
+ * @param home DSH home（测试可注入临时目录）
+ * @returns 缺失需求清单
+ */
+export function envRequirementsFor(languageId: string, home: string): LspMissingEnv[] {
+  const checker = CHECKERS[languageId]
+  if (!checker) return []
+  try {
+    return checker(home)
+  } catch {
+    return []
+  }
+}
+
+/**
+ * 尝试一键安装某条需求（存在内置安装器时启动，进行中/已满足返回 false）。
+ * @author ddj 2026年09月03号
+ * @param id 需求标识（如 dotnet-runtime:10）
+ * @returns 是否成功启动安装
+ */
+export function installRequirement(id: string): boolean {
+  const installer = INSTALLERS.find((it) => id.startsWith(it.prefix))
+  if (!installer) return false
+  return installer.run(id)
+}

package/src/lsp/providers.ts

@@ -1,8 +1,9 @@
 /**
  * dsh-vscode-mode host — 语言服务器 provider 解析。
  * 优先级：手动配置 > extmgr 扩展源(Phase 2 挂载) > 自动发现(~/.vscode/extensions、
- * ~/.dsh/dsh-vscode-mode/extensions、PATH)。产物 LspProviderSpec：{ ready, argv, cwd, reason }，
- * 供 manager 启动服务器。
+ * ~/.dsh/dsh-vscode-mode/extensions、PATH)。C# 自动发现覆盖 ms-dotnettools.csharp
+ * （Roslyn/OmniSharp）与 DotRush（自带 DotRush.dll 服务器，需对应 .NET 运行时）。
+ * 产物 LspProviderSpec：{ ready, argv, cwd, reason }，供 manager 启动服务器。
  * 作者 ddj 2026-08-27
  */
 import { existsSync, readdirSync, readFileSync, writeFileSync, mkdirSync, rmSync, type Dirent } from 'node:fs'
@@ -20,6 +21,9 @@ export interface LspProviderSpec {
   kind: LspProviderKind
   argv: string[]
   cwd?: string
+  env?: Record<string, string>
+  /** 需自动配置的 .NET 运行时大版本（发现 DotRush 但缺运行时时设置，见 dotnetProvision.ts）。 */
+  provisionRuntime?: number
   ready: boolean
   reason?: string
   version?: string
@@ -56,8 +60,16 @@ export function listMatchingDirs(dir: string, prefix: string): string[] {
   return entries.filter((e) => e.isDirectory() && e.name.startsWith(prefix)).map((e) => join(dir, e.name))
 }
 
-/** VSCode 扩展目录（~/.vscode/extensions、~/.vscode-server/extensions + extmgr 目录；无则空数组）。 */
+/**
+ * VSCode 扩展目录（~/.vscode/extensions、~/.vscode-server/extensions + extmgr 目录；无则空数组）。
+ * 测试可用 DSH_LSP_EXT_DIRS（平台路径分隔符分隔）完全覆盖扫描列表，避免受真实机器扩展影响。
+ * @author ddj 2026年09月03号
+ */
 export function vscodeExtensionsDirs(home = dshHome()): string[] {
+  const override = process.env.DSH_LSP_EXT_DIRS
+  if (override) {
+    return override.split(sep === '\\' ? ';' : ':').map((dir) => dir.trim()).filter((dir) => dir && existsSync(dir))
+  }
   const userHome = homedir()
   return [
     join(userHome, '.vscode', 'extensions'),
@@ -90,7 +102,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, version: p.version, providerName: p.version ? 'EmmyLua' : '语言服务器扩展' }
+  return { languageId, kind: 'extension', argv: p.argv, cwd: p.cwd, ready: true, version: p.version, providerName: '语言服务器扩展' }
 }
 
 /** 清空全部扩展源注册（插件卸载/扩展目录重建时）。 */
@@ -113,18 +125,104 @@ export function findInPath(name: string): string | null {
   return null
 }
 
-/** 查找 dotnet（PATH + 常见安装路径）。 */
-export function findDotnet(): string | null {
-  const inPath = findInPath('dotnet')
-  if (inPath) return inPath
-  const candidates = [
+/** dotnet 候选（PATH 命中 + 常见安装路径 + 用户级安装位置），仅保留真实存在者。 */
+export function dotnetCandidates(): string[] {
+  const localAppData = process.env.LOCALAPPDATA
+  const out = [
+    findInPath('dotnet'),
     'C:/Program Files/dotnet/dotnet.exe',
     'C:/Program Files (x86)/dotnet/dotnet.exe',
+    localAppData ? join(localAppData, 'Microsoft', 'dotnet', 'dotnet.exe') : null,
   ]
-  for (const c of candidates) if (existsSync(c)) return c
+  return out.filter((p): p is string => !!p && existsSync(p))
+}
+
+/** 查找 dotnet（PATH + 常见安装路径）。 */
+export function findDotnet(): string | null {
+  return dotnetCandidates()[0] ?? null
+}
+
+/**
+ * 查找具备指定 .NET 运行时大版本的 dotnet（按 dotnetCandidates 顺序探测）。
+ * @author ddj 2026年09月03号
+ * @param minMajor 运行时最低大版本（如 10）
+ * @param candidates dotnet 候选路径（缺省 dotnetCandidates()；测试可注入）
+ * @returns 满足条件的 dotnet 路径；无满足者返回 null
+ */
+export function dotnetWithRuntime(minMajor: number, candidates: string[] = dotnetCandidates()): string | null {
+  for (const dotnet of candidates) {
+    const sharedDir = join(dirname(dotnet), 'shared', 'Microsoft.NETCore.App')
+    let versions: string[] = []
+    try {
+      versions = readdirSync(sharedDir)
+    } catch (error) {
+      continue
+    }
+    const found = versions.some((name) => {
+      const major = Number.parseInt(name.split('.')[0] ?? '', 10)
+      return Number.isInteger(major) && major >= minMajor
+    })
+    if (found) return dotnet
+  }
+  return null
+}
+
+/**
+ * 探测含 .NET SDK 的 dotnet 根目录（MSBuild 工程求值与 restore 需要，runtime-only 不够）。
+ * @author ddj 2026年09月03号
+ * @param candidates dotnet 候选路径（缺省 dotnetCandidates()；测试可注入）
+ * @returns 含 SDK 的 dotnet 根目录；无则 null
+ */
+export function findSdkRoot(candidates: string[] = dotnetCandidates()): string | null {
+  for (const dotnet of candidates) {
+    const root = dirname(dotnet)
+    if (sdkVersionOf(root)) return root
+  }
   return null
 }
 
+/**
+ * dotnet 根目录下最新 SDK 版本号（无 SDK 返回 null）。
+ * @author ddj 2026年09月03号
+ * @param root dotnet 根目录
+ * @returns SDK 版本号
+ */
+export function sdkVersionOf(root: string): string | null {
+  try {
+    const versions = readdirSync(join(root, 'sdk')).filter((name) => /^\d+\.\d+/.test(name))
+    if (!versions.length) return null
+    return versions.sort((a, b) => b.localeCompare(a, undefined, { numeric: true }))[0] ?? null
+  } catch (error) {
+    return null
+  }
+}
+
+/**
+ * C# 服务器所需的 MSBuild 环境变量（SDK 解析 + restore 的 muxer 定位）。
+ * @author ddj 2026年09月03号
+ * @param sdkRoot 含 SDK 的 dotnet 根目录
+ * @returns 环境变量表
+ */
+export function sdkEnvOf(sdkRoot: string): Record<string, string> {
+  const version = sdkVersionOf(sdkRoot)
+  const env: Record<string, string> = {
+    DOTNET_ROOT: sdkRoot,
+    DOTNET_MSBUILD_SDK_RESOLVER_CLI_DIR: sdkRoot,
+  }
+  if (version) env.DOTNET_SDK_PATH = join(sdkRoot, 'sdk', version)
+  return env
+}
+
+/** 读扩展目录 package.json 的 version（读取失败不影响入口使用，返回 undefined）。 */
+function manifestVersionOf(extDir: string): string | undefined {
+  try {
+    const manifest = JSON.parse(readFileSync(join(extDir, 'package.json'), 'utf8')) as { version?: unknown }
+    return typeof manifest.version === 'string' ? manifest.version : undefined
+  } catch (error) {
+    return undefined
+  }
+}
+
 /** EmmyLua 自动发现候选（tangzx.emmylua-* / server/emmylua_ls）。 */
 export function candidateEmmyLua(home = dshHome()): { path: string; version?: string } | null {
   const candidates: { path: string; version?: string }[] = []
@@ -132,12 +230,7 @@ export function candidateEmmyLua(home = dshHome()): { path: string; version?: st
     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.push({ path: server, version: manifestVersionOf(extDir) })
     }
   }
   candidates.sort((a, b) => (b.version ?? '').localeCompare(a.version ?? '', undefined, { numeric: true }) || a.path.localeCompare(b.path))
@@ -161,9 +254,25 @@ export function candidateLuaServers(home = dshHome()): string[] {
   return out
 }
 
-/** C# 自动发现候选：Roslyn dll（需 dotnet）或 OmniSharp 可执行。 */
-export function candidateCSharpServers(home = dshHome()): { roslynDll?: string; omnisharpExe?: string; dotnet?: string } {
-  const out: { roslynDll?: string; omnisharpExe?: string; dotnet?: string } = {}
+/** C# 服务器发现结果（ms-Roslyn / DotRush / OmniSharp + 系统 dotnet）。 */
+export interface CSharpCandidates {
+  roslynDll?: string
+  dotrushDll?: string
+  dotrushVersion?: string
+  omnisharpExe?: string
+  dotnet?: string
+}
+
+/**
+ * C# 自动发现候选：ms-dotnettools.csharp 的 Roslyn dll（需 dotnet）/ OmniSharp 可执行，
+ * 以及 DotRush 扩展自带服务器（extension/bin/LanguageServer/DotRush.dll，需对应 .NET 运行时）。
+ * @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 }[] = []
   for (const dir of vscodeExtensionsDirs(home)) {
     for (const extDir of listMatchingDirs(dir, 'ms-dotnettools.csharp-')) {
       const roslyn = join(extDir, '.roslyn', 'Microsoft.CodeAnalysis.LanguageServer.dll')
@@ -171,12 +280,57 @@ export function candidateCSharpServers(home = dshHome()): { roslynDll?: string;
       const omni = join(extDir, '.omnisharp', 'OmniSharp' + exeSuffix())
       if (!out.omnisharpExe && existsSync(omni)) out.omnisharpExe = omni
     }
+    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) })
+    }
+  }
+  // 多版本并存时取清单版本最高者（与 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 dotnet = findDotnet()
   if (dotnet) out.dotnet = dotnet
   return out
 }
 
+/**
+ * 从服务器 dll 同目录的 *.runtimeconfig.json 解析所需 .NET 运行时大版本。
+ * @author ddj 2026年09月03号
+ * @param dllDir 服务器 dll 所在目录
+ * @returns 运行时大版本；无清单或解析失败返回 null
+ */
+export function runtimeMajorOf(dllDir: string): number | null {
+  try {
+    for (const name of readdirSync(dllDir)) {
+      if (!name.endsWith('.runtimeconfig.json')) continue
+      const config = JSON.parse(readFileSync(join(dllDir, name), 'utf8')) as { runtimeOptions?: { framework?: { version?: unknown } } }
+      const version = config.runtimeOptions?.framework?.version
+      if (typeof version !== 'string') continue
+      const major = Number.parseInt(version.split('.')[0] ?? '', 10)
+      if (Number.isInteger(major)) return major
+    }
+  } catch (error) { /* 清单读取失败按无约束处理 */ }
+  return null
+}
+
+/**
+ * 解析 DotRush 启动参数：优先扩展内置 SDK dotnet，否则找满足其运行时大版本的 dotnet。
+ * @author ddj 2026年09月03号
+ * @param dll DotRush.dll 绝对路径
+ * @returns argv 可直接启动；reason 为不可启动的原因
+ */
+function dotrushLaunch(dll: string): { argv: string[] } | { reason: string } {
+  const sdkDotnet = join(dirname(dirname(dll)), 'Sdk', 'dotnet' + exeSuffix())
+  const major = runtimeMajorOf(dirname(dll))
+  const dotnet = existsSync(sdkDotnet) ? sdkDotnet : major !== null ? dotnetWithRuntime(major) : findDotnet()
+  if (dotnet) return { argv: [dotnet, dll] }
+  return { reason: 'DotRush 需 .NET ' + (major ?? '') + ' 运行时，未找到满足的 dotnet' }
+}
+
 /**
  * 手动配置归一化：path 指向可执行文件/目录，command 为可执行名（PATH 解析）。
  * 未配置时返回空 reason（由各 resolve 兜底输出语言相关安装指引文案）。
@@ -221,7 +375,8 @@ export function resolveLuaProvider(manual?: { command?: string; path?: string },
 }
 
 /**
- * 解析 C# provider（优先级：手动 > 扩展源 > 自动发现；需 dotnet + Roslyn dll；或 OmniSharp）。
+ * 解析 C# provider（优先级：手动 > 扩展源 > 自动发现；Roslyn dll 需 dotnet；
+ * DotRush 需满足其运行时的 dotnet；或 OmniSharp）。
  * @author ddj 2026年08月27号
  * @param manual 手动配置
  * @param home DSH home（缺省真实；测试可注入临时目录）
@@ -235,16 +390,34 @@ export function resolveCSharpProvider(manual?: { command?: string; path?: string
     const ext = extensionProviderFor('csharp')
     if (ext) return ext
     const discovered = candidateCSharpServers(h)
+    // SDK 环境注入：runtime-only 的 dotnet 会导致 MSBuild 求值/restore 退化
+    const sdkRoot = findSdkRoot()
+    const msbuildEnv = sdkRoot ? sdkEnvOf(sdkRoot) : undefined
     if (discovered.roslynDll && discovered.dotnet) {
-      return { ...base, kind: 'discover', argv: [discovered.dotnet, discovered.roslynDll, '--stdio'], ready: true }
+      return { ...base, kind: 'discover', argv: [discovered.dotnet, discovered.roslynDll, '--stdio'], env: msbuildEnv, ready: true }
+    }
+    let dotrushReason: string | null = null
+    let provisionMajor: number | undefined
+    if (discovered.dotrushDll) {
+      const major = runtimeMajorOf(dirname(discovered.dotrushDll))
+      const launch = dotrushLaunch(discovered.dotrushDll)
+      if ('argv' in launch) {
+        return { ...base, kind: 'discover', argv: launch.argv, env: msbuildEnv, ready: true, version: discovered.dotrushVersion, providerName: 'DotRush' }
+      }
+      dotrushReason = launch.reason
+      provisionMajor = major ?? undefined
     }
     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 入口）' }
+    if (dotrushReason) {
+      reasons.push(dotrushReason)
+    } else {
+      if (!discovered.dotnet) reasons.push('未找到 dotnet')
+      reasons.push('未发现 ms-dotnettools.csharp / DotRush 扩展')
+    }
+    return { ...base, kind: 'none', argv: [], ready: false, provisionRuntime: provisionMajor, reason: reasons.join('；') + '（可手动指定 Roslyn/OmniSharp 入口）' }
   })
 }
 
@@ -319,7 +492,7 @@ function fingerprintOf(home: string): string {
       return '?'
     }
   })
-  return process.platform + '|' + marks.join('|')
+  return process.platform + '|' + (findSdkRoot() ?? 'no-sdk') + '|' + marks.join('|')
 }
 
 /**

package/src/lsp/rpc.ts

@@ -8,10 +8,13 @@ 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 { onRuntimeProvisioned, envInstallStates } from './dotnetProvision.js'
+import { envRequirementsFor, installRequirement } from './envRequirements.js'
 import type { LspManager } from './manager.js'
 import type { RpcHandlerMap } from '../shared/rpc.js'
 import type { LspLocation, LspServerStatus } from '../shared/lsp.js'
 import { installFromMarket, installVsixFile, listInstalled, marketGet, marketSearch, uninstall, updateExtension, type ExtInfo } from './extmgr.js'
+import { dshHome } from '../paths.js'
 
 export interface LspRpcDeps {
   ctx: Ctx
@@ -114,6 +117,12 @@ export function createLspRpc(deps: LspRpcDeps): { handlers: Partial<RpcHandlerMa
   const { ctx, pluginConfig, manager } = deps
   const tracker = createDocTracker()
 
+  // 运行时自动配置成功：清 provider 缓存并重置 C# 服务器，下一次文档同步即用新运行时重启
+  onRuntimeProvisioned(() => {
+    clearProviderCache()
+    manager.resetLanguage('csharp')
+  })
+
   /** 解析会话与工作区根（失败 → null + error）。 */
   const rootOf = async (sessionId: string | undefined): Promise<{ root: string; sessionId: string } | { err: string }> => {
     const session = sessionOf(ctx, sessionId)
@@ -138,9 +147,10 @@ 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())
     return {
       languageId,
       source: spec.kind,
@@ -149,6 +159,7 @@ export function createLspRpc(deps: LspRpcDeps): { handlers: Partial<RpcHandlerMa
       version: spec.version,
       providerName: spec.providerName,
       root,
+      missingEnv: missingEnv.length ? missingEnv : undefined,
     }
   }
 
@@ -352,6 +363,18 @@ export function createLspRpc(deps: LspRpcDeps): { handlers: Partial<RpcHandlerMa
       }
     },
 
+    // 环境需求：一键安装（内置安装器）与安装进度查询
+    'edrv.lsp.envInstall': async (args) => {
+      if (!installRequirement(args.id)) {
+        return { ok: false, started: false, error: '该需求不支持一键安装：' + args.id }
+      }
+      return { ok: true, started: true }
+    },
+
+    'edrv.lsp.envState': async () => {
+      return { ok: true, states: envInstallStates() }
+    },
+
     // --region 扩展管理（edrv.lsp.ext.*：已装/市场/安装/卸载/更新）
     'edrv.lsp.ext.list': async () => ({ ok: true, extensions: listInstalled() }),
 

package/src/lsp/server.ts

@@ -7,6 +7,7 @@
 import { spawnServer, type Transport } from './transport.js'
 import { createLspClient, type LspClient } from './client.js'
 import { pathToFileUri } from './uri.js'
+import { deriveDefinitionFromLocations } from './derive.js'
 import type { LspProviderSpec } from './providers.js'
 import { LSP_SEMANTIC_TOKEN_MODIFIERS, LSP_SEMANTIC_TOKEN_TYPES } from '../shared/lsp.js'
 import type {
@@ -64,6 +65,7 @@ export function createLspServer(spec: LspProviderSpec, root: string, languageId:
   let client: LspClient | null = null
   let capabilities: LspServerCapabilities = {
     definition: false,
+    declaration: false,
     references: false,
     documentSymbol: false,
     workspaceSymbol: false,
@@ -152,7 +154,7 @@ export function createLspServer(spec: LspProviderSpec, root: string, languageId:
       setPhase('starting')
       try {
         transport = spawnServer(
-          { argv: spec.argv, cwd: spec.cwd ?? root },
+          { argv: spec.argv, cwd: spec.cwd ?? root, env: spec.env },
           (message) => { /* 由 client 接管 */ },
           (line) => log('stderr: ' + line),
         )
@@ -185,6 +187,13 @@ export function createLspServer(spec: LspProviderSpec, root: string, languageId:
         })
         // 让 client 接管 stdout 消息
         const caps = await client.initialize(rootUri, [rootUri])
+        // DotRush 服务器阻塞等待带 dotrush 段的配置通知才继续初始化（加载工作区），
+        // 不发则所有文档类查询返回空；官方 VSCode 扩展经 configurationSection 自动发送。
+        // 按 csharp 语言统一发送：手动配置的 DotRush 与其它 C# 服务器（OmniSharp 等）
+        // 对不认识的配置段按协议忽略，均安全
+        if (languageId === 'csharp') {
+          client.notify('workspace/didChangeConfiguration', { settings: { dotrush: { roslyn: {} } } })
+        }
         capabilities = caps
         return true
       } catch (error) {
@@ -231,11 +240,55 @@ export function createLspServer(spec: LspProviderSpec, root: string, languageId:
     async definition(path: string, line: number, character: number): Promise<LspLocation[]> {
       const doc = docs.get(path)
       if (!doc || !(await readyWait)) return []
-      const result = await ensureClient().request<unknown>(
-        'textDocument/definition',
-        { textDocument: { uri: doc.uri }, position: { line, character } },
+      const client = ensureClient()
+      const position = { line, character }
+      // ① 标准定义（方法/跨文件命名空间等）
+      const direct = normalizeLocations(
+        await client.request<unknown>(
+          'textDocument/definition',
+          { textDocument: { uri: doc.uri }, position },
+        ),
       )
-      return normalizeLocations(result)
+      if (direct.length) return direct
+      // ② 声明（服务器能力支持时）：EmmyLua 对局部变量/参数/表字段 definition 常返回空，declaration 更准
+      if (capabilities.declaration) {
+        try {
+          const decl = normalizeLocations(
+            await client.request<unknown>(
+              'textDocument/declaration',
+              { textDocument: { uri: doc.uri }, position },
+            ),
+          )
+          if (decl.length) {
+            log('definition fallback → declaration (' + path + ':' + line + ':' + character + ')')
+            return decl
+          }
+        } catch (error) {
+          log('declaration request failed: ' + String(error))
+        }
+      }
+      // ③ 引用推导：definition/declaration 均空时，从 references(includeDeclaration) 推导声明
+      // （EmmyLua 局部/参数把声明排在引用首位；词文本不一致则拒绝，宁可空不误跳）
+      try {
+        const refs = normalizeLocations(
+          await client.request<unknown>(
+            'textDocument/references',
+            {
+              textDocument: { uri: doc.uri },
+              position,
+              context: { includeDeclaration: true },
+            },
+          ),
+        )
+        const derived = deriveDefinitionFromLocations(position, refs, doc.text, doc.uri)
+        if (derived) {
+          log('definition fallback → references-derived (' + path + ':' + line + ':' + character + ')')
+          return [derived]
+        }
+      } catch (error) {
+        log('references fallback failed: ' + String(error))
+      }
+      return []
     },
 
     async references(path: string, line: number, character: number, includeDeclaration: boolean): Promise<LspLocation[]> {

package/src/shared/lsp.ts

@@ -69,9 +69,66 @@ export interface LspSemanticTokens {
   resultId?: string
 }
 
+/** 语义 token 解码后的绝对范围（LSP 0-based；type 为插件固定 legend 与 type 名）。 */
+export interface LspSemanticTokenRange {
+  start: LspPosition
+  end: LspPosition
+  type: string
+  modifiers: number
+}
+
+/** 语义 token 中可作为"可导航标识符"的类型（ctrl+hover 下划线判定用）。 */
+export const LSP_NAVIGABLE_TOKEN_TYPES: ReadonlySet<string> = new Set([
+  'variable', 'parameter', 'property', 'function', 'method', 'class', 'enum',
+  'struct', 'interface', 'namespace', 'typeParameter', 'enumMember', 'event', 'type',
+])
+
+/**
+ * 语义 token 是否属于可导航标识符。
+ * @author ddj 2026年09月02号
+ * @param type 语义 token 类型名（插件固定 legend）
+ * @returns 是否可导航
+ */
+export function isNavigableTokenType(type: string): boolean {
+  return LSP_NAVIGABLE_TOKEN_TYPES.has(type)
+}
+
+/**
+ * 解码 LSP delta 编码的语义 token 流为绝对范围数组。
+ * @author ddj 2026年09月02号
+ * @param data 5 元组 delta 流（host normalizeSemanticData 产物，类型索引对应固定 legend）
+ * @param types 固定 legend 类型表（缺省 LSP_SEMANTIC_TOKEN_TYPES）
+ * @returns 绝对范围列表（保持文档顺序）
+ */
+export function decodeSemanticTokens(
+  data: number[],
+  types: readonly string[] = LSP_SEMANTIC_TOKEN_TYPES,
+): LspSemanticTokenRange[] {
+  const out: LspSemanticTokenRange[] = []
+  let line = 0
+  let character = 0
+  for (let i = 0; i + 4 < data.length; i += 5) {
+    const deltaLine = data[i] ?? 0
+    const deltaCharacter = data[i + 1] ?? 0
+    const length = Math.max(0, data[i + 2] ?? 0)
+    const typeIndex = data[i + 3] ?? 0
+    const modifiers = data[i + 4] ?? 0
+    line += deltaLine
+    character = deltaLine === 0 ? character + deltaCharacter : deltaCharacter
+    out.push({
+      start: { line, character },
+      end: { line, character: character + length },
+      type: types[typeIndex] ?? 'variable',
+      modifiers,
+    })
+  }
+  return out
+}
+
 /** LSP 服务器能力子集：本插件会用到的方法。 */
 export interface LspServerCapabilities {
   definition: boolean
+  declaration: boolean
   references: boolean
   documentSymbol: boolean
   workspaceSymbol: boolean
@@ -90,6 +147,23 @@ export type LspServerPhase =
   | 'unavailable' // 连续失败，停止自动重启
   | 'stopped'     // 已停止（禁用/卸载/会话结束）
 
+/** 单条缺失环境需求（edrv.lsp.status.missingEnv 元素，仅含未满足项）。 */
+export interface LspMissingEnv {
+  id: string          // 需求标识（如 dotnet-runtime:10，同时是安装器键）
+  label: string       // 显示名（如 '.NET 运行时 10.0'）
+  detail?: string     // 说明（哪个服务器需要）
+  installable: boolean // 支持一键安装
+  manualUrl?: string  // 官网手动下载地址
+  manualLabel?: string
+}
+
+/** 环境安装进行态（edrv.lsp.envState 载荷元素）。 */
+export interface LspEnvInstallState {
+  id: string
+  phase: 'idle' | 'downloading' | 'extracting' | 'done' | 'failed'
+  message?: string
+}
+
 /** 单语言服务器状态（edrv.lsp.status 载荷元素）。 */
 export interface LspServerStatus {
   languageId: string
@@ -101,6 +175,7 @@ export interface LspServerStatus {
   progressMessage?: string
   root?: string     // 绑定工作区根（相对显示）
   providerName?: string // provider 名称（如 EmmyLua / LuaLS）
+  missingEnv?: LspMissingEnv[] // 未满足的环境需求（无则省略）
 }
 
 /**