dsh-vscode-mode 0.1.53 → 0.1.55

package/lib/index.js

@@ -556,6 +556,7 @@ function inDshRange(version, range) {
 function familyLabel(input) {
 	const version = parseDshVersion(input);
 	if (!version) return "未知";
+	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）";
 }
@@ -586,6 +587,48 @@ function detectDshVersion() {
 //#region src/shared/rpc.ts
 /** webServer 精确路由。 */
 const RPC_PATH = "/edrv/rpc";
+/**
+* 图片扩展名（小写、无点）→ MIME。edrv.read base64 响应与 client 图片预览共用，
+* 收敛在此避免 host/client 两处漂移。
+* @author ddj 2026年09月08号
+*/
+const IMAGE_MIME = {
+	png: "image/png",
+	jpg: "image/jpeg",
+	jpeg: "image/jpeg",
+	gif: "image/gif",
+	webp: "image/webp",
+	bmp: "image/bmp",
+	ico: "image/x-icon",
+	avif: "image/avif",
+	svg: "image/svg+xml"
+};
+/**
+* 路径 → 图片 MIME：按 basename 扩展名小写查 {@link IMAGE_MIME}，未命中回退 application/octet-stream。
+* @author ddj 2026年09月08号
+* @param path 文件路径（`/` 或 `\` 分隔均可）
+* @returns MIME 字符串
+*/
+function imageMimeOf(path) {
+	const base = String(path || "").split(/[\\/]/).pop() || "";
+	const dot = base.lastIndexOf(".");
+	const ext = dot > 0 ? base.slice(dot + 1).toLowerCase() : "";
+	return IMAGE_MIME[ext] ?? "application/octet-stream";
+}
+/** PDF 统一 MIME（host base64 响应与 client PDF 面板同源，避免两处漂移）。 */
+const PDF_MIME = "application/pdf";
+/**
+* 路径 → 二进制预览 MIME：PDF 特判 {@link PDF_MIME}，其余走图片表回退 octet-stream。
+* @author ddj 2026年09月22号
+* @param path 文件路径（`/` 或 `\` 分隔均可）
+* @returns MIME 字符串
+*/
+function binaryMimeOf(path) {
+	const base = String(path || "").split(/[\\/]/).pop() || "";
+	const dot = base.lastIndexOf(".");
+	if (dot > 0 && base.slice(dot + 1).toLowerCase() === "pdf") return PDF_MIME;
+	return imageMimeOf(path);
+}
 //#endregion
 //#region src/paths.ts
 /**
@@ -959,7 +1002,7 @@ function detectGuards(ctx) {
 	}];
 }
 /** 已实测覆盖的最高 DSH 版本（适配矩阵上界，超过则提示，见 buildReport）。 */
-const TESTED_DSH_MAX = "0.1.2-alpha.4";
+const TESTED_DSH_MAX = "0.1.3-alpha.2";
 /** 版本适配机制状态行：DSH 版本探测 + 设置 section 安装策略。 */
 function versionAdapters(dshVersion) {
 	const adapters = [];
@@ -1005,7 +1048,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.2-alpha.4）：设置 API 按能力探测运行，异常时请回报适配矩阵");
+	if (parsed && testedMax && compareDshVersions(parsed, testedMax) > 0) warnings.push("DSH " + dshVersion + " 高于已实测版本（0.1.3-alpha.2）：设置 API 按能力探测运行，异常时请回报适配矩阵");
 	for (const guard of guards) if (!guard.active && guard.note) warnings.push(guard.note);
 	return {
 		pluginVersion: options?.version ?? pluginVersionOf(),
@@ -1034,6 +1077,7 @@ const IMG_ROUTES = [{
 /** Monaco AMD 构建静态资源（随包发布，离线可用；前缀路由 /edrv/vendor/*）。 */
 const VENDOR_MIME = {
 	".js": "text/javascript; charset=utf-8",
+	".mjs": "text/javascript; charset=utf-8",
 	".css": "text/css; charset=utf-8",
 	".json": "application/json",
 	".map": "application/json",
@@ -1046,7 +1090,9 @@ const VENDOR_MIME = {
 	".woff2": "font/woff2",
 	".ttf": "font/ttf",
 	".html": "text/html; charset=utf-8",
-	".md": "text/markdown"
+	".md": "text/markdown",
+	".bcmap": "application/octet-stream",
+	".pfb": "application/octet-stream"
 };
 /** 图标目录（paths.ts 统一解析：config.imageDir 覆盖优先，否则插件包 assets/）。 */
 const imgDirOf = (config) => imageDirOf(config, import.meta.url);
@@ -1569,6 +1615,8 @@ function archiveEntryFor(recs, cwd, reason) {
 		}))
 	};
 }
+/** 二进制预览/写回上限（PDF 等整文件 base64 传输；文本侧仍用 READ_CAP）。 */
+const BINARY_READ_CAP = 33554432;
 /** 会话沙箱策略（policyOf）：可能不存在，调用方需容忍 undefined。 */
 function policyOf(ctx, session) {
 	const svc = ctx.get("sandboxPolicy");
@@ -5877,6 +5925,31 @@ async function requireSession(ctx, sessionId) {
 	};
 }
 /**
+* 手动保存收尾（edrv.save / edrv.saveBinary 共用）：目录树失效 + 该路径 pending
+* 文本差异记录标记 superseded 并归档（旧文本 diff 不得再应用到新内容上）。
+* @author ddj 2026年09月22号
+* @param ctx DSH 上下文
+* @param registry 差异记录桶注册表
+* @param sc requireSession 成功结果（session + cwd）
+* @param path 保存的文件路径
+*/
+async function afterManualSave(ctx, registry, sc, path) {
+	invalidateIndex(ctx, sc.cwd, path);
+	const bucket = await bucketOf(registry, ctx, sc.cwd);
+	let changed = false;
+	for (const rec of bucket.values()) if (rec.path === path && rec.superseded !== true) {
+		rec.superseded = true;
+		rec.at = (/* @__PURE__ */ new Date()).toISOString();
+		changed = true;
+	}
+	if (changed) {
+		const done = [];
+		for (const rec of bucket.values()) if (rec.path === path && rec.superseded) done.push(rec);
+		if (done.length) await archiveRecords(ctx, sc.session, sc.cwd, bucket, done, "被手动编辑覆盖");
+		else await saveBucket(ctx, sc.cwd, bucket, sc.session);
+	}
+}
+/**
 * 批量决策核心：一次会话/桶解析 + 逐项处理 + 统一落盘（accept/reject 单条与 decideBatch 共用）。
 * rejected 项先做回滚，失败记入该项 error 且不改决策；本批次新增"已解决"记录一次性归档，
 * 有任何成功项则整桶只写盘一次，避免逐条读写整个 sidecar。
@@ -6055,6 +6128,20 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 					error: "文件不存在",
 					resolvedPath: fs.processPath(target)
 				};
+				if ((info.size ?? 0) > 33554432) return {
+					ok: false,
+					error: "文件过大（>32MB），不支持整文件预览"
+				};
+				if (args.encoding === "base64") {
+					const bytes = await fs.readBytes(target, void 0, BINARY_READ_CAP);
+					return {
+						ok: true,
+						content: Buffer.from(bytes).toString("base64"),
+						size: bytes.byteLength,
+						encoding: "base64",
+						mime: binaryMimeOf(args.path)
+					};
+				}
 				if ((info.size ?? 0) > 8388608) return {
 					ok: false,
 					error: "文件过大（>8MB），不支持整文件预览"
@@ -6139,20 +6226,7 @@ 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));
-				invalidateIndex(ctx, sc.cwd, args.path);
-				const bucket = await bucketOf(registry, ctx, sc.cwd);
-				let changed = false;
-				for (const rec of bucket.values()) if (rec.path === args.path && rec.superseded !== true) {
-					rec.superseded = true;
-					rec.at = (/* @__PURE__ */ new Date()).toISOString();
-					changed = true;
-				}
-				if (changed) {
-					const done = [];
-					for (const rec of bucket.values()) if (rec.path === args.path && rec.superseded) done.push(rec);
-					if (done.length) await archiveRecords(ctx, sc.session, sc.cwd, bucket, done, "被手动编辑覆盖");
-					else await saveBucket(ctx, sc.cwd, bucket, sc.session);
-				}
+				await afterManualSave(ctx, registry, sc, args.path);
 				return { ok: true };
 			} catch (error) {
 				return {
@@ -6161,6 +6235,52 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx), contentSearch
 				};
 			}
 		},
