dsh-vscode-mode 0.1.30 → 0.1.35

package/src/client/ui/PerfSettings.ts

@@ -0,0 +1,242 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — PerfSettings：「性能优化」设置子页（会话卫生 + 压缩调优）。
+ * - 会话盘点：全工作区/每会话体积、活跃标记，按体积排序；
+ * - 移出到归档（先规划→确认→执行→可恢复）与归档清除；
+ * - DSH 内置压缩调优：写 profile patch（compaction-basic / tool-result-pruner 更低阈值，
+ *   带备份与撤销，需重启生效）；
+ * - 侧车摘要用法提示（agent/脚本取关键字段，不整份读 .dsh-edit-review.json）。
+ * 作者 ddj 2026-09-02
+ */
+import React from 'react'
+import { rpc } from '../rpc.js'
+import '../styles/mcp.css'
+
+/** 字节数人类可读。 */
+function formatBytes(n) {
+  if (!n) return '0B'
+  if (n >= 1024 * 1024) return (n / (1024 * 1024)).toFixed(1) + 'MB'
+  if (n >= 1024) return (n / 1024).toFixed(0) + 'KB'
+  return n + 'B'
+}
+
+/** 会话行 key：workspaceKey \u0000 sessionId。 */
+const keyOf = (ws, id) => ws + '\u0000' + id
+
+/** 单行会话。 */
+function SessionRow({ row, checked, disabled, onToggle }) {
+  const age = Math.max(0, (Date.now() - row.mtime) / (24 * 3600 * 1000))
+  const when = age < 1 ? Math.round(age * 24) + 'h' : Math.round(age) + 'd'
+  return React.createElement('label', { className: 'vsm-perf-row' },
+    React.createElement('input', { type: 'checkbox', checked, disabled, onChange: onToggle }),
+    React.createElement('span', { className: 'vsm-perf-cell vsm-perf-id', title: row.sessionId }, row.sessionId),
+    React.createElement('span', { className: 'vsm-perf-cell vsm-perf-size ' + (row.bytes >= 1024 * 1024 ? 'big' : '') }, formatBytes(row.bytes)),
+    React.createElement('span', { className: 'vsm-perf-cell vsm-perf-mtime', title: new Date(row.mtime).toLocaleString() }, when),
+    row.active ? React.createElement('span', { className: 'vsm-perf-cell vsm-perf-active' }, '活跃') : null,
+  )
+}
+
+/**
+ * 会话卫生 + 压缩调优设置子页。
+ * @author ddj 2026年09月02号
+ */
+export function PerfSettings() {
+  const [inv, setInv] = React.useState(null)
+  const [error, setError] = React.useState('')
+  const [busy, setBusy] = React.useState('')
+  const [selected, setSelected] = React.useState({})
+  const [confirm, setConfirm] = React.useState(null)
+  const [moved, setMoved] = React.useState(null)
+  const [config, setConfig] = React.useState(null)
+
+  const load = React.useCallback(() => {
+    setError('')
+    Promise.all([rpc('edrv.perf.inventory', {}), rpc('edrv.perf.configGet', {})]).then(([i, c]) => {
+      if (!i.ok) throw new Error(i.error)
+      if (!c.ok) throw new Error(c.error)
+      setInv(i)
+      setConfig(c)
+    }).catch((e) => setError(String(e)))
+  }, [])
+
+  React.useEffect(load, [load])
+
+  const action = (id, method, args, patch) => {
+    setBusy(id)
+    setError('')
+    return rpc(method, args).then((res) => {
+      if (!res.ok) throw new Error(res.error)
+      if (patch) patch(res)
+      return res
+    }).catch((e) => setError(String(e))).finally(() => setBusy(''))
+  }
+
+  /** 圈选 ≥ 1MB 的非活跃会话。 */
+  const selectBig = () => {
+    if (!inv) return
+    const next = {}
+    for (const s of inv.sessions) {
+      if (s.bytes >= 1024 * 1024 && !s.active) next[keyOf(s.workspaceKey, s.sessionId)] = true
+    }
+    setSelected(next)
+  }
+
+  /** 清空选择。 */
+  const clearSel = () => setSelected({})
+
+  /** 规划移出所选（跨工作区按 sessionIds 一次规划）。 */
+  const planMove = () => {
+    const sessionIds = Object.keys(selected).map((k) => k.slice(k.indexOf('\u0000') + 1))
+    if (!sessionIds.length) return
+    action('plan', 'edrv.perf.movePlan', { sessionIds }).then((res) => {
+      if (res.items?.length) setConfirm(res)
+      else setError('所选会话没有可移出的项（活跃会话已排除）')
+    })
+  }
+
+  /** 确认移出：按工作区分组逐组执行，成功后刷新并记录可恢复项。 */
+  const doMove = () => {
+    const grouped = {}
+    for (const item of confirm.items) {
+      const list = grouped[item.workspaceKey] ?? (grouped[item.workspaceKey] = [])
+      list.push(item.sessionId)
+    }
+    const jobs = Object.entries(grouped).map(([ws, sessionIds]) => rpc('edrv.perf.moveOut', { workspaceKey: ws, sessionIds }))
+    Promise.all(jobs).then((results) => {
+      const allMoved = []
+      const failures = []
+      for (const res of results) {
+        if (!res.ok) { failures.push(res.error); continue }
+        allMoved.push(...(res.moved ?? []))
+        failures.push(...(res.failures ?? []).map((f) => f.sessionId + ': ' + f.error))
+      }
+      setMoved({ moved: allMoved, failures, reclaimedBytes: allMoved.reduce((s, i) => s + i.bytes, 0) })
+      setConfirm(null)
+      setSelected({})
+      load()
+    }).catch((e) => setError(String(e)))
+  }
+
+  /** 恢复单个已移出会话。 */
+  const doRestore = (item) => {
+    action('restore', 'edrv.perf.restore', { workspaceKey: item.workspaceKey, sessionId: item.sessionId }).then(() => {
+      setMoved((old) => old ? { ...old, moved: old.moved.filter((m) => !(m.workspaceKey === item.workspaceKey && m.sessionId === item.sessionId)) } : old)
+      load()
+    })
+  }
+
+  /** 清除归档区早于 N 天的会话（破坏性）。 */
+  const doPurge = () => {
+    if (!window.confirm('确认永久删除归档区中 30 天前的会话？此操作不可恢复（仅归档区，不影响当前 sessions）。')) return
+    action('purge', 'edrv.perf.purgeArchive', { olderThanDays: 30 }).then((res) => {
+      setError('已清除 ' + (res.removed ?? 0) + ' 个归档会话，释放 ' + formatBytes(res.reclaimedBytes ?? 0))
+    })
+  }
+
+  /** 应用压缩调优到 profile patch。 */
+  const applyConfig = () => {
+    action('apply', 'edrv.perf.configApply', {}).then((res) => {
+      setError('已写入压缩调优配置（备份 ' + res.backup + '），重启 DSH 后生效')
+      load()
+    })
+  }
+
+  /** 撤销压缩调优。 */
+  const undoConfig = () => {
+    action('undo', 'edrv.perf.configUndo', {}).then(() => {
+      setError('已撤销压缩调优配置（恢复备份）')
+      load()
+    })
+  }
+
+  const totals = inv?.totals
+  const summaryCards = totals ? React.createElement('div', { className: 'vsm-perf-cards' },
+    React.createElement('div', { className: 'vsm-perf-card' }, React.createElement('span', null, '工作区'), React.createElement('b', null, String(totals.workspaces))),
+    React.createElement('div', { className: 'vsm-perf-card' }, React.createElement('span', null, '会话数'), React.createElement('b', null, String(totals.sessions))),
+    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' }, '无会话'),
+      ),
+    )
+  }) : null
+
+  const selCount = Object.keys(selected).length
+  const confirmBody = confirm ? React.createElement('div', { className: 'vsm-perf-modal' },
+    React.createElement('div', { className: 'vsm-perf-modal-card' },
+      React.createElement('h3', null, '确认移出 ' + confirm.items.length + ' 个会话？'),
+      React.createElement('p', { className: 'vsm-perf-modal-note' }, '将从 ~/.dsh/sessions 移出到 ~/.dsh/sessions-archive（可逆，重启后不再回放，释放 ' + formatBytes(confirm.reclaimedBytes) + '）。活跃会话已排除。'),
+      React.createElement('ul', { className: 'vsm-perf-modal-list' }, confirm.items.slice(0, 20).map((item) => React.createElement('li', { key: item.workspaceKey + item.sessionId }, item.workspaceKey + ' / ' + item.sessionId + '（' + formatBytes(item.bytes) + '）'))),
+      confirm.items.length > 20 ? React.createElement('div', { className: 'vsm-perf-modal-more' }, '…等 ' + confirm.items.length + ' 个') : null,
+      React.createElement('div', { className: 'vsm-perf-modal-actions' },
+        React.createElement('button', { className: 'vsm-primary', onClick: doMove, disabled: busy === 'move' }, busy === 'move' ? '执行中…' : '确认移出'),
+        React.createElement('button', { className: 'vsm-secondary', onClick: () => setConfirm(null) }, '取消'),
+      ),
+    ),
+  ) : null
+
+  const movedBody = moved?.moved?.length ? React.createElement('div', { className: 'vsm-perf-moved' },
+    React.createElement('h3', null, '已移出 ' + moved.moved.length + ' 个会话（释放 ' + formatBytes(moved.reclaimedBytes) + '）'),
+    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 内置压缩调优'),
+    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' },
+      React.createElement('span', { className: 'vsm-perf-cell' }, '状态：' + (config.applied ? '已应用' : '未应用')),
+      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）'),
+    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' },
+    React.createElement('h2', null, '会话性能'),
+    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' }, '⟳ 刷新'),
+    ),
+    workspaceBlocks,
+    movedBody,
+    configBody,
+    guideBody,
+    confirmBody,
+  )
+}

