@dsh-xhl/dsh-file-explorer 0.1.5 → 0.1.6

package/README.md

@@ -4,10 +4,14 @@
 
 ## 功能
 
-- **标题栏图标**（`conversation.session.header.utilities`）：一个内置编辑器图标，点击打开文件预览 / 编辑弹窗
-  - **Hero / 新建会话同样显示**：同一图标通过框架通用浮层 `shell.overlay` 由插件自身定位到会话列右上角（hero 阶段显示，有记录后由标题栏图标接管，无重复）；纯插件实现，不改动框架代码（详见 `docs/hero-filex-button.md`）
-  - **对话内点击文件 → 编辑器预览**：聊天里的文件路径链接（工具行、产物行、正文提及）默认用系统程序打开；插件拦截 `remote.session.openWorkspacePath` 与 `workspaces.openPath` 两条通道，改为在编辑器弹窗中预览（目录或 cwd 外的路径仍落回系统打开）
-  - 打开系统文件夹 / 在外部编辑器（如 VS Code）打开工作区**由 DSH 新版壳自带**，本插件不再提供模式下拉与外部启动器，只保留内置编辑器
+- **聊天页标题栏图标**（`conversation.session.header.utilities`）：一个内置编辑器图标，点击打开文件预览 / 编辑弹窗（聊天页保持与现状一致，无下拉）
+- **Hero / 新建会话页 ButtonGroup**：同一浮层位置由插件定位到会话列右上角（hero 阶段显示，有记录后由标题栏图标接管，无重复）；hero 上为**左主按钮 + 右下拉**的组合：
+  - **编辑器**（默认）：点击打开文件预览 / 编辑弹窗（Ctrl+P 亦可）
+  - **文件夹**：点击直接打开会话工作区所在的**系统文件夹**（Windows `explorer` / macOS `open` / Linux `xdg-open`）
+  - **VSCode**：点击用 `code` 命令行在 **VS Code** 中打开会话工作区（自动探测安装位置 / PATH；未安装则该项自动隐藏）
+  - 选择记忆在 localStorage，点击后底部提示确认打开的路径；下拉选中某项会先切换默认打开方式，随后立即执行对应的打开动作
+  - 纯插件实现，不改动框架代码（详见 `docs/hero-filex-button.md`）
+- **对话内点击文件 → 编辑器预览**：聊天里的文件路径链接（工具行、产物行、正文提及）默认用系统程序打开；插件拦截 `remote.session.openWorkspacePath` 与 `workspaces.openPath` 两条通道，改为在编辑器弹窗中预览（目录或 cwd 外的路径仍落回系统打开）
 - **文件列表**：左侧目录树（跳过 `node_modules`/`.git`/`dist` 等）
 - **按文件名过滤**：输入即过滤
 - **全文搜索**：正则 / 大小写 / 全词匹配、包含/排除过滤，结果按文件分组、命中高亮，点击跳转并高亮匹配
