@michengai/dsh-codex-ui 0.2.113 → 1.0.0

package/CHANGELOG.md

@@ -4,7 +4,31 @@
 
 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).
 
-## Unreleased
+## 1.0.0 - 2026-09-08
+
+- Release 1.0.0, bringing project and conversation navigation, plugin entry points, and standalone settings together in a cohesive Codex-style experience.
+- Fix flashing when returning to the app or pressing Escape; let menus handle Escape first and preserve the current settings form while filtering navigation.
+- Upgrade notes: the standalone settings view requires the bundle patch that disables ui-settings-general. If an existing settings shell is detected, its entry is retained. Replacing client files alone is not a complete upgrade; reload DSH after upgrading. Existing business configuration and conversations require no migration.
+- Fix global settings search, onboarding and keyboard focus isolation, Escape handling for hidden dialogs, and configuration-file error feedback; retain the host settings shell when it is already active.
+- Replace the settings dialog with a Codex-style standalone view, category search, grouped preferences, and focus restoration when returning to the app.
+- Fix duplicate settings-shell registration, settings entry alignment and transitions, search focus, repeated headings, and content spacing.
+- Give the plugin marketplace and side cards distinct store and sidebar-layout icons instead of the generic box.
+- Preserve host configuration, onboarding, connection recovery, and installed plugin functionality; community plugin internal styling remains outside this change.
+
+## suite-installer-v0.1.31 - 2026-09-08
+
+Resolved and pinned the following member versions from the official npm registry:
+
+- `@michengai/dsh-archive-manager@0.1.32`
+- `@michengai/dsh-codex-ui@0.2.113`
+- `@michengai/dsh-skills-manager@0.1.43`
+- `@michengai/dsh-agency-agents@0.1.34`
+- `@michengai/dsh-im-connect@0.1.38`
+- `@michengai/dsh-automation@0.1.34`
+- `@michengai/dsh-btw@0.1.4`
+- `@michengai/dsh-simplify@0.1.2`
+
+The installer uses these exact versions for reproducible installation.
 
 ## 0.2.113 - 2026-09-08
 

package/CHANGELOG.zh-CN.md