package/src/client/ui/PerfSizeBadge.ts

@@ -0,0 +1,54 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — PerfSizeBadge：对话 header 会话体积指示器。
+ * 5s 轮询当前会话持久化体积（host 仅 stat，近零成本），≥1MB 显示、超阈值变色，
+ * 引导"一次任务一个短会话"：会话过大时建议 /compact 或新开会话。
+ * 作者 ddj 2026-09-02
+ */
+import React from 'react'
+import { rpc } from '../rpc.js'
+
+/** 软阈值：≥ 此值琥珀色（默认 2MB）。 */
+const SOFT = 2 * 1024 * 1024
+/** 硬阈值：≥ 此值红色（默认 8MB）。 */
+const HARD = 8 * 1024 * 1024
+/** 显示下限：≥ 1MB 才显示（太小无提示价值）。 */
+const SHOW_MIN = 1024 * 1024
+
+/**
+ * 会话 header 体积徽章（挂 conversation.session.header.utilities）。
+ * @author ddj 2026年09月02号
+ * @param props { sessionId, sessions }（sessions 供 cwd 解析）
+ */
+export function PerfSizeBadge(props) {
+  const sessionId = props?.sessionId
+  const sessions = props?.sessions
+  const [size, setSize] = React.useState(null)
+  const seq = React.useRef(0)
+
+  const load = React.useCallback(() => {
+    if (!sessionId) return
+    const cwd = sessions?.list?.getSnapshot?.()?.byId?.[sessionId]?.cwd
+    if (!cwd) return
+    const s = ++seq.current
+    rpc('edrv.perf.sessionSize', { sessionId, cwd }).then((res) => {
+      if (s !== seq.current || !res || !res.ok) return
+      setSize(res.exists ? res.bytes : 0)
+    }).catch(() => {})
+  }, [sessionId, sessions])
+
+  React.useEffect(() => {
+    load()
+    const t = setInterval(load, 5000)
+    return () => { clearInterval(t) }
+  }, [load])
+
+  if (!size || size < SHOW_MIN) return null
+  const label = size >= 1024 * 1024 ? (size / (1024 * 1024)).toFixed(1) + 'MB' : Math.round(size / 1024) + 'KB'
+  const color = size >= HARD ? '#dc2626' : size >= SOFT ? '#d97706' : 'var(--dsw-text-3,#6b7280)'
+  const tip = '当前会话已持久化 ' + label + '（启动回放约放大 10×，占内存）。过大建议 /compact 或新开会话。'
+  return React.createElement('span', {
+    style: { display: 'inline-flex', alignItems: 'center', height: 30, padding: '0 8px', fontSize: 11, color, borderRadius: 6, cursor: 'default', whiteSpace: 'nowrap', gap: 4, lineHeight: '30px' },
+    title: tip,
+  }, '会话 ' + label)
+}

