dsh-vscode-mode 0.1.32 → 0.1.36

package/src/lsp/settings.ts

@@ -0,0 +1,44 @@
+/**
+ * dsh-vscode-mode host — LSP 配置设置 section 安装（动态依赖，缺失不抛错）。
+ * ns：dsh-vscode-mode.languageServers；每语言 { enabled, command, path }。
+ * 作者 ddj 2026-08-27
+ */
+import type { Ctx } from '../store.js'
+import { LSP_LANGUAGES, LSP_SETTINGS_NS, type LspConfig } from './config.js'
+import { loadSettingsDeps, 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> {
+  const deps = await loadSettingsDeps()
+  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({})
+    deps.installSettingsSection(ctx, LSP_SETTINGS_NS, schema, entry, {
+      setSource: () => {},
+      onChange: () => {},
+    })
+    return true
+  } catch (error) {
+    // 设置 section 安装失败不致命：降级为无设置 UI，LSP 核心功能不受影响
+    console.error('[dsh-vscode-mode] LSP 设置 section 安装失败：' + String(error))
+    return false
+  }
+}
+
+export type { SettingsDeps }

package/src/lsp/transport.ts

@@ -0,0 +1,143 @@
+/**
+ * dsh-vscode-mode host — LSP 语言服务器进程传输层。
+ * 基于 node:child_process.spawn（stdio pipe 双向流）。刻意不用 DSH ctx.subprocess
+ * 抽象：LSP 需要持续写 stdin + 流式读 stdout，而该抽象 stdin 不可写、输出为一次性收集。
+ * 作者 ddj 2026-08-27
+ */
+import { spawn, type ChildProcess } from 'node:child_process'
+import { createFrameParser } from './jsonrpc.js'
+
+const STDERR_CAP = 256 << 10
+
+export interface TransportSpec {
+  argv: string[]
+  cwd?: string
+  env?: Record<string, string>
+}
+
+export interface Transport {
+  /** 写一行帧到 stdin（自动加换行）。 */
+  write(chunk: Buffer): boolean
+  /** 推送 stdout 解析出的原始消息（内部由帧解析器调用）。 */
+  onMessage: ((message: unknown) => void) | null
+  /** stderr 收集缓冲（有界，供诊断）。 */
+  stderr(): string
+  /** 进程退出/崩溃回调（code/signal）。 */
+  onExit: ((code: number | null, signal: string | null) => void) | null
+  /** 优雅关闭后强杀（Windows 下连带进程树）。 */
+  dispose(): void
+  /** 是否仍存活。 */
+  readonly alive: boolean
+  readonly pid: number | undefined
+}
+
+const running = new Set<ChildProcess>()
+
+/** 当前仍在运行的 LSP 子进程（供 disposeAll / 诊断）。 */
+export function liveChildren(): ReadonlySet<ChildProcess> {
+  return running
+}
+
+/**
+ * 启动语言服务器进程。
+ * @author ddj 2026年08月27号
+ * @param spec 启动参数（argv 数组，不经 shell，Windows 引号安全）
+ * @param onMessage stdout 消息回调
+ * @param logger 诊断日志（可选）
+ * @returns 传输句柄
+ */
+export function spawnServer(spec: TransportSpec, onMessage: (message: unknown) => void, logger?: (line: string) => void): Transport {
+  const { argv, cwd, env } = spec
+  const child = spawn(argv[0], argv.slice(1), {
+    cwd,
+    env: { ...process.env, ...env },
+    stdio: ['pipe', 'pipe', 'pipe'],
+    windowsHide: true,
+  })
+  running.add(child)
+  let stderrBuf = Buffer.alloc(0)
+  let alive = true
+  const parser = createFrameParser()
+
+  child.stderr.on('data', (chunk: Buffer) => {
+    if (stderrBuf.length < STDERR_CAP) {
+      stderrBuf = Buffer.concat([stderrBuf, chunk], Math.min(stderrBuf.length + chunk.length, STDERR_CAP))
+    }
+    logger?.(chunk.toString('utf8'))
+  })
+
+  let exited = false
+  const emitExit = (code: number | null, signal: string | null): void => {
+    if (exited) return
+    exited = true
+    alive = false
+    running.delete(child)
+    transport.onExit?.(code, signal)
+  }
+  child.on('error', (error) => {
+    logger?.('spawn error: ' + String(error))
+    emitExit(null, null)
+  })
+  child.on('exit', (code, signal) => emitExit(code, signal))
+  child.on('close', (code, signal) => emitExit(code, signal))
+
+  const transport: Transport = {
+    write(chunk: Buffer): boolean {
+      if (!alive || !child.stdin.writable) return false
+      child.stdin.write(chunk)
+      return true
+    },
+    onMessage,
+    stderr(): string {
+      return stderrBuf.toString('utf8')
+    },
+    onExit: null,
+    dispose(): void {
+      if (!alive) return
+      // 先 SIGTERM 让服务器有机会清理，1.5s 后强杀进程树
+      child.kill()
+      const timer = setTimeout(() => {
+        if (!alive) return
+        alive = false
+        running.delete(child)
+        try {
+          if (process.platform === 'win32') {
+            spawn('taskkill', ['/PID', String(child.pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' })
+          } else {
+            child.kill('SIGKILL')
+          }
+        } catch (error) {
+          logger?.('force kill error: ' + String(error))
+        }
+      }, 1500)
+      timer.unref?.()
+    },
+    get alive() {
+      return alive
+    },
+    get pid() {
+      return child.pid
+    },
+  }
+  // stdout 帧解析 → onMessage（LSP 响应/通知；onMessage 由 client 接管后动态生效）
+  child.stdout.on('data', (chunk: Buffer) => {
+    for (const message of parser.push(chunk)) transport.onMessage?.(message)
+  })
+  return transport
+}
+
+/** 强杀全部运行中的 LSP 子进程（插件卸载/退出用）。 */
+export function disposeAllServers(): void {
+  for (const child of running) {
+    try {
+      if (process.platform === 'win32' && child.pid) {
+        spawn('taskkill', ['/PID', String(child.pid), '/T', '/F'], { windowsHide: true, stdio: 'ignore' })
+      } else {
+        child.kill('SIGKILL')
+      }
+    } catch (error) {
+      /* 忽略单个清理失败 */
+    }
+  }
+  running.clear()
+}

package/src/lsp/uri.ts

@@ -0,0 +1,62 @@
+/**
+ * dsh-vscode-mode host — 路径 ↔ file:// URI 转换（纯函数，node 可测）。
+ * LSP 的 uri 字段必须是 file:// 绝对 URI；客户端 Monaco 用 edrv:///<encodeURI(path)>。
+ * 作者 ddj 2026-08-27
+ */
+import { fileURLToPath, pathToFileURL } from 'node:url'
+import { isAbsolute, resolve as resolvePath } from 'node:path'
+
+/**
+ * 绝对路径 → file:// URI（Windows 盘符保留：D:/x → file:///D:/x）。
+ * @author ddj 2026年08月27号
+ * @param absPath 绝对路径（正/反斜杠均可）
+ * @returns file:// URI
+ */
+export function pathToFileUri(absPath: string): string {
+  const normalized = absPath.replace(/\\/g, '/')
+  const drive = /^([A-Za-z]:)(?:\/(.*))?$/.exec(normalized)
+  if (drive) {
+    const tail = drive[2] ? '/' + drive[2].split('/').map(encodeURIComponent).join('/') : ''
+    return 'file:///' + drive[1] + tail
+  }
+  return pathToFileURL(normalized).toString()
+}
+
+/**
+ * file:// URI → 绝对路径（Windows file:///C:/x → C:\x）。
+ * @author ddj 2026年08月27号
+ * @param uri file:// URI
+ * @returns 绝对路径
+ */
+export function fileUriToPath(fileUri: string): string {
+  try {
+    return fileURLToPath(fileUri)
+  } catch (error) {
+    return String(error)
+  }
+}
+
+/**
+ * 将（可能相对的）路径解析为绝对路径后转 file:// URI。
+ * @author ddj 2026年08月27号
+ * @param path 相对或绝对路径
+ * @param cwd 解析相对路径的基准（可选）
+ * @returns file:// URI
+ */
+export function resolveToFileUri(path: string, cwd?: string): string {
+  const abs = isAbsolute(path) ? path : cwd ? resolvePath(cwd, path) : resolvePath(path)
+  return pathToFileUri(abs)
+}
+
+/**
+ * 判定绝对路径是否在给定根目录（含）内。
+ * @author ddj 2026年08月27号
+ * @param root 根目录绝对路径
+ * @param target 目标绝对路径
+ * @returns 是否在根内
+ */
+export function isInside(root: string, target: string): boolean {
+  const r = root.replace(/\\/g, '/').replace(/\/+$/, '') + '/'
+  const t = target.replace(/\\/g, '/')
+  return t === r.slice(0, -1) || t.startsWith(r)
+}

package/src/lsp/zip.ts

@@ -0,0 +1,82 @@
+/**
+ * dsh-vscode-mode host — 纯 Node ZIP 解压（零依赖，跨平台）。
+ * 供 extmgr 解包 VSIX 使用；只实现 VSIX 需要的子集：
+ * 读取 EOCD + 中央目录，支持 stored(0)/deflate(8)，忽略 zip64（VSIX < 4GB）。
+ * 作者 ddj 2026-08-27
+ */
+import { inflateRawSync } from 'node:zlib'
+
+/** 单条解压结果：相对路径 + 内容（目录条目 path 以 / 结尾）。 */
+export interface ZipEntry {
+  path: string
+  data: Buffer
+  isDirectory: boolean
+}
+
+const EOCD_SIG = 0x06054b50
+const CDIR_SIG = 0x02014b50
+const LHDR_SIG = 0x04034b50
+
+/**
+ * 解析 ZIP 缓冲区 → 条目列表（不解压内容，仅元数据）。
+ * @author ddj 2026年08月27号
+ * @param buf zip 字节
+ * @returns 条目元数据
+ */
+export function zipEntries(buf: Buffer): { name: string; method: number; compressed: number; uncompressed: number; localOffset: number }[] {
+  const eocd = findEocd(buf)
+  if (eocd < 0) throw new Error('不是有效的 ZIP 文件（找不到 EOCD）')
+  const total = buf.readUInt16LE(eocd + 10)
+  let offset = buf.readUInt32LE(eocd + 16)
+  const out: { name: string; method: number; compressed: number; uncompressed: number; localOffset: number }[] = []
+  for (let i = 0; i < total; i++) {
+    if (buf.readUInt32LE(offset) !== CDIR_SIG) throw new Error('ZIP 中央目录损坏')
+    const method = buf.readUInt16LE(offset + 10)
+    const compressed = buf.readUInt32LE(offset + 20)
+    const uncompressed = buf.readUInt32LE(offset + 24)
+    const nameLen = buf.readUInt16LE(offset + 28)
+    const extraLen = buf.readUInt16LE(offset + 30)
+    const commentLen = buf.readUInt16LE(offset + 32)
+    const localOffset = buf.readUInt32LE(offset + 42)
+    const name = buf.subarray(offset + 46, offset + 46 + nameLen).toString('utf8')
+    out.push({ name, method, compressed, uncompressed, localOffset })
+    offset += 46 + nameLen + extraLen + commentLen
+  }
+  return out
+}
+
+/**
+ * 解压 ZIP → 条目列表（目录条目含尾部 /）。
+ * @author ddj 2026年08月27号
+ * @param buf zip 字节
+ * @returns 条目（含内容）
+ */
+export function unzip(buf: Buffer): ZipEntry[] {
+  const metas = zipEntries(buf)
+  const out: ZipEntry[] = []
+  for (const meta of metas) {
+    const lh = meta.localOffset
+    if (buf.readUInt32LE(lh) !== LHDR_SIG) throw new Error('ZIP 本地头损坏：' + meta.name)
+    const nameLen = buf.readUInt16LE(lh + 26)
+    const extraLen = buf.readUInt16LE(lh + 28)
+    const dataStart = lh + 30 + nameLen + extraLen
+    const isDir = /\/$/.test(meta.name)
+    let data: Buffer = Buffer.alloc(0)
+    if (!isDir && meta.compressed > 0) {
+      const raw = buf.subarray(dataStart, dataStart + meta.compressed)
+      data = meta.method === 8 ? Buffer.from(inflateRawSync(raw)) : meta.method === 0 ? Buffer.from(raw) : Buffer.alloc(0)
+    }
+    out.push({ path: meta.name, data, isDirectory: isDir })
+  }
+  return out
+}
+
+/** 定位 EOCD（从尾部向前扫，容忍尾部注释）。 */
+function findEocd(buf: Buffer): number {
+  const maxScan = Math.min(buf.length, 65557)
+  for (let i = buf.length - 22; i >= buf.length - maxScan; i--) {
+    if (i < 0) break
+    if (buf.readUInt32LE(i) === EOCD_SIG) return i
+  }
+  return -1
+}

package/src/rpc.ts

@@ -216,8 +216,16 @@ async function latestPatchBackup(patchPath: string): Promise<string | undefined>
 }
 
 /** 各方法 handler 表（类型由 shared/rpc 的 RpcHandlerMap 约束）。 */
-export function buildHandlers(ctx: Ctx, registry: Registry, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx)): RpcHandlerMap {
+export function buildHandlers(
+  ctx: Ctx,
+  registry: Registry,
+  searcher = newSearcher(ctx),
+  contentSearcher = newContentSearcher(ctx),
+  lspHandlers?: Partial<RpcHandlerMap>,
+): RpcHandlerMap {
   return {
+    // edrv.lsp.* 由 createLspRpc 一次性提供（tracker 跨请求保留），这里并入。
+    ...((lspHandlers ?? {}) as RpcHandlerMap),
     'edrv.list': async (args) => {
       const sc = await requireSession(ctx, args.sessionId)
       if ('err' in sc) return { ok: false, error: sc.err }
@@ -664,8 +672,9 @@ export async function handleRpc<M extends RpcMethod>(
   args: RpcRequestMap[M],
   searcher = newSearcher(ctx),
   contentSearcher = newContentSearcher(ctx),
+  lspHandlers?: Partial<RpcHandlerMap>,
 ): Promise<RpcResult<M>> {
-  const handlers = buildHandlers(ctx, registry, searcher, contentSearcher)
+  const handlers = buildHandlers(ctx, registry, searcher, contentSearcher, lspHandlers)
   const handler = handlers[method]
   if (!handler) return { ok: false, error: '未知方法: ' + String(method) } as RpcResult<M>
   return handler(args)

package/src/shared/lsp.ts

@@ -0,0 +1,138 @@
+/**
+ * dsh-vscode-mode shared — 语言服务器 RPC 契约（双面，禁 node/react）。
+ * LSP 请求/响应的 JSON 载荷形状 + 纯函数辅助（Monaco↔LSP 坐标换算等）。
+ * 只描述"过 RPC 的载荷"，宿主与语言服务器之间的帧级交互在 host 侧 src/lsp/ 内。
+ * 作者 ddj 2026-08-27
+ */
+
+/** LSP Position（0-based：line 行号从 0，character UTF-16 列从 0）。 */
+export interface LspPosition {
+  line: number
+  character: number
+}
+
+/** LSP Range（start/end 均 0-based，包含 start、排除 end）。 */
+export interface LspRange {
+  start: LspPosition
+  end: LspPosition
+}
+
+/** LSP Location：uri 为 file:// 绝对路径；root 用于还原为工作区相对路径。 */
+export interface LspLocation {
+  uri: string
+  range: LspRange
+  root?: string
+}
+
+/** 跳转结果（definition 常返回 LocationLink，归一化为 targetUri + targetRange + 可选 originSelectionRange）。 */
+export interface LspLocationLink {
+  targetUri: string
+  targetRange: LspRange
+  targetSelectionRange: LspRange
+  originSelectionRange?: LspRange
+}
+
+/** 归一化后的符号（documentSymbol/workspaceSymbol 统一形状）。kind 为 LSP SymbolKind 数值。 */
+export interface LspSymbol {
+  name: string
+  kind: number
+  range: LspRange
+  selectionRange: LspRange
+  detail?: string
+  containerName?: string
+  children?: LspSymbol[]
+}
+
+/** hover 内容（markdown/纯文本行数组）。 */
+export interface LspHover {
+  contents: string[]
+  range?: LspRange
+}
+
+/** LSP 服务器能力子集：本插件会用到的方法。 */
+export interface LspServerCapabilities {
+  definition: boolean
+  references: boolean
+  documentSymbol: boolean
+  workspaceSymbol: boolean
+  hover: boolean
+}
+
+/** 服务器进程/会话状态。 */
+export type LspServerPhase =
+  | 'idle'        // 未启动（惰性）
+  | 'starting'    // 启动中（initialize 握手）
+  | 'ready'       // 就绪
+  | 'indexing'    // 工作区索引中
+  | 'unavailable' // 连续失败，停止自动重启
+  | 'stopped'     // 已停止（禁用/卸载/会话结束）
+
+/** 单语言服务器状态（edrv.lsp.status 载荷元素）。 */
+export interface LspServerStatus {
+  languageId: string
+  source: 'extension' | 'discover' | 'manual' | 'none'
+  phase: LspServerPhase
+  version?: string
+  reason?: string   // unavailable/不可用原因（缺 dotnet、找不到服务器等）
+  progress?: number // LSP 工作区解析进度（0–100，未知时省略）
+  progressMessage?: string
+  root?: string     // 绑定工作区根（相对显示）
+}
+
+/**
+ * Monaco 位置（1-based lineNumber/column）→ LSP Position（0-based）。
+ * @author ddj 2026年08月27号
+ * @param lineNumber Monaco 行（≥1）
+ * @param column Monaco 列（≥1）
+ * @returns LSP 0-based position
+ */
+export function monoToLsp(lineNumber: number, column: number): LspPosition {
+  return { line: Math.max(0, lineNumber - 1), character: Math.max(0, column - 1) }
+}
+
+/**
+ * LSP Position（0-based）→ Monaco 位置（1-based）。
+ * @author ddj 2026年08月27号
+ * @param pos LSP position
+ * @returns { lineNumber, column }（均 ≥1）
+ */
+export function lspToMono(pos: LspPosition): { lineNumber: number; column: number } {
+  return { lineNumber: Math.max(1, pos.line + 1), column: Math.max(1, pos.character + 1) }
+}
+
+/** file:// URI → 路径（仅做规范化解码；Windows file:///C:/... 保留）。 */
+export function fileUriToPath(uri: string): string {
+  if (!uri) return ''
+  const rest = uri.replace(/^file:\/\//, '')
+  const decoded = decodeURIComponent(rest)
+  return decoded.replace(/^\/([A-Za-z]:)/, '$1') // file:///C:/x → C:/x
+}
+
+/** 已装扩展信息（edrv.lsp.ext.list 载荷元素）。 */
+export interface LspExtInfo {
+  id: string        // publisher.name
+  namespace: string
+  name: string
+  version: string
+  displayName?: string
+  description?: string
+}
+
+/** Open VSX 市场搜索结果项（edrv.lsp.ext.market 载荷元素）。 */
+export interface LspMarketItem {
+  namespace: string
+  name: string
+  id: string
+  version: string
+  displayName?: string
+  description?: string
+  download?: string
+}
+
+/** 有更新的已装扩展（edrv.lsp.ext.updates 载荷元素）。 */
+export interface LspExtUpdate {
+  id: string
+  current: string
+  latest: string
+  displayName?: string
+}

package/src/shared/rpc.ts

@@ -14,6 +14,7 @@ import type {
 } from './types.js'
 import type { MpcConfig, MpcProject, MpcProjectSaveInput, MpcServer } from './mcp.js'
 import type { CompatReport, DevFormInfo } from './compat.js'
+import type { LspExtInfo, LspExtUpdate, LspHover, LspLocation, LspMarketItem, LspPosition, LspServerStatus, LspSymbol } from './lsp.js'
 
 /** webServer 精确路由。 */
 export const RPC_PATH = '/edrv/rpc'
@@ -134,6 +135,22 @@ export interface RpcRequestMap {
   'vscode.devFormGet': {}
   'vscode.devFormSet': { enabled: boolean; path?: string }
   'compat': {}
+  'edrv.lsp.status': { sessionId?: string }
+  '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 }
+  'edrv.lsp.references': { sessionId?: string; path: string; position: LspPosition; includeDeclaration?: boolean }
+  'edrv.lsp.documentSymbol': { sessionId?: string; path: string }
+  'edrv.lsp.workspaceSymbol': { sessionId?: string; query: string }
+  'edrv.lsp.hover': { sessionId?: string; path: string; position: LspPosition }
+  'edrv.lsp.configGet': {}
+  'edrv.lsp.configUpdate': { languageId: string; enabled?: boolean; command?: string; path?: string }
+  'edrv.lsp.ext.list': {}
+  'edrv.lsp.ext.install': { vsixPath?: string; namespace?: string; name?: string; version?: string }
+  'edrv.lsp.ext.uninstall': { id: string }
+  'edrv.lsp.ext.update': { id: string }
+  'edrv.lsp.ext.updates': {}
+  'edrv.lsp.ext.market': { query: string; size?: number }
   'edrv.perf.inventory': { sessionId?: string }
   'edrv.perf.sessionSize': { sessionId?: string; cwd: string }
   'edrv.perf.movePlan': { workspaceKey?: string; sessionIds?: string[]; minBytes?: number; olderThanDays?: number }
@@ -180,6 +197,22 @@ export interface RpcOkMap {
   'vscode.devFormGet': { devForm: DevFormInfo }
   'vscode.devFormSet': { devForm: DevFormInfo; restart: boolean }
   'compat': { report: CompatReport }
+  'edrv.lsp.status': { servers: LspServerStatus[] }
+  'edrv.lsp.sync': object
+  'edrv.lsp.close': object
+  'edrv.lsp.definition': { locations: LspLocation[]; truncated?: boolean }
+  'edrv.lsp.references': { locations: LspLocation[]; truncated?: boolean }
+  'edrv.lsp.documentSymbol': { symbols: LspSymbol[] }
+  'edrv.lsp.workspaceSymbol': { symbols: LspSymbol[]; truncated?: boolean }
+  'edrv.lsp.hover': { hover?: LspHover }
+  'edrv.lsp.configGet': { config: Record<string, unknown> }
+  'edrv.lsp.configUpdate': { config: Record<string, unknown> }
+  'edrv.lsp.ext.list': { extensions: LspExtInfo[] }
+  'edrv.lsp.ext.install': { extension: LspExtInfo; updated?: boolean }
+  'edrv.lsp.ext.uninstall': object
+  'edrv.lsp.ext.update': { extension: LspExtInfo; updated: boolean }
+  'edrv.lsp.ext.updates': { updates: LspExtUpdate[] }
+  'edrv.lsp.ext.market': { extensions: LspMarketItem[] }
   'edrv.perf.inventory': { workspaces: PerfWorkspace[]; sessions: PerfSession[]; totals: PerfTotals; activeIds: string[] }
   'edrv.perf.sessionSize': { bytes: number; exists: boolean }
   'edrv.perf.movePlan': { items: PerfMoveItem[]; reclaimedBytes: number }