dsh-vscode-mode 0.1.21 → 0.1.23

package/lib/index.js

@@ -378,6 +378,7 @@ function detectExternal(ctx, depsAvailable) {
 	const mcpCount = entriesOf(ctx).length;
 	const settings = ctx.get("settings");
 	const hasSettings = Boolean(settings?.describe || settings?.update);
+	const sub = ctx.get("subprocess");
 	return [
 		{
 			name: MCP_PACKAGE,
@@ -393,6 +394,11 @@ function detectExternal(ctx, depsAvailable) {
 			name: "settings 服务",
 			active: hasSettings,
 			note: hasSettings ? "可读写设置" : "不可用（设置读写走配置回退）"
+		},
+		{
+			name: "文件浏览器打开（subprocess 服务）",
+			active: typeof sub?.spawn === "function",
+			note: typeof sub?.spawn === "function" ? "可定位/打开 OS 文件浏览器" : "不可用（右键「在文件浏览器中打开」将提示失败）"
 		}
 	];
 }
@@ -2451,6 +2457,73 @@ function toTreeEntries(rel, children) {
 	return out.sort(entryOrder);
 }
 //#endregion
+//#region src/reveal.ts
+/**
+* dsh-vscode-mode host — 在 OS 文件浏览器中打开/定位路径（reveal 能力）。
+* 纯函数 revealCommand 平台分发 + revealInExplorer 经 ctx.subprocess.spawn 发射
+* （argv 数组、无 shell 插值，沿 workspace/revert 的 subprocess 契约）。
+* 文件 → 资源管理器选中定位；目录 → 打开目录；Linux 无通用定位协议 → 打开所在目录。
+* 作者 ddj 2026-08-27
+*/
+/**
+* 构造平台 opener 的 argv（纯函数，platform 可注入便于单测）。
+* @author ddj 2026年08月27号
+* @param absPath 绝对路径
+* @param isDir 是否为目录
+* @param platform 目标平台（缺省当前进程平台）
+* @returns opener argv（无 shell 插值）
+*/
+function revealCommand(absPath, isDir, platform = process.platform) {
+	switch (platform) {
+		case "darwin": return { argv: [
+			"open",
+			"-R",
+			absPath
+		] };
+		case "win32": return isDir ? { argv: ["explorer.exe", absPath] } : { argv: [
+			"explorer.exe",
+			"/select,",
+			absPath
+		] };
+		default: return { argv: ["xdg-open", isDir ? absPath : dirname(absPath)] };
+	}
+}
+/**
+* 经 host subprocess 服务发射 opener（fire-and-forget 语义）。
+* Explorer 为 GUI 分离进程，非零退出码不视为失败；仅 spawn 级错误回失败。
+* @author ddj 2026年08月27号
+* @param ctx DSH host 上下文
+* @param absPath 绝对路径
+* @param isDir 是否为目录
+* @returns 成功或失败原因
+*/
+async function revealInExplorer(ctx, absPath, isDir) {
+	const sub = ctx.get("subprocess");
+	if (!sub || typeof sub.spawn !== "function") return {
+		ok: false,
+		error: "打开文件浏览器不可用：缺少 subprocess 服务"
+	};
+	const { argv } = revealCommand(absPath, isDir);
+	try {
+		await sub.spawn({
+			argv,
+			cwd: dirname(absPath),
+			stdio: {
+				stdout: { maxBytes: 65536 },
+				stderr: { maxBytes: 65536 },
+				stdin: "ignore"
+			},
+			graceMs: 1e4
+		}).done;
+		return { ok: true };
+	} catch (error) {
+		return {
+			ok: false,
+			error: "打开失败：" + String(error)
+		};
+	}
+}
+//#endregion
 //#region src/rpc.ts
 /** cwd → Promise 链：串行化 debug 日志追加（fs read+write 非原子，避免并发丢行）。 */
 const debugWriteQueues = /* @__PURE__ */ new Map();
@@ -2925,6 +2998,46 @@ function buildHandlers(ctx, registry, searcher = newSearcher(ctx)) {
 				};
 			}
 		},
+		"edrv.revealInExplorer": async (args) => {
+			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 rel = normalizeRel(args.path);
+				if (rel === null) return {
+					ok: false,
+					error: "路径不合法"
+				};
+				const target = await fs.resolve(rel || ".", { cwd: sc.cwd });
+				const info = await fs.stat(target);
+				if (!info) return {
+					ok: false,
+					error: "路径不存在"
+				};
+				const abs = fs.processPath(target);
+				const outcome = await revealInExplorer(ctx, abs, info.type === "directory");
+				if (!outcome.ok) return {
+					ok: false,
+					error: outcome.error
+				};
+				return {
+					ok: true,
+					revealed: abs
+				};
+			} catch (error) {
+				return {
+					ok: false,
+					error: "打开失败：" + String(error)
+				};
+			}
+		},
 		"mcp.list": async () => ({
 			ok: true,
 			...listMcp(ctx)