dsh-folia 4.0.2 → 4.0.4

package/lib/routes/boot.js

@@ -9,7 +9,7 @@
  * 播放走 `/folia/boot/clip`，**支持 Range**：注入的 `<video>` 与浏览器都靠它边下边播。
  * 这也是为什么片段必须先落盘 —— 启动路径上不能有网络。
  */
-import { createReadStream, existsSync, statSync, writeFileSync } from 'node:fs';
+import { createReadStream, existsSync, readFileSync, statSync, writeFileSync } from 'node:fs';
 import { join } from 'node:path';
 import { sendJson } from '../json-response.js';
 import { bodyReader } from '../http-body.js';
@@ -112,6 +112,28 @@ async function fetchClipBytes(url, chunks = 4) {
   }
 }
 
+/**
+ * 判定一段字节是不是**真的视频**，并给出它的 MIME。
+ *
+ * 为什么必须验文件头而不是 content-type：站点对未知路径会回退 index.html 并以 200 返回，
+ * 这种"伪视频"存成 .mp4 的结果是**每次开机黑屏**。
+ *
+ * 认两种容器（覆盖站点上实际会有的上传）：
+ *   MP4/MOV  ISO BMFF —— 偏移 4..8 是 `ftyp`
+ *   WebM     EBML    —— 开头 4 字节是 1A 45 DF A3
+ */
+export function sniffVideo(buf) {
+  if (!buf || buf.length < 1024) return null;
+  if (buf.length >= 12 && buf.toString('latin1', 4, 8) === 'ftyp') {
+    const brand = buf.toString('latin1', 8, 12);
+    return { mime: 'video/mp4', ext: '.mp4', container: 'mp4', brand };
+  }
+  if (buf.length >= 4 && buf[0] === 0x1a && buf[1] === 0x45 && buf[2] === 0xdf && buf[3] === 0xa3) {
+    return { mime: 'video/webm', ext: '.webm', container: 'webm', brand: null };
+  }
+  return null;
+}
+
 /** 读请求体里的 `{ id }`。 */
 async function readIdBody(req) {
   try {
@@ -269,9 +291,10 @@ export function registerBootRoutes(webServer, c) {
         const buf = await fetchClipBytes(item.url, 4);
         const ct = 'video/mp4';   // 并行分段之后没有单一响应头可读，类型下面用 ftyp 验
         // 站点把未知路径回落到 HTML —— 这类"伪 200"绝不能当成视频存下来（否则每次开机黑屏）。
-        // 只认文件头：`ftyp` 在偏移 4。比 content-type 更可靠（站点回退页是 HTML，
-        // 而并行分段之后我们也拿不到单一响应头）。
-        if (buf.length < 1024 || buf.toString('latin1', 4, 8) !== 'ftyp') {
+        // 只认文件头（mp4 的 ftyp / webm 的 EBML）。比 content-type 可靠，
+        // 而且并行分段之后本来也拿不到单一响应头。
+        const sniff = sniffVideo(buf);
+        if (!sniff) {
           sendJson(res, 422, { ok: false, error: 'not-a-video', detail: ct || 'no content-type' });
           return;
         }
@@ -280,6 +303,7 @@ export function registerBootRoutes(webServer, c) {
         try {
           writeFileSync(clipMetaFile(id), JSON.stringify({
             id,
+            mime: sniff.mime,
             title: item.title, durationSec: item.durationSec, bytes: buf.length, sha256: item.sha256 || null,
           }, null, 2) + '\n');
         } catch { /* meta 只是锦上添花 */ }
@@ -369,7 +393,12 @@ export function registerBootRoutes(webServer, c) {
       if (!file || !existsSync(file)) { res.statusCode = 404; res.end('no clip'); return; }
       const size = statSync(file).size;
       const range = String((req.headers && req.headers.range) || '');
-      const type = 'video/mp4';
+      // MIME 取自下载时记下的 meta：webm 用 video/webm，否则 video/mp4。
+      let type = 'video/mp4';
+      try {
+        const meta = JSON.parse(readFileSync(clipMetaFile(boot.clipId), 'utf8'));
+        if (meta && typeof meta.mime === 'string' && /^video\//.test(meta.mime)) type = meta.mime;
+      } catch { /* 没 meta 就按 mp4 */ }
       // Range：`bytes=start-end` —— Chromium 播放本地大文件时会先发一小段探测请求。
       const m = /^bytes=(\d*)-(\d*)$/.exec(range.trim());
       if (m) {

package/lib/routes/inventory.js

@@ -258,7 +258,9 @@ function foliaItemFromCatalog(it, base) {
   // 预览优先级：**站点自己给的 preview 最高**（省掉宿主这一跳，也最省流量）；
   // 站点没给才退回宿主缩略图代理。只有预览走小图，`media` 永远是原图 ——
   // 应用壁纸用的是 `media`，所以画质不受影响。
-  const sitePreview = foliaAbs(base, it && (it.preview || it.poster)) || null;
+  // 站点后台已经自动生成缩略图（thumbUrl，webp 小图），优先用它 ——
+  // 比宿主自己 ffmpeg 生成更快（少一跳），也比你手传更省事。
+  const sitePreview = foliaAbs(base, it && (it.thumbUrl || it.preview || it.poster)) || null;
   const thumb = sitePreview ? null : (type === 'image' ? '/folia/site-thumb?u=' + encodeURIComponent(media) : null);
   const extHit = String(media).match(/\.([a-z0-9]{2,5})(?:[?#]|$)/i);
   const num = (v) => (Number.isFinite(Number(v)) && Number(v) > 0 ? Number(v) : undefined);

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "dsh-folia",
-    "version":  "4.0.2",
+    "version":  "4.0.4",
     "description":  "Folia 壁纸引擎：把本机 Wallpaper Engine 壁纸搬进 DSH 界面（场景实时渲染 / 视频 / 网页），内置液态玻璃与 Folia 吉祥物，并可从自建站点拉取壁纸。单包形态（组件已合并）。",
     "type":  "module",
     "engines":  {