@dsh-xhl/dsh-file-explorer 0.1.8 → 0.2.0

package/README.md

@@ -5,12 +5,14 @@
 ## 功能
 
 - **聊天页标题栏图标**（`conversation.session.header.utilities`）：一个内置编辑器图标，点击打开文件预览 / 编辑弹窗（聊天页保持与现状一致，无下拉）
-- **Hero / 新建会话页 ButtonGroup**：同一浮层位置由插件定位到会话列右上角（hero 阶段显示，有记录后由标题栏图标接管，无重复）；hero 上为**左主按钮 + 右下拉**的组合：
+- **Hero / 新建会话页 ButtonGroup**：通过 `@dsh-xhl/dsh-hero-flex` 插件声明的
+  `hero.flex` 槽位渲染（**未安装该插件则不显示**）；hero 上为**左主按钮 +
+  右下拉**的组合：
   - **编辑器**（默认）：点击打开文件预览 / 编辑弹窗（Ctrl+P 亦可）
   - **文件夹**：点击直接打开会话工作区所在的**系统文件夹**（Windows `explorer` / macOS `open` / Linux `xdg-open`）
   - **VSCode**：点击用 `code` 命令行在 **VS Code** 中打开会话工作区（自动探测安装位置 / PATH；宿主明确报告未安装时该项自动隐藏，探测请求本身失败则保持可见并退避重试）
   - 选择记忆在 localStorage，点击后底部提示确认打开的路径；下拉选中某项会先切换默认打开方式，随后立即执行对应的打开动作
-  - 纯插件实现，不改动框架代码（详见 `docs/hero-filex-button.md`）
+  - 纯插件实现，不改动框架代码；hero 按钮组渲染依赖独立插件 `@dsh-xhl/dsh-hero-flex`（详见 `docs/hero-filex-button.md`）
 - **对话内点击文件 → 编辑器预览**：聊天里的文件路径链接（工具行、产物行、正文提及）默认用系统程序打开；插件拦截 `remote.session.openWorkspacePath` 与 `workspaces.openPath` 两条通道，改为在编辑器弹窗中预览（目录或 cwd 外的路径仍落回系统打开）
 - **文件列表**：左侧目录树（跳过 `node_modules`/`.git`/`dist` 等）
 - **按文件名过滤**：输入即过滤
@@ -28,7 +30,7 @@ src/
                       + /filex/file 媒体路由（图片/PDF 字节），loopback 信任围栏
   trust-fence.ts      Host-header loopback 校验（DNS-rebinding 防护）
   client/
-    index.tsx         入口：聊天页 header 图标（内置编辑器）+ hero 模式 ButtonGroup + overlay 弹窗 + Ctrl+P 快捷键
+    index.tsx         入口：聊天页 header 图标（内置编辑器）+ hero 模式 ButtonGroup（hero.flex 槽位）+ overlay 弹窗 + Ctrl+P 快捷键
     Explorer.tsx      弹窗：文件树 / 文件名过滤 / 全文搜索 / 查看器分派（primitives 重排）
     TextEditor.tsx    CodeMirror 6 编辑器 + 搜索跳转高亮
     lang.ts           扩展名 → CodeMirror 语言映射
@@ -41,9 +43,27 @@ src/
 
 ```bash
 pnpm install
-pnpm build     # lib/index.js（host）+ lib/client.js（client bundle，CodeMirror 内联）
+pnpm build     # lib/index.js（host）+ lib/client.js（client bundle，CodeMirror 内联）+ 图标校验
 ```
 
