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

package/README.md

@@ -4,29 +4,31 @@
 
 ## 功能
 
-- **标题栏 ButtonGroup**（`conversation.session.header.utilities`）：左侧按钮 + 右侧下拉（编辑器 / 文件夹 / VSCode）
-  - **Hero / 新建会话同样显示**：同一 ButtonGroup 通过框架通用浮层 `shell.overlay` 由插件自身定位到会话列右上角（hero 阶段显示，有记录后由标题栏图标接管，无重复）；纯插件实现，不改动框架代码（详见 `docs/hero-filex-button.md`）
-  - **对话内点击文件 → 编辑器预览**：聊天里的文件路径链接（工具行、产物行、正文提及）默认用系统程序打开；插件拦截 `remote.session.openWorkspacePath` 与 `workspaces.openPath` 两条通道，改为在编辑器弹窗中预览（目录或 cwd 外的路径仍落回系统打开）
-  - **编辑器**（默认）：点击打开全屏文件预览 / 编辑弹窗（Ctrl+P 亦可）
+- **聊天页标题栏图标**（`conversation.session.header.utilities`）：一个内置编辑器图标，点击打开文件预览 / 编辑弹窗（聊天页保持与现状一致，无下拉）
+- **Hero / 新建会话页 ButtonGroup**：同一浮层位置由插件定位到会话列右上角（hero 阶段显示，有记录后由标题栏图标接管，无重复）；hero 上为**左主按钮 + 右下拉**的组合：
+  - **编辑器**（默认）：点击打开文件预览 / 编辑弹窗（Ctrl+P 亦可）
   - **文件夹**：点击直接打开会话工作区所在的**系统文件夹**（Windows `explorer` / macOS `open` / Linux `xdg-open`）
-  - **VSCode**：点击用 `code` 命令行在 **VS Code** 中打开会话工作区（自动探测安装位置 / PATH）
+  - **VSCode**：点击用 `code` 命令行在 **VS Code** 中打开会话工作区（自动探测安装位置 / PATH；未安装则该项自动隐藏）
   - 选择记忆在 localStorage，点击后底部提示确认打开的路径；下拉选中某项会先切换默认打开方式，随后立即执行对应的打开动作
+  - 纯插件实现，不改动框架代码（详见 `docs/hero-filex-button.md`）
+- **对话内点击文件 → 编辑器预览**：聊天里的文件路径链接（工具行、产物行、正文提及）默认用系统程序打开；插件拦截 `remote.session.openWorkspacePath` 与 `workspaces.openPath` 两条通道，改为在编辑器弹窗中预览（目录或 cwd 外的路径仍落回系统打开）
 - **文件列表**：左侧目录树（跳过 `node_modules`/`.git`/`dist` 等）
 - **按文件名过滤**：输入即过滤
 - **全文搜索**：正则 / 大小写 / 全词匹配、包含/排除过滤，结果按文件分组、命中高亮，点击跳转并高亮匹配
 - **编辑**：CodeMirror 6（20+ 语言语法高亮含 Vue SFC、行号、撤销/重做、Ctrl+S 保存、只读切换、Tab 缩进）
 - **预览**：图片直接显示、PDF 内嵌查看（Markdown / HTML 预览已移除——大文档渲染会卡死界面）
