dsh-mpkg-wallpaper 3.16.3 → 3.16.4

package/lib/client.js

@@ -6876,9 +6876,11 @@ function mpwThumbFail(el, why) {
 		/** ①(新) scene 内嵌视频探测（scene-video 快路径）：探测 URL 按 key 路由。
 		 *  返回 { has, mime }；网络错误/未找到视为无视频（回退静态帧）。 */
 		function sceneVideoCheckUrl(key) {
-			if (key && key.indexOf("library|") === 0) return HOST_URL + "/library-scene-video-check?ltoken=" + encodeURIComponent(key.slice(8));
+			// ①(2026-10-04) `has=1`：只要"有没有"（宿主走只读目录表+前缀的 verdict，不再为问一句提取整段视频）；
+			//   不带该参数时宿主保持旧行为（含 mime/size 与探测即落盘缓存）——旧路径判据因此逐位不变。
+			if (key && key.indexOf("library|") === 0) return HOST_URL + "/library-scene-video-check?has=1&ltoken=" + encodeURIComponent(key.slice(8));
 			const name = key && key.indexOf("custom|") === 0 ? key.slice(7) : "";
-			return HOST_URL + "/custom-scene-video-check?folder=" + encodeURIComponent(name);
+			return HOST_URL + "/custom-scene-video-check?has=1&folder=" + encodeURIComponent(name);
 		}
 		function checkSceneVideo(key) {
 			// ①(修正) 探测加 4s 超时：host 端首查需同步读包/落盘（可达 1-3s），

package/lib/index.js

@@ -16,7 +16,7 @@ import { execFileSync, spawn, spawnSync } 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, mpwParseWeJson, mpwWeJsonSwallowed } from './pkg-extract.js';
+import { extractSceneMainImage, extractSceneMainImageFromDir, extractSceneManifest, extractSceneLayer, extractTexVideoMp4, collectSceneVideoFiles, parsePkg, readPkgEntry, scanSceneAudio, scanSceneVideo, clearSceneVideoScanCache, probeSceneVideoVerdict, 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）、宿主媒体音频控制
@@ -4229,6 +4229,31 @@ function apply(ctx) {
     const probeSceneVideo = (req, res, dir) => {
       const t0 = Date.now();
       try {
+        /* ①(2026-10-04) **只判不取**（**仅当调用方显式要 `?has=1` 时**）：客户端"卡片/清单阶段"
+         *   只问"这张场景有没有内嵌视频"（`lib/client.js` 只读 `d.has`），而 `ensureSceneVideo` 是
+         *   "判定 + 提取"一体的（会把整段内嵌视频读进内存并落盘；实测 792MB 的容器 = 791.6MB 读盘）。
+         *   `?has=1` 时先走只读目录表 + 候选前缀的 `probeSceneVideoVerdict`（实测 64KB/容器）：能判定
+         *   就直接答 `{ok,has}`，答不了（unknown/多独立视频/松散目录）回退提取路径。
+         *   ⚠ **不带该参数时行为与改前逐位相同**（含 `{has,mime,size}` 响应形状与"探测即落盘缓存"
+         *   的既有契约）—— 既有判据 `tools/scene-video-test.mjs` 钉的正是那条默认路径。 */
+        const wantHasOnly = (() => {
+          try {
+            const q = String((req && req.url) || '');
+            return /[?&]has=1(?:&|$)/.test(q);
+          } catch { return false; }
+        })();
+        try {
+          const verdict = wantHasOnly ? probeSceneVideoVerdict(dir) : null;
+          if (verdict && verdict.decided) {
+            const ms0 = Date.now() - t0;
+            if (ms0 > 500) {
+              try { console.log('[dsh-mpkg-wallpaper][perf] scene 视频探测(verdict) ' + ms0 + 'ms:', dir); } catch {}
+            }
+            if (!verdict.has) { json(res, 200, { ok: true, has: false, verdict: true }); return; }
+            json(res, 200, { ok: true, has: true, verdict: true });
+            return;
+          }
+        } catch { /* verdict 出意外 → 回退提取路径（与改前同一答案） */ }
         const v = ensureSceneVideo(dir);
         const ms = Date.now() - t0;
         if (ms > 500) {

package/lib/pkg-extract.js

@@ -427,6 +427,35 @@ function readPkgEntry(data, entry) {
   return out;
 }
 
+/**
+ * ①(2026-10-04) **从"已读出的存储字节"还原一条目**：把"是否 LZ4 链"的判定交给**唯一口径**
+ * `probeCompressedEntry`（与 `parsePkg` 同一函数），而不是依赖调用方传进来的 `flags`。
+ *
+ * 为什么需要：`readPkgIndexFromFile` 只读目录表，条目内容不在已读头里 ⇒ 头解析出来的条目
+ * `flags` 恒为 0（`partial:true`）。索引先行的路径据此把**压缩条目**当 raw 用 ⇒ 视频/TEX
+ * 在"压缩存储"时会静默探测失败（legacy 整包口径却能成功）—— 这正是"两条路径判定分叉"的形态。
+ * 这里用全量存储字节做判定（信息最全），成功即解压；`flags & 1` 的快路保留（整包口径）。
+ */
+function decodeStoredEntry(stored, entry) {
+  const raw = stored instanceof Uint8Array ? stored : new Uint8Array(stored)
+  let original = null
+  if ((entry.flags & 1) === 0) {
+    // 头解析出来的条目 `size` 是**存储长度**（partial），不能拿它当原始长度：链头 u64 才是真值
+    try { original = probeCompressedEntry(raw, 0, raw.length) } catch { original = null }
+    if (original === null) return raw
+  }
+  if (original === null) {
+    // 整包口径（flags&1）：`entry.size` 已是 probe 出来的原始长度；仍以链头为准做一致性兜底
+    try {
+      const view = new DataView(raw.buffer, raw.byteOffset, raw.byteLength)
+      const head = Number(view.getBigUint64(0, true))
+      original = head > 0 && head <= 2147483647 ? head : entry.size
+    } catch { original = entry.size }
+  }
+  const w = { path: entry.path, offset: 0, compressedSize: raw.length, size: original, flags: 1 }
+  return readPkgEntry(raw, w)
+}
+
 /* ═══════════════════════════════════════════════════════════════════════════
  * ①(2026-09-15 用户第 1 条反馈「扫描音频的速度能否快些」) 惰性音频索引
  *
@@ -2446,11 +2475,9 @@ function scanSceneVideo(dirOrPath, opts = {}) {
           const got = readSync(fd, stored, 0, stored.length, Math.max(0, e.offset));
           bytesRead += got; entriesRead++;
           const buf = got === stored.length ? stored : stored.subarray(0, got);
-          if (e.flags & 1) {
-            const w = { path: e.path, offset: 0, compressedSize: buf.length, size: e.size, flags: 1 };
-            return readPkgEntry(buf, w);
-          }
-          return new Uint8Array(buf);
+          // ①(2026-10-04) 走 decodeStoredEntry：头解析的条目 flags 恒为 0（partial），
+          //   压缩条目必须靠 probeCompressedEntry 判（全量口径），否则会被当 raw 用 ⇒ 静默漏判。
+          return decodeStoredEntry(buf, e);
         } catch { return null; }
       };
       // ① 独立视频条目：只读它们（旧路径读了全部 TEX 也会丢弃这些结果）
@@ -2510,7 +2537,90 @@ function scanSceneVideo(dirOrPath, opts = {}) {
   return { video, source, cacheHit: false, indexEntries, entriesRead, bytesRead, tableBytes: source === 'pkg' ? undefined : 0, ms };
 }
 
-export { extractSceneMainImage, extractSceneMainImageFromDir, extractSceneManifest, extractSceneLayer, extractTexVideoMp4, collectSceneVideoFiles, parsePkg, readPkgEntry, parseTex, PKG_MAGIC_RE };
+/* ═══════════════════════════════════════════════════════════════════════════
+ * ①(2026-10-04) 「只判不取」的 scene 内嵌视频 verdict
+ *
+ * 动机（本机实测）：`ensureSceneVideo` 是"判定 + 提取"一体的 —— 探一次就把整段内嵌视频读进
+ * 内存并落盘（实测样例里 712 MB 的视频 = 712 MB 读盘），而客户端在**列表/卡片阶段**只问
+ * `{has, mime}`（`lib/client.js` 的 `sceneVideoCheckUrl` 只读 `d.has`）。本函数只做判定：
+ * **只读目录表 + 每条候选的前缀**（本机实测判定成本 ≈ 60 KB/包），绝不读视频载荷。
+ *
+ * 判定口径与 `scanSceneVideo` / legacy（`findSceneVideoInPkg`）**同源**：
+ *   · 有独立视频条目 ⇒ 恰好 1 条时可判定（取它）；≥2 条时"谁最大"要看解压后长度 ⇒ 交回慢路径；
+ *   · 否则看 TEX：逐条前缀判定（`probeTexVideoDecision`）——
+ *       ≥2 条判为 video ⇒ `has:false`（与 legacy "多 TEX 视频 ⇒ null" 一致）；
+ *       exactly 1 条 video 且无 unknown ⇒ `has:true`；0 条 video 且无 unknown ⇒ `has:false`；
+ *       出现 unknown（前缀不足/异常布局/压缩解释歧义）⇒ `decided:false`，调用方回退 `ensureSceneVideo`。
+ *   · **松散目录**（`scene.json` + 平铺 `.tex`）一律 `decided:false`：那种场景没有大载荷，不值得为它加一条分支。
+ *
+ * 返回 `{ has, ref, tex, decided, source, reason, indexEntries, bytesRead, ms }`。
+ * ⚠ 本函数**不写任何缓存**（判定结果由调用方决定是否复用；提取物缓存仍归 `ensureSceneVideo`）。
+ * ═══════════════════════════════════════════════════════════════════════════ */
+function probeSceneVideoVerdict(dirOrPath, opts = {}) {
+  const t0 = process.hrtime.bigint()
+  const done = (o) => Object.assign({ has: null, ref: null, tex: null, decided: false, source: 'pkg', reason: null, indexEntries: 0, bytesRead: 0, texPeeked: 0, ms: Number(process.hrtime.bigint() - t0) / 1e6 }, o)
+  let target = dirOrPath
+  try {
+    const st0 = statSync(dirOrPath)
+    if (st0.isDirectory()) {
+      const pkgPath = join(dirOrPath, 'scene.pkg')
+      if (!existsSync(pkgPath)) return done({ source: 'dir', reason: 'loose-dir' })
+      target = pkgPath
+    }
+  } catch (e) { return done({ source: 'unknown', reason: 'stat-failed' }) }
+  let idx = null
+  try { idx = readPkgIndexFromFile(target, opts) } catch (e) { return done({ reason: 'index-unreadable' }) }
+  const idxEntries = idx.entries
+  const sizeOf = (e) => (e.compressedSize == null ? e.size : e.compressedSize)
+  const base = { indexEntries: idxEntries.length, bytesRead: idx.headBytes, texPeeked: 0 }
+  const standalone = idxEntries.filter((e) => SCENE_VIDEO_EXT_RE.test(String(e.path || '').toLowerCase()) && sizeOf(e) > 0)
+  if (standalone.length === 1) return done(Object.assign({ has: true, ref: standalone[0].path, tex: false, decided: true }, base))
+  if (standalone.length > 1) return done(Object.assign({ reason: 'multi-standalone' }, base))
+  const texEntries = idxEntries.filter((e) => String(e.path || '').toLowerCase().endsWith('.tex'))
+  let bytesRead = idx.headBytes
+  let texPeeked = 0
+  const fd = openSync(target, 'r')
+  try {
+    let positives = 0, unknown = 0, firstPositive = null
+    for (const e of texEntries) {
+      const want = Math.min(sizeOf(e), TEX_PEEK_BYTES)
+      if (want <= 0) { unknown++; continue }
+      let head = null
+      try {
+        const buf = Buffer.allocUnsafe(want)
+        const got = readSync(fd, buf, 0, want, Math.max(0, e.offset))
+        bytesRead += got
+        if (got > 0) texPeeked++
+        head = got === want ? buf : buf.subarray(0, got)
+      } catch { head = null }
+      const decide = (bytes) => (bytes && bytes.length)
+        ? probeTexVideoDecision((off, len) => (off + len > bytes.length ? null : bytes.subarray(off, off + len)), bytes, e.path)
+        : 'unknown'
+      let decision = decide(head)
+      // 头解析的条目 `flags` 未知：可能是 LZ4 链条目 ⇒ 再按"压缩解释"试一次（成功且判出结论才采用）
+      if (decision === 'unknown') {
+        try {
+          const d = readPkgEntryHead(head, { path: e.path, offset: 0, compressedSize: head.length, size: e.size, flags: 1 }, TEX_PEEK_BYTES)
+          const d2 = decide(d)
+          if (d2 !== 'unknown') decision = d2
+        } catch { /* 不是压缩条目（或前缀不足）→ 保持 unknown */ }
+      }
+      if (decision === 'none') continue
+      if (decision === 'video') {
+        positives++
+        if (!firstPositive) firstPositive = e.path
+        if (positives >= 2) break
+      } else unknown++
+    }
+    const out = { indexEntries: idxEntries.length, bytesRead, texPeeked }
+    if (positives >= 2) return done(Object.assign({ has: false, decided: true }, out))
+    if (positives === 1 && unknown === 0) return done(Object.assign({ has: true, ref: firstPositive, tex: true, decided: true }, out))
+    if (positives === 0 && unknown === 0) return done(Object.assign({ has: false, decided: true }, out))
+    return done(Object.assign({ reason: 'unknown-tex-decision', positives, unknown }, out))
+  } finally { closeSync(fd) }
+}
+
+export { extractSceneMainImage, extractSceneMainImageFromDir, extractSceneManifest, extractSceneLayer, extractTexVideoMp4, collectSceneVideoFiles, parsePkg, readPkgEntry, parseTex, PKG_MAGIC_RE, probeSceneVideoVerdict, decodeStoredEntry };
 // ①(2026-09-15 音频扫描提速 / 2026-09-16 洁净室重写) 惰性音频索引：只读目录表 + 仅候选头 ≤16 字节。
 //   名字与结构依据 docs/AUDIO-TRACK-SPEC.md（后缀判定 / 容器判定 / 枚举核心里外三层）。
 export {

package/package.json

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