+> **图标命名陷阱（务必先读）**：宿主 `@deepseek-ai/dsh-client-ui-primitives`
+> 的图标导出已从**尺寸后缀**（`Icon*16` / `Icon*14`）改为**字重后缀**
+> （`Icon*Regular` / `Icon*Medium`），旧名在宿主里**一个都不存在**。
+>
+> 这个失败模式极其隐蔽：客户端 bundle 通过冻结的模块表解析原语，缺失的名字
+> 拿到的是 `undefined`，React 在渲染时抛 "Element type is invalid"，而槽位的
+> 错误边界会**静默退位（abdicate）**——插件看起来已安装、已注册，却什么都不渲染。
+>
+> 曾经的坑在于开发依赖停留在 `0.1.0-rc.6`（仍是旧命名），于是 `tsc` 放行、
+> 构建成功，只有运行时才炸。现在 `pnpm build` 末尾的
+> [`scripts/check-icons.mjs`](scripts/check-icons.mjs) 会把产物引用的图标与
+> **宿主真实导出**逐一比对，对不上直接构建失败。
+>
+> 若 `pnpm typecheck` 报某图标不存在，多半是本地 `node_modules` 里的原语包
+> 落后于宿主：把 `node_modules/@deepseek-ai/dsh-client-ui-primitives` 指向
+> 宿主实际安装的那份（`$env:LOCALAPPDATA\Volta\tools\image\packages\@deepseek-ai\dsh\node_modules\@deepseek-ai\dsh\node_modules\@deepseek-ai\dsh-client-ui-primitives`）
+> 再重试。
+
 > 构建采用**原地覆盖**（不再先删除 `lib/`）。宿主半在进程启动时载入内存，而 profile
 > 若 link 到本工作区则会直读磁盘：构建中途清空目录会让 HMR 读到空 bundle，导致
 > `/filex` 路由与客户端 import 瞬时失败（表现为 `unknown filex API method ...`）。

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

@@ -36902,7 +36902,7 @@ window.__ModuleLoader__.load({
 						children: ctxMenu.empty ? "请先在编辑器中选中文本" : reference(ctxMenu)
 					})]
 				}),
-				icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRightUpOutline16, {}),
+				icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRightUpOutlineRegular, {}),
 				disabled: ctxMenu.empty
 			}, {
 				id: "insertFile",
@@ -36913,7 +36913,7 @@ window.__ModuleLoader__.load({
 						children: reference()
 					})]
 				}),
-				icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRightUpOutline16, {})
+				icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRightUpOutlineRegular, {})
 			}] : [];
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
 				/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
@@ -36993,7 +36993,7 @@ window.__ModuleLoader__.load({
 				}),
 				insertError !== "" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Toast, {
 					text: `插入聊天框失败：${insertError}`,
-					icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconWarningOutline16, {}),
+					icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconWarningOutlineRegular, {}),
 					onDone: () => setInsertError("")
 				}, toastKey)
 			] });
@@ -37020,40 +37020,19 @@ window.__ModuleLoader__.load({
    down. An 8px radius keeps it a rounded square rather than a full circle. */
 .filex-header-btn{width:28px;height:28px;padding:0;border-radius:8px}
 
-/* ── hero ButtonGroup (shell.overlay entry) ──────────────────────────── */
-/* The mode group shown only on the hero / new-session screen: the left
+/* ── hero ButtonGroup (hero.flex slot entry) ─────────────────────────── */
+/* The mode group shown on the hero / blank-session screen: the left
    button carries the remembered mode's icon, the right chevron the mode
    dropdown. Outer corners use the same rounded-rectangle radius as the
    header buttons (8px on a 28px-tall button), so the group reads as one
-   pill consistent with the session header icons. */
+   pill consistent with the session header icons. The host is the
+   dsh-hero-flex plugin's hf-row (its own stylesheet); this sheet only
+   styles the group itself. */
 .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: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 corner seat (new runtime) ────────────────────────────────── */
-/* The corner occupant: the hero ButtonGroup directly left of the right-
-   sidebar expand button in one flex row — the same corner seat the shell's
-   expand button occupies alone once the header chrome is shown, now shared
-   with the plugin's open-actions group. The seat's own margin and the
-   header's padding position the row at the far right of the blank header. */
-.filex-corner{display:flex;align-items:center;gap:8px}
-/* Re-painted expand button, same footprint as the shell's ExpandButton
-   (28×28, 15px mirrored panel icon) but with a rounded-rectangle corner to
-   match the editor button beside it; visible only while the panel is
-   collapsed. */
-.filex-corner-expand{width:28px;height:28px;color:var(--dsw-alias-label-secondary,#9ca3af);cursor:pointer;background:transparent;border:none;border-radius:8px;flex:none;justify-content:center;align-items:center;padding:6px;display:inline-flex}
-.filex-corner-expand:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(128,128,128,.15))}
-.filex-corner-expand-icon{transform:scaleX(-1)}
-
-/* ── hero floating utility (shell.overlay entry) ─────────────────────── */
-/* 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,
-   notices) and any body-portaled popup. */
-.filex-hero-fab{position:fixed;pointer-events:auto}
-
 /* ── transient notice strip ──────────────────────────────────────────── */
 .filex-notice{position:fixed;left:50%;bottom:24px;transform:translateX(-50%);z-index:2147483003;display:flex;align-items:center;gap:10px;max-width:70vw;padding:9px 14px;font:12px/1.5 ui-monospace,SFMono-Regular,Menlo,monospace;color:var(--dsw-alias-state-warn-primary,#f59e0b);background:var(--dsw-alias-bg-layer-2,#1b1b22);border:1px solid rgba(245,158,11,.5);border-radius:10px;box-shadow:0 8px 28px rgba(0,0,0,.45);pointer-events:auto}
 .filex-notice-btn{border:0;background:transparent;color:inherit;cursor:pointer;font-size:14px;line-height:1;padding:2px 4px;opacity:.7;flex-shrink:0}
@@ -37311,7 +37290,7 @@ window.__ModuleLoader__.load({
 							onContextMenu(node.relPath, e.clientX, e.clientY);
 						},
 						children: [
-							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronRightOutline14, { className: "filex-chev" }),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronRightOutlineRegular, { className: "filex-chev" }),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsx)(FileIcon, {
 								kind: "dir",
 								name: node.name,
@@ -37574,7 +37553,7 @@ window.__ModuleLoader__.load({
 						children: `@file:${sideMenu.relPath} lines:${sideMenu.line}`
 					})]
 				}),
-				icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRightUpOutline16, {})
+				icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRightUpOutlineRegular, {})
 			}] : [], {
 				id: "insertFile",
 				label: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("span", {
@@ -37584,7 +37563,7 @@ window.__ModuleLoader__.load({
 						children: `@file:${sideMenu.relPath}`
 					})]
 				}),
