dsh-vscode-mode 0.5.0 → 0.5.2

package/lib/index.js

@@ -1,7 +1,7 @@
 import { createRequire } from "node:module";
 import { chmod, copyFile, cp, mkdir, readFile, readdir, rename, rm, stat, truncate, writeFile } from "node:fs/promises";
 import { basename, dirname, extname, join, normalize, resolve, sep } from "node:path";
-import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, symlinkSync, watch, writeFileSync } from "node:fs";
+import { chmodSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, symlinkSync, watch, writeFileSync } from "node:fs";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { homedir, tmpdir } from "node:os";
 import { createHash, randomUUID } from "node:crypto";
@@ -330,17 +330,83 @@ async function hostImport(specifier) {
 	return import(specifier);
 }
 /**
-* 动态加载设置依赖（模块级缓存；任一缺失/失败返回 null 而非抛错）。
-* installSettingsSection 仅在 rc 线 dsh-settings 中存在时提供（alpha 起移除，
-* 属性探测得到 undefined，不抛错）。
-* @author ddj 2026年08月24号 / 2026年09月15号
+* schema 库候选名（新名在前）。
+* DSH 官方自 0.1.5 起把 vendored 包改名为 @deepseek-ai/schemastery 并全树改用新名，
+* 安装树里**没有**裸 schemastery；裸名保留给 rc 线（其 dsh-settings 仍 peers 旧名），
+* 也让开发形态（插件 node_modules 有 devDependency 副本）继续可用。
+*/
+const SCHEMA_SPECIFIERS = ["@deepseek-ai/schemastery", "schemastery"];
+/** 设置持久化包名（installSettingsSection 仅 rc 线提供，alpha 线缺失属正常）。 */
+const SETTINGS_SPECIFIER = "@deepseek-ai/dsh-settings";
+/**
+* 逐个尝试候选名，返回首个加载成功的模块及其包名（全失败返回 null，不抛错）。
+* @author ddj 2026年09月18号
+* @param specifiers 候选包名（按优先级）
+* @param importFn 加载函数（测试注入）
+* @returns 命中的模块与包名；全失败返回 null
+*/
+async function firstImport(specifiers, importFn = hostImport) {
+	for (const specifier of specifiers) try {
+		return {
+			specifier,
+			module: await importFn(specifier)
+		};
+	} catch {}
+	return null;
+}
+/**
+* 抹平 schema 库的 ESM/CJS 互操作形态取默认导出。
+* 三种实测形态：真 ESM（`default` 即 z）、CJS 经 import()（`default` 与
+* `module.exports` 同为 z）、双层包装（`default.default` 才是 z）。
+* @author ddj 2026年09月18号
+* @param module 加载到的模块命名空间（可空）
+* @returns 具备 object/string 等构造器的 z；取不到返回 null
+*/
+function pickSchema(module) {
+	const layers = [
+		module,
+		module?.default,
+		module?.["module.exports"]
+	];
+	for (const layer of layers) {
+		const z = layer?.default ?? layer;
+		if (z && typeof z.object === "function" && typeof z.string === "function") return z;
+	}
+	return null;
+}
+/** 实际命中的 schema 库名（供兼容性报告展示；未命中为空串）。 */
+let schemaLib = "";
+/**
+* 读取实际命中的 schema 库名（报告文案用）。
+* @author ddj 2026年09月18号
+* @returns 包名；未解析到为空串
+*/
+function schemaLibName() {
+	return schemaLib;
+}
+/**
+* 动态加载设置依赖（模块级缓存；schema 库缺失返回 null 而非抛错）。
+* ⚠️ 两个依赖**独立解析**：@deepseek-ai/dsh-settings 仅 rc 线跑 legacy 策略时需要，
+* alpha 线走 settings 服务 installSection 用不到它；原先 Promise.all 让该包缺失
+* 拖垮整体 → 用户端（npm 安装）settings section 永不装配。
+* 同理，schema 库按候选链解析（安装树只有新名 @deepseek-ai/schemastery）。
+* @author ddj 2026年08月24号 / 2026年09月15号 / 2026年09月18号
+* @param importFn 加载函数（测试注入；缺省宿主锚点动态导入）
 * @returns 设置依赖或 null
 */
