dsh-vscode-mode 0.4.3 → 0.4.4

package/lib/index.js

@@ -259,6 +259,15 @@ function bindHostLog(ctx) {
 }
 //#endregion
 //#region src/fileOpenSettings.ts
+/**
+* dsh-vscode-mode host — 文件链接打开工具 + 快捷键的持久化设置。
+* 依赖守卫：schemastery 动态加载；@deepseek-ai/dsh-settings 仅作 legacy 探测——
+* rc 线导出 installSettingsSection free function，0.1.2-alpha 起移除（改由 settings
+* 服务的 installSection 方法承载，见 runSettingsInstall 三策略）。
+* 缺失/任一策略失败时插件仍可加载（fileOpenTool 降级为配置值，compat 报告可见），
+* 全程 try/catch，不产生未捕获 rejection。
+* 作者 ddj 2026年08月24号 / 2026年08月26号 / 2026年09月02号
+*/
 const FILE_OPEN_SETTINGS_NS = "dsh-vscode-mode";
 const FILE_OPEN_DEFAULT = "auto";
 /** AI 内联补全配置默认值（默认关闭；路由空 = 自动；档位空 = 跟随模型默认）。 */
@@ -270,14 +279,31 @@ const AI_CONFIG_DEFAULT = {
 };
 let depsPromise;
 /**
+* 宿主锚点动态导入：先经 process.argv[1]（DSH 启动脚本所在树）解析并加载目标包，
+* 避开本插件自身 node_modules 的 dev 依赖副本（dev-link 下 import() 相对插件位置
+* 解析，会命中 rc 线旧包 dsh-settings@0.1.0-rc.8）；argv[1] 缺失或解析失败回退
+* 普通 specifier import。
+* @author ddj 2026年09月15号
+* @param specifier 包名
+* @returns 加载的模块命名空间
+*/
+async function hostImport(specifier) {
+	const entry = process.argv[1];
+	if (entry) try {
+		const resolved = createRequire(entry).resolve(specifier);
+		return await import(pathToFileURL(resolved).href);
+	} catch {}
+	return import(specifier);
+}
+/**
 * 动态加载设置依赖（模块级缓存；任一缺失/失败返回 null 而非抛错）。
 * installSettingsSection 仅在 rc 线 dsh-settings 中存在时提供（alpha 起移除，
 * 属性探测得到 undefined，不抛错）。
-* @author ddj 2026年08月24号
+* @author ddj 2026年08月24号 / 2026年09月15号
 * @returns 设置依赖或 null
 */
 function loadSettingsDeps() {
-	if (!depsPromise) depsPromise = Promise.all([import("@deepseek-ai/dsh-settings"), import("schemastery")]).then(([dshSettings, schemastery]) => ({
+	if (!depsPromise) depsPromise = Promise.all([hostImport("@deepseek-ai/dsh-settings"), hostImport("schemastery")]).then(([dshSettings, schemastery]) => ({
 		installSettingsSection: dshSettings.installSettingsSection,
 		z: schemastery.default
 	})).catch(() => null);
@@ -736,6 +762,8 @@ function inDshRange(version, range) {
 function familyLabel(input) {
 	const version = parseDshVersion(input);
 	if (!version) return "未知";
+	if (inDshRange(version, { from: "0.1.6-alpha.1" })) return "0.1.6-alpha 及更新（MCP SDK v2 + Web 侧边栏终端 + 文件链接默认侧栏预览）";
+	if (inDshRange(version, { from: "0.1.5-alpha.1" })) return "0.1.5-alpha 及更新（官方右侧 Sidebar 编辑区 + sidebar.panellist）";
 	if (inDshRange(version, { from: "0.1.3-alpha.1" })) return "0.1.3-alpha 及更新（对话文件链接=remote.session.openWorkspacePath）";
 	if (inDshRange(version, { from: "0.1.2-alpha.1" })) return "0.1.2-alpha 及更新（设置 API=settings.installSection）";
 	return "0.1.0/0.1.1 rc 线（设置 API=installSettingsSection）";
@@ -748,19 +776,48 @@ const VERSION_CANDIDATES = [
 	"@deepseek-ai/dsh/package.json"
 ];
 let detectedVersion;
+/**
+* 宿主入口 require 锚点：process.argv[1] 指向运行中 DSH 的启动脚本
+* （安装树 node_modules/@deepseek-ai/dsh/... 或 profile 树），从其所在目录
+* 向上解析能命中宿主的 @deepseek-ai 包——避开本插件自身 node_modules 里的
+* dev 依赖副本（dev-link 安装下 import.meta.url 锚点会先命中 rc 线副本，
+* 曾致版本探测与 deps 加载错位到 0.1.0-rc.8，见 fileOpenSettings 的 hostImport）。
+* @author ddj 2026年09月15号
+* @returns 宿主锚点 require；argv[1] 缺失或不可用时 undefined
+*/
+function hostRequire() {
+	const entry = process.argv[1];
+	if (!entry) return void 0;
+	try {
+		return createRequire(entry);
+	} catch {
+		return;
+	}
+}
+/** 用指定 resolver 解析一个候选包版本（解析/读取失败返回 null）。 */
+function resolveVersionOf(specifier, resolver) {
+	try {
+		const file = resolver.resolve(specifier);
+		const pkg = JSON.parse(readFileSync(file, "utf8"));
+		if (typeof pkg.version === "string" && parseDshVersion(pkg.version) !== null) return pkg.version;
+	} catch {}
+	return null;
+}
 /** 探测运行中 DSH 核心版本（模块级缓存；失败空串，不抛错）。 */
 function detectDshVersion() {
 	if (detectedVersion !== void 0) return detectedVersion;
 	detectedVersion = "";
-	const require = createRequire(import.meta.url);
-	for (const specifier of VERSION_CANDIDATES) try {
-		const file = require.resolve(specifier);
-		const pkg = JSON.parse(readFileSync(file, "utf8"));
-		if (typeof pkg.version === "string" && parseDshVersion(pkg.version) !== null) {
-			detectedVersion = pkg.version;
-			break;
+	const resolvers = [hostRequire(), createRequire(import.meta.url)];
+	for (const resolver of resolvers) {
+		if (!resolver) continue;
+		for (const specifier of VERSION_CANDIDATES) {
+			const version = resolveVersionOf(specifier, resolver);
+			if (version !== null) {
+				detectedVersion = version;
+				return detectedVersion;
+			}
 		}
-	} catch {}
+	}
 	return detectedVersion;
 }
 //#endregion
@@ -1642,7 +1699,7 @@ function detectGuards(ctx) {
 	}];
 }
 /** 已实测覆盖的最高 DSH 版本（适配矩阵上界，超过则提示，见 buildReport）。 */
-const TESTED_DSH_MAX = "0.1.3-alpha.2";
+const TESTED_DSH_MAX = "0.1.6-alpha.1";
 /** 版本适配机制状态行：DSH 版本探测 + 设置 section 安装策略。 */
 function versionAdapters(dshVersion) {
 	const adapters = [];
@@ -1688,7 +1745,7 @@ async function buildReport(ctx, options) {
 	if (settingsInstallStrategy() === "none") warnings.push("设置 section 安装不可用：" + settingsInstallNote());
 	const parsed = parseDshVersion(dshVersion);
 	const testedMax = parseDshVersion(TESTED_DSH_MAX);
-	if (parsed && testedMax && compareDshVersions(parsed, testedMax) > 0) warnings.push("DSH " + dshVersion + " 高于已实测版本（0.1.3-alpha.2）：设置 API 按能力探测运行，异常时请回报适配矩阵");
+	if (parsed && testedMax && compareDshVersions(parsed, testedMax) > 0) warnings.push("DSH " + dshVersion + " 高于已实测版本（0.1.6-alpha.1）：设置 API 按能力探测运行，异常时请回报适配矩阵");
 	for (const guard of guards) if (!guard.active && guard.note) warnings.push(guard.note);
 	return {
 		pluginVersion: options?.version ?? pluginVersionOf(),
@@ -6966,6 +7023,29 @@ function snippetTargetOf(path) {
 	return isSnippetFilePath(path) ? path.replace(/\\/g, "/") : null;
 }
 /**
+* 本地文件系统版本令牌（mtime+size）：与 ctx.fs 的不透明版本串用途相同，
+* 仅供全局片段文件（走 node:fs 直读、不经 ctx.fs）在 edrv.read 时回带。
+* @author ddj 2026年09月15号
+* @param info node fs.Stats（stat 失败传 null）
+* @returns 版本令牌；取不到 → 空串（不启用护栏）
+*/
+function fileVersionOf(info) {
+	if (!info || typeof info.mtimeMs !== "number" || typeof info.size !== "number") return "";
+	return info.mtimeMs + ":" + info.size;
+}
+/**
+* 判定错误是否为「读取后文件已被外部修改」（版本守卫拒绝写入）。
+* 不依赖 host fs 的 FsError 类（外置模块，instanceof 不可靠），按错误码与文案双重判定。
+* @author ddj 2026年09月15号
+* @param error 捕获到的异常
+* @returns 是否为版本冲突
+*/
+function isStaleVersion(error) {
+	const err = error;
+	if (err && err.code === "FS_STALE_VERSION") return true;
+	return (err && typeof err.message === "string" ? err.message : String(error)).includes("changed since it was read");
+}
+/**
 * 手动保存收尾（edrv.save / edrv.saveBinary 共用）：目录树失效 + 该路径 pending
 * 文本差异记录标记 superseded 并归档（旧文本 diff 不得再应用到新内容上）。
 * @author ddj 2026年09月22号
@@ -7072,7 +7152,7 @@ async function integrationBaseUrlOf(ctx) {
 	return (typeof value?.integrationBaseUrl === "string" ? value.integrationBaseUrl.trim() : "") || "http://127.0.0.1:3080";
 }
 /** 各方法 handler 表（类型由 shared/rpc 的 RpcHandlerMap 约束）。 */
-function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx), lspHandlers, aiHandlers) {
+function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx), lspHandlers, aiHandlers, fileVersions) {
 	return {
 		...lspHandlers ?? {},
 		...aiHandlers ?? {},
@@ -7163,10 +7243,12 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 			const snippetTarget = snippetTargetOf(args.path);
 			if (snippetTarget && args.encoding !== "base64") try {
 				const content = await readFile(snippetTarget, "utf8");
+				const info = await stat(snippetTarget).catch(() => null);
 				return {
 					ok: true,
 					content,
-					size: content.length
+					size: content.length,
+					version: fileVersionOf(info)
 				};
 			} catch (error) {
 				return {
@@ -7204,7 +7286,8 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 						content: Buffer.from(bytes).toString("base64"),
 						size: bytes.byteLength,
 						encoding: "base64",
-						mime: binaryMimeOf(args.path)
+						mime: binaryMimeOf(args.path),
+						version: String(info.version ?? "")
 					};
 				}
 				if ((info.size ?? 0) > 8388608) return {
@@ -7215,7 +7298,8 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 				return {
 					ok: true,
 					content,
-					size: content.length
+					size: content.length,
+					version: String(info.version ?? "")
 				};
 			} catch (error) {
 				return {
@@ -7224,6 +7308,13 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 				};
 			}
 		},
+		"edrv.versions": async (args) => {
+			if (!fileVersions) return {
+				ok: false,
+				error: "文件版本观察器未装配"
+			};
+			return fileVersions.versions(args);
+		},
 		"edrv.original": async (args) => {
 			const sc = await requireSession(ctx, args.sessionId);
 			if ("err" in sc) return {
@@ -7300,10 +7391,23 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 			};
 			try {
 				const target = await resolveTarget(ctx, sc.session, args.path);
-				await fs.writeText(target, args.content, void 0, void 0, policyOf(ctx, sc.session));
+				const rev = typeof args.rev === "string" && args.rev ? args.rev : null;
+				const intent = rev ? {
+					kind: "replaceIfVersion",
+					version: rev
+				} : void 0;
+				const outcome = await fs.writeText(target, args.content, intent, void 0, policyOf(ctx, sc.session));
 				await afterManualSave(ctx, registry, sc, args.path);
-				return { ok: true };
+				return {
+					ok: true,
+					rev: outcome?.version ? String(outcome.version) : rev ?? void 0
+				};
 			} catch (error) {
+				if (isStaleVersion(error)) return {
+					ok: false,
+					conflict: true,
+					error: "文件已被外部修改，请先重新加载（或用编辑器内容覆盖）"
+				};
 				return {
 					ok: false,
 					error: "保存失败：" + String(error)
@@ -8231,8 +8335,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), lspHandlers, aiHandlers) {
-	const handler = buildHandlers(ctx, registry, searcher, contentSearcher, lspHandlers, aiHandlers)[method];
+async function handleRpc(ctx, registry, method, args, searcher = newSearcher(ctx), contentSearcher = newContentSearcher(ctx), lspHandlers, aiHandlers, fileVersions) {
+	const handler = buildHandlers(ctx, registry, searcher, contentSearcher, lspHandlers, aiHandlers, fileVersions)[method];
 	if (!handler) return {
 		ok: false,
 		error: "未知方法: " + String(method)
@@ -11665,6 +11769,118 @@ function createAiRpc(deps) {
 		})
 	} };
 }
+/** 基准表键：工作区根 + 归一化路径。 */
+function memoKey(cwd, path) {
+	return String(cwd).replace(/\\/g, "/") + "\0" + String(path).replace(/\\/g, "/");
+}
+/** 清理超期/超量记忆（每次写入前调用，摊还 O(1)）。 */
+function sweep(memos, now) {
+	if (memos.size === 0) return;
+	for (const [key, memo] of memos) if (now - memo.at > 3e5) memos.delete(key);
+	while (memos.size > 500) {
+		const oldest = memos.keys().next().value;
+		if (oldest === void 0) break;
+		memos.delete(oldest);
+	}
+}
+/**
+* 创建文件版本观察器（host 单例，随插件装配创建、卸载 dispose）。
+* @author ddj 2026年09月15号
+* @param ctx DSH host 上下文
+* @returns 观察器实例
+*/
+function createFileVersions(ctx) {
+	/** 基准表：memoKey → 上次观察到的版本（仅用于变化判定与树失效）。 */
+	const memos = /* @__PURE__ */ new Map();
+	/**
+	* 记录一次观察并按需失效目录树；返回本次是否为「变化」。
+	* @author ddj 2026年09月15号
+	* @param cwd 工作区根
+	* @param path 请求路径
+	* @param version 当前版本令牌（空串 = 后端不提供）
+	* @param present 磁盘上是否存在
+	* @returns 是否检测到变化
+	*/
+	const syncTree = (cwd, path, version, present) => {
+		const now = Date.now();
+		const key = memoKey(cwd, path);
+		const prev = memos.get(key);
+		sweep(memos, now);
+		const changed = prev !== void 0 && (prev.version !== version || !present);
+		memos.set(key, {
+			version,
+			at: now
+		});
+		if (changed) log.debug("检测到磁盘变化（已失效目录树）：" + path);
+		if (changed) invalidateIndex(ctx, cwd, path);
+		return changed;
+	};
+	/**
+	* 单条路径观察：解析 → stat → 组装条目（异常一律降级为 missing，不整批失败）。
+	* @author ddj 2026年09月15号
+	* @param fs host fs 服务
+	* @param cwd 工作区根（为空表示会话无工作区，跳过变化判定）
+	* @param path 请求路径
+	* @returns 版本条目
+	*/
+	const observe = async (fs, cwd, path) => {
+		try {
+			const target = await fs.resolve(path, cwd ? { cwd } : {});
+			const info = await fs.stat(target);
+			if (!info || info.type === "other") {
+				if (cwd) syncTree(cwd, path, "", false);
+				return {
+					path,
+					version: "",
+					type: "missing"
+				};
+			}
+			const version = info.version ? String(info.version) : "";
+			if (cwd) syncTree(cwd, path, version, true);
+			return {
+				path,
+				version,
+				size: typeof info.size === "number" ? info.size : void 0,
+				type: info.type
+			};
+		} catch (error) {
+			if (cwd) syncTree(cwd, path, "", false);
+			return {
+				path,
+				version: "",
+				type: "missing",
+				error: String(error)
+			};
+		}
+	};
+	/**
+	* 批查入口（RPC handler 直接委托）：同一会话的路径共享一次会话解析。
+	* @author ddj 2026年09月15号
+	* @param args 会话 id 与路径列表
+	* @returns 始终 ok 的逐条结果
+	*/
+	const versions = async (args) => {
+		const fs = ctx.get("fs");
+		const paths = (Array.isArray(args.paths) ? args.paths : []).filter((p) => typeof p === "string" && p.length > 0).slice(0, 200);
+		if (!fs || !paths.length) return {
+			ok: true,
+			items: []
+		};
+		const cwd = cwdOf(sessionOf(ctx, args.sessionId));
+		const items = [];
+		for (const path of paths) items.push(await observe(fs, cwd, path));
+		return {
+			ok: true,
+			items
+		};
+	};
+	return {
+		versions,
+		dispose() {
+			memos.clear();
+		}
+	};
+}
 //#endregion
 //#region src/index.ts
 /**
@@ -11721,6 +11937,8 @@ function apply(ctx, config) {
 		ctx,
 		settings: openSettings
 	}).handlers;
+	/** 文件磁盘新鲜度观察器（客户端轮询 edrv.versions；变化时顺带失效目录树缓存）。 */
+	const fileVersions = createFileVersions(ctx);
 	ctx.on("tools/result", (exec, result) => {
 		captureToolResult(ctx, registry, exec, result);
 	});
@@ -11736,7 +11954,7 @@ function apply(ctx, config) {
 		const sid = session?.id;
 		if (typeof sid === "string") lspRpc.disposeSession(sid);
 	});
-	registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher, contentSearcher, lspHandlers, aiHandlers), (warning) => warnings.push(warning));
+	registerRoutes(ctx, config, (method, args) => handleRpc(ctx, registry, method, args, searcher, contentSearcher, lspHandlers, aiHandlers, fileVersions), (warning) => warnings.push(warning));
 	installIsolation(ctx);
 	ctx.effect(() => shellMenuLifecycle(ctx));
 	sweepTreeCache();
@@ -11745,6 +11963,7 @@ function apply(ctx, config) {
 		lspManager.disposeAll().catch(() => {});
 		disposeAllServers();
 	});
+	ctx.effect(() => () => fileVersions.dispose());
 	hookExitReclaim();
 	log.info("编辑差异审查已装配（/edrv/rpc 路由就绪，项目 MCP 隔离已启用，语言服务器 LSP 已接入，规则注入" + (rulesInstalled ? "已接入" : "未接入") + "，技能组" + (skillsDispatched ? "装配中" : "未装配") + "）");
 }