+- **全屏**：弹窗标题栏的全屏按钮，一键把预览 / 编辑弹窗放大到整个窗口（图标转为「退出全屏」，再点一次还原）
 - **界面**：复用 Web 壳设计系统（`@deepseek-ai/dsh-client-ui-primitives`：Button / Menu / Modal / Input / Toast / Tooltip + `--dsw-*` token），随主题明暗自适应
 
 ## 架构
 
 ```
 src/
-  index.ts            Host：/filex/api JSON 路由（session.cwd / fs.list / fs.read / fs.write / fs.search / fs.reveal）
+  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 ButtonGroup（编辑器/文件夹模式）+ overlay 弹窗 + Ctrl+P 快捷键
+    index.tsx         入口：聊天页 header 图标（内置编辑器）+ hero 模式 ButtonGroup + overlay 弹窗 + Ctrl+P 快捷键
     Explorer.tsx      弹窗：文件树 / 文件名过滤 / 全文搜索 / 查看器分派（primitives 重排）
     TextEditor.tsx    CodeMirror 6 编辑器 + 搜索跳转高亮
     lang.ts           扩展名 → CodeMirror 语言映射

package/cordis.patch.yml

@@ -1,8 +1,8 @@
-# dsh-file-explorer bundle patch
-#
-# 通过 bundle 通道挂载：
-#   dsh plugin --profile <name> add @dsh-xhl/dsh-file-explorer@<version>
-# 或手动把 '@dsh-xhl/dsh-file-explorer' 加进 profile 的 dsh.profile.bundles 并 link 依赖。
-- insert:
-    - id: dsh-file-explorer
-      name: '@dsh-xhl/dsh-file-explorer'
+# dsh-file-explorer bundle patch
+#
+# 通过 bundle 通道挂载：
+#   dsh plugin --profile <name> add @dsh-xhl/dsh-file-explorer@<version>
+# 或手动把 '@dsh-xhl/dsh-file-explorer' 加进 profile 的 dsh.profile.bundles 并 link 依赖。
+- insert:
+    - id: dsh-file-explorer
+      name: '@dsh-xhl/dsh-file-explorer'

package/lib/client.js

@@ -37010,16 +37010,28 @@ window.__ModuleLoader__.load({
 		* inputs, modals, toasts, tooltips) is left to them; this sheet only covers
 		* the explorer's bespoke layout — the split body, tree rows, search rows,
 		* editor chrome — and the small adjustments that compose primitives into
-		* native-looking pieces (the header ButtonGroup, the modal surface).
+		* native-looking pieces (the header icon, the modal surface).
 		*/
 		const CSS = `
-/* ── header ButtonGroup (utilities slot) ─────────────────────────────── */
-.filex-group{display:inline-flex;align-items:center;position:relative}
-.filex-group .filex-group-main{border-radius:8px 0 0 8px;padding:0 9px}
-.filex-group .filex-group-trigger{margin-left:-1px;border-radius:0 8px 8px 0;border-left:0;padding:0 7px}
+/* ── header icon (utilities slot) ────────────────────────────────────── */
+/* Same 28×28 round button as dsh-git-gui's header entry (.gg-header-btn):
+   the primitive sm button is already 28px tall with a 16px icon, so only
+   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 ButtonGroup, 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,
@@ -37033,6 +37045,12 @@ window.__ModuleLoader__.load({
 
 /* ── modal surface (headless primitives Modal) ───────────────────────── */
 .filex-modal{width:min(1200px,92vw);height:min(780px,88vh);gap:0;padding:0;border-radius:16px}
+/* Full-viewport mode (header toggle). The shell's dialog sits in a fixed
+   root with 24px padding, so a fixed inset:0 card fills the whole window
+   without being inset by that padding. */
+.filex-modal-full{position:fixed;inset:0;width:auto;height:auto;border-radius:0}
+/* The expand-corners glyph rotated 180° reads as "exit fullscreen". */
+.filex-fs-on{transform:rotate(180deg)}
 
 /* ── explorer frame ──────────────────────────────────────────────────── */
 .filex-explorer{display:flex;flex-direction:column;height:100%;min-height:0}