package/src/compat.ts

@@ -14,6 +14,9 @@ import { loadSettingsDeps } from './fileOpenSettings.js'
 import { readDevForm } from './devForm.js'
 import type { CompatAdapter, CompatReport } from './shared/compat.js'
 import type { Ctx } from './store.js'
+import { ROUTE_PREFIX } from './paths.js'
+
+export { ROUTE_PREFIX }
 
 export const PLUGIN_NAME = 'dsh-vscode-mode'
 export const MCP_PACKAGE = '@deepseek-ai/dsh-mcp-client'
@@ -21,8 +24,6 @@ export const MCP_PACKAGE = '@deepseek-ai/dsh-mcp-client'
 export const PROJECT_ENTRY_PREFIX = 'vsm-mcp.'
 /** 旧版项目 MCP 条目前缀（升级残留识别，不显示为全局 MCP）。 */
 export const LEGACY_PROJECT_PREFIX = 'vsm-mcp:'
-/** webServer 路由前缀（RPC 精确路由 + 静态资源前缀共用）。 */
-export const ROUTE_PREFIX = '/edrv'
 
 /** 判断新旧格式项目 MCP 条目 id（旧残留不被视为全局 MCP）。 */
 export function isProjectEntryId(id: string): boolean {

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

@@ -15,7 +15,14 @@ import { installIsolation } from './mcpIsolation.js'
 import { dropFileIndex } from './workspace.js'
 import { cwdOf } from './registry.js'
 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'
 
@@ -32,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)
@@ -47,14 +60,24 @@ export function apply(ctx: Ctx, config?: unknown): void {
       dropFileIndex(cwd)
       searcher.dispose(cwd)
       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
+}