dsh-vscode-mode 0.1.32 → 0.1.36

package/src/client/ui/PerfSettings.ts

@@ -10,6 +10,7 @@
  */
 import React from 'react'
 import { rpc } from '../rpc.js'
+import { foldLoad, foldSave, normalizeFoldKey } from '../state/workspaceFoldCache.js'
 import '../styles/mcp.css'
 
 /** 字节数人类可读。 */
@@ -23,6 +24,39 @@ function formatBytes(n) {
 /** 会话行 key：workspaceKey \u0000 sessionId。 */
 const keyOf = (ws, id) => ws + '\u0000' + id
 
+/** 工作区列表每页条数。 */
+const PAGE_SIZE = 7
+
+/**
+ * 计算分页（纯函数，可单测）。
+ * 作者 ddj 2026年09月02号
+ * @param total 总条数
+ * @param pageSize 每页条数
+ * @param page 当前页码（1 起）
+ * @returns 归一化后的分页信息（page 被夹到有效范围）
+ */
+export function paginate(total, pageSize, page) {
+  const size = Math.max(1, Math.floor(pageSize) || 1)
+  const pages = Math.max(1, Math.ceil(total / size))
+  const current = Math.min(Math.max(1, Math.floor(page) || 1), pages)
+  const start = (current - 1) * size
+  return { page: current, pages, pageSize: size, start, end: Math.min(start + size, total), total }
+}
+
+/**
+ * 取当前页切片（纯函数，可单测）。
+ * 作者 ddj 2026年09月02号
+ * @param items 全量列表
+ * @param page 当前页码（1 起）
+ * @param pageSize 每页条数
+ * @returns 当前页子数组
+ */
+export function pageSlice(items, page, pageSize) {
+  const list = items ?? []
+  const { start, end } = paginate(list.length, pageSize, page)
+  return list.slice(start, end)
+}
+
 /** 单行会话。 */
 function SessionRow({ row, checked, disabled, onToggle }) {
   const age = Math.max(0, (Date.now() - row.mtime) / (24 * 3600 * 1000))
@@ -36,6 +70,56 @@ function SessionRow({ row, checked, disabled, onToggle }) {
   )
 }
 
+/**
+ * 工作区列表分页器：顶部文案 + 上一页/下一页交互。
+ * 作者 ddj 2026年09月02号
+ * @param {object} info paginate() 的分页信息
+ * @param {Function} onPrev 上一页回调
+ * @param {Function} onNext 下一页回调
+ */
+function WorkspacePager({ info, onPrev, onNext }) {
+  const { page, pages, start, end, total } = info
+  return React.createElement('div', { className: 'vsm-perf-pager' },
+    React.createElement('span', { className: 'vsm-perf-pager-text' },
+      total ? `第 ${start + 1}–${end} 个 / 共 ${total} 个工作区（第 ${page}/${pages} 页）` : '暂无工作区',
+    ),
+    React.createElement('div', { className: 'vsm-perf-pager-actions' },
+      React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: onPrev, disabled: page <= 1 }, '‹ 上一页'),
+      React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: onNext, disabled: page >= pages }, '下一页 ›'),
+    ),
+  )
+}
+
+/**
+ * 工作区栏目（可展开/折叠），内含该工作区的会话行。
+ * 作者 ddj 2026年09月02号
+ * @param {object} ws 工作区汇总（workspaceKey / totalBytes）
+ * @param {object[]} rows 该工作区的会话行
+ * @param {boolean} expanded 是否展开
+ * @param {Function} onToggleFold 展开/折叠切换回调
+ * @param {object} selected 已选会话键集合
+ * @param {boolean} locked 会话勾选是否禁用（移出执行中）
+ * @param {Function} onToggleRow 单行勾选回调
+ */
+function WorkspaceBlock({ ws, rows, expanded, onToggleFold, selected, locked, onToggleRow }) {
+  const head = React.createElement('div', { className: 'vsm-perf-ws-head', role: 'button', tabIndex: 0, 'aria-expanded': expanded, onClick: onToggleFold, onKeyDown: (event) => {
+    if (event.key === 'Enter' || event.key === ' ') { event.preventDefault(); onToggleFold() }
+  } },
+    React.createElement('span', { className: 'vsm-perf-ws-caret ' + (expanded ? 'open' : '') }, '▸'),
+    React.createElement('span', { className: 'vsm-perf-ws-name', title: ws.workspaceKey }, ws.workspaceKey),
+    React.createElement('span', { className: 'vsm-perf-ws-meta' }, rows.length + ' 会话 · ' + formatBytes(ws.totalBytes)),
+  )
+  if (!expanded) return React.createElement('div', { className: 'vsm-perf-ws' }, head)
+  const body = rows.length ? rows.map((row) => React.createElement(SessionRow, {
+    key: keyOf(row.workspaceKey, row.sessionId),
+    row,
+    checked: !!selected[keyOf(row.workspaceKey, row.sessionId)],
+    disabled: row.active || locked,
+    onToggle: () => onToggleRow(keyOf(row.workspaceKey, row.sessionId)),
+  })) : React.createElement('div', { className: 'vsm-mcp-empty' }, '无会话')
+  return React.createElement('div', { className: 'vsm-perf-ws expanded' }, head, React.createElement('div', { className: 'vsm-perf-rows' }, body))
+}
+
 /**
  * 会话卫生 + 压缩调优设置子页。
  * @author ddj 2026年09月02号
@@ -48,6 +132,23 @@ export function PerfSettings() {
   const [confirm, setConfirm] = React.useState(null)
   const [moved, setMoved] = React.useState(null)
   const [config, setConfig] = React.useState(null)
+  const [expanded, setExpanded] = React.useState(() => foldLoad())
+  const [page, setPage] = React.useState(1)
+
+  React.useEffect(() => { foldSave(expanded) }, [expanded])
+
+  /** 数据变化后把越界页码夹回有效范围。 */
+  const workspaces = inv?.workspaces ?? []
+  const pageInfo = paginate(workspaces.length, PAGE_SIZE, page)
+  React.useEffect(() => {
+    if (page !== pageInfo.page) setPage(pageInfo.page)
+  }, [page, pageInfo.page])
+
+  /** 切换某工作区栏目的展开/折叠（默认全折叠）。 */
+  const toggleFold = (key) => setExpanded((old) => old.includes(key) ? old.filter((item) => item !== key) : old.concat(key))
+
+  /** 切换单会话勾选。 */
+  const toggleRow = (k) => setSelected((old) => { const next = { ...old }; if (next[k]) delete next[k]; else next[k] = true; return next })
 
   const load = React.useCallback(() => {
     setError('')
@@ -156,27 +257,25 @@ export function PerfSettings() {
     React.createElement('div', { className: 'vsm-perf-card' }, React.createElement('span', null, '压缩态总体积'), React.createElement('b', { className: totals.totalBytes >= 50 * 1024 * 1024 ? 'big' : '' }, formatBytes(totals.totalBytes))),
   ) : null
 
-  const workspaceBlocks = inv?.workspaces ? inv.workspaces.map((ws) => {
-    const rows = inv.sessions.filter((s) => s.workspaceKey === ws.workspaceKey)
-    return React.createElement('div', { key: ws.workspaceKey, className: 'vsm-perf-ws' },
-      React.createElement('div', { className: 'vsm-perf-ws-head' },
-        React.createElement('span', { className: 'vsm-perf-ws-name', title: ws.workspaceKey }, ws.workspaceKey),
-        React.createElement('span', { className: 'vsm-perf-ws-meta' }, rows.length + ' 会话 · ' + formatBytes(ws.totalBytes)),
-      ),
-      React.createElement('div', { className: 'vsm-perf-rows' },
-        rows.length ? rows.map((row) => React.createElement(SessionRow, {
-          key: keyOf(row.workspaceKey, row.sessionId),
-          row,
-          checked: !!selected[keyOf(row.workspaceKey, row.sessionId)],
-          disabled: row.active || busy === 'move',
-          onToggle: () => {
-            const k = keyOf(row.workspaceKey, row.sessionId)
-            setSelected((old) => { const next = { ...old }; if (next[k]) delete next[k]; else next[k] = true; return next })
-          },
-        })) : React.createElement('div', { className: 'vsm-mcp-empty' }, '无会话'),
-      ),
-    )
+  const visible = pageSlice(workspaces, pageInfo.page, PAGE_SIZE)
+  const workspacePager = workspaces.length > PAGE_SIZE ? React.createElement(WorkspacePager, {
+    info: pageInfo,
+    onPrev: () => setPage((old) => Math.max(1, old - 1)),
+    onNext: () => setPage((old) => Math.min(pageInfo.pages, old + 1)),
   }) : null
+  const workspaceBlocks = workspaces.length ? React.createElement('div', { className: 'vsm-perf-ws-list' }, visible.map((ws) => {
+    const key = normalizeFoldKey(ws.workspaceKey)
+    return React.createElement(WorkspaceBlock, {
+      key: ws.workspaceKey,
+      ws,
+      rows: inv.sessions.filter((s) => s.workspaceKey === ws.workspaceKey),
+      expanded: expanded.includes(key),
+      onToggleFold: () => toggleFold(key),
+      selected,
+      locked: busy === 'move',
+      onToggleRow: toggleRow,
+    })
+  })) : null
 
   const selCount = Object.keys(selected).length
   const confirmBody = confirm ? React.createElement('div', { className: 'vsm-perf-modal' },
@@ -192,18 +291,21 @@ export function PerfSettings() {
     ),
   ) : null
 
-  const movedBody = moved?.moved?.length ? React.createElement('div', { className: 'vsm-perf-moved' },
-    React.createElement('h3', null, '已移出 ' + moved.moved.length + ' 个会话（释放 ' + formatBytes(moved.reclaimedBytes) + '）'),
+  const movedBody = moved?.moved?.length ? React.createElement('section', { className: 'vsm-panel' },
+    React.createElement('h3', { className: 'vsm-panel-title' }, '已移出 ' + moved.moved.length + ' 个会话（释放 ' + formatBytes(moved.reclaimedBytes) + '）'),
+    React.createElement('div', { className: 'vsm-panel-body' },
     React.createElement('div', { className: 'vsm-perf-rows' }, moved.moved.map((item) => React.createElement('div', { key: item.workspaceKey + item.sessionId, className: 'vsm-perf-row' },
       React.createElement('span', { className: 'vsm-perf-cell vsm-perf-id' }, item.sessionId),
       React.createElement('span', { className: 'vsm-perf-cell vsm-perf-size' }, formatBytes(item.bytes)),
       React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: () => doRestore(item), disabled: busy === 'restore' }, '恢复'),
     ))),
     moved.failures?.length ? React.createElement('div', { className: 'vsm-mcp-error vsm-mcp-banner' }, '失败：' + moved.failures.join('；')) : null,
+    ),
   ) : null
 
-  const configBody = config ? React.createElement('div', { className: 'vsm-perf-config' },
-    React.createElement('h3', null, 'DSH 内置压缩调优'),
+  const configBody = config ? React.createElement('section', { className: 'vsm-panel' },
+    React.createElement('h3', { className: 'vsm-panel-title' }, 'DSH 内置压缩调优'),
+    React.createElement('div', { className: 'vsm-panel-body' },
     React.createElement('p', null, '调低 compaction-basic / tool-result-pruner 触发阈值，让长循环会话更早压缩，降低模型可见上下文压力（减少 token 与防 context overflow）。'),
     React.createElement('p', { className: 'vsm-perf-note' }, '注意：压缩只追加 compaction 事件，不重写已持久化会话日志（append-only），因此不会缩小已存在的会话文件——存量瘦身请用上方「移出到归档」。packChunks 已默认开启，无需配置。'),
     React.createElement('div', { className: 'vsm-perf-config-state' },
@@ -211,13 +313,16 @@ export function PerfSettings() {
       config.applied ? React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: undoConfig, disabled: busy === 'undo' }, '撤销') : React.createElement('button', { className: 'vsm-primary vsm-small', onClick: applyConfig, disabled: busy === 'apply' }, '应用建议配置（需重启）'),
     ),
     React.createElement('pre', { className: 'vsm-perf-block' }, config.block),
+    ),
   ) : null
 
-  const guideBody = React.createElement('div', { className: 'vsm-perf-guide' },
-    React.createElement('h3', null, '侧车摘要（agent/脚本取关键字段，不整份读 sidecar）'),
+  const guideBody = React.createElement('section', { className: 'vsm-panel' },
+    React.createElement('h3', { className: 'vsm-panel-title' }, '侧车摘要（agent/脚本取关键字段，不整份读 sidecar）'),
+    React.createElement('div', { className: 'vsm-panel-body' },
     React.createElement('p', null, '工作区根目录的 .dsh-edit-review.json（可能数 MB）只应通过摘要接口读取，禁止 agent 整份 read/write 进对话：'),
     React.createElement('pre', { className: 'vsm-perf-block' },
       "curl -s -X POST http://127.0.0.1:3080/edrv/rpc -H 'content-type: application/json' -d '{\"method\":\"edrv.perf.sidecarSummary\",\"args\":{}}'\n# 差异记录列表（含每文件 pending 摘要）：edrv.list\n# 历史归档：edrv.archiveList / edrv.archiveRead"),
+    ),
   )
 
   return React.createElement('section', { className: 'vsm-perf-page' },
@@ -225,15 +330,21 @@ export function PerfSettings() {
     React.createElement('p', null, 'DSH 启动会回放 ~/.dsh/sessions 全部会话（V8 展开约 10×），体积越大内存越吃紧。定期把巨型/旧会话移出到归档可显著降低启动内存。'),
     error ? React.createElement('div', { className: 'vsm-mcp-error vsm-mcp-banner' }, error) : null,
     summaryCards,
-    React.createElement('div', { className: 'vsm-perf-toolbar' },
-      React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: selectBig }, '圈选 ≥1MB 非活跃'),
-      React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: clearSel, disabled: !selCount }, '清空选择'),
-      React.createElement('span', { className: 'vsm-perf-selcount' }, '已选 ' + selCount + ' 个'),
-      React.createElement('button', { className: 'vsm-primary vsm-small', onClick: planMove, disabled: !selCount || busy === 'plan' }, busy === 'plan' ? '规划中…' : '移出所选'),
-      React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: doPurge, disabled: busy === 'purge' }, '清除归档(>30天)'),
-      React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: load, disabled: busy === 'load' }, '⟳ 刷新'),
+    React.createElement('section', { className: 'vsm-panel' },
+      React.createElement('h3', { className: 'vsm-panel-title' }, '会话盘点'),
+      React.createElement('div', { className: 'vsm-panel-body' },
+        React.createElement('div', { className: 'vsm-perf-toolbar' },
+          React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: selectBig }, '圈选 ≥1MB 非活跃'),
+          React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: clearSel, disabled: !selCount }, '清空选择'),
+          React.createElement('span', { className: 'vsm-perf-selcount' }, '已选 ' + selCount + ' 个'),
+          React.createElement('button', { className: 'vsm-primary vsm-small', onClick: planMove, disabled: !selCount || busy === 'plan' }, busy === 'plan' ? '规划中…' : '移出所选'),
+          React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: doPurge, disabled: busy === 'purge' }, '清除归档(>30天)'),
+          React.createElement('button', { className: 'vsm-secondary vsm-small', onClick: load, disabled: busy === 'load' }, '⟳ 刷新'),
+        ),
+        workspacePager,
+        workspaceBlocks,
+      ),
     ),
