dsh-vscode-mode 0.1.32 → 0.1.35

package/lib/index.js

@@ -1,10 +1,12 @@
 import { createRequire } from "node:module";
 import { mkdir, readFile, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
 import { basename, dirname, extname, join, normalize, resolve, sep } from "node:path";
-import { existsSync, readFileSync, readdirSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, symlinkSync, writeFileSync } from "node:fs";
+import { fileURLToPath, pathToFileURL } from "node:url";
 import { homedir } from "node:os";
 import { createHash } from "node:crypto";
+import { spawn } from "node:child_process";
+import { inflateRawSync } from "node:zlib";
 //#region src/mcp.ts
 /**
 * dsh-vscode-mode host — MCP 运行时管理适配层。
@@ -2178,7 +2180,7 @@ function pathMatch(value, query) {
 * 作者 ddj 2026年08月24号
 */
 const STDOUT_CAP$1 = 4 << 20;
-const STDERR_CAP$1 = 65536;
+const STDERR_CAP$2 = 65536;
 const GRACE_MS$1 = 2e4;
 /** 默认排除目录（文件/内容搜索共用，导出供 provider 复用）。 */
 const EXCLUDES = [
@@ -2359,7 +2361,7 @@ async function searchRipgrep(input) {
 		stdio: {
 			stdin: "ignore",
 			stdout: { maxBytes: STDOUT_CAP$1 },
-			stderr: { maxBytes: STDERR_CAP$1 }
+			stderr: { maxBytes: STDERR_CAP$2 }
 		},
 		graceMs: GRACE_MS$1,
 		signal: input.signal
@@ -2824,7 +2826,7 @@ function newSearcher(ctx) {
 //#endregion
 //#region src/search/content.ts
 const STDOUT_CAP = 16 << 20;
-const STDERR_CAP = 65536;
+const STDERR_CAP$1 = 65536;
 const GRACE_MS = 2e4;
 const DEFAULT_MAX_MATCHES = 500;
 const DEFAULT_MAX_FILES = 100;
@@ -2986,7 +2988,7 @@ async function searchRipgrepContent(input) {
 		stdio: {
 			stdin: "ignore",
 			stdout: { maxBytes: STDOUT_CAP },
-			stderr: { maxBytes: STDERR_CAP }
+			stderr: { maxBytes: STDERR_CAP$1 }
 		},
 		graceMs: GRACE_MS,
 		signal: input.signal
@@ -4274,8 +4276,9 @@ async function latestPatchBackup(patchPath) {
 	return (await readdir(dir).catch(() => [])).filter((n) => n.startsWith(base + ".bak-")).sort().reverse()[0];
 }
 /** 各方法 handler 表（类型由 shared/rpc 的 RpcHandlerMap 约束）。 */
-function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx)) {
+function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx), lspHandlers) {
 	return {
+		...lspHandlers ?? {},
 		"edrv.list": async (args) => {
 			const sc = await requireSession(ctx, args.sessionId);
 			if ("err" in sc) return {
@@ -5100,8 +5103,8 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 * 统一入口：按方法分发到 handler 表。
 * @author ddj 2026年08月20号 / 2026年08月26号
 */
-async function handleRpc(ctx, registry, method, args, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx)) {
-	const handler = buildHandlers(ctx, registry, searcher, contentSearcher)[method];
+async function handleRpc(ctx, registry, method, args, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx), lspHandlers) {
+	const handler = buildHandlers(ctx, registry, searcher, contentSearcher, lspHandlers)[method];
 	if (!handler) return {
 		ok: false,
 		error: "未知方法: " + String(method)
@@ -5244,56 +5247,1960 @@ function dropFileIndex(cwd) {
 	fileIndex.delete(cwd);
 }
 //#endregion
-//#region src/index.ts
+//#region src/lsp/jsonrpc.ts
 /**
-* @dsh-external 生态 → dsh-vscode-mode：DSH 上的类 VSCode 编码体验（Host 半入口）。
-* 职责：装配 capture（tools/result 捕获 edit/write 差异）、RPC 分发（edrv.* / mcp.* / vscode.* / compat）、
-*       webServer 路由（/edrv/rpc、/edrv/assets/*、/edrv/vendor/*）、工作区旁车持久化、
-*       兼容层装配（依赖守卫 + 重复装配自诊断 + 启动日志兼容性报告）。
-* 结构：shared/（双面契约） + model/store/capture/workspace/revert/registry/rpc/routes/compat（host 模块）。
-* 作者 ddj 2026-08-20
+* dsh-vscode-mode host — LSP JSON-RPC 帧编解码（纯函数，node 可测）。
+* LSP over stdio 用 Content-Length 帧：
+*   Content-Length: <n>\r\n\r\n<恰好 n 字节 JSON>
+* 导出：encodeMessage（对象→帧 Buffer）、createFrameParser（流式粘包/拆包）、parseFrame（单帧）。
+* 作者 ddj 2026-08-27
 */
-const name = "dsh-vscode-mode";
-const inject = [
-	"sessions",
-	"fs",
-	"webServer",
-	"loader",
-	"tools",
-	"workspaceRegistry",
-	"agents"
-];
+const HEADER_END = "\r\n\r\n";
+/** 消息头正则（仅取 Content-Length；其它头忽略）。 */
+const HEADER_RE = /^Content-Length:\s*(\d+)\s*$/im;
+/** 将对象编码为带 Content-Length 头的帧。 */
+function encodeMessage(message) {
+	const body = JSON.stringify(message);
+	const head = "Content-Length: " + Buffer.byteLength(body, "utf8") + "\r\n\r\n";
+	return Buffer.from(head + body, "utf8");
+}
 /**
-* 装配插件：挂事件监听、注册路由、安装兼容层。
-* @author ddj 2026年08月20号
-* @param ctx DSH 上下文（sessions/fs/webServer 由 inject 提供；sandboxPolicy/subprocess 惰性获取）
-* @param config 插件配置（可选 imageDir 覆盖图标目录）
+* 尝试从 buffer 解析单个帧；成功返回 { body, rest }，数据不足返回 null。
+* @author ddj 2026年08月27号
+* @param buffer 已累积的字节
+* @returns 解析结果（rest 为剩余未消费字节）
 */
-function apply(ctx, config) {
-	const registry = /* @__PURE__ */ new Map();
-	const searcher = newSearcher(ctx);
-	const contentSearcher = newContentSearcher(ctx);
-	/** 兼容性警告收集（route 护栏等写入，启动日志一并输出）。 */
-	const warnings = [];
-	setupOpenSettings(ctx, config, () => {});
-	ctx.on("tools/result", (exec, result) => {
-		captureToolResult(ctx, registry, exec, result);
+function parseFrame(buffer) {
+	const headEnd = buffer.indexOf(HEADER_END);
+	if (headEnd < 0) return null;
+	const header = buffer.subarray(0, headEnd).toString("utf8");
+	const m = HEADER_RE.exec(header);
+	if (!m) {
+		const next = buffer.indexOf("Content-Length:");
+		return next >= 0 ? parseFrame(buffer.subarray(next)) : null;
+	}
+	const length = Number(m[1]);
+	const bodyStart = headEnd + 4;
+	if (buffer.length < bodyStart + length) return null;
+	return {
+		body: buffer.subarray(bodyStart, bodyStart + length).toString("utf8"),
+		rest: buffer.subarray(bodyStart + length)
+	};
+}
+/** 帧解析器：push 数据块，吐出完整消息（可能拆包后重组、也可能一包多帧）。 */
+function createFrameParser() {
+	let buffer = Buffer.alloc(0);
+	return {
+		push(chunk) {
+			if (chunk.length) buffer = Buffer.concat([buffer, chunk]);
+			const out = [];
+			for (;;) {
+				const parsed = parseFrame(buffer);
+				if (!parsed) break;
+				buffer = parsed.rest;
+				try {
+					out.push(JSON.parse(parsed.body));
+				} catch (error) {
+					out.push({
+						jsonrpc: "2.0",
+						error: {
+							code: -32700,
+							message: "Parse error: " + String(error)
+						},
+						id: null
+					});
+				}
+			}
+			return out;
+		},
+		clear() {
+			buffer = Buffer.alloc(0);
+		}
+	};
+}
+/** 构造标准 JSON-RPC 请求消息。 */
+function requestMessage(id, method, params) {
+	return {
+		jsonrpc: "2.0",
+		id,
+		method,
+		params
+	};
+}
+/** 构造标准 JSON-RPC 通知消息（无 id，fire-and-forget）。 */
+function notifyMessage(method, params) {
+	return {
+		jsonrpc: "2.0",
+		method,
+		params
+	};
+}
+//#endregion
+//#region src/lsp/transport.ts
+/**
+* dsh-vscode-mode host — LSP 语言服务器进程传输层。
+* 基于 node:child_process.spawn（stdio pipe 双向流）。刻意不用 DSH ctx.subprocess
+* 抽象：LSP 需要持续写 stdin + 流式读 stdout，而该抽象 stdin 不可写、输出为一次性收集。
+* 作者 ddj 2026-08-27
+*/
+const STDERR_CAP = 262144;
+const running = /* @__PURE__ */ new Set();
+/**
+* 启动语言服务器进程。
+* @author ddj 2026年08月27号
+* @param spec 启动参数（argv 数组，不经 shell，Windows 引号安全）
+* @param onMessage stdout 消息回调
+* @param logger 诊断日志（可选）
+* @returns 传输句柄
+*/
+function spawnServer(spec, onMessage, logger) {
+	const { argv, cwd, env } = spec;
+	const child = spawn(argv[0], argv.slice(1), {
+		cwd,
+		env: {
+			...process.env,
+			...env
+		},
+		stdio: [
+			"pipe",
+			"pipe",
+			"pipe"
+		],
+		windowsHide: true
 	});
-	ctx.on("session/disposed", (session) => {
-		const cwd = cwdOf(session);
-		if (cwd) {
-			registry.delete(cwd);
-			dropFileIndex(cwd);
-			searcher.dispose(cwd);
-			contentSearcher.dispose(cwd);
-			disposeIndex(cwd);
+	running.add(child);
+	let stderrBuf = Buffer.alloc(0);
+	let alive = true;
+	const parser = createFrameParser();
+	child.stderr.on("data", (chunk) => {
+		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, signal) => {
+		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 = {
+		write(chunk) {
+			if (!alive || !child.stdin.writable) return false;
+			child.stdin.write(chunk);
+			return true;
+		},
+		onMessage,
+		stderr() {
+			return stderrBuf.toString("utf8");
+		},
+		onExit: null,
+		dispose() {
+			if (!alive) return;
+			child.kill();
+			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).unref?.();
+		},
+		get alive() {
+			return alive;
+		},
+		get pid() {
+			return child.pid;
 		}
+	};
+	child.stdout.on("data", (chunk) => {
+		for (const message of parser.push(chunk)) transport.onMessage?.(message);
 	});
-	registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher, contentSearcher), (warning) => warnings.push(warning));
-	installIsolation(ctx);
-	sweepTreeCache();
-	logCompatSummary(ctx, warnings);
-	ctx.logger?.info?.("[dsh-vscode-mode] 编辑差异审查已装配（/edrv/rpc 路由就绪，项目 MCP 隔离已启用）");
+	return transport;
+}
+/** 强杀全部运行中的 LSP 子进程（插件卸载/退出用）。 */
+function disposeAllServers() {
+	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();
+}
+//#endregion
+//#region src/lsp/client.ts
+/**
+* dsh-vscode-mode host — LSP 客户端（JSON-RPC over stdio）。
+* 职责：请求/通知/握手/超时/服务器端请求处理/生命周期。transport 无关性：
+* 只依赖 write/onMessage 契约，便于单测时注入假传输。
+* 作者 ddj 2026-08-27
+*/
+const DEFAULT_TIMEOUT_MS = 2e4;
+var LspError = class extends Error {
+	code;
+	constructor(code, message) {
+		super(message);
+		this.code = code;
+	}
+};
+/**
+* 创建 LSP 客户端。
+* @author ddj 2026年08月27号
+* @param transport 传输句柄（write/onMessage/alive/dispose）
+* @param events 事件回调
+* @returns LSP 客户端
+*/
+function createLspClient(transport, events = {}) {
+	let nextId = 1;
+	let alive = transport.alive;
+	const pending = /* @__PURE__ */ new Map();
+	let serverCapabilities = {
+		definition: false,
+		references: false,
+		documentSymbol: false,
+		workspaceSymbol: false,
+		hover: false
+	};
+	const log = (line) => events.onLog?.(line);
+	createFrameParser();
+	transport.onMessage = (message) => {
+		const msg = message;
+		if (typeof msg.method === "string") {
+			if (msg.method === "$/progress") events.onProgress?.(msg.params);
+			handleServerRequest(msg);
+			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;
+				entry.reject(new LspError(err.code ?? -32e3, err.message ?? "LSP error"));
+			} else entry.resolve(msg.result);
+		}
+	};
+	/** 服务器端请求：消息/日志类打日志，配置/能力类回 result:null，其余回 method not found。 */
+	const handleServerRequest = async (msg) => {
+		const { method, params, id } = msg;
+		const respond = (payload) => {
+			transport.write(encodeMessage(payload));
+		};
+		try {
+			if (method === "window/logMessage" || method === "window/showMessage" || method === "window/showMessageRequest") {
+				const p = params;
+				log("[server " + (p?.type ?? "") + "] " + String(p?.message ?? ""));
+				if (id !== void 0) respond({
+					jsonrpc: "2.0",
+					id,
+					result: null
+				});
+				return;
+			}
+			if (method === "workspace/configuration") {
+				const p = params;
+				const items = Array.isArray(p?.items) ? p.items.map(() => null) : [];
+				if (id !== void 0) respond({
+					jsonrpc: "2.0",
+					id,
+					result: items
+				});
+				return;
+			}
+			if (method === "window/workDoneProgress/create" || method === "client/registerCapability" || method === "workspace/workspaceFolders") {
+				if (id !== void 0) respond({
+					jsonrpc: "2.0",
+					id,
+					result: null
+				});
+				return;
+			}
+			if (id !== void 0) respond({
+				jsonrpc: "2.0",
+				id,
+				error: {
+					code: -32601,
+					message: "Method not found: " + method
+				}
+			});
+		} catch (error) {
+			log("server request handler error: " + String(error));
+			if (id !== void 0) respond({
+				jsonrpc: "2.0",
+				id,
+				error: {
+					code: -32603,
+					message: String(error)
+				}
+			});
+		}
+	};
+	const transportExit = transport.onExit;
+	transport.onExit = (code, signal) => {
+		alive = false;
+		for (const entry of pending.values()) {
+			clearTimeout(entry.timer);
+			entry.reject(/* @__PURE__ */ new Error("LSP 服务器已退出（" + String(code) + "/" + String(signal) + "）"));
+		}
+		pending.clear();
+		events.onExit?.(code, signal);
+		transportExit?.(code, signal);
+	};
+	const client = {
+		async request(method, params, timeoutMs = DEFAULT_TIMEOUT_MS) {
+			if (!alive) throw new Error("LSP 服务器未运行");
+			const id = nextId++;
+			return new Promise((resolve, reject) => {
+				const timer = setTimeout(() => {
+					pending.delete(id);
+					reject(/* @__PURE__ */ new Error("LSP 请求超时：" + method + "（" + timeoutMs + "ms）"));
+				}, timeoutMs);
+				pending.set(id, {
+					resolve,
+					reject,
+					timer
+				});
+				transport.write(encodeMessage(requestMessage(id, method, params)));
+			});
+		},
+		notify(method, params) {
+			if (!alive) return;
+			transport.write(encodeMessage(notifyMessage(method, params)));
+		},
+		async initialize(rootUri, workspaceFolders) {
+			const caps = (await client.request("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 }
+					}
+				}
+			}))?.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() {
+			try {
+				await client.request("shutdown", null, 3e3);
+			} catch (error) {
+				log("shutdown: " + String(error));
+			}
+			try {
+				client.notify("exit", null);
+			} catch (error) {
+				log("exit: " + String(error));
+			}
+		},
+		get alive() {
+			return alive;
+		}
+	};
+	return client;
+}
+//#endregion
+//#region src/lsp/uri.ts
+/**
+* dsh-vscode-mode host — 路径 ↔ file:// URI 转换（纯函数，node 可测）。
+* LSP 的 uri 字段必须是 file:// 绝对 URI；客户端 Monaco 用 edrv:///<encodeURI(path)>。
+* 作者 ddj 2026-08-27
+*/
+/**
+* 绝对路径 → file:// URI（Windows 盘符保留：D:/x → file:///D:/x）。
+* @author ddj 2026年08月27号
+* @param absPath 绝对路径（正/反斜杠均可）
+* @returns file:// URI
+*/
+function pathToFileUri(absPath) {
+	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();
+}
+//#endregion
+//#region src/lsp/server.ts
+/**
+* dsh-vscode-mode host — 单语言服务器会话（绑定 工作区根 + 语言）。
+* 负责：启动传输 + LSP 客户端握手、文档同步（didOpen/didChange/didSave/didClose）、
+* 请求封装（definition/references/documentSymbol/workspaceSymbol/hover）、状态上报。
+* 作者 ddj 2026-08-27
+*/
+/**
+* 创建语言服务器会话。
+* @author ddj 2026年08月27号
+* @param spec provider 规格（argv/cwd）
+* @param root 工作区根（绝对路径）
+* @param languageId 语言 id
+* @param logger 诊断日志
+* @returns 会话句柄
+*/
+function createLspServer(spec, root, languageId, logger) {
+	const rootUri = pathToFileUri(root);
+	const docs = /* @__PURE__ */ new Map();
+	let phase = "idle";
+	let transport = null;
+	let client = null;
+	let capabilities = {
+		definition: false,
+		references: false,
+		documentSymbol: false,
+		workspaceSymbol: false,
+		hover: false
+	};
+	let disposed = false;
+	let readyWait = Promise.resolve(false);
+	let resolveReady = null;
+	let lastProgress = {};
+	let lastStatus = {
+		languageId,
+		source: spec.kind,
+		phase: "idle",
+		reason: spec.ready ? void 0 : spec.reason,
+		root
+	};
+	const log = (line) => logger?.("[" + languageId + "@" + root + "] " + line);
+	const setPhase = (next, reason) => {
+		phase = next;
+		lastStatus = {
+			languageId,
+			source: spec.kind,
+			phase: next,
+			reason,
+			root,
+			...progressFields()
+		};
+		server.onStateChange?.(lastStatus);
+	};
+	/** 返回当前进度字段，避免空进度污染状态载荷。 */
+	const progressFields = () => ({
+		progress: lastProgress.value,
+		progressMessage: lastProgress.message
+	});
+	/** 处理 LSP $/progress 通知并映射为编辑器状态。 */
+	const applyProgress = (params) => {
+		const report = params?.value;
+		if (report?.kind === "begin") {
+			lastProgress = {
+				value: 0,
+				message: typeof report.message === "string" ? report.message : "正在解析工作区"
+			};
+			if (phase === "ready") phase = "indexing";
+		} else if (report?.kind === "end") {
+			lastProgress = {
+				value: 100,
+				message: typeof report.message === "string" ? report.message : "解析完成"
+			};
+			if (phase === "indexing") phase = "ready";
+		} else if (typeof report?.percentage === "number") {
+			lastProgress = {
+				value: Math.max(0, Math.min(100, report.percentage)),
+				message: typeof report.message === "string" ? report.message : lastProgress.message
+			};
+			if (phase === "ready") phase = "indexing";
+		} else if (typeof report?.message === "string") lastProgress = {
+			...lastProgress,
+			message: report.message
+		};
+		lastStatus = {
+			...lastStatus,
+			phase,
+			...progressFields()
+		};
+		server.onStateChange?.(lastStatus);
+	};
+	const ensureClient = () => {
+		if (!client) throw new Error("LSP 服务器未启动");
+		return client;
+	};
+	const server = {
+		languageId,
+		root,
+		get phase() {
+			return phase;
+		},
+		get capabilities() {
+			return capabilities;
+		},
+		status() {
+			return lastStatus;
+		},
+		onStateChange: null,
+		async start() {
+			if (disposed) return false;
+			if (phase === "starting") return readyWait;
+			if (phase === "ready" || phase === "indexing") return true;
+			readyWait = new Promise((resolve) => {
+				resolveReady = resolve;
+			});
+			lastProgress = {};
+			setPhase("starting");
+			try {
+				transport = spawnServer({
+					argv: spec.argv,
+					cwd: spec.cwd ?? root
+				}, (message) => {}, (line) => log("stderr: " + line));
+				client = createLspClient(transport, {
+					onReady: (caps) => {
+						capabilities = caps;
+						for (const doc of docs.values()) client?.notify("textDocument/didOpen", { textDocument: {
+							uri: doc.uri,
+							languageId,
+							version: doc.version,
+							text: doc.text
+						} });
+						setPhase("ready");
+						resolveReady?.(true);
+						resolveReady = null;
+						log("ready: definition=" + caps.definition + " references=" + caps.references + " symbols=" + caps.documentSymbol);
+					},
+					onProgress: (params) => applyProgress(params),
+					onExit: (code, signal) => {
+						if (disposed) return;
+						resolveReady?.(false);
+						resolveReady = null;
+						log("server exited (" + String(code) + "/" + String(signal) + ")");
+						client = null;
+						transport = null;
+						setPhase("idle", "服务器已退出（" + String(code) + "/" + String(signal) + "），等待重启");
+					},
+					onLog: (line) => log("lsp: " + line)
+				});
+				capabilities = await client.initialize(rootUri, [rootUri]);
+				return true;
+			} catch (error) {
+				log("start failed: " + String(error));
+				setPhase("unavailable", "启动失败：" + String(error));
+				resolveReady?.(false);
+				resolveReady = null;
+				try {
+					await server.dispose();
+				} catch {}
+				return false;
+			}
+		},
+		sync(path, text, version) {
+			const existing = docs.get(path);
+			const uri = existing?.uri ?? pathToFileUri(root + "/" + path.split("/").join("/"));
+			if (existing) {
+				existing.version = version;
+				existing.text = text;
+				if (phase === "ready" || phase === "indexing") client?.notify("textDocument/didChange", {
+					textDocument: {
+						uri,
+						version
+					},
+					contentChanges: [{ text }]
+				});
+				return;
+			}
+			docs.set(path, {
+				path,
+				uri,
+				version,
+				text
+			});
+			if (phase === "ready" || phase === "indexing") client?.notify("textDocument/didOpen", { textDocument: {
+				uri,
+				languageId,
+				version,
+				text
+			} });
+		},
+		close(path) {
+			const doc = docs.get(path);
+			if (!doc) return;
+			docs.delete(path);
+			if (phase === "ready" || phase === "indexing") client?.notify("textDocument/didClose", { textDocument: { uri: doc.uri } });
+		},
+		async definition(path, line, character) {
+			const doc = docs.get(path);
+			if (!doc || !await readyWait) return [];
+			return normalizeLocations(await ensureClient().request("textDocument/definition", {
+				textDocument: { uri: doc.uri },
+				position: {
+					line,
+					character
+				}
+			}));
+		},
+		async references(path, line, character, includeDeclaration) {
+			const doc = docs.get(path);
+			if (!doc || !await readyWait) return [];
+			return normalizeLocations(await ensureClient().request("textDocument/references", {
+				textDocument: { uri: doc.uri },
+				position: {
+					line,
+					character
+				},
+				context: { includeDeclaration }
+			}));
+		},
+		async documentSymbol(path) {
+			const doc = docs.get(path);
+			if (!doc || !await readyWait) return [];
+			const result = await ensureClient().request("textDocument/documentSymbol", { textDocument: { uri: doc.uri } });
+			if (!Array.isArray(result)) return [];
+			return result.map(normalizeSymbol).filter((s) => s !== null);
+		},
+		async workspaceSymbol(query) {
+			if (!await readyWait) return [];
+			const result = await ensureClient().request("workspace/symbol", { query });
+			if (!Array.isArray(result)) return [];
+			return result.map(normalizeSymbol).filter((s) => s !== null);
+		},
+		async hover(path, line, character) {
+			const doc = docs.get(path);
+			if (!doc || !await readyWait) return null;
+			const result = await ensureClient().request("textDocument/hover", {
+				textDocument: { uri: doc.uri },
+				position: {
+					line,
+					character
+				}
+			});
+			if (!result || !result.contents) return null;
+			return { contents: stringifyHoverContents(result.contents) };
+		},
+		async dispose() {
+			disposed = true;
+			resolveReady?.(false);
+			resolveReady = null;
+			if (client) {
+				await client.shutdown().catch(() => {});
+				client = null;
+			}
+			if (transport) {
+				transport.dispose();
+				transport = null;
+			}
+			setPhase("stopped");
+		}
+	};
+	return server;
+}
+/** 归一化 definition/references 结果（Location | Location[] | LocationLink[]）。 */
+function normalizeLocations(result) {
+	if (!Array.isArray(result)) return [];
+	const out = [];
+	for (const item of result) {
+		if (!item || typeof item !== "object") continue;
+		const obj = item;
+		const uri = typeof obj.targetUri === "string" ? obj.targetUri : typeof obj.uri === "string" ? obj.uri : "";
+		const range = obj.targetRange ?? obj.range;
+		if (!uri || !range || !range.start || !range.end) continue;
+		out.push({
+			uri,
+			range: {
+				start: {
+					line: toInt(range.start.line),
+					character: toInt(range.start.character)
+				},
+				end: {
+					line: toInt(range.end.line),
+					character: toInt(range.end.character)
+				}
+			}
+		});
+	}
+	return out;
+}
+/** 归一化 documentSymbol/workspaceSymbol 结果（DocumentSymbol | SymbolInformation）。 */
+function normalizeSymbol(item) {
+	if (!item || typeof item !== "object") return null;
+	const obj = item;
+	if (typeof obj.name !== "string") return null;
+	const selection = obj.selectionRange ?? (obj.location && obj.location.range);
+	const range = obj.range ?? selection;
+	if (!range || typeof range !== "object") return null;
+	const r = range;
+	if (!r.start || !r.end) return null;
+	const symbol = {
+		name: obj.name,
+		kind: toInt(obj.kind),
+		range: {
+			start: {
+				line: toInt(r.start.line),
+				character: toInt(r.start.character)
+			},
+			end: {
+				line: toInt(r.end.line),
+				character: toInt(r.end.character)
+			}
+		},
+		selectionRange: selection ? {
+			start: {
+				line: toInt(selection.start?.line ?? toInt(r.start.line)),
+				character: toInt(selection.start?.character ?? toInt(r.start.character))
+			},
+			end: {
+				line: toInt(selection.end?.line ?? toInt(r.end.line)),
+				character: toInt(selection.end?.character ?? toInt(r.end.character))
+			}
+		} : {
+			start: {
+				line: toInt(r.start.line),
+				character: toInt(r.start.character)
+			},
+			end: {
+				line: toInt(r.end.line),
+				character: toInt(r.end.character)
+			}
+		}
+	};
+	if (typeof obj.detail === "string" && obj.detail) symbol.detail = obj.detail;
+	if (typeof obj.containerName === "string" && obj.containerName) symbol.containerName = obj.containerName;
+	if (Array.isArray(obj.children)) {
+		const kids = obj.children.map(normalizeSymbol).filter((s) => s !== null);
+		if (kids.length) symbol.children = kids;
+	}
+	return symbol;
+}
+/** hover contents → 文本行（MarkupContent | MarkedString | MarkedString[]）。 */
+function stringifyHoverContents(contents) {
+	if (typeof contents === "string") return [contents];
+	if (Array.isArray(contents)) return contents.map(stringifyHoverContents).flat().filter(Boolean);
+	if (contents && typeof contents === "object") {
+		const value = contents.value;
+		if (typeof value === "string") return [value];
+	}
+	return [];
+}
+function toInt(value) {
+	const n = Number(value);
+	return Number.isFinite(n) ? Math.max(0, Math.floor(n)) : 0;
+}
+//#endregion
+//#region src/lsp/manager.ts
+/**
+* dsh-vscode-mode host — LSP 服务器管理器。
+* 实例注册表（key=root|languageId，refcount 共享），崩溃退避重启，session/disposed 清理。
+* 作者 ddj 2026-08-27
+*/
+/**
+* 创建 LSP 管理器。
+* @author ddj 2026年08月27号
+* @param logger 诊断日志
+* @returns 管理器
+*/
+function createLspManager(logger) {
+	const entries = /* @__PURE__ */ new Map();
+	const keyOf = (root, languageId) => root + "|" + languageId;
+	const log = (line) => logger?.("[lsp-manager] " + line);
+	/** 同步摘除注册表项并后台回收（refs 归零/工作区清理用；statusAll 立即可见归零）。 */
+	const dropEntry = (entry) => {
+		if (entry.restartTimer) {
+			clearTimeout(entry.restartTimer);
+			entry.restartTimer = null;
+		}
+		entries.delete(entry.key);
+		entry.server.dispose().catch(() => {});
+	};
+	const manager = {
+		acquire(root, languageId, resolveSpec) {
+			const key = keyOf(root, languageId);
+			let entry = entries.get(key);
+			if (!entry) {
+				const spec = resolveSpec(languageId);
+				const server = createLspServer(spec, root, languageId, log);
+				server.onStateChange = (status) => manager.onStatusChange?.(status);
+				entry = {
+					key,
+					server,
+					refs: 0,
+					failures: 0,
+					restartTimer: null
+				};
+				entries.set(key, entry);
+				if (spec.ready) server.start().then((ok) => {
+					if (!ok && entries.has(key)) entry.failures++;
+				});
+			}
+			entry.refs++;
+			return entry.server;
+		},
+		release(root, languageId) {
+			const entry = entries.get(keyOf(root, languageId));
+			if (!entry) return;
+			entry.refs = Math.max(0, entry.refs - 1);
+			if (entry.refs === 0) dropEntry(entry);
+		},
+		releaseRoot(root) {
+			for (const entry of [...entries.values()]) if (entry.server.root === root) dropEntry(entry);
+		},
+		statusAll() {
+			return [...entries.values()].map((entry) => entry.server.status());
+		},
+		peek(root, languageId) {
+			return entries.get(keyOf(root, languageId))?.server;
+		},
+		async disposeAll() {
+			const list = [...entries.values()];
+			entries.clear();
+			for (const entry of list) {
+				if (entry.restartTimer) clearTimeout(entry.restartTimer);
+				await entry.server.dispose();
+			}
+		},
+		onStatusChange: null
+	};
+	return manager;
+}
+//#endregion
+//#region src/lsp/zip.ts
+/**
+* dsh-vscode-mode host — 纯 Node ZIP 解压（零依赖，跨平台）。
+* 供 extmgr 解包 VSIX 使用；只实现 VSIX 需要的子集：
+* 读取 EOCD + 中央目录，支持 stored(0)/deflate(8)，忽略 zip64（VSIX < 4GB）。
+* 作者 ddj 2026-08-27
+*/
+const EOCD_SIG = 101010256;
+const CDIR_SIG = 33639248;
+const LHDR_SIG = 67324752;
+/**
+* 解析 ZIP 缓冲区 → 条目列表（不解压内容，仅元数据）。
+* @author ddj 2026年08月27号
+* @param buf zip 字节
+* @returns 条目元数据
+*/
+function zipEntries(buf) {
+	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 = [];
+	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 条目（含内容）
+*/
+function unzip(buf) {
+	const metas = zipEntries(buf);
+	const out = [];
+	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.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) {
+	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;
+}
+//#endregion
+//#region src/lsp/extmgr.ts
+/**
+* dsh-vscode-mode host — VSIX 扩展管理器（extmgr）。
+* 管理 DSH 专属扩展目录（~/.dsh/dsh-vscode-mode/extensions/），支持：
+* 本地 .vsix 安装、Open VSX 市场搜索/下载安装、卸载、更新检测与安装。
+* 已装扩展作为 LSP provider 的"扩展源"（kind=extension），见 providers.ts。
+* 作者 ddj 2026-08-27
+*/
+const OPEN_VSX = "https://open-vsx.org";
+const META_FILE = "package.json";
+/** 当前平台（与 VSCode platform 命名对齐：win32-x64/darwin-arm64/linux-x64）。 */
+const PLATFORM = (() => {
+	if (process.platform === "win32") return process.arch === "arm64" ? "win32-arm64" : "win32-x64";
+	if (process.platform === "darwin") return process.arch === "arm64" ? "darwin-arm64" : "darwin-x64";
+	return process.arch === "arm64" ? "linux-arm64" : "linux-x64";
+})();
+/** DSH 专属扩展目录。 */
+function extensionsRoot(home = dshHome()) {
+	return join(home, PLUGIN_ID, "extensions");
+}
+/** 从 VSIX 字节里读 extension/package.json 清单。 */
+function vsixManifest(vsix) {
+	for (const entry of unzip(vsix)) if (entry.path === "extension/package.json" || entry.path === "extension\\package.json") return JSON.parse(entry.data.toString("utf8"));
+	throw new Error("VSIX 缺少 extension/package.json");
+}
+/**
+* 解包 VSIX 到目录（仅取 extension/ 子树，剥前缀；返回清单）。
+* @author ddj 2026年08月27号
+* @param vsix vsix 字节
+* @param dest 目标目录（已存在则先清空）
+* @returns 清单对象
+*/
+function unpackVsix(vsix, dest) {
+	rmSync(dest, {
+		recursive: true,
+		force: true
+	});
+	mkdirSync(dest, { recursive: true });
+	let manifest = null;
+	for (const entry of unzip(vsix)) {
+		const rel = entry.path.replace(/^extension[\\/]/, "");
+		if (!rel || entry.path.startsWith("..")) continue;
+		const safe = rel.split(/[\\/]/).filter((part) => part && part !== ".." && part !== ".").join("/");
+		if (!safe) continue;
+		const target = join(dest, ...safe.split("/"));
+		if (entry.isDirectory) {
+			mkdirSync(target, { recursive: true });
+			continue;
+		}
+		mkdirSync(dirname(target), { recursive: true });
+		writeFileSync(target, entry.data);
+		if (rel === "package.json") manifest = JSON.parse(entry.data.toString("utf8"));
+	}
+	if (!manifest) throw new Error("VSIX 解包后缺少 package.json");
+	return manifest;
+}
+/** 扩展信息（清单 + 目录）。 */
+function extInfoOf(manifest, dir) {
+	const namespace = String(manifest.publisher ?? "unknown");
+	const name = String(manifest.name ?? "unknown");
+	const version = String(manifest.version ?? "0.0.0");
+	return {
+		id: namespace + "." + name,
+		namespace,
+		name,
+		version,
+		displayName: typeof manifest.displayName === "string" ? manifest.displayName : void 0,
+		description: typeof manifest.description === "string" ? manifest.description : void 0,
+		dirName: basename(dir),
+		dir
+	};
+}
+/** 安装本地 .vsix 文件（已存在同 id 则升级替换）。 */
+async function installVsixFile(vsixPath, home = dshHome()) {
+	return installVsixBuffer(readFileSync(vsixPath), home);
+}
+/** 安装 VSIX 字节（解包进 extensionsRoot；同名旧版本先清）。 */
+function installVsixBuffer(vsix, home = dshHome()) {
+	const info = extInfoOf(vsixManifest(vsix), "");
+	const target = join(extensionsRoot(home), info.id + "-" + info.version);
+	return extInfoOf(unpackVsix(vsix, target), target);
+}
+/** 扫描已装扩展目录。 */
+function listInstalled(home = dshHome()) {
+	const root = extensionsRoot(home);
+	if (!existsSync(root)) return [];
+	const out = [];
+	for (const dir of readdirSync(root)) {
+		const full = join(root, dir);
+		const meta = join(full, META_FILE);
+		if (!existsSync(meta)) continue;
+		try {
+			const manifest = JSON.parse(readFileSync(meta, "utf8"));
+			out.push(extInfoOf(manifest, full));
+		} catch (error) {}
+	}
+	return out;
+}
+/** 卸载扩展（按 id）。 */
+function uninstall(id, home = dshHome()) {
+	const target = listInstalled(home).find((e) => e.id === id)?.dir;
+	if (!target) return false;
+	rmSync(target, {
+		recursive: true,
+		force: true
+	});
+	return true;
+}
+/** Open VSX 单扩展元数据（latest + 下载 URL）。 */
+async function marketGet(namespace, name, version) {
+	const path = version ? namespace + "/" + name + "/" + version : namespace + "/" + name;
+	const res = await fetch(OPEN_VSX + "/api/" + path, { headers: { accept: "application/json" } });
+	if (!res.ok) return null;
+	return await res.json();
+}
+/** Open VSX 搜索。 */
+async function marketSearch(query, size = 12) {
+	const url = OPEN_VSX + "/api/-/search?query=" + encodeURIComponent(query) + "&size=" + size;
+	const res = await fetch(url, { headers: { accept: "application/json" } });
+	if (!res.ok) throw new Error("市场搜索失败：HTTP " + res.status);
+	return ((await res.json()).extensions ?? []).map((item) => ({
+		namespace: String(item.namespace ?? ""),
+		name: String(item.name ?? ""),
+		id: String(item.namespace ?? "") + "." + String(item.name ?? ""),
+		version: String(item.version ?? ""),
+		displayName: typeof item.displayName === "string" ? item.displayName : void 0,
+		description: typeof item.description === "string" ? item.description : void 0,
+		download: typeof item.files?.download === "string" ? item.files.download : void 0
+	}));
+}
+/** 平台匹配的 VSIX 下载 URL（探测平台变体，失败回退 API 默认）。 */
+async function resolveDownload(namespace, name, version) {
+	const candidate = OPEN_VSX + "/api/" + namespace + "/" + name + "/" + PLATFORM + "/" + version + "/file/" + namespace + "." + name + "-" + version + "@" + PLATFORM + ".vsix";
+	try {
+		if ((await fetch(candidate, { method: "HEAD" })).ok) return candidate;
+	} catch (error) {}
+	const download = ((await marketGet(namespace, name, version))?.files)?.download;
+	if (typeof download === "string") return download;
+	throw new Error("市场未提供 " + namespace + "." + name + "@" + version + " 的下载地址");
+}
+/** 从 Open VSX 安装/更新扩展。 */
+async function installFromMarket(namespace, name, version) {
+	const meta = await marketGet(namespace, name, version);
+	if (!meta) throw new Error("市场找不到 " + namespace + "." + name + (version ? "@" + version : ""));
+	const url = await resolveDownload(namespace, name, version ?? String(meta.version ?? ""));
+	const res = await fetch(url);
+	if (!res.ok) throw new Error("下载失败：HTTP " + res.status);
+	return installVsixBuffer(Buffer.from(await res.arrayBuffer()));
+}
+/** 更新已装扩展（对比市场最新版；返回 null 表示已最新）。 */
+async function updateExtension(id) {
+	const installed = listInstalled().find((e) => e.id === id);
+	if (!installed) throw new Error("扩展未安装：" + id);
+	const meta = await marketGet(installed.namespace, installed.name);
+	const latest = String(meta?.version ?? "");
+	if (!latest || latest === installed.version) return null;
+	return installFromMarket(installed.namespace, installed.name, latest);
+}
+//#endregion
+//#region src/lsp/providers.ts
+/**
+* dsh-vscode-mode host — 语言服务器 provider 解析。
+* 优先级：手动配置 > extmgr 扩展源(Phase 2 挂载) > 自动发现(~/.vscode/extensions、
+* ~/.dsh/dsh-vscode-mode/extensions、PATH)。产物 LspProviderSpec：{ ready, argv, cwd, reason }，
+* 供 manager 启动服务器。
+* 作者 ddj 2026-08-27
+*/
+/** 平台目录名（LuaLS/OmniSharp 的 server/bin/<平台>）。 */
+function platformServerDir(platform = process.platform) {
+	if (platform === "win32") return "Windows";
+	if (platform === "darwin") return "macOS";
+	return "Linux";
+}
+/** exe 后缀（Windows 为 .exe）。 */
+function exeSuffix(platform = process.platform) {
+	return platform === "win32" ? ".exe" : "";
+}
+/** 列出目录下匹配前缀的子目录（如 ~/.vscode/extensions/sumneko.lua-*）。 */
+function listMatchingDirs(dir, prefix) {
+	if (!existsSync(dir)) return [];
+	let entries;
+	try {
+		entries = readdirSync(dir, { withFileTypes: true });
+	} catch (error) {
+		return [];
+	}
+	return entries.filter((e) => e.isDirectory() && e.name.startsWith(prefix)).map((e) => join(dir, e.name));
+}
+/** VSCode 扩展目录（~/.vscode/extensions、~/.vscode-server/extensions + extmgr 目录；无则空数组）。 */
+function vscodeExtensionsDirs(home = dshHome()) {
+	const userHome = homedir();
+	return [
+		join(userHome, ".vscode", "extensions"),
+		join(userHome, ".vscode-server", "extensions"),
+		extensionsRoot(home)
+	].filter((dir) => existsSync(dir));
+}
+/** 扩展源 provider 注册表：languageId → 启动参数。 */
+const extProviders = /* @__PURE__ */ new Map();
+/** 取扩展源 provider spec（未注册返回 null）。 */
+function extensionProviderFor(languageId) {
+	const p = extProviders.get(languageId);
+	if (!p || !p.argv.length) return null;
+	return {
+		languageId,
+		kind: "extension",
+		argv: p.argv,
+		cwd: p.cwd,
+		ready: true
+	};
+}
+/** PATH 中查找可执行文件（不含扩展名校验，交由 spawn 报错）。 */
+function findInPath(name) {
+	const pathEnv = process.env.PATH ?? "";
+	const exts = process.platform === "win32" ? [
+		"",
+		".exe",
+		".cmd",
+		".bat"
+	] : [""];
+	for (const dir of pathEnv.split(sep === "\\" ? ";" : ":")) {
+		if (!dir) continue;
+		for (const ext of exts) {
+			const candidate = join(dir, name + ext);
+			if (existsSync(candidate)) return candidate;
+		}
+	}
+	return null;
+}
+/** 查找 dotnet（PATH + 常见安装路径）。 */
+function findDotnet() {
+	const inPath = findInPath("dotnet");
+	if (inPath) return inPath;
+	for (const c of ["C:/Program Files/dotnet/dotnet.exe", "C:/Program Files (x86)/dotnet/dotnet.exe"]) if (existsSync(c)) return c;
+	return null;
+}
+/** LuaLS 自动发现候选（VSCode 扩展目录 + extmgr 目录下 sumneko.lua-* 的 server/bin 可执行）。 */
+function candidateLuaServers(home = dshHome()) {
+	const plat = platformServerDir();
+	const suffix = exeSuffix();
+	const out = [];
+	for (const dir of vscodeExtensionsDirs(home)) for (const extDir of listMatchingDirs(dir, "sumneko.lua-")) {
+		const binDir = join(extDir, "server", "bin");
+		const binName = "lua-language-server" + suffix;
+		const bin = existsSync(join(binDir, binName)) ? join(binDir, binName) : join(binDir, plat, binName);
+		if (existsSync(bin) && !out.includes(bin)) out.push(bin);
+	}
+	return out;
+}
+/** C# 自动发现候选：Roslyn dll（需 dotnet）或 OmniSharp 可执行。 */
+function candidateCSharpServers(home = dshHome()) {
+	const out = {};
+	for (const dir of vscodeExtensionsDirs(home)) for (const extDir of listMatchingDirs(dir, "ms-dotnettools.csharp-")) {
+		const roslyn = join(extDir, ".roslyn", "Microsoft.CodeAnalysis.LanguageServer.dll");
+		if (!out.roslynDll && existsSync(roslyn)) out.roslynDll = roslyn;
+		const omni = join(extDir, ".omnisharp", "OmniSharp" + exeSuffix());
+		if (!out.omnisharpExe && existsSync(omni)) out.omnisharpExe = omni;
+	}
+	const dotnet = findDotnet();
+	if (dotnet) out.dotnet = dotnet;
+	return out;
+}
+/**
+* 手动配置归一化：path 指向可执行文件/目录，command 为可执行名（PATH 解析）。
+* 未配置时返回空 reason（由各 resolve 兜底输出语言相关安装指引文案）。
+* @author ddj 2026年08月27号
+*/
+function manualSpec(manual) {
+	if (!manual) return {
+		argv: [],
+		ready: false
+	};
+	const pathValue = typeof manual.path === "string" && manual.path.trim() ? manual.path.trim() : "";
+	const commandValue = typeof manual.command === "string" && manual.command.trim() ? manual.command.trim() : "";
+	if (!pathValue && !commandValue) return {
+		argv: [],
+		ready: false
+	};
+	if (pathValue) {
+		if (!existsSync(pathValue)) return {
+			argv: [],
+			ready: false,
+			reason: "路径不存在：" + pathValue
+		};
+		return {
+			argv: [pathValue],
+			ready: true
+		};
+	}
+	const found = findInPath(commandValue);
+	if (!found) return {
+		argv: [],
+		ready: false,
+		reason: "PATH 中找不到命令：" + commandValue
+	};
+	return {
+		argv: [found],
+		ready: true
+	};
+}
+/**
+* 解析 Lua provider（优先级：手动 > 扩展源 > 自动发现）。
+* @author ddj 2026年08月27号
+* @param manual 手动配置
+* @param home DSH home（缺省真实；测试可注入临时目录）
+* @returns provider 规格
+*/
+function resolveLuaProvider(manual, home = dshHome()) {
+	const base = { languageId: "lua" };
+	const manualResolved = manualSpec(manual);
+	if (manualResolved.ready) return {
+		...base,
+		kind: "manual",
+		argv: manualResolved.argv,
+		cwd: manualResolved.cwd,
+		ready: true
+	};
+	const ext = extensionProviderFor("lua");
+	if (ext) return ext;
+	const candidates = candidateLuaServers(home);
+	if (candidates.length) return {
+		...base,
+		kind: "discover",
+		argv: [candidates[0]],
+		cwd: void 0,
+		ready: true
+	};
+	const inPath = findInPath("lua-language-server" + exeSuffix());
+	if (inPath) return {
+		...base,
+		kind: "discover",
+		argv: [inPath],
+		ready: true
+	};
+	return {
+		...base,
+		kind: "none",
+		argv: [],
+		ready: false,
+		reason: manualResolved.reason ?? "未发现 lua-language-server（可安装 LuaLS 或手动指定路径）"
+	};
+}
+/**
+* 解析 C# provider（优先级：手动 > 扩展源 > 自动发现；需 dotnet + Roslyn dll；或 OmniSharp）。
+* @author ddj 2026年08月27号
+* @param manual 手动配置
+* @param home DSH home（缺省真实；测试可注入临时目录）
+* @returns provider 规格
+*/
+function resolveCSharpProvider(manual, home = dshHome()) {
+	const base = { languageId: "csharp" };
+	const manualResolved = manualSpec(manual);
+	if (manualResolved.ready) return {
+		...base,
+		kind: "manual",
+		argv: manualResolved.argv,
+		cwd: manualResolved.cwd,
+		ready: true
+	};
+	const ext = extensionProviderFor("csharp");
+	if (ext) return ext;
+	const discovered = candidateCSharpServers(home);
+	if (discovered.roslynDll && discovered.dotnet) return {
+		...base,
+		kind: "discover",
+		argv: [
+			discovered.dotnet,
+			discovered.roslynDll,
+			"--stdio"
+		],
+		ready: true
+	};
+	if (discovered.omnisharpExe) return {
+		...base,
+		kind: "discover",
+		argv: [discovered.omnisharpExe, "--stdio"],
+		ready: true
+	};
+	const reasons = [];
+	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 入口）"
+	};
+}
+const PROVIDER_RESOLVERS = {
+	lua: resolveLuaProvider,
+	csharp: resolveCSharpProvider
+};
+//#endregion
+//#region src/lsp/config.ts
+const LSP_SETTINGS_NS = "dsh-vscode-mode.languageServers";
+const LSP_LANGUAGES = ["lua", "csharp"];
+function sanitizeLang(raw) {
+	if (!raw || typeof raw !== "object") return void 0;
+	const obj = raw;
+	const out = {};
+	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;
+}
+/** 从插件组合配置读取。 */
+function configFromPlugin(config) {
+	const raw = config?.languageServers;
+	if (!raw || typeof raw !== "object") return {};
+	const out = {};
+	for (const lang of LSP_LANGUAGES) {
+		const v = sanitizeLang(raw[lang]);
+		if (v) out[lang] = v;
+	}
+	return out;
+}
+/** 从 settings 描述符读取（无 settings 服务/无该 section → {}）。 */
+function configFromSettings(ctx) {
+	try {
+		const value = (ctx.get("settings")?.describe?.({ redactSecrets: true })?.find((item) => item.ns === LSP_SETTINGS_NS))?.value;
+		if (!value || typeof value !== "object") return {};
+		const out = {};
+		for (const lang of LSP_LANGUAGES) {
+			const v = sanitizeLang(value[lang]);
+			if (v) out[lang] = v;
+		}
+		return out;
+	} catch (error) {
+		return {};
+	}
+}
+/** 合并配置：settings 覆盖插件配置。 */
+function mergeConfig(a, b) {
+	const out = { ...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 规格
+*/
+function resolveProviderSpec(ctx, pluginConfig, languageId) {
+	const resolver = PROVIDER_RESOLVERS[languageId];
+	if (!resolver) return {
+		languageId,
+		kind: "none",
+		argv: [],
+		ready: false,
+		reason: "不支持的语言：" + languageId
+	};
+	const lang = mergeConfig(configFromPlugin(pluginConfig), configFromSettings(ctx))[languageId];
+	if (lang && lang.enabled === false) return {
+		languageId,
+		kind: "none",
+		argv: [],
+		ready: false,
+		reason: "已在设置中禁用"
+	};
+	return resolver({
+		command: lang?.command,
+		path: lang?.path
+	});
+}
+/** 语言 → 扩展名（供客户端判断是否触发 LSP）。 */
+function langOfPath(path) {
+	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;
+}
+//#endregion
+//#region src/lsp/rpc.ts
+/**
+* 打开文档跟踪：openDocs(docKey→sessionId) + rootLangRefs 计数 + sessionAcquired 归属。
+* 保证 manager 的 acquire/release 一一配对（多会话共享同一 root|lang 也平衡）。
+*/
+function createDocTracker() {
+	const openDocs = /* @__PURE__ */ new Map();
+	const rootLangRefs = /* @__PURE__ */ new Map();
+	const sessionDocs = /* @__PURE__ */ new Map();
+	const keyOf = (root, lang, path) => root + "|" + lang + "|" + path;
+	const rootLangOf = (docKey) => docKey.slice(0, docKey.lastIndexOf("|"));
+	const rememberDoc = (sessionId, docKey) => {
+		const docs = sessionDocs.get(sessionId) ?? /* @__PURE__ */ new Set();
+		docs.add(docKey);
+		sessionDocs.set(sessionId, docs);
+	};
+	const forgetDoc = (sessionId, docKey) => {
+		const docs = sessionDocs.get(sessionId);
+		docs?.delete(docKey);
+		if (docs?.size === 0) sessionDocs.delete(sessionId);
+	};
+	const releaseRef = (rl) => {
+		const next = (rootLangRefs.get(rl) ?? 1) - 1;
+		if (next <= 0) {
+			rootLangRefs.delete(rl);
+			return true;
+		}
+		rootLangRefs.set(rl, next);
+		return false;
+	};
+	return {
+		/** 记录文档打开；同一文档可由多个会话打开，但每个会话只计一次。 */
+		open(root, lang, path, sessionId) {
+			const docKey = keyOf(root, lang, path);
+			const owners = openDocs.get(docKey) ?? /* @__PURE__ */ new Set();
+			if (owners.has(sessionId)) return false;
+			owners.add(sessionId);
+			openDocs.set(docKey, owners);
+			rememberDoc(sessionId, docKey);
+			const rl = root + "|" + lang;
+			const count = rootLangRefs.get(rl) ?? 0;
+			rootLangRefs.set(rl, count + 1);
+			return count === 0;
+		},
+		/** 记录文档关闭；返回 true 表示 root|lang 已无文档（应 release）。 */
+		close(root, lang, path, sessionId) {
+			const docKey = keyOf(root, lang, path);
+			const owners = openDocs.get(docKey);
+			if (!owners?.has(sessionId)) return false;
+			owners.delete(sessionId);
+			if (owners.size === 0) openDocs.delete(docKey);
+			forgetDoc(sessionId, docKey);
+			return releaseRef(root + "|" + lang);
+		},
+		/** 关闭某会话全部文档；返回全局引用归零、需要 release 的 root|lang。 */
+		closeSession(sessionId) {
+			const docs = sessionDocs.get(sessionId);
+			if (!docs) return [];
+			const toRelease = /* @__PURE__ */ new Set();
+			for (const docKey of docs) {
+				const owners = openDocs.get(docKey);
+				owners?.delete(sessionId);
+				if (owners?.size === 0) openDocs.delete(docKey);
+				if (releaseRef(rootLangOf(docKey))) toRelease.add(rootLangOf(docKey));
+			}
+			sessionDocs.delete(sessionId);
+			return [...toRelease];
+		}
+	};
+}
+/**
+* 构造 edrv.lsp.* handlers（一次性创建，tracker 状态跨请求保留）。
+* @author ddj 2026年08月27号
+* @param deps 依赖（ctx/pluginConfig/manager）
+* @returns { handlers, disposeSession } handlers 为局部 map，disposeSession 供 session/disposed 清理
+*/
+function createLspRpc(deps) {
+	const { ctx, pluginConfig, manager } = deps;
+	const tracker = createDocTracker();
+	/** 解析会话与工作区根（失败 → null + error）。 */
+	const rootOf = async (sessionId) => {
+		const session = sessionOf(ctx, sessionId);
+		if (!session) return { err: "会话不存在" };
+		if (!cwdOf(session)) return { err: "会话无工作区" };
+		try {
+			return {
+				root: await searchRoot(ctx, session),
+				sessionId: typeof session.id === "string" && session.id ? session.id : sessionId ?? ""
+			};
+		} catch (error) {
+			return { err: String(error) };
+		}
+	};
+	const acquireServer = (root, lang) => manager.acquire(root, lang, (languageId) => resolveProviderSpec(ctx, pluginConfig, languageId));
+	const serverOf = (root, lang) => manager.peek(root, lang);
+	const rootLocations = (locations, root) => locations.map((location) => ({
+		...location,
+		root
+	}));
+	const disposeSession = (sessionId) => {
+		for (const rl of tracker.closeSession(sessionId)) {
+			const sep = rl.lastIndexOf("|");
+			manager.release(rl.slice(0, sep), rl.slice(sep + 1));
+		}
+	};
+	return {
+		handlers: {
+			"edrv.lsp.status": async (args) => {
+				if (!args.sessionId) return {
+					ok: true,
+					servers: manager.statusAll()
+				};
+				const sc = await rootOf(args.sessionId);
+				if ("err" in sc) return {
+					ok: false,
+					error: sc.err
+				};
+				return {
+					ok: true,
+					servers: manager.statusAll().filter((status) => status.root === sc.root)
+				};
+			},
+			"edrv.lsp.configGet": async () => {
+				const settings = configFromSettings(ctx);
+				const plugin = configFromPlugin(pluginConfig);
+				const merged = { ...plugin };
+				for (const lang of Object.keys(settings)) merged[lang] = {
+					...plugin[lang],
+					...settings[lang]
+				};
+				return {
+					ok: true,
+					config: merged
+				};
+			},
+			"edrv.lsp.configUpdate": async (args) => {
+				const lang = args.languageId;
+				if (!lang || !resolveProviderSpec(ctx, pluginConfig, lang).languageId) return {
+					ok: false,
+					error: "不支持的语言：" + lang
+				};
+				const current = configFromSettings(ctx);
+				const target = {
+					...current,
+					[lang]: { ...current[lang] ?? {} }
+				}[lang];
+				if (args.enabled !== void 0) target.enabled = args.enabled;
+				if (args.command !== void 0) target.command = args.command || void 0;
+				if (args.path !== void 0) target.path = args.path || void 0;
+				try {
+					const settings = ctx.get("settings");
+					if (!settings?.update) return {
+						ok: false,
+						error: "设置服务不可用"
+					};
+					await settings.update(LSP_SETTINGS_NS, { [lang]: target });
+					const stored = (settings.describe?.({ redactSecrets: true })?.find((item) => item.ns === LSP_SETTINGS_NS))?.value;
+					return {
+						ok: true,
+						config: {
+							...configFromPlugin(pluginConfig),
+							...stored
+						}
+					};
+				} catch (error) {
+					return {
+						ok: false,
+						error: "配置保存失败：" + String(error)
+					};
+				}
+			},
+			"edrv.lsp.sync": async (args) => {
+				const lang = langOfPath(args.path);
+				if (!lang) return { ok: true };
+				const sc = await rootOf(args.sessionId);
+				if ("err" in sc) return {
+					ok: false,
+					error: sc.err
+				};
+				const server = tracker.open(sc.root, lang, args.path, sc.sessionId) ? acquireServer(sc.root, lang) : serverOf(sc.root, lang);
+				if (!server) return {
+					ok: false,
+					error: "语言服务器未注册"
+				};
+				server.sync(args.path, args.text, args.version);
+				return { ok: true };
+			},
+			"edrv.lsp.close": async (args) => {
+				const lang = langOfPath(args.path);
+				if (!lang) return { ok: true };
+				const sc = await rootOf(args.sessionId);
+				if ("err" in sc) return { ok: true };
+				if (tracker.close(sc.root, lang, args.path, sc.sessionId)) manager.release(sc.root, lang);
+				return { ok: true };
+			},
+			"edrv.lsp.definition": async (args) => {
+				const lang = langOfPath(args.path);
+				if (!lang) return {
+					ok: true,
+					locations: []
+				};
+				const sc = await rootOf(args.sessionId);
+				if ("err" in sc) return {
+					ok: false,
+					error: sc.err
+				};
+				try {
+					const server = serverOf(sc.root, lang);
+					if (!server) return {
+						ok: true,
+						locations: []
+					};
+					const locations = await server.definition(args.path, args.position.line, args.position.character);
+					const rooted = rootLocations(locations, sc.root);
+					const truncated = rooted.length > 500;
+					return {
+						ok: true,
+						locations: truncated ? rooted.slice(0, 500) : rooted,
+						truncated: truncated || void 0
+					};
+				} catch (error) {
+					return {
+						ok: false,
+						error: "LSP 定义查询失败：" + String(error)
+					};
+				}
+			},
+			"edrv.lsp.references": async (args) => {
+				const lang = langOfPath(args.path);
+				if (!lang) return {
+					ok: true,
+					locations: []
+				};
+				const sc = await rootOf(args.sessionId);
+				if ("err" in sc) return {
+					ok: false,
+					error: sc.err
+				};
+				try {
+					const server = serverOf(sc.root, lang);
+					if (!server) return {
+						ok: true,
+						locations: []
+					};
+					const locations = await server.references(args.path, args.position.line, args.position.character, args.includeDeclaration !== false);
+					const rooted = rootLocations(locations, sc.root);
+					const truncated = rooted.length > 500;
+					return {
+						ok: true,
+						locations: truncated ? rooted.slice(0, 500) : rooted,
+						truncated: truncated || void 0
+					};
+				} catch (error) {
+					return {
+						ok: false,
+						error: "LSP 引用查询失败：" + String(error)
+					};
+				}
+			},
+			"edrv.lsp.documentSymbol": async (args) => {
+				const lang = langOfPath(args.path);
+				if (!lang) return {
+					ok: true,
+					symbols: []
+				};
+				const sc = await rootOf(args.sessionId);
+				if ("err" in sc) return {
+					ok: false,
+					error: sc.err
+				};
+				try {
+					const server = serverOf(sc.root, lang);
+					if (!server) return {
+						ok: true,
+						symbols: []
+					};
+					return {
+						ok: true,
+						symbols: await server.documentSymbol(args.path)
+					};
+				} catch (error) {
+					return {
+						ok: false,
+						error: "LSP 大纲查询失败：" + String(error)
+					};
+				}
+			},
+			"edrv.lsp.workspaceSymbol": async (args) => {
+				const sc = await rootOf(args.sessionId);
+				if ("err" in sc) return {
+					ok: false,
+					error: sc.err
+				};
+				const out = { symbols: [] };
+				for (const lang of ["lua", "csharp"]) {
+					const existing = serverOf(sc.root, lang);
+					if (!existing) continue;
+					try {
+						const symbols = await existing.workspaceSymbol(args.query);
+						if (symbols.length) out.symbols.push(...symbols);
+					} catch (error) {}
+				}
+				const truncated = out.symbols.length > 500;
+				return {
+					ok: true,
+					symbols: out.symbols.slice(0, 500),
+					truncated: truncated || void 0
+				};
+			},
+			"edrv.lsp.hover": async (args) => {
+				const lang = langOfPath(args.path);
+				if (!lang) return {
+					ok: true,
+					hover: void 0
+				};
+				const sc = await rootOf(args.sessionId);
+				if ("err" in sc) return {
+					ok: false,
+					error: sc.err
+				};
+				try {
+					const server = serverOf(sc.root, lang);
+					if (!server) return {
+						ok: true,
+						hover: void 0
+					};
+					return {
+						ok: true,
+						hover: await server.hover(args.path, args.position.line, args.position.character) ?? void 0
+					};
+				} catch (error) {
+					return {
+						ok: false,
+						error: "LSP hover 查询失败：" + String(error)
+					};
+				}
+			},
+			"edrv.lsp.ext.list": async () => ({
+				ok: true,
+				extensions: listInstalled()
+			}),
+			"edrv.lsp.ext.market": async (args) => {
+				try {
+					return {
+						ok: true,
+						extensions: await marketSearch(args.query, args.size ?? 12)
+					};
+				} catch (error) {
+					return {
+						ok: false,
+						error: "市场搜索失败：" + String(error)
+					};
+				}
+			},
+			"edrv.lsp.ext.install": async (args) => {
+				try {
+					let info;
+					if (args.vsixPath) info = await installVsixFile(args.vsixPath);
+					else if (args.namespace && args.name) info = await installFromMarket(args.namespace, args.name, args.version);
+					else return {
+						ok: false,
+						error: "缺少安装源（vsixPath 或 namespace+name）"
+					};
+					return {
+						ok: true,
+						extension: info
+					};
+				} catch (error) {
+					return {
+						ok: false,
+						error: "安装失败：" + String(error)
+					};
+				}
+			},
+			"edrv.lsp.ext.uninstall": async (args) => {
+				return uninstall(args.id) ? { ok: true } : {
+					ok: false,
+					error: "扩展未安装：" + args.id
+				};
+			},
+			"edrv.lsp.ext.update": async (args) => {
+				try {
+					const updated = await updateExtension(args.id);
+					if (!updated) {
+						const current = listInstalled().find((e) => e.id === args.id);
+						return current ? {
+							ok: true,
+							extension: current,
+							updated: false
+						} : {
+							ok: false,
+							error: "扩展未安装：" + args.id
+						};
+					}
+					return {
+						ok: true,
+						extension: updated,
+						updated: true
+					};
+				} catch (error) {
+					return {
+						ok: false,
+						error: "更新失败：" + String(error)
+					};
+				}
+			},
+			"edrv.lsp.ext.updates": async () => {
+				try {
+					const updates = [];
+					for (const ext of listInstalled()) {
+						const meta = await marketGet(ext.namespace, ext.name);
+						const latest = String(meta?.version ?? "");
+						if (latest && latest !== ext.version) updates.push({
+							id: ext.id,
+							current: ext.version,
+							latest,
+							displayName: ext.displayName
+						});
+					}
+					return {
+						ok: true,
+						updates
+					};
+				} catch (error) {
+					return {
+						ok: false,
+						error: "检查更新失败：" + String(error)
+					};
+				}
+			}
+		},
+		disposeSession
+	};
+}
+//#endregion
+//#region src/lsp/settings.ts
+/**
+* 安装 LSP 设置 section。
+* @author ddj 2026年08月27号
+* @param ctx DSH 上下文
+* @param entry 初始配置
+* @returns 是否成功安装
+*/
+async function installLspSettingsSection(ctx, entry) {
+	const deps = await loadSettingsDeps();
+	if (!deps) return false;
+	try {
+		const z = deps.z;
+		const langShape = {};
+		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) {
+		console.error("[dsh-vscode-mode] LSP 设置 section 安装失败：" + String(error));
+		return false;
+	}
+}
+//#endregion
+//#region src/index.ts
+/**
+* @dsh-external 生态 → dsh-vscode-mode：DSH 上的类 VSCode 编码体验（Host 半入口）。
+* 职责：装配 capture（tools/result 捕获 edit/write 差异）、RPC 分发（edrv.* / mcp.* / vscode.* / compat）、
+*       webServer 路由（/edrv/rpc、/edrv/assets/*、/edrv/vendor/*）、工作区旁车持久化、
+*       兼容层装配（依赖守卫 + 重复装配自诊断 + 启动日志兼容性报告）。
+* 结构：shared/（双面契约） + model/store/capture/workspace/revert/registry/rpc/routes/compat（host 模块）。
+* 作者 ddj 2026-08-20
+*/
+const name = "dsh-vscode-mode";
+const inject = [
+	"sessions",
+	"fs",
+	"webServer",
+	"loader",
+	"tools",
+	"workspaceRegistry",
+	"agents"
+];
+/**
+* 装配插件：挂事件监听、注册路由、安装兼容层。
+* @author ddj 2026年08月20号
+* @param ctx DSH 上下文（sessions/fs/webServer 由 inject 提供；sandboxPolicy/subprocess 惰性获取）
+* @param config 插件配置（可选 imageDir 覆盖图标目录）
+*/
+function apply(ctx, config) {
+	const registry = /* @__PURE__ */ new Map();
+	const searcher = newSearcher(ctx);
+	const contentSearcher = newContentSearcher(ctx);
+	/** LSP 服务器管理器（语言智能：跳转/引用/大纲）。 */
+	const lspManager = createLspManager((line) => ctx.logger?.debug?.("[" + name + "] " + line));
+	/** 兼容性警告收集（route 护栏等写入，启动日志一并输出）。 */
+	const warnings = [];
+	setupOpenSettings(ctx, config, () => {});
+	installLspSettingsSection(ctx, {});
+	/** LSP RPC 与会话清理（一次性创建，tracker 状态跨请求保留）。 */
+	const lspRpc = createLspRpc({
+		ctx,
+		pluginConfig: config,
+		manager: lspManager
+	});
+	const lspHandlers = lspRpc.handlers;
+	ctx.on("tools/result", (exec, result) => {
+		captureToolResult(ctx, registry, exec, result);
+	});
+	ctx.on("session/disposed", (session) => {
+		const cwd = cwdOf(session);
+		if (cwd) {
+			registry.delete(cwd);
+			dropFileIndex(cwd);
+			searcher.dispose(cwd);
+			contentSearcher.dispose(cwd);
+			disposeIndex(cwd);
+		}
+		const sid = session?.id;
+		if (typeof sid === "string") lspRpc.disposeSession(sid);
+	});
+	registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher, contentSearcher, lspHandlers), (warning) => warnings.push(warning));
+	installIsolation(ctx);
+	sweepTreeCache();
+	logCompatSummary(ctx, warnings);
+	ctx.effect(() => () => {
+		lspManager.disposeAll().catch(() => {});
+		disposeAllServers();
+	});
+	ctx.logger?.info?.("[" + name + "] 编辑差异审查已装配（/edrv/rpc 路由就绪，项目 MCP 隔离已启用，语言服务器 LSP 已接入）");
 }
 /**
 * 异步输出兼容性报告摘要（含重复装配/路由冲突自诊断）。