dsh-vscode-mode 0.15.8 → 0.16.0

package/lib/index.js

@@ -10306,6 +10306,181 @@ async function storedOpenBase(dir, fallback) {
 		return fallback;
 	}
 }
+//#endregion
+//#region src/selfUpdate.ts
+/**
+* dsh-vscode-mode host — 自我更新：registry 最新版本检查与官方 pluginManager「先删后装」编排。
+* 职责：compareVersion 语义化版本比较（纯函数可单测）、latestVersionOf 经 subprocess 运行
+*       `pnpm view <pkg> version --json`（与 installBundle 同一套 pnpm/registry 配置）、
+*       startSelfUpdate 把 removeBundle→installBundle 编排放进宿主级 setTimeout（先回 RPC 响应，
+*       定时器回调不受本插件卸载影响，规避「删除自身后 install 不再执行」的自愈陷阱）。
+* 注意：不 import @deepseek-ai/dsh-plugin-manager（鸭子类型引用 ctx.get('pluginManager')），
+*       老宿主缺失该服务时返回明确错误引导官方插件管理页。
+* 作者 ddj 2026-10-16
+*/
+/** 防并发重入标志：一旦启动编排，本次进程内不再接受第二次更新请求。 */
+let updating = false;
+/**
+* 语义化版本比较：核心段按 `.` 数值比较、段数不足补 0；预发布版（-beta 等）低于同号正式版，
+* 构建元数据（+）与预发布粒度不参与排序。
+* @private
+* @author ddj 2026年10月16号
+* @param a 左版本号
+* @param b 右版本号
+* @returns a>b 为 1，a<b 为 -1，相等为 0
+*/
+function compareVersion$1(a, b) {
+	const parse = (text) => {
+		const value = String(text ?? "").trim().replace(/^[^\d]*/, "");
+		const cut = value.search(/[-+]/);
+		return {
+			nums: (cut >= 0 ? value.slice(0, cut) : value).split(".").map((part) => {
+				const num = Number.parseInt(part, 10);
+				return Number.isFinite(num) ? num : 0;
+			}),
+			pre: cut >= 0 && value[cut] === "-"
+		};
+	};
+	const left = parse(a);
+	const right = parse(b);
+	const total = Math.max(left.nums.length, right.nums.length);
+	for (let index = 0; index < total; index += 1) {
+		const diff = (left.nums[index] ?? 0) - (right.nums[index] ?? 0);
+		if (diff !== 0) return diff > 0 ? 1 : -1;
+	}
+	if (left.pre !== right.pre) return left.pre ? -1 : 1;
+	return 0;
+}
+/**
+* 用 profileContext.packageManager（缺省 pnpm）查询 npm registry 上本包最新版本。
+* @private
+* @author ddj 2026年10月16号
+* @param ctx DSH host 上下文
+* @returns registry 最新版本号
+* @throws pnpm 不存在、退出非零或输出不可解析
+*/
+async function latestVersionOf(ctx) {
+	const dir = findProfileDir(ctx);
+	if (!dir) throw new Error("无法定位当前 profile，无法查询最新版本");
+	const runner = ctx.get("profileContext")?.packageManager;
+	return parseVersionJson(await new Promise((resolvePromise, rejectPromise) => {
+		let spawned = false;
+		try {
+			const handle = ctx.get("subprocess").spawn({
+				argv: [
+					runner?.command ?? "pnpm",
+					...runner?.args ?? [],
+					"view",
+					PLUGIN_NAME,
+					"version",
+					"--json"
+				],
+				cwd: dir,
+				env: childEnv(runner?.env),
+				stdio: {
+					stdout: "pipe",
+					stderr: "pipe",
+					stdin: "ignore"
+				},
+				graceMs: 2e4
+			});
+			spawned = true;
+			readSpawnText(handle, resolvePromise, rejectPromise);
+		} catch (error) {
+			if (!spawned) rejectPromise(error instanceof Error ? error : new Error(String(error)));
+		}
+	}));
+}
+/**
+* 读取 spawn 句柄的 stdout 文本并等待退出（非零退出或空输出抛错）。
+* @private
+* @author ddj 2026年10月16号
+* @param handle subprocess.spawn 返回句柄
+* @param resolvePromise 成功回传 stdout 全文
+* @param rejectPromise 失败回传错误
+*/
+function readSpawnText(handle, resolvePromise, rejectPromise) {
+	handle.done.then((outcome) => {
+		const text = handle.collected?.stdout?.readFrom(0)?.text ?? "";
+		if (outcome?.exitCode !== 0 || !text.trim()) {
+			rejectPromise(/* @__PURE__ */ new Error("pnpm view 失败（exit " + String(outcome?.exitCode) + "）：" + text.slice(0, 200)));
+			return;
+		}
+		resolvePromise(text);
+	}, rejectPromise);
+}
+/**
+* 解析 `pnpm view --json` 输出：JSON 字符串（"1.2.3"）或直接版本字面量均接受。
+* @private
+* @author ddj 2026年10月16号
+* @param text stdout 全文
+* @returns 版本号
+* @throws 输出不含可识别版本
+*/
+function parseVersionJson(text) {
+	const trimmed = text.trim();
+	try {
+		const value = JSON.parse(trimmed);
+		if (typeof value === "string" && value.trim()) return value.trim();
+	} catch {}
+	if (/^\d+(\.\d+){0,3}([-+].*)?$/.test(trimmed)) return trimmed;
+	throw new Error("无法解析 pnpm view 输出：" + trimmed.slice(0, 120));
+}
+/**
+* 检查 registry 是否有比当前安装版本更新的版本。
+* @public
+* @author ddj 2026年10月16号
+* @param ctx DSH host 上下文
+* @returns 当前版本 / 最新版本 / 是否有更新
+*/
+async function checkUpdate(ctx) {
+	const current = pluginVersionOf();
+	try {
+		const latest = await latestVersionOf(ctx);
+		return {
+			ok: true,
+			current,
+			latest,
+			hasUpdate: latest !== "" && compareVersion$1(latest, current) > 0
+		};
+	} catch (error) {
+		return {
+			ok: false,
+			current,
+			error: String(error)
+		};
+	}
+}
+/**
+* 启动「先删后装」自我更新编排：校验通过后把编排放进宿主级 setTimeout（延迟 1s 让 RPC 响应
+* 先送达客户端），立即返回 started；定时器回调不受本插件卸载影响。install 失败时
+* pluginManager 会恢复 profile 的 package.json/pnpm-lock.yaml，插件保持未安装状态，
+* 由用户在官方插件管理页重装恢复。
+* @public
+* @author ddj 2026年10月16号
+* @param ctx DSH host 上下文
+* @returns started 是否已启动编排；失败时 ok=false
+* @throws 无（失败走返回值 error）
+*/
+async function startSelfUpdate(ctx) {
+	if (updating) return {
+		ok: false,
+		error: "更新流程已在进行中，请重启 DSH 后观察结果"
+	};
+	const manager = ctx.get("pluginManager");
+	if (!manager || typeof manager.removeBundle !== "function" || typeof manager.installBundle !== "function") return {
+		ok: false,
+		error: "当前宿主无 pluginManager 服务，请在官方插件管理页卸载后重新安装以升级"
+	};
+	updating = true;
+	setTimeout(() => {
+		manager.removeBundle(PLUGIN_NAME).then(() => manager.installBundle(PLUGIN_NAME)).catch(() => {});
+	}, 1e3);
+	return {
+		ok: true,
+		started: true
+	};
+}
 /**
 * 路径归一：去首尾空白 + 反斜杠转 '/'（Windows 输入等价处理）。
 * @author ddj 2026年09月22号
@@ -12827,6 +13002,26 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 				};
 			}
 		},
+		"vscode.updateCheck": async () => {
+			try {
+				return await checkUpdate(ctx);
+			} catch (error) {
+				return {
+					ok: false,
+					error: String(error)
+				};
+			}
+		},
+		"vscode.updateSelf": async () => {
+			try {
+				return await startSelfUpdate(ctx);
+			} catch (error) {
+				return {
+					ok: false,
+					error: String(error)
+				};
+			}
+		},
 		"edrv.integration.status": async () => {
 			try {
 				return {
@@ -14225,6 +14420,25 @@ function isDeclarationForm(word, queryChain) {
 */
 const MAX_DOC_VERSION = 2147483647;
 /**
+* 找工作区根目录下的第一个 .sln（字典序）。
+*
+* 背景：Roslyn LSP 启动后若收不到 solution/project 通知，会停留在「杂项文件」模式——
+* 工作区内自有符号可解析，但 Unity 引擎程序集 / NuGet 包等元数据符号的
+* definition/hover 一律返回空（实测 2026-10-16，GameObject.Find 全空）。
+* 需在握手后发 Roslyn 专有 `solution/open` 通知加载项目上下文。
+* @author ddj 2026年10月19号
+* @param root 工作区根（绝对路径）
+* @returns sln 绝对路径；根目录无 sln 返回 null
+*/
+async function findSolutionFile(root) {
+	try {
+		const names = (await readdir(root)).filter((name) => name.toLowerCase().endsWith(".sln")).sort();
+		return names[0] ? join(root, names[0]) : null;
+	} catch {
+		return null;
+	}
+}
+/**
 * 使用合法、递增的 Int32 文档版本；旧客户端的毫秒时间戳不能直发给 Roslyn。
 * @author ddj 2026年09月24号
 * @param incoming 客户端传来的版本
@@ -14485,7 +14699,11 @@ function createLspServer(spec, root, languageId, logger) {
 					onLog: (line) => log("lsp: " + line)
 				});
 				const caps = await client.initialize(rootUri, [rootUri]);
-				if (languageId === "csharp") client.notify("workspace/didChangeConfiguration", { settings: { dotrush: { roslyn: {} } } });
+				if (languageId === "csharp") {
+					client.notify("workspace/didChangeConfiguration", { settings: { dotrush: { roslyn: {} } } });
+					const slnPath = await findSolutionFile(root);
+					if (slnPath) client.notify("solution/open", { solution: pathToFileUri(slnPath) });
+				}
 				capabilities = caps;
 				return true;
 			} catch (error) {
@@ -15909,8 +16127,8 @@ function resolveLuaProvider(manual, home = dshHome()) {
 	});
 }
 /**
-* 解析 C# provider（优先级：手动 > 扩展源 > 自动发现；Roslyn dll 需 dotnet；
-* DotRush 需满足其运行时的 dotnet；或 OmniSharp）。
+* 解析 C# provider（优先级：手动 > 扩展源 > 自动发现；DotRush 优先——自带 sln 加载与
+* 反编译跳转；Roslyn dll 需 dotnet，但无 C# Dev Kit 时不加载项目；或 OmniSharp）。
 * @author ddj 2026年08月27号
 * @param manual 手动配置
 * @param home DSH home（缺省真实；测试可注入临时目录）
@@ -15932,17 +16150,6 @@ function resolveCSharpProvider(manual, home = dshHome()) {
 		const discovered = candidateCSharpServers(h);
 		const sdkRoot = findSdkRoot();
 		const msbuildEnv = sdkRoot ? sdkEnvOf(sdkRoot) : void 0;
-		if (discovered.roslynDll && discovered.dotnet) return {
-			...base,
-			kind: "discover",
-			argv: [
-				discovered.dotnet,
-				discovered.roslynDll,
-				"--stdio"
-			],
-			env: msbuildEnv,
-			ready: true
-		};
 		let dotrushReason = null;
 		let provisionMajor;
 		if (discovered.dotrushDll) {
@@ -15960,6 +16167,17 @@ function resolveCSharpProvider(manual, home = dshHome()) {
 			dotrushReason = launch.reason;
 			provisionMajor = major ?? void 0;
 		}
+		if (discovered.roslynDll && discovered.dotnet) return {
+			...base,
+			kind: "discover",
+			argv: [
+				discovered.dotnet,
+				discovered.roslynDll,
+				"--stdio"
+			],
+			env: msbuildEnv,
+			ready: true
+		};
 		if (discovered.omnisharpExe) return {
 			...base,
 			kind: "discover",
@@ -22515,7 +22733,8 @@ function listProcesses() {
 * ~/.vscode-server/extensions、插件扩展目录），读各扩展 package.json 的
 * contributes.debuggers[] 声明，解析为 DapAdapterDecl：
 * - program 按平台取 windows/linux/osx 覆盖，相对扩展根解析；
-* - runtime='node' → 由 node 跑 js 入口；无 runtime → program 即可执行（args 为清单声明）；
+* - runtime='node' → 由 node 跑 js 入口；runtime='dotnet' → 由 dotnet 跑 dll 入口；
+*   无 runtime → program 即可执行（args 为清单声明）；
 * - 同 type 多扩展并存 → 按「清单版本降序(numeric) → 路径升序」取唯一（与 LSP 候选口径一致）；
 * - 入口不存在 / runtime 不支持 → available=false + reason（如 DotRush 按需下载的 clrdbg，
 *   诚实标注不假成功，调用方据此在下拉置灰并提示原因）。
@@ -22597,9 +22816,9 @@ function declOf(extDir, entry) {
 	const languages = stringsOf(entry.languages);
 	const resolved = resolveProgram(extDir, entry);
 	const runtime = typeof entry.runtime === "string" && entry.runtime ? entry.runtime : void 0;
-	const runtimeBad = runtime !== void 0 && runtime !== "node";
+	const runtimeBad = runtime !== void 0 && runtime !== "node" && runtime !== "dotnet";
 	const available = resolved.available && !runtimeBad;
-	const reason = !resolved.available ? resolved.reason : runtimeBad ? "暂不支持运行时 \"" + runtime + "\"（仅支持 node 与原生可执行）" : void 0;
+	const reason = !resolved.available ? resolved.reason : runtimeBad ? "暂不支持运行时 \"" + runtime + "\"（仅支持 node、dotnet 与原生可执行）" : void 0;
 	return {
 		type,
 		label: typeof entry.label === "string" && entry.label ? entry.label : type,
@@ -22665,6 +22884,8 @@ function stringsOf(value) {
 * dsh-vscode-mode host — 调试适配器规格解析：按调试类型从扩展清单声明（discovery）
 * 解析 spawn 规格，通用不限定语言：
 * - runtime='node' → node 跑 js 入口（emmylua 形态，等价旧 process.execPath 硬编码）；
+* - runtime='dotnet' → dotnet 跑 dll 入口（DotRush monodbg 形态；按 dll runtimeconfig
+*   要求的运行时大版本找满足的 dotnet，对齐 LSP 侧 dotrushLaunch 口径）；
 * - 无 runtime → program 即原生可执行（clrdbg/monodbg 形态，args 为清单声明如 --interpreter=vscode）；
 * - 其它 runtime 明确不支持（decl.available=false 带原因，不做假启动）。
 * 旧版仅探测 tangzx.emmylua 两型（attach/new），由清单驱动后自然覆盖并扩展到任意适配器。
@@ -22693,6 +22914,15 @@ function resolveAdapterSpec(type, force = false, home) {
 		command: process.execPath,
 		args: [decl.program, ...decl.args]
 	};
+	if (decl.runtime === "dotnet") {
+		const dotnet = dotnetLaunch(decl.extensionPath, decl.program);
+		if (!dotnet) return null;
+		return {
+			...base,
+			command: dotnet,
+			args: [decl.program, ...decl.args]
+		};
+	}
 	if (!decl.runtime) return {
 		...base,
 		command: decl.program,
@@ -22700,6 +22930,21 @@ function resolveAdapterSpec(type, force = false, home) {
 	};
 	return null;
 }
+/**
+* 为 dotnet 型适配器找启动用 dotnet：优先扩展内置 SDK，其次满足 dll runtimeconfig
+* 要求的运行时大版本，兜底任意 dotnet（对齐 LSP 侧 dotrushLaunch 口径）。
+* @author ddj 2026年10月19号
+* @param extensionPath 扩展根目录
+* @param program 适配器 dll 绝对路径
+* @returns dotnet 可执行路径；找不到满足条件的返回 null
+*/
+function dotnetLaunch(extensionPath, program) {
+	const sdkDotnet = join(extensionPath, "extension", "Sdk", "dotnet" + (process.platform === "win32" ? ".exe" : ""));
+	if (existsSync(sdkDotnet)) return sdkDotnet;
+	const major = runtimeMajorOf(dirname(program));
+	if (major !== null) return dotnetWithRuntime(major) ?? findDotnet();
+	return findDotnet();
+}
 //#endregion
 //#region src/dap/protocol.ts
 /** 客户端 → 适配器请求帧构造。 */