dsh-mpkg-wallpaper 3.13.4 → 3.13.6

package/lib/client.js

@@ -5725,7 +5725,9 @@ function mpwThumbFail(el, why) {
 			const c2 = canvas.getContext("2d");
 			if (!c2) return;
 			const layers = manifest.layers || [];
-			if (!layers.length) return;
+			/* ①(P-184) 清单里一层都没有：也落一次**0 层**戳 —— 否则会留着上一份同 key 清单的旧戳，
+			   慢判就会把"这份清单没画面"误读成"画出来了"（与"所有层加载失败"同一条口径：如实判没画出来）。 */
+			if (!layers.length) { mpwScenePaintStamp(canvas, manifest.key, 0); return; }
 			sceneImgs = layers.map(() => null);
 			let pending = layers.length;
 			const draw = () => {
@@ -5738,13 +5740,18 @@ function mpwThumbFail(el, why) {
 				// 图层定位：清单坐标是场景包围盒内偏移（[0,W]×[0,H]），
 				// 场景中心 = (W/2, H/2) 对齐屏幕中心。
 				const offX = manifest.w / 2, offY = manifest.h / 2;
+				let drawn = 0;
 				for (let i = 0; i < layers.length; i++) {
 					const im = sceneImgs[i];
 					const l = layers[i];
 					if (!im || !im.width || !im.height) continue;
 					const w = l.w * scale, h = l.h * scale;
 					c2.drawImage(im, cx + (l.x - offX) * scale - w / 2, cy + (l.y - offY) * scale - h / 2, w, h);
+					drawn++;
 				}
+				/* ①(2026-09-25 P-184) 落**画过戳**：只认"真的画了几层 + 画的是哪一份清单"（见
+				   `mpwScenePaintStamp` 的注释）。0 层 ⇒ 戳为 0 ⇒ 慢判如实判"没画出来"并补一次 + 告警。 */
+				mpwScenePaintStamp(canvas, manifest.key, drawn);
 			};
 			layers.forEach((l, i) => {
 				const im = new Image();
@@ -5858,12 +5865,36 @@ function mpwThumbFail(el, why) {
 		     · 慢判（12s）：有 src 但**一直没有画面** ⇒ 强制重挂一次（同签名只做一次）。
 		   诚实边界：转码档（host 正在转）不判死 —— 它有自己的超时回退（见 showVideoEl 后面的
 		   `__mpwTransLoadingTimeout`），在后面推它只会把转码重来一遍。 */
+		/* ①(2026-09-25 P-184) 场景合成的"画过"戳：**逐层计数**（`mpwScenePaintStamp`/`mpwScenePainted`）。
+		   为什么必须换成戳：慢判（12s"有 src 但一直没有画面 ⇒ 强制重挂一次"）原来对 scene 档用的判据是
+		   `canvas.width > 0` —— 而 `draw()` **一开始**就按视口设宽高、`clearRect` 之后逐层 `drawImage`，
+		   **所有图层都加载失败时**（真机：图层 URL 404 / token 失效 / 清单里全是坏 url）宽高照样被设上
+		   ⇒ 判据退化成"元素存在"，慢判恒为"画出来了"、自愈永不触发，用户看到的是**永久空白且无自愈**。
+		   现在只有**真的 `drawImage` 过 ≥1 层、且那一次画的正是当前 sceneKey** 才算"画出来了"。
+		   （抽成两个只用 canvas 普通字段的小函数，是为了让门禁能单独切出来跑真实现：
+		   `tools/bgpaint-heal-test.mjs`；也便于宿主/探针读同一处口径。） */
+		function mpwScenePaintStamp(canvas, key, drawn) {
+			try {
+				if (!canvas) return 0;
+				canvas.__mpwBgDrawnLayers = Number(drawn) || 0;
+				canvas.__mpwBgDrawnKey = String(key == null ? "" : key);
+				canvas.__mpwBgDrawnAt = (typeof Date !== "undefined" && Date.now) ? Date.now() : 0;
+				return canvas.__mpwBgDrawnLayers;
+			} catch { return 0 }
+		}
+		function mpwScenePainted(canvas, key) {
+			try {
+				if (!canvas) return false;
+				if (!((Number(canvas.__mpwBgDrawnLayers) || 0) > 0)) return false;
+				return String(canvas.__mpwBgDrawnKey || "") === String(key == null ? "" : key);
+			} catch { return false }
+		}
 		function mpwBgPaintedNow(section) {
 			try {
 				const { img, video, canvas, wrap } = bgElements();
 				if (!wrap) return true;
 				if (section.webUrl) return true;                       // 帧内画面看不见，不越权判死
-				if (section.converted === "scene" && section.sceneKey) return !!(canvas && (canvas.width || 0) > 0);
+				if (section.converted === "scene" && section.sceneKey) return mpwScenePainted(canvas, section.sceneKey);
 				if (section.converted === "mp4") {
 					if (!video) return true;
 					let st = "";
@@ -5937,7 +5968,7 @@ function mpwThumbFail(el, why) {
 			}
 			try { applyFromStorageInner() } catch (e) { mpwErr("壁纸源补挂", e) }
 		}
-		try { window.__mpwBgWrapState = () => ({ fixOn: mpwBgWrapFixOn(), heal: (() => { try { return window.__mpwBgSrcHeal || 0 } catch { return -1 } })(), last: __mpwBgHeal, paintedNow: (() => { try { return mpwBgPaintedNow(normalizeSection(readSection())) } catch { return null } })() }) } catch {}
+		try { window.__mpwBgWrapState = () => ({ fixOn: mpwBgWrapFixOn(), heal: (() => { try { return window.__mpwBgSrcHeal || 0 } catch { return -1 } })(), last: __mpwBgHeal, paintedNow: (() => { try { return mpwBgPaintedNow(normalizeSection(readSection())) } catch { return null } })(), drawn: (() => { try { const c = bgElements().canvas; return c ? { layers: Number(c.__mpwBgDrawnLayers) || 0, key: String(c.__mpwBgDrawnKey || ""), at: Number(c.__mpwBgDrawnAt) || 0 } : null } catch { return null } })() }) } catch {}
 		/* ═══ ①(2026-09-16 根治) 设置归一化：**必须是模块级函数** ═══
 		   历史 bug（"标题栏磨砂一直没有效果"的真根因，真机 diag 实锤）：
 		     `__asStr` / `normalizeSection` 原本定义在 `applyFromStorageInner()` **函数体内**

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

@@ -154,6 +154,14 @@ function mpwWeJsonSwallowed(where, e) {
 }
 /* ═══ 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,

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