dsh-vscode-mode 0.1.46 → 0.1.47

package/package.json

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

package/src/client/ui/LspSettings.ts

@@ -11,7 +11,7 @@ import '../styles/mcp.css'
 
 const LANGUAGES = [
   { id: 'lua', label: 'Lua（EmmyLua / LuaLS）', hint: '优先使用已安装 EmmyLua；未安装时回退 LuaLS 或 PATH 中的 lua-language-server' },
-  { id: 'csharp', label: 'C#（Roslyn / OmniSharp）', hint: '需 dotnet + ms-dotnettools.csharp 的 .roslyn 服务器，或手动指定' },
+  { id: 'csharp', label: 'C#（Roslyn / DotRush / OmniSharp）', hint: '优先自动发现 ms-dotnettools.csharp / DotRush 扩展（DotRush 需 .NET 10 运行时）；也可手动指定' },
 ]
 
 const PHASE_LABEL = {
@@ -25,8 +25,18 @@ const TABS = [
   { id: 'updates', label: '更新' },
 ]
 
-/** 语言卡片：状态 + 启用开关 + 命令/路径配置 + 重新检测。 */
-function LangCard({ lang, config, status, busy, onToggle, onSave, onRedetect }) {
+/** 环境安装按钮文案（按安装进行态）。 */
+function envButtonLabel(req, envStates) {
+  const state = (envStates ?? []).find((s) => s.id === req.id)
+  if (state?.phase === 'downloading') return '下载中…'
+  if (state?.phase === 'extracting') return '安装中…'
+  if (state?.phase === 'done') return '已完成'
+  if (state?.phase === 'failed') return '重试'
+  return '一键安装'
+}
+
+/** 语言卡片：状态 + 缺失环境提示（一键安装/官网下载） + 启用开关 + 命令/路径配置 + 重新检测。 */
+function LangCard({ lang, config, status, busy, envStates, onInstallEnv, onToggle, onSave, onRedetect }) {
   const [pathDraft, setPathDraft] = React.useState(config?.path ?? '')
   const [commandDraft, setCommandDraft] = React.useState(config?.command ?? '')
   React.useEffect(() => { setPathDraft(config?.path ?? ''); setCommandDraft(config?.command ?? '') }, [config?.path, config?.command])
@@ -44,6 +54,21 @@ function LangCard({ lang, config, status, busy, onToggle, onSave, onRedetect })
       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?.missingEnv) && status.missingEnv.length
+      ? React.createElement('div', { className: 'vsm-lsp-hint' },
+        '缺少运行环境（一键安装后自动生效）：',
+        status.missingEnv.map((req) => React.createElement('div', { key: req.id, className: 'vsm-mcp-actions' },
+          React.createElement('span', null, req.label, req.detail ? '（' + req.detail + '）' : ''),
+          req.installable ? React.createElement('button', {
+            className: 'vsm-primary vsm-small',
+            disabled: busy === 'env:' + req.id,
+            onClick: () => onInstallEnv(lang.id, req),
+          }, envButtonLabel(req, envStates)) : null,
+          req.manualUrl ? React.createElement('a', {
+            href: req.manualUrl, target: '_blank', rel: 'noreferrer',
+            style: { color: 'inherit', textDecoration: 'underline', alignSelf: 'center' },
+          }, req.manualLabel ?? '官网下载') : null)))
+      : null,
     React.createElement('div', { className: 'vsm-lsp-form' },
       React.createElement('label', null, React.createElement('span', null, '可执行文件路径（绝对路径，优先）'), React.createElement('input', { value: pathDraft, placeholder: '如 C:/.../lua-language-server.exe', onChange: (e) => setPathDraft(e.target.value) })),
       React.createElement('label', null, React.createElement('span', null, '命令名（PATH 内查找）'), React.createElement('input', { value: commandDraft, placeholder: '如 lua-language-server', onChange: (e) => setCommandDraft(e.target.value) })),
@@ -96,6 +121,8 @@ export function LspSettings() {
   const [busy, setBusy] = React.useState('')
   const [error, setError] = React.useState('')
   const [loading, setLoading] = React.useState(true)
+  const [envStates, setEnvStates] = React.useState([])
+  const [envLang, setEnvLang] = React.useState('')
 
   const refreshServers = React.useCallback(() => {
     Promise.all([rpc('edrv.lsp.configGet', {}), rpc('edrv.lsp.status', {})])
@@ -117,6 +144,15 @@ export function LspSettings() {
       .catch((e) => setError(String(e)))
   }, [])
 
+  const refreshEnvStates = React.useCallback(() => {
+    return rpc('edrv.lsp.envState', {})
+      .then((res) => {
+        if (res?.ok) setEnvStates(res.states ?? [])
+        return res?.states ?? []
+      })
+      .catch(() => [])
+  }, [])
+
   const refresh = React.useCallback(() => {
     setLoading(true)
     Promise.all([refreshServers(), refreshExt()]).finally(() => setLoading(false))
@@ -140,10 +176,52 @@ export function LspSettings() {
   }
 
   /** 重检测后通知编辑器：与 host 重新同步已打开的模型（触发重新 acquire）。 */
-  const notifyResync = (languageId) => {
+  const notifyResync = React.useCallback((languageId) => {
     window.dispatchEvent(new CustomEvent('edrv:lsp-redetect', { detail: { languageId } }))
+  }, [])
+
+  /** 一键安装缺失环境：启动内置安装器（成功后进入轮询，完成自动重同步）。 */
+  const installEnv = (languageId, req) => {
+    const key = 'env:' + req.id
+    setBusy(key)
+    setError('')
+    setEnvLang(languageId)
+    rpc('edrv.lsp.envInstall', { languageId, id: req.id })
+      .then((res) => {
+        if (!res?.ok) { setError(res?.error ?? '无法启动安装'); return }
+        void refreshEnvStates()
+        void refreshServers()
+      })
+      .catch((e) => setError(String(e)))
+      .finally(() => setBusy(''))
   }
 
+  // 环境安装进行中：2s 轮询进度并刷新状态；某项转入 done 时由下方过渡检测重同步
+  React.useEffect(() => {
+    const states = envStates ?? []
+    const installing = states.some((s) => s.phase === 'downloading' || s.phase === 'extracting')
+    if (!installing) return
+    const timer = setInterval(() => {
+      void refreshEnvStates()
+      void refreshServers()
+    }, 2000)
+    return () => clearInterval(timer)
+  }, [envStates, refreshEnvStates, refreshServers])
+
+  // 环境安装完成过渡检测：刷新状态并通知编辑器重新同步对应语言
+  const prevEnvPhases = React.useRef({})
+  React.useEffect(() => {
+    const states = envStates ?? []
+    for (const s of states) {
+      const prev = prevEnvPhases.current[s.id]
+      if (prev && prev !== 'done' && s.phase === 'done' && envLang) {
+        void refreshServers()
+        notifyResync(envLang)
+      }
+      prevEnvPhases.current[s.id] = s.phase
+    }
+  }, [envStates, envLang, refreshServers, notifyResync])
+
   const saveLang = (languageId, path, command) => {
     setBusy(languageId)
     setError('')
@@ -271,7 +349,7 @@ export function LspSettings() {
         key: lang.id, lang,
         config: config[lang.id] ?? {},
         status: servers.find((s) => s.languageId === lang.id),
-        busy, onToggle: toggleLang, onSave: saveLang, onRedetect: redetectLang,
+        busy, envStates, onInstallEnv: installEnv, onToggle: toggleLang, onSave: saveLang, onRedetect: redetectLang,
       })),
       React.createElement('div', { className: 'vsm-lsp-hint' }, '提示：打开 Lua/C# 文件即自动（惰性）启动对应语言服务器；未配置时编辑器功能不受影响，大纲回退内置解析。')))
   } else if (tab === 'installed') {

package/src/lsp/config.ts

@@ -5,6 +5,7 @@
  */
 import type { Ctx } from '../store.js'
 import { PROVIDER_RESOLVERS, type LspProviderSpec } from './providers.js'
+import { provisionRuntime } from './dotnetProvision.js'
 
 /** 单语言配置。 */
 export interface LspLangConfig {
@@ -91,7 +92,10 @@ export function resolveProviderSpec(ctx: Ctx, pluginConfig: unknown, languageId:
   if (lang && lang.enabled === false) {
     return { languageId, kind: 'none', argv: [], ready: false, reason: '已在设置中禁用' }
   }
-  return resolver({ command: lang?.command, path: lang?.path })
+  const spec = resolver({ command: lang?.command, path: lang?.path })
+  // DotRush 缺运行时：后台自动下载官方 .NET runtime（用户零操作），完成后经监听者重载
+  if (spec.provisionRuntime) provisionRuntime(spec.provisionRuntime)
+  return spec
 }
 
 /** 语言 → 扩展名（供客户端判断是否触发 LSP）。 */

package/src/lsp/dotnetProvision.ts

@@ -0,0 +1,224 @@
+/**
+ * dsh-vscode-mode host — C# 服务器 .NET 运行时自动配置。
+ * DotRush 等服务器需要 .NET 运行时；缺失时从官方 release 元数据解析下载地址，
+ * sha512 校验后解压到用户级 dotnet 目录（win: %LOCALAPPDATA%\Microsoft\dotnet，
+ * unix: ~/.dotnet），成功后通知监听者重载 provider——用户零手动操作。
+ * 失败静默降级（保留原 reason 文案），10 分钟退避重试。
+ * 安装全程有状态机（envInstallStates）供设置页一键安装与进度轮询使用。
+ * 作者 ddj 2026年09月03号
+ */
+import { spawn } from 'node:child_process'
+import { createHash } from 'node:crypto'
+import { existsSync, mkdirSync, rmSync, writeFileSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { homedir } from 'node:os'
+import { dirname, join } from 'node:path'
+import { dotnetWithRuntime } from './providers.js'
+import type { LspEnvInstallState } from '../shared/lsp.js'
+import { unzip } from './zip.js'
+
+/** release 元数据 files 元素子集（官方 releases.json）。 */
+export interface RuntimeAsset {
+  name: string
+  url: string
+  hash: string
+}
+
+const META_BASE = 'https://builds.dotnet.microsoft.com/dotnet/release-metadata'
+const RETRY_MS = 10 * 60 * 1000
+
+/** 同 major 去重（in-flight）。 */
+const inFlight = new Map<number, Promise<boolean>>()
+/** 失败时间戳（退避重试）。 */
+const failedAt = new Map<number, number>()
+/** 配置成功监听者（重载 provider 缓存与服务器）。 */
+const listeners = new Set<() => void>()
+/** 安装进行态（major → phase/message），供设置页轮询展示。 */
+const installStates = new Map<number, { phase: LspEnvInstallState['phase']; message?: string }>()
+
+/** 需求 id（与 envRequirements 的 id 一致）。 */
+export function runtimeRequirementId(major: number): string {
+  return 'dotnet-runtime:' + major
+}
+
+/** 当前安装进行态快照（edrv.lsp.envState 载荷）。 */
+export function envInstallStates(): LspEnvInstallState[] {
+  return [...installStates.entries()].map(([major, state]) => ({
+    id: runtimeRequirementId(major),
+    phase: state.phase,
+    message: state.message,
+  }))
+}
+
+/** 注册配置成功监听（成功后由 rpc 侧清缓存并重置服务器）。 */
+export function onRuntimeProvisioned(listener: () => void): void {
+  listeners.add(listener)
+}
+
+/** 平台 → 官方运行时资产文件名。 */
+function assetNameFor(platform: string, arch: string): string {
+  const archPart = arch === 'arm64' ? 'arm64' : 'x64'
+  if (platform === 'win32') return 'dotnet-runtime-win-' + archPart + '.zip'
+  if (platform === 'darwin') return 'dotnet-runtime-osx-' + archPart + '.tar.gz'
+  return 'dotnet-runtime-linux-' + archPart + '.tar.gz'
+}
+
+/** 用户级 dotnet 安装目录（与 providers 的发现候选位置一致）。 */
+export function userDotnetDir(): string {
+  if (process.platform === 'win32') {
+    return join(process.env.LOCALAPPDATA ?? join(homedir(), 'AppData', 'Local'), 'Microsoft', 'dotnet')
+  }
+  return join(homedir(), '.dotnet')
+}
+
+/** 从 release 元数据 files 里挑当前平台资产（纯函数，测试可注入平台）。 */
+export function pickRuntimeAsset(files: RuntimeAsset[], platform = process.platform, arch = process.arch): RuntimeAsset | null {
+  const name = assetNameFor(platform, arch)
+  return files.find((f) => f.name === name) ?? null
+}
+
+/** 是否允许自动配置（测试隔离 + 显式开关）。 */
+function allowed(): boolean {
+  if (process.env.DSH_LSP_AUTO_RUNTIME === '0') return false
+  if (process.env.DSH_LSP_EXT_DIRS) return false // 测试环境不下载
+  return true
+}
+
+function setState(major: number, phase: LspEnvInstallState['phase'], message?: string): void {
+  installStates.set(major, { phase, message })
+}
+
+function notifyListeners(): void {
+  for (const listener of listeners) {
+    try {
+      listener()
+    } catch { /* 单个监听失败不影响其它 */ }
+  }
+}
+
+/**
+ * 触发运行时自动配置（幂等：同 major 去重；失败 10 分钟退避；已满足则直接成功回调）。
+ * 静默自动路径与设置页一键安装共用；进度经 envInstallStates 暴露。
+ * @author ddj 2026年09月03号
+ * @param major 运行时大版本
+ */
+export function provisionRuntime(major: number): void {
+  if (inFlight.has(major)) return
+  const failed = failedAt.get(major)
+  if (failed && Date.now() - failed < RETRY_MS) return
+  const task = runProvision(major)
+    .catch(() => false)
+    .then((ok) => {
+      inFlight.delete(major)
+      if (ok) {
+        failedAt.delete(major)
+        setState(major, 'done')
+        notifyListeners()
+      } else {
+        failedAt.set(major, Date.now())
+        setState(major, 'failed')
+      }
+      return ok
+    })
+  inFlight.set(major, task)
+}
+
+/**
+ * 一键安装入口（设置页按钮）：校验允许后触发 provisionRuntime。
+ * @author ddj 2026年09月03号
+ * @param major 运行时大版本
+ * @returns 是否成功启动（已满足/进行中/被禁用时返回 false）
+ */
+export function startEnvInstall(major: number): boolean {
+  if (dotnetWithRuntime(major)) {
+    setState(major, 'done')
+    return false
+  }
+  if (!allowed() || inFlight.has(major)) return false
+  const failed = failedAt.get(major)
+  if (failed && Date.now() - failed < RETRY_MS && installStates.get(major)?.phase === 'failed') {
+    // 退避期内失败态：允许用户手动重试（清除退避标记）
+    failedAt.delete(major)
+  }
+  provisionRuntime(major)
+  return inFlight.has(major)
+}
+
+async function runProvision(major: number): Promise<boolean> {
+  if (dotnetWithRuntime(major)) return true
+  setState(major, 'downloading')
+  const meta = await fetchJson(META_BASE + '/' + major + '.0/releases.json')
+  const release = meta?.releases?.[0]
+  const files = release?.runtime?.files
+  if (!Array.isArray(files)) return false
+  const asset = pickRuntimeAsset(files as RuntimeAsset[])
+  if (!asset?.url || !asset.hash) return false
+  const buf = await downloadVerified(asset.url, asset.hash)
+  if (!buf) return false
+  setState(major, 'extracting')
+  const dir = userDotnetDir()
+  const created = !existsSync(dir)
+  try {
+    const ok = await extractTo(buf, dir)
+    if (!ok) throw new Error('解压失败')
+  } catch (error) {
+    if (created) rmSync(dir, { recursive: true, force: true })
+    return false
+  }
+  return dotnetWithRuntime(major) !== null
+}
+
+/** 拉取 JSON（30s 超时，失败返回 null）。 */
+async function fetchJson(url: string): Promise<{ releases?: { runtime?: { files?: unknown } }[] } | null> {
+  try {
+    const res = await fetch(url, { signal: AbortSignal.timeout(30000) })
+    if (!res.ok) return null
+    return await res.json()
+  } catch {
+    return null
+  }
+}
+
+/** 下载并按官方 sha512 校验（5 分钟超时，不匹配返回 null）。 */
+async function downloadVerified(url: string, sha512: string): Promise<Buffer | null> {
+  try {
+    const res = await fetch(url, { signal: AbortSignal.timeout(300000) })
+    if (!res.ok) return null
+    const buf = Buffer.from(await res.arrayBuffer())
+    const actual = createHash('sha512').update(buf).digest('hex').toLowerCase()
+    return actual === sha512.toLowerCase() ? buf : null
+  } catch {
+    return null
+  }
+}
+
+/** 解压到目录：win 走 zip（PK 头），unix 落临时包交系统 tar。 */
+async function extractTo(buf: Buffer, dir: string): Promise<boolean> {
+  mkdirSync(dir, { recursive: true })
+  if (buf.subarray(0, 2).toString('ascii') === 'PK') {
+    for (const entry of unzip(buf)) {
+      if (!entry.path || entry.path.startsWith('..')) continue
+      const parts = entry.path.split(/[\\/]/).filter((p) => p && p !== '..' && p !== '.')
+      if (!parts.length) continue
+      const target = join(dir, ...parts)
+      if (entry.isDirectory) {
+        mkdirSync(target, { recursive: true })
+        continue
+      }
+      mkdirSync(dirname(target), { recursive: true })
+      writeFileSync(target, entry.data)
+    }
+    return true
+  }
+  const tmp = join(tmpdir(), 'dsh-dotnet-' + Date.now() + '.tar.gz')
+  try {
+    writeFileSync(tmp, buf)
+    return await new Promise<boolean>((resolve) => {
+      const child = spawn('tar', ['-xzf', tmp, '-C', dir], { stdio: 'ignore' })
+      child.on('exit', (code) => resolve(code === 0))
+      child.on('error', () => resolve(false))
+    })
+  } finally {
+    rmSync(tmp, { force: true })
+  }
+}

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)
+}