-				icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRightUpOutline16, {})
+				icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRightUpOutlineRegular, {})
 			}] : [];
 			let sideContent;
 			if (searchMode === "name") {
@@ -37777,7 +37756,7 @@ window.__ModuleLoader__.load({
 											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 }),
+											icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFullscreenOutlineRegular, { className: fullscreen ? "filex-fs-on" : void 0 }),
 											title: fullscreen ? "退出全屏" : "全屏",
 											"aria-label": fullscreen ? "退出全屏" : "全屏",
 											onClick: () => setFullscreen((v) => !v)
@@ -37786,7 +37765,7 @@ window.__ModuleLoader__.load({
 											type: "button",
 											size: "sm",
 											variant: "ghost",
-											icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCloseOutline16, {}),
+											icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCloseOutlineRegular, {}),
 											title: "关闭（Esc）",
 											"aria-label": "关闭",
 											onClick: handleClose
@@ -37824,7 +37803,7 @@ window.__ModuleLoader__.load({
 												type: "button",
 												size: "sm",
 												variant: "outline",
-												icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRefreshOutline14, {}),
+												icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconRefreshOutlineRegular, {}),
 												disabled: loading,
 												onClick: () => void refresh(),
 												title: "刷新文件列表",
@@ -37985,7 +37964,7 @@ window.__ModuleLoader__.load({
 				}),
 				sideToast !== "" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Toast, {
 					text: `插入聊天框失败：${sideToast}`,
-					icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconWarningOutline16, {}),
+					icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconWarningOutlineRegular, {}),
 					onDone: () => setSideToast("")
 				}, toastKey)
 			] });
