dsh-mpkg-wallpaper 3.13.4 → 3.13.5

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