@@ -4,7 +4,31 @@
 
 本日志记录 DSH Codex UI 及其一键安装器的最近发布；更早的变更可查看 [Git 提交历史](https://github.com/MichengAI/dsh-codex-ui/commits/main)。
 
-## 未发布
+## 1.0.0 - 2026-09-08
+
+- 发布 1.0.0：将项目与会话导航、插件入口和独立设置视图整合为完整的 Codex 风格体验。
+- 修复返回应用和 Escape 退出时的页面闪烁；菜单先处理 Escape，搜索筛选保留正在填写的正文。
+- 升级说明：独立设置页依赖 bundle patch 停用 ui-settings-general；检测到既有设置壳时保留宿主入口。单独替换客户端文件不等同于完整升级，升级后应重载 DSH。既有业务配置和会话无需迁移。
+- 修复全局搜索设置入口、引导与键盘焦点隔离、隐藏弹窗对 Escape 的影响及配置文件失败反馈；旧设置壳并存时保留宿主入口。
+- 设置改为 Codex 风格的独立页面，提供分类搜索、分组偏好、返回应用及焦点恢复。
+- 修复新旧设置壳重复注册、设置入口对齐与交互动画、搜索聚焦、重复标题及内容留白。
+- 为插件市场和侧边卡片分别使用商店与侧栏布局图标，避免与默认盒子图标混淆。
+- 保留宿主配置、引导和连接恢复接口，以及已安装插件原有功能；社区插件内部样式不在本次统一范围。
+
+## suite-installer-v0.1.31 - 2026-09-08
+
+从官方 npm 解析并锁定以下成员版本：
+
+- `@michengai/dsh-archive-manager@0.1.32`
+- `@michengai/dsh-codex-ui@0.2.113`
+- `@michengai/dsh-skills-manager@0.1.43`
+- `@michengai/dsh-agency-agents@0.1.34`
+- `@michengai/dsh-im-connect@0.1.38`
+- `@michengai/dsh-automation@0.1.34`
+- `@michengai/dsh-btw@0.1.4`
+- `@michengai/dsh-simplify@0.1.2`
+
+安装器使用这些精确版本执行安装，确保可复现。
 
 ## 0.2.113 - 2026-09-08
 

package/cordis.patch.yml

@@ -1,6 +1,8 @@
-# 由本插件接管 sidebar 的子插槽声明，原设置面板仍通过 sidebar.settings 挂载。
+# 由本插件统一声明侧栏和设置子插槽，避免与原壳重复声明。
 - id: ui-sidebar
   disabled: true
+- id: ui-settings-general
+  disabled: true
 - insert:
     - id: codex-ui
       name: '@michengai/dsh-codex-ui'

package/lib/client.js

@@ -30,16 +30,22 @@ window.__ModuleLoader__.load({
 		}
 		let cancelPendingNavigation;
 		const SETTINGS_NAVIGATION_TIMEOUT_MS = 4e3;
+		const SETTINGS_TRIGGER_SELECTOR = "[data-dcu-settings-trigger],[aria-haspopup=\"dialog\"]";
+		/** 根入口与分区跳转使用同一触发器合约，兼容保留的宿主设置壳。 */
+		function openSettingsRoot(root) {
+			root?.querySelector(SETTINGS_TRIGGER_SELECTOR)?.click();
+		}
 		function openSettingsSection(root, label, onMissing, onSelected) {
 			const labels = typeof label === "string" ? [label] : label;
-			const trigger = root?.querySelector("[aria-haspopup=\"dialog\"]");
+			const trigger = root?.querySelector(SETTINGS_TRIGGER_SELECTOR);
 			if (trigger === null || trigger === void 0) {
 				onMissing?.();
 				return;
 			}
 			const opening = cancelPendingNavigation !== void 0;
 			cancelPendingNavigation?.();
-			if (!opening && document.querySelector("[role=\"dialog\"]") === null) trigger.click();
+			const pageSelector = trigger.hasAttribute("data-dcu-settings-trigger") ? "[data-dcu-settings-page]" : "[role=\"dialog\"]";
+			if (!opening && document.querySelector(pageSelector) === null) trigger.click();
 			let frame;
 			let finished = false;
 			const observer = new MutationObserver(() => {
@@ -54,7 +60,7 @@ window.__ModuleLoader__.load({
 				if (cancelPendingNavigation === cleanup) cancelPendingNavigation = void 0;
 			};
 			const select = () => {
-				const target = pickSettingsSectionButton([...document.querySelectorAll("[role=\"dialog\"] nav button")], labels);
+				const target = pickSettingsSectionButton([...document.querySelectorAll(`${pageSelector} nav button`)], labels);
 				if (target === void 0) return false;
 				cleanup();
 				target.click();
@@ -483,6 +489,148 @@ window.__ModuleLoader__.load({
 		* This source code is licensed under the ISC license.
 		* See the LICENSE file in the root directory of this source tree.
 		*/
+		const ArrowLeft = createLucideIcon("arrow-left", [["path", {
+			d: "m12 19-7-7 7-7",
+			key: "1l729n"
+		}], ["path", {
+			d: "M19 12H5",
+			key: "x3x0zl"
+		}]]);
+		/**
+		* @license lucide-react v1.39.0 - ISC
+		*
+		* This source code is licensed under the ISC license.
+		* See the LICENSE file in the root directory of this source tree.
+		*/
+		const Box = createLucideIcon("box", [
+			["path", {
+				d: "M21 8a2 2 0 0 0-1-1.73l-7-4a2 2 0 0 0-2 0l-7 4A2 2 0 0 0 3 8v8a2 2 0 0 0 1 1.73l7 4a2 2 0 0 0 2 0l7-4A2 2 0 0 0 21 16Z",
+				key: "hh9hay"
+			}],
+			["path", {
+				d: "m3.3 7 8.7 5 8.7-5",
+				key: "g66t2b"
+			}],
+			["path", {
+				d: "M12 22V12",
+				key: "d0xqtd"
+			}]
+		]);
+		/**
+		* @license lucide-react v1.39.0 - ISC
+		*
+		* This source code is licensed under the ISC license.
+		* See the LICENSE file in the root directory of this source tree.
+		*/
+		const CircleQuestionMark = createLucideIcon("circle-question-mark", [
+			["circle", {
+				cx: "12",
+				cy: "12",
+				r: "10",
+				key: "1mglay"
+			}],
+			["path", {
+				d: "M9.09 9a3 3 0 0 1 5.83 1c0 2-3 3-3 3",
+				key: "1u773s"
+			}],
+			["path", {
+				d: "M12 17h.01",
+				key: "p32p05"
+			}]
+		]);
+		/**
+		* @license lucide-react v1.39.0 - ISC
+		*
+		* This source code is licensed under the ISC license.
+		* See the LICENSE file in the root directory of this source tree.
+		*/
+		const Clock = createLucideIcon("clock", [["circle", {
+			cx: "12",
+			cy: "12",
+			r: "10",
+			key: "1mglay"
+		}], ["path", {
+			d: "M12 6v6l4 2",
+			key: "mmk7yg"
+		}]]);
+		/**
+		* @license lucide-react v1.39.0 - ISC
+		*
+		* This source code is licensed under the ISC license.
+		* See the LICENSE file in the root directory of this source tree.
+		*/
+		const Cpu = createLucideIcon("cpu", [
+			["path", {
+				d: "M12 20v2",
+				key: "1lh1kg"
+			}],
+			["path", {
+				d: "M12 2v2",
+				key: "tus03m"
+			}],
+			["path", {
+				d: "M17 20v2",
+				key: "1rnc9c"
+			}],
+			["path", {
+				d: "M17 2v2",
+				key: "11trls"
+			}],
+			["path", {
+				d: "M2 12h2",
+				key: "1t8f8n"
+			}],
+			["path", {
+				d: "M2 17h2",
+				key: "7oei6x"
+			}],
+			["path", {
+				d: "M2 7h2",
+				key: "asdhe0"
+			}],
+			["path", {
+				d: "M20 12h2",
+				key: "1q8mjw"
+			}],
+			["path", {
+				d: "M20 17h2",
+				key: "1fpfkl"
+			}],
+			["path", {
+				d: "M20 7h2",
+				key: "1o8tra"
+			}],
+			["path", {
+				d: "M7 20v2",
+				key: "4gnj0m"
+			}],
+			["path", {
+				d: "M7 2v2",
+				key: "1i4yhu"
+			}],
+			["rect", {
+				x: "4",
+				y: "4",
+				width: "16",
+				height: "16",
+				rx: "2",
+				key: "1vbyd7"
+			}],
+			["rect", {
+				x: "8",
+				y: "8",
+				width: "8",
+				height: "8",
+				rx: "1",
+				key: "z9xiuo"
+			}]
+		]);
+		/**
+		* @license lucide-react v1.39.0 - ISC
+		*
+		* This source code is licensed under the ISC license.
+		* See the LICENSE file in the root directory of this source tree.
+		*/
 		const EyeOff = createLucideIcon("eye-off", [
 			["path", {
 				d: "M10.733 5.076a10.744 10.744 0 0 1 11.205 6.575 1 1 0 0 1 0 .696 10.747 10.747 0 0 1-1.444 2.49",
@@ -522,6 +670,19 @@ window.__ModuleLoader__.load({
 		* This source code is licensed under the ISC license.
 		* See the LICENSE file in the root directory of this source tree.
 		*/
+		const Link = createLucideIcon("link", [["path", {
+			d: "M10 13a5 5 0 0 0 7.54.54l3-3a5 5 0 0 0-7.07-7.07l-1.72 1.71",
+			key: "1cjeqo"
+		}], ["path", {
+			d: "M14 11a5 5 0 0 0-7.54-.54l-3 3a5 5 0 0 0 7.07 7.07l1.71-1.71",
+			key: "19qd67"
+		}]]);
+		/**
+		* @license lucide-react v1.39.0 - ISC
+		*
+		* This source code is licensed under the ISC license.
+		* See the LICENSE file in the root directory of this source tree.
+		*/
 		const MessageCircle = createLucideIcon("message-circle", [["path", {
 			d: "M2.992 16.342a2 2 0 0 1 .094 1.167l-1.065 3.29a1 1 0 0 0 1.236 1.168l3.413-.998a2 2 0 0 1 1.099.092 10 10 0 1 0-4.777-4.719",
 			key: "1sd12s"
@@ -532,6 +693,33 @@ window.__ModuleLoader__.load({
 		* This source code is licensed under the ISC license.
 		* See the LICENSE file in the root directory of this source tree.
 		*/
+		const MessageSquare = createLucideIcon("message-square", [["path", {
+			d: "M22 17a2 2 0 0 1-2 2H6.828a2 2 0 0 0-1.414.586l-2.202 2.202A.71.71 0 0 1 2 21.286V5a2 2 0 0 1 2-2h16a2 2 0 0 1 2 2z",
+			key: "18887p"
+		}]]);
+		/**
+		* @license lucide-react v1.39.0 - ISC
+		*
+		* This source code is licensed under the ISC license.
+		* See the LICENSE file in the root directory of this source tree.
+		*/
+		const PanelRight = createLucideIcon("panel-right", [["rect", {
+			width: "18",
+			height: "18",
+			x: "3",
+			y: "3",
+			rx: "2",
+			key: "afitv7"
+		}], ["path", {
+			d: "M15 3v18",
+			key: "14nvp0"
+		}]]);
+		/**
+		* @license lucide-react v1.39.0 - ISC
+		*
+		* This source code is licensed under the ISC license.
+		* See the LICENSE file in the root directory of this source tree.
+		*/
 		const Pin = createLucideIcon("pin", [["path", {
 			d: "M12 17v5",
 			key: "bb1du9"
@@ -545,6 +733,106 @@ window.__ModuleLoader__.load({
 		* This source code is licensed under the ISC license.
 		* See the LICENSE file in the root directory of this source tree.
 		*/
+		const Search = createLucideIcon("search", [["path", {
+			d: "m21 21-4.34-4.34",
+			key: "14j7rj"
+		}], ["circle", {
+			cx: "11",
+			cy: "11",
+			r: "8",
+			key: "4ej97u"
+		}]]);
+		/**
+		* @license lucide-react v1.39.0 - ISC
+		*
+		* This source code is licensed under the ISC license.
+		* See the LICENSE file in the root directory of this source tree.
+		*/
+		const Settings = createLucideIcon("settings", [["path", {
+			d: "M9.671 4.136a2.34 2.34 0 0 1 4.659 0 2.34 2.34 0 0 0 3.319 1.915 2.34 2.34 0 0 1 2.33 4.033 2.34 2.34 0 0 0 0 3.831 2.34 2.34 0 0 1-2.33 4.033 2.34 2.34 0 0 0-3.319 1.915 2.34 2.34 0 0 1-4.659 0 2.34 2.34 0 0 0-3.32-1.915 2.34 2.34 0 0 1-2.33-4.033 2.34 2.34 0 0 0 0-3.831A2.34 2.34 0 0 1 6.35 6.051a2.34 2.34 0 0 0 3.319-1.915",
+			key: "1i5ecw"
+		}], ["circle", {
+			cx: "12",
+			cy: "12",
+			r: "3",
+			key: "1v7zrd"
+		}]]);
+		/**
+		* @license lucide-react v1.39.0 - ISC
+		*
+		* This source code is licensed under the ISC license.
+		* See the LICENSE file in the root directory of this source tree.
+		*/
+		const SlidersHorizontal = createLucideIcon("sliders-horizontal", [
+			["path", {
+				d: "M10 5H3",
+				key: "1qgfaw"
+			}],
+			["path", {
+				d: "M12 19H3",
+				key: "yhmn1j"
+			}],
+			["path", {
+				d: "M14 3v4",
+				key: "1sua03"
+			}],
+			["path", {
+				d: "M16 17v4",
+				key: "1q0r14"
+			}],
+			["path", {
+				d: "M21 12h-9",
+				key: "1o4lsq"
+			}],
+			["path", {
+				d: "M21 19h-5",
+				key: "1rlt1p"
+			}],
+			["path", {
+				d: "M21 5h-7",
+				key: "1oszz2"
+			}],
+			["path", {
+				d: "M8 10v4",
+				key: "tgpxqk"
+			}],
+			["path", {
+				d: "M8 12H3",
+				key: "a7s4jb"
+			}]
+		]);
+		/**
+		* @license lucide-react v1.39.0 - ISC
+		*
+		* This source code is licensed under the ISC license.
+		* See the LICENSE file in the root directory of this source tree.
+		*/
+		const Sparkles = createLucideIcon("sparkles", [
+			["path", {
+				d: "M11.017 2.814a1 1 0 0 1 1.966 0l1.051 5.558a2 2 0 0 0 1.594 1.594l5.558 1.051a1 1 0 0 1 0 1.966l-5.558 1.051a2 2 0 0 0-1.594 1.594l-1.051 5.558a1 1 0 0 1-1.966 0l-1.051-5.558a2 2 0 0 0-1.594-1.594l-5.558-1.051a1 1 0 0 1 0-1.966l5.558-1.051a2 2 0 0 0 1.594-1.594z",
+				key: "1s2grr"
+			}],
+			["path", {
+				d: "M20 2v4",
+				key: "1rf3ol"
+			}],
+			["path", {
+				d: "M22 4h-4",
+				key: "gwowj6"
+			}],
+			["circle", {
+				cx: "4",
+				cy: "20",
+				r: "2",
+				key: "6kqj1y"
+			}]
+		]);
+		/**
+		* @license lucide-react v1.39.0 - ISC
+		*
+		* This source code is licensed under the ISC license.
+		* See the LICENSE file in the root directory of this source tree.
+		*/
 		const SquarePen = createLucideIcon("square-pen", [["path", {
 			d: "M12 3H5a2 2 0 0 0-2 2v14a2 2 0 0 0 2 2h14a2 2 0 0 0 2-2v-7",
 			key: "1m0v6g"
@@ -552,6 +840,41 @@ window.__ModuleLoader__.load({
 			d: "M18.375 2.625a1 1 0 0 1 3 3l-9.013 9.014a2 2 0 0 1-.853.505l-2.873.84a.5.5 0 0 1-.62-.62l.84-2.873a2 2 0 0 1 .506-.852z",
 			key: "ohrbg2"
 		}]]);
+		/**
+		* @license lucide-react v1.39.0 - ISC
+		*
+		* This source code is licensed under the ISC license.
+		* See the LICENSE file in the root directory of this source tree.
+		*/
+		const Store = createLucideIcon("store", [
+			["path", {
+				d: "M15 21v-5a1 1 0 0 0-1-1h-4a1 1 0 0 0-1 1v5",
+				key: "slp6dd"
+			}],
+			["path", {
+				d: "M17.774 10.31a1.12 1.12 0 0 0-1.549 0 2.5 2.5 0 0 1-3.451 0 1.12 1.12 0 0 0-1.548 0 2.5 2.5 0 0 1-3.452 0 1.12 1.12 0 0 0-1.549 0 2.5 2.5 0 0 1-3.77-3.248l2.889-4.184A2 2 0 0 1 7 2h10a2 2 0 0 1 1.653.873l2.895 4.192a2.5 2.5 0 0 1-3.774 3.244",
+				key: "o0xfot"
+			}],
+			["path", {
+				d: "M4 10.95V19a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2v-8.05",
+				key: "wn3emo"
+			}]
+		]);
+		/**
+		* @license lucide-react v1.39.0 - ISC
+		*
+		* This source code is licensed under the ISC license.
+		* See the LICENSE file in the root directory of this source tree.
+		*/
+		const User = createLucideIcon("user", [["path", {
+			d: "M19 21v-2a4 4 0 0 0-4-4H9a4 4 0 0 0-4 4v2",
+			key: "975kel"
+		}], ["circle", {
+			cx: "12",
+			cy: "7",
+			r: "4",
+			key: "17ys0d"
+		}]]);
 		//#endregion
 		//#region src/client/session-tree.tsx
 		function PinIcon() {
@@ -5438,7 +5761,6 @@ body[data-we-sidebar-glass] .dcu-expanded-shell,body[data-we-sidebar-glass] .dcu
 .dcu-footer-actions [data-testid="billing-rail-button"] svg{flex:none;width:24px;height:24px;stroke-width:1.5px}
 .dcu-settings-seat [data-slot="settings.trigger"]{color:var(--dcu-sidebar-navigation)}
 .dcu-settings-seat [data-slot="settings.trigger"]>svg{color:var(--dcu-sidebar-icon)}
-.dcu-root:not(.dcu-compact) .dcu-settings-seat [data-slot="settings.trigger"]>span{margin-left:4px}
 @media (prefers-reduced-motion:reduce){.dcu-footer-actions :is([data-testid="billing-trigger"],[data-testid="billing-rail-button"]){transition:none}}
 /* 宿主列负责缩放，宽态内容保持展开宽度，避免中文竖排与工作区逐帧重排。 */
 .dcu-expanded-shell,.dcu-root:not(.dcu-compact)>.dcu-foot{width:var(--dcu-sidebar-expanded-width,240px);flex-shrink:0}
@@ -5457,7 +5779,6 @@ body[data-we-sidebar-glass] .dcu-expanded-shell,body[data-we-sidebar-glass] .dcu
 @media (prefers-reduced-motion:reduce){[data-dcu-codex-sidebar-initialized],[data-dcu-codex-sidebar-initialized] [data-side="sidebar"],#root [data-dcu-codex-sidebar-initialized]:not([data-dragging]){transition:none}.dcu-root.dcu-collapsing .dcu-compact-shell{animation:none}}
 .dcu-native-workspaces{flex-direction:column}.dcu-native-workspaces>[data-mcp-connector-top-mount=true]{flex:none}.dcu-root .mcpConnectorLauncher,.dcu-root [data-mcp-connector-top-mount=true]{display:none!important}
 .dcu-dependency-notice{margin:0 10px 8px;border:1px solid var(--dcu-sidebar-border);border-radius:8px;padding:8px;color:var(--dcu-sidebar-secondary);font-size:12px;line-height:18px}
-[role="dialog"][aria-labelledby]{width:min(1000px,calc(100vw - 48px));max-width:calc(100vw - 48px);height:min(800px,calc(100vh - 48px))}
 .dcu-search-scrim{position:fixed;z-index:10020;inset:0;display:flex;justify-content:center;align-items:flex-start;padding:72px 20px;background:color-mix(in srgb,#000 48%,transparent);animation:dcu-search-scrim-in 140ms ease-out}.dcu-search-dialog{width:min(560px,100%);max-height:min(640px,calc(100vh - 120px));overflow:auto;border:1px solid var(--dcu-sidebar-border);border-radius:16px;padding:10px;background:var(--dsw-specific-menu);box-shadow:var(--dsw-shadow-lv4);animation:dcu-search-dialog-in 180ms cubic-bezier(.16,1,.3,1)}@keyframes dcu-search-scrim-in{from{opacity:0}to{opacity:1}}@keyframes dcu-search-dialog-in{from{opacity:0;transform:translateY(-6px) scale(.985)}to{opacity:1}}.dcu-search-input{margin-bottom:8px}.dcu-search-section{padding:6px 0}.dcu-search-title{padding:0 8px 4px;color:var(--dcu-sidebar-tertiary);font-size:12px;font-weight:600}.dcu-search-row{display:grid;grid-template-columns:minmax(0,1fr) auto;align-items:center;gap:12px;width:100%;min-height:34px;border:0;border-radius:8px;padding:6px 8px;background:transparent;color:var(--dcu-sidebar-primary);font:inherit;text-align:left;cursor:pointer}.dcu-search-row:hover,.dcu-search-row[data-active=true]{background:var(--dcu-sidebar-hover)}.dcu-search-main{min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.dcu-search-detail{max-width:160px;overflow:hidden;color:var(--dcu-sidebar-tertiary);font-size:12px;text-overflow:ellipsis;white-space:nowrap}.dcu-search-empty{padding:18px 8px;color:var(--dcu-sidebar-tertiary);font-size:13px}@media (prefers-reduced-motion:reduce){.dcu-expanded-shell,.dcu-root.dcu-compact .dcu-compact-shell,.dcu-foot,.dcu-search-scrim,.dcu-search-dialog,.dcu-extension-panel,.dcu-extension-leading svg{animation:none;transition:none}}
 [data-conversation-scroll]{--dsh-composer-card-max-width:calc(var(--dsh-chat-content-width) + 32px);--dsh-composer-side-clearance:24px}[data-conversation-scroll] [data-composer-card]{min-height:96px;padding-top:10px;border-radius:16px;box-shadow:var(--dsw-shadow-lv3);transition:border-color 180ms ease,box-shadow 180ms ease}[data-conversation-scroll] [data-composer-card]:focus-within{border-color:var(--dsw-alias-button-info-fill);box-shadow:0 0 0 2px var(--dsw-static-deepseek-50),var(--dsw-shadow-lv3)}[data-conversation-scroll] [data-input-mirror]{min-height:44px}@media (prefers-reduced-motion:reduce){[data-conversation-scroll] [data-composer-card]{transition:none}}
 html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:has([data-dcu-official-turn-navigator]) .dcu-turn-navigator{display:none}
@@ -5545,7 +5866,7 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 				t
 			]);
 			const openSettings = (0, react.useCallback)(() => {
-				settingsSeat.current?.querySelector("[aria-haspopup=\"dialog\"]")?.click();
+				openSettingsRoot(settingsSeat.current);
 			}, [settingsSeat]);
 			const entries = (0, react.useMemo)(() => {
 				const archived = new Set(workspaces.archivedSessionIds);
@@ -6856,6 +7177,23 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 		/** 本插件独占的界面文案命名空间。 */
 		const NS = "michengai.codexUi";
 		const zh = {
+			"settings.title": "设置",
+			"settings.back": "返回应用",
+			"settings.openDocument": "打开配置文件",
+			"settings.openDocumentError": "无法打开配置文件",
+			"settings.search": "搜索设置…",
+			"settings.personal": "个人",
+			"settings.integrations": "集成",
+			"settings.records": "记录与应用",
+			"settings.general": "常规",
+			"settings.permissions": "权限",
+			"settings.editor": "编辑器",
+			"settings.noResults": "没有匹配的设置分类",
+			"settings.filterHint": "仅筛选导航，选择分类后切换当前页面。",
+			"settings.disconnected": "连接异常",
+			"settings.reconnect": "立即重连",
+			"settings.connecting": "连接中",
+			"settings.recovered": "连接成功",
 			"input.historyHint": "↑↓ 翻历史",
 			"sidebar.label": "DSH 导航",
 			"sidebar.expand": "展开侧边栏",
@@ -7068,6 +7406,23 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 			"meta.locale": "zh-CN"
 		};
 		const en = {
+			"settings.title": "Settings",
+			"settings.back": "Back to app",
+			"settings.openDocument": "Open configuration file",
+			"settings.openDocumentError": "Could not open configuration file",
+			"settings.search": "Search settings…",
+			"settings.personal": "Personal",
+			"settings.integrations": "Integrations",
+			"settings.records": "Records and app",
+			"settings.general": "General",
+			"settings.permissions": "Permissions",
+			"settings.editor": "Editor",
+			"settings.noResults": "No matching settings categories",
+			"settings.filterHint": "Navigation is filtered. Select a category to switch pages.",
+			"settings.disconnected": "Disconnected",
+			"settings.reconnect": "Reconnect now",
+			"settings.connecting": "Connecting",
+			"settings.recovered": "Connected",
 			"input.historyHint": "↑↓ History",
 			"sidebar.label": "DSH navigation",
 			"sidebar.expand": "Expand sidebar",
@@ -7414,6 +7769,600 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 			};
 		}
 		//#endregion
+		//#region src/client/settings-page-model.ts
+		function settingsGroup(id) {
+			if (/archive|about/.test(id)) return "records";
+			if (/^(general|appearance|theme|language|shortcuts|voice|account)$/.test(id)) return "personal";
+			return "integrations";
+		}
+		function filterSettingsRows(rows, query) {
+			const needle = query.trim().toLocaleLowerCase();
+			return needle === "" ? rows : rows.filter((row) => `${row.label} ${row.id}`.toLocaleLowerCase().includes(needle));
+		}
+		function generalItemGroup(id) {
+			if (/permission|approval|sandbox/.test(id)) return "permissions";
+			if (/composer|font|conversation|chat|enter/.test(id)) return "editor";
+			return "general";
+		}
+		//#endregion
+		//#region src/client/settings-page-styles.ts
+		/** Codex 设置页的局部 tokens 与布局，不覆盖宿主其他弹窗。 */
+		const settingsPageStyles = `
+.dcu-settings-page{--sp-bg:#fff;--sp-nav:#f5f5f5;--sp-card:#fafafa;--sp-border:#e5e5e5;--sp-text:#303030;--sp-muted:#737373;--sp-hover:#e9e9e9;--sp-active:#e4e4e4;position:fixed;inset:0;z-index:1000;display:grid;grid-template-columns:240px minmax(0,1fr);background:var(--sp-bg);color:var(--sp-text);font:14px/1.5 var(--dcu-font,system-ui);text-align:left;isolation:isolate}
+body[data-ds-dark-theme] .dcu-settings-page{--sp-bg:#181818;--sp-nav:#202322;--sp-card:#232323;--sp-border:#333;--sp-text:#dedede;--sp-muted:#a1a1a1;--sp-hover:#292c2b;--sp-active:#303332;color-scheme:dark}
+.dcu-settings-page *{box-sizing:border-box}
+.dcu-settings-page button,.dcu-settings-page input{font:inherit}
+.dcu-settings-page button{cursor:pointer}
+.dcu-settings-page :focus-visible{outline:2px solid #459cff;outline-offset:3px}
+.dcu-settings-nav{display:flex;flex-direction:column;min-height:0;padding:18px 8px;background:var(--sp-nav);border-right:1px solid var(--sp-border);overflow-y:auto}
+.dcu-settings-back{display:flex;align-items:center;gap:8px;width:100%;padding:8px;border:0;border-radius:7px;background:transparent;color:var(--sp-text);text-align:left}
+.dcu-settings-back:hover,.dcu-settings-link:hover{background:var(--sp-hover)}
+.dcu-settings-search{display:flex;align-items:center;gap:8px;padding:5px 9px;margin:12px 0 18px;background:var(--sp-hover);border:1px solid transparent;border-radius:8px;color:var(--sp-muted)}
+.dcu-settings-search:focus-within{border-color:#459cff}
+.dcu-settings-search input{width:100%;min-width:0;border:0;background:transparent;color:var(--sp-text);outline:none;font-size:13px}
+.dcu-settings-search input[type=search]{appearance:none;padding:0;border-radius:0;box-shadow:none;line-height:20px}
+.dcu-settings-search input:focus,.dcu-settings-search input:focus-visible{outline:none;box-shadow:none}
+.dcu-settings-search input::placeholder{color:var(--sp-muted)}
+.dcu-settings-group{margin:0 0 22px}
+.dcu-settings-group-label{margin:0 8px 6px;color:var(--sp-muted);font-size:12px;font-weight:500}
+.dcu-settings-link{display:flex;align-items:center;gap:9px;min-height:32px;width:100%;padding:5px 9px;border:0;border-radius:8px;background:transparent;color:var(--sp-text);text-align:left;font-size:14px!important}
+.dcu-settings-link[aria-current=page]{background:var(--sp-active)}
+.dcu-settings-link svg{flex:none;opacity:.9}
+.dcu-settings-link span{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.dcu-settings-empty{padding:8px;color:var(--sp-muted);font-size:13px}
+.dcu-settings-main{min-width:0;min-height:0;overflow:auto;overscroll-behavior:contain;background:var(--sp-bg);scrollbar-width:thin;scrollbar-color:var(--sp-border) transparent}
+.dcu-settings-inner{width:min(100%,864px);margin:0 auto;padding:32px 48px}
+.dcu-settings-heading{display:flex;align-items:center;justify-content:space-between;gap:24px;margin-bottom:24px}
+.dcu-settings-heading h1{margin:0;font-size:24px;line-height:32px;font-weight:600;letter-spacing:-.4px}
+.dcu-settings-heading[data-own-title=false]{justify-content:flex-end;margin-bottom:16px}
+.dcu-settings-heading:not(:has(h1,button,a,[role=button])){display:none}
+.dcu-settings-actions{display:flex;gap:8px;flex-wrap:wrap;justify-content:flex-end;color:var(--sp-muted)}
+.dcu-settings-actions button{font-size:12px}
+.dcu-settings-general-group{margin-bottom:44px}
+.dcu-settings-general-group h2{margin:0 0 16px;font-size:14px;font-weight:600;color:var(--sp-text)}
+.dcu-settings-card{border:1px solid var(--sp-border);border-radius:16px;background:var(--sp-card);padding:0 16px;overflow:hidden}
+.dcu-settings-row+.dcu-settings-row{border-top:1px solid var(--sp-border)}
+.dcu-settings-row>[data-slot]{display:contents}
+.dcu-settings-row>[data-slot]>*{padding:12px 0!important;border-bottom:0!important;margin:0!important;min-width:0}
+.dcu-settings-row button{font-size:13px;border-radius:8px}
+.dcu-settings-row input{max-width:100%}
+.dcu-settings-trigger{appearance:none;box-sizing:border-box;display:flex;align-items:center;border:0;border-radius:8px;background:transparent;color:var(--dcu-sidebar-navigation,inherit);height:36px;min-height:36px;padding:0 4px;width:100%;font:400 14px/20px var(--dcu-font,system-ui);text-align:left;cursor:pointer;transition:background-color 160ms ease,color 160ms ease,transform 120ms ease}
+.dcu-settings-trigger-content{display:grid;grid-template-columns:20px minmax(0,1fr);column-gap:8px;align-items:center;width:100%;min-width:0}
+.dcu-settings-trigger-content svg{display:block;width:16px;height:16px;color:var(--dcu-sidebar-icon,currentColor);transition:transform 220ms cubic-bezier(.16,1,.3,1)}
+.dcu-settings-trigger:hover{background:var(--dcu-sidebar-hover,rgba(127,127,127,.12));color:var(--dcu-sidebar-primary,inherit)}
+.dcu-settings-trigger:hover svg{transform:rotate(18deg)}
+.dcu-settings-trigger:active{transform:scale(.98)}
+.dcu-settings-trigger:focus-visible{outline:2px solid #459cff;outline-offset:2px;background:var(--dcu-sidebar-hover,rgba(127,127,127,.12))}
+.dcu-settings-trigger[data-wide=false]{justify-content:center;width:36px;padding:0!important}
+.dcu-settings-trigger[data-wide=false] .dcu-settings-trigger-content{grid-template-columns:16px;justify-content:center}
+.dcu-settings-page{animation:dcu-settings-enter 180ms ease-out}
+.dcu-settings-nav{animation:dcu-settings-nav-enter 220ms cubic-bezier(.16,1,.3,1)}
+.dcu-settings-inner{animation:dcu-settings-content-enter 240ms cubic-bezier(.16,1,.3,1)}
+.dcu-settings-back,.dcu-settings-link{transition:background-color 160ms ease,color 160ms ease}
+@keyframes dcu-settings-enter{from{opacity:0}to{opacity:1}}
+@keyframes dcu-settings-nav-enter{from{opacity:0;transform:translateX(-6px)}to{opacity:1;transform:none}}
+@keyframes dcu-settings-content-enter{from{opacity:0;transform:translateY(8px)}to{opacity:1;transform:none}}
+@media(prefers-reduced-motion:reduce){.dcu-settings-trigger,.dcu-settings-trigger-content svg,.dcu-settings-back,.dcu-settings-link{transition:none}.dcu-settings-trigger:hover svg,.dcu-settings-trigger:active{transform:none}.dcu-settings-page,.dcu-settings-nav,.dcu-settings-inner{animation:none}}
+.dcu-settings-page [data-slot="settings.section"]{min-width:0}
+.dcu-settings-inner:has(.dcu-connector-frame){height:100%;display:flex;flex-direction:column}
+.dcu-settings-inner:has(.dcu-connector-frame)>.dcu-settings-heading{flex:none}
+.dcu-settings-page .dcu-connectors:has(>.dcu-connector-frame){display:flex;flex-direction:column;flex:1 1 0;min-height:0}
+.dcu-settings-page .dcu-connector-frame{flex:1 1 0;min-height:0;height:100%}
+
+@media(max-width:900px){.dcu-settings-page{grid-template-columns:200px minmax(0,1fr)}.dcu-settings-inner{padding:24px 28px}.dcu-settings-heading{align-items:flex-start;flex-direction:column;gap:12px}}
+@media(max-width:600px){.dcu-settings-page{grid-template-columns:1fr;grid-template-rows:auto minmax(0,1fr)}.dcu-settings-nav{padding:8px 12px;max-height:220px;border-right:0;border-bottom:1px solid var(--sp-border)}.dcu-settings-search{margin:6px 0}.dcu-settings-groups{display:flex;gap:8px;overflow-x:auto;flex:none}.dcu-settings-group{display:flex;gap:4px;margin:0;flex:none}.dcu-settings-group-label{display:none}.dcu-settings-link{width:auto;min-height:40px;flex:none}.dcu-settings-inner{padding:24px 16px}.dcu-settings-heading{margin-bottom:28px}.dcu-settings-heading h1{font-size:22px}.dcu-settings-card{padding:0 12px}.dcu-settings-row>[data-slot]>*{flex-wrap:wrap;gap:12px!important}.dcu-settings-general-group{margin-bottom:32px}}
+`;
+		//#endregion
+		//#region src/client/settings-focus.ts
+		/** 设置页与宿主浮层共享的可交互判断，忽略隐藏及已被隔离的对话框。 */
+		function settingsElementAvailable(element) {
+			for (let node = element; node !== null; node = node.parentElement) {
+				const style = getComputedStyle(node);
+				if (node.inert || node.hidden || node.getAttribute("aria-hidden") === "true" || style.display === "none" || style.visibility === "hidden" || style.visibility === "collapse") return false;
+			}
+			return true;
+		}
+		function settingsOverlays(selector = "[role=\"dialog\"],[role=\"alertdialog\"],[role=\"menu\"],[role=\"listbox\"]") {
+			return [...document.querySelectorAll(selector)].filter(settingsElementAvailable);
+		}
+		//#endregion
+		//#region src/client/CodexSettingsPage.tsx
+		const groupLabels = {
+			personal: "settings.personal",
+			integrations: "settings.integrations",
+			records: "settings.records",
+			permissions: "settings.permissions",
+			general: "settings.general",
+			editor: "settings.editor"
+		};
+		function sectionIcon(id) {
+			if (id === "market" || id === "plugin-marketplace") return Store;
+			if (id === "better-sidebar" || id === "sidebar-cards") return PanelRight;
+			if (/model/.test(id)) return Cpu;
+			if (/archive/.test(id)) return Archive;
+			if (/about/.test(id)) return CircleQuestionMark;
+			if (/expert|agency/.test(id)) return User;
+			if (/skill/.test(id)) return Sparkles;
+			if (/connector|mcp/.test(id)) return Link;
+			if (/schedule|automation/.test(id)) return Clock;
+			if (/im|assistant/.test(id)) return MessageSquare;
+			if (id === "general") return Settings;
+			if (/plugin/.test(id)) return SlidersHorizontal;
+			return Box;
+		}
+		/** 独立设置视图复用原始 section/close 合约，退出时保留底层会话与输入状态。 */
+		function CodexSettingsPage({ wide, sections, onboarding, connectionState, reconnect, useSessions, renderSlot, t }) {
+			const rows = (0, react.useSyncExternalStore)(sections.subscribe, sections.getSnapshot);
+			const steps = (0, react.useSyncExternalStore)(onboarding.subscribe, onboarding.getSnapshot);
+			const connection = (0, react.useSyncExternalStore)(connectionState.subscribe, connectionState.getSnapshot);
+			const onboardingActive = useSessions((state) => state.phase === "ready" && (state.current === void 0 || state.byId[state.current]?.blank === true));
+			const [completed, setCompleted] = (0, react.useState)(() => /* @__PURE__ */ new Set());
+			const [open, setOpen] = (0, react.useState)(false);
+			const [activeId, setActiveId] = (0, react.useState)("general");
+			const [query, setQuery] = (0, react.useState)("");
+			const [recovered, setRecovered] = (0, react.useState)(false);
+			const previousConnection = (0, react.useRef)(connection);
+			const trigger = (0, react.useRef)(null);
+			const page = (0, react.useRef)(null);
+			const back = (0, react.useRef)(null);
+			const onboardingRoot = (0, react.useRef)(null);
+			const main = (0, react.useRef)(null);
+			const wasOpen = (0, react.useRef)(false);
+			const exitAnimation = (0, react.useRef)(null);
+			const active = rows.find((row) => row.id === activeId) ?? rows[0];
+			const step = onboardingActive ? steps.find((item) => !completed.has(item.id)) : void 0;
+			const close = (0, react.useCallback)(() => {
+				if (exitAnimation.current !== null) return;
+				const finish = () => {
+					exitAnimation.current = null;
+					setOpen(false);
+					setQuery("");
+				};
+				const element = page.current;
+				if (element?.animate === void 0 || window.matchMedia?.("(prefers-reduced-motion: reduce)").matches) {
+					finish();
+					return;
+				}
+				const animation = element.animate([{ opacity: getComputedStyle(element).opacity }, { opacity: 0 }], {
+					duration: 140,
+					easing: "ease-out",
+					fill: "forwards"
+				});
+				exitAnimation.current = animation;
+				animation.onfinish = finish;
+			}, []);
+			const openSection = (0, react.useCallback)((id) => {
+				exitAnimation.current?.cancel();
+				exitAnimation.current = null;
+				setActiveId(id);
+				setOpen(true);
+			}, []);
+			(0, react.useEffect)(() => () => {
+				exitAnimation.current?.cancel();
+			}, []);
+			(0, react.useEffect)(() => {
+				if (!onboardingActive) setCompleted(/* @__PURE__ */ new Set());
+			}, [onboardingActive]);
+			(0, react.useEffect)(() => {
+				const previous = previousConnection.current;
+				previousConnection.current = connection;
+				setRecovered(connection === "connected" && (previous === "disconnected" || previous === "connecting"));
+				if (connection !== "connected") return;
+				const timer = window.setTimeout(() => {
+					setRecovered(false);
+				}, 3e3);
+				return () => {
+					window.clearTimeout(timer);
+				};
+			}, [connection]);
+			(0, react.useEffect)(() => {
+				if (wasOpen.current && !open) trigger.current?.focus();
+				wasOpen.current = open;
+				if (!open || page.current === null) return;
+				if (settingsElementAvailable(page.current) && settingsOverlays().length === 0) back.current?.focus();
+				const hidden = /* @__PURE__ */ new Map();
+				const guideModals = step === void 0 ? [] : settingsOverlays("[role=\"dialog\"][aria-modal=\"true\"],[role=\"alertdialog\"][aria-modal=\"true\"]");
+				const isolate = (element) => {
+					if (element === onboardingRoot.current || guideModals.includes(element)) return;
+					if (guideModals.some((modal) => element.contains(modal))) {
+						for (const child of element.children) if (child instanceof HTMLElement && !/^(STYLE|SCRIPT|LINK)$/.test(child.tagName)) isolate(child);
+						return;
+					}
+					hidden.set(element, element.inert);
+					element.inert = true;
+				};
+				let branch = page.current;
+				while (branch.parentElement !== null) {
+					for (const sibling of branch.parentElement.children) {
+						if (!(sibling instanceof HTMLElement) || sibling === branch || /^(STYLE|SCRIPT|LINK)$/.test(sibling.tagName)) continue;
+						isolate(sibling);
+					}
+					branch = branch.parentElement;
+					if (branch === document.body) break;
+				}
+				const onKeyDown = (event) => {
+					if (event.key === "Escape" && !event.defaultPrevented && settingsOverlays().length === 0) {
+						event.preventDefault();
+						close();
+					}
+				};
+				const keepFocus = (event) => {
+					const target = event.target;
+					if (!(target instanceof Node) || page.current === null || !settingsElementAvailable(page.current)) return;
+					if (page.current.contains(target) || onboardingRoot.current?.contains(target) || settingsOverlays().some((overlay) => overlay.contains(target))) return;
+					back.current?.focus();
+				};
+				const wrapFocus = (event) => {
+					if (event.key !== "Tab" || event.defaultPrevented || page.current === null || !settingsElementAvailable(page.current) || settingsOverlays().length > 0) return;
+					const items = [page.current, onboardingRoot.current].filter((root) => root !== null).flatMap((root) => [...root.querySelectorAll("button,input,select,textarea,a[href],[tabindex]")]).filter((element) => element.tabIndex >= 0 && !element.matches(":disabled") && settingsElementAvailable(element));
+					const next = event.shiftKey ? items.at(-1) : items[0];
+					if (document.activeElement === (event.shiftKey ? items[0] : items.at(-1))) {
+						event.preventDefault();
+						next?.focus();
+					}
+				};
+				document.addEventListener("keydown", onKeyDown, true);
+				document.addEventListener("keydown", wrapFocus);
+				document.addEventListener("focusin", keepFocus);
+				return () => {
+					document.removeEventListener("keydown", onKeyDown, true);
+					document.removeEventListener("keydown", wrapFocus);
+					document.removeEventListener("focusin", keepFocus);
+					for (const [element, inert] of hidden) element.inert = inert;
+				};
+			}, [
+				open,
+				close,
+				step?.id
+			]);
+			(0, react.useEffect)(() => {
+				if (main.current !== null) main.current.scrollTop = 0;
+			}, [active?.id]);
+			const visible = filterSettingsRows(rows, query);
+			const connectionIndicator = connection === "disconnected" ? "disconnected" : connection === "connecting" ? "connecting" : recovered ? "recovered" : void 0;
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("style", { children: settingsPageStyles }),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+					ref: trigger,
+					type: "button",
+					className: "dcu-settings-trigger",
+					"data-dcu-settings-trigger": true,
+					"data-wide": wide,
+					"aria-expanded": open,
+					"aria-label": t("settings.title"),
+					onClick: () => {
+						setOpen(true);
+					},
+					children: renderSlot("settings.trigger", { wide })
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.ConnectionIndicator, {
+					state: wide ? connectionIndicator : void 0,
+					disconnectedLabel: t("settings.disconnected"),
+					reconnectLabel: t("settings.reconnect"),
+					connectingLabel: t("settings.connecting"),
+					recoveredLabel: t("settings.recovered"),
+					reconnectActionLabel: t("settings.reconnect"),
+					restartActionLabel: t("settings.reconnect"),
+					onReconnect: reconnect
+				}),
+				open && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+					ref: page,
+					className: "dcu-settings-page",
+					"data-dcu-settings-page": true,
+					role: "region",
+					"aria-label": t("settings.title"),
+					children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("nav", {
+						className: "dcu-settings-nav",
+						"aria-label": t("settings.title"),
+						children: [
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+								ref: back,
+								type: "button",
+								className: "dcu-settings-back",
+								onClick: close,
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(ArrowLeft, { size: 16 }), renderSlot("settings.close", {}) ?? t("settings.back")]
+							}),
+							renderSlot("settings.header", {}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("label", {
+								className: "dcu-settings-search",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Search, {
+									size: 15,
+									"aria-hidden": "true"
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
+									type: "search",
+									value: query,
+									"aria-label": t("settings.search"),
+									placeholder: t("settings.search"),
+									onChange: (event) => {
+										setQuery(event.target.value);
+									}
+								})]
+							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "dcu-settings-groups",
+								children: [
+									"personal",
+									"integrations",
+									"records"
+								].map((group) => {
+									const entries = visible.filter((row) => settingsGroup(row.id) === group);
+									return entries.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+										className: "dcu-settings-group",
+										children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h2", {
+											className: "dcu-settings-group-label",
+											children: t(groupLabels[group])
+										}), entries.map((row) => {
+											const Icon = sectionIcon(row.id);
+											return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("button", {
+												type: "button",
+												className: "dcu-settings-link",
+												"aria-current": row.id === active?.id ? "page" : void 0,
+												onClick: () => {
+													setActiveId(row.id);
+												},
+												children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(Icon, {
+													size: 16,
+													strokeWidth: 1.6,
+													"aria-hidden": "true"
+												}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { children: row.id === "general" ? t("settings.general") : row.label })]
+											}, row.id);
+										})]
+									}, group);
+								})
+							}),
+							visible.length > 0 && !visible.some((row) => row.id === active?.id) && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "dcu-settings-empty",
+								role: "status",
+								children: t("settings.filterHint")
+							}),
+							visible.length === 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+								className: "dcu-settings-empty",
+								role: "status",
+								children: t("settings.noResults")
+							})
+						]
+					}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+						ref: main,
+						className: "dcu-settings-main",
+						children: /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+							className: "dcu-settings-inner",
+							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("header", {
+								className: "dcu-settings-heading",
+								"data-own-title": active?.id === "general",
+								children: [active?.id === "general" && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("h1", { children: t("settings.general") }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									className: "dcu-settings-actions",
+									children: renderSlot("settings.action", {})
+								})]
+							}), active !== void 0 && renderSlot("settings.section", { close }, { only: active.id })]
+						})
+					})]
+				}),
+				/* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+					ref: onboardingRoot,
+					style: { display: "contents" },
+					children: step !== void 0 && renderSlot("settings.onboarding", {
+						stepId: step.id,
+						complete: () => {
+							setCompleted((previous) => /* @__PURE__ */ new Set([...previous, step.id]));
+						},
+						openSection
+					}, { only: step.id })
+				})
+			] });
+		}
+		/** 每条偏好仍由原插件渲染和保存，只为公共条目添加可扩展的分组容器。 */
+		function CodexGeneralSettings({ items, renderSlot, t }) {
+			const rows = (0, react.useSyncExternalStore)(items.subscribe, items.getSnapshot);
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+				className: "dcu-settings-general",
+				children: [
+					"permissions",
+					"general",
+					"editor"
+				].map((group) => {
+					const entries = rows.filter((row) => generalItemGroup(row.id) === group);
+					return entries.length > 0 && /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+						className: "dcu-settings-general-group",
+						children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h2", { children: t(groupLabels[group]) }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+							className: "dcu-settings-card",
+							children: entries.map((row) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+								className: "dcu-settings-row",
+								children: renderSlot("settings.general.item", {}, { only: row.id })
+							}, row.id))
+						})]
+					}, group);
+				})
+			});
+		}
+		//#endregion
+		//#region src/client/SettingsDocumentAction.tsx
+		/** 通过宿主公开接口打开配置文件，沿用共享元数据和路径无关的操作。 */
+		function SettingsDocumentAction({ describe, openDocument, t }) {
+			const snapshot = (0, react.useSyncExternalStore)((listener) => describe.subscribe(listener), () => describe.getSnapshot());
+			const busy = (0, react.useRef)(false);
+			const [opening, setOpening] = (0, react.useState)(false);
+			const [error, setError] = (0, react.useState)(false);
+			(0, react.useEffect)(() => {
+				let active = true;
+				setError(false);
+				describe.ensure().catch(() => {
+					if (active) setError(true);
+				});
+				return () => {
+					active = false;
+				};
+			}, [describe]);
+			if (!snapshot.view?.hasDocument) return error ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				role: "alert",
+				children: t("settings.openDocumentError")
+			}) : null;
+			const open = async () => {
+				if (busy.current) return;
+				busy.current = true;
+				setOpening(true);
+				setError(false);
+				try {
+					setError(!(await openDocument()).ok);
+				} catch {
+					setError(true);
+				} finally {
+					busy.current = false;
+					setOpening(false);
+				}
+			};
+			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [error && /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
+				role: "alert",
+				children: t("settings.openDocumentError")
+			}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
+				type: "button",
+				disabled: opening,
+				onClick: () => {
+					open();
+				},
+				children: t("settings.openDocument")
+			})] });
+		}
+		//#endregion
+		//#region src/client/settings-page-registration.ts
+		/** 用公开插槽替换设置壳，保留宿主的设置写入、连接恢复和首次使用引导。 */
+		function registerSettingsPage(ctx) {
+			const children = [
+				"settings.trigger",
+				"settings.header",
+				"settings.action",
+				"settings.close",
+				"settings.section",
+				"settings.onboarding",
+				"settings.general.item"
+			];
+			const occupied = () => ctx.slots.entriesOfSlot("sidebar.settings").length > 0 || children.some((name) => ctx.slots.snapshot(name).length > 0);
+			const warn = () => console.warn("[michengai-codex-ui] 已存在设置外壳，保留宿主设置；独立设置页需要 bundle patch 停用 ui-settings-general。");
+			if (occupied()) {
+				warn();
+				return;
+			}
+			let owned = false;
+			const t = ctx.locale.bind(NS);
+			const connection = ctx.get("connection");
+			const source = (name) => {
+				let revision = "";
+				let cached = [];
+				return {
+					getSnapshot: () => {
+						const next = `${ctx.slots.getVersion(name)}:${ctx.locale.getSnapshot().revision}`;
+						if (revision !== next) {
+							revision = next;
+							cached = ctx.slots.entriesOfSlot(name).map((entry) => ({
+								id: entry.options.id ?? "",
+								order: entry.options.order ?? 0,
+								label: (typeof entry.options.label === "function" ? entry.options.label() : entry.options.label) ?? ""
+							})).sort((a, b) => a.order - b.order);
+						}
+						return cached;
+					},
+					subscribe: (listener) => {
+						const offSlots = ctx.slots.subscribe(name, listener);
+						const offLocale = ctx.locale.subscribe(listener);
+						return () => {
+							offSlots();
+							offLocale();
+						};
+					}
+				};
+			};
+			const sections = source("settings.section");
+			const onboarding = source("settings.onboarding");
+			const items = source("settings.general.item");
+			ctx.slots.inject("settings.trigger", () => !owned ? () => {} : ctx.slots.register({
+				name: "settings.trigger",
+				locale: NS
+			}, ({ wide }) => (0, react.createElement)("span", { className: "dcu-settings-trigger-content" }, (0, react.createElement)(Settings, {
+				size: 16,
+				strokeWidth: 1.6
+			}), wide ? (0, react.createElement)("span", null, t("settings.title")) : null)));
+			ctx.slots.inject("settings.close", () => !owned ? () => {} : ctx.slots.register({
+				name: "settings.close",
+				locale: NS
+			}, () => t("settings.back")));
+			ctx.inject(["settingsScope", "remote.settings"], (settingsCtx) => {
+				const remote = settingsCtx.get("remote");
+				if (!remote.$host.isLoopback) return;
+				const describe = settingsCtx.settingsScope.describe();
+				settingsCtx.slots.inject("settings.action", () => !owned ? () => {} : settingsCtx.slots.register({
+					name: "settings.action",
+					id: "open-document",
+					locale: NS,
+					inject: () => ({
+						describe,
+						openDocument: () => remote.settings.openSettingsDocument()
+					})
+				}, SettingsDocumentAction));
+			});
+			ctx.slots.inject("sidebar.settings", () => {
+				if (occupied()) {
+					warn();
+					return () => {};
+				}
+				owned = true;
+				const remove = ctx.slots.register({
+					name: "sidebar.settings",
+					priority: -1,
+					locale: NS,
+					children: {
+						"settings.trigger": {
+							kind: "single",
+							scope: "root"
+						},
+						"settings.header": {
+							kind: "single",
+							scope: "root"
+						},
+						"settings.action": {
+							kind: "list",
+							scope: "root"
+						},
+						"settings.close": {
+							kind: "single",
+							scope: "root"
+						},
+						"settings.section": {
+							kind: "list",
+							scope: "root"
+						},
+						"settings.onboarding": {
+							kind: "list",
+							scope: "root"
+						}
+					},
+					inject: () => ({
+						sections,
+						onboarding,
+						connectionState: connection.state,
+						reconnect: () => {
+							connection.reconnect();
+						}
+					})
+				}, CodexSettingsPage);
+				return () => {
+					owned = false;
+					remove();
+				};
+			});
+			ctx.slots.inject("settings.section", () => !owned ? () => {} : ctx.slots.register({
+				name: "settings.section",
+				id: "general",
+				priority: -1,
+				order: 0,
+				locale: NS,
+				label: () => t("settings.general"),
+				children: { "settings.general.item": {
+					kind: "list",
+					scope: "root"
+				} },
+				inject: () => ({ items })
+			}, CodexGeneralSettings));
+		}
+		//#endregion
 		//#region src/client/permission-labels.ts
 		const PERMISSION_LABELS = [
 			{
@@ -8183,6 +9132,7 @@ html[data-dcu-official-turn-navigator-supported=true] .dcu-turn-navigator,html:h
 			}), "michengai-codex-ui: dictionaries");
 			const t = ctx.locale.bind(NS);
 			registerInputHistory(ctx);
