dsh-mpkg-wallpaper 3.13.12 → 3.14.0

package/README.en.md

@@ -258,8 +258,6 @@ Contains the *Show wallpaper* sub-section.
 | Title bar frost amount | `headerBlurAmount` | 0% | Frost thickness 0–100% (default 0 = transparent) | 0 |
 | Set title bar frost separately | `headerFrostOwn` | off | on = `headerFrostAmount` overrides the frost radius | off |
 | Title bar frost strength | `headerFrostAmount` | 30px | 0–60 | 0 |
-| Right sidebar / dock blur | `rightSidebarBlur` | on | The DSH right sidebar and bottom dock | off |
-| Blur amount / surface opacity | `rightSidebarBlurAmount` / `rightSidebarAlpha` | 14px / 45% | 0–40 / 0–100% | — |
 
 ### 4. Surface unify (unify)
 
@@ -273,15 +271,24 @@ Contains the *Show wallpaper* sub-section.
 | Unified fog (full-screen mask) | `aquaMask` | off | All surfaces share one fog colour (moved here from the Aqua section) | off |
 | Unified fog strength | `aquaMaskAlpha` | 82% | 0–100% | — |
 
+> **What the two sliders mean (fixed since 2026-10-02; judged by `tools/fog-model-test.mjs`)**:
+> *Full-screen blur degree* = blur radius (**0 = no blur at all**: the title bar / sidebar / right sidebar / dock
+> return to a **solid** surface, so the un-blurred raw wallpaper is never shown through);
+> *Left sidebar / title-bar opacity* = fog thickness on every surface (**0 = fully transparent**: the *blurred*
+> wallpaper only, no fog and no wallpaper-sampled tint) — it only matters while the blur degree is > 0.
+> Both apply to the **whole UI shell** (left sidebar, title bar, right sidebar and dock share one set of tokens).
+
 ### 5. UI blur (blur)
 
 | Label | Key | Default | Amount key / default | Off |
 |---|---|---|---|---|
+| UI blur follows Unified blur | `blurFollowUnify` | **on** | on = the taken-over rows on this page follow the *Full-screen blur degree* + *Left sidebar / title-bar opacity*; off = they become independently adjustable | — |
 | Blur dialogs | `dialogBlur` | on | `dialogAmount` 14px | off |
 | Blur settings panel | `settingsBlur` | on | `settingsAmount` 14px | off |
 | Blur download/confirm popups | `confirmBlur` | on | `confirmAmount` 12px | off |
 | Blur popovers | `popoverBlur` | on | `popoverAmount` 10px; plus `popoverAlpha` 94% surface opacity | off |
 | Blur mask (full-screen backdrop) | `maskBlur` | on | `maskAmount` 8px | off |
+| Right sidebar / dock blur | `rightSidebarBlur` | on | `rightSidebarBlurAmount` 14px + `rightSidebarAlpha` 45%; both are taken over while following Unified blur | off |
 
 ### 6. Other (other)
 

package/README.md

@@ -273,8 +273,6 @@ node tools/build-bundle.mjs
 | 标题栏磨砂程度 | `headerBlurAmount` | 0% | 白雾厚度 0–100%（默认 0 = 透明） | 0 |
 | 单独调节标题栏磨砂 | `headerFrostOwn` | 关 | 开 = 用 `headerFrostAmount` 覆盖磨砂半径 | 关 |
 | 标题栏磨砂强度 | `headerFrostAmount` | 30px | 0–60 | 0 |
-| 右侧边栏/dock 虚化 | `rightSidebarBlur` | 开 | DSH 自带右侧边栏与底部 dock | 关 |
-| 虚化程度 / 表面透明度 | `rightSidebarBlurAmount` / `rightSidebarAlpha` | 14px / 45% | 0–40 / 0–100% | — |
 
 ### 4. 界面统一（unify）
 
@@ -288,15 +286,24 @@ node tools/build-bundle.mjs
 | 统一雾（全屏遮罩） | `aquaMask` | 关 | 所有表面共享一种雾色（原 Aqua 实验项） | 关 |
 | 统一雾强度 | `aquaMaskAlpha` | 82% | 0–100% | — |
 
+> **两个条的语义（2026-10-02 起口径固定，判据 `tools/fog-model-test.mjs`）**：
+> 「整屏虚化程度」= 模糊半径（**0 = 完全不虚化**：标题栏/侧边栏/右栏/dock 也回到**实心**，
+> 不会把未模糊的原始壁纸透出来）；
+> 「左侧边栏/标题栏透明度」= 各表面白雾厚度（**0 = 完全透明**：只看到**模糊**壁纸，不留雾、不留面板取色）——
+> 它只在「整屏虚化程度 > 0」时决定观感。
+> 两者对**整个界面外壳**生效（左栏/标题栏/右栏/dock 共用同一套表面 token）。
+
 ### 5. 界面虚化（blur）
 
 | 面板文案 | 内部键 | 默认 | 程度键 / 默认 | 关 |
 |---|---|---|---|---|
+| 界面虚化跟随统一虚化 | `blurFollowUnify` | **开** | 开 = 本页被接管的项交给「整屏虚化程度 + 左侧边栏/标题栏透明度」统一驱动；关 = 各自独立可调 | — |
 | 虚化对话框 | `dialogBlur` | 开 | `dialogAmount` 14px | 关 |
 | 虚化设置面板 | `settingsBlur` | 开 | `settingsAmount` 14px | 关 |
 | 虚化下载/确认弹窗 | `confirmBlur` | 开 | `confirmAmount` 12px | 关 |
 | 虚化弹层 | `popoverBlur` | 开 | `popoverAmount` 10px；另有 `popoverAlpha` 94% 表面不透明度 | 关 |
 | 虚化遮罩（全屏背景） | `maskBlur` | 开 | `maskAmount` 8px | 关 |
+| 右侧边栏/dock 虚化 | `rightSidebarBlur` | 开 | `rightSidebarBlurAmount` 14px + `rightSidebarAlpha` 45%；跟随统一虚化时两项都被接管 | 关 |
 
 ### 6. 其他（other）
 

package/lib/client.js

