@linxin666/dsh-client-ui-skin-center 0.3.16 → 0.3.18

package/contracts/semantic-attrs-v1.md

@@ -45,7 +45,7 @@
 | `data-dsh-wallpaper-active` | html + body（body/html 级，另行管理） | WE 壁纸挂载期间置 `true`，卸载 / 禁用清除；供皮肤 CSS 与壁纸中和规则锚定（#734） |
 | `data-dsh-wallpaper-surface` | 官方 shell 全视口背景元素 + 侧栏工作区淡化条（元素级） | `WallpaperController.markWallpaperSurfaces()` 在 WE 壁纸挂载期间打标（全视口 bg-base 背景 + `data-slot="sidebar.workspaces"` 内渐变淡化条），命中 `html[data-dsh-wallpaper-active] [data-dsh-wallpaper-surface]` 中和；卸载清除，不含哈希类依赖（#734） |
 
-## part 组（49 行，含各 owner 行）
+## part 组（70 行，含各 owner 行）
 
 shell 区域（owner: shell）：
 
@@ -89,6 +89,7 @@ family / 插件区域：
 | `card` | skill-explorer | 技能中心模态卡；`[data-dsh-plugin="skill-explorer"] [data-dsh-part="card"]` |
 | `tab-bar` / `tab` | skill-explorer | 技能中心页签条/页签；`[data-dsh-plugin="skill-explorer"] [data-dsh-part="tab-bar"]` / `[data-dsh-plugin="skill-explorer"] [data-dsh-part="tab"]` |
 | `skill-row` | skill-explorer | 技能卡行；`[data-dsh-plugin="skill-explorer"] [data-dsh-part="skill-row"]` |
+| `filter-bar` | skill-explorer | 技能列表筛选条（搜索框 + 工作区选择）；`[data-dsh-plugin="skill-explorer"] [data-dsh-part="filter-bar"]` |
 | `header` | doctor | 救助控制台头部；`[data-dsh-plugin="doctor"] [data-dsh-part="header"]` |
 | `enable` | doctor | 救助模式启用行 |
 | `status` | doctor | 系统状态卡 |
@@ -118,8 +119,16 @@ family / 插件区域：
 | `trend-card` / `usage-chart` | usage | 近 30 天卡 / 其中的提供方-模型条形图；`[data-dsh-part="trend-card"]` 内 `[data-dsh-part="usage-chart"]` |
 | `settings-row` | usage | 插件设置行；`[data-dsh-part="settings-row"]` |
 | `plan-card` / `plan-window` | usage | 套餐卡 / 套餐窗口行（个人套餐页签）；`[data-dsh-part="plan-card"]` 内窗口行 |
+| `panel` | model-capabilities | 提供方卡片能力扩展区根；`[data-dsh-plugin="model-capabilities"][data-dsh-part="panel"]` |
+| `toggle` | model-capabilities | 扩展区折叠头按钮；panel 内 `button[data-dsh-part="toggle"]` |
+| `model-row` / `model-toggle` | model-capabilities | 逐模型能力行与其展开按钮；panel 内 `li[data-dsh-part="model-row"]` 及其中 `button[data-dsh-part="model-toggle"]` |
+| `image-input` / `efforts-mode` | model-capabilities | 图片输入勾选组 / 推理档位三态组；展开行内字段容器 `[data-dsh-part="image-input"]`、`[data-dsh-part="efforts-mode"]` |
+| `wire-input` | model-capabilities | 档位发送值输入行；`[data-dsh-part="wire-input"]` 内含 `input[type="text"]` |
+| `save` / `reset` / `disable` / `enable` / `reload` | model-capabilities | 扩展区动作按钮（保存 / 重置 / 禁用此提供方 / 启用 / 重新读取）；panel 内裸值按钮 |
+| `disabled-state` | model-capabilities | 已禁用提供方的卡片提示区（含启用按钮）；panel 内 `[data-dsh-part="disabled-state"]` |
+| `disabled-footer` / `disabled-row` | model-capabilities | Models 页底部存档区与其行；`settings.models.footer` 槽内 `section[data-dsh-part="disabled-footer"]` 与其中 `li[data-dsh-part="disabled-row"]` |
 
-## plugin 组（14 个，含停更 aionui-panel）
+## plugin 组（15 个，含停更 aionui-panel）
 
 | data-dsh-plugin | owner | 锚定方式 |
 | --- | --- | --- |
@@ -137,6 +146,7 @@ family / 插件区域：
 | `session-id` | dsh-session-id | footer action slot entry id `session-id`；`[data-dsh-plugin="session-id"]`（面板 overlay 根 + 入口触发器） |
 | `miku-pet` | dsh-miku-pet | 宠物浮层根 `[data-dsh-plugin="miku-pet"]`；host 路由前缀 `/miku-pet/*`；设置页 settings.section id `miku-pet-config` |
 | `usage` | dsh-usage | 一级设置分区 settings.section id `dsh-usage`（创意工坊下方）；`[data-dsh-plugin="usage"]` |