+			registerSettingsPage(ctx);
 			const connection = ctx.get("connection");
 			const openPath = (path) => openPathInHost(connection, path);
 			ctx.effect(() => observeSlimSidebar(), "michengai-codex-ui: slim sidebar");

package/lib/index.mjs

@@ -1,3 +1,4 @@
+import { apply as apply$1 } from "@deepseek-ai/dsh-client-ui-settings-general";
 import { spawn } from "node:child_process";
 import { existsSync } from "node:fs";
 import { lstat, mkdir, open, readFile, realpath, rename, rm, unlink, writeFile } from "node:fs/promises";
@@ -1674,6 +1675,7 @@ function sessionMoveAuthenticationError(status, error) {
 }
 /** 提供不泄露地址、命令和凭证的连接器目录。 */
 function apply(ctx) {
+	apply$1(ctx);
 	const host = hostServices(ctx);
 	ctx.effect(() => {
 		const foregroundExplorer = new ForegroundExplorer();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@michengai/dsh-codex-ui",
-  "version": "0.2.113",
+  "version": "1.0.0",
   "description": "以 Codex 风格重构 DSH Web 侧栏的独立客户端插件",
   "license": "Apache-2.0",
   "publishConfig": {
@@ -54,7 +54,8 @@
         "@deepseek-ai/dsh-client-ui-conversation",
         "@deepseek-ai/dsh-client-ui-input-trigger",
         "@deepseek-ai/dsh-client-ui-workspace",
-        "@deepseek-ai/dsh-client-ui-settings-general"
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-connection"
       ],
       "platform": "web"
     }
@@ -63,7 +64,7 @@
     "build": "tsc --noEmit && tsdown",
     "typecheck": "tsc --noEmit",
     "test": "pnpm run typecheck && vitest run && tsdown && node tests/run-assertions.mjs && pnpm run test:layout",
-    "test:layout": "node scripts/verify-workspace-drop-layout.mjs --run && node scripts/verify-sidebar-transition.mjs"
+    "test:layout": "node scripts/verify-workspace-drop-layout.mjs --run && node scripts/verify-sidebar-transition.mjs && node scripts/verify-settings-exit.mjs"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.2 <5.0.0",