@@ -373,6 +373,11 @@ function mpwTrace(ev, data) {
 		const DEFAULT_CHAT_FOLLOW = true; // ①(新) 统一虚化是否接管聊天区壁纸（开=整屏统一；关=磨砂条独立控制聊天区，统一虚化只管侧边栏/标题栏）
 		const DEFAULT_SIDEBAR_ALPHA = 35; // ①(新) 统一虚化下侧边栏/标题栏白雾厚度 0-100（默认 35：顶栏/侧边栏一致且白底淡，session log/模式标签后不会太突兀；用户实测 55 太厚）
 		const DEFAULT_SESSION_FOLLOW = true; // 统一虚化下，「新会话」按钮是否随整屏虚化（关=随面板不透明度）
+		// ①(2026-10-02 第3项) 「界面虚化」是否跟随统一虚化（默认跟随 = 保持历史接管语义）：
+		//   开(默认) → 统一虚化开时，界面虚化里被点名接管的项（左侧边栏磨砂/右栏/dock…
+		//              以及它们背后的雾厚度）由「整屏虚化程度 + 左侧边栏/标题栏透明度」驱动；
+		//   关       → 界面虚化完全独立：各自的开关/滑条自己说了算，统一虚化不再接管它们。
+		const DEFAULT_BLUR_FOLLOW_UNIFY = true;
 		const DEFAULT_HYBRID = true; // ①(新) 大文件混合模式：上传到 DSH 宿主流式播放（>600MB 无限制）；关=纯浏览器模式
 		// ⑲(新) Aqua 实验模式（借鉴 Bil812 fork，默认全关，不影响原功能）：
 		// - aquaMask：统一雾（#mpw-mask 全屏遮罩，所有表面共享一种雾色）
@@ -498,21 +503,50 @@ function mpwTrace(ev, data) {
 		   DSH 自己的第一方客户端包统一兜底到 `http://dsh.internal`（`dsh-client-connection` 的 `INTERNAL_BASE`、
 		   `dsh-client-file-upload` 的 `resolveUrl`、`dsh-session-log-export`、`dsh-client-ui-open-in-app`、
 		   `dsh-api-gateway` 五处同款）——这里照**同一口径**做，桌面壳负责解析这个名字：
-		     · HTTP 档（web profile）：origin 有值 ⇒ 返回 `origin + HOST_BASE`，与原相对路径**逐字节等价**；
-		     · 非 HTTP 档：origin 缺失/`"null"` ⇒ 返回 `http://dsh.internal + HOST_BASE`。
+		     · HTTP 档（web profile）：origin 有值 ⇒ **保持原来的相对路径**（`/api/...`）——
+		       相对路径天然同源、随宿主 host/port 变化，也是 DSH 第一方客户端包的写法；
+		       这里绝对化过一次（改成 `origin + path`），把 5 个门禁的"URL 形状"判据打成红的
+		       （np-media / np-control / web-wallpaper / pkg-import / media-session-wiring 期望
+		       相对路径），属回归 ⇒ 已改回相对；
+		     · 非 HTTP 档：origin 缺失/`"null"`/file:// ⇒ 返回 `http://dsh.internal + HOST_BASE`。
 		   所有宿主 URL 一律经 `HOST_URL`（或 `mpwHostUrl()`），不要再写裸相对路径。 */
 		const MPW_HOST_FALLBACK_ORIGIN = "http://dsh.internal";
-		function mpwHostOrigin() {
-			try {
-				const o = (typeof location !== "undefined" && location) ? location.origin : void 0;
-				return (typeof o === "string" && o && o !== "null") ? o : MPW_HOST_FALLBACK_ORIGIN;
-			} catch (e) { return MPW_HOST_FALLBACK_ORIGIN }
+		/** 页面 origin；拿不到 / 是 `"null"`（file:// 档）⇒ 返回 ""。
+		 *  ⚠️ 不看 `location.protocol`：桩环境（tools/_stub.mjs）只给 origin/href 不给 protocol，
+		 *  多这一条会把"HTTP 档"误判成非 HTTP 档 ⇒ 又把 URL 绝对化成 dsh.internal（门禁红）。
+		 *  origin 本身有效就说明是 http(s) 档（file:// 的 origin 恒为字符串 "null"）。 */
+		function mpwPageOrigin() {
+			try {
+				const l = (typeof location !== "undefined" && location) ? location : null;
+				if (!l) return "";
+				const o = String(l.origin || "");
+				return (o && o !== "null") ? o : "";
+			} catch (e) { return "" }
 		}
-		/** 绝对化一个宿主路径（已是 http(s) 的原样返回；其余一律前缀宿主 origin）。 */
+		/** 宿主 origin（报告/诊断用）：可用 origin > `http://dsh.internal` 兜底。 */
+		function mpwHostOrigin() { return mpwPageOrigin() || MPW_HOST_FALLBACK_ORIGIN }
+		/** 宿主 URL：HTTP 档原样相对路径（逐字节等价），非 HTTP 档才绝对化到 dsh.internal。 */
 		function mpwHostUrl(path) {
 			const p2 = String(path == null ? "" : path);
 			if (/^https?:/i.test(p2)) return p2;
-			return mpwHostOrigin() + (p2.charAt(0) === "/" ? p2 : "/" + p2);
+			const rel = p2.charAt(0) === "/" ? p2 : "/" + p2;
+			const o = mpwPageOrigin();
+			return o ? rel : MPW_HOST_FALLBACK_ORIGIN + rel;
+		}
+		/** **交给别的文档/源**的宿主 URL：必须绝对。
+		 *  哪些地方必须用它（判据：这个字符串会不会被**另一个文档**解析）：
+		 *   · 场景渲染器 iframe 的 `pkgurl=`（渲染器可能在另一个源，如回环 :8902 —— 相对路径会被它
+		 *     按**自己的** origin 解析 ⇒ 取不到包；3.13.11 起这里一直是 `location.origin + HOST_BASE`）；
+		 *   · 交给渲染器的 `thumbpost=`（它据此 POST 回宿主）。
+		 *  页面自己的 fetch/`<img src>` 一律用相对（`mpwHostUrl`）——同源、随宿主 host/port 变化。
+		 *  ①(2026-10-02) 这条纪律是被真红点逼出来的：把 `HOST_URL` 一律改回相对后，
+		 *  `mpwSceneIdentityFromWebUrl()` 里的 `new URL(pkgurl)` 直接抛错 ⇒ 沙箱 strict 的
+		 *  `st` 令牌不再下发（**安全档静默降级 legacy**），scene-url-token-guard 的 A2/B5/C2 变红。 */
+		function mpwHostAbsUrl(path) {
+			const p2 = String(path == null ? "" : path);
+			if (/^https?:/i.test(p2)) return p2;
+			const rel = p2.charAt(0) === "/" ? p2 : "/" + p2;
+			return mpwHostOrigin() + rel;
 		}
 		/** 反过来：把（可能是绝对的）宿主 URL 还原成以 HOST_BASE 开头的路径；不是宿主 URL 返回 ""。 */
 		function mpwHostPathOf(url) {
@@ -6878,7 +6912,7 @@ function mpwThumbFail(el, why) {
 				}
 				const q = "custom=1" + (meta.folder ? "&folder=" + encodeURIComponent(meta.folder) : "")
 					+ "&file=" + encodeURIComponent(meta.rawFile);
-				const rawUrl = HOST_URL + "/raw?" + q;
+				const rawUrl = mpwHostAbsUrl("/raw?" + q);   // ①(2026-10-02) 交给渲染器 iframe ⇒ 必须绝对（见 mpwHostAbsUrl 注释）
 				const base = mpwSceneRendererBase();
 				/* ①(P-205 F6) 渲染器目标闸门的判定结果：`st` 下发与 extbase 都由它决定。
 				   base 已经过闸门（不合法时 `mpwSceneRendererBase()` 回落默认回环），这里再取一次
@@ -6953,7 +6987,7 @@ function mpwThumbFail(el, why) {
 					//   demo.html 首帧/第 90 帧各 POST 一次（text/plain 简单请求免预检），失败仅日志。
 					//   ①(批次15 B1) 首帧 POST 同时是**首帧看门狗的信标**（宿主 lastpost=1 查询）。
 					//   ①(B6) strict 下 token 随 body 走（简单请求，绝不加自定义头：那会触发预检被鉴权墙 401）。
-					+ "&thumbpost=" + encodeURIComponent(HOST_URL + "/custom-scene-thumb")
+					+ "&thumbpost=" + encodeURIComponent(mpwHostAbsUrl("/custom-scene-thumb"))   // ①(2026-10-02) 渲染器据此回传首帧 ⇒ 必须绝对
 					+ (__sbToken ? "&sandbox=strict&thumbtoken=" + encodeURIComponent(__sbToken) : "");
 				if (!__sbToken) { try { mpwSandboxPrefetch(__sbPlan.ident); } catch {} }
 				try { const sbd = mpwSandboxDiag(); if (window.__mpwDiagSandboxHook) window.__mpwDiagSandboxHook(sbd) } catch {}
@@ -7606,7 +7640,20 @@ function mpwThumbFail(el, why) {
 					? explicitGate
 					: (explicitFrost ? explicitGate : (wallpaperOn || hb || un));
 				// 半径下限：过去在"没填强度"时会算成 0（=看不到模糊）。现在给可见下限（磨砂 24px、统一虚化取下限 12px）。
-				const px = !wanted ? 0 : (own ? Math.max(8, ownAmt) : (un ? Math.max(12, unAmt || 0) : Math.max(12, hbAmt > 0 ? Math.round(hbAmt / 4) : 24)));
+				// ①(2026-10-02 第1项真机) **0 就是 0**：旧写法 `Math.max(12, unAmt || 0)` 把"整屏虚化程度
+				//   = 0"也算成 12px ⇒ 用户把统一虚化拉到 0（滑条语义：0 = 不虚化），标题栏却还在模糊。
+				//   现在可见下限只在**值 > 0** 时兜（1–11px 仍抬到 12px 保证看得见），显式 0 → px = 0
+				//   ⇒ 走下面的 cleanup 分支（注入层被移除、半透明底被撤掉），"关掉"是真关掉。
+				//   标题栏磨砂条（hbAmt）保留旧语义：它默认 0 = **自动档**（24px），不是"关闭"。
+				const pxFloor = (v, lo) => (Number(v) > 0 ? Math.max(lo, Number(v)) : 0);
+				// ①(2026-10-02 第3项) 「界面虚化是否跟随统一虚化」（新开关，默认跟随）：
+				//   跟随 = 标题栏磨砂半径由 unifyAmount 接管（历史语义）；不跟随 = 标题栏自己的
+				//   磨砂条（headerBlurAmount / headerFrostOwn）说了算，统一虚化只管壁纸与表面雾。
+				const followUnifyNow = un && mpwFogModel(s).followUnify;
+				const px = !wanted ? 0
+					: (own ? pxFloor(ownAmt, 8)
+						: (followUnifyNow ? pxFloor(unAmt, 12)
+							: (hbAmt > 0 ? Math.max(12, Math.round(hbAmt / 4)) : (un ? pxFloor(unAmt, 12) : 24))));
 				// 自动半透明底：让模糊真的看得见（否则顶栏是不透明的，磨砂被挡在后面）。
 				// ①(2026-09-16) 半透底色改用**我们自己的命名空间 token**（--mpw-hdr-frost-bg），
 				//   不再依赖宿主静态色 token；亮/暗两档由 JS 写入（见下）。
@@ -8306,6 +8353,13 @@ function mpwThumbFail(el, why) {
 				const rsBlurOn = section.rightSidebarBlur !== void 0 ? !!section.rightSidebarBlur : DEFAULT_RIGHT_SIDEBAR_BLUR;
 				// 关闭时写 "off"（而不是移除属性）——兜底选择器据此精确匹配，避免"无属性=恒关"
 				if (rsBlurOn) document.body.setAttribute("data-mpw-rsblur", "on"); else document.body.setAttribute("data-mpw-rsblur", "off");
+				// ①(2026-10-02 第2/3项) 统一虚化接管门控：只有"统一虚化开 + 界面虚化跟随"时才打。
+				//   CSS 侧 [data-mpw-unify] 的右栏/dock/better-sidebar 规则据此生效（与
+				//   buildCss 里 unifyTakeover 同源：都走 mpwFogModel(section).unifyOn）。
+				try {
+					if (mpwFogModel(section).unifyOn) document.body.setAttribute("data-mpw-unify", "");
+					else document.body.removeAttribute("data-mpw-unify");
+				} catch {}
 				// ①(2026-09-13) 标题栏磨砂实现方式开关：默认"本体"（观感稳定）；
 				//   ?hdrblur=pseudo → 改用 .wSkVaW_header::before 伪元素（不产生 containing block/层叠上下文，
 				//   用于排障：若某些浮层/面板在"本体"方案下异常，可切到该模式对照）。
@@ -8351,6 +8405,14 @@ function mpwThumbFail(el, why) {
 					|| (section.aquaTint !== void 0 ? !!section.aquaTint : DEFAULT_AQUA_TINT);
 				if (headerTint) document.body.setAttribute("data-mpw-aqua-header", "");
 				else document.body.removeAttribute("data-mpw-aqua-header");
+				// ①(2026-10-02 第1项) 刷多厚 = 当前的雾厚度（统一虚化开 → 左侧边栏/标题栏透明度；
+				//   关 → 历史档 62%）。厚度 0 ⇒ 写 0% ⇒ color-mix(...,0%) = 透明，标题栏不被采样色盖住。
+				try {
+					const fog = mpwFogModel(section);
+					const pct = fog.unifyOn ? fog.sidePct : 62;
+					if (headerTint) document.documentElement.style.setProperty("--mpw-aqua-header-alpha", pct + "%");
+					else document.documentElement.style.removeProperty("--mpw-aqua-header-alpha");
+				} catch {}
 				if (section.aquaTextEnhance !== void 0 ? !!section.aquaTextEnhance : DEFAULT_AQUA_TEXT_ENHANCE)
 					document.body.setAttribute("data-mpw-aqua-text", "");
 				else document.body.removeAttribute("data-mpw-aqua-text");
@@ -11105,6 +11167,47 @@ function mpwThumbFail(el, why) {
 				}
 			} catch {}
 		}
+		/**
+		 * 雾模型（唯一源，2026-10-02 第 1/2/3 项）：所有"表面雾"的**厚度**都从这里取。
+		 *
+		 * 为什么需要它（真机 bug）：厚度与颜色原来各写各的 —— 表面底色读滑条（sidebarAlpha），
+		 * 而"面板取色"的 token 覆盖把 alpha 写死（bg-base 62% / sidebar-fill 85%）。
+		 * 于是用户把「整屏虚化程度」和「左侧边栏/标题栏透明度」都拉到 0（= 不要雾、
+		 * 不要模糊）时，侧边栏里层仍被刷上 85% 的**壁纸采样色**（粉色），观感是
+		 * "透明侧边栏 + 壁纸采样粉"，而标题栏还留着 12px 模糊（见 syncHeaderFrost 的 0 下限修复）。
+		 *
+		 * 现在：颜色（取色/mask 色）只决定**色相**，可见程度一律 = 这里的厚度；
+		 *       厚度 0 ⇒ 该表面一个像素都不刷（纯壁纸透出），不是"刷一层透明度 0 的颜色"。
+		 *
+		 * @returns {{followUnify:boolean, unifyOn:boolean, amountPx:number, sidePct:number, chatPct:number}}
+		 *   followUnify  「界面虚化」是否跟随统一虚化（新开关，默认跟随）
+		 *   unifyOn      = 统一虚化开关 && followUnify ⇒ 一个厚度管全部（左栏/标题栏/右栏/dock/聊天区）
+		 *   amountPx     整屏虚化程度（0–40px）：壁纸层与各栏的模糊半径
+		 *   sidePct      左侧边栏/标题栏透明度（0–100）：所有 chrome 表面的雾厚度（**取色 alpha 用它**）
+		 *   shellPct     chrome 表面的**有效**厚度：amount = 0（不虚化）⇒ 钉到 100 = 实心
+		 *                （没有模糊时透出原始壁纸 = "零设置却有观感"，用户第1项真机反馈）
+		 *   chatPct      聊天区厚度（面板不透明度，历史下限 50）
+		 */
+		function mpwFogModel(section) {
+			const s = section || {};
+			const followUnify = s.blurFollowUnify !== void 0 ? !!s.blurFollowUnify : DEFAULT_BLUR_FOLLOW_UNIFY;
+			const unifyOn = (s.unifyTint !== void 0 ? !!s.unifyTint : DEFAULT_UNIFY_TINT) && followUnify;
+			const rawAmt = Number(s.unifyAmount !== void 0 ? s.unifyAmount : DEFAULT_UNIFY_AMOUNT);
+			const rawSide = Number(s.sidebarAlpha !== void 0 ? s.sidebarAlpha : DEFAULT_SIDEBAR_ALPHA);
+			const rawChat = Number(s.opacity !== void 0 ? s.opacity : DEFAULT_OPACITY);
+			const amountPx = Math.max(0, Math.min(40, Number.isFinite(rawAmt) ? rawAmt : DEFAULT_UNIFY_AMOUNT));
+			const sidePct = Math.max(0, Math.min(100, Number.isFinite(rawSide) ? rawSide : DEFAULT_SIDEBAR_ALPHA));
+			return {
+				followUnify,
+				unifyOn,
+				amountPx,
+				sidePct,
+				/* ①(2026-10-02 第1项) 有效厚度：不虚化 ⇒ 实心（与 buildCss 的 uAlpha 同一条纪律，
+				   两处必须一致：一处管左栏/标题栏，一处管右栏/dock/better-sidebar 的接管 token）。 */
+				shellPct: amountPx > 0 ? sidePct : 100,
+				chatPct: Math.max(50, Math.min(100, Number.isFinite(rawChat) ? rawChat : DEFAULT_OPACITY)),
+			};
+		}
 		/** Aqua 开启时的 token 覆盖（mask 色背景 + ink 文字 + 蓝色清理），合并进 applyTokenOverrides。 */
 		function aquaTokenOverrides(section) {
 			const darkTheme = !!(document.body && document.body.hasAttribute("data-ds-dark-theme"));
@@ -11120,12 +11223,21 @@ function mpwThumbFail(el, why) {
 			// 用户实测 aquaTint 开时 full access/加号/模型/推理/上下文选择器被变透明（不该）
 			const tintOn = section.aquaTint !== void 0 ? !!section.aquaTint : DEFAULT_AQUA_TINT;
 			const maskOn = section.aquaMask !== void 0 ? !!section.aquaMask : DEFAULT_AQUA_MASK;
+			/* ①(2026-10-02 第1项) 取色只管**色相**，可见程度 = 雾模型给的**厚度**：
+			   这两枚"表面"token（主画布 bg-base / 侧边栏填充 sidebar-fill）以前把 alpha 写死
+			   62%/85%，于是「整屏虚化程度 + 左侧边栏/标题栏透明度」都拉到 0 时，侧边栏里层
+			   仍被刷上 85% 的壁纸采样色（真机：透明侧边栏 + 壁纸采样粉）。
+			   现在统一虚化开 → 用 sidebarAlpha（0 ⇒ color-mix(...,0%) = 完全透明，一个像素不刷）；
+			   统一虚化关 → 保留历史档（62%/85%），观感与刷新前逐字节一致。 */
+			const fog = mpwFogModel(section);
+			const baseAlpha = fog.unifyOn ? fog.chatPct / 100 : 0.62;
+			const sideAlpha = fog.unifyOn ? fog.sidePct / 100 : 0.85;
 			const out = {};
 			// 主画布 + 面板/表面类（取色或统一雾开启时生效）
 			if (tintOn || maskOn) {
 				Object.assign(out, {
-					"--dsw-alias-bg-base": { light: tinted(0.62), dark: tinted(0.62) },
-					"--dsw-specific-sidebar-fill": { light: tinted(0.85), dark: tinted(0.85) },
+					"--dsw-alias-bg-base": { light: tinted(baseAlpha), dark: tinted(baseAlpha) },
+					"--dsw-specific-sidebar-fill": { light: tinted(sideAlpha), dark: tinted(sideAlpha) },
 					"--dsw-specific-sidebar-nav-item-active": { light: tinted(0.72), dark: tinted(0.72) },
 					"--dsw-specific-sidebar-nav-item-hover": { light: tinted(0.6), dark: tinted(0.6) },
 					"--dsw-specific-sidebar-nav-item-active-accent": { light: tinted(0.6), dark: tinted(0.6) },
@@ -15914,12 +16026,27 @@ module.exports = {
 			// unifyTint=true 时各区域不再用各自写死的百分比，全部用 U(原值)=panel，
 			// 视觉上侧边栏/聊天区/标题栏/输入框不再"一块白一块透"地分裂背景。
 			const unifyTint = section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT;
+			/* ①(2026-10-02 第3项) 「界面虚化跟随统一虚化」开关（默认跟随 = 历史接管语义）。
+			   跟随 ⇒ 界面虚化里被点名接管的项（左侧边栏磨砂/标题栏磨砂/右栏·dock 虚化）
+			          统一由「整屏虚化程度 + 左侧边栏/标题栏透明度」驱动；
+			   不跟随 ⇒ 这些项各自恢复可调（统一虚化只管壁纸模糊与表面雾，不再改它们的半径）。 */
+			const blurFollowUnify = section.blurFollowUnify !== void 0 ? !!section.blurFollowUnify : DEFAULT_BLUR_FOLLOW_UNIFY;
+			const unifyFollowNow = unifyTint && blurFollowUnify;
 			// ①(重做) 统一虚化：unifyTint 开时 unifyAmount 控制**壁纸层真实 blur**（虚化程度）：
 			// 0px = 壁纸清晰，40px = 强模糊。表面白雾统一由「不透明度」条（panel）控制
 			//（不再把 unifyAmount 映射成透明度——那只是"改白雾厚度"，不是"改虚化程度"）。
 			const unifyAmount = section.unifyAmount !== void 0 ? section.unifyAmount : DEFAULT_UNIFY_AMOUNT;
 			// 侧边栏/标题栏白雾厚度：统一虚化开 → sidebarAlpha 独立条；关 → 各区域原值
-			const uAlpha = Math.max(0, Math.min(100, (section.sidebarAlpha !== void 0 ? section.sidebarAlpha : DEFAULT_SIDEBAR_ALPHA)));
+			// ①(2026-10-02 第1项真机语义收口) **整屏虚化程度 = 0 ⇒ 外壳实心**：
+			//   没有模糊时再把"原始（未模糊）壁纸"透出来，观感就是"两个条都拉到 0，
+			//   界面却变成半透明、还带壁纸自己的颜色"——用户报的正是这一条（真机设置：
+			//   unifyAmount=0 + sidebarAlpha=0 + chatFollow=false ⇒ 左侧边栏整块透出壁纸）。
+			//   所以 amount = 0 时把外壳厚度钉到 100（实心）；只有 amount > 0（真的在虚化）时，
+			//   「左侧边栏/标题栏透明度」才决定"透出多少模糊壁纸"。
+			//   ⚠️ 取色（面板取色/统一雾）的 alpha **不看这个钳制**：它仍按那条滑条的原始值给，
+			//   所以厚度 0 时不会有任何采样色层（见 mpwFogModel 与 fog-model D 组判据）。
+			const uAlphaRaw = Math.max(0, Math.min(100, (section.sidebarAlpha !== void 0 ? section.sidebarAlpha : DEFAULT_SIDEBAR_ALPHA)));
+			const uAlpha = Number(unifyAmount) > 0 ? uAlphaRaw : 100;
 			const U = (v) => unifyTint ? uAlpha : v;
 			/* ①(2026-09-18 §5「功能静默无效」第 2 条 / 用户裁定候选 A)「新会话按钮跟随面板不透明度」：
 			   开 = 跟随那条透明度（现状公式 U(panel)：统一虚化开=sidebarAlpha，关=panel）；
@@ -16697,8 +16824,9 @@ body:not([data-ds-dark-theme]) .mpw_dialog {
 `;
 			}
 			// ── E. 侧边栏磨砂（sidebarBlur，Aqua 方案）──
-			// unify 开时由整屏虚化（壁纸层 blur）接管，不输出自身 backdrop-filter（避免双重模糊）
-			if (sidebarFrosted && !unifyTint) {
+			// unify 开（且「界面虚化跟随统一虚化」开着）时由整屏虚化（壁纸层 blur）接管，
+			// 不输出自身 backdrop-filter（避免双重模糊）；跟随开关关掉 ⇒ 恢复自己那条半径。
+			if (sidebarFrosted && !unifyFollowNow) {
 				const sblFilter = `blur(${sidebarBlurAmount}px)`;
 				css += `
 /* ── 侧边栏磨砂（Aqua 方案：sidebarCol 自身 backdrop-filter） ──
@@ -16826,9 +16954,16 @@ html body:has([class*="_modal"]) [data-mpw-rs] {
 			//   5) 变量由 JS 写入 :root，改设置只改变量、不动 DOM。
 			if (bdSupported) {
 				// sidebarBlur 是布尔（是否启用侧栏磨砂），数值在 sidebarBlurAmount；未启用时退回统一虚化程度
-				const chromeBlur = Math.max(0, Math.round((sidebarBlur ? sidebarBlurAmount : unifyAmount) || 0));
+				// ①(2026-10-02 第3项) 跟随开关开 ⇒ 统一虚化接管（半径一律 unifyAmount，
+				//   不再被 sidebarBlur 的数值分走）；关 ⇒ 保持历史公式（侧栏磨砂开就用它自己的数值）。
+				const chromeBlur = Math.max(0, Math.round((unifyFollowNow ? unifyAmount : (sidebarBlur ? sidebarBlurAmount : unifyAmount)) || 0));
 				const chromeAlphaRaw = (section && section.sidebarAlpha !== void 0) ? section.sidebarAlpha : DEFAULT_SIDEBAR_ALPHA;
-				const chromeAlpha = Math.max(0, Math.min(1, Number(chromeAlphaRaw) / 100));
+				/* ①(2026-10-02 第1项) 与 buildCss 的 uAlpha 同一条纪律、同一判据：
+				   统一虚化开着但「整屏虚化程度」= 0（不虚化）⇒ chrome 表面实心（alpha 1），
+				   否则左栏/标题栏会把**原始未模糊**的壁纸透出来（用户第1项真机反馈）。
+				   统一虚化关着时保持历史语义：sidebarAlpha 决定"透出多少模糊壁纸"。 */
+				const chromeAlphaPct = (unifyTint && !(Number(unifyAmount) > 0)) ? 100 : Number(chromeAlphaRaw);
+				const chromeAlpha = Math.max(0, Math.min(1, Number(chromeAlphaPct) / 100));
 				const chromeBg = (typeof unifyTint === 'string' && unifyTint) ? unifyTint : '255,255,255';
 				const rsAmt2 = Math.max(0, Math.round(typeof rsAmount === 'number' ? rsAmount : 18));
 				const rsAlpha2 = Math.max(0, Math.min(1, (typeof rsAlpha === 'number' ? rsAlpha : 60) / 100));
@@ -16846,6 +16981,37 @@ html body:has([class*="_modal"]) [data-mpw-rs] {
 				tok("--mpw-surface-rs-dock", `rgba(${chromeBg === '255,255,255' ? '255,255,255' : chromeBg}, calc(var(--mpw-rs-alpha) * 0.55))`);
 				/* 右侧栏 / dockkit 面板表面（暗色底 + 30% 档） */
 				tok("--mpw-surface-rs-dock-dark", "rgba(18, 22, 30, calc(var(--mpw-rs-alpha) * 0.75))");
+				/* ①(2026-10-02 第2项) 统一虚化接管时的**共同表面**：与左栏同色同厚度同半径。
+				   三枚 token 只在接管时被下面那块 CSS 引用；不接管时它们不生效（无引用）。
+				   厚度直接取雾模型（= 左侧边栏/标题栏透明度），0 ⇒ rgba(...,0) = 完全透明，
+				   所以"统一虚化程度/透明度都拉到 0"时右栏/dock 也是干净的透出，不留采样色。 */
+				const fogCss = mpwFogModel(section);
+				const unifyTakeover = unifyFollowNow && hasImage;
+				const unifyBlurCss = fogCss.amountPx > 0 ? `blur(${fogCss.amountPx}px) saturate(140%)` : "none";
+				/* ⚠️ 三枚 token **只在接管时**输出：不接管时产物里连变量名都不该出现
+				   （tools/fog-model-test 的 B3/E3 判据：不跟随时 `--mpw-unify-*` 必须为 0 处），
+				   否则"有一枚没人用的 token"会被当成"接管逻辑还在"。 */
+				if (unifyTakeover) {
+					tok("--mpw-unify-blur", fogCss.amountPx + "px");
+					tok("--mpw-unify-surface", `rgba(255, 255, 255, ${(fogCss.shellPct / 100).toFixed(3)})`);
+					tok("--mpw-unify-surface-dark", `rgba(18, 22, 30, ${(fogCss.shellPct / 100).toFixed(3)})`);
+				}
+				/* ①(2026-10-02 第2项) better-sidebar 那几条规则**受 bsCompat 总闸门控**（见下方注释）：
+				   用户手动关掉适配时产物里不许出现 [data-dsh-better-sidebar] 选择器。
+				   只改底色、不给 backdrop-filter（面板带 backdrop-filter 会困住内部 fixed 内容）。 */
+				const bsCompatTakeover = section && (section.bsCompat !== void 0 ? !!section.bsCompat : DEFAULT_BS_COMPAT);
+				const bsTakeoverSurface = !unifyTakeover || !bsCompatTakeover ? "" : `
+html body[data-mpw-unify] [data-dsh-better-sidebar] [class*="_panel"]:not([class*="_panelBody"]):not([data-dsh-bottom-panel]),
+html body[data-mpw-unify] [data-dsh-better-sidebar] [class*="_bottomPanel"],
+html body[data-mpw-unify] [data-dsh-better-sidebar] [data-dsh-bottom-panel] {
+	background-color: var(--mpw-unify-surface) !important;
+}
+html body[data-ds-dark-theme][data-mpw-unify] [data-dsh-better-sidebar] [class*="_panel"]:not([class*="_panelBody"]):not([data-dsh-bottom-panel]),
+html body[data-ds-dark-theme][data-mpw-unify] [data-dsh-better-sidebar] [class*="_bottomPanel"],
+html body[data-ds-dark-theme][data-mpw-unify] [data-dsh-better-sidebar] [data-dsh-bottom-panel] {
+	background-color: var(--mpw-unify-surface-dark) !important;
+}
+`;
 				css += `
 /* ── H. 玻璃统一块（CSS-first）：标题栏 / 左侧栏 / 右侧栏(dockkit) ──
    ①(2026-09-18 §5 第1项) 本块不再自建 :root —— 表面 token 全部由 emitSurfaceTokens()
@@ -17161,6 +17327,57 @@ html body[data-mpw-float]:not([data-mpw-traject-clip="off"]) [class*="_overview"
 	overflow-x: auto !important;            /* 需要时总览自己内部横滚，而不是画到面板外 */
 	overscroll-behavior-x: contain !important;
 }
+${unifyTakeover ? `
+/* ═══ ①(2026-10-02 第2项) 统一虚化：右栏 / dock / better-sidebar 与左栏**统一** ═══
+   为什么单独立这一块：F 块（右栏/dock）与 H 块的右栏规则走的是"自己那套"参数
+   （--mpw-rs-blur / --mpw-rs-alpha ←「右侧边栏/dock 虚化」开关+两条滑条），
+   而设置界面早已写着「统一虚化开启中：右侧边栏/dock 虚化由『整屏虚化程度』+『透明度』
+   接管」—— 文案与实现不符（用户第2项：统一虚化只管了左栏/标题栏）。
+   现在接管真的做出来：这些表面与左栏**读同一套 token**（同色 + 同厚度 + 同半径），
+   于是"整屏虚化程度 + 左侧边栏/标题栏透明度"一改，右栏/dock 一起变。
+   位置在本块最后（与前文选择器同特异性时后者胜）⇒ 不需要额外的权重技巧。 */
+html body[data-mpw-unify] [data-sidebar-right-panel],
+html body[data-mpw-unify] [data-sidebar-right-float-host],
+html body[data-mpw-unify] [data-mpw-rs],
+html body[data-mpw-unify] [data-dockkit-pane],
+html body[data-mpw-unify] [data-dockkit-strip],
+html body[data-mpw-unify] [data-dockkit-surface],
+html body[data-mpw-unify] [data-dockkit-float] {
+	-webkit-backdrop-filter: ${unifyBlurCss} !important;
+	backdrop-filter: ${unifyBlurCss} !important;
+	background-color: var(--mpw-unify-surface) !important;
+}
+html body[data-ds-dark-theme][data-mpw-unify] [data-sidebar-right-panel],
+html body[data-ds-dark-theme][data-mpw-unify] [data-sidebar-right-float-host],
+html body[data-ds-dark-theme][data-mpw-unify] [data-mpw-rs],
+html body[data-ds-dark-theme][data-mpw-unify] [data-dockkit-pane],
+html body[data-ds-dark-theme][data-mpw-unify] [data-dockkit-strip],
+html body[data-ds-dark-theme][data-mpw-unify] [data-dockkit-surface],
+html body[data-ds-dark-theme][data-mpw-unify] [data-dockkit-float] {
+	background-color: var(--mpw-unify-surface-dark) !important;
+}
+/* better-sidebar 的面板 / 底部工作台：**只跟雾色与厚度，不给 backdrop-filter**。
+   依据它自己的适配笔记（docs/BETTER-SIDEBAR-COMPAT.md / bsReveal 段注释）：
+   面板带 backdrop-filter 会成为内部 fixed 内容的 containing block（"困内容"）⇒ 只改底色。
+   ①(2026-10-02) 整段**受 bsCompat 总闸门控**：用户手动关掉 better-sidebar 适配时，
+   产物里连一条 [data-dsh-better-sidebar] 规则都不许有（tools/bs-compat-default-test
+   的「尊重用户手动关」判据），所以这里单独插值，不能塞进上面那块无条件规则里。 */
+${bsTakeoverSurface}
+/* 接管同样要"让位"：弹窗/设置面板打开时撤掉 backdrop-filter
+   （含 backdrop-filter 的节点是 fixed 弹层的 containing block ⇒ 面板尺寸会被压缩）。
+   与上文 H 块的抑制规则同款，只是把新加的这些表面也覆盖上。 */
+html body[data-mpw-unify]:has([class*="_overlay"]) [data-sidebar-right-panel],
+html body[data-mpw-unify]:has([class*="_overlay"]) [data-dockkit-pane],
+html body[data-mpw-unify]:has([class*="_overlay"]) [data-dockkit-strip],
+html body[data-mpw-unify]:has([class*="_overlay"]) [data-dockkit-surface],
+html body[data-mpw-unify]:has([class*="_modal"]) [data-sidebar-right-panel],
+html body[data-mpw-unify]:has([class*="_modal"]) [data-dockkit-pane],
+html body[data-mpw-unify]:has([class*="_modal"]) [data-dockkit-strip],
+html body[data-mpw-unify]:has([class*="_modal"]) [data-dockkit-surface] {
+	-webkit-backdrop-filter: none !important;
+	backdrop-filter: none !important;
+}
+` : ""}
 `;
 			}
 			// ②(新) 弹层虚化（菜单/提示/data-surface，独立于对话框）
@@ -17414,9 +17631,12 @@ body[data-mpw-accent] [data-slot*="composer"] [class*="primary"] {
    ①(修正2) 标题栏是否刷 mask 色由 JS 打 data-mpw-aqua-header 门控：
    纯 aquaInk（自适应文字色）时不刷——此时遮罩色=主题中性色（亮色主题=白），
    会把标题栏刷成 62% 白 → session log/标准模式背后的「白框」（用户实测：
-   统一虚化 + 自适应文字色同时开出现）。 */
+   统一虚化 + 自适应文字色同时开出现）。
+   ①(2026-10-02 第1项) 刷多厚由 **雾厚度** 决定（--mpw-aqua-header-alpha，JS 按
+   「左侧边栏/标题栏透明度」写；厚度 0 ⇒ 0% = 一个像素都不刷）。原来写死 62%
+   ⇒ 用户把透明度拉到 0 时标题栏仍被壁纸采样色盖住。 */
 body[data-mpw-aqua][data-mpw-aqua-header] .wSkVaW_header {
-	background-color: color-mix(in srgb, rgb(var(--mpw-aqua-rgb)) 62%, transparent) !important;
+	background-color: color-mix(in srgb, rgb(var(--mpw-aqua-rgb)) var(--mpw-aqua-header-alpha, 62%), transparent) !important;
 	backdrop-filter: none !important;
 }
 body[data-mpw-aqua] .wSkVaW_header {
@@ -20039,6 +20259,7 @@ body[data-mpw-modal] [role="dialog"] {
 					popoverBlur: DEFAULT_POPOVER_BLUR, popoverAmount: DEFAULT_POPOVER_AMOUNT,
 					maskBlur: DEFAULT_MASK_BLUR, maskAmount: DEFAULT_MASK_AMOUNT,
 					unifyTint: DEFAULT_UNIFY_TINT, unifyAmount: DEFAULT_UNIFY_AMOUNT, sidebarAlpha: DEFAULT_SIDEBAR_ALPHA, chatFollow: DEFAULT_CHAT_FOLLOW, sessionFollow: DEFAULT_SESSION_FOLLOW,
+					blurFollowUnify: DEFAULT_BLUR_FOLLOW_UNIFY, // ①(2026-10-02 第3项) 恢复默认 = 回到"界面虚化跟随统一虚化"
 					aquaMask: DEFAULT_AQUA_MASK, aquaTint: DEFAULT_AQUA_TINT, aquaInk: DEFAULT_AQUA_INK, aquaColor: "", aquaInkColor: "", aquaTextEnhance: DEFAULT_AQUA_TEXT_ENHANCE, todoBlur: DEFAULT_TODO_BLUR, aquaMaskAlpha: DEFAULT_AQUA_MASK_ALPHA, aquaTintStrength: DEFAULT_AQUA_TINT_STRENGTH, themeColor: DEFAULT_THEME_COLOR,
 					hybrid: DEFAULT_HYBRID, roundCompat: DEFAULT_ROUND_COMPAT,
 					rotate: DEFAULT_ROTATE, rotateMin: 5, customDirPath: "", brightness: DEFAULT_BRIGHTNESS, float: DEFAULT_FLOAT,
@@ -20062,7 +20283,7 @@ body[data-mpw-modal] [role="dialog"] {
 				"headerFrostOwn", "headerFrostAmount", "popoverAlpha", "sceneReport",
 				"sceneWatchdog", "sceneWatchdogSecs", "sceneDebugParams", // ①(批次15 B1/B3) 四处接线②：备份导出/导入
 				"dialogBlur", "dialogAmount", "popoverBlur", "popoverAmount", "maskBlur", "maskAmount",
-				"unifyTint", "unifyAmount", "sidebarAlpha", "chatFollow", "sessionFollow",
+				"unifyTint", "unifyAmount", "sidebarAlpha", "chatFollow", "sessionFollow", "blurFollowUnify",
 				"aquaMask", "aquaTint", "aquaInk", "aquaColor", "aquaInkColor", "aquaTextEnhance", "todoBlur",
 				"aquaMaskAlpha", "aquaTintStrength", "themeColor", "accent", "glassColor", "glassAlpha",
 				"hybrid", "roundCompat", "rotate", "rotateMin", "rotGroups", "rotGroupId", "rotSeeded",
@@ -20108,7 +20329,7 @@ body[data-mpw-modal] [role="dialog"] {
 						// ①(修正) 类型校验（评审指出：原实现直接透传，`opacity:"abc"` 会污染设置）：
 						// 数值类必须为有限数、布尔类必须为 boolean、字符串类必须为 string。
 						const numFields = ["opacity", "blur", "zoom", "headerBlurAmount", "headerFrostAmount", "dialogAmount", "popoverAmount", "popoverAlpha", "maskAmount", "unifyAmount", "sidebarAlpha", "aquaMaskAlpha", "aquaTintStrength", "glassAlpha", "lgCssAmount", "rotateMin", "brightness", "playbackRate", "clockSize", "fpsCap", "resMax", "preScale", "bsRevealAlpha", "sceneWatchdogSecs", "npVolume"]; // ①(批次15) 四处接线③：导入数值净化；①(NP-4)① 追加 npVolume
-						const boolFields = ["sidebar", "sharp", "headerBlur", "headerBg", "rightSidebarBlur", "dialogBlur", "popoverBlur", "maskBlur", "unifyTint", "chatFollow", "sessionFollow", "aquaMask", "aquaTint", "aquaInk", "aquaTextEnhance", "todoBlur", "hybrid", "roundCompat", "rotate", "float", "newStyle", "mute", "thinkBg", "enabled", "forceEnabled", "clock", "clock24h", "clockSec", "clockDate", "bsCompat", "bsFloat", "bsFont", "bsReveal", "bsAlpha", "bsAqua", "bsBottomAvoid", "lgTest", "lgCss", "lgComposer", "lgSidebar", "lgHeader", "powPauseHidden", "powPauseBlur", "powPauseBattery", "sceneWatchdog", "npNowPlaying", "npLinkWallpaper", "npPaused"]; // ①(批次15) 四处接线④：导入布尔净化；①(NP-1) 末尾追加 npNowPlaying；①(NP-4)② 追加 npLinkWallpaper；①(NP-5) 追加 npPaused
+						const boolFields = ["sidebar", "sharp", "headerBlur", "headerBg", "rightSidebarBlur", "dialogBlur", "popoverBlur", "maskBlur", "unifyTint", "blurFollowUnify", "chatFollow", "sessionFollow", "aquaMask", "aquaTint", "aquaInk", "aquaTextEnhance", "todoBlur", "hybrid", "roundCompat", "rotate", "float", "newStyle", "mute", "thinkBg", "enabled", "forceEnabled", "clock", "clock24h", "clockSec", "clockDate", "bsCompat", "bsFloat", "bsFont", "bsReveal", "bsAlpha", "bsAqua", "bsBottomAvoid", "lgTest", "lgCss", "lgComposer", "lgSidebar", "lgHeader", "powPauseHidden", "powPauseBlur", "powPauseBattery", "sceneWatchdog", "npNowPlaying", "npLinkWallpaper", "npPaused"]; // ①(批次15) 四处接线④：导入布尔净化；①(NP-1) 末尾追加 npNowPlaying；①(NP-4)② 追加 npLinkWallpaper；①(NP-5) 追加 npPaused；①(2026-10-02) 追加 blurFollowUnify
 						const strFields = ["aquaColor", "aquaInkColor", "themeColor", "accent", "glassColor", "clockPos", "fontColorGrayColor", "sceneDebugParams"]; // ①(批次15) sceneDebugParams 走字符串净化（非法键/值在写入端丢弃）
 						for (const k of BACKUP_FIELDS) {
 							const v = settings[k];
@@ -20777,6 +20998,12 @@ body[data-mpw-modal] [role="dialog"] {
 			// ①(修正) 第5项：面板颜色匹配壁纸（aquaTint）开关状态 —— 开时「遮罩自定义色」
 			// 取色盘禁用变灰（二选一：自动匹配 vs 手动取色）。
 			const aquaTintOn = section.aquaTint !== void 0 ? !!section.aquaTint : DEFAULT_AQUA_TINT;
+			/* ①(2026-10-02 第3项) 「界面虚化是否跟随统一虚化」的**渲染派生量**（单一判据）：
+			   与 buildCss / mpwFogModel 同源（unifyTint && blurFollowUnify）——
+			   设置行里凡是"被接管"的变灰/强制开/接管提示，都用它门控，避免又出现
+			   "文案说接管了、实现没接管"（或反之）的不一致。 */
+			const followUnifyNow = (section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT)
+				&& (section.blurFollowUnify !== void 0 ? !!section.blurFollowUnify : DEFAULT_BLUR_FOLLOW_UNIFY);
 			let ffStatus = null;        // 状态区文本（null 不显示额外状态行）
 			let ffShowDownload = false; // 是否显示下载按钮（missing / downloading 都显示）
 			let ffShowUninstall = false; // ①(新) 是否显示卸载按钮（仅 cached 来源；不碰系统/env）
@@ -21831,15 +22058,14 @@ body[data-mpw-modal] [role="dialog"] {
 				//   统一虚化开启时：开关+程度条被接管（禁用变灰），并在本项下方就地给接管说明（第6项）。
 				h("div", { style: { display: (section.sidebar !== void 0 ? !!section.sidebar : DEFAULT_SIDEBAR) ? "" : "none" } }, [
 					toggleRow(t("sidebarBlur"), t("sidebarBlur.desc"), "sidebarBlur", DEFAULT_SIDEBAR_BLUR,
-						(section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT),
-						(section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT)),
+						followUnifyNow, followUnifyNow),
 					h("div", { style: {
 						display: (section.sidebarBlur !== void 0 ? !!section.sidebarBlur : DEFAULT_SIDEBAR_BLUR) ? "" : "none",
-						opacity: (section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT) ? 0.45 : 1,
-						pointerEvents: (section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT) ? "none" : "auto"
+						opacity: followUnifyNow ? 0.45 : 1,
+						pointerEvents: followUnifyNow ? "none" : "auto"
 					} },
 						sliderRow(t("sidebarBlurAmount"), "sidebarBlurAmount", 0, 40, "px", 1, DEFAULT_SIDEBAR_BLUR_AMOUNT)),
-					(section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT)
+					followUnifyNow
 						? h("p", { className: "mpw_hint" }, t("sidebarBlur.overridden"))
 						: null,
 				]),
@@ -21857,15 +22083,14 @@ body[data-mpw-modal] [role="dialog"] {
 				// 开关（headerBg/headerBlur）仍独立：透出关 = 纯白背景。
 				h("div", { style: { display: (section.headerBg !== void 0 ? !!section.headerBg : DEFAULT_HEADER_BG) ? "" : "none" } },
 					toggleRow(t("headerBlur"), t("headerBlur.desc"), "headerBlur", DEFAULT_HEADER,
-						(section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT),
-						(section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT))),
+						followUnifyNow, followUnifyNow)),
 				h("div", { style: {
 					display: (section.headerBg !== void 0 ? !!section.headerBg : DEFAULT_HEADER_BG) && (section.headerBlur !== void 0 ? !!section.headerBlur : DEFAULT_HEADER) ? "" : "none",
-					opacity: (section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT) ? 0.45 : 1,
-					pointerEvents: (section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT) ? "none" : "auto"
+					opacity: followUnifyNow ? 0.45 : 1,
+					pointerEvents: followUnifyNow ? "none" : "auto"
 				} },
 					sliderRow(t("headerBlurAmount"), "headerBlurAmount", 0, 100, "%", 1, DEFAULT_HEADER_BLUR_AMOUNT)),
-				(section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT)
+				followUnifyNow
 					? h("p", { className: "mpw_hint" }, t("headerBlur.overridden"))
 					: null,
 				// ①(新 2026-09-13 用户要求) 「标题栏磨砂强度」独立滑条：
@@ -21877,20 +22102,10 @@ body[data-mpw-modal] [role="dialog"] {
 				} },
 					sliderRow(t("headerFrostAmount"), "headerFrostAmount", 0, 60, "px", 1, DEFAULT_HEADER_FROST_AMOUNT)),
 
-				// ①(修正 2026-09-13 第1项) 右侧边栏/dock 虚化：纳入统一虚化接管（与侧边栏/标题栏同款提示）
-				toggleRow(t("rightSidebarBlur"), t("rightSidebarBlur.desc"), "rightSidebarBlur", DEFAULT_RIGHT_SIDEBAR_BLUR,
-					(section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT),
-					(section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT)),
-				h("div", { style: {
-					display: (section.rightSidebarBlur !== void 0 ? !!section.rightSidebarBlur : DEFAULT_RIGHT_SIDEBAR_BLUR) ? "" : "none",
-					opacity: (section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT) ? 0.45 : 1,
-					pointerEvents: (section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT) ? "none" : "auto"
-				} },
-					sliderRow(t("rightSidebarBlurAmount"), "rightSidebarBlurAmount", 0, 40, "px", 1, DEFAULT_RIGHT_SIDEBAR_AMOUNT),
-					sliderRow(t("rightSidebarAlpha"), "rightSidebarAlpha", 0, 100, "%", 1, DEFAULT_RIGHT_SIDEBAR_ALPHA)),
-				(section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT)
-					? h("p", { className: "mpw_hint" }, t("rightSidebarBlur.overridden"))
-					: null,
+				// ①(2026-10-02 第4项) 「右侧边栏/dock 虚化」整组**迁到「界面虚化」页**：
+				//   它是"某个区域的背景虚化"，与该页的对话框/弹层/遮罩同类；放在"外观"页时
+				//   用户找不到（用户第4项：右侧边栏/Dock 虚化属于界面虚化）。原来这里的两行
+				//   开关+两条滑条已原样搬到 blur tab 的「右侧边栏 / Dock」分组。
 
 
 				]),
@@ -21933,6 +22148,13 @@ body[data-mpw-modal] [role="dialog"] {
 				]),
 				// ═══ 界面虚化 ═══
 				h("div", { "data-mpw-tabkey": "blur", style: { flex: "0 0 100%", minWidth: "100%", boxSizing: "border-box", paddingRight: "4px" } }, [
+				// ①(2026-10-02 第3项) **说明行 + 跟随开关放在 tab 栏与「界面虚化」标题之间**：
+				//   用户先读到"这一页的虚化程度默认由统一虚化接管"，再看到具体滑条；
+				//   开关默认开(=跟随)，与 buildCss/mpwFogModel 同源（DEFAULT_BLUR_FOLLOW_UNIFY）。
+				//   ⚠️ toggleRow 含 hooks ⇒ 必须常挂载（这里无条件渲染；统一虚化关时只禁用，不卸载）。
+				h("p", { className: "mpw_hint", style: { marginTop: 0 } }, t("blur.follow.hint")),
+				toggleRow(t("blurFollowUnify"), t("blurFollowUnify.desc"), "blurFollowUnify", DEFAULT_BLUR_FOLLOW_UNIFY,
+					!(section.unifyTint !== void 0 ? !!section.unifyTint : DEFAULT_UNIFY_TINT)),
 				h("div", { className: "mpw_section" }, t("sec.blur")),
 				h("p", { className: "mpw_hint" }, t("sec.blur.desc")),
 
@@ -21970,6 +22192,26 @@ body[data-mpw-modal] [role="dialog"] {
 				h("div", { style: { display: (section.maskBlur !== void 0 ? !!section.maskBlur : DEFAULT_MASK_BLUR) ? "" : "none" } },
 					sliderRow(t("maskBlurAmount"), "maskAmount", 0, 40, "px", 1, DEFAULT_MASK_AMOUNT)),
 
+				// ── 右侧边栏 / Dock（①(2026-10-02 第4项) 从「外观」页迁来：它属于本页）──
+				//   统一虚化开启且「跟随」开着时整组被接管（开关强制开+变灰，滑条变灰），
+				//   并在下方就地给出接管说明；关掉上面的跟随开关即可恢复本组可调。
+				h("div", { className: "mpw_section", style: { marginTop: 18 } }, t("sec.blurRight")),
+				h("p", { className: "mpw_hint" }, t("sec.blurRight.desc")),
+				toggleRow(t("rightSidebarBlur"), t("rightSidebarBlur.desc"), "rightSidebarBlur", DEFAULT_RIGHT_SIDEBAR_BLUR,
+					followUnifyNow, followUnifyNow),
+				h("div", { style: {
+					display: (section.rightSidebarBlur !== void 0 ? !!section.rightSidebarBlur : DEFAULT_RIGHT_SIDEBAR_BLUR) ? "" : "none",
+					opacity: followUnifyNow ? 0.45 : 1,
+					pointerEvents: followUnifyNow ? "none" : "auto"
+				} },
+					sliderRow(t("rightSidebarBlurAmount"), "rightSidebarBlurAmount", 0, 40, "px", 1, DEFAULT_RIGHT_SIDEBAR_AMOUNT),
+					h("p", { className: "mpw_hint", style: { marginTop: -4 } }, t("rightSidebarBlurAmount.desc")),
+					sliderRow(t("rightSidebarAlpha"), "rightSidebarAlpha", 0, 100, "%", 1, DEFAULT_RIGHT_SIDEBAR_ALPHA),
+					h("p", { className: "mpw_hint", style: { marginTop: -4 } }, t("rightSidebarAlpha.desc"))),
+				followUnifyNow
+					? h("p", { className: "mpw_hint" }, t("rightSidebarBlur.overridden"))
+					: null,
+
 				]),
 				// ═══ 其他 ═══
 				h("div", { "data-mpw-tabkey": "other", style: { flex: "0 0 100%", minWidth: "100%", boxSizing: "border-box", paddingRight: "4px" } }, [
@@ -22466,8 +22708,6 @@ body[data-mpw-modal] [role="dialog"] {
 			"none": "无",
 			"pause.pause": "暂停壁纸",
 			"pause.play": "播放壁纸",
-			"pause.pause": "暂停壁纸",
-			"pause.play": "播放壁纸",
 			"refresh.bg": "刷新壁纸",
 			"refresh.done": "壁纸已刷新",
 			"master.desc": "开启后应用所选背景",
@@ -22491,7 +22731,6 @@ body[data-mpw-modal] [role="dialog"] {
 			"web.confirmBody": "网页壁纸可能卡顿或无法加载",
 			"web.riskHeavy": "⚠ 预检：Spine/L2D 骨骼动画壁纸，低性能设备上可能卡住界面",
 			"web.riskExternal": "⚠ 预检：依赖外网资源（SDK/CDN），加载可能失败",
-			"web.confirmBody": "网页壁纸可能卡顿或无法加载",
 			"web.confirmHint": "部分网页壁纸（事件页/动效重）会在低性能设备上卡住界面；卡住时刷新页面即可恢复（不会自动重新加载）。若加载失败，壁纸会显示黑底并出现刷新按钮——那是壁纸自身的内容，属正常现象。",
 			"web.confirmShim": "沙箱模式（推荐）",
 			"web.confirmCompat": "兼容模式（同源）",
@@ -22563,9 +22802,14 @@ body[data-mpw-modal] [role="dialog"] {
 			"sec.appearance": "外观",
 			"sec.appearance.desc": "面板不透明度=所有区域白雾厚度；磨砂模糊=整张壁纸的模糊程度（0=清晰）；镜头缩放/位置=背景画面的放大与平移（缩小可看到画面边缘的组件）",
 			"sec.blur": "界面虚化",
-			"sec.blur.desc": "各类弹层/面板打开时的背景虚化：对话框（通用居中窗口+聊天输入框）、设置面板、下载确认弹窗各自独立；弹层=菜单/下拉/提示；遮罩=弹层背后的全屏背景；左侧边栏磨砂=左侧边栏自身玻璃化",
+			"sec.blur.desc": "各区域的背景虚化：对话框（通用居中窗口+聊天输入框）、设置面板、下载确认弹窗各自独立；弹层=菜单/下拉/提示；遮罩=弹层背后的全屏背景；右侧边栏/dock=DSH 自带右栏与底部浮层。默认「跟随统一虚化」：统一虚化开着时，被接管的项（左侧边栏磨砂/标题栏磨砂/右侧边栏·dock）由「整屏虚化程度 + 左侧边栏/标题栏透明度」统一驱动。",
+			"blurFollowUnify": "界面虚化跟随统一虚化",
+			"blurFollowUnify.desc": "开（默认）＝本页里被接管的项（左侧边栏磨砂、标题栏磨砂、右侧边栏/dock 虚化）交给统一虚化统一驱动，整屏一致；关＝这些项各自独立可调，统一虚化只管壁纸模糊与各表面白雾，不再改它们的半径。",
+			"blur.follow.hint": "下面这组「界面虚化」的虚化程度默认由「界面统一」页的滑条统一接管（统一虚化开启时）；想让它们各自独立调节，请关掉下面这个开关。未被接管的项（对话框/设置面板/下载确认/弹层/遮罩）始终独立生效。",
+			"sec.blurRight": "右侧边栏 / Dock",
+			"sec.blurRight.desc": "DSH 自带的右侧边栏与底部 dock 浮层（含 better-sidebar 的面板与底部工作台）。跟随统一虚化时本组由统一虚化接管，且与左侧边栏使用同一套表面颜色与厚度。",
 			"sec.unify": "界面统一",
-			"sec.unify.desc": "整屏界面外观统一管理，两类效果互不干扰：①统一虚化=壁纸模糊度+白雾厚度（左侧边栏/标题栏整体毛玻璃）；②统一雾=全屏色调雾罩（所有表面共享一种雾色/浓度）。开启后「界面虚化」里的左侧边栏磨砂被接管",
+			"sec.unify.desc": "整屏界面外观统一管理，两类效果互不干扰：①统一虚化=壁纸模糊度+白雾厚度（左侧边栏/标题栏/右侧边栏/dock 等整个界面外壳一起毛玻璃）；②统一雾=全屏色调雾罩（所有表面共享一种雾色/浓度）。统一虚化开启时，「界面虚化」页里被点名的项由这里的两个条接管（可在那一页关掉「跟随统一虚化」让它们独立）。",
 			"sec.unifyFog": "统一雾（色调）",
 			"sec.unifyFog.desc": "全屏纯色雾罩：所有表面（左侧边栏/标题栏/聊天区/按钮）共享一种雾色与浓度，让整屏色调统一；关 = 保持原有分区配色",
 			"sec.show": "透出壁纸",
@@ -22906,12 +23150,13 @@ body[data-mpw-modal] [role="dialog"] {
 			"headerFrostAmount": "标题栏磨砂强度",
 			
 			"unifyTint": "统一虚化",
-			"unifyTint.desc": "开启后，左侧边栏获得类似聊天框的毛玻璃虚化（整块模糊、无缝隙），强度由「整屏虚化程度」条控制；左侧边栏表面白雾厚度由「左侧边栏透明度」条控制；标题栏始终按自己的磨砂条（默认透明）。关闭后各区域单独调节",
+			"unifyTint.desc": "开启后，整个界面外壳（左侧边栏/标题栏/右侧边栏/dock）一起变成毛玻璃：模糊半径由「整屏虚化程度」控制，表面白雾厚度由「左侧边栏/标题栏透明度」控制；「界面虚化」页里被点名的项默认跟随这两个条（可在那一页关掉「跟随统一虚化」让它们独立）。关闭后各区域单独调节",
 			"unifyAmount": "整屏虚化程度",
+			"unifyAmount.desc": "整屏的模糊半径（px）：0 = 不虚化（壁纸完全清晰，标题栏/侧边栏/右栏/dock 也回到实心，不会再把原始壁纸透出来）；40 = 强毛玻璃。统一虚化开启时这是整个界面外壳唯一的模糊来源。",
 			"sidebarAlpha": "左侧边栏/标题栏透明度",
-			"sidebarAlpha.desc": "统一虚化开启时：左侧边栏表面的白雾厚度（0 = 全透明透出模糊壁纸，100 = 实心）。与「整屏虚化程度」解耦，可单独调；标题栏不再跟随（按自己的磨砂条）",
+			"sidebarAlpha.desc": "各表面白雾的厚度（%）：0 = 完全透明（只看到**模糊**壁纸，不留雾、不留取色）；100 = 完全不透明。统一虚化开启时，左侧边栏/标题栏/右侧边栏/dock 的表面厚度都由它决定。⚠ 它只在「整屏虚化程度 > 0」时决定观感：程度 = 0（不虚化）时外壳一律实心，避免把未模糊的原始壁纸透出来。",
 			"chatFollow": "聊天区跟随整屏虚化",
-			"chatFollow.desc": "统一虚化开启时：开 = 聊天区壁纸模糊也随「整屏虚化程度」（磨砂条被接管禁用）；关 = 磨砂条恢复可调，聊天区壁纸由磨砂条控制（统一虚化只虚化左侧边栏/标题栏）",
+			"chatFollow.desc": "统一虚化开启时：开 = 聊天区壁纸模糊也随「整屏虚化程度」（磨砂条被接管禁用）；关 = 磨砂条恢复可调，聊天区壁纸由磨砂条控制（统一虚化仍负责界面外壳：左栏/标题栏/右栏/dock）",
 			"sessionFollow": "新会话按钮跟随面板不透明度",
 			"sessionFollow.desc": "统一虚化开启时：「添加新会话」按钮是否随「不透明度」条。关 = 保持原按钮色",
 			"dialogBlur": "虚化对话框",
@@ -22934,13 +23179,14 @@ body[data-mpw-modal] [role="dialog"] {
 			"sidebarBlur": "左侧边栏磨砂",
 			"rightSidebarBlur": "右侧边栏/dock 虚化",
 			"rightSidebarBlurAmount": "虚化程度",
+			"rightSidebarBlurAmount.desc": "右侧边栏/dock 背后壁纸的模糊半径（px）。「界面虚化跟随统一虚化」开着且统一虚化开启时，本项由「整屏虚化程度」接管。",
 			"rightSidebarAlpha": "表面透明度",
-			"rightSidebarBlur.desc": "适配 DSH 0.1.5 自带的右侧边栏与底部 dock 浮层（补打旧类名使其命中同一套虚化规则）。",
+			"rightSidebarAlpha.desc": "右侧边栏/dock 表面白雾的浓淡（%）：0 = 完全透明（只看到壁纸）；100 = 完全不透明。跟随统一虚化时由「左侧边栏/标题栏透明度」接管。",
+			"rightSidebarBlur.desc": "适配 DSH 自带的右侧边栏与底部 dock 浮层（补打旧类名使其命中同一套虚化规则）。跟随统一虚化开启时，本组整体由统一虚化的两个条接管。",
 			"sidebarBlur.desc": "左侧边栏自身玻璃化（backdrop-filter 模糊其背后的壁纸），开启后左侧边栏有类似 Aqua 的磨砂玻璃质感；打开弹窗时自动摘除以防弹窗被左侧边栏模糊层困住",
 			"sidebarBlurAmount": "左侧边栏磨砂程度",
 			"sidebarBlur.overridden": "统一虚化开启中：左侧边栏磨砂由「整屏虚化程度」+「透明度」接管；关闭统一虚化后此开关恢复可调",
-			"rightSidebarBlur.overridden": "Unified blur is on: right sidebar / dock frost is taken over by the screen blur amount + surface opacity; turn Unified blur off to adjust this switch again",
-			"rightSidebarBlur.overridden": "统一虚化开启中：右侧边栏/dock 虚化由「整屏虚化程度」+「透明度」接管；关闭统一虚化后此开关恢复可调",
+			"rightSidebarBlur.overridden": "统一虚化开启中（且「界面虚化跟随统一虚化」开着）：右侧边栏/dock 虚化由「整屏虚化程度」+「左侧边栏/标题栏透明度」接管；在「界面虚化」页关掉跟随开关即可恢复本组可调",
 			"sidebarBlur.needReveal": "需先开启「左侧边栏透出壁纸」才能使用左侧边栏磨砂（受左侧边栏透出控制）",
 			"headerBlur.overridden": "统一虚化开启中：标题栏磨砂由「整屏虚化程度」+「透明度」接管；关闭统一虚化后此开关恢复可调",
 			"thinkBg": "Deep diving 背景方框",
@@ -23138,9 +23384,14 @@ body[data-mpw-modal] [role="dialog"] {
 			"sec.appearance": "Appearance",
 			"sec.appearance.desc": "Panel opacity = frosted tint thickness of all areas; Frosted blur = how blurred the wallpaper itself is (0 = sharp); Lens zoom/position = zoom and pan of the background image (zoom out to see components at the picture edges)",
 			"sec.blur": "UI blur",
-			"sec.blur.desc": "Backdrop blur when each popup layer opens: dialogs (generic center windows + chat input), the settings panel, and download/confirm popups each have their own switch; popovers = menus/dropdowns/tooltips; mask = the full-screen dim behind popups; sidebar frost = the sidebar itself becomes glass",
+			"sec.blur.desc": "Backdrop blur per area: dialogs (generic center windows + chat input), the settings panel and download/confirm popups each have their own switch; popovers = menus/dropdowns/tooltips; mask = the full-screen dim behind popups; right sidebar/dock = the built-in right panel and bottom dock. By default this page follows Unified blur: the taken-over rows (left sidebar frost, title-bar frost, right sidebar/dock) are driven by the Full-screen blur degree + Left sidebar / title-bar opacity.",
+			"blurFollowUnify": "UI blur follows Unified blur",
+			"blurFollowUnify.desc": "On (default) = the taken-over rows on this page (left sidebar frost, title-bar frost, right sidebar/dock blur) are driven by Unified blur so the whole shell matches; Off = those rows become independently adjustable, and Unified blur only owns the wallpaper blur and the surface fog.",
+			"blur.follow.hint": "The frost amounts below are taken over by the two sliders on the “Surface unify” page while Unified blur is on. Turn the switch below off to make them independent. Rows that are not taken over (dialogs / settings panel / download-confirm / popovers / mask) always stay independent.",
+			"sec.blurRight": "Right sidebar / Dock",
+			"sec.blurRight.desc": "The built-in right sidebar and bottom dock overlays (including better-sidebar panels and its bottom workbench). While following Unified blur this group is taken over and shares one surface color and thickness with the left sidebar.",
 			"sec.unify": "Surface unify",
-			"sec.unify.desc": "One place manages the whole-surface look with two independent groups: ①Unified frost = wallpaper blur + fog thickness (sidebar/title-bar frosted glass); ②Unified fog = full-screen color mist shared by every surface. When on, the sidebar frost below is taken over",
+			"sec.unify.desc": "One place manages the whole-surface look with two independent groups: ①Unified blur = wallpaper blur radius + fog thickness (the whole UI shell — left sidebar, title bar, right sidebar, dock — becomes frosted glass together); ②Unified fog = full-screen color mist shared by every surface. While Unified blur is on, the taken-over rows on the “UI blur” page follow these two sliders (turn “UI blur follows Unified blur” off there to decouple them).",
 			"sec.unifyFog": "Unified fog (tint)",
 			"sec.unifyFog.desc": "Full-screen solid-color mist: every surface (sidebar/title bar/chat/buttons) shares one fog color and density for a unified tint; off = keep per-area colors",
 			"sec.show": "Show wallpaper",
@@ -23351,12 +23602,13 @@ body[data-mpw-modal] [role="dialog"] {
 			"headerFrostAmount": "Title bar frost strength",
 			
 			"unifyTint": "Unify blur",
-			"unifyTint.desc": "On: the sidebar gets a chat-box-like frosted blur (one seamless layer, no seams); strength by the Full-screen blur degree; sidebar white-fog thickness by the Sidebar opacity slider; the title bar always follows its own frost slider (transparent by default). Off = per-area control",
+			"unifyTint.desc": "On: the whole UI shell (left sidebar / title bar / right sidebar / dock) becomes one seamless frosted glass; blur radius by the Full-screen blur degree, surface fog thickness by the Left sidebar / title-bar opacity slider. The rows taken over on the UI-blur page follow these two sliders by default (turn “UI blur follows Unified blur” off there to decouple them). Off = per-area control",
 			"unifyAmount": "Full-screen blur degree",
+			"unifyAmount.desc": "Blur radius (px) for the whole screen: 0 = no blur at all (the wallpaper is fully sharp and the title bar / sidebar / right sidebar / dock return to a solid surface — no raw wallpaper showing through); 40 = heavy frosted glass. While Unified blur is on this is the only blur source for the UI shell.",
 			"sidebarAlpha": "Left sidebar / title-bar opacity",
-			"sidebarAlpha.desc": "When unified blur is on: white-fog thickness on the sidebar and title bar (0 = fully transparent showing blurred wallpaper, 100 = solid). Decoupled from the blur degree, adjustable independently",
+			"sidebarAlpha.desc": "Fog thickness (%) on every chrome surface: 0 = fully transparent (the *blurred* wallpaper only — no fog and no wallpaper-sampled tint); 100 = fully opaque. While Unified blur is on it drives the left sidebar, title bar, right sidebar and dock alike. ⚠ It only matters while *Full-screen blur degree* > 0: with the degree at 0 (no blur) the shell stays solid, so the un-blurred wallpaper is never shown through.",
 			"chatFollow": "Chat follows full-screen blur",
-			"chatFollow.desc": "When unified blur is on: On = the chat area wallpaper blur also follows the Full-screen blur degree (frosted slider taken over & disabled); Off = the frosted slider becomes adjustable again, the chat area wallpaper follows it (unified blur only frosts the sidebar/title bar)",
+			"chatFollow.desc": "When unified blur is on: On = the chat area wallpaper blur also follows the Full-screen blur degree (frosted slider taken over & disabled); Off = the frosted slider becomes adjustable again and the chat-area wallpaper follows it (unified blur still owns the UI shell: sidebar / title bar / right sidebar / dock)",
 			"sessionFollow": "New-chat button follows panel opacity",
 			"sessionFollow.desc": "When unified blur is on: whether the New chat button follows the Opacity slider. Off = keeps its original button color",
 			"dialogBlur": "Blur dialogs",
@@ -23379,13 +23631,15 @@ body[data-mpw-modal] [role="dialog"] {
 			"sidebarBlur": "Left sidebar frost",
 			"rightSidebarBlur": "Right sidebar / dock blur",
 			"rightSidebarBlurAmount": "Blur amount",
+			"rightSidebarBlurAmount.desc": "Backdrop blur radius (px) for the right sidebar / dock. While “UI blur follows Unified blur” is on and Unified blur is enabled, this is taken over by the Full-screen blur degree.",
 			"rightSidebarAlpha": "Surface opacity",
-			"rightSidebarBlur.desc": "Adapts DSH 0.1.5 built-in right sidebar and bottom dock overlays to the same frost rules.",
+			"rightSidebarAlpha.desc": "White-fog density (%) on the right sidebar / dock surface: 0 = fully transparent (wallpaper only), 100 = fully opaque. Taken over by “Left sidebar / title-bar opacity” while following Unified blur.",
+			"rightSidebarBlur.desc": "Adapts the built-in right sidebar and bottom dock overlays to the same frost rules. While Unified blur takes over, this whole group follows its two sliders.",
 			"sidebarBlur.desc": "The sidebar itself becomes glass (backdrop-filter blurs the wallpaper behind it, Aqua-style); automatically lifted while a dialog is open so the blur layer cannot trap fixed popups",
 			"sidebarBlurAmount": "Left sidebar frost amount",
-			"sidebarBlur.overridden": "Unified blur is on: left sidebar frost is taken over by the Full-screen blur degree + Surface opacity; turn unified blur off to adjust this switch",
+			"sidebarBlur.overridden": "Unified blur is on: left sidebar frost is taken over by the Full-screen blur degree + Left sidebar / title-bar opacity. Turn off “UI blur follows Unified blur” on the UI-blur page to adjust this switch again",
 			"sidebarBlur.needReveal": "Turn on the sidebar wallpaper reveal first to use sidebar frost (controlled by the sidebar reveal)",
-			"headerBlur.overridden": "Unified blur is on: title-bar frost is taken over by Full-screen blur degree + transparency; turn unified blur off to adjust this switch",
+			"headerBlur.overridden": "Unified blur is on: title-bar frost is taken over by the Full-screen blur degree + Left sidebar / title-bar opacity. Turn off “UI blur follows Unified blur” on the UI-blur page to adjust this switch again",
 			"thinkBg": "Deep diving background box",
 			"thinkBg.desc": "On: show a blurred background box behind the Deep diving thinking status; Off (default): transparent, text sits directly on the wallpaper",
 			"blur.unsupported": "⚠️ This browser (Via/WebView) does not truly render backdrop blur; blur appears as translucency only. Use Chrome/Firefox for the full frosted effect",
@@ -23516,7 +23770,7 @@ body[data-mpw-modal] [role="dialog"] {
 			"themeColor": "Theme color",
 			"themeColor.hint": "Tints the left sidebar / title bar / new-session button / settings dialog background (picker + presets); brand interactive elements (buttons/selection/links) are controlled by the Aqua “Accent color”; empty = disabled",
 			"themeColorReset": "Default",
-			"rightSidebarBlur.overridden": "Unified blur is on: right sidebar/dock blur is handled by “Global blur amount” + “Opacity”; turn unified blur off to make this switch adjustable again",
+			"rightSidebarBlur.overridden": "Unified blur is on (and “UI blur follows Unified blur” is on): right sidebar/dock blur is handled by the Full-screen blur degree + Left sidebar / title-bar opacity; turn the follow switch off on the UI-blur page to make this group adjustable again",
 			// ①(P-66 真 bug 修复) 原来硬编码在 JSX 里的中文（英文界面会漏中文）
 			"hybrid.status": "Status",
 			"scnRender.reapplied": " (remounted)",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-mpkg-wallpaper",
-  "version": "3.13.12",
+  "version": "3.14.0",
   "description": "DSH Web 壁纸引擎 Wallpaper Engine mpkg 背景插件：浏览器内直接解析 .mpkg（preview.gif 动态背景/内嵌 mp4 视频/多时段切换），整屏统一虚化/对话框/弹层/遮罩独立虚化、镜头缩放平移、时钟、冲突检测。",
   "private": false,
   "type": "module",