dsh-ui-fortifier 0.6.0 → 0.7.0

package/README.md

@@ -18,7 +18,7 @@ dsh plugin --profile web add dsh-ui-fortifier
 
 ## Features
 
-Adds a "ui-fortifier" tab in Settings to toggle every feature module of this plugin.
+Adds a configuration area to this plugin's own card on the sidebar's Plugins page, toggling every feature module of this plugin.
 
 | Feature | Description |
 | --- | --- |
@@ -26,12 +26,12 @@ Adds a "ui-fortifier" tab in Settings to toggle every feature module of this plu
 | compact-button | Compact-context button at the right end of the composer tool row's left group; runs `/compact`. |
 | provider-label | Shows the currently selected provider to the left of the model selector. |
 | model-picker | Cascading model picker (provider → model) next to the model selector in the input row. |
-| open-dsh-folder | Adds an "Open .dsh folder" button next to "Open configuration file" at the top-right of the Settings page. |
+| open-dsh-folder | Adds an "Open dshHome folder" button next to "Open configuration file" at the top-right of the Settings page. |
 | settings-frame | Makes the Settings panel draggable and resizable. |
 
 ## dsh version used for development
 
-- dsh version used for development: `0.1.5-rc.2`. `@deepseek-ai/dsh-*` dependencies use `workspace:^`.
+- dsh version used for development: `0.1.7-rc.2`. `@deepseek-ai/dsh-*` dependencies use `workspace:^`.
 
 ## Secondary Development
 

package/README.zh.md

@@ -18,7 +18,7 @@ dsh plugin --profile web add dsh-ui-fortifier
 
 ## 功能
 
-在设置页新增「ui-fortifier」标签页，集中开关本插件各功能模块。
+在侧边栏「插件」页本插件自己的卡片上提供配置区，集中开关本插件各功能模块。
 
 | 功能 | 描述 |
 | --- | --- |
@@ -26,12 +26,12 @@ dsh plugin --profile web add dsh-ui-fortifier
 | compact-button | 输入框工具行左组右端提供压缩上下文按钮，等价于提交 `/compact` 指令。 |
 | provider-label | 在模型选择按钮左侧显示当前选择的提供方。 |
 | model-picker | 输入行模型选择器旁提供级联模型选择器（提供商 → 模型）。 |
-| open-dsh-folder | 在设置页右上角「打开配置文件」旁增加「打开 .dsh 文件夹」。 |
+| open-dsh-folder | 在设置页右上角「打开配置文件」旁增加「打开dshHome文件夹」。 |
 | settings-frame | 设置面板可拖动位置与拖动大小。 |
 
 ## 构建时使用的 dsh 版本
 
-- 构建时使用的 dsh 版本：`0.1.5-rc.2`；`@deepseek-ai/dsh-*` 依赖使用 `workspace:^`。
+- 构建时使用的 dsh 版本：`0.1.7-rc.2`；`@deepseek-ai/dsh-*` 依赖使用 `workspace:^`。
 
 ## 二次开发说明
 

package/lib/client.js