-    workspaceBlocks,
     movedBody,
     configBody,
     guideBody,

package/src/fileOpenSettings.ts

@@ -24,6 +24,7 @@ export interface SettingsDeps {
   z: {
     object: (shape: Record<string, unknown>) => { default: (value: Record<string, unknown>) => unknown }
     string: () => { default: (value: string) => unknown }
+    boolean: () => { default: (value: boolean) => unknown }
   }
 }
 

package/src/index.ts

@@ -18,6 +18,11 @@ import { setupOpenSettings } from './fileOpenSettings.js'
 import { disposeIndex } from './treeIndex.js'
 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 type { RpcHandlerMap } from './shared/rpc.js'
 import type { Registry } from './registry.js'
 import type { Ctx } from './store.js'
 
@@ -34,9 +39,15 @@ export function apply(ctx: Ctx, config?: unknown): void {
   const registry: Registry = new Map()
   const searcher = newSearcher(ctx)
   const contentSearcher = newContentSearcher(ctx)
+  /** LSP 服务器管理器（语言智能：跳转/引用/大纲）。 */
+  const lspManager = createLspManager((line) => ctx.logger?.debug?.('[' + name + '] ' + line))
   /** 兼容性警告收集（route 护栏等写入，启动日志一并输出）。 */
   const warnings: string[] = []
   setupOpenSettings(ctx, config, () => {})
+  void installLspSettingsSection(ctx, {})
+  /** LSP RPC 与会话清理（一次性创建，tracker 状态跨请求保留）。 */
+  const lspRpc = createLspRpc({ ctx, pluginConfig: config, manager: lspManager })
+  const lspHandlers: Partial<RpcHandlerMap> = lspRpc.handlers
 
   ctx.on('tools/result', (exec: unknown, result: unknown) => {
     void captureToolResult(ctx, registry, exec, result)
@@ -51,15 +62,22 @@ export function apply(ctx: Ctx, config?: unknown): void {
       contentSearcher.dispose(cwd)
       disposeIndex(cwd)
     }
+    const sid = (session as { id?: unknown })?.id
+    if (typeof sid === 'string') lspRpc.disposeSession(sid)
   })
 
-  registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher, contentSearcher), (warning) => warnings.push(warning))
+  registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher, contentSearcher, lspHandlers), (warning) => warnings.push(warning))
   installIsolation(ctx)
   // 启动清理缓存目录：非当前 schema / 超保留期 / 未知残留（best-effort，不阻塞装配）
   void sweepTreeCache()
   void logCompatSummary(ctx, warnings)