+| `model-capabilities` | dsh-model-capabilities | Models 页 `settings.models.provider-card` keyed 槽 key `llm-pi-ai`（提供方卡片扩展区）+ `settings.models.footer` 槽 entry id `ui-model-capabilities`（存档区）；`[data-dsh-plugin="model-capabilities"]` |
 
 ## 已知脆弱点（上游主题缝 PR 诉求）
 

package/lib/client.js

@@ -3365,6 +3365,48 @@ window.__ModuleLoader__.load({
 			const extracted = extractSkinBackgroundUserLayer(user);
 			return extracted === null ? "" : JSON.stringify(extracted);
 		}
+		/** Seed the reconcile state from the scope snapshot visible at construction. */
+		function initialSkinBackgroundReconcileState(snapshot) {
+			return {
+				v2Loaded: false,
+				bootSyncSeen: false,
+				lastRevision: snapshot.revision,
+				lastUserJson: serializeSkinBackgroundUserLayer(snapshot.user)
+			};
+		}
+		/**
+		* Fold one scope publication into the reconcile state and produce the v2-safe
+		* patch to merge into the live background values (null = nothing to apply).
+		*
+		* The boot document never merges, whichever order it lands in:
+		*  - a publication seen before the v2 GET completes is only recorded, so the
+		*    post-load check reads it as the unchanged boot snapshot, not an edit;
+		*  - the first revisioned publication of the plugin's lifetime (the document
+		*    resync itself) is consumed as the boot sync even when it lands after the
+		*    GET, because a genuine settings-page edit can only follow the document.
+		*/
+		function reconcileSkinBackgroundPublication(state, current, snapshot) {
+			const seen = {
+				...state,
+				lastRevision: snapshot.revision ?? state.lastRevision,
+				lastUserJson: serializeSkinBackgroundUserLayer(snapshot.user)
+			};
+			if (!state.v2Loaded) return {
+				state: seen,
+				patch: null
+			};
+			if (!state.bootSyncSeen) return {
+				state: snapshot.revision === void 0 ? seen : {
+					...seen,
+					bootSyncSeen: true
+				},
+				patch: null
+			};
+			return {
+				state: seen,
+				patch: reconcileSkinBackgroundScope(current, snapshot, state.lastRevision, state.lastUserJson).patch
+			};
+		}
 		/**
 		* Accept a scope publication only when its namespace revision is new AND the
 		* user layer has actually changed. A revision bump with identical user-layer
@@ -4969,7 +5011,7 @@ window.__ModuleLoader__.load({
 		/** The building package's version, when the bundle carries it. */
 		function bakedVersion() {
 			try {
-				return "0.3.16";
+				return "0.3.18";
 			} catch {
 				return;
 			}
@@ -5121,33 +5163,31 @@ window.__ModuleLoader__.load({
 				if (value === void 0 || value === null) return null;
 				return value;
 			};
-			let v2Loaded = false;
-			let lastScopeRevision = backgroundScope.getSnapshot().revision;
-			let lastUserJson = serializeSkinBackgroundUserLayer(backgroundScope.getSnapshot().user);
 			const background = new BackgroundController(scopeConfig(), persistBackground);
+			let reconcileState = initialSkinBackgroundReconcileState(backgroundScope.getSnapshot());
 			const reconcileScope = () => {
-				if (!v2Loaded) return;
-				const snapshot = backgroundScope.getSnapshot();
-				const result = reconcileSkinBackgroundScope(background.snapshot(), {
-					revision: snapshot.revision,
-					user: snapshot.user
-				}, lastScopeRevision, lastUserJson);
-				lastScopeRevision = result.revision;
-				lastUserJson = result.lastUserJson;
-				if (!result.accepted || result.patch === null) return;
-				const current = background.snapshot();
+				const result = reconcileSkinBackgroundPublication(reconcileState, background.snapshot(), backgroundScope.getSnapshot());
+				reconcileState = result.state;
+				if (result.patch === null) return;
+				const currentSnapshot = background.snapshot();
 				background.init({
-					...current,
+					...currentSnapshot,
 					...result.patch
 				});
 				persistBackground(background.snapshot());
 			};
 			fetch(V2_ACTIVE_URL).then((res) => res.ok ? res.json() : null).then((body) => {
-				v2Loaded = true;
+				reconcileState = {
+					...reconcileState,
+					v2Loaded: true
+				};
 				if (body?.background) background.init(body.background);
 				reconcileScope();
 			}).catch(() => {
-				v2Loaded = true;
+				reconcileState = {
+					...reconcileState,
+					v2Loaded: true
+				};
 				reconcileScope();
 			});
 			ctx.effect(() => backgroundScope.subscribe(reconcileScope), "ui-skin-center: background scope sync");