dsh-mpkg-wallpaper 3.13.2 → 3.13.4

package/lib/client.js

@@ -80,6 +80,198 @@ function mpwTrace(ev, data) {
 			return Math.max(1, Math.min(120, Number.isFinite(n) && n > 0 ? n : 5));
 		}
 		try { window.__mpwClampRotMin = mpwClampRotMin; } catch {}
+		/* ═══ MPW-BLOBRETRY-BEGIN ═══ */
+		/** blob 媒体「有界重试看门狗」（**唯一定义处**；上游 Firefox Bug 2056444 的页内兜底）。
+		 *  症状（已定性，有实测证据）：把**包内字节**做成 `blob:` URL 再喂 `<video>`/`<audio>`，在受影响的
+		 *  Firefox 构建上会**静默挂住** —— `readyState` 恒 0、`networkState` 恒 1、**不触发 error**、
+		 *  `play()` 的 Promise 永不 settle。
+		 *  上游回归：Bug 2056444（由 Bug 2005247 引入，Firefox 152 起；官方已修：155 nightly → beta 154 →
+		 *  release 153（153.0.3）/ ESR153）。机制：blob 数据超过 **1MiB 的 IPC 内联上限**后改走 IPC 异步流，
+		 *  `CloneableWithRangeMediaResource` 在异步 IPC 流上做同步读 ⇒ 首次元数据读（MP4 的 `moov` 常在
+		 *  **尾部** = 远端 seek）挂住；`decodeAudioData` 同族也会挂。
+		 *  证据（**仓外**姐妹仓库「渲染器仓」的两条探针，只读引用、**勿改**；本仓门禁禁止在 lib/** 里写跨仓路径）：
+		 *   · `tests/mpkg-video-decode-probe.mjs` —— 同一段 22MB h264 字节：HTTP 直供 `rs=4`（约 0.4s）；
+		 *     blob 恒 `rs=0`；14KB blob `rs=4`（⇒ 与 1MiB 上限相关）；`new Blob([buf])`、`new File([buf])`、
+		 *     `new Response(buf).blob()`、`data:` URL 四种写法全部复现。
+		 *   · `tests/mpkg-videobase-recovery-probe.mjs` —— 真页面里元素卡在 `rs=0` 后，**只补一次 `load()`**
+		 *     就恢复（`rs=4 / 1636x1156 / dur=30`，并且画面真的出来了）。
+		 *  ⇒ 页内可用的兜底 = **有界重试 `load()`**：最多 2 次、间隔 1500ms。
+		 *  **健康浏览器上永不触发**：`rs≥1` 早在 1.5s 内到达 ⇒ 首次检查就返回，一次 `load()` 都不会多调。
+		 *  契约（`tools/blob-media-retry-test.mjs` S2 逐条钉住）：①有界（2 次 / 1500ms）；②`rs≥1` 或
+		 *  `el.error` 非空 ⇒ 立刻停（不再重试、不再计时）；③每次重试**恰好一行**日志（`🔁` + label + 第几次
+		 *  + 缺陷号 2056444）；④2 次用尽仍 `rs=0` ⇒ **恰好一行** `⚠`；⑤绝不抛异常（元素已摘 / `load()` 抛错 /
+		 *  无 `window` 一律吞掉）；⑥只兜 `blob:` 源（HTTP 直供是健康路径 —— 探针里 `rs=4` 的就是它 —— 不打扰）。
+		 *  计数钩子 `window.__mpwBlobMediaRetry`（**仅当 `window` 存在时**写；语义如下）：
+		 *   `calls`   = 本函数被调用的次数（每处接线各算一次，**不代表真的重试过**）；
+		 *   `retries` = 真的调了 `el.load()` 的次数；
+		 *   `gaveUp`  = 2 次用尽仍 `rs=0` 的收尾次数；
+		 *   `byLabel` = 同口径按 `label` 分桶：`{ [label]: { calls, retries, gaveUp } }`。
+		 *  纯诊断、无用户可见提示：恢复是自动的，正常用户不该被打扰（只在控制台留痕）。 */
+		function mpwBlobMediaRetry(el, label) {
+			const RETRY_MAX = 2, RETRY_GAP_MS = 1500, BUG = "2056444";
+			const tag = String(label == null ? "" : label);
+			/** 计数（**唯一**碰 `window` 的地方；任何一步失败都只吞掉，绝不影响兜底主流程）。 */
+			const count = (k) => {
+				try {
+					if (typeof window === "undefined" || !window) return;
+					const st = window.__mpwBlobMediaRetry || (window.__mpwBlobMediaRetry = { calls: 0, retries: 0, gaveUp: 0, byLabel: {} });
+					const bk = st.byLabel || (st.byLabel = {});
+					const b = bk[tag] || (bk[tag] = { calls: 0, retries: 0, gaveUp: 0 });
+					st[k] = (st[k] || 0) + 1;
+					b[k] = (b[k] || 0) + 1;
+				} catch (e) {}
+			};
+			/** 停的条件：已出元数据（`rs≥1`）或已报错（`error` 非空）。读失败按"停"处理（不拿读不准的状态去戳元素）。 */
+			const done = () => { try { return !!(el && (el.readyState >= 1 || el.error)) } catch (e) { return true } };
+			/** 只兜 `blob:` 源：先读 `src` 属性（`showVideoEl` 判等用的就是它，避免 `currentSrc` 还没换过来的窗口），
+			 *  读不到再退回属性值；读不出 / 为空 ⇒ 放行（fail-open：宁可多兜一次，也不漏掉真挂住的那个）。 */
+			const blobSrc = () => {
+				try {
+					let u = "";
+					try { if (el && typeof el.getAttribute === "function") u = String(el.getAttribute("src") || "") } catch (e) {}
+					if (!u) { try { u = String((el && el.src) || "") } catch (e) {} }
+					return !u || /^blob:/i.test(u);
+				} catch (e) { return true }
+			};
+			let tries = 0, timer = null;
+			const tick = () => {
+				try {
+					timer = null;
+					if (done()) return;                       // 已出元数据 / 已报错 ⇒ 停（不再重试、不再计时）
+					if (tries >= RETRY_MAX) {                 // 2 次用尽仍 rs=0 ⇒ 恰好一行 ⚠ 收尾
+						count("gaveUp");
+						try { console.warn("[dsh-mpkg-wallpaper] ⚠ " + tag + " 始终未出元数据 rs=0，已重试 " + RETRY_MAX + " 次（上游 Firefox Bug " + BUG + "：blob>1MiB 走 IPC 异步流、同步读挂住；健康浏览器上永不触发）"); } catch (e) {}
+						return;
+					}
+					tries++;                                  // 只数"真的调了 load()"的次数
+					count("retries");
+					try { console.warn("[dsh-mpkg-wallpaper] 🔁 " + tag + " rs=0 无元数据 → 第 " + tries + "/" + RETRY_MAX + " 次补 load()（上游 Firefox Bug " + BUG + "；依据渲染器仓探针 tests/mpkg-videobase-recovery-probe.mjs：只补一次 load() 即恢复）"); } catch (e) {}
+					try { el.load() } catch (e) {}
+					try { const p = el.play(); if (p && typeof p.catch === "function") p.catch(() => {}) } catch (e) {}
+					timer = setTimeout(tick, RETRY_GAP_MS);
+				} catch (e) {}
+			};
+			try {
+				count("calls");
+				if (!el) return;                          // 元素已摘 / 还没建：什么都不做
+				if (!blobSrc()) return;                   // HTTP/宿主直供：不打扰（探针里 rs=4 的就是这条健康路径）
+				if (done()) return;                       // 健康浏览器：一次 load() 都不调、也不计时
+				/* "立刻停"的另一半：真出元数据 / 真报错时把**待发的那一发**撤掉（不产生多余的 load()）。
+				   `{once:true}` + 元素长期存活 ⇒ 不累积；拿不到 addEventListener 就算了（tick 里仍会判）。 */
+				try {
+					if (typeof el.addEventListener === "function") {
+						const stop = () => { try { if (timer != null) clearTimeout(timer) } catch (e) {} timer = null };
+						el.addEventListener("loadedmetadata", stop, { once: true });
+						el.addEventListener("error", stop, { once: true });
+					}
+				} catch (e) {}
+				timer = setTimeout(tick, RETRY_GAP_MS);
+			} catch (e) {}
+		}
+		/* ═══ MPW-BLOBRETRY-END ═══ */
+		/* ═══ MPW-WEJSON-BEGIN ═══ */
+		/* 官方随包 JSON 的**宽容解析**（WE 允许尾逗号；我们的 `JSON.parse` 不允许）。
+		 *
+		 * ── 为什么必须有（官方证据，2026-09-24 官方产物盘点；与渲染器仓同一轮定性）──────────────
+		 *   · 官方随包发布的 `wallpaper_engine/assets/effects/fluidsimulation/effect.json`（10,224 B）
+		 *     **自己就带尾逗号**：第 402 行 `"shaders/effects/fluidsimulation_normal.vert",` 后面紧跟 `}`
+		 *     ⇒ 标准 `JSON.parse` 报 `Expecting value: line 403 column 2`。WE 照发照用 ⇒ **官方容忍尾逗号**
+		 *     （引擎用 jsoncpp，二进制里带 `allowTrailingCommas`/`allowComments` 开关名）。
+		 *   · 后果是**静默**的：本仓凡是"读包内条目失败就 catch 成 null"的地方（project.json 属性表、
+		 *     web 壁纸的 general.properties…），遇到这种文件会**整份丢掉** —— 属性面板空白、`{user:…}`
+		 *     绑定全部回落默认值，而日志里一行都不会有。
+		 *   · 渲染器仓的对应修复编号 **P-177**（`core/we-scene-bundle.js` 的 `export function parseWeJson`
+		 *     + `weJsonStats()`，同一轮把页面与 bundle 里"读容器条目文本"的解析点全部换过去）。本块与它
+		 *     **逐条同口径**（行为对照，不是代码搬运：渲染器仓是 GPL-3.0-or-later、本仓 MIT ⇒ 这里按同一
+		 *     语义**独立实现**，`tools/we-json-tolerance-test.mjs` 拿同一组夹具把两边的读数逐条对拍）。
+		 *     宿主侧 `lib/pkg-extract.js` 里的同名实现（Node 侧、同一语义）与本块在同一份判据里逐夹具对拍
+		 *     （防两处漂移）。
+		 *
+		 * ── 口径（只做"官方明确容忍"的那两件事，其余照旧抛）──────────────────────────────────
+		 *   ① 尾逗号：`,` 后面（跳过空白）紧跟 `}` / `]` ⇒ 丢掉这个逗号；**字符串内的逗号一律不动**
+		 *      （扫描器带 inString/escape 状态，不会碰 `"a,}"` 这种内容）。
+		 *   ② 注释：**只在**"去掉尾逗号后仍解析失败"时才尝试剥 `//` 与 `/* *\/`（同样字符串内不动），
+		 *      并单独计数 —— 这样"到底有没有真用到"现场看得见，不是我们猜的。
+		 *   ③ BOM（U+FEFF）与官方一致地吃掉（`JSON.parse` 自己不认 BOM）。
+		 *   **健康文件逐位等价于 `JSON.parse`**：先走 `JSON.parse(text)`，成功就原样返回（plain 计数 +1）；
+		 *   只有失败才落到宽容路径。真坏 JSON **仍然抛** ⇒ **调用点的 try/catch 语义一个都不变**
+		 *   （原来抛的还抛、原来吞的还吞，只是吞的那几处现在要记账，见 `mpwWeJsonSwallowed`）。
+		 *   计数：`mpwWeJsonStats()` 返回 `{ calls, plain, trailingComma, comments, failed, swallowed }`
+		 *   —— 前五项与渲染器 `weJsonStats()` 同名同义（两仓对拍用同一组读数）；`swallowed` 是本仓
+		 *   额外加的"被调用方吞掉"记账（渲染器那边是调用点自己记日志，没有这一项）。 */
+		const MPW_WEJSON = { calls: 0, plain: 0, trailingComma: 0, comments: 0, failed: 0, swallowed: 0 };
+		/** 只读快照（对外只给这个，避免调用方改计数）。 */
+		function mpwWeJsonStats() { return Object.assign({}, MPW_WEJSON) }
+		/** 文本整形：一趟扫描，按需去掉**字符串外**的尾逗号（`withComments=false`）或尾逗号 + 注释
+		 *  （`withComments=true`）。**字符串里的一律照抄**（`"a,}"` / `"//"` / `"/*"` 一个字都不动）；
+		 *  注释替换成等长空白，行号与列号都保持可读；尾逗号判定会**越过空白与注释**看下一个有效字符
+		 *  （所以 `{"a":1, /* c *\/ }` 与不带注释的写法同解）。 */
+		function mpwWeJsonRepair(src, withComments) {
+			let out = "", inStr = false, esc = false;
+			for (let i = 0; i < src.length; i++) {
+				const c = src[i], d = src[i + 1];
+				if (inStr) {                     // 字符串内：只跟 escape 状态，内容逐字照抄
+					out += c;
+					if (esc) esc = false;
+					else if (c === "\\") esc = true;
+					else if (c === '"') inStr = false;
+					continue;
+				}
+				if (c === '"') { inStr = true; out += c; continue }
+				if (withComments && c === "/" && d === "/") {              // `//` 行注释 ⇒ 空白
+					while (i < src.length && src[i] !== "\n") { out += " "; i++ }
+					out += "\n";
+					continue;
+				}
+				if (withComments && c === "/" && d === "*") {              // `/* */` 块注释 ⇒ 空白
+					out += "  "; i += 2;
+					while (i < src.length && !(src[i] === "*" && src[i + 1] === "/")) { out += (src[i] === "\n" ? "\n" : " "); i++ }
+					out += "  "; i++;
+					continue;
+				}
+				if (c === ",") {                 // 尾逗号：往后看下一个有效字符（可跨空白/注释）
+					let j = i + 1;
+					for (;;) {
+						while (j < src.length && (src[j] === " " || src[j] === "\t" || src[j] === "\n" || src[j] === "\r")) j++;
+						if (!withComments) break;
+						if (src[j] === "/" && src[j + 1] === "/") { while (j < src.length && src[j] !== "\n") j++; continue }
+						if (src[j] === "/" && src[j + 1] === "*") { j += 2; while (j < src.length && !(src[j] === "*" && src[j + 1] === "/")) j++; j += 2; continue }
+						break;
+					}
+					if (src[j] === "}" || src[j] === "]") continue;        // 尾逗号 ⇒ 丢掉这个逗号
+				}
+				out += c;
+			}
+			return out;
+		}
+		/**
+		 * 解析官方随包 JSON（project.json / scene.json / materials / effects / models / combo 定义…）。
+		 * 与 `JSON.parse` 的差别只有两条：容忍尾逗号；再不行才容忍注释（外加吃掉 BOM）。
+		 * **其余一律照旧抛**（调用方的 try/catch 语义不变）。
+		 * @param {string} text
+		 * @returns {any}
+		 */
+		function mpwParseWeJson(text) {
+			MPW_WEJSON.calls++;
+			const s0 = (typeof text === "string") ? text : String(text == null ? "" : text);
+			const s = s0.charCodeAt(0) === 0xFEFF ? s0.slice(1) : s0;       // ① BOM：官方产物会带，JSON.parse 自己不认
+			try { const v = JSON.parse(s); MPW_WEJSON.plain++; return v } catch (e) { /* 健康文件到此为止（逐位等价 JSON.parse） */ }
+			try { const v = JSON.parse(mpwWeJsonRepair(s, false)); MPW_WEJSON.trailingComma++; return v } catch (e) { /* ② 尾逗号也不够 ⇒ 再试注释 */ }
+			try { const v = JSON.parse(mpwWeJsonRepair(s, true)); MPW_WEJSON.comments++; return v }         // ③ 尾逗号 + 注释
+			catch (e) { MPW_WEJSON.failed++; throw e }                                                       // 真坏 JSON：照旧抛
+		}
+		/** 包内 JSON 解析失败、调用方**按原有语义吞掉**时的记账：计数 + 至少一行诊断（不静默）。
+		 *  （调用点的 try/catch 结构不动：这里只负责"吞了要说一声"，返回值恒 null 方便 `catch { x = ... }` 写法。） */
+		function mpwWeJsonSwallowed(where, e) {
+			try { MPW_WEJSON.swallowed++ } catch (e2) {}
+			try {
+				if (typeof mpwErr === "function") mpwErr("包内 JSON 解析失败（按原语义吞掉）: " + where, e);
+				else console.warn("[dsh-mpkg-wallpaper] 包内 JSON 解析失败（按原语义吞掉）: " + where, e);
+			} catch (e2) {}
+			return null;
+		}
+		try { window.__mpwWeJson = { parse: mpwParseWeJson, stats: mpwWeJsonStats, swallowed: mpwWeJsonSwallowed }; } catch (e) {}
+		/* ═══ MPW-WEJSON-END ═══ */
 		// ①(P-104 2026-09-17 用户发布纪律②) **插件侧 localStorage 也要有上限**：
 		//   本插件只用固定几个键（STORE_KEY / mpw_settings_backup / mpwdiag / mpwwatch），键数量天然有界；
 		//   真正的风险在**单值**——STORE_KEY 里含背景 data URL（本文件注释自述 1MB+）。这里给单值硬顶
