@michengai/dsh-codex-ui 0.2.86 → 0.2.87

package/CHANGELOG.md

@@ -4,6 +4,23 @@
 
 This changelog records recent releases of DSH Codex UI and its one-click installer. Earlier changes remain available in the [Git history](https://github.com/MichengAI/dsh-codex-ui/commits/main).
 
+## 0.2.87 — 2026-08-26
+
+Companion release: `@michengai/dsh-codex-suite-installer@0.1.4`.
+
+### Fixed
+
+- Restored Chinese labels for the built-in permission presets in Settings and Chat with an exact-match compatibility adapter that leaves custom presets, prose, icons, and Host menu layout untouched.
+- Made **Open in File Explorer** bypass in-app file previews, close its menu immediately, and open Windows Explorer in the foreground and maximized.
+- Restyled conversation and workspace rename fields to match the native settings form, including helper copy, accessible labels, and a visible focus state.
+- Kept the Codex UI **About** section at the bottom of Settings even when third-party plugins add later sections.
+
+### Compatibility
+
+- Updated the lightweight installer to pin Codex UI `0.2.87`, IM Connect `0.1.24`, and Automation `0.1.15`; the legacy aggregate Suite remains private and unpublished.
+
+Published packages: [`@michengai/dsh-codex-ui@0.2.87`](https://www.npmjs.com/package/@michengai/dsh-codex-ui/v/0.2.87) and [`@michengai/dsh-codex-suite-installer@0.1.4`](https://www.npmjs.com/package/@michengai/dsh-codex-suite-installer/v/0.1.4).
+
 ## 0.2.86 — 2026-08-25
 
 Companion release: `@michengai/dsh-codex-suite-installer@0.1.3`.

package/CHANGELOG.zh-CN.md

@@ -4,6 +4,23 @@
 
 本日志记录 DSH Codex UI 及其一键安装器的最近发布；更早的变更可查看 [Git 提交历史](https://github.com/MichengAI/dsh-codex-ui/commits/main)。
 
+## 0.2.87 — 2026-08-26
+
+配套版本：`@michengai/dsh-codex-suite-installer@0.1.4`。
+
+### 修复
+
+- 恢复设置与 Chat 中三个内置权限预设的中文显示；兼容逻辑只精确替换权限控件文案，不改动自定义预设、正文、图标或宿主菜单布局。
+- “在资源管理器中打开”不再被应用内文件预览拦截；点击后立即收起菜单，并在前台最大化打开 Windows 资源管理器。
+- 将会话和工作区重命名输入框调整为原生设置表单样式，补充辅助说明、无障碍名称和清晰的焦点状态。
+- 即使第三方插件继续注册设置分区，也保证 Codex UI 自带的“关于”入口始终位于最底部。
+
+### 兼容性
+
+- 轻量安装器同步固定 Codex UI `0.2.87`、IM Connect `0.1.24` 和 Automation `0.1.15`；旧聚合 Suite 继续保持私有且不发布。
+
+发布包：[`@michengai/dsh-codex-ui@0.2.87`](https://www.npmjs.com/package/@michengai/dsh-codex-ui/v/0.2.87) 与 [`@michengai/dsh-codex-suite-installer@0.1.4`](https://www.npmjs.com/package/@michengai/dsh-codex-suite-installer/v/0.1.4)。
+
 ## 0.2.86 — 2026-08-25
 
 配套版本：`@michengai/dsh-codex-suite-installer@0.1.3`。

package/dist/client.js

@@ -1334,8 +1334,9 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 .dcu-wb-rename-actions{display:flex;justify-content:flex-end;gap:8px}
 .dcu-wb-delete-button{color:var(--dsw-alias-state-error-primary)!important}
 .dcu-wb-delete-copy{margin:0;color:var(--dcu-sidebar-secondary);font-size:13px;line-height:20px}
-.dcu-wb-rename-input{width:100%;height:44px;border:1px solid var(--dcu-sidebar-border);border-radius:22px;padding:7px 14px;outline:0;background:transparent;color:var(--dcu-sidebar-primary);font:inherit}
-.dcu-wb-rename-input:focus{border-color:var(--dsw-alias-button-info-fill)}
+.dcu-wb-rename-input{box-sizing:border-box;width:100%;height:36px;border:1px solid var(--dsw-alias-border-l2);border-radius:8px;padding:7px 10px;outline:0;background:var(--dsw-alias-background-secondary);color:var(--dsw-alias-label-primary);font:14px/20px var(--dsw-font-family,inherit);caret-color:var(--dsw-alias-state-business-primary);transition:border-color 120ms ease,box-shadow 120ms ease}
+.dcu-wb-rename-input:hover{border-color:color-mix(in srgb,var(--dsw-alias-label-primary) 32%,var(--dsw-alias-border-l2))}
+.dcu-wb-rename-input:focus{border-color:var(--dsw-alias-state-business-primary);box-shadow:0 0 0 1px color-mix(in srgb,var(--dsw-alias-state-business-primary) 28%,transparent)}
 `;
 		const runningStyles = `.dcu-wb-running{flex:none;width:12px;height:12px;border:2px solid color-mix(in srgb,var(--dcu-sidebar-secondary) 25%,transparent);border-top-color:var(--dcu-sidebar-secondary);border-radius:50%;animation:dcu-wb-spin .8s linear infinite}@keyframes dcu-wb-spin{to{transform:rotate(360deg)}}@media (prefers-reduced-motion:reduce){.dcu-wb-running{animation:none}}`;
 		const typographyStyles = `.dcu-wb{font:14px/20px var(--dcu-font,var(--dsw-font-family))}.dcu-wb-section-label{color:var(--dcu-sidebar-tertiary);font-size:13px;font-weight:400;letter-spacing:.02em}.dcu-wb-project-title{font-size:14px;line-height:20px;font-weight:400;color:var(--dcu-sidebar-primary)}.dcu-wb-session-title{font-size:14px;line-height:20px;font-weight:400;color:var(--dcu-sidebar-secondary)}.dcu-wb-session.dcu-wb-selected .dcu-wb-session-title,.dcu-wb-session:hover .dcu-wb-session-title{color:var(--dcu-sidebar-primary)}.dcu-wb-empty{color:var(--dcu-sidebar-tertiary);font-size:13px;line-height:18px}.dcu-wb-nochat{padding:0 8px 4px 28px;color:var(--dcu-sidebar-tertiary);font-size:14px;line-height:20px}`;
@@ -1605,6 +1606,11 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 					await (0, _deepseek_ai_dsh_client_ui_primitives.writeClipboard)(value);
 				});
 			};
+			const openPathImmediately = (path) => {
+				setMenu(void 0);
+				setHeaderMenu(void 0);
+				run("open-path", () => openPath(path));
+			};
 			const toggleGroup = (key, defaultOpen = true) => {
 				setExpanded((current) => ({
 					...current,
@@ -1816,7 +1822,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 												setPinnedWorkspaceIds((ids) => togglePinnedWorkspace(ids, workspace.workspaceId));
 												setMenu(void 0);
 											}
-											if (id === "openPath") run("open-path", () => openPath(workspace.path));
+											if (id === "openPath") openPathImmediately(workspace.path);
 											if (id === "delete") {
 												setDeleteTarget({
 													id: workspace.workspaceId,
@@ -2040,7 +2046,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 													setMenu(void 0);
 												}
 												if (action === "fork") run("fork", () => forkSession(id));
-												if (action === "openPath" && path !== void 0) run("open-path", () => openPath(path));
+												if (action === "openPath" && path !== void 0) openPathImmediately(path);
 												if (action === "copyPath") copy(path);
 												if (action === "copyTitle") copy(session.displayTitle);
 												if (action === "copyId") copy(id);
@@ -2380,7 +2386,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 													setMenu(void 0);
 												}
 												if (action === "fork") run("fork", () => forkSession(id));
-												if (action === "openPath" && session.cwd !== void 0) run("open-path", () => openPath(session.cwd));
+												if (action === "openPath" && session.cwd !== void 0) openPathImmediately(session.cwd);
 												if (action === "copyPath") copy(session.cwd);
 												if (action === "copyTitle") copy(title);
 												if (action === "copyId") copy(id);
@@ -2417,7 +2423,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 								setError(void 0);
 							}
 							if (action === "fork") run("fork", () => forkSession(id));
-							if (action === "openPath" && path !== void 0) run("open-path", () => openPath(path));
+							if (action === "openPath" && path !== void 0) openPathImmediately(path);
 							if (action === "copyPath") copy(path);
 							if (action === "copyTitle") copy(session.displayTitle);
 							if (action === "copyId") copy(id);
@@ -2446,6 +2452,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 						},
 						closeLabel: t("sessions.close"),
 						title: renameTarget?.kind === "workspace" ? t("workspace.rename") : t("sessions.rename"),
+						description: t("sessions.renameDescription"),
 						footer: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 							className: "dcu-wb-rename-actions",
 							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
@@ -2463,6 +2470,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 						}),
 						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
 							className: "dcu-wb-rename-input",
+							"aria-label": renameTarget?.kind === "workspace" ? t("workspace.rename") : t("sessions.rename"),
 							value: renameDraft,
 							autoFocus: true,
 							onFocus: (event) => {
@@ -2675,6 +2683,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 				},
 				closeLabel: t("sessions.close"),
 				title: t("sessions.rename"),
+				description: t("sessions.renameDescription"),
 				footer: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 					className: "dcu-wb-rename-actions",
 					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Button, {
@@ -2692,6 +2701,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 				}),
 				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
 					className: "dcu-wb-rename-input",
+					"aria-label": t("sessions.rename"),
 					value: renameDraft,
 					autoFocus: true,
 					onFocus: (event) => {
@@ -4327,6 +4337,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			"sessions.markRead": "标记为已读",
 			"sessions.unread": "未读",
 			"sessions.rename": "重命名会话",
+			"sessions.renameDescription": "保持简短且易于识别",
 			"sessions.archive": "归档会话",
 			"sessions.delete": "删除会话",
 			"sessions.deleteDescription": "将永久删除会话“{name}”及其全部记录，此操作不可恢复。",
@@ -4449,6 +4460,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			"sessions.markRead": "Mark as read",
 			"sessions.unread": "Unread",
 			"sessions.rename": "Rename conversation",
+			"sessions.renameDescription": "Keep it short and easy to recognize.",
 			"sessions.archive": "Archive conversation",
 			"sessions.delete": "Delete conversation",
 			"sessions.deleteDescription": "This permanently deletes “{name}” and all of its records. This cannot be undone.",
@@ -4505,6 +4517,30 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			"turns.untitled": "Untitled prompt",
 			"turns.jump": "Jump to turn {index}: {summary}"
 		};
+		//#endregion
+		//#region src/client/host-open-path.ts
+		const OPEN_IN_EXPLORER_ENDPOINT = "/api/michengai/codex-ui/open-in-explorer";
+		/** “在资源管理器中打开”属于明确的系统动作，不应被侧边栏文件预览器接管。 */
+		async function openPathInHost(connection, path, fetcher = fetch) {
+			let foregroundResponse;
+			try {
+				foregroundResponse = await fetcher(OPEN_IN_EXPLORER_ENDPOINT, {
+					method: "POST",
+					headers: { "content-type": "application/json" },
+					body: JSON.stringify({ path })
+				});
+			} catch {}
+			if (foregroundResponse?.ok) return;
+			if (foregroundResponse !== void 0 && foregroundResponse.status !== 404 && foregroundResponse.status !== 501) {
+				const payload = await foregroundResponse.json().catch(() => ({}));
+				throw new Error(typeof payload.error === "string" ? payload.error : "无法在前台打开资源管理器。");
+			}
+			const response = await connection.api.host.openPath({ path });
+			if (!response.result.ok) throw new Error(`path open failed: ${response.result.error.message}`);
+		}
+		//#endregion
+		//#region src/client/settings-nav-icons.ts
+		const ABOUT_SETTINGS_NAV_ORDER = "2147483647";
 		const SETTINGS_NAV_ICON_HTML = {
 			experts: "<path fill=\"currentColor\" d=\"M11.0307 5.46369C11.0305 3.78995 9.6734 2.43357 7.99961 2.43357C6.32601 2.43379 4.96972 3.79009 4.96949 5.46369C4.96949 7.13748 6.32587 8.49455 7.99961 8.49477C9.67354 8.49477 11.0307 7.13762 11.0307 5.46369ZM12.3163 5.46369C12.3163 7.84777 10.3837 9.78042 7.99961 9.78042C5.61572 9.7802 3.68288 7.84763 3.68288 5.46369C3.6831 3.07993 5.61586 1.14718 7.99961 1.14695C10.3836 1.14695 12.3161 3.0798 12.3163 5.46369Z\"/><path fill=\"currentColor\" d=\"M8.00002 10.3316C11.7343 10.3316 14.1864 11.8997 15.0387 14.4445L14.4292 14.6483L13.8197 14.8531C13.1955 12.9893 11.3673 11.6182 8.00002 11.6182C4.63277 11.6182 2.80455 12.9893 2.18031 14.8531L1.5708 14.6483L0.961304 14.4445C1.81368 11.8997 4.26579 10.3316 8.00002 10.3316Z\"/>",
 			skills: "<path fill=\"currentColor\" d=\"M12.5113 15.4067C12.4395 15.6249 12.1308 15.6249 12.059 15.4067L11.643 14.1416C11.454 13.567 11.0033 13.1164 10.4288 12.9274L9.16369 12.5113C8.94544 12.4395 8.94544 12.1308 9.16369 12.059L10.4288 11.643C11.0033 11.454 11.454 11.0033 11.643 10.4288L12.059 9.16369C12.1308 8.94544 12.4395 8.94544 12.5113 9.16369L12.9274 10.4288C13.1164 11.0033 13.567 11.454 14.1416 11.643L15.4067 12.059C15.6249 12.1308 15.6249 12.4395 15.4067 12.5113L14.1416 12.9274C13.567 13.1164 13.1164 13.567 12.9274 14.1416L12.5113 15.4067Z\"/><path fill=\"currentColor\" d=\"M9.02246 0.546878C9.9822 0.546878 10.7564 0.545403 11.374 0.612307C12.0042 0.680586 12.5515 0.826244 13.0273 1.17188C13.3052 1.37376 13.5501 1.61868 13.752 1.89649C14.0975 2.37225 14.2432 2.91984 14.3115 3.54981C14.3784 4.16727 14.377 4.94206 14.377 5.90137V8.51367C13.9611 8.29533 13.5071 8.13985 13.0273 8.06055V5.90137C13.0273 4.9121 13.0259 4.22322 12.9688 3.69532C12.9129 3.18044 12.8098 2.89782 12.6592 2.69043C12.5406 2.52724 12.3966 2.38326 12.2334 2.26465C12.026 2.11404 11.7437 2.0109 11.2285 1.95508C10.7005 1.89789 10.0122 1.89649 9.02246 1.89649H6.55371C5.56395 1.89649 4.87569 1.89787 4.34766 1.95508C3.83242 2.01092 3.55022 2.11398 3.34278 2.26465C3.17953 2.38329 3.03564 2.52719 2.91699 2.69043C2.76642 2.89782 2.66325 3.18042 2.60742 3.69532C2.55027 4.22322 2.54883 4.9121 2.54883 5.90137V10.0986C2.54883 11.0878 2.55031 11.7768 2.60742 12.3047C2.66326 12.8196 2.76642 13.1032 2.91699 13.3105C3.03558 13.4736 3.17966 13.6178 3.34278 13.7363C3.5502 13.8869 3.83265 13.9901 4.34766 14.0459C4.87568 14.1031 5.56398 14.1035 6.55371 14.1035H8.08399C8.27443 14.6025 8.55077 15.0585 8.89551 15.4541H6.55371C5.59402 15.4541 4.81976 15.4546 4.20215 15.3877C3.57204 15.3194 3.02468 15.1738 2.54883 14.8281C2.27111 14.6263 2.02606 14.3813 1.82422 14.1035C1.47883 13.6278 1.33293 13.08 1.26465 12.4502C1.19783 11.8327 1.19922 11.0579 1.19922 10.0986V5.90137C1.19922 4.94206 1.1978 4.16727 1.26465 3.54981C1.33295 2.91984 1.47867 2.37225 1.82422 1.89649C2.02613 1.61864 2.27098 1.37379 2.54883 1.17188C3.02472 0.826181 3.57197 0.6806 4.20215 0.612307C4.81976 0.545393 5.594 0.546877 6.55371 0.546878H9.02246ZM9.19629 9.14649H4.5459V7.84571H9.19629V9.14649ZM11.0303 6.10645H4.5459V4.80567H11.0303V6.10645Z\"/>",
@@ -4534,9 +4570,20 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 		function applySettingsNavIcon(button) {
 			const id = settingsNavIconId(button.textContent ?? "");
 			if (id === void 0) return false;
+			let changed = false;
+			if (id === "about") {
+				if (!button.hasAttribute("data-dcu-settings-about-last")) {
+					button.setAttribute("data-dcu-settings-about-last", "");
+					changed = true;
+				}
+				if (button.style.getPropertyValue("order") !== "2147483647" || button.style.getPropertyPriority("order") !== "important") {
+					button.style.setProperty("order", ABOUT_SETTINGS_NAV_ORDER, "important");
+					changed = true;
+				}
+			}
 			const svg = button.querySelector("svg");
-			if (svg === null) return false;
-			if (svg.getAttribute("data-dcu-nav-icon") === id) return false;
+			if (svg === null) return changed;
+			if (svg.getAttribute("data-dcu-nav-icon") === id) return changed;
 			svg.setAttribute("data-dcu-nav-icon", id);
 			svg.setAttribute("viewBox", id === "archive" ? "0 0 20 20" : id === "about" ? "0 0 14 14" : "0 0 16 16");
 			svg.setAttribute("fill", "none");
@@ -4581,6 +4628,105 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			};
 		}
 		//#endregion
+		//#region src/client/permission-labels.ts
+		const PERMISSION_LABELS = [
+			{
+				aliases: [
+					"Read Only",
+					"preset.readOnly",
+					"只读"
+				],
+				en: "Read Only",
+				zh: "只读"
+			},
+			{
+				aliases: [
+					"Workspace Write",
+					"preset.workspaceWrite",
+					"工作区写入"
+				],
+				en: "Workspace Write",
+				zh: "工作区写入"
+			},
+			{
+				aliases: [
+					"Full access",
+					"preset.fullAccess",
+					"完全访问"
+				],
+				en: "Full access",
+				zh: "完全访问"
+			}
+		];
+		const INTERACTIVE_SELECTOR = "button, [role=\"menuitem\"], [role=\"menuitemradio\"], [role=\"option\"]";
+		function targetLabel(value, activeLocale) {
+			const definition = PERMISSION_LABELS.find((item) => item.aliases.includes(value));
+			if (definition === void 0) return void 0;
+			return activeLocale.toLowerCase().startsWith("zh") ? definition.zh : definition.en;
+		}
+		function applyPermissionLabel(element, activeLocale) {
+			const document = element.ownerDocument;
+			const showText = document.defaultView?.NodeFilter.SHOW_TEXT ?? 4;
+			const walker = document.createTreeWalker(element, showText);
+			let changed = false;
+			let node = walker.nextNode();
+			while (node !== null) {
+				const value = node.nodeValue ?? "";
+				const trimmed = value.trim();
+				const next = targetLabel(trimmed, activeLocale);
+				if (next !== void 0 && next !== trimmed) {
+					node.nodeValue = value.replace(trimmed, next);
+					changed = true;
+				}
+				node = walker.nextNode();
+			}
+			return changed;
+		}
+		/** 只修正权限选择控件里的内置预设名称，不改动正文或自定义权限名称。 */
+		function localizePermissionLabels(root, activeLocale) {
+			let changed = 0;
+			const rootElement = root.nodeType === 1 ? root : void 0;
+			const elements = rootElement?.matches(INTERACTIVE_SELECTOR) === true ? [rootElement, ...rootElement.querySelectorAll(INTERACTIVE_SELECTOR)] : [...root.querySelectorAll(INTERACTIVE_SELECTOR)];
+			for (const element of elements) if (applyPermissionLabel(element, activeLocale)) changed += 1;
+			return changed;
+		}
+		/** 兼容宿主设置页和 Chat 中由官方组件直接输出的英文权限名称。 */
+		function observePermissionLabels(locale) {
+			if (typeof document === "undefined" || document.body === null) return () => {};
+			let applying = false;
+			let frame;
+			const apply = () => {
+				if (applying) return;
+				applying = true;
+				const active = locale.getSnapshot?.().active ?? document.documentElement.lang ?? window.navigator.language ?? "zh";
+				try {
+					localizePermissionLabels(document, active);
+				} finally {
+					applying = false;
+				}
+			};
+			const schedule = () => {
+				if (frame !== void 0) return;
+				frame = window.requestAnimationFrame(() => {
+					frame = void 0;
+					apply();
+				});
+			};
+			apply();
+			const observer = new MutationObserver(schedule);
+			observer.observe(document.body, {
+				childList: true,
+				characterData: true,
+				subtree: true
+			});
+			const unsubscribe = locale.subscribe?.(schedule) ?? (() => {});
+			return () => {
+				observer.disconnect();
+				unsubscribe();
+				if (frame !== void 0) window.cancelAnimationFrame(frame);
+			};
+		}
+		//#endregion
 		//#region src/client/conversation-dom.ts
 		/**
 		* DSH 尚未公开会话滚动容器和消息锚点服务；把兼容读取集中在这里，方便
@@ -4828,7 +4974,8 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			"sessions",
 			"workspaces",
 			"layout",
-			"locale"
+			"locale",
+			"connection"
 		];
 		function hasDeleteSession(value) {
 			return value !== null && typeof value === "object" && "deleteSession" in value && typeof value.deleteSession === "function";
@@ -4840,8 +4987,11 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 				en
 			}), "michengai-codex-ui: dictionaries");
 			const t = ctx.locale.bind(NS);
+			const connection = ctx.get("connection");
+			const openPath = (path) => openPathInHost(connection, path);
 			ctx.effect(() => observeSlimSidebar(), "michengai-codex-ui: slim sidebar");
 			ctx.effect(() => observeSettingsNavIcons(), "michengai-codex-ui: settings nav icons");
+			ctx.effect(() => observePermissionLabels(ctx.locale), "michengai-codex-ui: permission labels");
 			ctx.effect(() => observeConversationHeader(), "michengai-codex-ui: conversation header");
 			const companionSlots = createCompanionTabSource(ctx.slots);
 			ctx.slots.inject("sidebar", () => ctx.slots.register({
@@ -4884,7 +5034,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 					deleteSession,
 					forkSession,
 					renameSession,
-					openPath: (path) => ctx.workspaces.openPath(path),
+					openPath,
 					companionSlots
 				})
 			}, CodexSidebar));
@@ -4922,7 +5072,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 					deleteSession,
 					deleteWorkspace: (workspaceId) => ctx.workspaces.delete(workspaceId),
 					forkSession,
-					openPath: (path) => ctx.workspaces.openPath(path),
+					openPath,
 					openSession: (sessionId) => {
 						ctx.sessions.open(sessionId);
 					},
@@ -4962,7 +5112,7 @@ header [data-dcu-title-folder] svg,header [data-dcu-title-more] svg{display:bloc
 			ctx.slots.inject("settings.section", () => ctx.slots.register({
 				name: "settings.section",
 				id: "about",
-				order: 100,
+				order: Number.MAX_SAFE_INTEGER,
 				label: () => t("about.nav"),
 				locale: NS
 			}, AboutSection));

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import { spawn } from "node:child_process";
 import { mkdir, readFile, rename, rm, unlink, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
-import { basename, dirname, join, resolve, sep } from "node:path";
+import { basename, dirname, isAbsolute, join, resolve, sep } from "node:path";
 import { fileURLToPath } from "node:url";
 import { randomUUID } from "node:crypto";
 //#region src/dependencies.ts
@@ -529,6 +529,224 @@ function hostServices(ctx) {
 	};
 }
 //#endregion
+//#region src/native-explorer.ts
+const WINDOWS_EXPLORER_TIMEOUT_MS = 8e3;
+const WINDOWS_FOREGROUND_EXPLORER_SCRIPT = String.raw`
+$ErrorActionPreference = 'Stop'
+
+Add-Type -TypeDefinition @'
+using System;
+using System.Runtime.InteropServices;
+public static class DcuWindowFocus {
+  [DllImport("user32.dll")] public static extern IntPtr GetForegroundWindow();
+  [DllImport("user32.dll")] public static extern uint GetWindowThreadProcessId(IntPtr hWnd, out uint pid);
+  [DllImport("kernel32.dll")] public static extern uint GetCurrentThreadId();
+  [DllImport("user32.dll")] public static extern bool AttachThreadInput(uint idAttach, uint idAttachTo, bool attach);
+  [DllImport("user32.dll")] public static extern bool ShowWindowAsync(IntPtr hWnd, int command);
+  [DllImport("user32.dll")] public static extern bool BringWindowToTop(IntPtr hWnd);
+  [DllImport("user32.dll")] public static extern bool SetForegroundWindow(IntPtr hWnd);
+}
+'@
+
+$shell = New-Object -ComObject Shell.Application
+
+function Find-ExplorerWindow([string]$path) {
+  foreach ($item in @($shell.Windows())) {
+    try {
+      $candidate = [IO.Path]::GetFullPath([string]$item.Document.Folder.Self.Path).TrimEnd('\')
+      if ($candidate -ieq $path) { return $item }
+    } catch {}
+  }
+  return $null
+}
+
+function Open-ExplorerInForeground([string]$target) {
+  $target = [IO.Path]::GetFullPath($target).TrimEnd('\')
+  $window = Find-ExplorerWindow $target
+  if ($null -eq $window) {
+    $shell.Explore($target)
+    for ($attempt = 0; $attempt -lt 120 -and $null -eq $window; $attempt += 1) {
+      Start-Sleep -Milliseconds 25
+      $window = Find-ExplorerWindow $target
+    }
+  }
+  if ($null -eq $window) { throw 'Explorer window was not found.' }
+
+  $handle = [IntPtr]([long]$window.HWND)
+  $foreground = [DcuWindowFocus]::GetForegroundWindow()
+  $foregroundProcessId = 0
+  $foregroundThread = [DcuWindowFocus]::GetWindowThreadProcessId($foreground, [ref]$foregroundProcessId)
+  $currentThread = [DcuWindowFocus]::GetCurrentThreadId()
+  $attached = $foregroundThread -ne 0 -and [DcuWindowFocus]::AttachThreadInput($currentThread, $foregroundThread, $true)
+  try {
+    [void][DcuWindowFocus]::ShowWindowAsync($handle, 3)
+    [void][DcuWindowFocus]::BringWindowToTop($handle)
+    if (-not [DcuWindowFocus]::SetForegroundWindow($handle)) { throw 'Explorer could not be activated.' }
+  } finally {
+    if ($attached) { [void][DcuWindowFocus]::AttachThreadInput($currentThread, $foregroundThread, $false) }
+  }
+}
+
+[Console]::Out.WriteLine('READY')
+[Console]::Out.Flush()
+while (($line = [Console]::In.ReadLine()) -ne $null) {
+  if ([string]::IsNullOrWhiteSpace($line)) { continue }
+  $parts = $line.Split([char]9, 2)
+  $requestId = $parts[0]
+  try {
+    if ($parts.Count -ne 2) { throw 'Invalid request.' }
+    $target = [Text.Encoding]::UTF8.GetString([Convert]::FromBase64String($parts[1]))
+    Open-ExplorerInForeground $target
+    [Console]::Out.WriteLine(('OK' + [char]9 + $requestId))
+  } catch {
+    $message = [Convert]::ToBase64String([Text.Encoding]::UTF8.GetBytes([string]$_.Exception.Message))
+    [Console]::Out.WriteLine(('ERR' + [char]9 + $requestId + [char]9 + $message))
+  }
+  [Console]::Out.Flush()
+}
+`;
+/**
+* 常驻的 Windows Explorer 前台激活助手。
+* PowerShell 与窗口 API 只在 Host 启动时初始化一次，点击时仅发送一行路径请求。
+*/
+var ForegroundExplorer = class {
+	run;
+	platform;
+	child;
+	startupChild;
+	starting;
+	stdout = "";
+	sequence = 0;
+	pending = /* @__PURE__ */ new Map();
+	disposed = false;
+	constructor(run = spawn, platform = process.platform) {
+		this.run = run;
+		this.platform = platform;
+	}
+	/** 在用户点击前完成 PowerShell 与窗口 API 初始化。 */
+	warmup() {
+		if (this.platform !== "win32") return Promise.resolve();
+		return this.ensureStarted().then(() => void 0);
+	}
+	async open(path) {
+		if (this.platform !== "win32") throw new Error("foreground Explorer is only available on Windows");
+		if (!isAbsolute(path)) throw new Error("Explorer path must be absolute");
+		if (this.disposed) throw new Error("Explorer helper has been disposed");
+		const child = await this.ensureStarted();
+		const requestId = String(++this.sequence);
+		const encodedPath = Buffer.from(path, "utf8").toString("base64");
+		return await new Promise((resolve, reject) => {
+			const timeout = setTimeout(() => {
+				this.pending.delete(requestId);
+				reject(/* @__PURE__ */ new Error("Explorer activation timed out"));
+			}, WINDOWS_EXPLORER_TIMEOUT_MS);
+			timeout.unref?.();
+			this.pending.set(requestId, {
+				resolve,
+				reject,
+				timeout
+			});
+			child.stdin.write(`${requestId}\t${encodedPath}\n`, (error) => {
+				if (error === null || error === void 0) return;
+				const request = this.pending.get(requestId);
+				if (request === void 0) return;
+				clearTimeout(request.timeout);
+				this.pending.delete(requestId);
+				request.reject(error);
+			});
+		});
+	}
+	dispose() {
+		this.disposed = true;
+		this.failAll(/* @__PURE__ */ new Error("Explorer helper has been disposed"));
+		this.startupChild?.kill();
+		this.child?.kill();
+		this.startupChild = void 0;
+		this.child = void 0;
+		this.starting = void 0;
+	}
+	ensureStarted() {
+		if (this.disposed) return Promise.reject(/* @__PURE__ */ new Error("Explorer helper has been disposed"));
+		if (this.child !== void 0) return Promise.resolve(this.child);
+		if (this.starting !== void 0) return this.starting;
+		const encoded = Buffer.from(WINDOWS_FOREGROUND_EXPLORER_SCRIPT, "utf16le").toString("base64");
+		this.starting = new Promise((resolve, reject) => {
+			const child = this.run("powershell.exe", [
+				"-NoLogo",
+				"-NoProfile",
+				"-NonInteractive",
+				"-EncodedCommand",
+				encoded
+			], { windowsHide: true });
+			this.startupChild = child;
+			let settled = false;
+			const finishStart = (error) => {
+				if (settled) return;
+				settled = true;
+				clearTimeout(startupTimeout);
+				if (error !== void 0) {
+					this.starting = void 0;
+					if (this.startupChild === child) this.startupChild = void 0;
+					child.kill();
+					reject(error);
+					return;
+				}
+				if (this.disposed) {
+					this.starting = void 0;
+					if (this.startupChild === child) this.startupChild = void 0;
+					child.kill();
+					reject(/* @__PURE__ */ new Error("Explorer helper has been disposed"));
+					return;
+				}
+				if (this.startupChild === child) this.startupChild = void 0;
+				this.child = child;
+				this.starting = void 0;
+				resolve(child);
+			};
+			const startupTimeout = setTimeout(() => finishStart(/* @__PURE__ */ new Error("Explorer helper startup timed out")), WINDOWS_EXPLORER_TIMEOUT_MS);
+			startupTimeout.unref?.();
+			child.stdout.on("data", (chunk) => {
+				this.stdout += String(chunk);
+				let newline = this.stdout.indexOf("\n");
+				while (newline >= 0) {
+					const line = this.stdout.slice(0, newline).trimEnd();
+					this.stdout = this.stdout.slice(newline + 1);
+					if (line === "READY") finishStart();
+					else this.handleResponse(line);
+					newline = this.stdout.indexOf("\n");
+				}
+			});
+			child.once("error", (error) => finishStart(error));
+			child.once("exit", () => {
+				if (!settled) finishStart(/* @__PURE__ */ new Error("Explorer helper exited during startup"));
+				if (this.child === child) this.child = void 0;
+				this.failAll(/* @__PURE__ */ new Error("Explorer helper exited"));
+			});
+		});
+		return this.starting;
+	}
+	handleResponse(line) {
+		const [status, requestId, encodedMessage] = line.split("	");
+		const request = requestId === void 0 ? void 0 : this.pending.get(requestId);
+		if (request === void 0) return;
+		clearTimeout(request.timeout);
+		this.pending.delete(requestId);
+		if (status === "OK") {
+			request.resolve();
+			return;
+		}
+		const message = encodedMessage === void 0 ? "Explorer activation failed" : Buffer.from(encodedMessage, "base64").toString("utf8");
+		request.reject(new Error(message));
+	}
+	failAll(error) {
+		for (const request of this.pending.values()) {
+			clearTimeout(request.timeout);
+			request.reject(error);
+		}
+		this.pending.clear();
+	}
+};
+//#endregion
 //#region src/workspace-preferences.ts
 const WORKSPACE_PREFERENCES_FILE = ".dsh-codex-ui-preferences.json";
 /** Desktop 和普通 DSH Web 共用 Profile；服务换端口或重启后目录仍保持稳定。 */
@@ -596,6 +814,7 @@ function writeWorkspacePreferences(pinnedWorkspaceIds, path = workspacePreferenc
 //#region src/index.ts
 const connectorsEndpoint = "/api/michengai/codex-ui/connectors";
 const dependenciesEndpoint = "/api/michengai/codex-ui/dependencies";
+const explorerEndpoint = "/api/michengai/codex-ui/open-in-explorer";
 const preferencesEndpoint = "/api/michengai/codex-ui/preferences";
 const maxPreferencesBodyBytes = 32768;
 function headerValue(headers, name) {
@@ -656,6 +875,8 @@ const inject = [
 function apply(ctx) {
 	const host = hostServices(ctx);
 	ctx.effect(() => {
+		const foregroundExplorer = new ForegroundExplorer();
+		foregroundExplorer.warmup().catch((error) => ctx.logger.warn("foreground explorer warmup failed: %s", error));
 		const disposeConnectors = host.webServer.register({
 			kind: "exact",
 			path: connectorsEndpoint,
@@ -844,10 +1065,66 @@ function apply(ctx) {
 				}
 			}
 		});
+		const disposeExplorer = host.webServer.register({
+			kind: "exact",
+			path: explorerEndpoint,
+			handler: async (request, response) => {
+				if (request.method !== "POST") {
+					response.writeHead(405, { allow: "POST" });
+					response.end();
+					return;
+				}
+				if (crossSiteRequest(request)) {
+					response.writeHead(403, {
+						"content-type": "application/json; charset=utf-8",
+						"cache-control": "no-store"
+					});
+					response.end(JSON.stringify({ error: "已拒绝跨站请求。" }));
+					return;
+				}
+				if (process.platform !== "win32") {
+					response.writeHead(501, {
+						"content-type": "application/json; charset=utf-8",
+						"cache-control": "no-store"
+					});
+					response.end(JSON.stringify({ error: "当前平台使用系统默认打开方式。" }));
+					return;
+				}
+				try {
+					const body = JSON.parse(await readRequestBody(request));
+					if (typeof body.path !== "string" || body.path.trim() === "") {
+						response.writeHead(400, {
+							"content-type": "application/json; charset=utf-8",
+							"cache-control": "no-store"
+						});
+						response.end(JSON.stringify({ error: "目录路径无效。" }));
+						return;
+					}
+					await foregroundExplorer.open(body.path);
+					response.writeHead(200, {
+						"content-type": "application/json; charset=utf-8",
+						"cache-control": "no-store"
+					});
+					response.end(JSON.stringify({
+						opened: true,
+						foreground: true
+					}));
+				} catch (error) {
+					ctx.logger.warn("foreground explorer open failed: %s", error);
+					response.writeHead(error instanceof SyntaxError ? 400 : 503, {
+						"content-type": "application/json; charset=utf-8",
+						"cache-control": "no-store"
+					});
+					response.end(JSON.stringify({ error: error instanceof SyntaxError ? "目录路径格式无效。" : "无法在前台打开资源管理器。" }));
+				}
+			}
+		});
 		return () => {
 			disposeDependencyInstaller();
+			foregroundExplorer.dispose();
 			disposeConnectors();
 			disposeDependencies();
+			disposeExplorer();
 			disposePreferences();
 		};
 	}, "michengai-codex-ui: catalogs");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michengai/dsh-codex-ui",
-  "version": "0.2.86",
+  "version": "0.2.87",
   "description": "以 Codex 风格重构 DSH Web 侧栏的独立客户端插件",
   "license": "Apache-2.0",
   "publishConfig": {
@@ -53,6 +53,11 @@
       "platform": "web"
     }
   },
+  "scripts": {
+    "build": "tsc --noEmit && tsdown",
+    "typecheck": "tsc --noEmit",
+    "test": "pnpm run typecheck && vitest run tests/client-runtime.integration.spec.ts && tsdown && node tests/run-assertions.mjs"
+  },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.1 <5.0.0",
     "@deepseek-ai/dsh-client-locale": ">=0.1.0-rc.0 <0.2.0",
@@ -98,10 +103,5 @@
     "tsx": "^4.22.4",
     "typescript": "^6.0.3",
     "vitest": "^4.1.8"
-  },
-  "scripts": {
-    "build": "tsc --noEmit && tsdown",
-    "typecheck": "tsc --noEmit",
-    "test": "pnpm run typecheck && vitest run tests/client-runtime.integration.spec.ts && tsdown && node tests/run-assertions.mjs"
   }
-}
+}