@@ -20,11 +24,11 @@
 
 ```
 src/
-  index.ts            Host：/filex/api JSON 路由（session.cwd / fs.list / fs.read / fs.write / fs.search）
+  index.ts            Host：/filex/api JSON 路由（session.cwd / fs.list / fs.read / fs.write / fs.search / fs.reveal / fs.vscode / fs.capabilities）
                       + /filex/file 媒体路由（图片/PDF 字节），loopback 信任围栏
   trust-fence.ts      Host-header loopback 校验（DNS-rebinding 防护）
   client/
-    index.tsx         入口：header 图标（内置编辑器）+ overlay 弹窗 + Ctrl+P 快捷键
+    index.tsx         入口：聊天页 header 图标（内置编辑器）+ hero 模式 ButtonGroup + overlay 弹窗 + Ctrl+P 快捷键
     Explorer.tsx      弹窗：文件树 / 文件名过滤 / 全文搜索 / 查看器分派（primitives 重排）
     TextEditor.tsx    CodeMirror 6 编辑器 + 搜索跳转高亮
     lang.ts           扩展名 → CodeMirror 语言映射

package/lib/client.js

@@ -49,6 +49,15 @@ window.__ModuleLoader__.load({
 				path,
 				content
 			}),
+			fsReveal: (scope, cwd, signal) => call("fs.reveal", {
+				sessionId: scope.sessionId,
+				...cwd !== void 0 && cwd !== "" ? { cwd } : {}
+			}, signal),
+			fsVscode: (scope, cwd, signal) => call("fs.vscode", {
+				sessionId: scope.sessionId,
+				...cwd !== void 0 && cwd !== "" ? { cwd } : {}
+			}, signal),
+			fsCapabilities: (signal) => call("fs.capabilities", {}, signal),
 			fsSearch: (scope, pattern, options, include, exclude, signal) => call("fs.search", {
 				sessionId: scope.sessionId,
 				pattern,
@@ -37010,8 +37019,19 @@ window.__ModuleLoader__.load({
    the width / padding / radius need pinning down. */
 .filex-header-btn{width:28px;height:28px;padding:0;border-radius:14px}
 
+/* ── hero ButtonGroup (shell.overlay entry) ──────────────────────────── */
+/* The mode group shown only on the hero / new-session screen: the left
+   button carries the remembered mode's icon, the right chevron the mode
+   dropdown. Outer corners reuse the in-chat header-button radius (14px on
+   a 28px-tall button = a fully round cap), so the group reads as one pill
+   with the same curve as the session header icon. */
+.filex-group{display:inline-flex;align-items:center;position:relative;height:28px}
+.filex-group .filex-group-main,.filex-group .filex-group-trigger{height:28px}
+.filex-group .filex-group-main{border-radius:14px 0 0 14px;padding:0 9px}
+.filex-group .filex-group-trigger{margin-left:-1px;border-radius:0 14px 14px 0;border-left:0;padding:0 7px}
+
 /* ── hero floating utility (shell.overlay entry) ─────────────────────── */
-/* The same icon, pinned by the plugin to the conversation column's
+/* The ButtonGroup, pinned by the plugin to the conversation column's
    top-right while the column is in its hero phase. The shell.overlay layer
    is click-through by design, so the entry opts back into pointer events;
    no explicit z-index keeps it below sibling overlay entries (modal,
@@ -38035,24 +38055,23 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/index.tsx
 		/**
-		* Client half of dsh-file-explorer: a single header icon that opens the
-		* built-in file-explorer modal (preview / edit), plus the overlay modal, the
-		* Ctrl+P shortcut, and transient notices.
+		* Client half of dsh-file-explorer.
 		*
-		* The icon registers into `conversation.session.header.utilities`. Opening
-		* the session's working folder in the OS file manager and opening it in an
-		* external editor are features of the DSH shell itself in current versions,
-		* so this plugin deliberately carries only its own built-in editor and no
-		* mode dropdown / no external launchers.
+		* The in-chat session header (`conversation.session.header.utilities`) keeps
+		* a single built-in-editor icon: clicking it opens the file-explorer modal
+		* (preview / edit). The hero / new-session floating utility rendered by the
+		* plugin itself through the generic `shell.overlay` layer carries the full
+		* ButtonGroup — the left button performs the remembered open action
+		* (内置编辑器 / 系统文件夹 / VS Code) and the right chevron opens a dropdown
+		* to switch between them. Selecting an entry both persists it as the new
+		* default and immediately runs that action.
 		*
-		* The same icon is also shown on the new-session screen through the
-		* generic `shell.overlay` floating layer (no shell change involved): a
-		* plugin-owned entry pins it to the conversation column's top-right while
-		* the column is in its hero phase — the no-session hero and the
+		* The floating entry pins itself to the conversation column's top-right
+		* while the column is in its hero phase — the no-session hero and the
 		* blank-session (new chat) hero, where the session header and its utilities
-		* seat are absent or deliberately hidden. The floating entry resolves its
-		* session itself: the action falls back to the live selection
-		* (`useSessions` → `state.current`) and shows a notice when none exists.
+		* seat are absent or deliberately hidden. It resolves its session itself:
+		* the actions fall back to the live selection (`useSessions` →
+		* `state.current`) and show a notice when none exists.
 		*
 		* Session binding: every /filex request is conversation-scoped, so the modal
 		* must know WHICH session it belongs to — the host resolves the workspace
@@ -38068,11 +38087,51 @@ window.__ModuleLoader__.load({
 			"remote",
 			"remote.session"
 		];
+		const MODE_STORAGE_KEY = "dsh-file-explorer.header-mode";
+		/** Read the persisted mode; anything unknown defaults to the editor. */
+		function readStoredMode() {
+			try {
+				const stored = window.localStorage.getItem(MODE_STORAGE_KEY);
+				if (stored === "folder" || stored === "vscode") return stored;
+				return "editor";
+			} catch {
+				return "editor";
+			}
+		}
+		/** The official VS Code logo (brand colors), sized like the kit icons. */
+		function VscodeIcon(props) {
+			const { size = 16, className } = props;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("svg", {
+				width: size,
+				height: size,
+				viewBox: "0 0 32 32",
+				className,
+				"aria-hidden": true,
+				focusable: "false",
+				xmlns: "http://www.w3.org/2000/svg",
+				children: [
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
+						d: "M29.01,5.03,23.244,2.254a1.742,1.742,0,0,0-1.989.338L2.38,19.8A1.166,1.166,0,0,0,2.3,21.447c.025.027.05.053.077.077l1.541,1.4a1.165,1.165,0,0,0,1.489.066L28.142,5.75A1.158,1.158,0,0,1,30,6.672V6.605A1.748,1.748,0,0,0,29.01,5.03Z",
+						fill: "#0065a9"
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
+						d: "M29.01,26.97l-5.766,2.777a1.745,1.745,0,0,1-1.989-.338L2.38,12.2A1.166,1.166,0,0,1,2.3,10.553c.025-.027.05-.053.077-.077l1.541-1.4A1.165,1.165,0,0,1,5.41,9.01L28.142,26.25A1.158,1.158,0,0,0,30,25.328V25.4A1.749,1.749,0,0,1,29.01,26.97Z",
+						fill: "#007acc"
+					}),
+					/* @__PURE__ */ (0, react_jsx_runtime.jsx)("path", {
+						d: "M23.244,29.747a1.745,1.745,0,0,1-1.989-.338A1.025,1.025,0,0,0,23,28.684V3.316a1.024,1.024,0,0,0-1.749-.724,1.744,1.744,0,0,1,1.989-.339l5.765,2.772A1.748,1.748,0,0,1,30,6.6V25.4a1.748,1.748,0,0,1-.991,1.576Z",
+						fill: "#1f9cf0"
+					})
+				]
+			});
+		}
 		let ctxRef;
 		let store = {
 			open: false,
 			sessionId: "",
 			notice: null,
+			mode: readStoredMode(),
+			vscode: true,
 			pendingPath: null,
 			pendingSeq: 0
 		};
@@ -38137,6 +38196,32 @@ window.__ModuleLoader__.load({
 			};
 			emit();
 		}
+		/** Ask the host to reveal the session's working folder in the OS file manager. */
+		async function openSystemFolder(sessionId, cwd) {
+			const resolved = sessionId !== void 0 && sessionId !== "" ? sessionId : activeSessionId;
+			if (resolved === void 0) {
+				showNotice("没有可用的会话：无法确定文件工作区。请先新建/选择一个会话。");
+				return;
+			}
+			try {
+				showNotice(`已打开文件夹：${(await api.fsReveal({ sessionId: resolved }, cwd)).cwd}`);
+			} catch (error) {
+				showNotice(`打开系统文件夹失败：${error instanceof Error ? error.message : String(error)}`);
+			}
+		}
+		/** Ask the host to open the session's working folder in VS Code. */
+		async function openInVscode(sessionId, cwd) {
+			const resolved = sessionId !== void 0 && sessionId !== "" ? sessionId : activeSessionId;
+			if (resolved === void 0) {
+				showNotice("没有可用的会话：无法确定文件工作区。请先新建/选择一个会话。");
+				return;
+			}
+			try {
+				showNotice(`已在 VS Code 打开：${(await api.fsVscode({ sessionId: resolved }, cwd)).cwd}`);
+			} catch (error) {
+				showNotice(`用 VS Code 打开失败：${error instanceof Error ? error.message : String(error)}`);
+			}
+		}
 		/** Close the modal (session binding stays for the next open). */
 		function closeExplorer() {
 			store = {
@@ -38145,8 +38230,64 @@ window.__ModuleLoader__.load({
 			};
 			emit();
 		}
-		/** The header icon: the built-in file explorer (preview / edit modal). */
-		function HeaderGroup(props) {
+		function setMode(mode) {
+			if (store.mode === mode) return;
+			store = {
+				...store,
+				mode
+			};
+			emit();
+			try {
+				window.localStorage.setItem(MODE_STORAGE_KEY, mode);
+			} catch {}
+		}
+		/**
+		* Probe the host once per activation for VS Code availability and hide the
+		* VSCode option (falling back to the editor) when it is missing — the user
+		* explicitly wants the entry hidden rather than shown-but-broken.
+		*/
+		function probeVscode() {
+			api.fsCapabilities().then((result) => {
+				store = {
+					...store,
+					vscode: result.vscode
+				};
+				if (!result.vscode && store.mode === "vscode") store = {
+					...store,
+					mode: "editor"
+				};
+				emit();
+			}).catch(() => {
+				store = {
+					...store,
+					vscode: false
+				};
+				if (store.mode === "vscode") store = {
+					...store,
+					mode: "editor"
+				};
+				emit();
+			});
+		}
+		const MODE_ITEMS = [
+			{
+				id: "editor",
+				label: "编辑器",
+				icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconEditOutline16, {})
+			},
+			{
+				id: "folder",
+				label: "文件夹",
+				icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFolderOpen16, {})
+			},
+			{
+				id: "vscode",
+				label: "VSCode",
+				icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(VscodeIcon, {})
+			}
+		];
+		/** The in-chat header icon: a single built-in-editor entry. */
+		function HeaderIcon(props) {
 			const title = "文件预览 / 编辑（Ctrl+P）";
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
 				label: title,
@@ -38168,7 +38309,77 @@ window.__ModuleLoader__.load({
 			});
 		}
 		/**
-		* Hero / new-session floating utility: the same HeaderGroup, rendered by the
+		* The hero ButtonGroup: the left button carries the remembered mode's icon and
+		* runs its action, the right chevron opens the mode dropdown. Rendered only on
+		* the hero / new-session screen — the in-chat header keeps the single
+		* built-in-editor `HeaderIcon`.
+		*/
+		function HeroGroup(props) {
+			const state = (0, react.useSyncExternalStore)(subscribe, getSnapshot);
+			const [menuOpen, setMenuOpen] = (0, react.useState)(false);
+			const useSessions = props.useSessions ?? (() => void 0);
+			const sessionId = useSessions((s) => s.current);
+			const sessionCwd = useSessions((s) => sessionId !== void 0 ? s.byId?.[sessionId]?.cwd : void 0);
+			const mode = state.mode;
+			const items = state.vscode ? MODE_ITEMS : MODE_ITEMS.filter((item) => item.id !== "vscode");
+			const mainIcon = mode === "folder" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFolderOpen16, {}) : mode === "vscode" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(VscodeIcon, {}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconEditOutline16, {});
+			const mainTitle = mode === "folder" ? "打开系统文件夹" : mode === "vscode" ? "用 VSCode 打开工作区" : "文件预览 / 编辑（Ctrl+P）";
+			const onMainClick = (e) => {
+				e.stopPropagation();
+				if (mode === "folder") openSystemFolder(sessionId, sessionCwd);
+				else if (mode === "vscode") openInVscode(sessionId, sessionCwd);
+				else openExplorer(sessionId);
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
+				label: mainTitle,
+				side: "bottom",
+				delayMs: 400,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Menu, {
+					open: menuOpen,
+					align: "end",
+					portal: true,
+					compact: true,
+					selectedId: mode,
+					items,
+					onSelect: (id) => {
+						const next = id === "folder" || id === "vscode" ? id : "editor";
+						setMode(next);
+						setMenuOpen(false);
+						if (next === "folder") openSystemFolder(sessionId, sessionCwd);
+						else if (next === "vscode") openInVscode(sessionId, sessionCwd);
+						else openExplorer(sessionId);
+					},
+					onClose: () => setMenuOpen(false),
+					anchor: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+						className: "filex-group",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+							type: "button",
+							className: "filex-group-main",
+							size: "sm",
+							variant: "outline",
+							icon: mainIcon,
+							title: mainTitle,
+							"aria-label": mainTitle,
+							onClick: onMainClick
+						}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+							type: "button",
+							className: "filex-group-trigger",
+							size: "sm",
+							variant: "outline",
+							title: "选择打开方式：编辑器 / 文件夹 / VSCode",
+							"aria-label": "选择打开方式",
+							onClick: (e) => {
+								e.stopPropagation();
+								setMenuOpen((v) => !v);
+							},
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutline14, {})
+						})]
+					})
+				})
+			});
+		}
+		/**
+		* Hero / new-session floating utility: the hero ButtonGroup, rendered by the
 		* plugin itself through the generic `shell.overlay` floating layer (no shell
 		* change needed) and pinned to the conversation column's top-right corner —
 		* the spot where the session-header utilities sit once a conversation has
@@ -38176,11 +38387,11 @@ window.__ModuleLoader__.load({
 		* (no session at all, or a blank session whose header is deliberately
 		* hidden); the position is measured from the rendered column root
 		* (`[data-phase]`), so sidebar collapse and details-panel toggles are
-		* tracked automatically. Clicking behaves exactly like the header icon: in a
-		* blank-session hero the action binds to that session, and with no session
-		* at all it surfaces the no-session notice.
+		* tracked automatically. Clicking behaves exactly like the in-chat icon: in a
+		* blank-session hero the actions bind to that session, and with no session
+		* at all they surface the no-session notice.
 		*/
-		function HeroFilexButton() {
+		function HeroFilexButton(props) {
 			const [pos, setPos] = (0, react.useState)(null);
 			(0, react.useEffect)(() => {
 				const update = () => {
@@ -38216,7 +38427,7 @@ window.__ModuleLoader__.load({
 					top: pos.top,
 					right: pos.right
 				},
-				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(HeaderGroup, {})
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(HeroGroup, { useSessions: props.useSessions })
 			});
 		}
 		/** The overlay entry: keyboard shortcut + modal + transient notice. */
@@ -38293,7 +38504,7 @@ window.__ModuleLoader__.load({
 					id: "file-explorer",
 					order: 10,
 					label: "文件预览 / 编辑"
-				}, HeaderGroup));
+				}, HeaderIcon));
 				ctx.slots.inject("shell.overlay", () => {
 					const overlay = ctx.slots.register({
 						name: "shell.overlay",
@@ -38312,6 +38523,7 @@ window.__ModuleLoader__.load({
 						heroFab();
 					};
 				});
+				probeVscode();
 				ctx.effect(() => {
 					const deps = {
 						currentSessionId: () => activeSessionId,

package/lib/index.js

@@ -1,4 +1,5 @@
 import { mkdir, open, readFile, readdir, rename, rm, stat, writeFile } from "node:fs/promises";
+import { spawn } from "node:child_process";
 import { basename, dirname, isAbsolute, join, resolve } from "node:path";
 //#region src/trust-fence.ts
 function header(headers, name) {
@@ -42,8 +43,9 @@ function isTrustedApiRequest(request) {
 //#region src/index.ts
 /**
 * dsh-file-explorer host half: the /filex JSON API (session cwd, file list,
-* read / write / content search) and the /filex/file media route (images /
-* PDFs). Every route passes the same loopback browser-trust fence.
+* read / write / content search, OS file-manager reveal, VS Code launch) and
+* the /filex/file media route (images / PDFs). Every route passes the same
+* loopback browser-trust fence.
 *
 * All operations are conversation-scoped: requests carry a sessionId and the
 * session's authoritative cwd comes from the session store.
@@ -296,6 +298,110 @@ function parseGlobList(raw) {
 	}
 	return out;
 }
+/**
+* Launch the OS file manager pointing at `target` (a directory). Detached and
+* stdio-ignored so the spawn never blocks the host or leaks pipes; failures
+* are swallowed — the API reports unsupported platforms instead.
+*
+* NOTE: never pass `windowsHide: true` on Windows — explorer.exe honors the
+* startup show-window flag and would open its folder window hidden, making
+* the click look dead. The plain GUI-app spawn shows the window normally.
+*/
+function openInSystemFileManager(target) {
+	let command;
+	let args;
+	if (process.platform === "win32") {
+		command = "explorer";
+		args = [target];
+	} else if (process.platform === "darwin") {
+		command = "open";
+		args = [target];
+	} else if (process.platform === "linux") {
+		command = "xdg-open";
+		args = [target];
+	} else return false;
+	try {
+		const child = spawn(command, args, {
+			detached: true,
+			stdio: "ignore"
+		});
+		child.on("error", () => {});
+		child.unref();
+		return true;
+	} catch {
+		return false;
+	}
+}
+/**
+* Resolve the directory a reveal/open action should point at. Authoritative
+* source: the session's own header cwd. When it is absent (sessions created
+* without workspace metadata fall back to the host process cwd — usually
+* meaningless), accept the loopback-only client's session-list cwd hint so
+* the folder still opens where the user works.
+*/
+function revealCwdOf(ctx, sessionId, rawHint) {
+	const headerCwd = ctx.sessions.get(sessionId)?.header.cwd;
+	const hint = typeof rawHint === "string" && rawHint !== "" ? rawHint : void 0;
+	return headerCwd !== void 0 && headerCwd !== "" ? resolve(headerCwd) : hint !== void 0 && isAbsolute(hint) ? resolve(hint) : process.cwd();
+}
+/**
+* Locate the VS Code CLI (`code`). Checks the standard install locations
+* first, then falls back to a PATH scan. Windows `code` is a .cmd shim, so
+* the caller must route it through `cmd /c` (spawn alone cannot execute it).
+*/
+async function resolveVscodeCli() {
+	const candidates = [];
+	if (process.platform === "win32") {
+		const local = process.env.LOCALAPPDATA;
+		if (local !== void 0) candidates.push(join(local, "Programs", "Microsoft VS Code", "bin", "code.cmd"));
+		const pf = process.env.ProgramFiles;
+		if (pf !== void 0) candidates.push(join(pf, "Microsoft VS Code", "bin", "code.cmd"));
+		const pf86 = process.env["ProgramFiles(x86)"];
+		if (pf86 !== void 0) candidates.push(join(pf86, "Microsoft VS Code", "bin", "code.cmd"));
+	} else if (process.platform === "darwin") candidates.push("/Applications/Visual Studio Code.app/Contents/Resources/app/bin/code");
+	else if (process.platform === "linux") candidates.push("/usr/bin/code", "/usr/local/bin/code", "/snap/bin/code");
+	for (const candidate of candidates) try {
+		await stat(candidate);
+		return candidate;
+	} catch {}
+	const name = process.platform === "win32" ? "code.cmd" : "code";
+	const paths = (process.env.PATH ?? "").split(process.platform === "win32" ? ";" : ":");
+	for (const dir of paths) {
+		if (dir === "") continue;
+		const probe = join(dir, name);
+		try {
+			await stat(probe);
+			return probe;
+		} catch {}
+	}
+	return null;
+}
+/**
+* Launch VS Code pointed at `target` (a directory). On Windows the CLI is a
+* .cmd shim, so it is routed through `cmd /c` with the console hidden (the
+* hidden console belongs to cmd only — the Code GUI window is unaffected).
+*/
+function openInVscode(cli, target) {
+	try {
+		const child = process.platform === "win32" ? spawn("cmd", [
+			"/c",
+			cli,
+			target
+		], {
+			detached: true,
+			stdio: "ignore",
+			windowsHide: true
+		}) : spawn(cli, [target], {
+			detached: true,
+			stdio: "ignore"
+		});
+		child.on("error", () => {});
+		child.unref();
+		return true;
+	} catch {
+		return false;
+	}
+}
 function buildApi(ctx) {
 	const cwdOf = (payload) => {
 		const sessionId = requireString(payload, "sessionId");
@@ -351,6 +457,36 @@ function buildApi(ctx) {
 			}
 			return { ok: true };
 		},
+		"fs.reveal": async (payload) => {
+			const { sessionId } = cwdOf(payload);
+			const cwd = revealCwdOf(ctx, sessionId, payload.cwd);
+			if (!(await stat(cwd).catch(() => {
+				throw new FilexError("fs-error", `cannot open "${cwd}": not found`, 404);
+			})).isDirectory()) throw new FilexError("fs-error", `"${cwd}" is not a directory`);
+			if (!openInSystemFileManager(cwd)) throw new FilexError("unsupported", "current platform has no file-manager launcher", 501);
+			return {
+				ok: true,
+				cwd
+			};
+		},
+		"fs.vscode": async (payload) => {
+			const { sessionId } = cwdOf(payload);
+			const cwd = revealCwdOf(ctx, sessionId, payload.cwd);
+			if (!(await stat(cwd).catch(() => {
+				throw new FilexError("fs-error", `cannot open "${cwd}": not found`, 404);
+			})).isDirectory()) throw new FilexError("fs-error", `"${cwd}" is not a directory`);
+			const cli = await resolveVscodeCli();
+			if (cli === null) throw new FilexError("vscode-not-found", "未找到 VS Code 命令行工具（code）。请确认 VS Code 已安装且勾选了“添加到 PATH”", 404);
+			if (!openInVscode(cli, cwd)) throw new FilexError("unsupported", "failed to launch the VS Code CLI", 501);
+			return {
+				ok: true,
+				cwd,
+				cli
+			};
+		},
+		"fs.capabilities": async () => {
+			return { vscode: await resolveVscodeCli() !== null };
+		},
 		"fs.search": async (payload) => {
 			const { cwd } = cwdOf(payload);
 			const pattern = requireString(payload, "pattern").trim();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-xhl/dsh-file-explorer",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "DSH 外部编译型插件：工作区文件预览 / 编辑（CodeMirror 6 编辑器 + 文件树 + 全文搜索 + Markdown/HTML/图片/PDF 预览）。移植自同目录下的动态 Cordis 插件版本。",
   "type": "module",
   "main": "lib/index.js",