-function loadSettingsDeps() {
-	if (!depsPromise) depsPromise = Promise.all([hostImport("@deepseek-ai/dsh-settings"), hostImport("schemastery")]).then(([dshSettings, schemastery]) => ({
-		installSettingsSection: dshSettings.installSettingsSection,
-		z: schemastery.default
-	})).catch(() => null);
+function loadSettingsDeps(importFn = hostImport) {
+	if (!depsPromise) depsPromise = Promise.all([firstImport([SETTINGS_SPECIFIER], importFn), firstImport(SCHEMA_SPECIFIERS, importFn)]).then(([settingsHit, schemaHit]) => {
+		const z = pickSchema(schemaHit?.module);
+		if (!z) {
+			schemaLib = "";
+			return null;
+		}
+		schemaLib = schemaHit?.specifier ?? "";
+		return {
+			installSettingsSection: (settingsHit?.module)?.installSettingsSection,
+			z
+		};
+	}).catch(() => null);
 	return depsPromise;
 }
 const INSTALL_UNMOUNTED = "设置 section 尚未装配";
@@ -824,10 +890,17 @@ function inDshRange(version, range) {
 	}
 	return true;
 }
-/** 版本线标签：报告与文档展示版本归属；不可解析返回 '未知'。 */
+/**
+* 版本线标签：报告与文档展示版本归属；不可解析返回 '未知'。
+* 逐线自新到旧匹配，先命中先返回（区间无上界，故顺序即优先级）。
+* @author ddj 2026年09月02号 / 2026年09月18号
+* @param input 版本串（如 '0.1.6-alpha.2'）
+* @returns 版本线标签
+*/
 function familyLabel(input) {
 	const version = parseDshVersion(input);
 	if (!version) return "未知";
+	if (inDshRange(version, { from: "0.1.6-alpha.2" })) return "0.1.6-alpha.2 及更新（会话多实例共存 + 回合改动卡片 + Office 侧栏预览 + 侧栏浏览器）";
 	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）";
@@ -1691,7 +1764,7 @@ function detectExternal(ctx, depsAvailable) {
 		{
 			name: "设置持久化（@deepseek-ai/dsh-settings）",
 			active: depsAvailable,
-			note: depsAvailable ? "设置 section 已安装" : "未安装：fileOpenTool 持久化降级为配置值"
+			note: depsAvailable ? "设置 section 已安装（schema: " + (schemaLibName() || "未知") + "）" : "未安装：fileOpenTool 持久化降级为配置值"
 		},
 		{
 			name: "settings 服务",
@@ -1765,7 +1838,7 @@ function detectGuards(ctx) {
 	}];
 }
 /** 已实测覆盖的最高 DSH 版本（适配矩阵上界，超过则提示，见 buildReport）。 */
-const TESTED_DSH_MAX = "0.1.6-alpha.1";
+const TESTED_DSH_MAX = "0.1.6-alpha.2";
 /** 版本适配机制状态行：DSH 版本探测 + 设置 section 安装策略。 */
 function versionAdapters(dshVersion) {
 	const adapters = [];
@@ -1811,7 +1884,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.6-alpha.1）：设置 API 按能力探测运行，异常时请回报适配矩阵");
+	if (parsed && testedMax && compareDshVersions(parsed, testedMax) > 0) warnings.push("DSH " + dshVersion + " 高于已实测版本（0.1.6-alpha.2）：设置 API 按能力探测运行，异常时请回报适配矩阵");
 	for (const guard of guards) if (!guard.active && guard.note) warnings.push(guard.note);
 	return {
 		pluginVersion: options?.version ?? pluginVersionOf(),
@@ -4249,8 +4322,33 @@ function newContentSearcher(ctx) {
 //#endregion
 //#region src/revert.ts
 /**
+* 删除单文件的 argv（纯函数，platform 可注入便于单测）。
+* Windows 走 PowerShell Remove-Item；其余平台走 /bin/rm。
+* 原先无条件先发 powershell：macOS/Linux 上必然 spawn 失败后才回落，
+* 每删一个文件多一次无谓 spawn 与失败噪声。
+* @author ddj 2026年09月18号
+* @param absPath 绝对路径
+* @param platform 目标平台（缺省当前进程平台）
+* @returns 删除命令 argv
+*/
+function removeFileArgv(absPath, platform = process.platform) {
+	if (platform === "win32") return [
+		"powershell",
+		"-NoProfile",
+		"-NonInteractive",
+		"-Command",
+		"Remove-Item -LiteralPath \"" + absPath + "\" -Force"
+	];
+	return [
+		"/bin/rm",
+		"-f",
+		"--",
+		absPath
+	];
+}
+/**
 * 删除新建文件（拒绝创建时）：subprocess 删除，路径先经 fs.contains 校验工作区边界。
-* @author ddj 2026年08月20号
+* @author ddj 2026年08月20号 / 2026年09月18号
 * @returns 成功或失败原因
 */
 async function deleteCreated(ctx, session, record) {
@@ -4286,29 +4384,13 @@ async function deleteCreated(ctx, session, record) {
 		}
 	};
 	try {
-		await attempt([
-			"powershell",
-			"-NoProfile",
-			"-NonInteractive",
-			"-Command",
-			"Remove-Item -LiteralPath \"" + p + "\" -Force"
-		]);
+		await attempt(removeFileArgv(p));
 		return { ok: true };
 	} catch (error) {
-		try {
-			await attempt([
-				"/bin/rm",
-				"-f",
-				"--",
-				p
-			]);
-			return { ok: true };
-		} catch (error2) {
-			return {
-				ok: false,
-				error: "删除失败（文件仍存在）：" + String(error) + " / " + String(error2)
-			};
-		}
+		return {
+			ok: false,
+			error: "删除失败（文件仍存在）：" + String(error)
+		};
 	}
 }
 /** 整调用回滚：write/编辑用 before 整文件恢复；新建文件转 deleteCreated。 */
@@ -9857,9 +9939,9 @@ const CDIR_SIG = 33639248;
 const LHDR_SIG = 67324752;
 /**
 * 解析 ZIP 缓冲区 → 条目列表（不解压内容，仅元数据）。
-* @author ddj 2026年08月27号
+* @author ddj 2026年08月27号 / 2026年09月18号
 * @param buf zip 字节
-* @returns 条目元数据
+* @returns 条目元数据（含 Unix mode，见 modeOf）
 */
 function zipEntries(buf) {
 	const eocd = findEocd(buf);
@@ -9877,22 +9959,36 @@ function zipEntries(buf) {
 		const commentLen = buf.readUInt16LE(offset + 32);
 		const localOffset = buf.readUInt32LE(offset + 42);
 		const name = buf.subarray(offset + 46, offset + 46 + nameLen).toString("utf8");
+		const mode = modeOf(buf.readUInt32LE(offset + 38));
 		out.push({
 			name,
 			method,
 			compressed,
 			uncompressed,
-			localOffset
+			localOffset,
+			...mode === void 0 ? {} : { mode }
 		});
 		offset += 46 + nameLen + extraLen + commentLen;
 	}
 	return out;
 }
 /**
+* 中央目录 external attributes → Unix 权限位。
+* ZIP 把 Unix mode 放在 `st_mode << 16`（含 S_IFREG 等类型位），低 16 位仅 DOS 属性；
+* 故必须右移 16 再取低 9 位权限。非 Unix 归档（Windows 打包）该字段为 0 或纯 DOS 位。
+* @author ddj 2026年09月18号
+* @param attributes 中央目录 offset+38 的 4 字节
+* @returns 0o000~0o777 权限位；无有效 mode 返回 undefined
+*/
+function modeOf(attributes) {
+	const mode = attributes >>> 16 & 511;
+	return mode === 0 ? void 0 : mode;
+}
+/**
 * 解压 ZIP → 条目列表（目录条目含尾部 /）。
-* @author ddj 2026年08月27号
+* @author ddj 2026年08月27号 / 2026年09月18号
 * @param buf zip 字节
-* @returns 条目（含内容）
+* @returns 条目（含内容与可选 mode）
 */
 function unzip(buf) {
 	const metas = zipEntries(buf);
@@ -9912,7 +10008,8 @@ function unzip(buf) {
 		out.push({
 			path: meta.name,
 			data,
-			isDirectory: isDir
+			isDirectory: isDir,
+			...meta.mode === void 0 ? {} : { mode: meta.mode }
 		});
 	}
 	return out;
@@ -9953,8 +10050,60 @@ function vsixManifest(vsix) {
 	throw new Error("VSIX 缺少 extension/package.json");
 }
 /**
+* 判定解包路径是否为可执行入口（无 mode 时的启发式兜底）。
+* 只认确定语义：`bin/` 段下的文件、语言服务器/运行时常见可执行名、`.sh` 脚本。
+* @author ddj 2026年09月18号
+* @param rel 相对路径（/ 分隔）
+* @returns 是否应补执行位
+*/
+function looksExec(rel) {
+	const path = String(rel ?? "").replace(/\\/g, "/");
+	if (!path) return false;
+	if (path.split("/").includes("bin")) return true;
+	if (/\.(sh|bash|zsh)$/i.test(path)) return true;
+	const base = (path.split("/").pop() ?? "").replace(/\.exe$/i, "");
+	return [
+		"lua-language-server",
+		"emmylua_ls",
+		"OmniSharp",
+		"dotnet",
+		"node"
+	].includes(base);
+}
+/**
+* 计算解包后要施加的权限位（纯函数，可单测）。
+* 优先信任归档自带的 Unix mode 中的执行位（VS Code 自身解 VSIX 即此口径）；
+* 归档无 mode（Windows 打包的 VSIX）时按路径启发式补 0o755；
+* 其余保持 undefined（交给 umask 默认，不越权改动）。
+* @author ddj 2026年09月18号
+* @param entry 解压条目
+* @returns 目标权限位；无需处理返回 undefined
+*/
+function execModeOf(entry) {
+	if (entry.isDirectory) return void 0;
+	const mode = entry.mode;
+	if (mode !== void 0 && (mode & 73) !== 0) return mode;
+	return looksExec(entry.path) ? 493 : void 0;
+}
+/**
+* 落盘后补可执行位（POSIX 专属；Windows 无此概念，直接跳过）。
+* 必须 best-effort：只读文件系统/无权限时不能拖垮整个扩展安装。
+* @author ddj 2026年09月18号
+* @param target 落盘绝对路径
+* @param entry 解压条目
+* @param platform 目标平台（测试注入）
+*/
+function applyExecBit(target, entry, platform = process.platform) {
+	if (platform === "win32") return;
+	const mode = execModeOf(entry);
+	if (mode === void 0) return;
+	try {
+		chmodSync(target, mode);
+	} catch (error) {}
+}
+/**
 * 解包 VSIX 到目录（仅取 extension/ 子树，剥前缀；返回清单）。
-* @author ddj 2026年08月27号
+* @author ddj 2026年08月27号 / 2026年09月18号
 * @param vsix vsix 字节
 * @param dest 目标目录（已存在则先清空）
 * @returns 清单对象
@@ -9978,6 +10127,7 @@ function unpackVsix(vsix, dest) {
 		}
 		mkdirSync(dirname(target), { recursive: true });
 		writeFileSync(target, entry.data);
+		applyExecBit(target, entry);
 		if (rel === "package.json") manifest = JSON.parse(entry.data.toString("utf8"));
 	}
 	if (!manifest) throw new Error("VSIX 解包后缺少 package.json");