dsh-mpkg-wallpaper 3.13.3 → 3.13.5

package/lib/client.js

@@ -169,6 +169,109 @@ function mpwTrace(ev, data) {
 			} 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+）。这里给单值硬顶
@@ -352,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;
@@ -2343,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();
@@ -2576,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) {
@@ -2601,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 大包不整体进内存）。 */
@@ -5186,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;
@@ -17219,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），
@@ -17938,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; }
@@ -18421,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];
@@ -20625,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": "缺纹理回退",
@@ -21432,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/index.js

@@ -16,7 +16,7 @@ import { execFileSync, spawn } from 'node:child_process';
 // ①(2026-09-21 音频格式补全) 后三个导出是**唯一的**扩展名→MIME 表与嗅探入口，见 docs/AUDIO-TRACK-SPEC.md §1.2/§3：
 //   路由侧原先各自内联一份扩展名三元链 + 一份魔数嗅探，已与渲染器支持的后缀漂移（.oga/.m4a/.aac 缺失、ftyp 偏移写错）。
 //   ⚠ 这条 import 必须**保持单行**：tools/bundle-equivalence-test.mjs 的具名导入解析器按行读（注释进括号会解析失败）。
-import { extractSceneMainImage, extractSceneMainImageFromDir, extractSceneManifest, extractSceneLayer, extractTexVideoMp4, collectSceneVideoFiles, parsePkg, readPkgEntry, scanSceneAudio, scanSceneVideo, clearSceneVideoScanCache, suffixAudioMime, audioMimeFor, AUDIO_SUFFIX_MIME } from './pkg-extract.js';
+import { extractSceneMainImage, extractSceneMainImageFromDir, extractSceneManifest, extractSceneLayer, extractTexVideoMp4, collectSceneVideoFiles, parsePkg, readPkgEntry, scanSceneAudio, scanSceneVideo, clearSceneVideoScanCache, suffixAudioMime, audioMimeFor, AUDIO_SUFFIX_MIME, mpwParseWeJson, mpwWeJsonSwallowed } from './pkg-extract.js';
 // ①(新 2026-09-16 I 项) 网页（web）类壁纸：内容优先的类型判定 + WE API shim 注入 + 跨源策略
 // （MIT，本仓库自写；API 名单参考 oneincase/webwallgl，未复制其代码，见 ../docs/COPYING-RULES.md §4）
 // ①(WP-1 2026-09-19) 追加：帧内存储 facade 的持久化路由（/web-store）、宿主媒体音频控制