+		"edrv.saveBinary": async (args) => {
+			if (args.encoding !== "base64") return {
+				ok: false,
+				error: "仅支持 base64 编码"
+			};
+			const sc = await requireSession(ctx, args.sessionId);
+			if ("err" in sc) return {
+				ok: false,
+				error: sc.err
+			};
+			const fs = ctx.get("fs");
+			if (!fs) return {
+				ok: false,
+				error: "缺少 fs"
+			};
+			try {
+				const target = await resolveTarget(ctx, sc.session, args.path);
+				const info = await fs.stat(target);
+				if (!info || info.type !== "file") return {
+					ok: false,
+					error: "文件不存在"
+				};
+				const rootTarget = await fs.resolve(policyOf(ctx, sc.session)?.workspaceRoot ?? ".", {});
+				if (!fs.contains(rootTarget, target)) return {
+					ok: false,
+					error: "拒绝保存：目标不在会话工作区内"
+				};
+				const bytes = Buffer.from(args.content, "base64");
+				if (bytes.byteLength === 0) return {
+					ok: false,
+					error: "内容为空，拒绝写回"
+				};
+				if (bytes.byteLength > 33554432) return {
+					ok: false,
+					error: "内容过大（>32MB），拒绝写回"
+				};
+				await writeFile(fs.processPath(target), bytes);
+				await afterManualSave(ctx, registry, sc, args.path);
+				return { ok: true };
+			} catch (error) {
+				return {
+					ok: false,
+					error: "二进制保存失败：" + String(error)
+				};
+			}
+		},
 		"edrv.archiveList": async (args) => {
 			const sc = await requireSession(ctx, args.sessionId);
 			if ("err" in sc) return {