@@ -263,7 +455,7 @@ function mpwTrace(ev, data) {
 		// ①(MERGED-3 1.3) 诊断开关速查区离线副本（渲染器离线时用）。
 		//   在线数据源 = <渲染器>/diag-flags.json（由 we-scene-demo/diag-flag-check.mjs 脚本生成，勿手改）；
 		//   tools/panel-smoke.mjs 断言本副本 == diag-flags.json 的 common 集合 → 两边同步，勿单独改这里。
-		const MPW_DIAG_FLAGS_FALLBACK = '[{"name":"att","usage":"att=legacy"},{"name":"mcc","usage":"mcc=1"},{"name":"piv","usage":"piv=1"},{"name":"align","usage":"align=0"},{"name":"parallax","usage":"parallax=legacy"},{"name":"audio","usage":"audio=1"},{"name":"whitefallback","usage":"whitefallback=0"},{"name":"hier","usage":"hier=0"},{"name":"isolate","usage":"isolate=<层名>"},{"name":"audit","usage":"audit=3"}]';
+		const MPW_DIAG_FLAGS_FALLBACK = '[{"name":"att","usage":"att=legacy"},{"name":"mcc","usage":"mcc=1"},{"name":"piv","usage":"piv=1"},{"name":"align","usage":"align=0"},{"name":"parallax","usage":"parallax=legacy"},{"name":"gyro","usage":"gyro=1"},{"name":"audio","usage":"audio=1"},{"name":"whitefallback","usage":"whitefallback=0"},{"name":"hier","usage":"hier=0"},{"name":"isolate","usage":"isolate=<层名>"},{"name":"audit","usage":"audit=3"}]';
 		const DEFAULT_THINK_BG = false; // Deep diving 背景方框：默认取消（透明）
 		const DEFAULT_ENABLED = true;
 		const DEFAULT_CLOCK = false;
@@ -2254,9 +2446,10 @@ function mpwThumbFail(el, why) {
 				const proj = projJson ? null : mpkg.entries.find((e) => e.name === "project.json");
 				if (proj) {
 					try {
-						const pj = JSON.parse(new TextDecoder().decode(await readEntry(proj)));
+						// ①(P-177 同口径) 包内 project.json 走宽容解析（官方允许尾逗号；严格 parse 会整份丢掉）
+						const pj = mpwParseWeJson(new TextDecoder().decode(await readEntry(proj)));
 						propsMap = (pj.general && pj.general.properties) || null;
-					} catch {}
+					} catch (e) { mpwWeJsonSwallowed("handleVideoTexes:project.json", e) }   // 原来就吞；现在计数 + 一行诊断
 				}
 				const key2 = file.name + "|" + file.size;
 				const prevS = readSection();
@@ -2487,7 +2680,8 @@ function mpwThumbFail(el, why) {
 		/** 解析 project.json 文本，提取标题 + 可调参数信息。 */
 		function extractProjectInfo(jsonText) {
 			try {
-				const json = JSON.parse(jsonText);
+				// ①(P-177 同口径) 包内 project.json 走宽容解析（官方允许尾逗号）；健康文件与 JSON.parse 逐位等价
+				const json = mpwParseWeJson(jsonText);
 				const props = json.general && json.general.properties;
 				const list = [];
 				if (props) {
@@ -2512,7 +2706,8 @@ function mpwThumbFail(el, why) {
 				}
 				return { title: json.title || "", properties: list };
 			} catch (e) {
-				return null;
+				// 原来就吞（bad project.json ⇒ 无标题/无属性）；现在记账：计数 + 一行诊断（不静默）
+				return mpwWeJsonSwallowed("extractProjectInfo:project.json", e);
 			}
 		}
 		/** ③(重做) 异步版：project.json 按需读取（424MB 大包不整体进内存）。 */
@@ -5097,7 +5292,13 @@ function mpwThumbFail(el, why) {
 				const dirBase = HOST_BASE + (info.src === "library"
 					? "/library-web/" + encodeURIComponent(info.id) + "/"
 					: "/custom-folder/" + encodeURIComponent(info.id) + "/");
-				fetch(dirBase + "project.json").then((r) => (r.ok ? r.json() : null)).then((pj) => {
+				// ①(P-177 同口径) 网页壁纸的包内 project.json：**先读文本再宽容解析**（原来是 r.json()，
+				//   官方带尾逗号的 project.json 会在这里被静默丢掉 ⇒ general.properties 一个都推不下去）。
+				//   原来的 `.catch(() => {})` 语义不变：解析失败仍吞，但走 mpwWeJsonSwallowed 记账。
+				fetch(dirBase + "project.json")
+					.then((r) => (r.ok ? r.text() : null))
+					.then((txt) => { try { return txt ? mpwParseWeJson(txt) : null } catch (e) { return mpwWeJsonSwallowed("webShimPushProps:project.json", e) } })
+					.then((pj) => {
 					const wire = mpwWebPropsToWire(pj);
 					try {
 						const edits = (readSection().propEdits || {})[info.key] || null;
@@ -6596,6 +6797,9 @@ function mpwThumbFail(el, why) {
 					// ⑤(新) Edge 兼容：画到 canvas
 					if (IS_EDGE) { try { showVideoEdge(url, bgElements().video); } catch { showVideoEl(url); } }
 					else showVideoEl(url);
+					/* ①(2026-09-23 上游 Firefox Bug 2056444) blob: 喂 `<video>` 的**唯一落点**（`showVideoEl` 只在这里
+					   拿到新建的 ObjectURL）⇒ 挂有界重试看门狗。健康浏览器 `rs≥1` ⇒ 一次 `load()` 都不会多调。 */
+					mpwBlobMediaRetry(bgElements().video, "视频壁纸");
 				}).catch(() => {});
 			} else if (image === "idb:img") {
 				// ③(新) 大图片 Blob 路径：ObjectURL 显示，不走 dataURL（防内存膨胀）
@@ -8458,6 +8662,9 @@ function mpwThumbFail(el, why) {
 					npAudio.src = obj;
 					npBlobUrlSet(obj);
 					const p = npAudio.play(); if (p && p.catch) p.catch(() => {});
+					/* ①(2026-09-23 上游 Firefox Bug 2056444) 同一族的静默挂起（blob 音轨 rs=0 / 无 error、
+					   play() 的 Promise 永不 settle；`decodeAudioData` 亦然）⇒ 同一个有界重试兜底。 */
+					mpwBlobMediaRetry(npAudio, "音轨");
 				}).catch(() => {});
 			} catch (e) {}
 		}
@@ -17124,7 +17331,12 @@ body[data-mpw-modal] [role="dialog"] {
 				if (section.converted !== "web" || !section.mpkgKey || section.mpkgKey.indexOf("custom|") !== 0) return;
 				const name = section.mpkgKey.slice("custom|".length);
 				const url = HOST_BASE + "/custom-folder/" + encodeURIComponent(name) + "/loadJson.json";
-				fetch(url).then((r) => (r.ok ? r.json() : null)).then((d) => {
+				// ①(P-177 同口径) 包内 loadJson.json（L2D 作者的 SettingModel）：先读文本再宽容解析；
+				//   原来的 `.catch(() => setWebCfg(null))` 语义不变，但解析失败要记账（不静默）。
+				fetch(url)
+					.then((r) => (r.ok ? r.text() : null))
+					.then((txt) => { try { return txt ? mpwParseWeJson(txt) : null } catch (e) { return mpwWeJsonSwallowed("webCfg:loadJson.json", e) } })
+					.then((d) => {
 					if (dead || !d || !d.SettingModel) { setWebCfg(null); return; }
 					const langs = d.AnimationsTexts ? Object.keys(d.AnimationsTexts) : [];
 					// ①(修正) 缓存完整 loadJson（含 EventInfos/AnimationsTexts），
@@ -17843,7 +18055,12 @@ body[data-mpw-modal] [role="dialog"] {
 										let projJson = null;
 										try {
 											const pj = await fetch(HOST_BASE + "/custom-folder/" + encodeURIComponent(w.name) + "/project.json");
-											if (pj.ok) projJson = await pj.json();
+											// ①(P-177 同口径) 包内 project.json：**先读文本再宽容解析**（官方允许尾逗号；
+											//   原来是 pj.json() ⇒ 带尾逗号的官方 project.json 在这里被静默丢掉、时段全走默认）。
+											if (pj.ok) {
+												const pjTxt = await pj.text();
+												try { projJson = mpwParseWeJson(pjTxt) } catch (e) { mpwWeJsonSwallowed("customFolder:project.json(projJson)", e) }
+											}
 										} catch {}
 										const ok = await handleVideoTexes({ entries: d.entries }, vtex, { name: w.title || w.name, size: 0 }, t, showError, readEntry, projJson, setHint, { kind: "host", token: d.token });
 										if (ok === "stale") { try { console.warn("[dsh-mpkg-wallpaper] 时段导入已过期(壁纸已切换)，跳过后续链"); } catch {}; return; }
@@ -18326,10 +18543,11 @@ body[data-mpw-modal] [role="dialog"] {
 					let cfg = { enabled: true, morning: 4, day: 9, dusk: 17, night: 20 };
 					if (projIdx >= 0) {
 						try {
-							const pj = JSON.parse(new TextDecoder().decode(await readFull(projIdx)));
+							// ①(P-177 同口径) 宿主 /media 供来的包内 project.json 也走宽容解析
+							const pj = mpwParseWeJson(new TextDecoder().decode(await readFull(projIdx)));
 							const pm = (pj.general && pj.general.properties) || null;
 							if (pm) cfg = timeConfigFromProps(pm, {});
-						} catch {}
+						} catch (e) { mpwWeJsonSwallowed("hostMedia:project.json(timeConfig)", e) }   // 原来就吞；现在记账
 					}
 					const slot = slotForTime(cfg, new Date());
 					const active = vtex.find((v) => slotFromName(v.name) === slot) || vtex[0];
@@ -20530,6 +20748,8 @@ body[data-mpw-modal] [role="dialog"] {
 			"diagflag.align.d": "?align=0：复现旧对齐（origin 恒几何中心），用于对齐语义 A/B。",
 			"diagflag.parallax": "视差旧公式",
 			"diagflag.parallax.d": "?parallax=legacy：鼠标视差退回旧 lwe 近似式；默认官方公式。",
+			"diagflag.gyro": "移动端姿态源",
+			"diagflag.gyro.d": "?gyro=1 强制启用 / ?gyro=0 完全不监听（一个监听都不挂）/ 缺省 auto（有细指针不启用、触摸设备启用）：deviceorientation 的 beta/gamma 按与鼠标同一套 u,v 喂进指针源 ⇒ 视差 g_ParallaxPosition、粒子、轨迹、脚本指针全链生效。",
 			"diagflag.audio": "开启声音",
 			"diagflag.audio.d": "?audio=1：播放场景 sound 层（每层一条流；浏览器策略可能需要先点一下页面）。",
 			"diagflag.whitefallback": "缺纹理回退",
@@ -21337,6 +21557,8 @@ body[data-mpw-modal] [role="dialog"] {
 			"diagflag.align.d": "?align=0: legacy alignment (origin always geometric center) for A/B.",
 			"diagflag.parallax": "Legacy parallax",
 			"diagflag.parallax.d": "?parallax=legacy: old lwe-approx mouse parallax; the official formula is default.",
+			"diagflag.gyro": "Device-motion pointer source",
+			"diagflag.gyro.d": "?gyro=1 force on / ?gyro=0 no deviceorientation listener at all / default auto (off when a fine pointer exists, on for touch devices): beta/gamma feed the same u,v pointer source as the mouse, so parallax g_ParallaxPosition, particles, trails and script pointers all follow.",
 			"diagflag.audio": "Enable audio",
 			"diagflag.audio.d": "?audio=1: play scene sound layers (one stream per layer; may need a user gesture).",
 			"diagflag.whitefallback": "Missing-texture fallback",

package/lib/pkg-extract.js

@@ -52,6 +52,108 @@ import { readFileSync, readdirSync, statSync, openSync, readSync, closeSync, exi
 import { join, resolve, sep } from 'node:path';
 import { deflateSync, inflateSync } from 'node:zlib';
 
+/* ═══ MPW-WEJSON-BEGIN ═══ */
+/* 官方随包 JSON 的**宽容解析**（WE 允许尾逗号；`JSON.parse` 不允许）——**宿主侧**实现。
+ *
+ * ── 为什么必须有（官方证据，2026-09-24 官方产物盘点；与渲染器仓同一轮定性）──────────────
+ *   · 官方随包发布的 `wallpaper_engine/assets/effects/fluidsimulation/effect.json`（10,224 B）
+ *     **自己就带尾逗号**：第 402 行 `"shaders/effects/fluidsimulation_normal.vert",` 后面紧跟 `}`
+ *     ⇒ 标准 `JSON.parse` 报 `Expecting value: line 403 column 2`。WE 照发照用 ⇒ **官方容忍尾逗号**
+ *     （引擎用 jsoncpp，二进制里带 `allowTrailingCommas`/`allowComments` 开关名）。
+ *   · 宿主侧同样会**静默丢整份文件**：`scene.json`（音频 sound 层引用 / 主图提取 / 图层清单）、
+ *     `model.json`、`material.json`（`access.readJson`）解析失败就是 `null` —— 少一层、少一条音轨、
+ *     回退预览图，日志一行都没有。
+ *   · 渲染器仓的对应修复编号 **P-177**（`core/we-scene-bundle.js` 的 `export function parseWeJson`
+ *     + `weJsonStats()`）；插件**客户端**侧同一实现是 `lib/client.js` 的 `mpwParseWeJson`
+ *     （`/* ═══ MPW-WEJSON-BEGIN ═══ *\/` 块）。两处是**同一语义的独立实现**（渲染器仓 GPL-3.0-or-later、
+ *     本仓 MIT ⇒ 只做行为对照，不搬运代码），且 `tools/we-json-tolerance-test.mjs` 把两处切片后
+ *     逐夹具对拍（解析值 + 计数增量全等）⇒ 防漂移。
+ *
+ * ── 口径（只做"官方明确容忍"的那两件事，其余照旧抛）──────────────────────────────────
+ *   ① 尾逗号：`,` 后面（跳过空白）紧跟 `}` / `]` ⇒ 丢掉这个逗号；**字符串内的逗号一律不动**。
+ *   ② 注释：**只在**"去掉尾逗号后仍解析失败"时才尝试剥 `//` 与 `/* *\/`（同样字符串内不动），单独计数。
+ *   ③ BOM（U+FEFF）与官方一致地吃掉。
+ *   **健康文件逐位等价于 `JSON.parse`**：先走 `JSON.parse(text)`，成功原样返回（plain +1）；
+ *   真坏 JSON **仍然抛** ⇒ 调用点的 try/catch 语义与读量（如 audio-scan 规格的 sceneJsonRead 预算）不变，
+ *   只是失败的那几处现在记账（计数 + 一行 console.warn，见 `mpwWeJsonSwallowed`），不再静默。
+ *   计数：`mpwWeJsonStats()` 返回 `{ calls, plain, trailingComma, comments, failed, swallowed }`
+ *   —— 前五项与渲染器 `weJsonStats()` / 客户端 `mpwWeJsonStats()` 同名同义。 */
+const MPW_WEJSON = { calls: 0, plain: 0, trailingComma: 0, comments: 0, failed: 0, swallowed: 0 };
+const MPW_WEJSON_SEEN = new Map();   // where|msg → 次数（诊断去重：同一个坏文件只吵一行）
+/** 只读快照（对外只给这个，避免调用方改计数）。 */
+function mpwWeJsonStats() { return Object.assign({}, MPW_WEJSON) }
+/** 文本整形：一趟扫描，按需去掉**字符串外**的尾逗号（`withComments=false`）或尾逗号 + 注释
+ *  （`withComments=true`）。**字符串里的一律照抄**（`"a,}"` / `"//"` / `"/*"` 一个字都不动）；
+ *  注释替换成等长空白，行号与列号都保持可读；尾逗号判定会**越过空白与注释**看下一个有效字符
+ *  （所以 `{"a":1, /* c *\/ }` 与不带注释的写法同解）。与客户端 `lib/client.js` 的同名函数同语义。 */
+function mpwWeJsonRepair(src, withComments) {
+  let out = '', inStr = false, esc = false;
+  for (let i = 0; i < src.length; i++) {
+    const c = src[i], d = src[i + 1];
+    if (inStr) {                     // 字符串内：只跟 escape 状态，内容逐字照抄
+      out += c;
+      if (esc) esc = false;
+      else if (c === '\\') esc = true;
+      else if (c === '"') inStr = false;
+      continue;
+    }
+    if (c === '"') { inStr = true; out += c; continue }
+    if (withComments && c === '/' && d === '/') {              // `//` 行注释 ⇒ 空白
+      while (i < src.length && src[i] !== '\n') { out += ' '; i++ }
+      out += '\n';
+      continue;
+    }
+    if (withComments && c === '/' && d === '*') {              // `/* */` 块注释 ⇒ 空白
+      out += '  '; i += 2;
+      while (i < src.length && !(src[i] === '*' && src[i + 1] === '/')) { out += (src[i] === '\n' ? '\n' : ' '); i++ }
+      out += '  '; i++;
+      continue;
+    }
+    if (c === ',') {                 // 尾逗号：往后看下一个有效字符（可跨空白/注释）
+      let j = i + 1;
+      for (;;) {
+        while (j < src.length && (src[j] === ' ' || src[j] === '\t' || src[j] === '\n' || src[j] === '\r')) j++;
+        if (!withComments) break;
+        if (src[j] === '/' && src[j + 1] === '/') { while (j < src.length && src[j] !== '\n') j++; continue }
+        if (src[j] === '/' && src[j + 1] === '*') { j += 2; while (j < src.length && !(src[j] === '*' && src[j + 1] === '/')) j++; j += 2; continue }
+        break;
+      }
+      if (src[j] === '}' || src[j] === ']') continue;          // 尾逗号 ⇒ 丢掉这个逗号
+    }
+    out += c;
+  }
+  return out;
+}
+/**
+ * 解析官方随包 JSON（scene.json / project.json / materials / effects / models / combo 定义…）。
+ * 与 `JSON.parse` 的差别只有两条：容忍尾逗号；再不行才容忍注释（外加吃掉 BOM）。
+ * **其余一律照旧抛**（调用方的 try/catch 语义不变）。
+ * @param {string} text
+ * @returns {any}
+ */
+function mpwParseWeJson(text) {
+  MPW_WEJSON.calls++;
+  const s0 = (typeof text === 'string') ? text : String(text == null ? '' : text);
+  const s = s0.charCodeAt(0) === 0xFEFF ? s0.slice(1) : s0;       // ① BOM：官方产物会带，JSON.parse 自己不认
+  try { const v = JSON.parse(s); MPW_WEJSON.plain++; return v } catch (e) { /* 健康文件到此为止（逐位等价 JSON.parse） */ }
+  try { const v = JSON.parse(mpwWeJsonRepair(s, false)); MPW_WEJSON.trailingComma++; return v } catch (e) { /* ② 尾逗号也不够 ⇒ 再试注释 */ }
+  try { const v = JSON.parse(mpwWeJsonRepair(s, true)); MPW_WEJSON.comments++; return v }         // ③ 尾逗号 + 注释
+  catch (e) { MPW_WEJSON.failed++; throw e }                                                      // 真坏 JSON：照旧抛
+}
+/** 包内 JSON 读取/解析失败、调用方**按原有语义吞掉**时的记账：计数 + 一行 console.warn（不静默）。
+ *  （调用点的 try/catch 结构不动；返回值恒 null 方便 `catch { x = ... }` 写法。同 where+msg 只吵一次。） */
+function mpwWeJsonSwallowed(where, e) {
+  try { MPW_WEJSON.swallowed++ } catch (e2) {}
+  try {
+    const key = where + '|' + String((e && e.message) || e);
+    const n = (MPW_WEJSON_SEEN.get(key) || 0) + 1;
+    MPW_WEJSON_SEEN.set(key, n);
+    if (n === 1) console.warn('[dsh-mpkg-wallpaper] 包内 JSON 读取/解析失败（按原语义吞掉）: ' + where + ' — ' + String((e && e.message) || e));
+  } catch (e2) {}
+  return null;
+}
+/* ═══ MPW-WEJSON-END ═══ */
+
 /** Wallpaper Engine texture format ids (TEXI0001 header), per RePKG/lwe. */
 const TexFormat = {
   RGBA8888: 0,
@@ -587,8 +689,9 @@ function enumerateAudioTracks(src) {
     if (sjEntry) {
       try {
         const bytes = readEntry(sjEntry);
-        if (bytes && bytes.length) { sceneJson = JSON.parse(textDecoder.decode(bytes)); sceneJsonRead = true; }
-      } catch { sceneJson = null; }
+        // ①(P-177 同口径) 包内 scene.json 走宽容解析（官方允许尾逗号）；原来解析失败就 null（静默丢 refs）
+        if (bytes && bytes.length) { sceneJson = mpwParseWeJson(textDecoder.decode(bytes)); sceneJsonRead = true; }
+      } catch (e) { sceneJson = mpwWeJsonSwallowed('enumerateAudioTracks:scene.json（容器内）', e); }
     }
   }
   for (const { layer, path } of collectSoundLayerRefs(sceneJson)) note(path, layer, 0);
@@ -633,8 +736,9 @@ function collectDirAudioTracks(dir, opts = {}) {
   let sceneJson = null;
   try {
     const sj = join(dir, 'scene.json');
-    if (existsSync(sj)) sceneJson = JSON.parse(readFileSync(sj, 'utf8'));
-  } catch { sceneJson = null; }
+    // ①(P-177 同口径) 松散场景目录的 scene.json 也走宽容解析（原来解析失败静默 null）
+    if (existsSync(sj)) sceneJson = mpwParseWeJson(readFileSync(sj, 'utf8'));
+  } catch (e) { sceneJson = mpwWeJsonSwallowed('collectDirAudioTracks:' + join(dir, 'scene.json'), e); }
   const readHead = (entry, n) => {
     try {
       const len = Math.max(0, Math.min(n, entry.size));
@@ -1351,9 +1455,10 @@ function pkgSceneAccess(pkgData) {
       const file = readFile(path);
       if (!file) return null;
       try {
-        return JSON.parse(textDecoder.decode(file.bytes));
-      } catch {
-        return null;
+        // ①(P-177 同口径) 容器内 scene.json / model.json / material.json 走宽容解析（官方允许尾逗号）
+        return mpwParseWeJson(textDecoder.decode(file.bytes));
+      } catch (e) {
+        return mpwWeJsonSwallowed('pkgSceneAccess.readJson:' + path, e);   // 原来就吞；现在记账
       }
     },
     readFile,
@@ -1459,9 +1564,10 @@ function dirSceneAccess(dir) {
       const file = readFile(path);
       if (!file) return null;
       try {
-        return JSON.parse(textDecoder.decode(file.bytes));
-      } catch {
-        return null;
+        // ①(P-177 同口径) 松散场景目录里的 scene.json / model.json / material.json 走宽容解析
+        return mpwParseWeJson(textDecoder.decode(file.bytes));
+      } catch (e) {
+        return mpwWeJsonSwallowed('dirSceneAccess.readJson:' + path, e);   // 原来就吞；现在记账
       }
     },
     readFile,

package/package.json

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