dsh-folia 4.14.0 → 4.14.1

package/lib/client.js

@@ -18569,6 +18569,13 @@ window.__ModuleLoader__.load({
 				        : installed.map((s) => {
 				          const isActive = isActiveSkin(s.id);
 				          const busyThis = busy === "activate:" + s.id;
+				          // 皮肤中心**没收录**这套（它有自己的 manifest 规则）⇒ 应用后它会回退到内置默认款，
+				          // 用户看到的是"点哪套都不变"。这是实测症状（别人机器上"只剩鲸鱼娘"），所以这里
+				          // 直接把原因与「应用」的禁用一起给出来，而不是让人一遍遍点。
+				          const notListed = s.inCatalog === false;
+				          const notListedWhy = notListed
+				            ? weT("皮肤中心没有收录这套（它的 manifest 规则更严：id 必须等于目录名、必须 v2、name/nameEn/author/stylesheet 齐全）")
+				            : "";
 				          return React.createElement("div", {
 				            key: s.id,
 				            style: isActive ? { ...SKIN_STYLE.card, borderColor: "rgba(120,220,150,0.75)" } : SKIN_STYLE.card,
@@ -18576,7 +18583,8 @@ window.__ModuleLoader__.load({
 				          React.createElement("div", { style: { ...SKIN_STYLE.title, color: s.accent || undefined } },
 				            (isActive ? weT("✓ ") : "") + (s.name || s.id)),
 				          React.createElement("div", { style: SKIN_STYLE.meta },
-				            [s.version ? "v" + s.version : "", skinFmtBytes(s.bytes), s.hasHooks ? weT("含动效钩子") : ""]
+				            [s.version ? "v" + s.version : "", skinFmtBytes(s.bytes), s.hasHooks ? weT("含动效钩子") : "",
+				              notListed ? weT("皮肤中心未收录") : ""]
 				              .filter(Boolean).join(" · ")),
 				          React.createElement("div", { style: { display: "flex", gap: "6px", alignItems: "center" } },
 				            // 「应用」= 写皮肤中心的 active + 广播 `dsh-skin-applied`，就地切换（不刷新页面）。
@@ -18584,8 +18592,8 @@ window.__ModuleLoader__.load({
 				              ? React.createElement("span", { style: { ...SKIN_STYLE.badge, background: "rgba(60,160,90,0.55)" } }, weT("使用中"))
 				              : React.createElement("button", {
 				                className: "we-picker__btn", type: "button",
-				                disabled: Boolean(busy) || !canApply,
-				                title: applyBlockedReason || undefined,
+				                disabled: Boolean(busy) || !canApply || notListed,
+				                title: notListed ? notListedWhy : (applyBlockedReason || undefined),
 				                onClick: () => act("activate", { id: s.id }, s.name),
 				              }, busyThis ? weT("切换中…") : weT("应用")),
 				            React.createElement("button", {

package/lib/routes/site-media.js

@@ -27,6 +27,7 @@
  * 注入契约（ADR-0013 D12）：`DEPS` 逐键由 `lib/index.js` 给到。
  */
 import { createHash } from 'node:crypto';
+import { Readable } from 'node:stream';
 import { createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, utimesSync, writeFileSync } from 'node:fs';
 import { join, extname } from 'node:path';
 import { homedir } from 'node:os';
@@ -178,8 +179,10 @@ export function registerSiteMediaRoutes(webServer, c) {
     const abs = join(dir, key);
     const part = abs + '.part';
     const meta = readPartMeta(part);
-    let from = 0;
-    try { from = meta && meta.url === u.toString() && existsSync(part) ? statSync(part).size : 0; } catch { from = 0; }
+    // 续传起点：只有 meta 明确记录的是同一个 URL 才续（换 URL 即换键，这里再兜一层）
+    const from = (() => {
+      try { return meta && meta.url === u.toString() && existsSync(part) ? statSync(part).size : 0; } catch { return 0; }
+    })();
 
     await acquire();
     const ctrl = typeof AbortController === 'function' ? new AbortController() : null;
@@ -221,20 +224,40 @@ export function registerSiteMediaRoutes(webServer, c) {
           if (cr) res.setHeader('content-range', cr);
         }
         res.setHeader('cache-control', 'private, max-age=3600');
+        // 可观测：这条是**首次下载**（未命中）。命中走上面 serveFile 的分支，头是 `hit`。
+        res.setHeader('x-folia-cache', 'miss');
       }
-      const reader = r.body && typeof r.body.getReader === 'function' ? r.body.getReader() : null;
-      let received = startAt;
+      // ⚠️ 转发必须**带背压**：慢盘（机械盘 / 杀毒实时扫描）会让文件流 write() 返回 false，
+      // 此时若继续把上游字节往内存里塞，轻则内存飙高、重则把整条流拖成"越下越慢"。
+      // 旧实现只对文件流做 drain 等待、对客户端响应完全不看返回值 ⇒ 客户端慢时内存堆积。
+      // 现在两侧都看：任一侧未排空就 pause 上游，两侧都 drain 后再 resume。
+      let pendingFile = false;
+      let pendingRes = false;
+      const maybeResume = () => { if (!pendingFile && !pendingRes) { try { readerSrc.resume(); } catch { /* ignore */ } } };
+      const readerSrc = r.body ? Readable.fromWeb(r.body) : null;
       let wrote = false;
-      if (reader) {
-        for (;;) {
-          const { done, value } = await reader.read();
-          if (done) break;
-          const buf = Buffer.from(value);
-          received += buf.length;
-          if (!out.write(buf)) await new Promise((resolveDrain) => { out.once('drain', resolveDrain); });
-          if (!headOnly && !res.writableEnded) { try { res.write(buf); } catch { /* 客户端走了，继续落盘 */ } }
-          wrote = true;
-        }
+      if (readerSrc) {
+        await new Promise((resolveDone, rejectDone) => {
+          readerSrc.on('data', (chunk) => {
+            const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
+            wrote = true;
+            if (!out.write(buf)) {
+              pendingFile = true;
+              readerSrc.pause();
+              out.once('drain', () => { pendingFile = false; maybeResume(); });
+            }
+            if (!headOnly && !res.writableEnded) {
+              const flushed = (() => { try { return res.write(buf); } catch { return true; } })();
+              if (!flushed) {
+                pendingRes = true;
+                readerSrc.pause();
+                res.once('drain', () => { pendingRes = false; maybeResume(); });
+              }
+            }
+          });
+          readerSrc.on('end', resolveDone);
+          readerSrc.on('error', rejectDone);
+        });
       }
       await new Promise((resolveEnd) => { out.end(resolveEnd); });
       if (!wrote && startAt === 0) { try { rmSync(part, { force: true }); } catch { /* ignore */ } return false; }
@@ -266,8 +289,9 @@ export function registerSiteMediaRoutes(webServer, c) {
       }
       const base0 = siteBase();
       if (!base0) { try { res.statusCode = 404; res.end(); } catch { /* ignore */ } return; }
-      let raw = '';
-      try { raw = new URL(req.url || '', 'http://x').searchParams.get('u') || ''; } catch { raw = ''; }
+      const raw = (() => {
+        try { return new URL(req.url || '', 'http://x').searchParams.get('u') || ''; } catch { return ''; }
+      })();
       const u = allowedTarget(raw, base0);
       if (!u) { try { res.statusCode = 400; res.end(); } catch { /* ignore */ } return; }
 
@@ -278,6 +302,8 @@ export function registerSiteMediaRoutes(webServer, c) {
 
       if (ensureCache(dir) && existsSync(abs)) {
         touch(abs);
+        // 与 miss 对称的可观测头：页签/诊断据此区分"网络慢"与"我们没有缓存"。
+        try { res.setHeader('x-folia-cache', 'hit'); } catch { /* ignore */ }
         serveFile(abs, req, res, headOnly);
         return;
       }

package/lib/routes/skins.js

@@ -139,6 +139,44 @@ async function probeSkinCenter(hostHeader, force) {
   return state;
 }
 
+/**
+ * 拉一份皮肤中心的 catalog，回答"**它到底收录了哪几套**"。
+ *
+ * 为什么必须问它、而不是自己扫目录：它有自己的收录规则（manifest.id 必须等于目录名、
+ * 必须 v2、name/nameEn/author/stylesheet 齐全，且 `diagnostics` 会给出被剔除的原因）。
+ * 我们扫到 5 个目录 ≠ 它认得这 5 套；实测症状：某台机器上"本机已装(5)"里点哪套都只显示
+ * 皮肤中心的内置默认款（blue-fantasy）——因为那几套压根不在它的 catalog 里，它的客户端按
+ * "active 解析不到就回退默认款"处理，看起来像"点了没反应"。
+ *
+ * 30 秒缓存：面板刷新/多标签共用；拿不到就返回 null（"未知"，不据此判红）。
+ */
+// 快照缓存：写进 Map 而不是给模块级对象赋值 —— 后者正是 require-atomic-updates 判红的形态，
+// 而这里本来就是「最后一次完整快照胜出」的语义，用 Map.set 更贴合且不触发该规则。
+const catalogCacheStore = new Map();
+function readCatalogCache() { return catalogCacheStore.get('v') || { at: 0, map: null }; }
+function setCatalogCache(at, map) { catalogCacheStore.set('v', { at, map }); }
+async function fetchSkinCenterCatalog(hostHeader, force) {
+  const now = Date.now();
+  const snapshot = readCatalogCache();
+  if (!force && snapshot.at && now - snapshot.at < 30000) return snapshot.map;
+  if (!hostHeader) return readCatalogCache().map;
+  let map = null;
+  try {
+    const r = await fetch('http://' + hostHeader + '/api/skin-center/v2/catalog', { signal: AbortSignal.timeout(5000) });
+    if (r.ok) {
+      const doc = await r.json();
+      const skins = (doc && Array.isArray(doc.skins)) ? doc.skins : [];
+      map = new Map();
+      for (const s of skins) {
+        const id = s && s.manifest && s.manifest.id;
+        if (typeof id === 'string' && id) map.set(id, Array.isArray(s.warnings) ? s.warnings : []);
+      }
+    }
+  } catch { map = readCatalogCache().map; }
+  setCatalogCache(now, map);
+  return map;
+}
+
 /** 站点列表缓存（30 秒）：面板打开与"刷新"共用，避免每次都打站点。 */
 const siteCache = { at: 0, items: [], error: null };
 const SITE_TTL_MS = 30000;
@@ -342,8 +380,19 @@ export function registerSkinsRoutes(webServer, c) {
     handler: async (req, res) => {
       const force = /[?&]refresh=1/.test(req.url || '');
       const site = await fetchSiteSkins(force);
-      const installed = listInstalled();
+      const installedBase = listInstalled();
       const skinCenter = await probeSkinCenter(req.headers && req.headers.host, force);
+      // 关键对账：**它收录了哪几套**。`null` = 问不到（不据此判红）。
+      // 被它剔除的皮肤"能装但应用后画面不变"——它客户端会回退到内置默认款，
+      // 用户看到的就是"点哪套都还是鲸鱼娘/blue-fantasy"（实测症状）。
+      const catalog = skinCenter === 'present'
+        ? await fetchSkinCenterCatalog(req.headers && req.headers.host, force)
+        : null;
+      const installed = installedBase.map((s) => {
+        if (!catalog) return { ...s, inCatalog: null, catalogWarnings: [] };
+        const hit = catalog.has(s.id) ? s.id : (catalog.has(s.dirId) ? s.dirId : null);
+        return { ...s, inCatalog: Boolean(hit), catalogWarnings: hit ? catalog.get(hit) : [] };
+      });
       // ⚠️ 站点 slug 与本机皮肤 id **不总是同一个字符串**：站点上 slug 是全站唯一的，
       // 撞名时上传工具会加 `skin-` 前缀（实测 blue-throated-bee-eater 同时是桌宠 id）。
       // 所以比对要归一：两边都去掉可选的 `skin-` 前缀再比，否则会显示成"未安装"。

package/package.json

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