dsh-vscode-mode 0.15.7 → 0.15.9

package/lib/index.js

@@ -2423,6 +2423,15 @@ function imageMimeOf(path) {
 /** PDF 统一 MIME（host base64 响应与 client PDF 面板同源，避免两处漂移）。 */
 const PDF_MIME = "application/pdf";
 /**
+* 会话级前置错误的规范文案：host requireSession 系与 client 错误识别共用同一常量，
+* 避免文案漂移导致 client 端分类失效。跨端场景（桌面端/Web 端各自运行独立 DSH 实例、
+* 会话列表互通但会话仅在一端激活）下，本端 host 取不到会话即返回「会话不存在」。
+* @author ddj 2026年10月16号
+*/
+const SESSION_MISSING_ERROR = "会话不存在";
+/** 会话存在但无工作区 cwd 时的规范文案（与 SESSION_MISSING_ERROR 同源共用）。 */
+const SESSION_NO_WORKSPACE_ERROR = "会话无工作区";
+/**
 * 路径 → 二进制预览 MIME：PDF 特判 {@link PDF_MIME}，其余走图片表回退 octet-stream。
 * @author ddj 2026年09月22号
 * @param path 文件路径（`/` 或 `\` 分隔均可）
@@ -10297,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号
@@ -11198,9 +11382,9 @@ function recView(record, ws = null) {
 /** 会话/工作区公共前置：返回 {session,cwd} 或错误文案。 */
 async function requireSession(ctx, sessionId) {
 	const session = sessionOf(ctx, sessionId);
-	if (!session) return { err: "会话不存在" };
+	if (!session) return { err: SESSION_MISSING_ERROR };
 	const cwd = cwdOf(session);
-	if (!cwd) return { err: "会话无工作区" };
+	if (!cwd) return { err: SESSION_NO_WORKSPACE_ERROR };
 	return {
 		session,
 		cwd
@@ -12818,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 {
@@ -16706,8 +16910,8 @@ function createLspRpc(deps) {
 	/** 解析会话与工作区根（失败 → null + error）。 */
 	const rootOf = async (sessionId) => {
 		const session = sessionOf(ctx, sessionId);
-		if (!session) return { err: "会话不存在" };
-		if (!cwdOf(session)) return { err: "会话无工作区" };
+		if (!session) return { err: SESSION_MISSING_ERROR };
+		if (!cwdOf(session)) return { err: SESSION_NO_WORKSPACE_ERROR };
 		try {
 			return {
 				root: await searchRoot(ctx, session),
@@ -19960,9 +20164,9 @@ function foregroundHelperArgv(processName) {
 /** host 会话/工作区前置（对齐 rpc.ts requireSession 的错误文案）。 */
 async function requireSvnSession(ctx, sessionId) {
 	const session = sessionOf(ctx, sessionId);
-	if (!session) return { err: "会话不存在" };
+	if (!session) return { err: SESSION_MISSING_ERROR };
 	const cwd = cwdOf(session);
-	if (!cwd) return { err: "会话无工作区" };
+	if (!cwd) return { err: SESSION_NO_WORKSPACE_ERROR };
 	return { cwd };
 }
 /** 工作区相对路径归一（'' 合法 = 工作区根；非法含越界/绝对路径返回 null）。 */