@@ -4,12 +4,12 @@ window.__ModuleLoader__.load({
 		var module = { exports: {} };
 		var exports = module.exports;
 		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
-		let react_jsx_runtime = require("react/jsx-runtime");
-		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
 		let react = require("react");
+		let _deepseek_ai_dsh_client_ui_primitives = require("@deepseek-ai/dsh-client-ui-primitives");
+		let react_jsx_runtime = require("react/jsx-runtime");
 		let react_dom = require("react-dom");
 		//#region \0dsh-css:D:\data\code\deepseek-harness\packages\my\dsh-ui-fortifier\src\client\settings\FortifierSettingsPage.module.css.mjs
-		const css$6 = ".t1_2kq_page{flex-direction:column;gap:8px;max-width:520px;padding:16px;display:flex}.t1_2kq_heading{color:var(--dsw-alias-label-primary);margin:0;font-size:16px;line-height:24px}.t1_2kq_list{flex-direction:column;margin:0;padding:0;list-style:none;display:flex}.t1_2kq_row{justify-content:space-between;align-items:center;gap:12px;padding:10px 12px;display:flex}.t1_2kq_row+.t1_2kq_row{border-top:.5px solid var(--dsw-alias-border-l3)}.t1_2kq_row:hover{background:var(--dsw-alias-interactive-bg-hover)}.t1_2kq_rowLabel{color:var(--dsw-alias-label-primary);font-size:13px;line-height:20px}.t1_2kq_switch{box-sizing:border-box;background:var(--dsw-alias-border-l3);cursor:pointer;border:0;border-radius:10px;flex:none;width:36px;height:20px;padding:2px;position:relative}.t1_2kq_switchOn{background:var(--dsw-alias-brand-primary)}.t1_2kq_switch:disabled{cursor:default;opacity:.5}.t1_2kq_switch:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:2px}.t1_2kq_thumb{corner-shape:round;background:var(--dsw-alias-label-primary-foreground);border-radius:50%;width:16px;height:16px;transition:transform .12s;display:block}.t1_2kq_switchOn .t1_2kq_thumb{transform:translate(16px)}";
+		const css$6 = ".t1_2kq_page{flex-direction:column;gap:8px;padding:16px;display:flex}.t1_2kq_heading{color:var(--dsw-alias-label-primary);margin:0;font-size:16px;line-height:24px}.t1_2kq_list{flex-direction:column;margin:0;padding:0;list-style:none;display:flex}.t1_2kq_row{justify-content:space-between;align-items:center;gap:12px;padding:10px 12px;display:flex}.t1_2kq_row+.t1_2kq_row{border-top:.5px solid var(--dsw-alias-border-l3)}.t1_2kq_row:hover{background:var(--dsw-alias-interactive-bg-hover)}.t1_2kq_rowLabel{color:var(--dsw-alias-label-primary);font-size:13px;line-height:20px}";
 		const tagId$6 = "dsh-ui-fortifier/FortifierSettingsPage.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$6) + "]") === null) {
 			const tag = document.createElement("style");
@@ -23,23 +23,57 @@ window.__ModuleLoader__.load({
 			"list": "t1_2kq_list",
 			"page": "t1_2kq_page",
 			"row": "t1_2kq_row",
-			"rowLabel": "t1_2kq_rowLabel",
-			"switch": "t1_2kq_switch",
-			"switchOn": "t1_2kq_switchOn",
-			"thumb": "t1_2kq_thumb"
+			"rowLabel": "t1_2kq_rowLabel"
 		};
 		//#endregion
 		//#region src/client/settings/FortifierSettingsPage.tsx
-		/** 设置页：读取配置项自动生成切换按钮行。 */
+		/**
+		* 配置区：插件页上本包卡片里的六个功能开关。
+		*/
+		/**
+		* 渲染六个功能开关。
+		* @param props - 组装后的插槽 props。
+		* @returns 插件页本包卡片上的配置区。
+		*/
 		function FortifierSettingsPage(props) {
 			const t = props.t;
 			const rows = props.useToggles((value) => value);
+			const [local, setLocal] = (0, react.useState)(() => /* @__PURE__ */ new Map());
+			const [pendingWrites, setPendingWrites] = (0, react.useState)(0);
+			const synced = (0, react.useRef)(/* @__PURE__ */ new Map());
+			(0, react.useEffect)(() => {
+				const host = new Map(rows.map((row) => [row.field, row.value]));
+				const unchanged = [...host].every(([field, value]) => synced.current.get(field) === value) && host.size === synced.current.size;
+				if (pendingWrites > 0 || unchanged) return;
+				synced.current = host;
+				setLocal(/* @__PURE__ */ new Map());
+			}, [rows, pendingWrites]);
+			/** 记一次未落定的写入，落定后减一；被拒或传输失败也照样放行，好让宿主值接管。 */
+			const trackWrite = (write) => {
+				setPendingWrites((count) => count + 1);
+				write.catch(() => false).finally(() => {
+					setPendingWrites((count) => Math.max(0, count - 1));
+				});
+			};
+			/**
+			* 提交一个开关：先落在本地（控件立即显示新值），再写宿主。
+			* @param row - 要切换的开关行。
+			*/
+			const commit = (row) => {
+				const next = !(local.get(row.field) ?? row.value);
+				const pending = new Map(local);
+				pending.set(row.field, next);
+				setLocal(pending);
+				synced.current = new Map(synced.current).set(row.field, next);
+				trackWrite(props.set(row.field, next));
+			};
+			if (props.view === "summary") return /* @__PURE__ */ (0, react_jsx_runtime.jsx)(react_jsx_runtime.Fragment, { children: t("nav") });
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
 				className: FortifierSettingsPage_module_css_default.page,
 				children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h2", {
 					className: FortifierSettingsPage_module_css_default.heading,
 					children: t("nav")
-				}), rows.length === 0 ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", { children: t("empty") }) : /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", {
+				}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("ul", {
 					className: FortifierSettingsPage_module_css_default.list,
 					children: rows.map((row) => {
 						const label = t(`config.${row.field}`);
@@ -48,16 +82,12 @@ window.__ModuleLoader__.load({
 							children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", {
 								className: FortifierSettingsPage_module_css_default.rowLabel,
 								children: label
-							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("button", {
-								type: "button",
-								role: "switch",
-								"aria-checked": row.value,
-								"aria-label": label,
-								className: `${FortifierSettingsPage_module_css_default.switch} ${row.value ? FortifierSettingsPage_module_css_default.switchOn : ""}`,
-								onClick: () => {
-									props.set(row.field, !row.value);
-								},
-								children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)("span", { className: FortifierSettingsPage_module_css_default.thumb })
+							}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.Switch, {
+								checked: local.get(row.field) ?? row.value,
+								label,
+								onChange: () => {
+									commit(row);
+								}
 							})]
 						}, row.field);
 					})
@@ -69,15 +99,14 @@ window.__ModuleLoader__.load({
 		/** 英文文案。 */
 		const en = {
 			nav: "ui-fortifier",
-			empty: "No feature modules registered.",
 			"config.provider-label": "Input - Provider",
-			"config.open-dsh-folder": "Settings top-right - Open .dsh folder",
+			"config.open-dsh-folder": "Settings top-right - Open dshHome folder",
 			"config.settings-frame": "Settings panel - Drag and resize",
 			"config.model-picker": "Input - Cascading model picker",
 			"config.session-id-copy": "Session header - Copy session ID",
 			"config.compact-button": "Input left group - Compact context",
-			openDshFolder: "Open .dsh folder",
-			"openDshFolder.error": "Could not open the .dsh folder",
+			openDshFolder: "Open dshHome folder",
+			"openDshFolder.error": "Could not open the dshHome folder",
 			"openDshFolder.pathLabel": "Path: ",
 			"settingsFrame.drag": "Drag the settings panel",
 			"settingsFrame.resize": "Resize the settings panel",
@@ -104,15 +133,14 @@ window.__ModuleLoader__.load({
 		/** 中文文案。 */
 		const zh = {
 			nav: "ui-fortifier",
-			empty: "没有已注册的功能模块。",
 			"config.provider-label": "输入框 - 提供商",
-			"config.open-dsh-folder": "设置右上角 - 打开 .dsh 文件夹",
+			"config.open-dsh-folder": "设置右上角 - 打开dshHome文件夹",
 			"config.settings-frame": "设置面板 - 拖动与缩放",
 			"config.model-picker": "输入框 - 级联模型选择器",
 			"config.session-id-copy": "会话标题栏 - 复制 Session ID",
 			"config.compact-button": "输入框左组 - 压缩上下文",
-			openDshFolder: "打开 .dsh 文件夹",
-			"openDshFolder.error": "无法打开 .dsh 文件夹",
+			openDshFolder: "打开dshHome文件夹",
+			"openDshFolder.error": "无法打开dshHome文件夹",
 			"openDshFolder.pathLabel": "路径：",
 			"settingsFrame.drag": "拖动设置面板",
 			"settingsFrame.resize": "缩放设置面板",
@@ -138,63 +166,58 @@ window.__ModuleLoader__.load({
 		};
 		//#endregion
 		//#region src/client/settings/index.ts
-		/** 本插件设置命名空间(与 host 侧一致)。 */
+		/** 本插件在 profile 里的入口 id，同时是设置契约的命名空间。 */
 		const UI_FORTIFIER = "ui-fortifier";
 		/**
-		* 注册设置页并绑定功能开关的 settings 作用域。
-		* @param ctx - 需已提供 slots/locale/settingsScope 的客户端上下文。
-		* @param moduleOrder - 功能模块字段的显示顺序(settings 开关 key)。
-		* @returns 功能开关的 settings 绑定,供调用方控制子模块注册。
+		* 本插件在 profile 里的包名，也是插件页派发配置区的键。
+		*
+		* 该页以 `pkg.name` 派发（`renderSlot('plugins.bundle.config', ..., { entryKey: pkg.name })`），
+		* 所以这里的值必须与 package.json 的 `name` 逐字一致；写错不会报错，只会让配置区静默
+		* 地不出现。
+		*/
+		const BUNDLE_NAME = "dsh-ui-fortifier";
+		/**
+		* 注册配置区并把入口配置的表单绑成本页的数据源。
+		* @param ctx - 需已提供 slots/locale/configForms 的客户端上下文。
+		* @param moduleOrder - 功能开关字段的显示顺序。
+		* @returns 本入口的表单，供调用方控制子模块注册。
 		*/
 		function installSettings(ctx, moduleOrder) {
 			ctx.effect(() => ctx.locale.register(UI_FORTIFIER, {
 				zh,
 				en
 			}), "dsh-ui-fortifier: copy dictionaries");
-			const scope = ctx.settingsScope.bind({ namespace: UI_FORTIFIER });
-			const mirror = ctx.settingsScope.describe();
-			const view = () => mirror.getSnapshot().view?.namespaces.find((row) => row.ns === UI_FORTIFIER);
-			const sectionInjected = () => {
+			const form = ctx.configForms.get(UI_FORTIFIER);
+			const injected = () => {
 				let cached = [];
-				let cachedSignature = "";
+				let signature = "";
 				return {
 					hooks: { toggles: {
 						getSnapshot: () => {
-							const value = view()?.value ?? {};
+							const value = form.getSnapshot().value;
 							const rows = moduleOrder.map((field) => ({
 								field,
-								value: value[field] ?? true
+								value: value?.[field] ?? true
 							}));
-							const signature = JSON.stringify(rows);
-							if (signature !== cachedSignature) {
+							const current = JSON.stringify(rows);
+							if (current !== signature) {
 								cached = rows;
-								cachedSignature = signature;
+								signature = current;
 							}
 							return cached;
 						},
-						subscribe: (listener) => {
-							const offScope = scope.subscribe(listener);
-							const offMirror = mirror.subscribe(listener);
-							return () => {
-								offScope();
-								offMirror();
-							};
-						}
+						subscribe: (listener) => form.subscribe(listener)
 					} },
-					set: (field, value) => {
-						scope.set(field, value);
-					}
+					set: (field, value) => form.set(field, value)
 				};
 			};
-			ctx.slots.inject("settings.section", () => ctx.slots.register({
-				name: "settings.section",
-				id: UI_FORTIFIER,
-				order: 30,
-				label: () => ctx.locale.bind(UI_FORTIFIER)("nav"),
+			ctx.slots.inject("plugins.bundle.config", () => ctx.slots.register({
+				name: "plugins.bundle.config",
+				key: BUNDLE_NAME,
 				locale: UI_FORTIFIER,
-				inject: sectionInjected
+				inject: injected
 			}, FortifierSettingsPage));
-			return scope;
+			return form;
 		}
 		//#endregion
 		//#region \0dsh-css:D:\data\code\deepseek-harness\packages\my\dsh-ui-fortifier\src\client\provider-label\ProviderLabel.module.css.mjs
@@ -252,7 +275,7 @@ window.__ModuleLoader__.load({
 		//#endregion
 		//#region src/client/open-dsh-folder/OpenDshFolderAction.tsx
 		/**
-		* 渲染「打开 .dsh 文件夹」操作，点击后请求 Host 打开 .dsh 目录。
+		* 渲染「打开 dshHome 文件夹」操作，点击后请求 Host 打开 dshHome 目录。
 		* @param props - header owner 参数、本地化文案与注入的打开回调。
 		* @returns 操作按钮及其结果提示。
 		*/
@@ -301,7 +324,7 @@ window.__ModuleLoader__.load({
 		/** 本模块文案命名空间(与 host 侧一致)。 */
 		const NS$2 = "ui-fortifier";
 		/**
-		* 注册「打开 .dsh 文件夹」到设置页右上角操作区，仅在回环连接下注册。
+		* 注册「打开 dshHome 文件夹」到设置页右上角操作区，仅在回环连接下注册。
 		* @param ctx - 需已提供 slots/connection 的客户端上下文。
 		* @returns 停止注入并卸载注册的 disposer。
 		*/
@@ -640,7 +663,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-css:D:\data\code\deepseek-harness\packages\my\dsh-ui-fortifier\src\client\model-picker\ModelPicker.module.css.mjs
-		const css$2 = ".AGI7WG_root{flex:none;display:inline-flex}.AGI7WG_trigger{box-sizing:border-box;width:28px;height:28px;color:var(--dsw-alias-label-secondary);cursor:pointer;background:0 0;border:none;border-radius:14px;justify-content:center;align-items:center;padding:0;display:inline-flex}.AGI7WG_trigger:hover{background:var(--dsw-alias-interactive-bg-hover)}.AGI7WG_trigger:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}.AGI7WG_triggerIcon{flex:none;width:14px;height:14px}.AGI7WG_menu{z-index:1100;box-sizing:border-box;background:var(--dsw-specific-menu);--dsw-elevation-stroke-color:var(--dsw-alias-border-l1);min-width:min(420px,100vw - 32px);max-width:min(520px,100vw - 32px);height:min(420px,100vh - 96px);box-shadow:var(--dsw-elevation-prominent);color:var(--dsw-alias-label-primary);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);border:0;border-radius:16px;flex-direction:column;padding:6px;display:flex;position:fixed;overflow:hidden}.AGI7WG_search{box-sizing:border-box;background:var(--dsw-alias-bg-layer-2);border:.5px solid var(--dsw-alias-border-l3);border-radius:10px;flex:none;align-items:center;gap:6px;height:28px;margin:0 2px 6px;padding:0 8px;display:flex}.AGI7WG_search:focus-within{border-color:var(--dsw-alias-brand-primary)}.AGI7WG_searchIcon{color:var(--dsw-alias-label-tertiary);flex:none;display:inline-flex}.AGI7WG_searchIcon svg{width:13px;height:13px}.AGI7WG_searchInput{min-width:0;color:var(--dsw-alias-label-primary);font:inherit;background:0 0;border:none;outline:none;flex:1;padding:0;font-size:13px;line-height:20px}.AGI7WG_searchInput::placeholder{color:var(--dsw-alias-label-tertiary)}.AGI7WG_columns{flex:1;min-height:0;display:flex;overflow:hidden}.AGI7WG_providers{flex:none;width:160px;padding-right:4px;overflow-y:auto}.AGI7WG_models{flex:1;min-width:0;padding-left:4px;overflow-y:auto}.AGI7WG_columnTitle{color:var(--dsw-alias-label-tertiary);padding:5px 8px 3px;font-size:12px;font-weight:500;line-height:18px}.AGI7WG_cell{box-sizing:border-box;width:100%;min-height:34px;color:inherit;font:inherit;text-align:left;cursor:pointer;background:0 0;border:none;border-radius:10px;align-items:center;gap:8px;padding:6px 8px;display:flex}.AGI7WG_cell:hover:not(:disabled),.AGI7WG_cell:focus-visible{background:var(--dsw-alias-interactive-bg-hover)}.AGI7WG_cellActive{background:var(--dsw-alias-interactive-bg-active);color:var(--dsw-alias-label-primary)}.AGI7WG_cellSelected{color:var(--dsw-alias-label-primary);font-weight:500}.AGI7WG_cell:disabled{color:var(--dsw-alias-label-dimmed);cursor:default}.AGI7WG_modelName{overflow-wrap:anywhere;flex:1;min-width:0}.AGI7WG_check{color:var(--dsw-alias-brand-primary);flex:none}.AGI7WG_status{color:var(--dsw-alias-label-tertiary);padding:10px;font-size:13px;line-height:20px}.AGI7WG_error{background:var(--dsw-alias-interactive-bg-hover-danger);color:var(--dsw-alias-state-error-primary);border-radius:8px;justify-content:space-between;align-items:flex-start;gap:8px;margin-bottom:4px;padding:7px 8px;font-size:12px;line-height:18px;display:flex}.AGI7WG_retry{color:inherit;font:inherit;cursor:pointer;background:0 0;border:none;flex:none;padding:0;font-weight:600}";
+		const css$2 = ".AGI7WG_root{flex:none;display:inline-flex}.AGI7WG_trigger{box-sizing:border-box;width:28px;height:28px;color:var(--dsw-alias-label-secondary);cursor:pointer;background:0 0;border:none;border-radius:14px;justify-content:center;align-items:center;padding:0;display:inline-flex}.AGI7WG_trigger:hover{background:var(--dsw-alias-interactive-bg-hover)}.AGI7WG_trigger:focus-visible{outline:2px solid var(--dsw-alias-brand-primary);outline-offset:1px}.AGI7WG_triggerIcon{flex:none;width:14px;height:14px}.AGI7WG_menu{z-index:1100;box-sizing:border-box;--dsw-elevation-stroke-color:var(--dsw-alias-border-l1);min-width:min(420px,100vw - 32px);max-width:min(520px,100vw - 32px);height:min(420px,100vh - 96px);box-shadow:var(--dsw-elevation-prominent);color:var(--dsw-alias-label-primary);--dsh-scrollbar-thumb:var(--dsw-alias-scrollbar-bg-l2);--dsh-scrollbar-thumb-hover:var(--dsw-alias-scrollbar-hover-l2);border:0;flex-direction:column;padding:6px;display:flex;position:fixed;overflow:hidden}.AGI7WG_search{box-sizing:border-box;background:var(--dsw-alias-bg-layer-2);border:.5px solid var(--dsw-alias-border-l3);border-radius:10px;flex:none;align-items:center;gap:6px;height:28px;margin:0 2px 6px;padding:0 8px;display:flex}.AGI7WG_search:focus-within{border-color:var(--dsw-alias-brand-primary)}.AGI7WG_searchIcon{color:var(--dsw-alias-label-tertiary);flex:none;display:inline-flex}.AGI7WG_searchIcon svg{width:13px;height:13px}.AGI7WG_searchInput{min-width:0;color:var(--dsw-alias-label-primary);font:inherit;background:0 0;border:none;outline:none;flex:1;padding:0;font-size:13px;line-height:20px}.AGI7WG_searchInput::placeholder{color:var(--dsw-alias-label-tertiary)}.AGI7WG_columns{flex:1;min-height:0;display:flex;overflow:hidden}.AGI7WG_providers{flex:none;width:160px;padding-right:4px;overflow-y:auto}.AGI7WG_models{flex:1;min-width:0;padding-left:4px;overflow-y:auto}.AGI7WG_columnTitle{color:var(--dsw-alias-label-tertiary);padding:5px 8px 3px;font-size:12px;font-weight:500;line-height:18px}.AGI7WG_cell{box-sizing:border-box;width:100%;min-height:34px;color:inherit;font:inherit;text-align:left;cursor:pointer;background:0 0;border:none;border-radius:10px;align-items:center;gap:8px;padding:6px 8px;display:flex}.AGI7WG_cell:hover:not(:disabled),.AGI7WG_cell:focus-visible{background:var(--dsw-alias-interactive-bg-hover)}.AGI7WG_cellActive{background:var(--dsw-alias-interactive-bg-active);color:var(--dsw-alias-label-primary)}.AGI7WG_cellSelected{color:var(--dsw-alias-label-primary);font-weight:500}.AGI7WG_cell:disabled{color:var(--dsw-alias-label-dimmed);cursor:default}.AGI7WG_modelName{overflow-wrap:anywhere;flex:1;min-width:0}.AGI7WG_check{color:var(--dsw-alias-brand-primary);flex:none}.AGI7WG_status{color:var(--dsw-alias-label-tertiary);padding:10px;font-size:13px;line-height:20px}.AGI7WG_error{background:var(--dsw-alias-interactive-bg-hover-danger);color:var(--dsw-alias-state-error-primary);border-radius:8px;justify-content:space-between;align-items:flex-start;gap:8px;margin-bottom:4px;padding:7px 8px;font-size:12px;line-height:18px;display:flex}.AGI7WG_retry{color:inherit;font:inherit;cursor:pointer;background:0 0;border:none;flex:none;padding:0;font-weight:600}";
 		const tagId$2 = "dsh-ui-fortifier/ModelPicker.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId$2) + "]") === null) {
 			const tag = document.createElement("style");
@@ -973,7 +996,7 @@ window.__ModuleLoader__.load({
 							})
 						]
 					})
-				}), picker.open && (0, react_dom.createPortal)(/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				}), picker.open && (0, react_dom.createPortal)(/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(_deepseek_ai_dsh_client_ui_primitives.MenuSurface, {
 					ref: menuRef,
 					className: ModelPicker_module_css_default.menu,
 					role: "dialog",
@@ -1199,7 +1222,7 @@ window.__ModuleLoader__.load({
 					className: SessionIdCopyAction_module_css_default.button,
 					"aria-label": t("sessionIdCopy.action"),
 					onClick: copy,
-					children: copied ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCheckOutline16, {}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(HashGlyph, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCopyOutline16, {})] })
+					children: copied ? /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCheckOutlineRegular, {}) : /* @__PURE__ */ (0, react_jsx_runtime.jsxs)(react_jsx_runtime.Fragment, { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)(HashGlyph, {}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)(_deepseek_ai_dsh_client_ui_primitives.IconCopyOutlineRegular, {})] })
 				})
 			});
 		}
@@ -1224,7 +1247,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region \0dsh-css:D:\data\code\deepseek-harness\packages\my\dsh-ui-fortifier\src\client\compact-button\CompactContextButton.module.css.mjs
-		const css = ".zxJg-q_root{flex:none;display:inline-flex}.zxJg-q_button{corner-shape:round;background:var(--dsw-specific-selector);width:28px;height:28px;color:var(--dsw-alias-label-primary);cursor:pointer;border:none;border-radius:999px;flex:none;place-items:center;display:grid}.zxJg-q_button:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover-solid)}.zxJg-q_button:disabled{opacity:.5;cursor:default}.zxJg-q_glyph{fill:currentColor;flex:none;width:16px;height:16px;overflow:hidden}.zxJg-q_popover{z-index:1100;box-sizing:border-box;background:var(--dsw-specific-menu);max-width:min(260px,100vw - 32px);box-shadow:var(--dsw-elevation-prominent);color:var(--dsw-alias-label-primary);border-radius:12px;flex-direction:column;align-items:flex-start;gap:10px;padding:10px 12px;display:flex;position:fixed}.zxJg-q_popoverText{margin:0;font-size:13px;line-height:20px}";
+		const css = ".zxJg-q_root{flex:none;display:inline-flex}.zxJg-q_button{corner-shape:round;background:var(--dsw-specific-selector);width:28px;height:28px;color:var(--dsw-alias-label-primary);cursor:pointer;border:none;border-radius:999px;flex:none;place-items:center;display:grid}.zxJg-q_button:hover:not(:disabled){background:var(--dsw-alias-interactive-bg-hover-solid)}.zxJg-q_button:disabled{opacity:.5;cursor:default}.zxJg-q_glyph{fill:currentColor;flex:none;width:16px;height:16px;overflow:hidden}.zxJg-q_popover{z-index:1100;box-sizing:border-box;max-width:min(260px,100vw - 32px);box-shadow:var(--dsw-elevation-prominent);color:var(--dsw-alias-label-primary);flex-direction:column;align-items:flex-start;gap:10px;padding:10px 12px;display:flex;position:fixed}.zxJg-q_popoverText{margin:0;font-size:13px;line-height:20px}";
 		const tagId = "dsh-ui-fortifier/CompactContextButton.module.css";
 		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
 			const tag = document.createElement("style");
@@ -1341,8 +1364,9 @@ window.__ModuleLoader__.load({
 						},
 						children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(CompressGlyph, {})
 					})
-				}), open && (0, react_dom.createPortal)(/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", {
+				}), open && (0, react_dom.createPortal)(/* @__PURE__ */ (0, react_jsx_runtime.jsxs)(_deepseek_ai_dsh_client_ui_primitives.MenuSurface, {
 					ref: panelRef,
+					compact: true,
 					className: CompactContextButton_module_css_default.popover,
 					role: "dialog",
 					"aria-label": props.t("compactButton.confirmTitle"),
@@ -1380,7 +1404,7 @@ window.__ModuleLoader__.load({
 		}
 		//#endregion
 		//#region src/client/index.ts
-		/** 功能模块清单：字段名(settings 开关 key) → 模块安装面。 */
+		/** 功能模块清单：字段名(配置开关 key) → 模块安装面。 */
 		const modules = {
 			"provider-label": {
 				module: installProviderLabel,
@@ -1407,7 +1431,7 @@ window.__ModuleLoader__.load({
 				dispose: void 0
 			}
 		};
-		/** 设置页开关行的显示顺序：按各模块在界面上的位置，从会话标题栏到输入行再到设置页。 */
+		/** 配置区开关行的显示顺序：按各模块在界面上的位置，从会话标题栏到输入行再到插件页。 */
 		const MODULE_ORDER = [
 			"session-id-copy",
 			"compact-button",
@@ -1419,7 +1443,7 @@ window.__ModuleLoader__.load({
 		const inject = [
 			"slots",
 			"locale",
-			"settingsScope",
+			"configForms",
 			"modelDirectories",
 			"connection",
 			"sessions",
@@ -1428,22 +1452,26 @@ window.__ModuleLoader__.load({
 			"remote.commands"
 		];
 		/**
-		* 客户端插件体：注册设置页并据开关状态挂载各功能模块。
-		* @param ctx - 需已提供 slots/locale/settingsScope/modelDirectories/connection/sessions/remote 的客户端上下文。
+		* 客户端插件体：注册插件页上的配置区并据开关状态挂载各功能模块。
+		* @param ctx - 需已提供 slots/locale/configForms/modelDirectories/connection/sessions/remote 的客户端上下文。
 		*/
 		function apply(ctx) {
-			const scope = installSettings(ctx, MODULE_ORDER);
-			for (const field of Object.keys(modules)) {
+			const form = installSettings(ctx, MODULE_ORDER);
+			const mounted = /* @__PURE__ */ new Map();
+			const sync = (snapshot, field) => {
+				const enabled = snapshot.value?.[field] ?? true;
+				if (mounted.get(field) === enabled) return;
+				mounted.set(field, enabled);
 				const item = modules[field];
-				const sync = () => {
-					const enabled = scope.getSnapshot().value?.[field] ?? true;
-					item.dispose?.();
-					if (enabled) item.dispose = item.module(ctx);
-					else item.dispose = void 0;
-				};
-				scope.subscribe(sync);
-				sync();
-			}
+				item.dispose?.();
+				item.dispose = enabled ? item.module(ctx) : void 0;
+			};
+			const syncAll = () => {
+				const snapshot = form.getSnapshot();
+				for (const field of Object.keys(modules)) sync(snapshot, field);
+			};
+			form.subscribe(syncAll);
+			syncAll();
 		}
 		//#endregion
 		exports.MODULE_ORDER = MODULE_ORDER;

package/lib/index.js

@@ -93,7 +93,7 @@ async function openWindowsFolderInForeground(path, signal) {
 		windowsOpenScript(path)
 	], signal);
 }
-/** 用系统默认方式打开 .dsh 文件夹；无原生打开器时返回路径让 UI 展示。 */
+/** 用系统默认方式打开 dshHome 文件夹；无原生打开器时返回路径让 UI 展示。 */
 let OpenDshFolderService = (() => {
 	let _classSuper = TypertRemoteService;
 	let _instanceExtraInitializers = [];
@@ -125,9 +125,9 @@ let OpenDshFolderService = (() => {
 			__runInitializers(this, _instanceExtraInitializers);
 		}
 		/**
-		* 打开 .dsh 文件夹。
+		* 打开 dshHome 文件夹。
 		* @param signal - 调用方可取消信号。
-		* @returns opened 为 false 时 path 为 .dsh 文件夹路径。
+		* @returns opened 为 false 时 path 为 dshHome 文件夹路径。
 		*/
 		async openDshFolder(signal) {
 			const home = resolveDshHome();
@@ -143,7 +143,7 @@ let OpenDshFolderService = (() => {
 					path: home
 				};
 			} catch (error) {
-				if (signal.aborted) throw new RemoteError("gateway/cancelled", "dsh folder open was aborted", {});
+				if (signal.aborted) throw new RemoteError("gateway/cancelled", "dshHome folder open was aborted", {});
 				throw new RemoteError("gateway/internal", `path open failed: ${messageOf(error)}`, {}, { cause: error });
 			}
 		}
@@ -154,30 +154,30 @@ function messageOf(error) {
 }
 //#endregion
 //#region lib/types/index.js
-/** 功能开关的 settings 命名空间。 */
-const UI_FORTIFIER_SETTINGS_NAMESPACE = "ui-fortifier";
-/** 插件配置 schema。 */
+/**
+* 插件配置 schema。
+*
+* 不写成 `z<Config>`：`Config` 的字段是 `Volatile<T>`，而 volatile 字段的 schema 类型
+* 处于 `"volatile-defined"` 模式，两者在双向方差下互不可赋值，加了注解反而编译不过
+* （官方与已迁移的插件同样只写 `z.object`）。
+*/
 const Config = z.object({
-	"provider-label": z.boolean().default(true),
-	"open-dsh-folder": z.boolean().default(true),
-	"settings-frame": z.boolean().default(true),
-	"model-picker": z.boolean().default(true),
-	"session-id-copy": z.boolean().default(true),
-	"compact-button": z.boolean().default(true)
+	"provider-label": z.boolean().default(true).volatile(),
+	"open-dsh-folder": z.boolean().default(true).volatile(),
+	"settings-frame": z.boolean().default(true).volatile(),
+	"model-picker": z.boolean().default(true).volatile(),
+	"session-id-copy": z.boolean().default(true).volatile(),
+	"compact-button": z.boolean().default(true).volatile()
 });
 /**
-* 注册功能开关的 settings 命名空间并暴露打开 .dsh 文件夹的 Remote 服务。
-* @param ctx - 需已挂载 settings 服务的 Cordis 上下文。
-* @param config - 插件配置,作为 base 层。
+* 挂载插件：暴露打开 dshHome 文件夹的 Remote 服务，并声明本插件自带配置区。
+* @param ctx - 需已提供 reflect（Typert 网关）的 Cordis 上下文。
 */
-function apply(ctx, config) {
+function apply(ctx) {
 	new OpenDshFolderService(ctx);
 	ctx.inject(["settings"], (settingsCtx) => {
-		settingsCtx.settings.installSection(ctx, UI_FORTIFIER_SETTINGS_NAMESPACE, Config, config, {
-			setSource: () => {},
-			onChange: () => {}
-		});
+		settingsCtx.effect(() => settingsCtx.settings.configure({ auto: false }, ctx.fiber));
 	});
 }
 //#endregion
-export { Config, UI_FORTIFIER_SETTINGS_NAMESPACE, apply };
+export { Config, apply };

package/lib/types/client/index.d.ts

@@ -8,14 +8,14 @@ interface ModuleEntry {
     /** 当前注册的 disposer；归位后为 undefined。 */
     dispose: (() => void) | undefined;
 }
-/** 功能模块清单：字段名(settings 开关 key) → 模块安装面。 */
+/** 功能模块清单：字段名(配置开关 key) → 模块安装面。 */
 export declare const modules: Record<keyof Config, ModuleEntry>;
-/** 设置页开关行的显示顺序：按各模块在界面上的位置，从会话标题栏到输入行再到设置页。 */
+/** 配置区开关行的显示顺序：按各模块在界面上的位置，从会话标题栏到输入行再到插件页。 */
 export declare const MODULE_ORDER: readonly (keyof Config)[];
 export declare const inject: string[];
 /**
- * 客户端插件体：注册设置页并据开关状态挂载各功能模块。
- * @param ctx - 需已提供 slots/locale/settingsScope/modelDirectories/connection/sessions/remote 的客户端上下文。
+ * 客户端插件体：注册插件页上的配置区并据开关状态挂载各功能模块。
+ * @param ctx - 需已提供 slots/locale/configForms/modelDirectories/connection/sessions/remote 的客户端上下文。
  */
 export declare function apply(ctx: Context): void;
 declare module '@deepseek-ai/dsh-client-ui-slots' {

package/lib/types/client/locales.d.ts

@@ -1,6 +1,6 @@
 /** dsh-ui-fortifier 的文案。 */
 /** locale key。 */
-export type UiFortifierLocaleKey = 'nav' | 'empty' | 'config.provider-label' | 'config.open-dsh-folder' | 'config.settings-frame' | 'config.model-picker' | 'config.session-id-copy' | 'config.compact-button' | 'openDshFolder' | 'openDshFolder.error' | 'openDshFolder.pathLabel' | 'settingsFrame.drag' | 'settingsFrame.resize' | 'modelPicker.trigger' | 'modelPicker.searchPlaceholder' | 'modelPicker.providers' | 'modelPicker.models' | 'modelPicker.emptyProviders' | 'modelPicker.emptySearch' | 'modelPicker.emptyModels' | 'modelPicker.loading' | 'modelPicker.loadError' | 'modelPicker.retry' | 'modelPicker.provider' | 'modelPicker.model' | 'sessionIdCopy.action' | 'sessionIdCopy.hint' | 'sessionIdCopy.copied' | 'compactButton.action' | 'compactButton.confirmTitle' | 'compactButton.confirmText' | 'compactButton.confirm';
+export type UiFortifierLocaleKey = 'nav' | 'config.provider-label' | 'config.open-dsh-folder' | 'config.settings-frame' | 'config.model-picker' | 'config.session-id-copy' | 'config.compact-button' | 'openDshFolder' | 'openDshFolder.error' | 'openDshFolder.pathLabel' | 'settingsFrame.drag' | 'settingsFrame.resize' | 'modelPicker.trigger' | 'modelPicker.searchPlaceholder' | 'modelPicker.providers' | 'modelPicker.models' | 'modelPicker.emptyProviders' | 'modelPicker.emptySearch' | 'modelPicker.emptyModels' | 'modelPicker.loading' | 'modelPicker.loadError' | 'modelPicker.retry' | 'modelPicker.provider' | 'modelPicker.model' | 'sessionIdCopy.action' | 'sessionIdCopy.hint' | 'sessionIdCopy.copied' | 'compactButton.action' | 'compactButton.confirmTitle' | 'compactButton.confirmText' | 'compactButton.confirm';
 /** 英文文案。 */
 export declare const en: Record<UiFortifierLocaleKey, string>;
 /** 中文文案。 */

package/lib/types/client/open-dsh-folder/OpenDshFolderAction.d.ts

@@ -2,15 +2,15 @@ import type { InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-cli
 import type { ReactNode } from 'react';
 import type { ConnectionRpcResult } from '@deepseek-ai/dsh-client-connection/client';
 import type { DshFolderOpenValue } from '../../types.ts';
-/** 打开 .dsh 文件夹的注入面。 */
+/** 打开 dshHome 文件夹的注入面。 */
 export interface OpenDshFolderInjected {
-    /** 请求 Host 打开 .dsh 文件夹。 */
+    /** 请求 Host 打开 dshHome 文件夹。 */
     openDshFolder: () => Promise<ConnectionRpcResult<DshFolderOpenValue>>;
 }
 /** header 操作区的 owner 参数、本地化文案与注入回调。 */
 export type OpenDshFolderActionProps = PropsRuntime<'settings.action'> & PropsLocale<'ui-fortifier'> & InjectFace<OpenDshFolderInjected>;
 /**
- * 渲染「打开 .dsh 文件夹」操作，点击后请求 Host 打开 .dsh 目录。
+ * 渲染「打开 dshHome 文件夹」操作，点击后请求 Host 打开 dshHome 目录。
  * @param props - header owner 参数、本地化文案与注入的打开回调。
  * @returns 操作按钮及其结果提示。
  */

package/lib/types/client/open-dsh-folder/index.d.ts

@@ -1,10 +1,10 @@
 /**
- * open-dsh-folder 功能：在设置页右上角「打开配置文件」旁增加「打开 .dsh 文件夹」。
+ * open-dsh-folder 功能：在设置页右上角「打开配置文件」旁增加「打开 dshHome 文件夹」。
  */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
 export type { OpenDshFolderActionProps, OpenDshFolderInjected } from './OpenDshFolderAction.tsx';
 /**
- * 注册「打开 .dsh 文件夹」到设置页右上角操作区，仅在回环连接下注册。
+ * 注册「打开 dshHome 文件夹」到设置页右上角操作区，仅在回环连接下注册。
  * @param ctx - 需已提供 slots/connection 的客户端上下文。
  * @returns 停止注入并卸载注册的 disposer。
  */

package/lib/types/client/settings/FortifierSettingsPage.d.ts

@@ -1,22 +1,27 @@
 import type { HostObservable, InjectFace, PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { Config } from '../../types.ts';
 /** 一个功能开关行的状态。 */
 export interface FortifierToggleRow {
-    /** 字段名(即 settings 的 key)。 */
-    field: string;
+    /** 字段名(即配置的 key)。 */
+    field: keyof Config;
     /** 当前值。 */
     value: boolean;
 }
-/** 设置页渲染所需的面。 */
+/** 配置区渲染所需的面。 */
 export interface FortifierPageInjected {
     hooks: {
         /** 所有功能开关的当前值(响应式)。 */
         toggles: HostObservable<readonly FortifierToggleRow[]>;
     };
-    /** 写入一个开关值(user 层)。 */
-    set: (field: string, value: boolean) => void;
+    /** 写入一个开关值(user 层)；落定后 resolve。 */
+    set: (field: keyof Config, value: boolean) => Promise<boolean>;
 }
-/** 设置页 props。 */
-export type FortifierSettingsPageProps = PropsRuntime<'settings.section'> & PropsLocale<'ui-fortifier'> & InjectFace<FortifierPageInjected>;
-/** 设置页：读取配置项自动生成切换按钮行。 */
+/** 配置区 props：挂在插件页本包详情页的 `plugins.bundle.config` 上。 */
+export type FortifierSettingsPageProps = PropsRuntime<'plugins.bundle.config'> & PropsLocale<'ui-fortifier'> & InjectFace<FortifierPageInjected>;
+/**
+ * 渲染六个功能开关。
+ * @param props - 组装后的插槽 props。
+ * @returns 插件页本包卡片上的配置区。
+ */
 export declare function FortifierSettingsPage(props: FortifierSettingsPageProps): import("react").JSX.Element;
 //# sourceMappingURL=FortifierSettingsPage.d.ts.map

package/lib/types/client/settings/index.d.ts

@@ -1,14 +1,17 @@
+/**
+ * 注册本插件的配置区（插件页上本包自己的卡片），并把入口配置的表单绑成本页的数据源。
+ */
 import type { Context as ClientContext } from '@deepseek-ai/cordis';
-import type { SettingsScope } from '@deepseek-ai/dsh-client-ui-settings/client';
+import type { ConfigForm } from '@deepseek-ai/dsh-client-ui-settings/client';
 import type { Config } from '../../types.ts';
 export type { FortifierPageInjected, FortifierSettingsPageProps } from './FortifierSettingsPage.tsx';
-/** 本插件设置命名空间(与 host 侧一致)。 */
+/** 本插件在 profile 里的入口 id，同时是设置契约的命名空间。 */
 export declare const UI_FORTIFIER = "ui-fortifier";
 /**
- * 注册设置页并绑定功能开关的 settings 作用域。
- * @param ctx - 需已提供 slots/locale/settingsScope 的客户端上下文。
- * @param moduleOrder - 功能模块字段的显示顺序(settings 开关 key)。
- * @returns 功能开关的 settings 绑定,供调用方控制子模块注册。
+ * 注册配置区并把入口配置的表单绑成本页的数据源。
+ * @param ctx - 需已提供 slots/locale/configForms 的客户端上下文。
+ * @param moduleOrder - 功能开关字段的显示顺序。
+ * @returns 本入口的表单，供调用方控制子模块注册。
  */
-export declare function installSettings(ctx: ClientContext, moduleOrder: readonly string[]): SettingsScope<Config>;
+export declare function installSettings(ctx: ClientContext, moduleOrder: readonly (keyof Config)[]): ConfigForm<Config>;
 //# sourceMappingURL=index.d.ts.map

package/lib/types/index.d.ts

@@ -1,17 +1,62 @@
-import type { Context } from '@deepseek-ai/cordis';
+/**
+ * dsh-ui-fortifier 的宿主半侧。
+ *
+ * 只做两件事：暴露「打开 dshHome 文件夹」的 Remote 服务，以及声明本插件自带配置区。
+ * 六个功能开关的值由浏览器半侧经设置表单读写（见 `src/client/settings/index.ts`），
+ * 宿主不读它们，因此 `apply` 不接配置参数。
+ *
+ * @module dsh-ui-fortifier
+ */
+import type { Context, Volatile } from '@deepseek-ai/cordis';
 import z from '@deepseek-ai/schemastery';
-import type { Config as FortifierConfig } from './types.ts';
-/** 插件配置类型（定义见 `./types.ts`，与 Client 面共享）。 */
-export type Config = FortifierConfig;
 export type { DshFolderOpenValue } from './types.ts';
-/** 功能开关的 settings 命名空间。 */
-export declare const UI_FORTIFIER_SETTINGS_NAMESPACE = "ui-fortifier";
-/** 插件配置 schema。 */
-export declare const Config: z<FortifierConfig>;
 /**
- * 注册功能开关的 settings 命名空间并暴露打开 .dsh 文件夹的 Remote 服务。
- * @param ctx - 需已挂载 settings 服务的 Cordis 上下文。
- * @param config - 插件配置,作为 base 层。
+ * 插件配置。
+ *
+ * 六个字段都是 **volatile 引用**：设置表单只投影入口 `Config` 里声明为 `.volatile()`
+ * 的字段，写入由 Loader 经 `updateVolatile` 落回本入口的 profile patch。volatile 引用
+ * 原地更新，所以表单每次 `.get()` 都拿到当前值，不必重挂插件。
+ * 解引用之后的普通值见 [src/types.ts](./types.ts) 的 `Config`。
+ */
+export interface Config {
+    /** 输入框显示当前提供商。 */
+    'provider-label': Volatile<boolean>;
+    /** 插件页右上角显示打开 dshHome 文件夹按钮。 */
+    'open-dsh-folder': Volatile<boolean>;
+    /** 设置面板可拖动位置与大小。 */
+    'settings-frame': Volatile<boolean>;
+    /** 输入框右侧显示级联模型选择器(先选提供商、再选模型)。 */
+    'model-picker': Volatile<boolean>;
+    /** 会话标题栏显示复制会话 ID 按钮。 */
+    'session-id-copy': Volatile<boolean>;
+    /** 输入框工具行左组右端显示压缩上下文按钮。 */
+    'compact-button': Volatile<boolean>;
+}
+/**
+ * 插件配置 schema。
+ *
+ * 不写成 `z<Config>`：`Config` 的字段是 `Volatile<T>`，而 volatile 字段的 schema 类型
+ * 处于 `"volatile-defined"` 模式，两者在双向方差下互不可赋值，加了注解反而编译不过
+ * （官方与已迁移的插件同样只写 `z.object`）。
+ */
+export declare const Config: z<Schemastery.ObjectS<NoInfer<{
+    'provider-label': z<boolean, boolean, "volatile-defined">;
+    'open-dsh-folder': z<boolean, boolean, "volatile-defined">;
+    'settings-frame': z<boolean, boolean, "volatile-defined">;
+    'model-picker': z<boolean, boolean, "volatile-defined">;
+    'session-id-copy': z<boolean, boolean, "volatile-defined">;
+    'compact-button': z<boolean, boolean, "volatile-defined">;
+}>>, Schemastery.ObjectT<NoInfer<{
+    'provider-label': z<boolean, boolean, "volatile-defined">;
+    'open-dsh-folder': z<boolean, boolean, "volatile-defined">;
+    'settings-frame': z<boolean, boolean, "volatile-defined">;
+    'model-picker': z<boolean, boolean, "volatile-defined">;
+    'session-id-copy': z<boolean, boolean, "volatile-defined">;
+    'compact-button': z<boolean, boolean, "volatile-defined">;
+}>>, "plain">;
+/**
+ * 挂载插件：暴露打开 dshHome 文件夹的 Remote 服务，并声明本插件自带配置区。
+ * @param ctx - 需已提供 reflect（Typert 网关）的 Cordis 上下文。
  */
-export declare function apply(ctx: Context, config: FortifierConfig): void;
+export declare function apply(ctx: Context): void;
 //# sourceMappingURL=index.d.ts.map

package/lib/types/open-dsh-folder.d.ts

@@ -1,18 +1,18 @@
 /**
- * 打开本机 .dsh 文件夹的 Host Remote 服务。
+ * 打开本机 dshHome 文件夹的 Host Remote 服务。
  * 端点 `uiFortifier/openDshFolder` 由网关的 SRC 反射发现，无需 typert 生成器产物。
  */
 import { Context } from '@deepseek-ai/cordis';
 import { TypertRemoteService } from '@deepseek-ai/dsh-typert-protocol';
 import type { DshFolderOpenValue } from './types.ts';
 export type { DshFolderOpenValue };
-/** 用系统默认方式打开 .dsh 文件夹；无原生打开器时返回路径让 UI 展示。 */
+/** 用系统默认方式打开 dshHome 文件夹；无原生打开器时返回路径让 UI 展示。 */
 export declare class OpenDshFolderService extends TypertRemoteService {
     constructor(ctx: Context);
     /**
-     * 打开 .dsh 文件夹。
+     * 打开 dshHome 文件夹。
      * @param signal - 调用方可取消信号。
-     * @returns opened 为 false 时 path 为 .dsh 文件夹路径。
+     * @returns opened 为 false 时 path 为 dshHome 文件夹路径。
      */
     openDshFolder(signal: AbortSignal): Promise<DshFolderOpenValue>;
 }

package/lib/types/types.d.ts

@@ -1,27 +1,30 @@
 /**
  * 本包 Host/Client 两面共享的类型。
  * 仅类型、无运行时代码：双面工程各自编译本文件，无需跨面引用。
+ *
+ * 这里的 `Config` 是**解引用之后的普通值**，也就是配置区读写的那一份；Host 面的
+ * `Config` 六个字段都包在 volatile 引用里，见 [src/index.ts](./index.ts)。
  */
 /** 插件配置：功能开关状态(配置默认值)。 */
 export interface Config {
     /** 输入框显示当前提供商。 */
-    'provider-label': boolean;
-    /** 设置页右上角显示打开 .dsh 文件夹按钮。 */
-    'open-dsh-folder': boolean;
+    readonly 'provider-label': boolean;
+    /** 插件页右上角显示打开 dshHome 文件夹按钮。 */
+    readonly 'open-dsh-folder': boolean;
     /** 设置面板可拖动位置与大小。 */
-    'settings-frame': boolean;
+    readonly 'settings-frame': boolean;
     /** 输入框右侧显示级联模型选择器(先选提供商、再选模型)。 */
-    'model-picker': boolean;
+    readonly 'model-picker': boolean;
     /** 会话标题栏显示复制会话 ID 按钮。 */
-    'session-id-copy': boolean;
+    readonly 'session-id-copy': boolean;
     /** 输入框工具行左组右端显示压缩上下文按钮。 */
-    'compact-button': boolean;
+    readonly 'compact-button': boolean;
 }
-/** 打开 .dsh 文件夹的返回值。 */
+/** 打开 dshHome 文件夹的返回值。 */
 export interface DshFolderOpenValue {
     /** 是否已发起系统打开。 */
     readonly opened: boolean;
-    /** .dsh 文件夹绝对路径（未打开时供 UI 展示）。 */
+    /** dshHome 文件夹绝对路径（未打开时供 UI 展示）。 */
     readonly path: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-ui-fortifier",
   "description": "UI 强化",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "license": "MIT",
   "contributors": [
     "pgnqukezrdxmhjso"
@@ -44,35 +44,36 @@
     "lib/types/**/*.d.ts"
   ],
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-home-paths": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-native-command": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.2"
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-native-command": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-home-paths": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.7-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.4"
   },
   "devDependencies": {
     "@types/react": "~18.3.1",
     "@types/react-dom": "~18.3.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",
-    "@deepseek-ai/dsh-api-remotes": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-api-session-controller": "^0.1.5-rc.2",
-    "@deepseek-ai/cordis": "^4.0.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-model-selection": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-home-paths": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-locale": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-client-ui-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-native-command": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.5-rc.2",
-    "@deepseek-ai/schemastery": "^3.18.2",
-    "@deepseek-ai/dsh-session": "^0.1.5-rc.2",
-    "@deepseek-ai/dsh-settings": "^0.1.5-rc.2"
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/dsh-client-ui-conversation": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-remotes": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-connection": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-model-selection": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-api-session-controller": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-plugin-manager": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-session": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-home-paths": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-native-command": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-session": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-settings": "^0.1.7-rc.2",
+    "@deepseek-ai/schemastery": "^3.18.4",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.7-rc.2"
   },
   "dsh": {
     "bundle": {
@@ -85,6 +86,7 @@
         "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-client-ui-conversation",
         "@deepseek-ai/dsh-client-ui-model-selection",
+        "@deepseek-ai/dsh-client-ui-plugin-manager",
         "@deepseek-ai/dsh-client-ui-renderer",
         "@deepseek-ai/dsh-client-ui-settings",
         "@deepseek-ai/dsh-client-locale"
@@ -98,6 +100,7 @@
     "verify": "node ../dsh-pgnqukezrdxmhjso-base/verify.mjs",
     "pub": "pnpm run build && pnpm login --registry=https://registry.npmjs.org && pnpm publish --registry=https://registry.npmjs.org --no-git-checks",
     "pack": "pnpm run build && pnpm pack --pack-destination lib",
+    "link-test-i": "pnpm run build && (pnpm dsh plugin --profile pkgtest remove %npm_package_name% & pnpm dsh plugin --profile pkgtest add link:./)",
     "pack-test-i": "pnpm run pack && (pnpm dsh plugin --profile pkgtest remove %npm_package_name% & pnpm dsh plugin --profile pkgtest add ./lib/%npm_package_name%-%npm_package_version%.tgz)",
     "npm-test-i": "pnpm dsh plugin --profile pkgtest remove %npm_package_name% & pnpm dsh plugin --profile pkgtest add --registry=https://registry.npmjs.org %npm_package_name%@%npm_package_version%",
     "test-create": "pnpm dsh --profile pkgtest --from-default-profile web",