+  // 卸载/重启时强杀 LSP 子进程（防残留）
+  ctx.effect(() => () => {
+    void lspManager.disposeAll().catch(() => {})
+    disposeAllServers()
+  })
 
-  ctx.logger?.info?.('[' + name + '] 编辑差异审查已装配（/edrv/rpc 路由就绪，项目 MCP 隔离已启用）')
+  ctx.logger?.info?.('[' + name + '] 编辑差异审查已装配（/edrv/rpc 路由就绪，项目 MCP 隔离已启用，语言服务器 LSP 已接入）')
 }
 
 /**

package/src/lsp/client.ts

@@ -0,0 +1,205 @@
+/**
+ * dsh-vscode-mode host — LSP 客户端（JSON-RPC over stdio）。
+ * 职责：请求/通知/握手/超时/服务器端请求处理/生命周期。transport 无关性：
+ * 只依赖 write/onMessage 契约，便于单测时注入假传输。
+ * 作者 ddj 2026-08-27
+ */
+import { createFrameParser, encodeMessage, requestMessage, notifyMessage } from './jsonrpc.js'
+import type { LspServerCapabilities } from '../shared/lsp.js'
+
+export interface LspClientEvents {
+  onReady?: (capabilities: LspServerCapabilities) => void
+  onExit?: (code: number | null, signal: string | null) => void
+  onLog?: (line: string) => void
+  onProgress?: (params: unknown) => void
+}
+
+const DEFAULT_TIMEOUT_MS = 20_000
+
+export class LspError extends Error {
+  code: number
+  constructor(code: number, message: string) {
+    super(message)
+    this.code = code
+  }
+}
+
+export interface LspClientTransport {
+  write(chunk: Buffer): boolean
+  dispose(): void
+  readonly alive: boolean
+  onMessage: ((message: unknown) => void) | null
+  onExit: ((code: number | null, signal: string | null) => void) | null
+}
+
+export interface LspClient {
+  request<T>(method: string, params: unknown, timeoutMs?: number): Promise<T>
+  notify(method: string, params: unknown): void
+  initialize(rootUri: string, workspaceFolders: string[]): Promise<LspServerCapabilities>
+  shutdown(): Promise<void>
+  readonly alive: boolean
+}
+
+/**
+ * 创建 LSP 客户端。
+ * @author ddj 2026年08月27号
+ * @param transport 传输句柄（write/onMessage/alive/dispose）
+ * @param events 事件回调
+ * @returns LSP 客户端
+ */
+export function createLspClient(
+  transport: LspClientTransport,
+  events: LspClientEvents = {},
+): LspClient {
+  let nextId = 1
+  let alive = transport.alive
+  const pending = new Map<number, { resolve: (v: unknown) => void; reject: (e: Error) => void; timer: ReturnType<typeof setTimeout> }>()
+  let serverCapabilities: LspServerCapabilities = { definition: false, references: false, documentSymbol: false, workspaceSymbol: false, hover: false }
+
+  const log = (line: string): void => events.onLog?.(line)
+  const parser = createFrameParser()
+
+  transport.onMessage = (message: unknown): void => {
+    const msg = message as { id?: unknown; method?: unknown; params?: unknown; result?: unknown; error?: unknown }
+    // 服务器端请求/通知带 method（请求还带 id）；响应带 id + result/error、无 method。先判 method 再判 id。
+    if (typeof msg.method === 'string') {
+      if (msg.method === '$/progress') events.onProgress?.(msg.params)
+      void handleServerRequest(msg as { method: string; params?: unknown; id?: unknown })
+      return
+    }
+    if (typeof msg.id === 'number' || typeof msg.id === 'string') {
+      const entry = pending.get(Number(msg.id))
+      if (!entry) return
+      pending.delete(Number(msg.id))
+      clearTimeout(entry.timer)
+      if (msg.error) {
+        const err = msg.error as { code?: number; message?: string }
+        entry.reject(new LspError(err.code ?? -32000, err.message ?? 'LSP error'))
+      } else {
+        entry.resolve(msg.result)
+      }
+    }
+  }
+
+  /** 服务器端请求：消息/日志类打日志，配置/能力类回 result:null，其余回 method not found。 */
+  const handleServerRequest = async (msg: { method: string; params?: unknown; id?: unknown }): Promise<void> => {
+    const { method, params, id } = msg
+    const respond = (payload: Record<string, unknown>): void => {
+      transport.write(encodeMessage(payload))
+    }
+    try {
+      if (method === 'window/logMessage' || method === 'window/showMessage' || method === 'window/showMessageRequest') {
+        const p = params as { type?: number; message?: string }
+        log('[server ' + (p?.type ?? '') + '] ' + String(p?.message ?? ''))
+        if (id !== undefined) respond({ jsonrpc: '2.0', id, result: null })
+        return
+      }
+      if (method === 'workspace/configuration') {
+        const p = params as { items?: unknown[] }
+        const items = Array.isArray(p?.items) ? p.items.map(() => null) : []
+        if (id !== undefined) respond({ jsonrpc: '2.0', id, result: items })
+        return
+      }
+      // 客户端能力协商类：标准行为是确认（result:null），否则部分服务器（如 LuaLS）会中断工作区初始化
+      if (method === 'window/workDoneProgress/create' || method === 'client/registerCapability' || method === 'workspace/workspaceFolders') {
+        if (id !== undefined) respond({ jsonrpc: '2.0', id, result: null })
+        return
+      }
+      if (id !== undefined) {
+        respond({ jsonrpc: '2.0', id, error: { code: -32601, message: 'Method not found: ' + method } })
+      }
+    } catch (error) {
+      log('server request handler error: ' + String(error))
+      if (id !== undefined) {
+        respond({ jsonrpc: '2.0', id, error: { code: -32603, message: String(error) } })
+      }
+    }
+  }
+
+  const transportExit = transport.onExit
+  transport.onExit = (code, signal): void => {
+    alive = false
+    for (const entry of pending.values()) {
+      clearTimeout(entry.timer)
+      entry.reject(new Error('LSP 服务器已退出（' + String(code) + '/' + String(signal) + '）'))
+    }
+    pending.clear()
+    events.onExit?.(code, signal)
+    transportExit?.(code, signal)
+  }
+
+  const client: LspClient = {
+    async request<T>(method: string, params: unknown, timeoutMs = DEFAULT_TIMEOUT_MS): Promise<T> {
+      if (!alive) throw new Error('LSP 服务器未运行')
+      const id = nextId++
+      return new Promise<T>((resolve, reject) => {
+        const timer = setTimeout(() => {
+          pending.delete(id)
+          reject(new Error('LSP 请求超时：' + method + '（' + timeoutMs + 'ms）'))
+        }, timeoutMs)
+        pending.set(id, { resolve: resolve as (v: unknown) => void, reject, timer })
+        transport.write(encodeMessage(requestMessage(id, method, params)))
+      })
+    },
+    notify(method: string, params: unknown): void {
+      if (!alive) return
+      transport.write(encodeMessage(notifyMessage(method, params)))
+    },
+    async initialize(rootUri: string, workspaceFolders: string[]): Promise<LspServerCapabilities> {
+      const init = await client.request<{
+        capabilities?: {
+          definitionProvider?: unknown
+          referencesProvider?: unknown
+          documentSymbolProvider?: unknown
+          workspaceSymbolProvider?: unknown
+          hoverProvider?: unknown
+        }
+      }>('initialize', {
+        processId: process.pid,
+        rootUri: rootUri || null,
+        rootPath: null,
+        workspaceFolders: workspaceFolders.length
+          ? workspaceFolders.map((uri) => ({ uri, name: uri }))
+          : null,
+        capabilities: {
+          window: { workDoneProgress: true },
+          workspace: { configuration: true },
+          textDocument: {
+            synchronization: { dynamicRegistration: false, willSave: false, didSave: true },
+            definition: { dynamicRegistration: false },
+            references: { dynamicRegistration: false },
+            documentSymbol: { dynamicRegistration: false },
+            hover: { dynamicRegistration: false },
+          },
+        },
+      })
+      const caps = init?.capabilities ?? {}
+      serverCapabilities = {
+        definition: Boolean(caps.definitionProvider),
+        references: Boolean(caps.referencesProvider),
+        documentSymbol: Boolean(caps.documentSymbolProvider),
+        workspaceSymbol: Boolean(caps.workspaceSymbolProvider),
+        hover: Boolean(caps.hoverProvider),
+      }
+      client.notify('initialized', {})
+      events.onReady?.(serverCapabilities)
+      return serverCapabilities
+    },
+    async shutdown(): Promise<void> {
+      try {
+        await client.request<unknown>('shutdown', null, 3000)
+      } catch (error) {
+        log('shutdown: ' + String(error))
+      }
+      try {
+        client.notify('exit', null)
+      } catch (error) {
+        log('exit: ' + String(error))
+      }
+    },
+    get alive() {
+      return alive
+    },
+  }
+  return client
+}