@@ -37357,6 +37375,8 @@ window.__ModuleLoader__.load({
 			const [jumpRanges, setJumpRanges] = (0, react.useState)(void 0);
 			const [collapsed, setCollapsed] = (0, react.useState)(/* @__PURE__ */ new Set());
 			const [savedFlash, setSavedFlash] = (0, react.useState)("");
+			/** Full-viewport mode: the modal card fills the whole window (toggle in the header). */
+			const [fullscreen, setFullscreen] = (0, react.useState)(false);
 			const [sideMenu, setSideMenu] = (0, react.useState)(null);
 			const [sideToast, setSideToast] = (0, react.useState)("");
 			const [toastKey, setToastKey] = (0, react.useState)(0);
@@ -37714,7 +37734,7 @@ window.__ModuleLoader__.load({
 				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Modal, {
 					open: true,
 					headless: true,
-					className: "filex-modal",
+					className: `filex-modal${fullscreen ? " filex-modal-full" : ""}`,
 					title: openPath ?? "文件预览 / 编辑",
 					closeLabel: "关闭",
 					onClose: handleClose,
@@ -37732,18 +37752,30 @@ window.__ModuleLoader__.load({
 									})
 								}), /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 									className: "filex-header-actions",
-									children: [savedFlash !== "" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
-										className: `filex-badge${savedFlash.startsWith("保存失败") ? " filex-badge-warn" : ""}`,
-										children: savedFlash
-									}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
-										type: "button",
-										size: "sm",
-										variant: "ghost",
-										icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCloseOutline16, {}),
-										title: "关闭（Esc）",
-										"aria-label": "关闭",
-										onClick: handleClose
-									})]
+									children: [
+										savedFlash !== "" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+											className: `filex-badge${savedFlash.startsWith("保存失败") ? " filex-badge-warn" : ""}`,
+											children: savedFlash
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+											type: "button",
+											size: "sm",
+											variant: "ghost",
+											icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFullscreenOutline16, { className: fullscreen ? "filex-fs-on" : void 0 }),
+											title: fullscreen ? "退出全屏" : "全屏",
+											"aria-label": fullscreen ? "退出全屏" : "全屏",
+											onClick: () => setFullscreen((v) => !v)
+										}),
+										/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+											type: "button",
+											size: "sm",
+											variant: "ghost",
+											icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCloseOutline16, {}),
+											title: "关闭（Esc）",
+											"aria-label": "关闭",
+											onClick: handleClose
+										})
+									]
 								})]
 							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -38023,26 +38055,23 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/index.tsx
 		/**
-		* Client half of dsh-file-explorer: a header ButtonGroup that opens either
-		* the file-explorer modal (editor mode), the session's working folder in the
-		* OS file manager (folder mode), or the workspace in VS Code (vscode mode),
-		* plus the overlay modal, the Ctrl+P shortcut, and transient notices.
+		* Client half of dsh-file-explorer.
 		*
-		* The ButtonGroup registers into `conversation.session.header.utilities`:
-		* the left button carries the active mode's icon and triggers its action,
-		* the right button opens a dropdown to switch between 编辑器 (editor),
-		* 文件夹 (folder), and VSCode. Selecting an entry both persists it as the
-		* new default mode and immediately runs that mode's open action. The choice
-		* is persisted in localStorage so it survives reloads.
+		* 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 ButtonGroup 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 actions fall back to the live selection
-		* (`useSessions` → `state.current`) and show 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
@@ -38193,6 +38222,7 @@ window.__ModuleLoader__.load({
 				showNotice(`用 VS Code 打开失败：${error instanceof Error ? error.message : String(error)}`);
 			}
 		}
+		/** Close the modal (session binding stays for the next open). */
 		function closeExplorer() {
 			store = {
 				...store,
@@ -38256,20 +38286,49 @@ window.__ModuleLoader__.load({
 				icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(VscodeIcon, {})
 			}
 		];
-		/** The header ButtonGroup (session header utilities slot; receives sessionId). */
-		function HeaderGroup(props) {
+		/** 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,
+				side: "bottom",
+				delayMs: 400,
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
+					type: "button",
+					className: "filex-header-btn",
+					size: "sm",
+					variant: "outline",
+					icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconEditOutline16, {}),
+					title,
+					"aria-label": "文件预览 / 编辑",
+					onClick: (e) => {
+						e.stopPropagation();
+						openExplorer(props.sessionId);
+					}
+				})
+			});
+		}
+		/**
+		* 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 sessionCwd = (props.useSessions ?? (() => void 0))((s) => props.sessionId !== void 0 ? s.byId?.[props.sessionId]?.cwd : void 0);
+			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(props.sessionId, sessionCwd);
-				else if (mode === "vscode") openInVscode(props.sessionId, sessionCwd);
-				else openExplorer(props.sessionId);
+				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,
@@ -38286,9 +38345,9 @@ window.__ModuleLoader__.load({
 						const next = id === "folder" || id === "vscode" ? id : "editor";
 						setMode(next);
 						setMenuOpen(false);
-						if (next === "folder") openSystemFolder(props.sessionId, sessionCwd);
-						else if (next === "vscode") openInVscode(props.sessionId, sessionCwd);
-						else openExplorer(props.sessionId);
+						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", {
@@ -38320,7 +38379,7 @@ window.__ModuleLoader__.load({
 			});
 		}
 		/**
-		* Hero / new-session floating utility: the same HeaderGroup, rendered by the
+		* 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
@@ -38328,7 +38387,7 @@ 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
+		* 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.
 		*/
@@ -38368,7 +38427,7 @@ window.__ModuleLoader__.load({
 					top: pos.top,
 					right: pos.right
 				},
-				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(HeaderGroup, { useSessions: props.useSessions })
+				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(HeroGroup, { useSessions: props.useSessions })
 			});
 		}
 		/** The overlay entry: keyboard shortcut + modal + transient notice. */
@@ -38445,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",

package/lib/index.js

@@ -43,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.

package/package.json

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