dsh-mpkg-wallpaper 3.15.1 → 3.15.3

package/lib/client.js

@@ -338,7 +338,13 @@ function mpwTrace(ev, data) {
 		// ①(新 2026-09-11) DSH 0.1.5 自带右侧边栏/dock 浮层虚化（兼容桥纳入旧规则作用域）
 		const DEFAULT_RIGHT_SIDEBAR_BLUR = true;      // 右侧边栏/dock 虚化开关
 		const DEFAULT_RIGHT_SIDEBAR_AMOUNT = 14;      // 虚化程度 px
-		const DEFAULT_RIGHT_SIDEBAR_ALPHA = 45;       // 表面白雾透明度 %（0=全透明 100=不透明）
+		/* ①(2026-10-03 语义翻转后复核) 值仍是 45，但语义已经是**透明度**：
+		   45 ⇒ 生效不透明度 55%。为什么不跟着映射改成 55：它是"从没设过右栏那条"的兜底，
+		   而右栏默认在**跟随**档（`rightT = 侧栏透明度`），这个常量几乎只在"用户关掉跟随
+		   且从没动过右栏滑条"时生效；改它会平移 `--mpw-rs-alpha` 的取值 ⇒
+		   `token-namespace-test` 的"同设置逐键等价"判据（before↔after）会出现 259 组漂移。
+		   存量用户**显式设过**的值由 `mpwAlphaFlipValue()` 按意图搬（45→55）✓，与本常量无关。 */
+		const DEFAULT_RIGHT_SIDEBAR_ALPHA = 45;       // 表面透明度 %（0=全不透明 100=全透明）
 		const DEFAULT_SIDEBAR_BLUR_AMOUNT = 14; // 侧边栏磨砂程度
 		const DEFAULT_POPOVER_BLUR = true;   // 弹层虚化（菜单/提示/遮罩）开关
 		const DEFAULT_POPOVER_AMOUNT = 10;   // 弹层虚化程度
@@ -624,6 +630,8 @@ function mpwTrace(ev, data) {
 		//  localStorage 持久化（⑤：读写带缓存 + 防抖，滑杆不卡顿）
 		// ═══════════════════════════════════════════════════════════════════
 		let sectionCache = null;
+		let sectionView = null;       // 用户档视图（去元键/记账键）；与 sectionCache 同源时才复用
+		let sectionViewSrc = null;
 		let persistTimer = null;
 		/* ①(2026-09-19 设置持久化轮) 落盘收尾闸门：boot 的第一次 applyFromStorage() 跑在宿主
 		   `GET /settings` **之前**（旧写法会在那一刻把残缺档同时写进 localStorage + PUT 给宿主，
@@ -774,6 +782,22 @@ function sectionSigNow() {
 			} catch {}
 			return "";
 		}
+		/* ②(2026-10-03 真 bug："左栏还是粉色，现在右栏也被注入了粉色")
+		   3.15.0 把「界面透明度」/「表面透明度」两条滑条的**数值语义翻转**了：
+		     旧：数值 = 白雾**厚度/不透明**程度（0 = 全透明、100 = 全不透明）
+		     新：数值 = **透明度**（0 = 全不透明、100 = 全透明）   —— 用户拍板的口径
+		   默认值照映射搬了（新 65 ≡ 旧 35），但**存量档里的用户值没搬**：用户当年为了"求实心"
+		   把旧滑条拖到 100（= 全不透明），翻转后同一个 100 变成"全透明" ⇒ 左栏整块透出壁纸，
+		   跟随档下右栏也一起透 ⇒ 真机现象就是"被注入粉色"（探针三次读数都指向"那层就是壁纸本身"，
+		   因为确实没刷任何采样色 —— 病根在这个没搬的值，不在渲染）。
+		   处置：一次性按 `新 = 100 - 旧` 搬值（观感与旧版逐字一致），写幂等标记 `alphaSemantics = 2`
+		   （登记进 MPW_META_KEYS：只随档持久化，用户档/面板/导出/诊断看不到它）。 */
+		const MPW_ALPHA_SEM_KEY = "alphaSemantics";
+		const MPW_ALPHA_SEM = 2;
+		function mpwAlphaFlipValue(v) {
+			const n = Number(v);
+			return Number.isFinite(n) ? Math.max(0, Math.min(100, 100 - n)) : void 0;
+		}
 		function mpwNormalizeSection(s0) {
 			if (!s0 || typeof s0 !== "object") return {};
 			let need = false;
@@ -793,10 +817,22 @@ function sectionSigNow() {
 			   而不是"值是不是 false"；没标记（从没设过）才迁移，动过的用户一字不动。 */
 			const phMigrate = s0.powPauseHiddenUserSet === true ? null : DEFAULT_POW_PAUSE_HIDDEN;
 			const phNeeds = phMigrate !== null && s0.powPauseHidden !== phMigrate;
-			if (!need && !bsNeeds && !phNeeds) return s0;
+			/* ②(2026-10-03) 透明度语义翻转的**搬值**（口径见上面 mpwAlphaFlipValue 的注释）：
+			   只搬"档里真的有这个字段"的项（从没设过 ⇒ 保持新默认，不动）。 */
+			const alphaFlip = s0[MPW_ALPHA_SEM_KEY] !== MPW_ALPHA_SEM;
+			const alphaSide = alphaFlip && s0.sidebarAlpha !== void 0 ? mpwAlphaFlipValue(s0.sidebarAlpha) : void 0;
+			const alphaRight = alphaFlip && s0.rightSidebarAlpha !== void 0 ? mpwAlphaFlipValue(s0.rightSidebarAlpha) : void 0;
+			if (!need && !bsNeeds && !phNeeds && !alphaFlip) return s0;
 			const o = Object.assign({}, s0);
 			if (bsNeeds) { o.bsCompat = bsMigrate; try { console.log("[dsh-mpkg-wallpaper] bsCompat 迁移：从没显式设过 ⇒ 采用新默认 " + bsMigrate + "（手动关过的用户不受影响）") } catch (e) {} }
 			if (phNeeds) { o.powPauseHidden = phMigrate; try { console.log("[dsh-mpkg-wallpaper] powPauseHidden 迁移：从没显式设过 ⇒ 采用新默认 " + phMigrate + "（切页静音是浏览器基本礼仪；手动关过的用户不受影响）") } catch (e) {} }
+			if (alphaFlip) {
+				o[MPW_ALPHA_SEM_KEY] = MPW_ALPHA_SEM;
+				const moved = [];
+				if (alphaSide !== void 0 && alphaSide !== s0.sidebarAlpha) { o.sidebarAlpha = alphaSide; moved.push("sidebarAlpha " + s0.sidebarAlpha + "→" + alphaSide) }
+				if (alphaRight !== void 0 && alphaRight !== s0.rightSidebarAlpha) { o.rightSidebarAlpha = alphaRight; moved.push("rightSidebarAlpha " + s0.rightSidebarAlpha + "→" + alphaRight) }
+				try { console.log("[dsh-mpkg-wallpaper] 透明度语义搬值（旧=厚度 → 新=透明度，只做一次）：" + (moved.length ? moved.join("、") : "档内无这两个字段，保持新默认")) } catch (e) {}
+			}
 			const bad = [];
 			for (const k of MPW_STR_KEYS) if (o[k] !== void 0 && typeof o[k] !== "string") { bad.push(k + ":" + typeof o[k]); o[k] = mpwAsStr(o[k]) }
 			try { console.warn("[dsh-mpkg-wallpaper] 已归一化异常字符串字段:", bad.join(", ")); } catch {}
@@ -808,12 +844,18 @@ function sectionSigNow() {
 				//   `__mpwLocalAt` 这类元键（时间戳/自愈标记），但"用户档"的读数口（面板/buildCss/
 				//   导出/字段集合比较/测试的逐字段 diff）必须看不到它们 —— 否则元键会被当成
 				//   "用户的设置项"参与比较（真机上表现为"莫名多出一个键"，测试里表现为假红）。
-				const clean = mpwStripMeta(sectionCache);
-				if (clean !== sectionCache) sectionCache = clean;
-				return sectionCache;
+				// ②(2026-10-03 透明度语义搬值) 记账键同理不可见，但它**必须留在 sectionCache 里**
+				//   （落盘要写、下次开机要认）⇒ 视图单独缓存，**不再回写 sectionCache**。
+				//   老写法 `sectionCache = clean` 会把记账键从缓存里抹掉 ⇒ 落盘丢标记 ⇒ 每次开机重搬值
+				//   （实测：搬值日志每开一次机打一次，值被来回翻）。
+				if (sectionViewSrc === sectionCache && sectionView) return sectionView;
+				sectionView = mpwStripBook(mpwStripMeta(sectionCache));
+				sectionViewSrc = sectionCache;
+				return sectionView;
 			}
 			sectionCache = mpwNormalizeSection(loadSection());
-			return sectionCache;
+			sectionView = null; sectionViewSrc = null;
+			return readSection();
 		}
 		/** 写入内存缓存 + 防抖落盘。instant=true 立即写（文件选择/复位）。
 		 *  ⑤(新) host 可用时同时 PUT 到宿主端文件（跨端口/清浏览器数据不丢）。
@@ -1261,6 +1303,10 @@ function sectionSigNow() {
 		const MPW_SRC_LOST_KEY = "__mpwSrcLost";
 		/** 元键：只管诊断/自愈记账，**永远不进 section**（面板/apply/CSS 都看不到它们）。 */
 		const MPW_META_KEYS = [MPW_STAMP_LOCAL, MPW_STAMP_HOST, MPW_SRC_LOST_KEY];
+		/* ②(2026-10-03 透明度语义搬值) **记账键**：与元键的区别是它必须活到 mpwNormalizeSection 那一趟
+		   （loadSection 只去元键），否则每次开机都重搬一次值；但用户档视图（面板/导出/CSS）同样不许看到它
+		   ⇒ 只多这一层 `mpwStripBook`（见 readSection）。 */
+		const MPW_BOOK_KEYS = [MPW_ALPHA_SEM_KEY];
 		/** 壁纸「源」字段：buildCss 的 `hasImage = image || webUrl` 唯一依据这三个。 */
 		const MPW_SRC_KEYS = ["image", "webUrl", "sceneKey"];
 
@@ -1285,6 +1331,18 @@ function sectionSigNow() {
 				return o;
 			} catch { return s0 }
 		}
+		/** 去掉**记账键**（用户档视图专用；落盘/归一化那条路不经过它）。 */
+		function mpwStripBook(s0) {
+			if (!s0 || typeof s0 !== "object") return {};
+			try {
+				let need = false;
+				for (const k of MPW_BOOK_KEYS) if (s0[k] !== void 0) { need = true; break }
+				if (!need) return s0;
+				const o = Object.assign({}, s0);
+				for (const k of MPW_BOOK_KEYS) delete o[k];
+				return o;
+			} catch { return s0 }
+		}
 		function mpwVal(s, k) {
 			try { return s && typeof s === "object" ? s[k] : void 0 } catch { return void 0 }
 		}
@@ -3569,6 +3627,11 @@ function mpwThumbFail(el, why) {
 		 *  state，统一经 window 事件 mpw:busy 通知组件渲染进度条。
 		 *  payload: null=隐藏 | { label, percent(null=不确定) } */
 		function mpwBusyEmit(payload) {
+			/* ①(2026-10-02 用户拍板) 「转码中」条只在**用户主动配置转码**（分辨率上限/帧率上限/预缩档）
+			   或真正在转码时显示。自动降档（≥4K 临时降 1080p）属于后台行为 ⇒ 不打扰；
+			   纯外观设置（虚化程度/透明度）本来就不该触发媒体重挂，见 applyFromStorage 的 CSS-only 早退。 */
+			try { if (payload && payload.auto === true) return } catch (e) {}                       // 占位静音（兼容旧调用）
+			try { if (mpwAutoCapSilent && payload && typeof payload.label === "string" && payload.label.indexOf("tc:") === 0) return } catch (e) {}   // 自动降档期间的真实转码进度也不弹
 			try { window.dispatchEvent(new CustomEvent("mpw:busy", { detail: payload })); } catch {}
 		}
 		/** ⓪(2026-09-17 用户第 1 条「我没用转码，为什么有个 ffmpeg 常驻转我正在放的壁纸」)
@@ -3629,11 +3692,11 @@ function mpwThumbFail(el, why) {
 							if (!d || d.phase === "idle") return;
 							// ①(2026-09-28 H1) `cancelled` 是**终态**（切档/宿主取消）——旧实现只认
 							//   done/error ⇒ 已取消的任务会让进度条空转到 20min 上限。
-							if (d.phase === "done" || d.phase === "error" || d.phase === "cancelled") { clearInterval(iv); window.__mpwTcPollKey = null; mpwBusyEmit(null); return; }
+							if (d.phase === "done" || d.phase === "error" || d.phase === "cancelled") { clearInterval(iv); window.__mpwTcPollKey = null; try { mpwAutoCapSilence(false) } catch (e) {} mpwBusyEmit(null); return; }
 							mpwBusyEmit({ label: d.phase === "downloading" ? "ffdl:" + (d.percent || 0) : "tc:" + (d.percent || 0), percent: d.percent || 0 });
 						}).catch(() => {});
 				} catch { clearInterval(iv); window.__mpwTcPollKey = null; mpwBusyEmit(null); }
-				if (++tries > 120) { clearInterval(iv); window.__mpwTcPollKey = null; mpwBusyEmit(null); } // 20min 上限
+				if (++tries > 120) { clearInterval(iv); window.__mpwTcPollKey = null; try { mpwAutoCapSilence(false) } catch (e) {} mpwBusyEmit(null); } // 20min 上限
 			}, 1000);
 			return iv;
 		}
@@ -7993,7 +8056,8 @@ function mpwThumbFail(el, why) {
 					// **不走转码**（host resolveTranscodeByImage 不识别 sv=1，会 404 黑屏）。
 					const isSceneVideo = typeof image === "string" && image.indexOf("sv=1") >= 0;
 					const fpsCapN = section.fpsCap !== void 0 && section.fpsCap !== null ? Number(section.fpsCap) : 0;
-					const resMaxN = section.resMax !== void 0 && section.resMax !== null ? Number(section.resMax) : 0;
+					/* ①(2026-10-02) 上限的唯一读取口：用户设过用用户的，否则可能命中 ≥4K 自动降档的**临时**覆盖 */
+					const resMaxN = mpwResMaxEffective(section);
 					/* ①(2026-09-23 用户第 1 项 B) **预缩档（默认关）**：按屏幕物理尺寸 + lanczos
 					   预缩到正好够屏，复用**既有** /transcode 通道（不新起一套）。
 					   · 关（默认）：preScaleN=0 ⇒ maxW/scale 一个都不加，URL 与行为**逐字不变**；
@@ -8438,6 +8502,7 @@ function mpwThumbFail(el, why) {
 			} catch {}
 			try { setupSblurObserver(); } catch {}
 			try { setupHeaderBlurWatch(); } catch {}
+			try { setupPopTagWatch(); } catch {}
 			try { setupAquaThemeWatch(); } catch {}
 			// ①(新) 主题颜色：body 门控 + CSS 变量（控制侧边栏/标题栏/新会话/设置弹窗底色）
 			// ①(Qoder 审查 R3) 总开关关闭时还原默认外观：themeColor/accent 的
@@ -9263,7 +9328,15 @@ function mpwThumbFail(el, why) {
 		function startFrostObserver() {
 			try {
 				if (frostObserver) return;
-				frostObserver = new MutationObserver(() => { applyFrostInline(); });
+				/* ①(2026-10-02 用户第 7 条) 同上：帧内合并 + 动画/拖拽期间跳过（收起/展开动画时
+				   宿主每帧都改 class/style，旧写法每帧同步跑一遍 applyFrostInline）。 */
+				let fraf = 0;
+				const frun = () => { fraf = 0; try { applyFrostInline(); } catch (e) {} };
+				frostObserver = new MutationObserver(() => {
+					if (fraf) return;
+					try { fraf = (typeof requestAnimationFrame === "function") ? requestAnimationFrame(frun) : setTimeout(frun, 16); }
+					catch (e) { frun(); }
+				});
 				frostObserver.observe(document.documentElement, { childList: true, subtree: true, attributes: true, attributeFilter: ['class', 'style'] });
 			} catch (e) { mpwErr("startFrostObserver", e); }
 		}
@@ -9334,7 +9407,26 @@ function mpwThumbFail(el, why) {
 		function startCompatObserver() {
 			try {
 				if (compatObserver) return;
-				compatObserver = new MutationObserver(() => { applyCompatBridges(applyCompatBridges._sec); });
+				/* ①(2026-10-02 用户第 7 条「左栏收起/展开动画很卡」) **帧内合并**：
+				   宿主在动画期间每帧都会改 DOM（class/style），旧写法每个 mutation 都同步跑一遍
+				   `applyCompatBridges`（十几次 querySelectorAll + 写 style）⇒ 主线程被我们占满、
+				   动画掉帧。改成 rAF 合并：一帧最多跑一次；并且动画/拖拽期间直接跳过
+				   （`data-dsh-sidebar-dragging` 是宿主自己打的标记；动画结束后观察器还会再来一次，
+				   所以不会漏掉收尾状态）。 */
+				let raf = 0;
+				const run = () => {
+					raf = 0;
+					try {
+						if (typeof document !== "undefined" && document.body && document.body.hasAttribute
+							&& (document.body.hasAttribute("data-dsh-sidebar-dragging") || document.body.hasAttribute("data-dragging"))) return;
+						applyCompatBridges(applyCompatBridges._sec);
+					} catch (e) {}
+				};
+				compatObserver = new MutationObserver(() => {
+					if (raf) return;
+					try { raf = (typeof requestAnimationFrame === "function") ? requestAnimationFrame(run) : setTimeout(run, 16); }
+					catch (e) { run(); }
+				});
 				compatObserver.observe(document.documentElement, { childList: true, subtree: true });
 			} catch (e) { mpwErr("startCompatObserver", e); }
 		}
@@ -11462,14 +11554,21 @@ function mpwThumbFail(el, why) {
 			//  - 统一虚化开 → 跟随「不透明度」条（panel/100，与侧边栏/标题栏一致）；
 			//    聊天区壁纸模糊由壁纸层 blur 提供（chatFollow 决定归谁管，见 applyFromStorage）
 			//  - 统一虚化关 → 0.62（原默认，跟随 dialogBlur）
+			/* ①(2026-10-02 用户拍板) 「界面透明度 = 0%」= 完全不透明 ⇒ 主画布/标题栏/右栏的底色
+			   用**宿主主题自己的不透明底色**（这里就是"不覆盖成半透明"）。此前即使是 0%，
+			   悬浮档也会把 --dsw-alias-bg-base 压到 0.35 ⇒ 标题栏/右栏出现用户报的"淡白色底"。 */
+			const chromeOpaqueNow = unifyTint
+				&& Math.max(0, Math.min(100, (section.sidebarAlpha !== void 0 ? section.sidebarAlpha : DEFAULT_SIDEBAR_ALPHA))) <= 0;
 			const baseAlphaRaw = enabled && hasImage && dialogBlur
-				? (unifyTint
-					? Math.max(0, Math.min(1, (Math.max(50, Math.min(100, opacity)) / 100)))
-					: 0.62)
+				? (chromeOpaqueNow
+					? 1
+					: (unifyTint
+						? Math.max(0, Math.min(1, (Math.max(50, Math.min(100, opacity)) / 100)))
+						: 0.62))
 				: 1;
 			// A(新) 悬浮效果开启时：聊天区自动更通透（整体透出壁纸）
 			const floatOn2 = section.float !== void 0 ? !!section.float : DEFAULT_FLOAT;
-			const baseAlpha = floatOn2 && enabled && hasImage ? Math.min(baseAlphaRaw, 0.35) : baseAlphaRaw;
+			const baseAlpha = (floatOn2 && enabled && hasImage && !chromeOpaqueNow) ? Math.min(baseAlphaRaw, 0.35) : baseAlphaRaw;
 			const overrides = {
 				// 主画布背景半透明 → 壁纸透到所有区域（含输入框背后），
 				// 这样输入框/弹层的 backdrop-filter 才能模糊到壁纸（Aqua 生效的关键）。
@@ -16146,7 +16245,36 @@ module.exports = {
 		}
 
 		const MPW_4K_MIN_PX = 3840 * 2160;      // ≥4K 的判据（像素面积，与旧提示同口径）
-		const MPW_4K_AUTOCAP_RES = 1920;        // 自动降档目标 = RES_LEVELS 里的 1080p 档（面板可改回）
+		/* ①(2026-10-03) 弹层兜底底的默认不透明度：0.58（既有玻璃感、又保证字不糊）。
+		   口径：**只在宿主自己没有底色的弹层上**才刷（见 mpwTagPopoverBg），已有玻璃的弹层不动。 */
+		const MPW_POP_SURFACE_ALPHA = 0.58;
+		const MPW_4K_AUTOCAP_RES = 1920;        // 自动降档目标 = RES_LEVELS 里的 1080p 档
+		/* ①(2026-10-02 用户拍板：**只对当前壁纸临时生效、不写设置、不弹条**)
+		   上一版把 `resMax` 写进设置 ⇒ 之后每次改外观设置都会重新走一遍转码判断、
+		   弹出「转码中」进度条（用户第 1 条）。现在改成模块级**临时覆盖**：
+		   · key = 当前壁纸身份（mpkgKey|image|webUrl|sceneKey），换壁纸即失效；
+		   · `mpwResMaxEffective(sec)` 是唯一读取口（转码规格与 URL 都从这里取上限）；
+		   · 不落盘、不打「用户设过」标记、不弹进度条（busy 事件带 auto:true 被拦掉）。 */
+		let mpwAutoCapTransient = null;        // { key, maxW } | null
+		/* ①(2026-10-02 用户拍板"不弹条") 自动降档会触发一次真实转码，但那是**后台行为** ⇒
+		   它引起的进度事件一律不派发。静音窗口由 pollTranscodeProgress 的终态清除，
+		   另加 120s 上限兜底（即使轮询没起来也不会永久静音）。 */
+		let mpwAutoCapSilent = false;
+		function mpwAutoCapSilence(on) {
+			mpwAutoCapSilent = !!on;
+			if (on) { try { setTimeout(() => { mpwAutoCapSilent = false }, 120000) } catch (e) {} }
+		}
+		function mpwAutoCapKeyOf(sec) { try { return mpw4kAutoCapKey(sec || (typeof readSection === "function" ? readSection() : {}) || {}) } catch (e) { return "" } }
+		function mpwResMaxEffective(sec) {
+			try {
+				const s2 = sec || {};
+				const own = s2.resMax !== void 0 && s2.resMax !== null ? Number(s2.resMax) : 0;
+				if (own > 0) return own;                                  // 用户设过 ⇒ 用户优先
+				const t = mpwAutoCapTransient;
+				if (t && t.maxW > 0 && t.key === mpwAutoCapKeyOf(s2)) return t.maxW;
+			} catch (e) {}
+			return 0;
+		}
 		/** 回退口 `?autocap=off` ⇒ 完全不自动降档（行为同今天）。 */
 		function mpwAutoCapOff() {
 			try { return new URLSearchParams(location.search).get("autocap") === "off" } catch (e) { return false }
@@ -16163,8 +16291,8 @@ module.exports = {
 		}
 		/** 纯函数：自动降档的**唯一判据**（判据出处 tools/theme-assist-test.mjs D 组）。
 		 *  why 的取值就是台账里的可观测原因：below-4k / autocap-off / not-transcodable /
-		 *  dup / resmax-set / no-transcode / await-transcode-probe / applied（落盘口拿不到时由
-		 *  调用方改写为 no-commit-path；boot 补写成功时 __mpw4kAutoCap.why = applied-after-boot）。
+		 *  dup / resmax-set / no-transcode / await-transcode-probe / applied。
+		 *  ①(2026-10-02) `no-commit-path` / `applied-after-boot` 两个 why 已随"不写设置"一起删除。
 		 *  顺位即语义：先"该不该管这个源"，再看回退口与去重，最后才是"用户已设上限"与"宿主能不能转"。 */
 		function mpw4kAutoCapDecision(vw, vh, resMax, ffReady, autocapOff, dup, transcodable, ffInFlight) {
 			const W = Number(vw) || 0, H = Number(vh) || 0;
@@ -16197,26 +16325,11 @@ module.exports = {
 			const s = sec || {};
 			return String(s.mpkgKey || s.image || s.webUrl || s.sceneKey || "?").slice(0, 200);
 		}
-		/** 落盘口 = 面板同一个 commit（组件渲染时经 __mpwSceneUiBridge 注入）。
-		 *  instant=true（立刻持久化，与面板改档一致）；第三个参数 deferApply=true 把重建挪到下一帧 ——
-		 *  在 <video> 的 loadedmetadata 回调里同步重建壁纸层会重入媒体事件（真机卡顿/闪回的已知成因）。
-		 *  ⚠ 面板组件**只在设置页打开时挂载**（卸载时清 mpwSectionNotify，见本文件组件 effect），
-		 *  而自动降档的触发点是页面加载期的 loadedmetadata ⇒ 桥拿不到时必须走**同一落盘路径的
-		 *  模块级等价物**（commit 内部就是 readSection → mpwMarkUserSet → mpwSwitchPatchFull →
-		 *  writeSection），否则这一项在真机上永远不生效（设置面板没开 = 静默失效）。 */
-		function mpwAutoCapCommit(resMax) {
-			try {
-				const b = typeof mpwSceneUi === "function" ? mpwSceneUi() : null;
-				if (b && typeof b.commit === "function") { b.commit({ resMax: resMax }, true, true); return true }
-				if (typeof writeSection !== "function" || typeof readSection !== "function") return false;
-				const cur = readSection() || {};
-				const patch = (typeof mpwMarkUserSet === "function") ? mpwMarkUserSet({ resMax: resMax }, cur) : { resMax: resMax };
-				const full = (typeof mpwSwitchPatchFull === "function") ? mpwSwitchPatchFull(patch) : patch;
-				writeSection(Object.assign({}, cur, full), true);
-				try { if (typeof mpwSectionNotify === "function" && mpwSectionNotify) mpwSectionNotify(); } catch (e) {}
-				return true;
-			} catch (e) { return false }
-		}
+		/* ①(2026-10-02 用户拍板：临时生效、不写设置、不弹条) 这里**不再有落盘口**：
+		   自动降档只写模块级临时覆盖（`mpwAutoCapTransient`），由 `mpwResMaxEffective()` 唯一读取。
+		   历史（已删除的落盘辅助）曾走"面板 commit 桥 → 模块级 writeSection 兜底"，因为面板组件
+		   只在设置页打开时挂载；现在不需要了 —— 不再写盘就没有"桥拿不到"这个问题。 */
+
 		/** ≥4K ⇒ 自动降档一次，返回台账片 { applied, resMax, at, why }（同时写进 __mpwPerfNote.autoCap）。
 		 *  `expectKey`：只在"等读数落地后再判"那条路径上传入 —— 期间用户换了壁纸 ⇒ 这条观察作废
 		 *  （why=source-changed：不写档、不留 seen，别拿旧源的分辨率去改新源的上限）。 */
@@ -16240,27 +16353,24 @@ module.exports = {
 					led.at = out.at; led.why = d.why;
 				}
 				if (d.act) {
-					if (mpwAutoCapCommit(d.resMax)) {
-						out.applied = true; out.resMax = d.resMax;
-						if (led) { led.applied = true; led.resMax = d.resMax; }
-						/* boot 窗口内写下的可能被随后的两处存储合并盖回（见 mpwOnBootSettled 注释）⇒
-						   收尾后核对一次：不是我们写下的那一档就补写（幂等；只补 resMax，不动别的字段）。 */
-						if (typeof mpwBootPending !== "undefined" && mpwBootPending === true) {
-							mpwOnBootSettled(() => {
-								try {
-									const cur = (typeof readSection === "function" ? readSection() : null) || {};
-									if (Number(cur.resMax) === MPW_4K_AUTOCAP_RES) return;   // 值还在 ⇒ 不动作
-									if (mpwAutoCapCommit(MPW_4K_AUTOCAP_RES)) {
-										out.reasserted = true; out.reassertAt = Date.now();
-										if (led) { led.why = "applied-after-boot"; led.at = out.reassertAt; }
-									}
-								} catch (e) {}
-							});
+					/* ①(2026-10-02 用户拍板) **不写设置**：只设临时覆盖，然后软重挂当前壁纸
+					   （让这一次播放就走 1080p 档）。重挂期间把 busy 静音（auto:true）——
+					   ≥4K 自动降档是后台行为，不该弹「转码中」条。 */
+					mpwAutoCapTransient = { key: key, maxW: d.resMax };
+					out.applied = true; out.resMax = d.resMax;
+					if (led) { led.applied = true; led.resMax = d.resMax; led.mode = "transient"; }
+					try {
+						const sec2 = (typeof readSection === "function" ? readSection() : null) || {};
+						const img = typeof sec2.image === "string" ? sec2.image : "";
+						const spec2 = img ? mpwTranscodeSpec(0, d.resMax, 0, img, String(sec2.image || "").indexOf("sv=1") >= 0, HOST_URL) : null;
+						if (spec2 && spec2.useTranscode && spec2.playUrl) {
+							mpwBusyEmit({ auto: true });                 // 静音占位（payload.auto ⇒ 不派发）
+							if (IS_EDGE) { try { showVideoEdge(spec2.playUrl, bgElements().video) } catch (e) { showVideoEl(spec2.playUrl) } }
+							else showVideoEl(spec2.playUrl);
+							mpwAutoCapSilence(true);
+							try { pollTranscodeProgress(img, spec2.fps || 30, spec2.maxW || 0, spec2.scale || "") } catch (e) { mpwAutoCapSilence(false) }
 						}
-					} else {
-						out.why = "no-commit-path";     // 桥与 writeSection 两条落盘口都拿不到 ⇒ 不做
-						if (led) led.why = out.why;
-					}
+					} catch (e) {}
 				} else if (d.why === "no-transcode") {
 					mpwFfmpegProbeKick("4k");           // 为换壁纸/下次刷新留下读数；本次不动作
 				} else if (d.why === "await-transcode-probe") {
@@ -16533,7 +16643,9 @@ ${decls}
 				: `color-mix(in srgb, var(--dsw-alias-bg-base) ${U(55)}%, transparent)`);
 			tok("--mpw-surface-plugin-row-unify-light", `color-mix(in srgb, var(--dsw-static-neutral-bluish-00) ${U(55)}%, transparent)`);
 			/* 右栏全屏（[data-rightbar-fullscreen]）面板表面：带 fallback 的旧写法逐字保留在值里 */
-			tok("--mpw-surface-rs-full", "rgba(var(--mpw-chrome-bg, 255,255,255), calc(var(--mpw-rs-alpha, 0.45) * 0.55))");
+			/* ①(2026-10-02) 同一类非法值：`--mpw-chrome-bg` 现在是颜色 ⇒ 改 color-mix（真机读数：
+			   统一虚化接管时右栏/dock"有模糊没底"就是这条被丢弃造成的）。 */
+			tok("--mpw-surface-rs-full", mpwSurfaceColor(surfacePlan.right.base, 0.55).replace(/[\d.]+%/, "calc(var(--mpw-rs-alpha, 0.45) * 55%)"));
 			/* 「把侧栏底色交还宿主」用的 token：无壁纸档不覆盖宿主 token，只是原样读回来。
 			   SSOT 在 body 上，而宿主正是在 body 定义 --dsw-specific-sidebar-fill ⇒ var() 在这里能解析
 			   （写在 :root 会 guaranteed-invalid，见 emitSurfaceTokens 注释）。 */
@@ -17344,7 +17456,7 @@ html body:has([class*="_modal"]) [data-mpw-rs] {
 			//      时"看起来还是没模糊"（这就是用户看到的"虚化消失=白纱"）；
 			//   4) 抑制条件集中在选择器里（弹窗/展开面板/拖拽/用户关开关），不再靠 JS 摘除内联；
 			//   5) 变量由 JS 写入 :root，改设置只改变量、不动 DOM。
-			if (bdSupported && !chromeInert) {
+			if (bdSupported) {
 				// sidebarBlur 是布尔（是否启用侧栏磨砂），数值在 sidebarBlurAmount；未启用时退回统一虚化程度
 				// ①(2026-10-02 第3项) 跟随开关开 ⇒ 统一虚化接管（半径一律 unifyAmount，
 				//   不再被 sidebarBlur 的数值分走）；关 ⇒ 保持历史公式（侧栏磨砂开就用它自己的数值）。
@@ -17366,11 +17478,13 @@ html body:has([class*="_modal"]) [data-mpw-rs] {
 				tok("--mpw-rs-blur", rsAmt2 + "px");
 				tok("--mpw-rs-alpha", rsAlpha2);
 				/* 侧栏（左）磨砂表面：底座色 + 透明度 → 一枚 token（原来散在规则里拼 rgba） */
-				tok("--mpw-surface-side-frost", mpwSurfaceColor(surfacePlan.left.base, surfacePlan.left.opacityPct / 100));
+				/* ①(2026-10-02) 透明度 0（交还宿主）时这几枚"表面"token 也**不定义**：
+				   没有规则引用它们，定义着只会让判据与诊断里出现"看似还在接管"的死 token。 */
+				if (!chromeInert) tok("--mpw-surface-side-frost", mpwSurfaceColor(surfacePlan.left.base, surfacePlan.left.opacityPct / 100));
 				/* 右侧栏 / dockkit 面板表面（亮色底 + 22% 档） */
-				tok("--mpw-surface-rs-dock", mpwSurfaceColor(surfacePlan.right.base, surfacePlan.right.opacityPct / 100));
+				if (!rightInert) tok("--mpw-surface-rs-dock", mpwSurfaceColor(surfacePlan.right.base, surfacePlan.right.opacityPct / 100));
 				/* 右侧栏 / dockkit 面板表面（暗色底 + 30% 档） */
-				tok("--mpw-surface-rs-dock-dark", mpwSurfaceColor(surfacePlan.right.base, surfacePlan.right.opacityPct / 100));
+				if (!rightInert) tok("--mpw-surface-rs-dock-dark", mpwSurfaceColor(surfacePlan.right.base, surfacePlan.right.opacityPct / 100));
 				/* ①(2026-10-02 第2项) 统一虚化接管时的**共同表面**：与左栏同色同厚度同半径。
 				   三枚 token 只在接管时被下面那块 CSS 引用；不接管时它们不生效（无引用）。
 				   厚度直接取雾模型（= 左侧边栏/标题栏透明度），0 ⇒ rgba(...,0) = 完全透明，
@@ -17415,21 +17529,21 @@ html body[data-ds-dark-theme][data-mpw-unify] [data-dsh-better-sidebar] [data-ds
      * 作为层叠上下文：浮层被"关"在 header 内部，无法压过 header 内的文字。
    修法：**header 本体彻底不加 backdrop-filter**（磨砂改由 .wSkVaW_header::before 承担，
    见上方标题栏规则），这里只保留左侧栏的规则。 */
-html body:not([data-mpw-sblur-off]) [class*="sidebarCol"]:not([data-sidebar-right-panel]):not([data-dockkit-strip]):not([data-mpw-holds-layer]) {
+${chromeInert ? "" : `html body:not([data-mpw-sblur-off]) [class*="sidebarCol"]:not([data-sidebar-right-panel]):not([data-dockkit-strip]):not([data-mpw-holds-layer]) {
 	/* ①(2026-10-02 真机读数) 半径 0 ⇒ 写 **none**（不是 blur(0px)：视觉等价但仍会建 containing block） */
 	-webkit-backdrop-filter: ${chromeBlurCss} !important;
 	backdrop-filter: ${chromeBlurCss} !important;
 	background-color: var(--mpw-surface-side-frost) !important;
-}
+}`}
 /* 右侧栏 / dockkit（V 形：面板 + 标签条 + 表面） */
-html body[data-mpw-rsblur="on"] [data-sidebar-right-panel],
+${rightInert ? "" : `html body[data-mpw-rsblur="on"] [data-sidebar-right-panel],
 html body[data-mpw-rsblur="on"] [data-dockkit-pane],
 html body[data-mpw-rsblur="on"] [data-dockkit-strip],
 html body[data-mpw-rsblur="on"] [data-dockkit-surface] {
 	-webkit-backdrop-filter: blur(var(--mpw-rs-blur)) saturate(140%) !important;
 	backdrop-filter: blur(var(--mpw-rs-blur)) saturate(140%) !important;
 	background-color: var(--mpw-surface-rs-dock) !important;
-}
+}`}
 /* 抑制：弹窗/设置面板打开时（backdrop-filter 会成为 fixed 弹窗的 containing block → 必须摘除） */
 html body[data-mpw-sblur-off] [class*="sidebarCol"],
 html body[data-mpw-sblur-off] header[class*="_header_"],
@@ -17545,9 +17659,12 @@ html body:has([class*="_overlay"]) [class*="_floatHeader_"] {
 html body [class*="_overlayLayer"], html body [class*="_overlay"], html body [class*="_modal"], html body [role="dialog"] {
 	z-index: 2000 !important;
 }
-/* 设置/对话弹层本身不做玻璃（避免 backdrop-filter 变成下拉的 containing block） */
-[class*="_overlay"], [class*="_modal"], [role="dialog"], [class*="_overlayLayer"],
-[class*="_overlay"] *, [class*="_overlayLayer"] * {
+/* 设置/对话弹层本身不做玻璃（避免 backdrop-filter 变成下拉的 containing block）。
+   ①(2026-10-02 真机读数) **收窄到"真弹层"**：旧写法把 [class*="_overlay"] 及其**所有后代**都清掉模糊，
+   而宿主的聊天输入区锚点类名是 uV2eYG_overlayAnchor（常驻！）⇒ 挂在输入框上的那些弹层
+   （「+」菜单 / 权限选择 / 模型与推理等级 / 上下文占用圆圈）的模糊**被永久清掉**，
+   表现为"完全透明、文字与聊天重叠"（用户第 3 条第②④⑤⑥项）。真弹层用 _overlayLayer / _modal / role=dialog 认。 */
+[role="dialog"][aria-modal="true"], [class*="_overlayLayer"], [class*="_modal"] {
 	-webkit-backdrop-filter: none !important;
 	backdrop-filter: none !important;
 }
@@ -17788,12 +17905,31 @@ html body[data-mpw-sblur-off] [data-mpw-rs] {
 				const n = Number(v);
 				return Number.isFinite(n) ? Math.max(0, Math.min(100, n)) : DEFAULT_POPOVER_ALPHA;
 			})();
+			/* ①(2026-10-03) 「弹层不透明度」滑条是否被用户**显式**调过（值 ≠ 默认 94）。
+			   只有显式调过（或开了主题色遮罩/染色）才允许我们去**覆盖宿主自己画好的底**；
+			   默认状态下宿主自己的玻璃底一律不动 —— 用户第 3 条夸的就是这些。 */
+			const popAlphaUserSet = section.popoverAlpha !== void 0 && Number(section.popoverAlpha) !== DEFAULT_POPOVER_ALPHA;
+			const popFallbackAlpha = popAlphaUserSet ? popSurfaceAlpha / 100 : MPW_POP_SURFACE_ALPHA;
 			// 深色主题用深底（浅底 + 浅色文字 = 看不见字），浅色主题用白底；
 			// 若用户开了主题色（--mpw-theme-color）则跟随主题色，保持与整屏一致。
-			const popSurfaceRgb = `var(--mpw-chrome-bg, 255,255,255)`;
+			/* ①(2026-10-02 真机读数定案的**真 bug**) 这里原来拼 `rgba(var(--mpw-chrome-bg, 255,255,255), α)`，
+			   而 `--mpw-chrome-bg` 在表面模型重做后已经是**颜色**（`var(--dsw-specific-sidebar-fill)`）而不是
+			   三元组 ⇒ 解析成 `rgba(var(--dsw-specific-sidebar-fill), 0.94)` 属**非法值**，整条声明在
+			   computed-value 阶段被丢弃 ⇒ 所有弹层"只有模糊、没有底"（用户第 3 条「完全透明、文字重叠」）。
+			   改成一等公民 `color-mix()`：形态合法、运行时可调（探针在 Firefox 里逐条验过）。 */
+			const popSurfaceRgb = ``;
 			/* ①(2026-09-18 §5 第1项) 弹层（面板家族）表面 → 两枚表面 token（不透明度走 --mpw-pop-alpha，
 			   调用方可临时覆盖；默认值仍是「弹层不透明度」滑条）。 */
-			tok("--mpw-surface-pop", `rgba(${popSurfaceRgb}, var(--mpw-pop-alpha, ${(popSurfaceAlpha / 100).toFixed(2)}))`);
+			tok("--mpw-surface-pop", mpwSurfaceColor(surfacePlan.left.base, popSurfaceAlpha / 100).replace(/[\d.]+%/, `calc(var(--mpw-pop-alpha, ${(popSurfaceAlpha / 100).toFixed(2)}) * 100%)`));
+			/* ①(2026-10-03 用户："设置背景的 token 跟那个重掉了，让他独立出来")
+			   弹层（菜单/下拉/选择器）**不再共用面板表面 token** `--mpw-surface-pop`：
+			   上一版把 0.94 的它刷到弹层上 ⇒ 用户夸过的那些"本来就有玻璃感"的弹层（标题栏里的
+			   子代理展开框、VS Code 菜单…）被我们的近不透明底盖住，**玻璃感消失**。
+			   现在独立成一对 token，并且**只在宿主自己没有底色的弹层上兜底**（由 JS 打
+			   `data-mpw-pop-bg` 标记，见 mpwTagPopoverBg）：有宿主玻璃的弹层一个像素都不动。 */
+			tok("--mpw-pop-surface", mpwSurfaceColor(surfacePlan.left.base, popFallbackAlpha).replace(/[\d.]+%/, `calc(var(--mpw-pop-surface-alpha, ${popFallbackAlpha.toFixed(2)}) * 100%)`));
+			tok("--mpw-pop-surface-alpha", popFallbackAlpha.toFixed(2));
+			tok("--mpw-pop-surface-dark", `rgba(18, 22, 30, var(--mpw-pop-surface-alpha, ${popFallbackAlpha.toFixed(2)}))`);
 			tok("--mpw-surface-pop-dark", `rgba(18, 22, 30, var(--mpw-pop-alpha, ${(popSurfaceAlpha / 100).toFixed(2)}))`);
 			// 弹层**表面**选择器（背景 + 模糊共用一份，避免两处写法漂移）。
 			// ③(关键收窄 2026-09-13) 只用 [class*="_menu"] 会连**非表面**一起命中：
@@ -17802,10 +17938,24 @@ html body[data-mpw-sblur-off] [data-mpw-rs] {
 			//   `._G5b-a_menuStatus`（说明文字）都含 "_menu" ——
 			//   给它们加 backdrop-filter 会在界面上糊出一块方块，加底色会糊出白块。
 			//   这里显式排除 anchor/icon/status/open/item/row/trigger/card 等非表面后缀。
-			const POP_NOT = `:not([role="menuitem"]):not([role="option"]):not([class*="Anchor"]):not([class*="anchor"]):not([class*="Icon"]):not([class*="icon"]):not([class*="Status"]):not([class*="status"]):not([class*="Open"]):not([class*="open"]):not([class*="_item"]):not([class*="Item"]):not([class*="_row"]):not([class*="Row"]):not([class*="_trigger"]):not([class*="Trigger"]):not([class*="_card"]):not([class*="Card"]):not([class*="_groupTitle"])`;
-			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}`;
+			const POP_NOT = `:not([role="menuitem"]):not([role="option"]):not([class*="Anchor"]):not([class*="anchor"]):not([class*="Icon"]):not([class*="icon"]):not([class*="Status"]):not([class*="status"]):not([class*="Open"]):not([class*="open"]):not([class*="_item"]):not([class*="Item"]):not([class*="_row"]):not([class*="Row"]):not([class*="_trigger"]):not([class*="Trigger"]):not([class*="_card"]):not([class*="Card"]):not([class*="_groupTitle"]):not([class*="_viewport"])`;
+			/* ①(2026-10-02 用户第 3 条⑥：上下文占用圆圈点开的框是**纯白**、没有玻璃感)
+			   它的真实结构是 div.JObwrW_panel[role="dialog"][aria-label="上下文已用"] ⇒ 既不在
+			   下面这串弹层选择器里（所以没有我们的底），又被"真弹层不做玻璃"那条按 role=dialog
+			   清掉了模糊 ⇒ 纯白。把它（以及同类小面板）纳入弹层表面集合。 */
+			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"], [role="alert"]`;
-			const popSurfaceCss = (popSurfaceAlpha < 100 || popoverBlur || menuTranslucent)
+			/* ①(2026-10-02 用户第 3 条：「把这个好用的模糊效果独立成 token，因为还有几个地方也要实现」)
+			   弹层表面 = **底色 + 模糊半径 + 圆角** 三件套，全部由这几枚 token 定义；任何弹层只要被
+			   下面的选择器命中，就自动同一套效果（不再各处写死 rgba/blur）。
+			   取值口径：底色 = 宿主底色 × 「弹层不透明度」（默认 94%）；半径 = 「虚化弹层」的
+			   popoverAmount（关掉弹层虚化时为 0 ⇒ 只留底色）；圆角沿用宿主自己的（不覆盖 host radius）。 */
+			tok("--mpw-pop-blur", ((popoverBlur && Number(popoverAmount) > 0) ? `blur(${Number(popoverAmount)}px)` : "none"));
+			tok("--mpw-pop-radius", "var(--dsw-alias-radius-l2, 12px)");
+			/* ②(2026-10-03 用户："原本那种玻璃效果被修没了") **默认不再强刷**：只有用户**显式**动过
+			   「弹层不透明度」滑条、或开了主题色遮罩/染色（那时他明确要我们的表面色）才整片覆盖；
+			   默认只给"宿主自己没画底/画的是纯白小浮层"的弹层兜底（`data-mpw-pop-bg`，独立 token）。 */
+			const popSurfaceCss = (popAlphaUserSet || menuTranslucent)
 				? `/* 弹层表面底色兜底（浅色/深色两套；不透明度由「弹层不透明度」控制） */
 html body :is(${popSurfaceSel}) {
 	background-color: var(--mpw-surface-pop) !important;
@@ -17825,13 +17975,34 @@ html body[data-ds-dark-theme] :is(${popSurfaceSel}) {
    表面选择器与上面的底色规则共用（POP_NOT 已排除 anchor/icon/status 等非表面类）。 */
 ${popTipSel},
 ${popSurfaceSel} {
-	backdrop-filter: ${popFilter} !important;
-	-webkit-backdrop-filter: ${popFilter} !important;
-}
+	/* ①(2026-10-02) 半径/模糊统一读自有 token（--mpw-pop-blur 是唯一来源；关掉弹层虚化时它就是 none） */
+	backdrop-filter: var(--mpw-pop-blur, ${popFilter}) !important;
+	-webkit-backdrop-filter: var(--mpw-pop-blur, ${popFilter}) !important;
+}
+/* ①(2026-10-03 用户："原本那种玻璃效果被你修没了"、"背景 token 跟那个重掉了，让他独立出来")
+   兜底底**只刷宿主自己没有底色的弹层**（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-ds-dark-theme] [data-mpw-pop-bg] { background-color: var(--mpw-pop-surface-dark) !important; }
 [role="menu"] [class*="card"],
 [role="tooltip"] [class*="card"] {
 	backdrop-filter: none !important;
 }
+/* ①(2026-10-02 用户第 3 条⑤) 弹层里的**分组标题条**：宿主给 div._7KE1Ra_groupTitle 之类一块
+   不透明白底，于是"提供商标题是白色长条，而下面具体模型行是好的玻璃底"。这里把标题让成透明，
+   透出容器的玻璃表面（与模型行一致）。POP_NOT 里原本把它排除在"表面"之外是对的（它不该有
+   自己的底），但它自己的宿主白底必须显式清掉。 */
+html body [role="menu"] [class*="_groupTitle"],
+html body [role="listbox"] [class*="_groupTitle"],
+html body [class*="_menu"] [class*="_groupTitle"],
+html body [class*="JObwrW_panel"] [class*="_groupTitle"],
+html body [role="menu"] [class*="groupTitle"],
+html body [role="listbox"] [class*="groupTitle"],
+html body [class*="_menu"] [class*="groupTitle"],
+html body [class*="JObwrW_panel"] [class*="groupTitle"] {
+	background-color: transparent !important;
+}
 /* ── 弹层**表面底色**兜底（用户"浮层被压住"的根治项之一）──
    背景过去只来自宿主 token（--dsw-specific-menu / -tip / -selector …），
    不同组件用的 token 不一样，一旦某个链路把 token 改透明、或 backdrop 模糊在
@@ -24430,6 +24601,89 @@ body[data-mpw-modal] [role="dialog"] {
 			check();
 		}
 
+		/* ①(2026-10-03 用户："原本那种玻璃效果被你修没了" / "他那个设置背景的 token 好像跟那个重掉了，让他独立出来")
+		   弹层**兜底底**标记器：宿主自己把底画好了的弹层，我们**一个像素都不动**；只有下面两类才打
+		   `data-mpw-pop-bg`，由 CSS（独立 token `--mpw-pop-surface(-dark)` + `--mpw-pop-blur`）补一套玻璃：
+		     甲、宿主完全没画底（computed backgroundColor 的 α < 0.05，且近祖先也没有可见底）
+		         —— 用户第 3 条里「完全透明、文字重叠」的那几处（+ 菜单 / 权限 / 模型选择器）；
+		     乙、宿主画的是**不透明纯底的小浮层**（α ≥ 0.999 且面积 < 40% 视口）
+		         —— 用户第 3⑥ 条「上下文用量圆环弹出来是纯白」那一处，换成玻璃。
+		   硬前提：**背后必须有模糊**（computed backdrop-filter 含 blur）才刷底色 ——
+		   否则半透明底 + 无模糊 = 字叠字，比原来更糟。模糊由我们（虚化弹层）或宿主提供，两者都算。
+		   开销：只在弹层插进 DOM 时（rAF 合并）扫一次，元素级 getComputedStyle 只落在命中项上。 */
+		let popTagWatch = null;
+		const MPW_POP_TAG_SEL = '[role="menu"], [role="listbox"], [role="combobox"], [class*="_menu"], [class*="_popover"], [class*="_dropdown"], [class*="_denseList"], [class*="JObwrW_panel"], [role="tooltip"]';
+		const MPW_POP_TAG_NOT = /(Anchor|anchor|Icon|icon|Status|status|Item|_item|Row|_row|Trigger|_trigger|Card|_card|groupTitle|_viewport)/;
+		/** 近祖先（≤4 层）里已经有可见底 ⇒ 真正的表面在上面，别在里面再叠一层。 */
+		function mpwPopHasPaintedAncestor(el) {
+			try {
+				let p = el.parentElement, n = 0;
+				while (p && n < 4 && p !== document.body && p !== document.documentElement) {
+					let cs = null;
+					try { cs = getComputedStyle(p); } catch (e) { break; }
+					if (cs && cs.display !== "none" && mpwColorAlpha(cs.backgroundColor) >= 0.3) return true;
+					p = p.parentElement; n++;
+				}
+			} catch (e) {}
+			return false;
+		}
+		/** 小浮层（不是铺满视口的弹层/窗口）—— 不透明底的小面板才允许被换成玻璃。 */
+		function mpwPopIsFloating(el) {
+			try {
+				const r = el.getBoundingClientRect();
+				const vw = window.innerWidth || 1, vh = window.innerHeight || 1;
+				if (!r || r.width <= 0 || r.height <= 0) return false;
+				return r.width * r.height <= 0.4 * vw * vh && r.height <= vh * 0.9;
+			} catch (e) { return false; }
+		}
+		function mpwTagPopoverBg() {
+			let list = null;
+			try { list = document.querySelectorAll(MPW_POP_TAG_SEL); } catch (e) { return; }
+			if (!list) return;
+			for (let i = 0; i < list.length; i++) {
+				const el = list[i];
+				let need = false;
+				try {
+					const cls = (typeof el.className === "string") ? el.className : "";
+					if (!MPW_POP_TAG_NOT.test(cls)) {
+						const cs = getComputedStyle(el);
+						if (cs && cs.display !== "none" && cs.visibility !== "hidden"
+							&& /blur\(/.test(String(cs.backdropFilter || cs.webkitBackdropFilter || ""))) {
+							const a = mpwColorAlpha(cs.backgroundColor);
+							if (a < 0.05) need = !mpwPopHasPaintedAncestor(el);
+							else if (a >= 0.999) need = mpwPopIsFloating(el);
+						}
+					}
+				} catch (e) { need = false; }
+				try {
+					if (need) { if (!el.hasAttribute("data-mpw-pop-bg")) el.setAttribute("data-mpw-pop-bg", ""); }
+					else if (el.hasAttribute("data-mpw-pop-bg")) el.removeAttribute("data-mpw-pop-bg");
+				} catch (e) {}
+			}
+		}
+		function setupPopTagWatch() {
+			if (popTagWatch !== null) return;
+			let praf = 0;
+			const prun = () => {
+				praf = 0;
+				try {
+					// 左栏收起/展开与拖拽期间宿主每帧改 DOM：跳过（收尾还会再来一次）
+					if (document.body && document.body.hasAttribute
+						&& (document.body.hasAttribute("data-dsh-sidebar-dragging") || document.body.hasAttribute("data-dragging"))) return;
+					mpwTagPopoverBg();
+				} catch (e) {}
+			};
+			try {
+				popTagWatch = new MutationObserver(() => {
+					if (praf) return;
+					try { praf = (typeof requestAnimationFrame === "function") ? requestAnimationFrame(prun) : setTimeout(prun, 16); }
+					catch (e) { prun(); }
+				});
+				popTagWatch.observe(document.body, { childList: true, subtree: true });
+			} catch { popTagWatch = null; }
+			mpwTagPopoverBg();
+		}
+
 		// ①(新) 标题栏 backdrop blur 摘除：G 块给 header 加 blur(unifyAmount)（聊天区
 		// 不跟随时的标题栏虚化），但 header 内有 absolute 展开面板（子代理/后台任务，
 		// JObwrW_panel），backdrop-filter 会变成它们的 containing block → 面板定位错乱
@@ -24460,7 +24714,24 @@ body[data-mpw-modal] [role="dialog"] {
 				} catch {}
 			};
 			try {
-				headerBlurWatch = new MutationObserver(check);
+				/* ①(2026-10-02 用户第 7 条：左栏收起/展开动画卡顿；真机对照 rAF 峰值 650–684ms vs 267ms)
+				   `check()` 每次都 `querySelectorAll` + `getBoundingClientRect`（强制布局），而宿主在动画
+				   期间**每帧都改 DOM** ⇒ 旧写法等于每帧跑一次全量查询 + 布局。改成 rAF 帧内合并，
+				   并在动画/拖拽期间直接跳过（动画结束后还会再来一次，不会漏掉收尾状态）。 */
+				let hraf = 0;
+				const hrun = () => {
+					hraf = 0;
+					try {
+						if (document.body && document.body.hasAttribute
+							&& (document.body.hasAttribute("data-dsh-sidebar-dragging") || document.body.hasAttribute("data-dragging"))) return;
+						check();
+					} catch (e) {}
+				};
+				headerBlurWatch = new MutationObserver(() => {
+					if (hraf) return;
+					try { hraf = (typeof requestAnimationFrame === "function") ? requestAnimationFrame(hrun) : setTimeout(hrun, 16); }
+					catch (e) { hrun(); }
+				});
 				headerBlurWatch.observe(document.body, { childList: true, subtree: true });
 			} catch { headerBlurWatch = null; }
 			check();

package/lib/index.js

@@ -809,8 +809,12 @@ function normalizeScaleFlag(raw) {
  *  顺序仍是"先缩放再抽帧"（编码量更小）。 */
 function buildScaleFilter(maxW, fps, scaleFlag) {
   const w = Number(maxW) > 0 ? Math.round(Number(maxW)) : 0;
+  /* ①(2026-10-03 ffmpeg 审计"奇数宽"条) `-2` 只保证**高**是偶数：宽是 `iw`（H.264 允许奇数显示宽，
+     靠裁剪位）或用户/屏幕推出来的 `maxW`（`Math.round(w*dpr)` 可以是奇数，如 1366×1.5=2049）。
+     一旦我们显式给了 `-pix_fmt yuv420p`（见 F2），奇数宽会直接**编码失败**；不给则 ffmpeg 可能
+     协商出非 4:2:0 格式。⇒ 宽也取偶数（`trunc(x/2)*2`），与高同一条纪律。 */
   return w > 0
-    ? "scale='min(" + w + ",iw)':-2" + (scaleFlag ? ':flags=' + scaleFlag : '') + ',fps=' + fps
+    ? "scale='trunc(min(" + w + ",iw)/2)*2':-2" + (scaleFlag ? ':flags=' + scaleFlag : '') + ',fps=' + fps
     : 'fps=' + fps;
 }
 /** ①(B) 转码缓存键：**只含影响播放的字段**（源标识 | mtime | fps | maxW | 缩放 flags）。
@@ -868,6 +872,13 @@ function pixFmtBitDepth(fmt) {
 }
 /** 8bit 一族（这些源**不需要**任何色彩参数 —— 实测忠实，且保持与改动前逐字节相同的产物）。 */
 const TRANSCODE_8BIT_PIXFMT = /^(yuvj?420p|yuvj?422p|yuvj?444p|nv12|nv21|yuva420p|rgb24|bgr24|gray|pal8)$/i;
+/** ①(2026-10-03 ffmpeg 审计 F2) **浏览器安全的白名单只有 4:2:0**（外加无色度的 gray/pal8）：
+ *  8bit 的 `yuv422p` / `yuv444p` 源走旧计划是 `passthrough`（不加 `-pix_fmt`）⇒ libx264 会**顺着源**
+ *  产出 `High 4:2:2 / High 4:4:4`，而 `browserCodecGap()` 恰恰把这两种 profile 判成"浏览器吃不下"
+ *  ⇒ 我们**为了救它而转码，却转出一个同样放不出的文件**，而且它是个"有效缓存"（≥1KB + ftyp）
+ *  永久命中 ⇒ 之后一直是黑屏、也不会再重转（除非删缓存）。所以：非 4:2:0 一律显式降 `yuv420p`。
+ *  `rgb24/bgr24` 同理（x264 无 RGB 输入）⇒ 一起收进"要降"的一侧。 */
+const TRANSCODE_SAFE_420 = /^(yuvj?420p|nv12|nv21|yuva420p|gray|pal8)$/i;
 /** HDR 传输函数（PQ / HLG / 2020 系）：这些 transfer 在 8bit SDR 显示链上没有正确解释。 */
 const TRANSCODE_HDR_TRANSFER = /^(smpte2084|arib-std-b67|smpte428|bt2020-10|bt2020-12)$/i;
 /** 探测结果 → 转码色彩计划（**纯函数**，门禁直接切片断言；不改文件、不起进程）。
@@ -886,8 +897,12 @@ function transcodeColorPlan(info) {
   if (TRANSCODE_COLOR_MODE === 'force8') return { mode: 'force8', downgrade: true, deep, hdr, from, to, args: downgradeArgs, reason: 'DSH_WE_TRANSCODE_COLOR=force8：强制 8bit bt709（现场对比用）' };
   // 不知道（探测失败/空 pix_fmt）⇒ 保持旧行为，但**记账**
   if (!pixFmt) return { mode: 'unknown', downgrade: false, deep: false, hdr, from, to, args: [], reason: '拿不到源 pix_fmt（探测失败）⇒ 不加色彩参数（与改动前一致），台账记 unknown' };
-  if (!deep && !hdr) return { mode: 'passthrough', downgrade: false, deep, hdr, from, to, args: [], reason: '8bit SDR：实测转码忠实（标签/像素都不变）⇒ 不加参数，产物与改动前逐字节相同' };
-  return { mode: 'downgrade', downgrade: true, deep, hdr, from, to, args: downgradeArgs, reason: (deep ? ('源 ' + depth + 'bit') : '') + (deep && hdr ? ' + ' : '') + (hdr ? ('HDR transfer ' + transfer) : '') + ' ⇒ 降为 8bit bt709/tv（无 tonemap：ffmpeg-static 无 zscale，偏暗但能播）' };
+  /* ①(F2) 只有"8bit + SDR + 4:2:0"才允许 passthrough（与改动前逐字节相同）；
+     非 4:2:0 的 8bit 源必须显式降 4:2:0（否则转出 4:2:2/4:4:4 profile = 浏览器仍放不出，
+     却被当作有效缓存永久命中）。 */
+  const chromaUnsafe = !!pixFmt && !TRANSCODE_SAFE_420.test(pixFmt);
+  if (!deep && !hdr && !chromaUnsafe) return { mode: 'passthrough', downgrade: false, deep, hdr, chroma: false, from, to, args: [], reason: '8bit SDR 4:2:0：实测转码忠实（标签/像素都不变）⇒ 不加参数，产物与改动前逐字节相同' };
+  return { mode: 'downgrade', downgrade: true, deep, hdr, chroma: chromaUnsafe, from, to, args: downgradeArgs, reason: (deep ? ('源 ' + depth + 'bit') : '') + (deep && hdr ? ' + ' : '') + (hdr ? ('HDR transfer ' + transfer) : '') + (chromaUnsafe ? ((deep || hdr ? ' + ' : '') + '源 ' + pixFmt + ' 非 4:2:0') : '') + ' ⇒ 降为 8bit 4:2:0 bt709/tv' + ((deep || hdr) ? '（无 tonemap：ffmpeg-static 无 zscale，偏暗但能播）' : '') };
 }
 // ═══ MPW-COLOR-PLAN-END ═══
 /* ═══ MPW-TRANSCODE-GEN-BEGIN（H1 代际/归属/有效性；纯函数 + 三个小状态操作） ═══ */
@@ -991,10 +1006,20 @@ const BROWSER_OK_CONTAINER = /^(mov|mp4|m4a|3gp|3g2|mj2|matroska|webm)/i;
  *  · h264 + opus 装进 MP4：Chromium 系不支持（Opus 在 MP4 里只有 WebM/ogg 容器被支持）；
  *  · HEVC Main10（10bit）：多数平台无 10bit HEVC 解码（8bit Main 在 Safari/部分 Chromium 上可）。
  *  只用于"源本身就不该直读"的判断；命中即视为需要转码。 */
-function browserCodecGap(video, audio, fmt) {
-  const afmt = String(fmt || '');
-  if (video === 'h264' && audio === 'opus' && !/webm|matroska/i.test(afmt)) return 'mp4 容器里的 h264+opus（Chromium 不支持该组合）';
-  if (video === 'hevc' && /main ?10|main10/i.test(String(fmt || ''))) return 'HEVC Main10（10bit，多数平台无解码器）';
+function browserCodecGap(video, audio, container, profile) {
+  /* ①(2026-10-03 ffmpeg 审计 F6) **参数拆分**：旧签名 `(video, audio, fmt)` 里 `fmt` 同时被当
+     **容器**（h264+opus 那条）和**profile**（Main10 那条）用，而唯一调用点传的是 `videoProfile`
+     ⇒ 容器永远缺席：MKV/WebM 里的 h264+opus（本该被豁免）被判"mp4 容器里的 h264+opus"
+     ⇒ 白转一次码，`verdict.reason` 也是错的。现在容器与 profile 各是各的参数。
+     兼容：第三个参数若是 `High 10`/`Main 10` 这类 **profile 串**（老调用点/老测试），
+     仍按 profile 解释（容器判据退化为"未知"，不误判成 mp4）。 */
+  const looksProfile = (v) => /^\s*(high|main|baseline|constrained|profile|simple|advanced|professional)/i.test(String(v || ''));
+  let cont = String(container || '');
+  let prof = String(profile || '');
+  if (prof === '' && looksProfile(cont)) { prof = cont; cont = ''; }
+  const afmt = cont;
+  if (video === 'h264' && audio === 'opus' && afmt !== '' && !/webm|matroska/i.test(afmt)) return 'mp4 容器里的 h264+opus（Chromium 不支持该组合）';
+  if (video === 'hevc' && /main ?10|main10/i.test(prof)) return 'HEVC Main10（10bit，多数平台无解码器）';
   /* ①(2026-09-28 H2 色彩轮) **H.264 的高位深 profile**（High 10 / High 4:2:2 / High 4:4:4）：
      主流浏览器**没有** 10bit H.264 解码器（Chromium/Firefox 只到 High 8bit；Safari/VideoToolbox
      视平台），而本模块此前只认 HEVC Main10 ⇒ 一个 **H.264 High 10** 源会被判"可直读"、
@@ -1003,9 +1028,14 @@ function browserCodecGap(video, audio, fmt) {
      仍是 `High 10 / yuv420p10le` ⇒ 位深策略（`transcodeColorPlan`）必须与这条判据配套。
      置信度与既有 HEVC Main10 一条同级（"多数平台无解码器"），不猜；转码若失败客户端仍有
      回退原片的一次性路径（`mpwFallbackToDirect`）。 */
-  if (video === 'h264' && /high 10|high 4:2:2|high 4:4:4|high 10 intra|high 422|high 444/i.test(afmt)) {
-    return 'H.264 ' + String(fmt || '').trim() + '（10bit/高位深 profile，浏览器多数无解码器）';
+  if (video === 'h264' && /high 10|high 4:2:2|high 4:4:4|high 10 intra|high 422|high 444/i.test(prof)) {
+    return 'H.264 ' + prof.trim() + '（10bit/高位深 profile，浏览器多数无解码器）';
   }
+  /* ①(2026-10-03 ffmpeg 审计 F2 后半) VP9 / AV1 的**高位深/高色度** profile 同样没有浏览器解码器，
+     旧表只认 h264/hevc ⇒ 这些源被判"可直读"、直接喂浏览器（黑屏），转码这条唯一能救的路没走。
+     ffprobe 对 VP9 报 `Profile 0/1/2/3`、对 AV1 报 `Main/High/Professional`。 */
+  if (video === 'vp9' && /profile\s*(1|3)/i.test(prof)) return 'VP9 Profile 1/3（4:2:2 / 4:4:4，浏览器无解码器）';
+  if (video === 'av1' && /high|professional/i.test(prof)) return 'AV1 High/Professional（4:2:2 / 4:4:4 / 12bit，浏览器无解码器）';
   return '';
 }
 /** 给定探测结果 → { playable: true|false|null, reason }。
@@ -1020,7 +1050,8 @@ function browserPlayable(info) {
   if (!BROWSER_OK_VIDEO.has(v)) return { playable: false, reason: '视频编码 ' + v + ' 不在浏览器白名单（h264/vp8/vp9/av1）' };
   if (a && !BROWSER_OK_AUDIO.has(a)) return { playable: false, reason: '音频编码 ' + a + ' 不在浏览器白名单（aac/mp3/opus/vorbis/flac）' };
   if (!BROWSER_OK_CONTAINER.test(String(fmt))) return { playable: false, reason: '容器 ' + fmt + ' 不是 mp4/webm' };
-  const gap = browserCodecGap(v, a, info.videoProfile);
+  /* ①(F6) 容器与 profile 分开传（旧版把 profile 当容器用） */
+  const gap = browserCodecGap(v, a, fmt, info.videoProfile);
   if (gap) return { playable: false, reason: gap };
   return { playable: true, reason: v + (a ? '+' + a : '') + ' / ' + fmt + '（浏览器可直读）' };
 }
@@ -1967,10 +1998,17 @@ function materializeSource(src, cacheDir) {
       while (w < n) w += writeSync(outFd, buf, w, n - w);
       off += n;
     }
-  } finally {
-    closeSync(fd);
-    closeSync(outFd);
+  } catch (e) {
+    /* ①(2026-10-03 ffmpeg 审计 F7) 拷贝中途失败（ENOSPC / 读源出错）时**必须**把半成品删掉：
+       旧写法只有 `finally` 关句柄 ⇒ 部分写出的 `src_*.bin` 留在缓存目录里等着"1 小时后才回收"，
+       而磁盘正是满的 ⇒ 重试继续失败，用户只看到"转码失败"。 */
+    try { closeSync(fd); } catch { /* 忽略 */ }
+    try { closeSync(outFd); } catch { /* 忽略 */ }
+    try { unlinkSync(tmp); } catch { /* 忽略 */ }
+    throw e;
   }
+  try { closeSync(fd); } catch { /* 忽略 */ }
+  try { closeSync(outFd); } catch { /* 忽略 */ }
   return { file: tmp, cleanup: () => { try { unlinkSync(tmp); } catch { /* 忽略 */ } } };
 }
 
@@ -1979,7 +2017,7 @@ function materializeSource(src, cacheDir) {
  *  （实测 0xFFFFFFEA / EPERM），故先试 detached 再试普通 spawn。
  *  ①(2026-09-28 H1) `jobKey` = 本子进程所属的产物路径：登记进 `ACTIVE_FFMPEG`（proc→jobKey），
  *  取消时**只杀本任务**的进程（旧实现按"本请求之后启动的全部"过滤，会误杀别的档/别的源）。 */
-function spawnFfmpeg(ff, args, jobKey) {
+function spawnFfmpeg(ff, args, jobKey, deadline) {
   return new Promise((resolve, reject) => {
     const errLog = join(transcodeCacheDir(), 'ffmpeg-err-' + process.pid + '-' + Date.now() + '.log');
     const attempts = [
@@ -2031,7 +2069,7 @@ function spawnFfmpeg(ff, args, jobKey) {
         clearTimeout(timer);
         ACTIVE_FFMPEG.delete(proc);
         if (errFd) { try { closeSync(errFd); } catch { /* 忽略 */ } }
-        let detail = msg || 'ffmpeg failed';
+        let detail = (msg && msg.message) ? msg.message : (msg || 'ffmpeg failed');
         try {
           const t = readFileSync(errLog, 'utf8').trim();
           if (t) detail += ' | stderr: ' + t.split('\n').slice(-4).join(' | ');
@@ -2048,12 +2086,18 @@ function spawnFfmpeg(ff, args, jobKey) {
         if (msg) errors.push(msg);
         runNext();
       };
+      /* ①(2026-10-03 ffmpeg 审计 F4) 超时按**任务剩余时间**算（`deadline` = runTranscode 给的任务级
+         截止时刻），而不是"每次尝试各给 15 分钟"。旧写法下一次超时会被编码器循环当成"换个编码器
+         再试"⇒ libx264 15min + libsvtav1 15min + 各自单线程再来一遍 = 最多 1 小时，全程占着
+         `TRANSCODE_MAX_ACTIVE=1` 的唯一名额（与 docs/TRANSCODE-RESOURCE.md 的"单任务硬超时"不符）。 */
+      const budget = Number.isFinite(deadline) ? Math.max(0, deadline - Date.now()) : TRANSCODE_TIMEOUT_MS;
       const timer = setTimeout(() => {
         timedOut = true;
         try { proc.kill(); } catch { /* 忽略 */ }
-        // ①(修正) 超时：直接失败，不重试（见 finalReject 注释）
-        finalReject(a.name + ' timed out after ' + TRANSCODE_TIMEOUT_MS + 'ms (killed)');
-      }, TRANSCODE_TIMEOUT_MS);
+        const err = new Error(a.name + ' timed out after ' + TRANSCODE_TIMEOUT_MS + 'ms (killed)');
+        err.taskTimedOut = true;      // ← 任务级超时：runTranscode 拿到它就**不再换编码器/线程模式**
+        finalReject(err);
+      }, budget);
       proc.on('error', (err) => {
         // spawn 阶段的 'error'（如 EPERM）→ 重试下一个 attempt；执行中 error → 直接失败
         if (!done && timedOut) { finalReject(a.name + ' spawn error ' + (err && err.code ? err.code + ' ' + err.message : err)); return; }
@@ -2095,6 +2139,9 @@ async function runTranscode(srcFile, out, fps, maxW, job, isCancelled, scaleFlag
     throw new Error('ffmpeg not found (set DSH_WE_FFMPEG, install ffmpeg to PATH, or click 下载 ffmpeg → /ffmpeg-download)');
   }
   job.ff = ff.path;
+  /* ①(2026-10-03 ffmpeg 审计 F4) **任务级**截止时刻：整个 runTranscode（含换编码器/换线程模式
+     的全部尝试）共用这一个预算，超时即终态。 */
+  const deadline = Date.now() + TRANSCODE_TIMEOUT_MS;
   // ①(新) 降分辨率：`scale='min(maxW,iw)':-2` 保持宽高比、宽不超过 maxW（-2=高自动偶数）。
   // 与 fps 合并到一个 -vf 链（先缩放再抽帧，编码量更小）。
   // ①(2026-09-23 B) vf 链构造收敛到 buildScaleFilter（预缩档 = maxW + flags=lanczos；
@@ -2121,6 +2168,11 @@ async function runTranscode(srcFile, out, fps, maxW, job, isCancelled, scaleFlag
     if (mode.label === 'mt' && futexSeen) continue; // 已知 futex 问题 → 跳过多线程
     for (const enc of encoders) {
       if (cancelled()) throw new Error('cancelled');   // ⓪ 换编码器前也要查
+      if (Date.now() >= deadline) {                     // ①(F4) 预算已尽 ⇒ 不再起新进程
+        const te = new Error('已到任务级超时（' + TRANSCODE_TIMEOUT_MS + 'ms），停止后续尝试');
+        te.taskTimedOut = true;
+        throw te;
+      }
       job.encoder = enc.name + (mode.label === 'st' ? ' (单线程)' : '');
       // -f mp4 显式指定：临时输出路径不是 .mp4 后缀，ffmpeg 无法按扩展名选 muxer
       // ①(Qoder 审查 M5) 单线程时输出侧再加 -threads 1 控制编码线程
@@ -2129,12 +2181,20 @@ async function runTranscode(srcFile, out, fps, maxW, job, isCancelled, scaleFlag
         // ⓪(2026-09-17) x264 额外参数（默认空；见 TRANSCODE_X264_PARAMS 注释：省内存但费码率）
         const x264 = (enc.name === 'libx264' && TRANSCODE_X264_PARAMS) ? ['-x264-params', TRANSCODE_X264_PARAMS] : [];
         // ①(2026-09-28 H2) `colorArgs`：>8bit/HDR 源才带（8bit 源为空数组 ⇒ 产物与改动前逐字节相同）
-        const full = [...mode.extra, ...base, ...enc.tail, ...x264, ...(colorArgs || []), ...(mode.label === 'st' ? ['-threads', '1'] : []), '-movflags', '+faststart', '-an', '-f', 'mp4', out];
-        await spawnFfmpeg(ff.path, full, jobKey);
+        /* ①(2026-10-03 ffmpeg 审计 F3) 旧命令无条件 `-an`（"壁纸默认静音更省"）——但本插件的
+           **壁纸声音**是一等功能（`applyVideoMute` / NOW PLAYING 音量都落在这个 `<video>` 上）：
+           用户开了声音、又设了 fpsCap/resMax/预缩（或 ≥4K 源触发静默自动降档）⇒ 转码产物**没有音轨**
+           ⇒ 壁纸突然没声，且没有任何提示。现在改为**保留音轨**（aac 128k；源本来没音轨时
+           ffmpeg 的默认流选择不会凭空造一条，`-c:a` 也就用不上）。 */
+        const audioArgs = ['-c:a', 'aac', '-b:a', '128k'];
+        const full = [...mode.extra, ...base, ...enc.tail, ...x264, ...(colorArgs || []), ...(mode.label === 'st' ? ['-threads', '1'] : []), '-movflags', '+faststart', ...audioArgs, '-f', 'mp4', out];
+        await spawnFfmpeg(ff.path, full, jobKey, deadline);
         return;
       } catch (err) {
         lastErr = err;
         try { unlinkSync(out); } catch { /* 忽略 */ }
+        /* ①(F4) 任务级超时 = 终态：不再换编码器、不再换线程模式（旧写法把超时也当成"重试下一个"）。 */
+        if (err && err.taskTimedOut) throw err;
         // ①(Qoder 审查) futex 判定用精确报错原文匹配，避免误伤：文件名/路径
         // 含 "futex"（如用户 mpkg 名 futex_test.mpkg）的打开错误也会被宽松
         // /futex/i 命中 → 误置 TRANSCODE_FUTEX_FALLBACK 永久单线程（性能损失）。
@@ -2315,6 +2375,13 @@ async function transcodeToFps(src, fps, maxW, isCancelled, scaleFlag) {
   return p;
 }
 
+/* ①(2026-10-03 ffmpeg 审计 F1) `maxW` 的**唯一解析点**：`/transcode`（写入键）与
+   `/transcode-progress`（查询键）必须逐字一致 —— 两侧各写一份正是"进度永远 idle"的根因。 */
+function parseMaxWParam(raw) {
+  const n = Number(raw);
+  return Number.isFinite(n) && n > 0 ? Math.min(3840, Math.round(n)) : 0;
+}
+
 /** 转码/下载进度 JSON（/transcode-progress 与 /transcode 的 progress 子路径共用）。 */
 function handleTranscodeProgress(req, res) {
   try {
@@ -2322,10 +2389,17 @@ function handleTranscodeProgress(req, res) {
     const file = (url.searchParams.get('file') || '').trim();
     const srcParam = (url.searchParams.get('src') || '').trim();
     const fps = Number(url.searchParams.get('fps')) || 0;
-    const maxWRaw = Number(url.searchParams.get('maxW'));
-    const maxW = Number.isFinite(maxWRaw) && maxWRaw > 0 ? Math.min(3840, Math.round(maxWRaw)) : 0;
+    const maxW = parseMaxWParam(url.searchParams.get('maxW'));
     // ①(B) 查询键与写入键一致（含缩放 flags）；未给 flags ⇒ 与改动前逐字相同的键。
     const scaleFlag = normalizeScaleFlag(url.searchParams.get('scale')) || '';
+    /* ①(2026-10-03 ffmpeg 审计 F1) **查询键必须与写入键同源**：`/transcode` 没拿到 maxW 时会套
+       `TRANSCODE_DEFAULT_MAXW`（写入键 = `srcId|fps|1920`），而这里旧写法直接用 raw maxW=0
+       ⇒ 查 `srcId|fps|0`（永远 idle）。后果有两级：①忙条读到 0% 一直到 2 分钟超时才消失；
+       ②客户端"转码完成后重新 apply"的 10s 轮询等的是 `phase==='done'`，永远等不到 ⇒ 源被判
+       "不可直读"（HEVC Main10 / H.264 High 10 之类）时**卡在回退的原片上黑屏**，而磁盘上其实
+       早就有转好的产物。⇒ 这里按同一条默认规则算出 effMaxW 作为首选键。 */
+    const reqMaxW = maxW > 0 ? maxW : TRANSCODE_DEFAULT_MAXW;
+    const effMaxW = (TRANSCODE_DEFAULT_MAXW > 0 && reqMaxW > TRANSCODE_DEFAULT_MAXW) ? TRANSCODE_DEFAULT_MAXW : reqMaxW;
     let job = null;
     // ②(fix) src 优先（与 /transcode 同款）：客户端回退原片后轮询转码完成，
     // 用原始 image 串查询（旧式 file 兼容保留）。
@@ -2335,8 +2409,10 @@ function handleTranscodeProgress(req, res) {
       const srcId = src.type === 'mpkg' ? 'mpkg:' + src.rec.path + ':' + src.entry.index : srcPath;
       // ①(Qoder 审查 R7) 查询 key 与写入一致（含 maxW）——此前写入
       // srcId|fps|maxW、查询 srcId|fps，设了 maxW 的任务进度永远查不到(idle)。
-      const withFlags = srcId + '|' + fps + '|' + maxW + ((maxW > 0 && scaleFlag) ? '|s:' + scaleFlag : '');
-      job = transcodeJobs.get(withFlags)
+      const keyOf = (w) => srcId + '|' + fps + '|' + w + ((w > 0 && scaleFlag) ? '|s:' + scaleFlag : '');
+      job = transcodeJobs.get(keyOf(effMaxW))              // ← 与 /transcode 的写入键同源（含默认降采样）
+        || transcodeJobs.get(keyOf(maxW))                  // 兼容：显式 maxW 的老键
+        || transcodeJobs.get(srcId + '|' + fps + '|' + effMaxW)
         || transcodeJobs.get(srcId + '|' + fps + '|' + maxW)
         || transcodeJobs.get(srcId + '|' + fps) || null;
     } else if (ffmpegDownloadProgress) {
@@ -4807,8 +4883,7 @@ function apply(ctx) {
           const fpsRaw = Number(url.searchParams.get('fps'));
           const fps = Number.isFinite(fpsRaw) && ALLOWED_FPS.includes(fpsRaw) ? fpsRaw : 0;
           if (!fps) { json(res, 400, { ok: false, error: 'invalid fps (allowed: 24/30/48/60)' }); return; }
-          const maxWRaw = Number(url.searchParams.get('maxW'));
-          const maxW = Number.isFinite(maxWRaw) && maxWRaw > 0 ? Math.min(3840, Math.round(maxWRaw)) : 0;
+          const maxW = parseMaxWParam(url.searchParams.get('maxW'));
           // ①(2026-09-23 B) 预缩档：`scale=lanczos`（白名单外 ⇒ 400，不把任意串拼进 -vf）。
           //  它只影响**缩放滤波器**；目标宽仍由 maxW 决定（客户端按屏幕物理宽算 maxW）。
           const scaleFlag = normalizeScaleFlag(url.searchParams.get('scale'));

package/package.json

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