@@ -38075,19 +38054,17 @@ window.__ModuleLoader__.load({
 		*
 		* 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.
+		* (preview / edit).
 		*
-		* 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. It resolves its session itself:
-		* the actions fall back to the live selection (`useSessions` →
-		* `state.current`) and show a notice when none exists.
+		* The hero / blank-session open-actions ButtonGroup (编辑器 / 系统文件夹 /
+		* VS Code) renders ONLY through the `hero.flex` slot declared by the
+		* dsh-hero-flex plugin, which owns the header's corner seat at priority -1
+		* and hosts the additive flex row beside the right-sidebar expand button.
+		* Without dsh-hero-flex installed the ButtonGroup does not render at all —
+		* this plugin no longer occupies the corner seat nor floats a fallback
+		* overlay. The left button performs the remembered open action 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.
 		*
 		* Session binding: every /filex request is conversation-scoped, so the modal
 		* must know WHICH session it belongs to — the host resolves the workspace
@@ -38095,6 +38072,25 @@ window.__ModuleLoader__.load({
 		* the framework-resolved sessionId; Ctrl+P falls back to the currently
 		* selected session (`useSessions` → `state.current`).
 		*/
+		/**
+		* Icon primitives are resolved through the host's frozen module table, so a
+		* name the host no longer exports arrives as `undefined` and React throws
+		* "Element type is invalid" at render time. Inside a slot that throw is
+		* swallowed by the slot error boundary, which silently abdicates the seat —
+		* the plugin looks installed and registered while rendering nothing. Fail
+		* loudly at load instead, where the message is still visible.
+		*/
+		function assertPrimitives() {
+			const missing = Object.entries({
+				Button: _deepseek_ai_dsh_client_ui_primitives.Button,
+				Menu: _deepseek_ai_dsh_client_ui_primitives.Menu,
+				Tooltip: _deepseek_ai_dsh_client_ui_primitives.Tooltip,
+				IconChevronDownOutlineRegular: _deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutlineRegular,
+				IconEditOutlineRegular: _deepseek_ai_dsh_client_ui_primitives.IconEditOutlineRegular,
+				IconFolderOpenRegular: _deepseek_ai_dsh_client_ui_primitives.IconFolderOpenRegular
+			}).filter(([, v]) => v === void 0).map(([k]) => k);
+			if (missing.length > 0) throw new Error(`[dsh-file-explorer] 宿主 @deepseek-ai/dsh-client-ui-primitives 缺少: ${missing.join(", ")}。图标导出命名已从尺寸后缀（16/14）改为字重后缀（Regular/Medium），请同步更新源码引用。`);
+		}
 		/** Services required before mounting. */
 		const inject = [
 			"slots",
@@ -38315,12 +38311,12 @@ window.__ModuleLoader__.load({
 			{
 				id: "editor",
 				label: "编辑器",
-				icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconEditOutline16, {})
+				icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconEditOutlineRegular, {})
 			},
 			{
 				id: "folder",
 				label: "文件夹",
-				icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFolderOpen16, {})
+				icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFolderOpenRegular, {})
 			},
 			{
 				id: "vscode",
@@ -38340,7 +38336,7 @@ window.__ModuleLoader__.load({
 					className: "filex-header-btn",
 					size: "sm",
 					variant: "outline",
-					icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconEditOutline16, {}),
+					icon: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconEditOutlineRegular, {}),
 					title,
 					"aria-label": "文件预览 / 编辑",
 					onClick: (e) => {
@@ -38352,25 +38348,24 @@ window.__ModuleLoader__.load({
 		}
 		/**
 		* The hero ButtonGroup: the left button carries the remembered mode's icon and
-		* runs its action, the right chevron opens the mode dropdown. Rendered on the
-		* hero / new-session screen (both the corner seat on the new runtime and the
-		* floating fallback) — the in-chat header keeps the single built-in-editor
+		* runs its action, the right chevron opens the mode dropdown. Rendered only
+		* through the `hero.flex` slot declared by the dsh-hero-flex plugin (hero /
+		* blank-session header) — the in-chat header keeps the single built-in-editor
 		* `HeaderIcon`.
 		*
-		* `sessionId` is optional: the corner seat supplies it from the session
-		* standard kit; the floating fallback (root-scoped overlay) resolves it from
-		* `useSessions` → `state.current` instead.
+		* `sessionId` comes from the slot's session standard kit; without it the
+		* actions fall back to the live selection (`useSessions` → `state.current`)
+		* and show a notice when none exists.
 		*/
 		function HeroGroup(props) {
 			const state = (0, react.useSyncExternalStore)(subscribe, getSnapshot);
 			const [menuOpen, setMenuOpen] = (0, react.useState)(false);
 			const useSessions = props.useSessions ?? (() => void 0);
-			const current = useSessions((s) => s.current);
-			const sessionId = props.sessionId ?? current;
+			const sessionId = props.sessionId;
 			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 mainIcon = mode === "folder" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconFolderOpenRegular, {}) : mode === "vscode" ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(VscodeIcon, {}) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconEditOutlineRegular, {});
 			const mainTitle = mode === "folder" ? "打开系统文件夹" : mode === "vscode" ? "用 VSCode 打开工作区" : "文件预览 / 编辑（Ctrl+P）";
 			const onMainClick = (e) => {
 				e.stopPropagation();
@@ -38420,169 +38415,12 @@ window.__ModuleLoader__.load({
 								e.stopPropagation();
 								setMenuOpen((v) => !v);
 							},
-							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutline14, {})
+							children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconChevronDownOutlineRegular, {})
 						})]
 					})
 				})
 			});
 		}
