dsh-folia 4.16.1 → 4.17.0

package/lib/client.js

@@ -18955,10 +18955,40 @@ window.__ModuleLoader__.load({
 				 * 整区面板：这个页签的内容**整个**由功能自己的组件渲染（而不是 quick-panel 内的通用列表）。
 				 * 没登记的页签走 quick-panel 自己的通用布局（壁纸列表 / 外观节 / 播放节）。
 				 */
+				/**
+				 * 整区面板的**守卫包装**：任何一个页签在渲染期抛错，只让这一页显示错误信息，
+				 * 不许把整个面板带走。
+				 *
+				 * 实测故障：站点数据里出现一条字段形状异常的条目，渲染期抛错 ⇒ React 丢弃整棵树 ⇒
+				 * 整个「壁纸」窗口一片空白，用户只看到"界面消失了"，换版本也一样（故障在数据）。
+				 * 单卡错离在 quick-panel 里做；这里补"整页错离"，两层缺一就会重演那种空白。
+				 */
+				function guardTabPanel(name, Panel) {
+				  if (typeof Panel !== "function") return Panel;
+				  function GuardedTabPanel(props) {
+				    try {
+				      return Panel(props);
+				    } catch (e) {
+				      const why = (e && (e.message || String(e))) || "unknown";
+				      try { console.warn("[folia] 页签渲染失败：" + name, why); } catch { /* ignore */ }
+				      return React.createElement("div", {
+				        className: "we-picker",
+				        style: { padding: "12px", fontSize: "13px", lineHeight: 1.6, color: "#ff9a9a" },
+				      },
+				      React.createElement("div", null, weT("这一页加载失败：{name}", { name })),
+				      React.createElement("div", { style: { opacity: 0.8, marginTop: "4px", fontSize: "12px" } }, String(why).slice(0, 240)),
+				      React.createElement("div", { style: { opacity: 0.6, marginTop: "6px", fontSize: "12px" } },
+				        weT("其它页签仍可用；把这行原因发给作者即可定位。")));
+				    }
+				  }
+				  GuardedTabPanel.displayName = "Guarded(" + name + ")";
+				  return GuardedTabPanel;
+				}
+
 				const WE_FEATURE_PANELS = {
-				  boot: BootTabPanel,
-				  pets: PetsTabPanel,
-				  skins: SkinsTabPanel,
+				  boot: guardTabPanel("boot", BootTabPanel),
+				  pets: guardTabPanel("pets", PetsTabPanel),
+				  skins: guardTabPanel("skins", SkinsTabPanel),
 				};
 
 				/**
@@ -19316,6 +19346,63 @@ window.__ModuleLoader__.load({
 				    return shortSide > 0 && shortSide < 1280;
 				  }
 
+				  /**
+				   * 把一条清单数据**归一**成渲染层可以无条件相信的形状。
+				   *
+				   * 为什么在渲染前统一做，而不是每处判空：站点清单来自外部（154+ 条、每天都在变），
+				   * 字段形状出现一次意外（`tags` 是字符串、`preview` 是对象、`bytes` 是 "1.2 MB"）就会让
+				   * 卡片渲染期抛错。判空散落在十几个位置必然漏，归一只有一处。
+				   */
+				  function qpNormalizeItem(raw) {
+				    const w = (raw && typeof raw === "object") ? raw : {};
+				    const str = (v) => (typeof v === "string" && v ? v : null);
+				    const num = (v) => {
+				      const n = Number(v);
+				      return Number.isFinite(n) && n >= 0 ? n : 0;
+				    };
+				    let tags = w.tags;
+				    if (typeof tags === "string") tags = tags.split(/[,，\s]+/).filter(Boolean);
+				    if (!Array.isArray(tags)) tags = [];
+				    tags = tags.filter((t) => typeof t === "string");
+				    const type = str(w.type);
+				    return {
+				      ...w,
+				      id: (typeof w.id === "string" || typeof w.id === "number") ? w.id : String(w.id || ""),
+				      title: str(w.title) || String(w.id || ""),
+				      type: (type === "video" || type === "image" || type === "scene" || type === "package") ? type : "image",
+				      preview: str(w.preview),
+				      thumb: str(w.thumb),
+				      media: str(w.media),
+				      mediaProxy: str(w.mediaProxy),
+				      bytes: num(w.bytes),
+				      width: num(w.width),
+				      height: num(w.height),
+				      duration: num(w.duration),
+				      tags,
+				      rating: str(w.rating) || "unknown",
+				    };
+				  }
+
+				  /**
+				   * 渲染一张卡，**任何异常都只影响这一张**。
+				   * 失败时渲染一张"不可用"占位卡（带原因），而不是抛出把整棵树带走。
+				   */
+				  function qpRenderCardGuarded(raw, sel, cardsView) {
+				    const w = qpNormalizeItem(raw);
+				    try {
+				      return cardsView ? qpRenderCard(w, sel) : qpRenderRow(w, sel);
+				    } catch (e) {
+				      const why = (e && (e.message || String(e))) || "unknown";
+				      try { console.warn("[folia] 卡片渲染失败，已跳过：", w && w.id, why); } catch { /* ignore */ }
+				      return React.createElement("div", {
+				        key: "bad-" + String((w && w.id) || Math.random()),
+				        className: "we-qp__card we-qp__card--broken",
+				        title: why,
+				        style: { opacity: 0.5, padding: "8px", fontSize: "12px", lineHeight: 1.4 },
+				      }, weT("这条无法显示（数据异常）"), React.createElement("br"), String((w && w.id) || ""), " · ", why.slice(0, 80));
+				    }
+				  }
+
 				  function qpRenderCard(w, sel) {
 				    // ── 卡：缩略图网格形态（视图切换的「卡片」档；点击语义与列表行一致）──
 				    return React.createElement("div", {
@@ -19642,7 +19729,10 @@ window.__ModuleLoader__.load({
 				      rows.length
 				        ? React.createElement(React.Fragment, null,
 				            vTopH > 0 ? qpRenderSpacer("we-qp-vtop", vTopH) : null,
-				            rows.map(cardsView ? qpRenderCard : qpRenderRow),
+				            // **单卡错离**：一条数据坏掉只丢那一张卡，不许带走整片列表。
+				            // 实测故障：站点清单里出现字段形状异常（tags 非数组 / preview 非字符串 / media 缺失）后，
+				            // 卡片渲染期抛错 ⇒ React 丢弃整棵树 ⇒ 整个面板一片空白且没有任何提示。
+				            rows.map((w) => qpRenderCardGuarded(w, sel, cardsView)),
 				            vBtmH > 0 ? qpRenderSpacer("we-qp-vbtm", vBtmH) : null,
 				          )
 				        : React.createElement(React.Fragment, null,

package/lib/routes/downloads.js

@@ -15,18 +15,11 @@
  * 注入契约：`disposers` / `base` / `serveFile` / `log`（队列由本模块自建单例）。
  */
 import { createHash } from 'node:crypto';
-import { existsSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
 import { createDownloadQueue } from '../download-queue.js';
 export const DEPS = ['disposers', 'base', 'serveFile', 'log'];
 
-/**
- * 与 `lib/routes/site-media.js#EXT_OK` **必须一致**：那个模块按"扩展名在白名单里就保留、
- * 否则用 `.bin`"算缓存文件名。这里查缓存时必须用同一套规则，否则永远命不中（=重复下载）。
- */
-const SITE_MEDIA_EXT_OK = new Set(['.mp4', '.webm', '.mov', '.m4v', '.jpg', '.jpeg', '.png', '.webp', '.avif', '.gif']);
-
 /** 本地库与状态文件的位置（与其它路由同一口径：DSH_HOME 或桌面端的 harness 目录）。 */
 function dshHome() {
   return process.env.DSH_HOME || join(process.env.APPDATA || homedir(), 'dsh-desktop', 'harness');
@@ -46,44 +39,20 @@ function libraryDest(kind, slug, ext) {
 }
 
 /**
- * inventory 用：这条站点资源**是否已经落到本地**，以及怎么读它。
- *
- * 两个来源，都算"本地"，按代价从低到高：
- *   ① 下载队列落地（`<home>/library/<kind>/…`）⇒ `/folia/local-media/<id>`
- *   ② **site-media 缓存**（首次播放时边下边播留下的那份）⇒ 走已有的
- *      `/folia/site-media/<name>?u=…`，它命中缓存时直接 `serveFile`，**不触网**
- *
- * 为什么必须查②：站点壁纸第一次播放会经过 site-media 代理并落盘，如果这里只看①，
- * 同一份字节会被**再下载一遍**（21 MB 的包在弱网上就是"点了很久才出来"的主因），
- * 而且磁盘上存两份。
+ * inventory 用：这条站点资源**是否已经落到本地**，以及它的 job id。
+ * 命中 ⇒ inventory 把 `media` 指向 `/folia/local-media/<id>`（渲染只读本地）。
+ * 未命中 ⇒ 返回 null，调用方保持原来的远端/代理地址（用户点了会先入队下载）。
  */
 export function localCopyFor(url, kind = 'wallpaper') {
   try {
-    const raw = String(url);
-    const u = new URL(raw);
+    const u = new URL(String(url));
     const ext = (u.pathname.match(/\.([a-z0-9]{2,5})$/i) || [])[1] || 'bin';
     const slug = u.pathname.split('/').filter(Boolean).pop() || 'item';
     const dest = libraryDest(kind, slug, ext);
     const q = getDownloadQueue();
     const job = q.snapshot().find((j) => j.dest === dest);
-    if (job && job.status === 'done') {
-      return { id: job.id, url: `/folia/local-media/${job.id}`, bytes: job.total, source: 'library' };
-    }
-    // ② site-media 缓存：键算法必须与 lib/routes/site-media.js#keyFor **逐字一致**
-    //    （`sha256(url)[:32] + 规范化扩展名`），否则永远命不中。
-    const key = createHash('sha256').update(raw).digest('hex').slice(0, 32)
-      + (SITE_MEDIA_EXT_OK.has('.' + ext.toLowerCase()) ? '.' + ext.toLowerCase() : '.bin');
-    const cached = join(dshHome(), 'cache', 'site-media', key);
-    if (existsSync(cached)) {
-      const name = raw.split('/').pop() || 'media';
-      return {
-        id: key,
-        url: '/folia/site-media/' + encodeURIComponent(name) + '?u=' + encodeURIComponent(raw),
-        bytes: (() => { try { return statSync(cached).size; } catch { return 0; } })(),
-        source: 'site-media-cache',
-      };
-    }
-    return null;
+    if (!job || job.status !== 'done') return null;
+    return { id: job.id, url: `/folia/local-media/${job.id}`, bytes: job.total };
   } catch { return null; }
 }
 

package/package.json

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