@@ -3830,7 +3830,18 @@ function apply(ctx) {
               const proj = join(p, 'project.json');
               if (!existsSync(proj)) continue;
               try {
-                const meta = JSON.parse(readFileSync(proj, 'utf8'));
+                /* ①(2026-09-24 包内/包旁 JSON 收口线) **包旁** JSON：Steam 库里 `<壁纸目录>/project.json`
+                   （与 scene.pkg 同级，官方工坊布局）⇒ 走**宿主侧同一份**宽容解析（尾逗号/注释/BOM；
+                   官方 `assets/effects/fluidsimulation/effect.json` 第 402 行自己就带尾逗号）。
+                   语义与改动前一致：读不到/真坏 JSON ⇒ 仍然抛（下面的既有 catch 照旧跳过该壁纸并 console.warn）。
+                   多出来的是**记账**：解析器计数（`mpwWeJsonStats().failed`）+ 下面 catch 里的
+                   `mpwWeJsonSwallowed`（计数 + 一行诊断；同 where+原因只吵一次）—— 原来只有一句 warn，
+                   "坏在哪一步/坏了几次"看不出来。**注意只在解析这一段**调用记账：`readdirSync`/探测
+                   失败不该被记成"JSON 坏"（归因不能糊）。 */
+                const meta = (() => {
+                  try { return mpwParseWeJson(readFileSync(proj, 'utf8')); }
+                  catch (e) { mpwWeJsonSwallowed('[steam-inventory] ' + proj, e); throw e; }
+                })();
                 const type = (meta.type || 'scene').toLowerCase();
                 // ④(安全) 排除 application / exe 壁纸：这类已弃用的 .exe 格式可能被注入病毒，
                 // 本插件绝不读取/执行任何 .exe。scene 只给预览图（无法渲染）。

package/lib/pkg-extract.js

@@ -52,6 +52,116 @@ 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 ═══ */
+
+/* ①(2026-09-24 包内/包旁 JSON 收口线) **宿主侧复用出口**：`lib/web-wallpaper.js`（WE 目录的 `project.json`）
+   与 `lib/index.js`（Steam 库壁纸目录的 `project.json`）都要用**同一份**宽容解析与记账 —— 导出面只加名字，
+   解析逻辑、计数口径、`swallowed` 语义**一字未动**（"包内 JSON 解析点都要记账"这条纪律由
+   tools/we-json-tolerance-test.mjs 的静态反查看住）。客户端侧 `lib/client.js` 的同名块是**浏览器产物**的
+   内联副本（页面没有模块图），两边一致性由同一条门禁的切片对拍看着 —— 所以这里不是"第三份实现"，
+   而是把宿主这一份**接出来给宿主模块共用**。 */
+export { mpwParseWeJson, mpwWeJsonStats, mpwWeJsonSwallowed };
+
 /** Wallpaper Engine texture format ids (TEXI0001 header), per RePKG/lwe. */
 const TexFormat = {
   RGBA8888: 0,
@@ -587,8 +697,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 +744,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 +1463,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 +1572,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/lib/web-wallpaper.js

@@ -31,6 +31,13 @@ import { createHash } from 'node:crypto';
 //  为什么要 import 而不是复制一份：触摸的协议形状（`op:'touch'` 的字段表）与父页整形体同在
 //  lib/web-interaction.js，**唯一源**不能有两份（tools/web-interaction-test.mjs 会断言两侧一致）。
 import { WEB_TOUCH_FRAME_SOURCE } from './web-interaction.js';
+// ①(2026-09-24 包内/包旁 JSON 收口线) 官方随包 JSON 的**宽容解析**：**复用宿主侧那一份**
+//   （`lib/pkg-extract.js` 的 MPW-WEJSON 块，P-177 同口径：先 JSON.parse → 字符串外尾逗号 → 再不行剥注释；
+//   BOM 吃掉；真坏 JSON 仍然抛）。为什么必须共享而不是在本文件再写一遍：本仓已有两份同语义实现
+//   （`lib/client.js` 浏览器内联副本 + `lib/pkg-extract.js` 宿主侧），tools/we-json-tolerance-test.mjs
+//   把两处切片逐夹具对拍防漂移 —— 再加第三份就是三处漂移面。
+//   ⚠ 本模块是**宿主侧** ESM（Node），与 `lib/index.js` 同一个模块图（bundle 的模块表因此不变）。
+import { mpwParseWeJson, mpwWeJsonSwallowed } from './pkg-extract.js';
 
 /** 类型判定结果（四态 + 排除态） */
 export const WEB_KIND = { WEB: 'web', SCENE: 'scene', VIDEO: 'video', UNKNOWN: 'unknown' };
@@ -316,15 +323,27 @@ export function listWallpaperFiles(root, opts = {}) {
   return out;
 }
 
-/** 读并解析目录里的 project.json（缺失/损坏 → null；损坏不抛，交给启发式兜底） */
+/** 读并解析目录里的 project.json（缺失 → null；损坏 → 记账后 null，交给启发式兜底）。
+ *  ①(2026-09-24 包内/包旁 JSON 收口线) 读的是 **WE 目录的 `project.json`**（**包旁**：官方工坊布局里与
+ *  `scene.pkg` 同级；本模块的 `detectWallpaperDir` → `detectWebWallpaperKind` 用它做**内容优先**判定，
+ *  `general.file` 是网页壁纸入口的第一顺位证据）⇒ 必须容忍官方允许的尾逗号/注释：官方随包发布的
+ *  `assets/effects/fluidsimulation/effect.json` 第 402 行自己就带尾逗号（WE 用 jsoncpp 照用），
+ *  严格 `JSON.parse` 会把这份**包旁属性表/入口声明**整份丢掉 ⇒ 类型判定只剩文件名启发式、属性推不下去，
+ *  而且**日志一行都没有**（改前的 `catch { return null }` 就是这类静默）。
+ *  语义保持"读不到就是 null"（缺失 ⇒ null / 真坏 JSON ⇒ 记账后 null，照旧不抛 —— 调用方按启发式兜底）；
+ *  `mpwWeJsonSwallowed` 给计数 + 一行诊断（同 where+原因只吵一次）。 */
 export function readProjectJson(dir) {
+  const p = join(dir, 'project.json');
+  let text = null;
   try {
-    const p = join(dir, 'project.json');
     if (!statSync(p).isFile()) return null;
-    const obj = JSON.parse(readFileSync(p, 'utf8'));
+    text = readFileSync(p, 'utf8');
+  } catch { return null; }        // 缺失/损坏的路径/IO 读不到 ⇒ null（原语义；**不是** JSON 问题，不记账成 JSON 坏）
+  try {
+    const obj = mpwParseWeJson(text);
     return obj && typeof obj === 'object' ? obj : null;
-  } catch {
-    return null;
+  } catch (e) {
+    return mpwWeJsonSwallowed('web-wallpaper:readProjectJson(' + p + ')', e);
   }
 }
 

package/package.json

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