-		/**
-		* Corner expand button re-painted beside the explorer ButtonGroup while this
-		* plugin occupies the header's corner seat. Matches the shell's `ExpandButton`
-		* (28×28, mirrored panel icon, tooltip); the toggle goes through the
-		* cross-plugin `sidebarRight` face. Hides itself while the panel is open,
-		* exactly like the shipped button — the DOM probe (`data-sidebar-right-open`)
-		* is the same attribute the shell's panel root carries, so it tracks even
-		* opens that did not come from this button.
-		*/
-		function CornerExpandButton(props) {
-			const [expanded, setExpanded] = (0, react.useState)(false);
-			(0, react.useEffect)(() => {
-				const probe = () => {
-					setExpanded(document.querySelector("[data-sidebar-right-open]") !== null);
-				};
-				probe();
-				const observer = new MutationObserver(probe);
-				observer.observe(document.body, {
-					childList: true,
-					subtree: true,
-					attributes: true,
-					attributeFilter: ["data-sidebar-right-open"]
-				});
-				window.addEventListener("resize", probe);
-				return () => {
-					observer.disconnect();
-					window.removeEventListener("resize", probe);
-				};
-			}, []);
-			if (expanded) return null;
-			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Tooltip, {
-				label: "展开右侧栏",
-				side: "bottom",
-				delayMs: 500,
-				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-					type: "button",
-					className: "filex-corner-expand",
-					"aria-label": "展开右侧栏",
-					"data-sidebar-right-expand": "",
-					onClick: () => {
-						props.sidebar.toggleExpanded();
-					},
-					children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconPanelLeftOutline16, { className: "filex-corner-expand-icon" })
-				})
-			});
-		}
-		/**
-		* The header's corner seat while the new-session header chrome is blank: the
-		* explorer ButtonGroup sits directly left of the expand button — the same
-		* corner seat, one flex row, no floating layer, no measuring. In a session
-		* with records the `utilities` seat renders (where the editor icon lives), so
-		* only the expand button is re-painted here; the DOM probe keeps the pair
-		* from ever duplicating.
-		*/
-		function HeaderCornerGroup(props) {
-			const [utilitiesPresent, setUtilitiesPresent] = (0, react.useState)(false);
-			const [sidebar, setSidebar] = (0, react.useState)(void 0);
-			(0, react.useEffect)(() => {
-				let alive = true;
-				let tries = 0;
-				const read = () => {
-					if (!alive) return;
-					let value;
-					try {
-						value = ctxRef?.get?.("sidebarRight", false) ?? ctxRef?.sidebarRight;
-					} catch {
-						value = void 0;
-					}
-					if (value !== void 0) {
-						setSidebar(value);
-						return;
-					}
-					tries += 1;
-					if (tries < 40) setTimeout(read, 250);
-				};
-				read();
-				return () => {
-					alive = false;
-				};
-			}, []);
-			(0, react.useEffect)(() => {
-				const probe = () => {
-					setUtilitiesPresent(document.querySelector("[data-slot=\"conversation.session.header.utilities\"]") !== null);
-				};
-				probe();
-				const observer = new MutationObserver(probe);
-				observer.observe(document.body, {
-					childList: true,
-					subtree: true
-				});
-				return () => observer.disconnect();
-			}, []);
-			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
-				className: "filex-corner",
-				children: [!utilitiesPresent && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(HeroGroup, { sessionId: props.sessionId }), sidebar !== void 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CornerExpandButton, { sidebar })]
-			});
-		}
-		/**
-		* 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
-		* records. Shown only while the conversation column is in its `hero` phase
-		* (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 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.
-		*
-		* On the new runtime the corner seat carries the same ButtonGroup, so this
-		* fallback hides itself the moment `.filex-corner` is rendered — the two
-		* paths never overlap.
-		*/
-		function HeroFilexButton(props) {
-			const [pos, setPos] = (0, react.useState)(null);
-			(0, react.useEffect)(() => {
-				const update = () => {
-					if (document.querySelector(".filex-corner") !== null) {
-						setPos(null);
-						return;
-					}
-					const column = document.querySelector("[data-phase]");
-					if (column === null || column.getAttribute("data-phase") !== "hero") {
-						setPos(null);
-						return;
-					}
-					const rect = column.getBoundingClientRect();
-					if (rect.width === 0 || rect.height === 0) {
-						setPos(null);
-						return;
-					}
-					const top = rect.top + 14;
-					const right = window.innerWidth - rect.right + 28;
-					setPos((current) => current !== null && current.top === top && current.right === right ? current : {
-						top,
-						right
-					});
-				};
-				const timer = window.setInterval(update, 400);
-				window.addEventListener("resize", update);
-				update();
-				return () => {
-					window.clearInterval(timer);
-					window.removeEventListener("resize", update);
-				};
-			}, []);
-			if (pos === null) return null;
-			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
-				className: "filex-hero-fab",
-				style: {
-					top: pos.top,
-					right: pos.right
-				},
-				children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(HeroGroup, { useSessions: props.useSessions })
-			});
-		}
 		/** The overlay entry: keyboard shortcut + modal + transient notice. */
 		function ExplorerOverlay(props) {
 			const state = (0, react.useSyncExternalStore)(subscribe, getSnapshot);
@@ -38637,6 +38475,7 @@ window.__ModuleLoader__.load({
 				} catch {}
 			};
 			try {
+				assertPrimitives();
 				const tagId = "dsh-file-explorer/styles";
 				ctx.effect(() => {
 					const dark = detectDark();
@@ -38658,29 +38497,21 @@ window.__ModuleLoader__.load({
 					order: 10,
 					label: "文件预览 / 编辑"
 				}, HeaderIcon));
-				ctx.slots.inject("shell.overlay", () => {
-					const overlay = ctx.slots.register({
-						name: "shell.overlay",
-						id: "file-explorer-overlay",
-						order: 100,
-						label: "文件预览"
-					}, ExplorerOverlay);
-					const heroFab = ctx.slots.register({
-						name: "shell.overlay",
-						id: "file-explorer-hero-fab",
-						order: 90,
-						label: "文件预览 / 编辑（hero）"
-					}, HeroFilexButton);
-					return () => {
-						overlay();
-						heroFab();
-					};
-				});
-				ctx.slots.inject("conversation.session.header.corner", () => ctx.slots.register({
-					name: "conversation.session.header.corner",
-					priority: -1,
-					label: "文件预览 / 编辑（角落）"
-				}, (props) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(HeaderCornerGroup, { sessionId: props.sessionId })));
+				ctx.slots.inject("shell.overlay", () => ctx.slots.register({
+					name: "shell.overlay",
+					id: "file-explorer-overlay",
+					order: 100,
+					label: "文件预览"
+				}, ExplorerOverlay));
+				ctx.slots.inject("hero.flex", () => ctx.slots.register({
+					name: "hero.flex",
+					id: "file-explorer",
+					order: 10,
+					label: "文件预览 / 编辑（hero）"
+				}, (props) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(HeroGroup, {
+					sessionId: props.sessionId,
+					useSessions: props.useSessions
+				})));
 				probeVscode();
 				ctx.effect(() => {
 					const deps = {

package/lib/types/context-types.d.ts

@@ -117,16 +117,6 @@ export interface FilexSlotsService {
     }, component: unknown): () => void;
     inject(key: string, callback: () => () => void): () => void;
 }
-/**
- * The cross-plugin right-sidebar face (`dsh-client-ui-sidebar-right` provides
- * it as `ctx.sidebarRight`). Only the expand-toggle and expanded-state read
- * are used here, to re-paint the header's corner expand button beside the
- * explorer ButtonGroup while the plugin occupies the corner seat.
- */
-export interface FilexSidebarRight {
-    isExpanded(): boolean;
-    toggleExpanded(): void;
-}
 declare module 'cordis' {
     interface Context {
         webServer: FilexWebServer;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-xhl/dsh-file-explorer",
-  "version": "0.1.8",
+  "version": "0.2.0",
   "description": "DSH 外部编译型插件：工作区文件预览 / 编辑（CodeMirror 6 编辑器 + 文件树 + 全文搜索 + Markdown/HTML/图片/PDF 预览）。移植自同目录下的动态 Cordis 插件版本。",
   "type": "module",
   "main": "lib/index.js",
@@ -41,9 +41,10 @@
     "README.md"
   ],
   "scripts": {
-    "build": "tsc -p tsconfig.build.json && tsdown",
+    "build": "tsc -p tsconfig.build.json && tsdown && node scripts/check-icons.mjs",
     "typecheck": "tsc --noEmit",
     "bundle": "tsdown",
+    "check:icons": "node scripts/check-icons.mjs",
     "prepare": "tsdown"
   },
   "license": "MIT",