package/src/lsp/config.ts

@@ -0,0 +1,107 @@
+/**
+ * dsh-vscode-mode host — LSP 配置读取与 provider 解析装配。
+ * 配置来源优先级：settings 持久化（ns dsh-vscode-mode.languageServers）> 插件组合配置 > 默认。
+ * 作者 ddj 2026-08-27
+ */
+import type { Ctx } from '../store.js'
+import { PROVIDER_RESOLVERS, type LspProviderSpec } from './providers.js'
+
+/** 单语言配置。 */
+export interface LspLangConfig {
+  enabled?: boolean
+  command?: string
+  path?: string
+}
+
+/** LSP 配置（按语言）。 */
+export interface LspConfig {
+  lua?: LspLangConfig
+  csharp?: LspLangConfig
+  [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 {
+  if (!raw || typeof raw !== 'object') return undefined
+  const obj = raw as Record<string, unknown>
+  const out: LspLangConfig = {}
+  if (typeof obj.enabled === 'boolean') out.enabled = obj.enabled
+  if (typeof obj.command === 'string') out.command = obj.command
+  if (typeof obj.path === 'string') out.path = obj.path
+  return out
+}
+
+/** 从插件组合配置读取。 */
+export function configFromPlugin(config: unknown): LspConfig {
+  const raw = (config as { languageServers?: unknown } | undefined)?.languageServers
+  if (!raw || typeof raw !== 'object') return {}
+  const out: LspConfig = {}
+  for (const lang of LSP_LANGUAGES) {
+    const v = sanitizeLang((raw as Record<string, unknown>)[lang])
+    if (v) out[lang] = v
+  }
+  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 覆盖插件配置。 */
+export function mergeConfig(a: LspConfig, b: LspConfig): LspConfig {
+  const out: LspConfig = { ...a }
+  for (const lang of LSP_LANGUAGES) {
+    const av = a[lang]
+    const bv = b[lang]
+    if (bv) out[lang] = { ...av, ...bv }
+    else if (av) out[lang] = av
+  }
+  return out
+}
+
+/**
+ * 解析某语言的 provider spec（合并配置后）。
+ * @author ddj 2026年08月27号
+ * @param ctx DSH 上下文
+ * @param pluginConfig 插件组合配置
+ * @param languageId 语言 id
+ * @returns provider 规格
+ */
+export function resolveProviderSpec(ctx: Ctx, pluginConfig: unknown, languageId: string): 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 lang = merged[languageId]
+  if (lang && lang.enabled === false) {
+    return { languageId, kind: 'none', argv: [], ready: false, reason: '已在设置中禁用' }
+  }
+  return resolver({ command: lang?.command, path: lang?.path })
+}
+
+/** 语言 → 扩展名（供客户端判断是否触发 LSP）。 */
+export function langOfPath(path: string): string | null {
+  const base = String(path || '').split(/[\\/]/).pop() || ''
+  const dot = base.lastIndexOf('.')
+  if (dot <= 0) return null
+  const ext = base.slice(dot + 1).toLowerCase()
+  for (const [lang, exts] of Object.entries({ lua: ['lua'], csharp: ['cs', 'csx'] })) {
+    if (exts.includes(ext)) return lang
+  }
+  return null
+}