dsh-folia 4.16.2 → 4.17.1

package/lib/client.js

@@ -18314,6 +18314,13 @@ window.__ModuleLoader__.load({
 				  const busyRef = React.useRef("");
 				  const [note, setNote] = React.useState(null);
 
+				  // ⚠️ 这两面旗必须**在函数体最前面**算出来：下面「刷新」按钮的文案就要用它。
+				  // 曾把它们写在列表渲染处（更靠后）⇒ 首次渲染读到 TDZ 里的 const
+				  // ⇒ `Cannot access 'busyIsStructural' before initialization` ⇒ 整页被守卫接住变红。
+				  // 教训：渲染函数里任何"靠后声明的 const"都可能被靠前的 JSX 读到，声明一律前置。
+				  const busyIsStructural = /^(install|remove|repair):/.test(String(busy || ""));
+				  const busyIsActivating = /^activate:/.test(String(busy || ""));
+
 				  const load = React.useCallback(async (force) => {
 				    try {
 				      const resp = await apiJson("/skins/list" + (force ? "?refresh=1" : ""), { parse: "always" });
@@ -18573,8 +18580,7 @@ window.__ModuleLoader__.load({
 				  // 所以把 busy 拆成两条互不相干的通道：
 				  //   · 结构操作（install / remove / repair）：改动磁盘目录，串行，期间只锁**结构按钮**
 				  //   · 切换（activate）：只写 active，幂等且"最后动作优先"，期间只锁**该卡片的「应用」**
-				  const busyIsStructural = /^(install|remove|repair):/.test(String(busy || ""));
-				  const busyIsActivating = /^activate:/.test(String(busy || ""));
+				  // （这两面旗已上移到函数开头声明 —— 上面的「刷新」按钮文案要用到它们，写在这里会触发 TDZ。）
 
 				  const installed = (state && state.installed) || [];
 				  const activeId = (state && state.active) || "";
@@ -18955,10 +18961,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 +19352,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 +19735,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/package.json

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