dsh-vscode-mode 0.5.1 → 0.5.2

package/README.md

@@ -347,13 +347,13 @@ TortoiseSVN（`TortoiseProc.exe`）仅作 Windows 过渡增强：自研能力覆
 
 ```bash
 # ① Git 安装（clone + prepare 构建；推荐打固定 tag）
-dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.5.1
+dsh plugin --profile web add github:Lenonss/DSH_VsCodeMode#v0.5.2
 
 # ② npm 注册表（发布到 npm 后）
 dsh plugin --profile web add dsh-vscode-mode
 
 # ③ GitHub Release tgz 直装
-dsh plugin --profile web add https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.5.1/dsh-vscode-mode-0.5.1.tgz
+dsh plugin --profile web add https://github.com/Lenonss/DSH_VsCodeMode/releases/download/v0.5.2/dsh-vscode-mode-0.5.2.tgz
 ```
 
 > `dsh plugin ...` 是 pnpm 转发器：git 安装会克隆仓库、执行该包 `prepare` 脚本
@@ -640,6 +640,13 @@ Keep All / Undo All 却是亮的。修复：单文件 Keep / Undo 覆盖冲突
 完整变更见 [GitHub Releases](https://github.com/Lenonss/DSH_VsCodeMode/releases)。
 近期关键版本：
 
+- **v0.5.2**：**修复 macOS / npm 安装形态的兼容问题**——① schema 库按候选链解析
+  （官方已把 vendored schemastery 改名为 `@deepseek-ai/schemastery`，安装树里没有裸
+  `schemastery`），且 `@deepseek-ai/dsh-settings` 缺失不再拖垮整体 → 修复从 npm 安装时
+  「设置 section 尚未装配 / 设置持久化未安装」（开发形态因有 devDependency 副本而不复现）；
+  ② VSIX 解包保留归档自带 Unix 执行位并按入口名兜底补 0o755 → 修复 macOS/Linux 上语言
+  服务器 spawn `EACCES` 起不来；③ 删除新建文件按平台分派删除命令（macOS/Linux 不再先试
+  PowerShell 再回落）。
 - **v0.5.1**：**适配 DSH 0.1.6-alpha.2**——会话作用域三级取值链（`uiSession.current`
   优先，兼容旧版 `sessions.list.current`；修复官方移除 `current` 后 Monaco 预热 / LSP
   同步 / 编辑 Tab 恢复 / 文件链接静默失效）；Office 与官方「不可预览」后缀让位官方

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 尚未装配";
@@ -1698,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 服务",
@@ -4256,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) {
@@ -4293,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。 */
@@ -9864,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);
@@ -9884,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);
@@ -9919,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;
@@ -9960,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 清单对象
@@ -9985,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");