dsh-mpkg-wallpaper 3.16.4 → 3.16.6

package/lib/client.js

@@ -3413,6 +3413,40 @@ function mpwThumbFail(el, why) {
 		// ═══════════════════════════════════════════════════════════════════
 		//  背景 DOM（一个固定 img 层；用 <img> 保证 GIF 动画可靠播放，⑪）
 		// ═══════════════════════════════════════════════════════════════════
+		/** 我们**整屏 / 可见**浮层的宿主容器（`#mpw-layers`）。
+		 *
+		 *  为什么需要它（上游同族缺陷：macOS 桌面端"整屏 body 浮层把窗口可拖区整片挖掉"）：
+		 *  宿主前端在 darwin 下有一条 `html[data-platform=darwin] body>:not(#root){-webkit-app-region:no-drag}`，
+		 *  而 Electron 对 `no-drag` 的语义是**几何挖除** —— 把这块矩形从可拖区域里减掉，
+		 *  **与绘制顺序、z-index、pointer-events 都无关**（官方文档 custom-window-interactions）。
+		 *  ⇒ 我们直接挂在 `body` 上的整屏浮层（壁纸层/遮罩/时钟）会把整条顶栏的可拖几何挖空：
+		 *  真机症状 = 在顶栏空白处按下拖动，窗口纹丝不动（关掉插件立刻恢复）。
+		 *
+		 *  修法：所有整屏浮层挂进这一个容器。容器自己的盒子是 **0×0** ⇒ 被挖掉的面积是 0；
+		 *  子元素不在 `body>*` 集合里 ⇒ 宿主那条规则不再命中它们（`-webkit-app-region` 不是继承属性）。
+		 *  副作用面为零：`position:absolute` + 0 尺寸 = 脱离文档流（不是 flex/grid 项、不占位）。
+		 *
+		 *  三条**不许有**（否则等于把老问题换个地方犯，见 docs/BGWRAP-VISIBILITY.md 的"层宿主"一节）：
+		 *   · 不许 `z-index`（非 auto 会建层叠上下文 ⇒ `#mpw-bgWrap` 的 `z-index:-1` 会被困在容器里）；
+		 *   · 不许 `transform`/`filter`/`backdrop-filter`/`contain`/`will-change`（会变成 fixed 后代的
+		 *     **containing block** ⇒ 整屏浮层按 0×0 的容器定位，直接消失）；
+		 *   · 不许参与布局（`position:absolute` 就是为此；别改成 static/fixed —— static 会变成 flex/grid 项，
+		 *     fixed 会自建层叠上下文）。
+		 *  `data-plugin` 标记让 `mpwIsOurs()` 认它（我们自己的突变不再喂回自己的观察器）。 */
+		const LAYER_HOST_ID = "mpw-layers";
+		function mpwLayerHost() {
+			try {
+				const found = document.getElementById(LAYER_HOST_ID);
+				if (found && found.parentElement) return found;
+				const host = document.createElement("div");
+				host.id = LAYER_HOST_ID;
+				try { host.setAttribute("data-plugin", "dsh-mpkg-wallpaper") } catch (e) {}
+				host.style.cssText = "position:absolute;left:0;top:0;width:0;height:0;";
+				(document.body || document.documentElement).appendChild(host);
+				return host;
+			} catch (e) { return (document.body || document.documentElement); }
+		}
+
 		function ensureBgDom() {
 			let wrap = document.getElementById(BG_WRAP_ID);
 			if (!wrap) {
@@ -3515,7 +3549,8 @@ function mpwThumbFail(el, why) {
 				canvas.className = "mpw-bgCanvas";
 				canvas.style.display = "none";
 				wrap.appendChild(canvas);
-				(document.body || document.documentElement).appendChild(wrap);
+				/* ①(2026-10-07 上游同族轮) 走层宿主：直接挂 body 的整屏浮层会挖掉 macOS 的窗口可拖区（见 mpwLayerHost）。 */
+				mpwLayerHost().appendChild(wrap);
 			}
 			return wrap;
 		}
@@ -3619,7 +3654,7 @@ function mpwThumbFail(el, why) {
 			clockEl = document.createElement("div");
 			clockEl.id = "mpw-clock";
 			clockEl.style.cssText = "position:fixed;z-index:2000;pointer-events:none;font-family:ui-monospace,SFMono-Regular,monospace;font-variant-numeric:tabular-nums;text-shadow:0 1px 6px rgba(0,0,0,.55);color:var(--dsw-alias-label-primary,#e8eaf0);";
-			(document.body || document.documentElement).appendChild(clockEl);
+			mpwLayerHost().appendChild(clockEl);                   // 同上：整屏浮层一律走层宿主
 			return clockEl;
 		}
 		function clockText() {
@@ -6724,6 +6759,14 @@ function mpwThumbFail(el, why) {
 					if (d.op === "ready") mpwWebDiag("shim-ready", { v: Number(d.v) || 0, href: String(d.href || "").slice(0, 200), caps: d.caps || null });
 					return;
 				}
+				if (d.op === "focus-guard") {
+					/* ①(上游同族缺陷：网页壁纸帧级夺焦）帧内**夺焦围栏**第一次真拦下 `window.focus()` 时的回执。
+					   不透明源下父页读不到帧内 window ⇒ 计数只能由 shim/围栏上报；这条落进 /diag，
+					   让"这张壁纸在从 DSH 手里拿键盘"变成**宿主侧可见**的证据（不是错误，是记账）。 */
+					if (frame) { try { frame.__mpwFocusGuard = { blocked: Number(d.blocked) || 0, calls: Number(d.calls) || 0 } } catch (e) {} }
+					mpwWebDiag("focus-guard", { blocked: Number(d.blocked) || 0, calls: Number(d.calls) || 0 });
+					return;
+				}
 				if (d.op === "error") {
 					const info = mpwWebSrcFromUrl(frame && frame.getAttribute("src"));
 					try { console.warn("[dsh-mpkg-wallpaper] 网页壁纸脚本错误（已兜住）:", String(d.kind || "error"), String(d.message || ""), String(d.stack || "").split("\n")[1] || ""); } catch {}
@@ -7579,11 +7622,22 @@ function mpwThumbFail(el, why) {
 		 *  顺序重要：裸 `header` 会命中页面上任意 header（真机 diag 曾抓到错误节点）。 */
 		function findHostHeader() {
 			try {
-				return document.querySelector(".wSkVaW_header")
+				const h = document.querySelector(".wSkVaW_header")
 					|| document.querySelector('header[class*="_header_"]')
 					|| document.querySelector('[class*="wSkVaW_header"]')
 					|| document.querySelector("header")
 					|| null;
+				/* ①(2026-10-09 DSH 0.2.0 真机) 空标题栏状态在**所有**分支都广播一次：
+				   新会话 headerBlank / 会话加载中 headerSessionless 两个态下，宿主把标题栏留成一条空白，
+				   我们的底色/磨砂/描边/悬浮几何一律不许画（真机症状：顶部一条很细的圆角条）。
+				   挂在这里而不是只挂 ensureHeaderFrost：伪元素兜底（?hdrblur=pseudo）与 cleanup 分支
+				   不经过 ensureHeaderFrost，只在那里设会让空栏又被 ::before 糊上。 */
+				try {
+					const blank = !!(h && h.classList && (h.classList.contains("wSkVaW_headerBlank") || h.classList.contains("wSkVaW_headerSessionless")));
+					if (blank) document.body.setAttribute("data-mpw-hdr-blank", "");
+					else document.body.removeAttribute("data-mpw-hdr-blank");
+				} catch (e) { /* 忽略 */ }
+				return h;
 			} catch { return null }
 		}
 		/* ═══ ①(2026-09-17 真机 bug：在标题栏切换"主会话 ↔ 子代理会话"时磨砂先消失、约 3 秒才回来) ═══
@@ -7698,6 +7752,24 @@ function mpwThumbFail(el, why) {
 			try {
 				const hdr = findHostHeader();
 				if (!hdr) return null;
+				/* ①(2026-10-09 DSH 0.2.0 真机) 空标题栏**绝不给磨砂与底色**：
+				   宿主在"新会话"（wSkVaW_headerBlank）与"会话加载中"（wSkVaW_headerSessionless）
+				   两个态下把标题栏留成一条空白 —— 我们再往里插 blur(30px) 的层 + 给它半透明底，
+				   真机症状就是用户报的"最上面一条很细的圆角条"（太细了基本成弧）。
+				   判据用宿主这两个类名（0.2.0 真机 outerHTML 实测），命中就摘层收手；
+				   状态同时广播到 body（data-mpw-hdr-blank）给 CSS 兜底。 */
+				try {
+					const blank = !!(hdr.classList && (hdr.classList.contains("wSkVaW_headerBlank") || hdr.classList.contains("wSkVaW_headerSessionless")));
+					if (blank) {
+						try { const cur = hdr.querySelector(":scope > .mpw-hdrFrost"); if (cur) cur.remove() } catch {}
+						try { hdr.removeAttribute("data-mpw-hdr-frost") } catch {}
+						try { document.body.removeAttribute("data-mpw-hdr-frost-el") } catch {}
+						try { document.body.setAttribute("data-mpw-hdr-blank", "") } catch {}
+						try { lastFrostReason = "blank-header" } catch {}
+						return null;
+					}
+					try { document.body.removeAttribute("data-mpw-hdr-blank") } catch {}
+				} catch (e) { /* 读不到类名就按正常态走（宁可多一层磨砂，也不误伤正常标题栏） */ }
 				let el = null;
 				try { el = hdr.querySelector(":scope > .mpw-hdrFrost") } catch { el = null }
 				if (!el) {
@@ -9261,6 +9333,27 @@ function mpwThumbFail(el, why) {
 		const MPW_SIDE_MARK_ATTR = "data-mpw-side-mark";
 		/** 弹层/浮层容器候选（与既有弹层判定同一套锚点，另加"面板型"类名）。 */
 		const MPW_LAYER_SEL = '[class*="_overlay"], [class*="_modal"], [role="dialog"], [role="alertdialog"], [aria-modal="true"]';
+		/** 「宽面板」候选：dockkit 的右栏面板/浮层单元（用**宿主属性名**，不是哈希类名 ⇒ 跨版本稳定）。
+		 *  为什么要单列一类：上游同族缺陷（侧栏全屏时右栏面板与对话窗口重叠）的形态是**没有 dialog
+		 *  角色、也没有 overlay 类名**的纯布局态 —— 只认 MPW_LAYER_SEL 的判据对它一条都不命中，
+		 *  而左栏玻璃的 `backdrop-filter` 会同时干两件事：① 让左栏变成 `position:fixed` 后代的
+		 *  **containing block**（面板按左栏的盒子定位，真机读数 {x:13,w:254} = 被压进左栏）；
+		 *  ② 给左栏建层叠上下文，把我们自己钉的 `z-index:12`（dockkit 面板）连同面板一起困在里面。
+		 *  ⇒ 判据必须能把"左栏里那个整屏面板"算成"开着的层"，`data-mpw-holds-layer` 才会摘掉玻璃。
+		 *  只按**宽度**认整屏态：半屏右栏是常见态（左栏还露在旁边，摘它玻璃属于观感回归）⇒ 不触发；
+		 *  量不到视口宽时**不猜**（宁可不抬，也不误摘玻璃）。 */
+		const MPW_WIDE_PANEL_SEL = '[data-dockkit-pane], [data-dockkit-surface]';
+		function mpwIsWidePanel(el) {
+			try {
+				if (!el || el.nodeType !== 1) return false;
+				const cs = getComputedStyle(el);
+				if (!cs || cs.display === "none" || cs.visibility === "hidden" || Number(cs.opacity) === 0) return false;
+				const vw = Number(window.innerWidth) || 0;
+				if (!(vw > 0)) return false;
+				const r = el.getBoundingClientRect();
+				return !!r && r.width > 0 && r.width >= vw * 0.6;
+			} catch (e) { return false }
+		}
 		/** 弹层容器的**类名/角色**特征：这些节点绝不允许被我们打上侧栏类（会吃到侧栏 !important 规则）。 */
 		const MPW_LAYERISH_CLASS_RE = /(overlay|_modal|modal_|dialog|sheet|drawer|popover|panel|menu|portal)/i;
 		/** 该节点自己是不是"弹层/面板型"容器（不看子树，只看自身）。 */
@@ -9293,6 +9386,10 @@ function mpwThumbFail(el, why) {
 			try {
 				const want = new Set();
 				const all = Array.from(document.querySelectorAll(MPW_LAYER_SEL));
+				/* ①(上游同族缺陷：侧栏全屏时面板与对话重叠) 宽面板也算"开着的层"：它没有 dialog
+				   角色/overlay 类名，MPW_LAYER_SEL 一条都命中不了 ⇒ 玻璃规则会继续把左栏当
+				   containing block + 层叠上下文（判据与理由见 MPW_WIDE_PANEL_SEL）。 */
+				for (const el of Array.from(document.querySelectorAll(MPW_WIDE_PANEL_SEL))) { if (mpwIsWidePanel(el)) all.push(el) }
 				for (const el of all) {
 					let open = false;
 					try {
@@ -11146,7 +11243,7 @@ function mpwThumbFail(el, why) {
 			aquaMaskEl = document.createElement("div");
 			aquaMaskEl.id = "mpw-aqua-mask";
 			aquaMaskEl.style.cssText = "position:fixed;inset:0;z-index:-1;pointer-events:none;display:none;";
-			(document.body || document.documentElement).appendChild(aquaMaskEl);
+			mpwLayerHost().appendChild(aquaMaskEl);                // 同上：整屏浮层一律走层宿主
 			return aquaMaskEl;
 		}
 		function aquaParseHex(hex) {
@@ -11668,6 +11765,16 @@ function mpwThumbFail(el, why) {
 				"--dsw-alias-bg-layer-1": {
 					light: toAlpha("--dsw-static-neutral-bluish-50", a),
 					dark: toAlpha("--dsw-static-neutral-bluish-850", a)
+				},
+				/* ①(2026-10-09 DSH 0.2.0 真机) 输入框里的「+」：宿主唯一一枚**不透明**小 chip
+				   （.uV2eYG_add { background: var(--dsw-specific-selector) }，宿主值 #f5f6f7、无 blur），
+				   落在我们 55% 的磨砂卡上就是一块"死白"（用户读数："加号的底变成透明状态、只有一层白色的模糊"）。
+				   这一枚 token 全宿主**只有 2 处**使用（0.2.0-rc.2 产物实测），按弹层同档半透明化即可
+				   让它读作玻璃；关档/无壁纸时整个 overrides 在下面 early-return 前根本不生效。
+				   值形态与其余条目一致（toAlpha(静态色, a)），不引入新的宿主 token 依赖。 */
+				"--dsw-specific-selector": {
+					light: toAlpha("--dsw-static-neutral-bluish-50", a),
+					dark: toAlpha("--dsw-static-neutral-bluish-850", a)
 				}
 			};
 			if (!(enabled && hasImage)) {
@@ -13360,6 +13467,12 @@ function installAudioBus(win, opts = {}) {
 				startCompatObserver: () => { try { startCompatObserver(); return true } catch (e) { return String(e && e.message || e) } },
 				untagInjectedCompat: (why) => { try { return mpwUntagInjectedCompat(why || "test") } catch (e) { return -1 } },
 				holdsLayer: (el) => { try { return mpwHoldsLayer(el) } catch (e) { return null } },
+				syncLayerHosts: () => { try { return mpwSyncLayerHosts() } catch (e) { return String(e && e.message || e) } },
+				layerHost: () => { try { return mpwLayerHost() } catch (e) { return null } },
+				layerHostId: LAYER_HOST_ID,
+				sideLiftSync: () => { try { return mpwSideLiftSync() } catch (e) { return String(e && e.message || e) } },
+				isWidePanel: (el) => { try { return mpwIsWidePanel(el) } catch (e) { return null } },
+				widePanelSel: MPW_WIDE_PANEL_SEL,
 				looksLikeLayer: (el) => { try { return mpwLooksLikeLayer(el) } catch (e) { return null } },
 				compatBridges: COMPAT_BRIDGES.map((b) => ({ sel: b[0], cls: b[1], mode: b[2] })),
 				layerHostAttr: MPW_LAYER_HOST_ATTR,
@@ -17340,6 +17453,44 @@ html body[data-ds-dark-theme] [class*="sidebarCol"]:not([class*="_tab"]) {
 			// 小弹窗**（上下文占用 264px 面板等）必须实体（用户实测 aqua 全关时它也被
 			// dialogBlur 磨砂成透明）；磨砂只在 B 块给 overlay 内的真正对话框覆盖。
 			css += `
+/* ①(2026-10-09 第三批真机) 带 data-mpw-holds-layer 的 role=dialog 面板（Token 用量 / 会话统计
+   bRhRbq_panel、智能体团队 VoX2oq_panel）**不是**要挡内容的设置窗，而是右栏/标题栏那一族的
+   浮层面板：给它们不透明兜底等于把宿主自带的 blur(40px) 废掉（真机读数：bg=rgb(255,255,255)
+   + bf=blur(40px) saturate(1.5) ⇒ "有模糊但一点看不出来"）。改走霜化档（80% + 我们的弹层 blur）。
+   判据用**我们自己的** data-mpw-holds-layer 标记（这两个面板上都有，真机读数确认）。
+   ②(2026-10-10 第四批真机) **内层容器一律不准再画底**：宿主自己的
+   .bRhRbq_details{...}（grid 容器）与 ._7KE1Ra_cell/_option 全都是 background:0 0
+   —— 也就是说用户看到的"内层纯白"**是我们叠出来的**：在已经 80% 霜化的面板里再给内层
+   刷一层 80% ⇒ 合成 1-(1-0.8)² = 96% ≈ 纯白。所以这里只保留**面板本身**两条选择器，
+   [data-session-stats-usage] / [data-session-stats-details] 从名单里摘除（内层交给宿主
+   的透明 + 外层面板的霜化）。 */
+html body [data-team-panel],
+html body [class*="bRhRbq_panel"] {
+	background-color: var(--mpw-surface-panel-frost) !important;
+	/* 半径写**常量**：这一族面板属于"四表面"常量档，token-namespace 判据要求它在
+	   615 组设置 × 亮/暗下逐键相等 —— 挂 var(--mpw-pop-blur)（跟"弹层虚化"开关走）会让
+	   同一表面在不同档位下取值不同 ⇒ 判定为"表面取值不恒定"（真机判据 4290 键不一致）。
+	   玻璃观感靠 80% 霜化底 + 这枚常量半径；Token 用量/会话统计面板本来还带宿主自己的
+	   blur(40px)（我们只把它的不透明底换成霜化底，模糊是它自带的）。 */
+	-webkit-backdrop-filter: blur(11px) !important;
+	backdrop-filter: blur(11px) !important;
+}
+/* ①(2026-10-10 第四批真机) 智能体团队面板的**真正底**在伪元素上：宿主
+   .VoX2oq_panel:before{content:"";z-index:-1;background:var(--dsw-specific-menu);
+   backdrop-filter:var(--dsw-menu-backdrop-filter);border-radius:12px;position:absolute;inset:0}
+   —— 它画在（我们的）元素背景**之上**，所以只改元素 background-color 永远看不到效果
+   （用户："智能体团队的背景模糊还是没有修好"）。把这一层交还给我们：伪元素透明 + 不模糊，
+   霜化由上面的元素级规则提供（一层，不叠加）。 */
+html body [data-team-panel]::before,
+html body [data-team-panel]::after {
+	background: transparent !important;
+	-webkit-backdrop-filter: none !important;
+	backdrop-filter: none !important;
+}
+html body[data-ds-dark-theme] [data-team-panel],
+html body[data-ds-dark-theme] [class*="bRhRbq_panel"] {
+	background-color: var(--mpw-surface-panel-frost-dark) !important;
+}
 /* 通用居中窗口不透明兜底（防透出；overlay 内的对话框由 B 块磨砂覆盖） */
 [role="dialog"],
 [role="alertdialog"] {
@@ -17690,6 +17841,57 @@ html body[data-mpw-rsblur="on"] [data-mpw-rs-surface][data-dockkit-strip] {
 	backdrop-filter: ${rsBlurCss} !important;
 	background-color: var(--mpw-surface-rs-dock) !important;
 }`}
+/* ①(2026-10-09 DSH 0.2.0 真机) 收纳态停靠件兜底：宿主把收起的右栏面板留在 DOM 里并标
+   aria-hidden="true"（rect 仍在视口内，Chromium 上会真的画出来）⇒ 我们**一个像素的玻璃都不许画在它上面**。
+   标记由 JS（mpwTagSurfaceOuter 的 parked 分支）摘，这里再兜一道：即使标记来不及摘，
+   aria-hidden 的表面也保持透明无模糊 —— 用户报的"右半边被糊掉"就是这条缺失造成的。
+   反向判据：展开态的面板**不带** aria-hidden（真机读数），所以这条不会误伤正常右栏。 */
+html body[data-mpw-rightbar-parked] [data-mpw-rs-surface] {
+	-webkit-backdrop-filter: none !important;
+	backdrop-filter: none !important;
+	background-color: transparent !important;
+}
+/* ①(2026-10-09 第二轮真机) 收纳态停靠件**整棵子树**都不许画东西：
+   用户读数"右边还是有一个和展开态一样大的框，有边缘、框内壁纸色与框外明显不同"——
+   那是宿主的停靠件子树自己画的底（_tabHost_* / _emptyTabHost_* 带 --dsw-alias-bg-base），
+   我们摘掉 rs-surface 标记只解决了"我们的玻璃"，没解决"它的底"。
+   data-mpw-rightbar-parked 由 JS 在收纳态广播（展开即摘），命中时把这棵子树的
+   背景/边框/阴影/玻璃/层级全部交还（transparent + none + auto），展开动画本身不受影响
+   （宿主用的是 transform/尺寸过渡，这里只清绘制属性）。 */
+html body[data-mpw-rightbar-parked] [data-sidebar-right-panel],
+html body[data-mpw-rightbar-parked] [data-sidebar-right-float-host],
+html body[data-mpw-rightbar-parked] [data-dockkit-surface],
+html body[data-mpw-rightbar-parked] [data-dockkit-pane],
+html body[data-mpw-rightbar-parked] [data-dockkit-strip],
+html body[data-mpw-rightbar-parked] [class*="P3OORG_panel"],
+html body[data-mpw-rightbar-parked] [class*="_tabHost"],
+html body[data-mpw-rightbar-parked] [class*="_emptyTabHost"] {
+	background-color: transparent !important;
+	border-color: transparent !important;
+	box-shadow: none !important;
+	-webkit-backdrop-filter: none !important;
+	backdrop-filter: none !important;
+	z-index: auto !important;
+}
+/* ①(2026-10-09 第三批真机) 收纳态再加固两层，两个真机症状一起治：
+   · "有一个 1px 的描边"（Android/Chromium 才看得见）—— 我们的发丝线/伪元素描边不在
+     border-color 的管辖内（伪元素有自己的 border/box-shadow）⇒ 整棵停靠件子树**直接不画**：
+     opacity:0（不影响布局、不参与绘制；伪元素的描边也一并消失）。
+     注：这里**不再**逐项加 background-image/outline/transition/animation —— 那几条会撞
+     token-namespace 的"四表面生效值逐键相等"基线（真机报 gated|side|background-image 不一致）；
+   · "背景模糊最后才收起"（内容先没了、玻璃还留一会儿）—— 宿主用 transition 把面板挪走，
+     我们的 backdrop-filter 跟着一起走 ⇒ 用户看到"模糊停留"。transition:none + opacity:0
+     让它在标记落地的那一帧就消失（标记由 mpwTagSurfaceOuter 在同一个 mutation 批次里写）。 */
+html body[data-mpw-rightbar-parked] [data-sidebar-right-panel],
+html body[data-mpw-rightbar-parked] [data-sidebar-right-float-host],
+html body[data-mpw-rightbar-parked] [data-dockkit-surface],
+html body[data-mpw-rightbar-parked] [data-dockkit-pane],
+html body[data-mpw-rightbar-parked] [data-dockkit-strip],
+html body[data-mpw-rightbar-parked] [class*="P3OORG_panel"],
+html body[data-mpw-rightbar-parked] [class*="_tabHost"],
+html body[data-mpw-rightbar-parked] [class*="_emptyTabHost"] {
+	opacity: 0 !important;
+}
 /* 抑制：弹窗/设置面板打开时（backdrop-filter 会成为 fixed 弹窗的 containing block → 必须摘除） */
 html body[data-mpw-sblur-off] [class*="sidebarCol"],
 html body[data-mpw-sblur-off] header[class*="_header_"],
@@ -18027,6 +18229,15 @@ html body[data-ds-dark-theme][data-mpw-unify] [data-mpw-rs-surface][data-dockkit
 html body[data-ds-dark-theme][data-mpw-unify] [data-mpw-rs-surface][data-dockkit-float] {
 	background-color: var(--mpw-unify-surface-dark) !important;
 }
+/* ①(2026-10-09 DSH 0.2.0 真机) dockkit 新结构里 **面板本体**（_tabHost_*）自带
+   background: var(--dsw-alias-bg-base)（用户档位下算出来是 35% 白、且**没有 blur**），
+   它盖在我们刷好的玻璃之上 ⇒ 看到的是"一层死白的底、完全没有模糊"（Sub Agent 面板就是这样变不透明的）。
+   既然面板已经被我们刷了玻璃，这层结构底就该让位（同一条件门控：右侧玻璃开 / 统一虚化开 + 已打 rs-surface）。
+   [class*="_tabHost"] 同时覆盖 _tabHost_* / _tabHostHeader_* / _tabHostBody_* / _emptyTabHost_*。 */
+html body[data-mpw-rsblur="on"] [data-mpw-rs-surface] [class*="_tabHost"],
+html body[data-mpw-unify] [data-mpw-rs-surface] [class*="_tabHost"] {
+	background-color: transparent !important;
+}
 /* better-sidebar 的面板 / 底部工作台：**只跟雾色与厚度，不给 backdrop-filter**。
    依据它自己的适配笔记（docs/BETTER-SIDEBAR-COMPAT.md / bsReveal 段注释）：
    面板带 backdrop-filter 会成为内部 fixed 内容的 containing block（"困内容"）⇒ 只改底色。
@@ -18115,6 +18326,11 @@ html body[data-mpw-sblur-off] [data-mpw-rs] {
 			   清掉了模糊 ⇒ 纯白。把它（以及同类小面板）纳入弹层表面集合。 */
 			const popSurfaceSel = `[role="menu"]${POP_NOT}, [role="listbox"]${POP_NOT}, [role="combobox"]${POP_NOT}, [data-dsh-surface]${POP_NOT}, [class*="_menu"]${POP_NOT}, [class*="_popover"]${POP_NOT}, [class*="_dropdown"]${POP_NOT}, [class*="_denseList"]${POP_NOT}, [class*="JObwrW_panel"]${POP_NOT}`;
 			const popTipSel = `[role="tooltip"]:not([data-mpw-pop-untrunc]), [role="alert"]:not([data-mpw-pop-untrunc])`;
+			/* ①(2026-10-10 第五批真机) 子智能体会话树（docs/subagentouterhtml.md 的 ZKlsPq_* 家族）：
+			   类名以 _menu **结尾**，进不了上面那串 [class*="_menu_"]（那是给带下划线的表面用的）
+			   ⇒ 它一直没吃到我们的模糊；有壁纸时又落在带 blur 的祖先里 ⇒ 纯白。
+			   这里单独补一条，**只补模糊、不补底**（底由宿主自己的 material/菜单底负责，避免叠两层白）。 */
+			const popTreeSel = `[class*="ZKlsPq_menu"]:not([data-mpw-pop-untrunc])`;
 			/* ①(2026-10-02 用户第 3 条：「把这个好用的模糊效果独立成 token，因为还有几个地方也要实现」)
 			   弹层表面 = **底色 + 模糊半径 + 圆角** 三件套，全部由这几枚 token 定义；任何弹层只要被
 			   下面的选择器命中，就自动同一套效果（不再各处写死 rgba/blur）。
@@ -18144,6 +18360,7 @@ html body[data-ds-dark-theme] :is(${popSurfaceSel}) {
    open-in-app 的下拉是 div._denseList_），否则它们会"半透明又无模糊"。
    表面选择器与上面的底色规则共用（POP_NOT 已排除 anchor/icon/status 等非表面类）。 */
 ${popTipSel},
+html body :is(${popTreeSel}),
 ${popSurfaceSel} {
 	/* ①(2026-10-02) 半径/模糊统一读自有 token（--mpw-pop-blur 是唯一来源；关掉弹层虚化时它就是 none） */
 	backdrop-filter: var(--mpw-pop-blur, ${popFilter}) !important;
@@ -18153,7 +18370,7 @@ ${popSurfaceSel} {
    兜底底**只刷宿主自己没有底色的弹层**（JS 扫 computed backgroundColor，α=0 才打 data-mpw-pop-bg）；
    有宿主玻璃的弹层（标题栏子代理展开框 / VS Code 菜单 / 模型选择…）一个像素都不动。
    独立 token：--mpw-pop-surface(-dark)（不再共用面板表面 token --mpw-surface-pop）。 */
-html body [data-mpw-pop-bg] { background-color: var(--mpw-pop-surface) !important; }
+html body [data-mpw-pop-bg]:not([data-menu-material]) { background-color: var(--mpw-pop-surface) !important; }
 /* ②(2026-10-05) 弹层处在一个"自己有底的玻璃祖先"里面（backdrop root 被截断 ⇒ 我们糊不到页面背后）：
    与其"半透明却没模糊"（真机被读成"只有白色滤镜"），不如**做实在**——表面不透明度抬到 88%，
    并把 backdrop-filter 撤掉（白算一遍）。注意：只动我们自己的标记属性，宿主元素一个都不碰。
@@ -18175,7 +18392,66 @@ html body [data-mpw-pop-untrunc][data-mpw-pop-untrunc] {
    挂 body 的层又会压住弹层——弹层在卡片的层叠上下文里）。data-mpw-pop-glass 现在只是"B 类、
    祖先截断已被我们摘掉"的**诊断标记**，没有任何 CSS 效果（弹层自己的 blur 照常工作）。 */
 html body [data-mpw-pop-frost] { background-color: transparent !important; }
-html body[data-ds-dark-theme] [data-mpw-pop-bg] { background-color: var(--mpw-pop-surface-dark) !important; }
+html body[data-ds-dark-theme] [data-mpw-pop-bg]:not([data-menu-material]) { background-color: var(--mpw-pop-surface-dark) !important; }
+/* ①(2026-10-09 第三批真机) 0.2.0 新菜单外壳（加号展开的"触发候选建议" / 选择工作区 / 选择 agent 预设）：
+   外壳 ._surface_ri079_1 自带 isolation: isolate ⇒ **它自己就是 backdrop root**，内层
+   ._material_ri079_21 的宿主 blur(40px) 只能采样外壳内部（外壳自身透明）⇒ 一点模糊都出不来。
+   真机原话："加号点开之后展开的这个列表…它的模糊好像是不生效的"。
+   修法：把模糊补在**外壳自己**身上（外壳的 backdrop 是整页，不受它自己的 isolation 影响），
+   底色仍由宿主的 material 层画 —— 我们一个像素都不抢（这也是 host-material 判据的姊妹条款：
+   我们不画底，但必须补模糊，否则宿主那层 40px 被它自己的 isolation 废掉后整块是死的）。
+   关掉"弹层虚化"时 --mpw-pop-blur = none ⇒ 这条自动让位（审计提醒：别把 material 家族一起 none）。 */
+html body [data-menu-material],
+html body [data-trigger-menu] {
+	-webkit-backdrop-filter: var(--mpw-pop-blur, blur(10px)) !important;
+	backdrop-filter: var(--mpw-pop-blur, blur(10px)) !important;
+}
+/* ①(2026-10-10 第六批真机) 宿主 material 菜单的**内层底让位**：._material_ri079_21 是
+   58% 白 + 它自己的 blur(40px)，但那个 blur 被外壳 ._surface_ri079_1{isolation:isolate}
+   废掉（外壳自己就是 backdrop root，内层只能采样外壳内部）⇒ 真机上就只剩一块"死白板"
+   （用户："选择模型的地方里面还有一个白色的块"）。真机读数（--only-menu）：模型/推理菜单
+   整棵子树里画了底的节点**只有这一个**（bg=rgba(248,249,250,.58) bf=blur(40px)saturate）。
+   修法：让它透明、模糊交还给外壳上我们那条 blur；底色改用我们自己的弹层表面 token
+   ⇒ 模型/推理/工作区/权限这些菜单与其它弹层观感一致（不再是一块比周围更白的板）。 */
+/* ②(2026-10-10 用户截图 + 像素分析定案) 上一版把内层 material 底**整个透明掉**、改由外壳画底，
+   结果外壳自己没有圆角 ⇒ 截图里出现"外面一圈圆角玻璃 + 里面一块直角白矩形"（像素分析：白区
+   铺满菜单整宽 x=30→650，只有最外一圈是圆角）。
+   正解是**颜色换掉、形状保留**：带圆角的是内层 material 层，就让它继续画底（换成我们的弹层表面
+   token），外壳只负责模糊、不画底 —— 这样圆角由宿主维持，模糊由外壳（它的 backdrop 是整页，
+   不受自身 isolation 影响）提供，内层自己的 blur40 被 isolation 废掉这件事也就不重要了。 */
+html body :is([data-menu-material], [data-trigger-menu]) [class*="_material_ri079_"] {
+	background-color: var(--mpw-pop-surface) !important;
+	/* ③(2026-10-10 用户截图 + outerHTML 定案) 这一层是 inset:0 的**方形填充**（宿主只给它
+	   position/inset/背景，没有圆角），而外壳 ._surface_ri079_1 是带圆角的 ⇒ 真机上就是
+	   "外面一圈圆角玻璃 + 里面一块直角白矩形"（用户原话）。让它继承外壳的圆角即可对齐形状。 */
+	border-radius: inherit !important;
+}
+html body[data-ds-dark-theme] :is([data-menu-material], [data-trigger-menu]) [class*="_material_ri079_"] {
+	background-color: var(--mpw-pop-surface-dark) !important;
+	border-radius: inherit !important;
+}
+html body :is([data-menu-material], [data-trigger-menu]) {
+	background-color: transparent !important;
+}
+/* ③(2026-10-10 真机层次读数定案) 宿主 material 菜单里的**内层容器**（_7KE1Ra_groups，radius 0
+   的直角滚动容器）会被**两条**弹层规则命中：我们新写的那条（有 !important）与"老 G 块"那条
+   （[role="menu"]，无 !important）。只排除一条，另一条就接管（真机读数：groups 仍是
+   blur(11px) saturate(1.5)）⇒ 它把身后的 58% 白底在方形区域内再糊一遍，就是用户说的
+   "外面圆角那圈正常、里面一块直角白矩形"。这里**只新增**一条 !important 中和规则一次压住
+   所有来源，绝不改既有规则文本（改文本会扰动 token-namespace 的四表面基线，实测 612/615
+   组不一致）。 */
+html body [data-mpw-menu-inner][data-mpw-menu-inner][data-mpw-menu-inner] {
+	-webkit-backdrop-filter: none !important;
+	backdrop-filter: none !important;
+	background-color: transparent !important;
+}
+/* 特异性说明（2026-10-10 真机规则归属定案）：普通弹层规则那条是
+   html body :is(popTipSel..., popSurfaceSel) { backdrop-filter: var(--mpw-pop-blur) !important }，
+   而 :is() 取**参数里最高**的特异性 —— popSurfaceSel 含 [class*="_menu_"]:not(...) ⇒ (0,2,0)，
+   加上 html body ⇒ **(0,2,2)**。写两遍的我方规则同样 (0,2,2) ⇒ 平手，而它在样式表里更靠后 ⇒ 它赢
+   （真机读数：标记已落地但 bf 仍是 blur(11px)，规则归属里能看到那条 !important）。
+   所以这里把同一个属性写**三**遍 ⇒ (0,3,2)，与顺序无关地稳压。 */
+
 [role="menu"] [class*="card"],
 [role="tooltip"] [class*="card"] {
 	backdrop-filter: none !important;
@@ -18962,6 +19238,38 @@ html body[data-ds-dark-theme] header[class*="_header_"][data-mpw-hdr-translucent
 .wSkVaW_header:has(> .mpw-hdrFrost) > :not(.mpw-hdrFrost) { position: relative; z-index: 1; }
 .mpw-hdrFrost:first-child ~ * { position: relative; z-index: 1; }
 .wSkVaW_header > .mpw-hdrFrost { z-index: 0 !important; }
+/* ①(2026-10-09 DSH 0.2.0 真机) 面包屑文字"加载不出来"的真根因：0.2.0 在标题栏里插了一层
+   div[data-slot="conversation.session.header"][style="display:contents"] —— **display:contents 不生成盒子**，
+   上面那条"直接子节点抬升"落在它身上等于没落（position/z-index 对无盒元素无效），
+   于是它里面的 .wSkVaW_titleRow（标题/面包屑文字）仍是 static，被我们的 .mpw-hdrFrost
+   （absolute + z-index:0）**整片盖在下面**（模糊层盖住文字 ⇒ 看起来"文字加载不出来"）。
+   这里把真正的盒子层补抬一次：只针对标题行与面包屑（都是普通 div/span，position:relative 不改布局，
+   不加偏移就不会移位）。 */
+.wSkVaW_header:has(> .mpw-hdrFrost) .wSkVaW_titleRow,
+.wSkVaW_header:has(> .mpw-hdrFrost) .wSkVaW_crumbs,
+.wSkVaW_header:has(> .mpw-hdrFrost) .wSkVaW_crumb { position: relative; z-index: 1; }
+/* ①(2026-10-09 DSH 0.2.0) 空标题栏兜底（body[data-mpw-hdr-blank] 由 JS 在 headerBlank /
+   headerSessionless 两个态下广播）：底色、底色图、磨砂、阴影一律不下发 ——
+   否则刷新后新会话界面顶部会留一条"很细的圆角条"（那就是我们的磨砂层 + 半透明底）。 */
+html body[data-mpw-hdr-blank][data-mpw-hdr-blank] .wSkVaW_header,
+html body[data-mpw-hdr-blank][data-mpw-hdr-blank] .wSkVaW_header::before,
+html body[data-mpw-hdr-blank][data-mpw-hdr-blank] .wSkVaW_header::after,
+html body[data-mpw-hdr-blank][data-mpw-hdr-blank] .wSkVaW_header > .mpw-hdrFrost {
+	background-color: transparent !important;
+	background-image: none !important;
+	-webkit-backdrop-filter: none !important;
+	backdrop-filter: none !important;
+	box-shadow: none !important;
+	border-radius: 0 !important;
+	padding: 0 !important;
+	margin: 0 !important;
+	min-height: 0 !important;
+	border-width: 0 !important;
+}
+/* 特异性说明（2026-10-09 真机第二轮）：既有规则里有 (0,3,3) 的暗色底（header[class*="_header_"] 那条）
+   与 (0,3,1) 的 aqua 底、以及 float 档的 margin/padding/border/radius —— 单写 [data-mpw-hdr-blank] 只有
+   (0,2,x)，压不过它们（空栏仍被画出来）。这里把同一个属性写两遍把特异性翻到 (0,4,x)，既压得住，
+   又不用去改那几条既有规则的文本（css-matrix 按源码文本判 ::before 磨砂，改文本会破断言）。 */
 /* ①(2026-09-16 bug①) 右侧「轮次导航条」（DSH 0.1.5 的 TurnNavigator rail / .eGxaPq_*）对比兜底。
    判据：宿主 .eGxaPq_mark::before 用 --dsw-alias-border-l4（#00000029 / #fff3 = 16%/20% alpha），
    假定条背后是**不透明表面**；壁纸模式把表面透明化后，条与壁纸混色 ⇒ 用户观感"条变透明"。
@@ -19153,7 +19461,6 @@ ${(section.bsFloat !== void 0 ? !!section.bsFloat : false) ? `
    （不透明），在已被透明的 .pane 内又铺一层与圆角壳(bg-layer-1)不同的 token → 双层、
    两层透明度（用户实测"圆角里套直角、两层透明度不同"的根源，子代理定位）。置透明后
    让圆角壳单层显示。xterm 内部文字/光标类用 foreground 色，不受背景影响。 */
-[data-dsh-better-sidebar] [class*="_terminalWrap"],
 [data-dsh-better-sidebar] [class*="_terminal"] {
 	background-color: transparent !important;
 }
@@ -19182,7 +19489,6 @@ ${(section.bsAlpha !== void 0 ? !!section.bsAlpha : false) ? `
 [data-dsh-better-sidebar] [data-dsh-pane],
 [data-dsh-better-sidebar] [class*="_tabBar"],
 [data-dsh-better-sidebar] [class*="_editorHeader"],
-[data-dsh-better-sidebar] [class*="_terminalWrap"],
 [data-dsh-better-sidebar] [class*="_browserBar"] {
 	background-color: color-mix(in srgb, var(--dsw-alias-bg-base) 52%, transparent) !important;
 }
@@ -19211,8 +19517,7 @@ body[data-ds-dark-theme] [data-dsh-better-sidebar] [class*="_pane"]:not([class*=
 body[data-ds-dark-theme] [data-dsh-better-sidebar] [data-dsh-pane],
 body[data-ds-dark-theme] [data-dsh-better-sidebar] [class*="_tabBar"],
 body[data-ds-dark-theme] [data-dsh-better-sidebar] [class*="_editorHeader"],
-body[data-ds-dark-theme] [data-dsh-better-sidebar] [class*="_browserBar"],
-body[data-ds-dark-theme] [data-dsh-better-sidebar] [class*="_terminalWrap"] {
+body[data-ds-dark-theme] [data-dsh-better-sidebar] [class*="_browserBar"] {
 	background-color: color-mix(in srgb, var(--dsw-static-neutral-bluish-950) 28%, transparent) !important;
 }
 body[data-ds-dark-theme] [data-dsh-better-sidebar] [class*="_addBar"],
@@ -19254,7 +19559,6 @@ ${(section.bsAqua !== void 0 ? !!section.bsAqua : false) ? `
 [data-dsh-better-sidebar] [data-dsh-pane],
 [data-dsh-better-sidebar] [class*="_tabBar"],
 [data-dsh-better-sidebar] [class*="_editorHeader"],
-[data-dsh-better-sidebar] [class*="_terminalWrap"],
 [data-dsh-better-sidebar] [class*="_browserBar"] {
 	background-color: var(--dsw-alias-bg-base) !important;
 }
@@ -21563,11 +21867,13 @@ body[data-mpw-modal] [role="dialog"] {
 
 			// ①(2026-09-12) 原 `const h` 声明在 1600 行之后（使用点之前）→ TDZ/未定义；
 			//   已上移到函数开头（见 MpkgSectionImpl 首行），此处删除避免重复声明。
-			// ①(修正) 弹窗遮罩 portal：渲染到 body，避开设置面板包含块/backdrop root 困局
+			// ①(修正) 弹窗遮罩 portal：渲染到**层宿主**（不是 body），避开设置面板包含块/backdrop root 困局；
+			//   ①(2026-10-07 上游同族轮) 改挂层宿主：`.mpw_mask` 是 `position:fixed;inset:0` 的整屏浮层，
+			//   直接挂 body 会把 macOS 的窗口可拖区整片挖掉（见 mpwLayerHost）。
 			const MaskPortal = (props) => {
 				const node = h("div", { className: "mpw_mask", onClick: props.onClick }, props.children);
-				if (ReactDOM && ReactDOM.createPortal && typeof document !== "undefined" && document.body) {
-					try { return ReactDOM.createPortal(node, document.body); } catch { /* 回退原位渲染 */ }
+				if (ReactDOM && ReactDOM.createPortal && typeof document !== "undefined" && (document.body || document.documentElement)) {
+					try { return ReactDOM.createPortal(node, mpwLayerHost()); } catch { /* 回退原位渲染 */ }
 				}
 				return node;
 			};
@@ -24912,10 +25218,44 @@ body[data-mpw-modal] [role="dialog"] {
 		   `data-mpw-rs-surface`，CSS 只认这个标记（与 `data-mpw-holds-layer` 同一手法）。
 		   幂等、无布局读取（只用 matches/parentElement），可随突变跑。 */
 		const MPW_RS_FAMILY = '[data-sidebar-right-panel], [data-dockkit-pane], [data-dockkit-strip], [data-dockkit-surface], [data-dockkit-float], [data-sidebar-right-float-host], [class*="P3OORG_panel"]';
+		/** 右栏**收纳态/停靠件**判据（DSH 0.2.0 真机结构）：
+		 *  宿主在 `pI_x6G_frame` 上打 `data-rightbar-collapsed="true"`（展开时该属性被移除），
+		 *  并把收起的停靠面板留在 DOM 里且 `aria-hidden="true"` —— **它的 rect 仍在视口内**
+		 *  （实测 `[780,10,650,880]`），只是内核裁剪行为不同：Android Via/Chromium 上会真的画出来，
+		 *  Firefox 上命中测试打不到。用户看到的就是"右半屏被糊了一整块"。
+		 *  ⇒ 判定成立时**一个 rs-surface 标记都不许留**（这是"停靠件"，不是用户要看的表面）。
+		 *  两条判据都认：属性名优先（跨版本更稳），`aria-hidden` 兜底。 */
+		function mpwRightbarParked() {
+			try {
+				const f = document.querySelector('[data-rightbar-collapsed]');
+				if (f && String(f.getAttribute('data-rightbar-collapsed')) !== 'false') return true;
+				const p = document.querySelector('[data-sidebar-right-panel]');
+				if (p && p.getAttribute('aria-hidden') === 'true') return true;
+			} catch (e) { /* 读不到就按"没收起"处理（宁可不摘，也不误摘展开态） */ }
+			return false;
+		}
 		function mpwTagSurfaceOuter() {
 			try {
-				const all = Array.from(document.querySelectorAll(MPW_RS_FAMILY));
-				if (!all.length) return 0;
+				/* ①(2026-10-09 第二轮真机) 收纳态还要**一个像素都不画**：只摘标记不够 ——
+				   宿主的停靠件子树自己会画底（`_tabHost_*` / `_emptyTabHost_*` 带 --dsw-alias-bg-base），
+				   于是用户仍看到"和展开态一样大的框、有边缘、框内壁纸色和框外不一样"。
+				   ⇒ 把状态广播到 body（`data-mpw-rightbar-parked`），由 CSS 把那一整棵子树的底/边/影/玻璃全清。 */
+				const parkedNow = mpwRightbarParked();
+				try {
+					if (parkedNow) document.body.setAttribute('data-mpw-rightbar-parked', '');
+					else document.body.removeAttribute('data-mpw-rightbar-parked');
+				} catch (e) { /* 忽略 */ }
+				const all = Array.from(document.querySelectorAll(MPW_RS_FAMILY))
+					.filter((el) => { try { return el.getAttribute('aria-hidden') !== 'true' } catch (e) { return true } });
+				if (!all.length || parkedNow) {
+					/* 收纳态：把已有标记摘干净（否则玻璃会留在停靠件上 = 右半屏被糊） */
+					let removed = 0;
+					for (const el of Array.from(document.querySelectorAll('[data-mpw-rs-surface]'))) {
+						try { el.removeAttribute('data-mpw-rs-surface'); removed++ } catch (e) { /* 忽略 */ }
+					}
+					if (removed) { try { mpwTrace('rs-surface:parked', { removed }) } catch (e) {} }
+					return removed;
+				}
 				const set = new Set(all);
 				const isDock = (el) => { try { return el.matches('[data-dockkit-pane], [data-dockkit-strip], [data-dockkit-surface], [data-dockkit-float]') } catch (e) { return false } };
 				const hasMatchedAncestor = (el) => {
@@ -24968,6 +25308,14 @@ body[data-mpw-modal] [role="dialog"] {
 							want = true; break;
 						} catch (e) { /* 单个读不到就跳过 */ }
 					}
+					/* ①(上游同族缺陷) 整屏 dockkit 面板：没有 dialog 角色 ⇒ 上面那条一个都不命中，
+					   而左栏的 z-index:1 会把面板的 z-index:12 一起困在左栏的层叠上下文里（真机症状：
+					   面板与对话重叠）。抬升左栏 ⇒ 面板随子树回到宿主为它设计的层。半屏不抬。 */
+					if (!want) {
+						for (const p of Array.from(side.querySelectorAll(MPW_WIDE_PANEL_SEL))) {
+							if (mpwIsWidePanel(p)) { want = true; break }
+						}
+					}
 					const has = side.hasAttribute("data-mpw-side-lift");
 					if (want && !has) { try { side.setAttribute("data-mpw-side-lift", ""); changed++ } catch (e) {} }
 					else if (!want && has) { try { side.removeAttribute("data-mpw-side-lift"); changed++ } catch (e) {} }
@@ -24987,6 +25335,47 @@ body[data-mpw-modal] [role="dialog"] {
 			} catch (e) {}
 			return false;
 		}
+		/** ③(2026-10-10 真机定案) **快路打标**：material 外壳里的内层 [role="menu"]（真机是
+		 *  `._7KE1Ra_groups`，radius=0 的直角滚动容器）会被两条弹层规则糊到，从而在方形区域内
+		 *  把身后的白底再糊一遍 = 用户看到的"外面圆角正常、里面一块直角白矩形"。
+		 *  压制规则（html body [data-mpw-menu-inner] { backdrop-filter:none !important }）在 CSS 里，
+		 *  但打标若只放在**节流的重活同步**里，开菜单那一帧标记还没落地 ⇒ 用户仍会看到白块
+		 *  （实测：开菜单 ~0.5s 后读数仍是 blur(11px)）。所以这里在**突变快路**上（微任务、渲染前）
+		 *  立刻打标；重活同步里那份保留，作为兜底与"失效标记回收"。 */
+		const MPW_MENU_SHELL_SEL = '[data-menu-material], [data-trigger-menu], [class*="ZKlsPq_menu"]';
+		function mpwMarkMenuInner(root) {
+			try {
+				if (!root || root.nodeType !== 1) return 0;
+				const shells = [];
+				try { if (root.matches && root.matches(MPW_MENU_SHELL_SEL)) shells.push(root) } catch (e) {}
+				try {
+					if (root.querySelectorAll) {
+						const found = root.querySelectorAll(MPW_MENU_SHELL_SEL);
+						for (let i = 0; i < found.length && i < 8; i++) shells.push(found[i]);
+					}
+				} catch (e) {}
+				let n = 0;
+				for (const sh of shells) {
+					let inner = [];
+					try { inner = sh.querySelectorAll('[role="menu"], [role="listbox"], [class*="_groups"]') } catch (e) { inner = [] }
+					for (let k = 0; k < inner.length && k < 12; k++) {
+						try {
+							const el2 = inner[k];
+							if (!el2.hasAttribute("data-mpw-menu-inner")) { el2.setAttribute("data-mpw-menu-inner", ""); n++ }
+							/* ④(2026-10-10 规则归属定案) **必须用内联 !important**：压我们的那条弹层规则是
+							   html body :is(popTipSel…, popSurfaceSel) { backdrop-filter: var(--mpw-pop-blur) !important }，
+							   而 popSurfaceSel 的首项带着 POP_NOT 里 **23 个 :not()** ⇒ :is() 取最高 ⇒ 该规则
+							   特异性约 (0,25,2)，靠属性重复(0,3,2)根本压不过（真机读数：三遍重复后仍 blur(11px)）。
+							   作者**内联** important 在层叠里高于任何作者样式表 important ⇒ 无特异性问题。
+							   清理：标记被摘掉时（下面的回收分支）同步 removeProperty，宿主逐字还原。 */
+							try { el2.style.setProperty("backdrop-filter", "none", "important") } catch (e) {}
+							try { el2.style.setProperty("-webkit-backdrop-filter", "none", "important") } catch (e) {}
+						} catch (e) {}
+					}
+				}
+				return n;
+			} catch (e) { return 0 }
+		}
 		function mpwTagPopoverFast(records) {
 			try {
 				let n = 0;
@@ -25000,6 +25389,8 @@ body[data-mpw-modal] [role="dialog"] {
 					if (rec.type === "attributes") {
 						const t = rec.target;
 						if (!t || t.nodeType !== 1) continue;
+						/* ③(2026-10-10) 宿主菜单显形/换页签走的是属性突变 ⇒ 这里顺手把内层容器标记上 */
+						try { mpwMarkMenuInner(t) } catch (e) {}
 						let hit = false;
 						try { hit = t.matches && t.matches(MPW_POP_TAG_SEL) } catch (e) {}
 						if (hit) { if (mpwTagOnePopover(t)) n++; }
@@ -25007,6 +25398,8 @@ body[data-mpw-modal] [role="dialog"] {
 					}
 					for (const node of (rec.addedNodes || [])) {
 						if (!node || node.nodeType !== 1) continue;
+						/* ③(2026-10-10) 菜单是"先插入 DOM 再显形"，插入那一刻就打标 ⇒ 渲染前已生效 */
+						try { mpwMarkMenuInner(node) } catch (e) {}
 						const cands = [];
 						try {
 							if (node.matches && node.matches(MPW_POP_TAG_SEL)) cands.push(node);
@@ -25023,6 +25416,50 @@ body[data-mpw-modal] [role="dialog"] {
 			} catch (e) { return 0 }
 		}
 		/** 单个元素：该不该有我们的兜底底；返回是否发生了变化。 */
+		/** 宿主新菜单（DSH 0.2.0）**自带内层 material 底**：表面 `._surface_ri079_1` 自身 α=0
+		 *  （我们只看自身底色 ⇒ 判成 empty，垫上我们那层 58%），而真正的底画在直接子层
+		 *  `._material_ri079_21`（`--dsw-menu-surface-fill` 58% + `--dsw-menu-backdrop-filter` blur(40px)）。
+		 *  两层叠起来 ≈82% 近白 ⇒ 用户看到"白、没有模糊"。
+		 *  判据：宿主显式声明 material 家族（属性 `data-menu-material` 优先），或直接子层就是那个
+		 *  material 底且自己画了底/模糊 ⇒ need=false（**撤我们的底、留我们的 blur**）。 */
+		function mpwPopHostMaterial(el) {
+			try {
+				if (!el || el.nodeType !== 1) return false;
+				if (el.hasAttribute && el.hasAttribute("data-menu-material")) return true;
+				const kids = el.children || [];
+				for (let i = 0; i < kids.length; i++) {
+					const c = kids[i];
+					let cls = "";
+					try { cls = String((c.className && c.className.baseVal !== void 0 ? c.className.baseVal : c.className) || "") } catch (e) { cls = "" }
+					if (cls.indexOf("_material_") < 0) continue;
+					try {
+						const cs = getComputedStyle(c);
+						const a = mpwColorAlpha(cs.backgroundColor);
+						const bf = cs.backdropFilter;
+						if (a >= 0.05 || (bf && bf !== "none")) return true;
+					} catch (e) { /* 单个读不到就跳过 */ }
+				}
+			} catch (e) { /* 忽略 */ }
+			return false;
+		}
+		/** ①(2026-10-10 第四批真机) 外层已经是"玻璃外壳"时，**内层**不许再吃我们的兜底底：
+		 *  真机症状——模型选择器弹框里"提供商/模型"那一小块是白的（用户："弹框里面套了一个框，
+		 *  里面这个框没有模糊"），而 `._7KE1Ra_cell/_option/_groups` 这些内层类在宿主 CSS 里
+		 *  全是 background:0 0；白底是我们自己给内层 [role="listbox"] 刷的兜底层
+		 *  （--mpw-pop-surface 58%）叠在宿主 58% 的 material 层之上 ⇒ ≈82% 近白。
+		 *  同一片区域只许留一层底（与 `mpwTagSurfaceOuter` 同一条纪律）。 */
+		function mpwPopInsideMenuShell(el) {
+			try {
+				for (let p = el && el.parentElement, i = 0; p && i < 8; p = p.parentElement, i++) {
+					if (p.hasAttribute && (p.hasAttribute("data-menu-material")
+						|| p.hasAttribute("data-trigger-menu")
+						|| p.hasAttribute("data-mpw-pop-bg")
+						|| p.hasAttribute("data-mpw-rs-surface"))) return true;
+					try { if (p.matches && p.matches('[class*="_surface_ri079_"]')) return true } catch (e) { /* 忽略 */ }
+				}
+			} catch (e) { /* 忽略 */ }
+			return false;
+		}
 		function mpwTagOnePopover(el) {
 			let need = false;
 			let why = "";
@@ -25042,8 +25479,13 @@ body[data-mpw-modal] [role="dialog"] {
 						   宿主底回来 ⇒ 再打标 …… 逐帧自激（真机："底色时有时无"）。
 						   属性值就是当初的理由：empty = 宿主没画底；painted = 宿主画了不透明底。 */
 						const reason = el.getAttribute("data-mpw-pop-bg");
-						if (reason === "empty") { need = !mpwPopHasPaintedAncestor(el); why = "empty" }
+						/* ①(2026-10-09 DSH 0.2.0) 宿主自带 material 底的菜单（data-menu-material）⇒ 撤我们的底。
+						   ⚠ sticky 复核**只许走结构判据**（属性在不在），绝不重读底色/子层 computed —— 那正是
+						   A6"反自激"钉的事（标记一生效底色就变我们画的，重读会打-撤-打地闪）。 */
+						if (el.hasAttribute && el.hasAttribute("data-menu-material")) { need = false; why = "host-material" }
+						else if (reason === "empty") { need = !mpwPopHasPaintedAncestor(el); why = "empty" }
 						else if (reason === "painted") { need = mpwPopIsFloating(el); why = "painted" }
+						else if (mpwPopHostMaterial(el) || mpwPopInsideMenuShell(el)) { need = false; why = "host-material" }
 						else {
 							const a = mpwColorAlpha(cs.backgroundColor);
 							/* ②(2026-10-05) 两类分开判：
@@ -25178,6 +25620,66 @@ body[data-mpw-modal] [role="dialog"] {
 			};
 		} catch (e) {}
 
+		/** ②(2026-10-10 第五批真机) **专用去截断趟**：宿主 material 菜单（data-menu-material /
+		 *  data-trigger-menu，我们按 H 判据故意不给底）与子智能体会话树（ZKlsPq_menu）**自己**也有
+		 *  blur（我们补的或宿主自带的），但它们同样会被祖先的 backdrop root 截断 —— 有壁纸时输入框
+		 *  卡片 uV2eYG_card(blur 14px)/侧栏/面板都有我们的模糊，弹层的 blur 只能采样祖先内部
+		 *  ⇒ 用户看到的正是"没壁纸时模糊正常，一上壁纸只剩白底、没有模糊"。
+		 *
+		 *  为什么**不**复用上面的 A/B/C 分类：那套里的 C 路（"祖先不是包装容器"）刻意"一个都不摘"，
+		 *  是为"用户正在看的面板"设计的；而这类弹层的祖先恰恰就是包装容器，必须摘。
+		 *  这里只做一件事：找**最近的**一个带 blur 的祖先（或已被我们标记过的），交给同一趟
+		 *  mpwPopUntruncApply ⇒ 与主路共用同一份幂等状态，不会互相撤标记。
+		 *  只往 need 里**加**、从不删 ⇒ 主路（尤其 popover-glass 的 B1 输入框卡片 case）不受影响。 */
+		function mpwPopUntruncExtra(need) {
+			let added = 0;
+			/* ③(2026-10-10 真机层次读数定案) 给"宿主 material 外壳里的内层容器"打标记：
+			   真机读数——shell radius=16px / material radius=16px(58% 白) / **groups radius=0px**
+			   且 groups 拿到了 blur(11px)（我们的规则 + 老 G 块两条都按 [role="menu"] 命中它）
+			   ⇒ 它把自己身后的白底在**方形区域内**又糊一遍 = 用户看到的"外面圆角正常、里面直角白矩形"。
+			   这里只做标记，压制交给 CSS 一条 !important 中和规则（不改任何既有规则文本，
+			   避免扰动 token-namespace 的四表面基线）。 */
+			try {
+				const want = new Set();
+				const shells = document.querySelectorAll('[data-menu-material], [data-trigger-menu], [class*="ZKlsPq_menu"]');
+				for (let i = 0; i < shells.length; i++) {
+					const inner = shells[i].querySelectorAll('[role="menu"], [role="listbox"], [class*="_groups"]');
+					for (let k = 0; k < inner.length; k++) want.add(inner[k]);
+				}
+				const stale = document.querySelectorAll("[data-mpw-menu-inner]");
+				for (let i = 0; i < stale.length; i++) {
+					if (want.has(stale[i])) continue;
+					try { stale[i].removeAttribute("data-mpw-menu-inner") } catch (e) {}
+					/* 同步清掉内联（宿主逐字还原，不给它留残留样式） */
+					try { stale[i].style.removeProperty("backdrop-filter") } catch (e) {}
+					try { stale[i].style.removeProperty("-webkit-backdrop-filter") } catch (e) {}
+				}
+				for (const el of want) { if (!el.hasAttribute("data-mpw-menu-inner")) { try { el.setAttribute("data-mpw-menu-inner", "") } catch (e) {} } }
+			} catch (e) { /* 忽略 */ }
+			try {
+				const els = document.querySelectorAll('[data-menu-material], [data-trigger-menu], [class*="ZKlsPq_menu"]');
+				for (let i = 0; i < els.length; i++) {
+					const el = els[i];
+					try {
+						const cs = getComputedStyle(el);
+						if (!cs || cs.display === "none" || cs.visibility === "hidden") continue;
+						/* 自己没有模糊 ⇒ 没有"被截断"这回事（别去动祖先） */
+						if (!cs.backdropFilter || String(cs.backdropFilter).indexOf("blur") < 0) continue;
+						for (let p = el.parentElement, k = 0; p && p !== document.body && p !== document.documentElement && k < 12; p = p.parentElement, k++) {
+							let acs = null;
+							try { acs = getComputedStyle(p) } catch (e) { break }
+							const declared = !!(p.hasAttribute && p.hasAttribute("data-mpw-pop-untrunc"));
+							const ablur = declared || (acs && acs.backdropFilter && acs.backdropFilter !== "none" && String(acs.backdropFilter).indexOf("blur") >= 0);
+							if (!ablur) continue;
+							if (mpwPopCanCtx(p, acs)) { need.add(p); added++ }
+							break;   // 只处理最近的一个（与主路"第一个截断祖先"语义一致）
+						}
+					} catch (e) { /* 单个元素失败不影响其它 */ }
+				}
+			} catch (e) { /* 忽略 */ }
+			return added;
+		}
+
 		function mpwPopClassifySync() {
 			try {
 				const surfaces = document.querySelectorAll("[data-mpw-pop-bg]");
@@ -25228,6 +25730,9 @@ body[data-mpw-modal] [role="dialog"] {
 				};
 				sync("data-mpw-pop-glass", glasses);
 				sync("data-mpw-pop-trunc", truncated);
+				/* ②(第五批) 宿主 material 菜单 / 触发候选菜单 / 子智能体会话树：只**补**祖先进 need，
+				   不参与上面的 glasses/truncated 打标（那会让它们吃到我们的底，回到"叠两层白"的老问题）。 */
+				try { mpwPopUntruncExtra(neutralize) } catch (e) {}
 				mpwPopUntruncApply(neutralize);
 				return glasses.size + truncated.size;
 			} catch (e) { return 0 }

package/lib/index.js

@@ -680,10 +680,36 @@ function isWsl(release, env, exists) {
   } catch { return false; }
 }
 
+/** WE「已安装」标记（相对安装目录的路径，**两级 × 两个位宽**逐项探测）。
+ *
+ *  为什么不是单个顶层 `wallpaper32.exe`：Wallpaper Engine 2.x 起把可执行文件从安装目录顶层移进了
+ *  `distribution/` 子目录（顶层只剩 `ChromaAppInfo.xml` / `installer.exe` / `launcher.exe`），只探顶层
+ *  ⇒ 明明装了也判成"未安装" ⇒ `/steam-inventory` 永远回 `installDir:null` + 空清单（`projects/*` 与
+ *  工坊库一起扫不到）。上游同缺陷（"安装目录探测失败：`wallpaper32.exe` 位于 `distribution/` 子目录"）
+ *  的建议修法就是逐级回退，这里取同一口径。
+ *
+ *  为什么不用 `version.json` 当标记：那是"某个像 WE 的目录"的弱证据，而本判据决定是否去读该目录下的
+ *  `project.json` 与工坊库 —— 读错目录等于把无关目录当壁纸库。宁可用可执行文件这种强标记
+ *  （上游报告者给出的应急绕行也是"在顶层给 `distribution/wallpaper32.exe` 建软链"）。
+ *
+ *  纯函数（`exists` 可注入）：判断是契约，要能在**没装 WE** 的机器上逐项断言。 */
+export const WE_INSTALL_MARKERS = [
+  'distribution/wallpaper32.exe',
+  'distribution/wallpaper64.exe',
+  'wallpaper32.exe',
+  'wallpaper64.exe',
+];
+export function weInstallMarker(dir, exists = existsSync) {
+  for (const rel of WE_INSTALL_MARKERS) {
+    try { if (exists(join(dir, ...rel.split('/')))) return rel; } catch { /* 注入的 exists 抛 ⇒ 换下一个标记，绝不外抛 */ }
+  }
+  return null;
+}
+
 /** ③ 自动发现：定位壁纸引擎安装目录（Steam libraryfolders.vdf + 常见路径探测）。
  *  ①(修正) 补非 Windows 平台探测：macOS/Linux/WSL 也各自有 Steam 安装路径。
  *  候选清单本身在纯函数 steamProbeDirs() 里（平台分支都在那里，可注入、可在非 WSL 机器上断言）；
- *  本函数只负责"注册表优先 → 逐个候选读 libraryfolders.vdf → 只认 wallpaper32.exe 存在的那一个"。
+ *  本函数只负责"注册表优先 → 逐个候选读 libraryfolders.vdf → 只认安装标记（见 WE_INSTALL_MARKERS）存在的那一个"。
  *  路径是纯字符串，平台用不到时 existsSync 自然为 false，无副作用。 */
 function locateWallpaperEngine() {
   const probes = [];
@@ -709,10 +735,10 @@ function locateWallpaperEngine() {
   const roots = [...new Set([...probes, ...libraries])];
   for (const root of roots) {
     const dir = join(root, 'steamapps', 'common', 'wallpaper_engine');
-    if (existsSync(join(dir, 'wallpaper32.exe'))) return dir;
+    if (weInstallMarker(dir)) return dir;
   }
   const alt = 'C:\\Program Files (x86)\\Wallpaper Engine';
-  return existsSync(join(alt, 'wallpaper32.exe')) ? alt : null;
+  return weInstallMarker(alt) ? alt : null;
 }
 
 // ①(修正) 硬依赖 webServer：cordis 等待 HTTP 服务挂载后再 apply（dsh-wallpaper-engine 同款）。

package/lib/web-wallpaper.js

@@ -9,7 +9,7 @@
 // 本文件做七件事（都在**宿主侧或帧内 shim 里**，渲染器零改动）：
 //   ① `detectWebWallpaperKind`：按**内容**判定 web/scene/video/unknown（声明只是线索，不是依据）
 //   ② `WEB_SHIM_SOURCE`：WE API shim（注入到 iframe 内，**在作者脚本之前**执行）
-//   ③ `rewriteWebEntryHtml`：把 shim（可选种子脚本）插到入口 HTML 的 `<head>` 最前
+//   ③ `rewriteWebEntryHtml`：把帧级夺焦围栏（`mpwFocusGuardSource`）+ shim（可选种子脚本）插到入口 HTML 的 `<head>` 最前
 //   ④ `webAssetCorsHeaders`：跨源策略——只给「沙箱帧的不透明源（Origin: null）」放行读取
 //   ⑤ 交互注入（第 11 条）：shim 侧把父页推来的指针/滚轮/键盘按 WE 语义还原成帧内合成 DOM 事件
 //      （父页侧的舞台、事件整形与开关状态机在 `lib/web-interaction.js`）
@@ -54,6 +54,81 @@ export const SHIM_MSG = 'mpw:web';
 /** shim 版本（父页握手校验用） */
 export const SHIM_VERSION = 1;
 
+/** 帧级夺焦围栏 `<script>` 的标记属性（见 mpwFocusGuardSource） */
+export const FOCUS_GUARD_ATTR = 'data-mpw-focus-guard';
+
+/** 网页壁纸的**帧级夺焦围栏** —— 一段以文本形式注入壁纸文档的经典脚本。
+ *
+ *  现象（上游同族缺陷 + 机制可静态闭合）：播某些网页类壁纸时，DSH 自己的输入框 / 下拉框 /
+ *  账号菜单**每被点一次就失去焦点**（窗口仍在焦点、`relatedTarget` 为 null ⇒ 焦点被搬进了
+ *  **另一个文档**）。与点击位置无关，只有"必须持有键盘焦点才正常"的那类控件看得出来。
+ *
+ *  机制（三步，本插件的架构逐条对得上）：
+ *    ① 壁纸层在宿主页里是**背景**（`pointer-events:none`），鼠标事件由 DSH UI 消费，我们再把
+ *       pointer 事件经 `window.__wp.pushPointer` / postMessage 注入壁纸帧（`lib/web-interaction.js`）；
+ *    ② 注入落点 = 帧内 shim 用 `elementFromPoint` 命中元素后 `dispatchEvent` 的**合成事件**
+ *       （`isTrusted === false`，与用户真点壁纸可区分）；
+ *    ③ 作者为了在 WE 桌面模式下"让键盘有处可去"，常在**捕获相 mousedown** 里调 `window.focus()`
+ *       ⇒ 宿主里**任何位置**点一下，焦点就被搬进壁纸帧，DSH 的 composer / 下拉框当场丢焦点。
+ *
+ *  为什么可以整条废掉：本插件把键盘送进帧靠的是**父页捕获相监听 + shim 合成 KeyboardEvent**
+ *  （`op:"key"`，仅交互 full 档），帧级焦点**不是**必要条件；反过来，帧一旦抢到焦点，父页的
+ *  keydown 监听就不再触发 ⇒ 交互注入自己也会静默失效。围栏只拦**帧级** `window.focus()`；
+ *  元素级 `HTMLElement.prototype.focus()` 原样放行 —— 壁纸自己的编辑框、模态输入框、软键盘
+ *  照常工作（那才是它真正需要的焦点）。
+ *
+ *  实现纪律：
+ *   · 注入体是**源码文本**（`mpwFocusGuardSource()` 用 `Function.prototype.toString` 取下面那个
+ *     函数的原文 ⇒ 函数体必须**自足**：只碰 `window` 与标准内建，不引用本模块作用域的名字、
+ *     不用 import/export（它被当经典脚本执行）；
+ *   · 只随 `?mpwshim=1` 那条路注入（= auto/sandbox 档，帧是不透明源、键盘本来就走我们的合成通道）。
+ *     **compat 档不注入**：那一档用户显式要"等价裸 iframe"，作者页可能要真的拿键盘，围栏会让它静默失灵；
+ *   · 绝不抛：壁纸文档里的任何异常都会毁掉作者脚本，而围栏的意义恰恰是"别让宿主被第三方代码拖下水"
+ *     ⇒ 每步各自 try/catch，失败只体现为 `__mpwFocusGuard.installed === false`；
+ *   · 留计数 + 一条回执：`window.__mpwFocusGuard = { version, calls, blocked, allowed, installed, allow }`
+ *     （帧内控制台一眼能看到拦了多少次）；**第一次真拦下**时给父页回一条
+ *     `{mpw:'mpw:web', op:'focus-guard', blocked, calls}` ⇒ 宿主诊断里能直接看到"这张壁纸在夺焦"。
+ *     `allow = true` 是**逃生门**（给对比测试用，不是用户开关）：置 true 后原函数照旧调用、`allowed` 累加。
+ *
+ *  已知残留（不在围栏射程内）：跨源 WindowProxy 上的 `top.focus()` / `parent.focus()` 无法从壁纸
+ *  文档侧改写（同源策略允许调用、禁止改写），要拦只能在宿主半拦，代价是与作者页拉锯，本仓不做；
+ *  元素级 `el.focus()` 按上面的理由**故意放行**。真出现这两类时 `__mpwFocusGuard.blocked` 不涨而
+ *  症状仍在 —— 那就是残留，别把它读成"围栏没生效"。 */
+export function mpwFocusGuardSource(msgName) {
+  return '(' + mpwFocusGuardInstall.toString() + ')(' + JSON.stringify(String(msgName || SHIM_MSG)) + ');';
+}
+
+/** 注入体本身（自足；注释会随源码一起进 HTML，写短） */
+function mpwFocusGuardInstall(msg) {
+  var w = window;
+  if (w.__mpwFocusGuard) return;                      // 幂等：同一文档重复注入只装一次（计数不重置）
+  var guard = { version: 1, calls: 0, blocked: 0, allowed: 0, installed: false, allow: false, reported: false };
+  w.__mpwFocusGuard = guard;
+  var report = function () {                          // 第一次真拦下时给父页一条回执（宿主 /diag 可见）
+    if (guard.reported) return;
+    guard.reported = true;
+    try { if (w.parent && w.parent !== w) w.parent.postMessage({ mpw: msg, op: "focus-guard", blocked: guard.blocked, calls: guard.calls }, "*"); } catch (e) { /* 父页不可达：忽略 */ }
+  };
+  var raw = null;
+  try { raw = w.focus; } catch (e) { raw = null; }
+  if (typeof raw !== "function") return;              // 没有可拦的 focus：如实退场（installed 仍 false）
+  var patched = function () {
+    guard.calls += 1;
+    if (guard.allow) { guard.allowed += 1; return raw.apply(w, arguments); }
+    guard.blocked += 1;                               // 帧级夺焦：吞掉，不转交原函数
+    report();
+    return undefined;
+  };
+  // ① 直接赋值：Window 上的 focus 是原型上的可写操作 ⇒ 赋值产生自有属性并遮蔽它。
+  try { w.focus = patched; } catch (e) { /* 只读/访问器：交给 ② */ }
+  // ② 赋值没生效（继承来的不可写属性 / 访问器）时改用 defineProperty —— 自有属性的创建
+  //    不受继承链约束，所以这条腿覆盖 ① 覆盖不到的形态。
+  if (w.focus !== patched) {
+    try { Object.defineProperty(w, "focus", { configurable: true, writable: true, value: patched }); } catch (e) { /* 如实记账 */ }
+  }
+  guard.installed = w.focus === patched;
+}
+
 /** 帧内存储 facade 的查询开关：缺省开（`mpwstore=0` 关 = 完全不装 facade，退回旧行为）。
  *  为什么需要开关：① 逐字节负面对照（关掉时注入的种子与帧内行为与改动前一致）；
  *  ② 极端页面上作者的存储语义与我们的内存 facade 冲突时的逃生门（不影响渲染主路径）。 */
@@ -644,7 +719,11 @@ export function rewriteWebEntryHtml(html, opts = {}) {
   if (/data-mpw-we-shim(=|[\s>"'])/i.test(src)) return src;
   if (opts.fileUrlBase) src = rewriteWebFileUrlsInHtml(src, { basePath: opts.fileUrlBase }).html;
   const shim = typeof opts.shimSource === 'string' && opts.shimSource ? opts.shimSource : WEB_SHIM_SOURCE;
-  const inject =
+  // 帧级夺焦围栏**排在 shim 前**：即使 shim 自己抛错，焦点围栏也已经装好（见 mpwFocusGuardSource）。
+  // `opts.focusGuard === false` 是逐字节对照口（只给判据用；生产调用点不传）。
+  const guard = opts.focusGuard === false ? '' :
+    '<script ' + FOCUS_GUARD_ATTR + '="' + SHIM_VERSION + '">\n' + escapeScriptClose(mpwFocusGuardSource(opts.shimMsg)) + '\n</script>';
+  const inject = guard +
     '<script ' + SHIM_ATTR + '="' + SHIM_VERSION + '">\n' + escapeScriptClose(shim) + '\n</script>' +
     (opts.seedScript ? '\n<script ' + SHIM_ATTR + '-seed="' + SHIM_VERSION + '">\n' + escapeScriptClose(opts.seedScript) + '\n</script>' : '');
   const head = /<head(\s[^>]*)?>/i.exec(src);
@@ -810,7 +889,10 @@ export const WEB_SHIM_SOURCE = `(function () {
      这里在帧内如实探一次并上报，父页据此（配合 error 上报）给出**可判定的降级**：
      自动切到兼容模式（同源）重载一次，并留下可查状态。探测本身全部 try/catch，绝不影响页面。 */
   function probeCaps() {
-    var out = { version: 1, opaque: false, storage: null, storageReal: null, worker: null, blobUrl: null, offscreen: null, module: null };
+    var out = { version: 1, opaque: false, storage: null, storageReal: null, worker: null, blobUrl: null, offscreen: null, module: null, focusGuard: null };
+    /* 帧级夺焦围栏是否在位（父页据此知道"这张壁纸的 window.focus() 已被吞掉"；计数在帧内
+       window.__mpwFocusGuard，越权夺焦时另有一条 op:"focus-guard" 回执 —— 见 mpwFocusGuardSource）。 */
+    try { var fg = W.__mpwFocusGuard; out.focusGuard = fg ? { version: Number(fg.version) || 0, installed: !!fg.installed, allow: !!fg.allow } : null; } catch (e) { out.focusGuard = "error"; }
     try { out.opaque = (W.location && W.location.origin === "null") || W.origin === "null"; } catch (e) { out.opaque = null; }
     try { out.storage = (function () { try { W.localStorage.setItem("__mpwProbe", "1"); var v = W.localStorage.getItem("__mpwProbe"); W.localStorage.removeItem("__mpwProbe"); return v === "1" ? "ok" : "mismatch" } catch (e) { return "blocked:" + String(e && e.name || e) } })(); } catch (e) { out.storage = "error"; }
     try { out.storageReal = !!(W.__mpwWebStore && W.__mpwWebStore.real === true); } catch (e) { out.storageReal = null; }

package/package.json

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