dsh-folia 4.14.0 → 4.14.3

package/lib/client.js

@@ -18309,6 +18309,9 @@ window.__ModuleLoader__.load({
 				function SkinsTabPanel() {
 				  const [state, setState] = React.useState(null);
 				  const [busy, setBusy] = React.useState("");
+				  // 给"静默对账"用的只读镜像：定时器/可见性回调里不能读闭包里的旧 `busy`（会一直看到 ""），
+				  // 用一个 ref 跟住最新值，操作进行中就不打扰用户。
+				  const busyRef = React.useRef("");
 				  const [note, setNote] = React.useState(null);
 
 				  const load = React.useCallback(async (force) => {
@@ -18356,11 +18359,33 @@ window.__ModuleLoader__.load({
 
 				  React.useEffect(() => { load(false); }, [load]);
 
+				  // 与外部改动**保持同步**：皮肤可能在皮肤中心那边被删/装，也可能在另一个窗口里操作。
+				  // 之前只在挂载时拉一次 ⇒ 那边删了，这边还列着（点了才失败，看起来像"没同步"）。
+				  // 三条腿都只做"重拉一次列表"，不做别的：
+				  //   ① 页签重新可见（switch 回来）② 窗口重新获得焦点 ③ 每 20 秒的轻量对账
+				  // 轻量对账只在**没有正在进行的操作**时跑，避免把用户刚点的"安装中…"状态冲掉。
+				  React.useEffect(() => {
+				    if (typeof document === "undefined" || typeof window === "undefined") return undefined;
+				    let timer = null;
+				    const refreshQuietly = () => { try { if (!busyRef.current) load(false); } catch { /* ignore */ } };
+				    const onVisible = () => { try { if (document.visibilityState === "visible") refreshQuietly(); } catch { /* ignore */ } };
+				    try { document.addEventListener("visibilitychange", onVisible); } catch { /* ignore */ }
+				    try { window.addEventListener("focus", refreshQuietly); } catch { /* ignore */ }
+				    try { timer = window.setInterval(refreshQuietly, 20000); } catch { timer = null; }
+				    return () => {
+				      try { document.removeEventListener("visibilitychange", onVisible); } catch { /* ignore */ }
+				      try { window.removeEventListener("focus", refreshQuietly); } catch { /* ignore */ }
+				      if (timer !== null) { try { window.clearInterval(timer); } catch { /* ignore */ } }
+				    };
+				  }, [load]);
+
 				  const act = async (kind, payload, label) => {
 				    // 结构性操作才锁整块 UI；`activate` 是幂等的、而且要让人能连点换皮肤，所以不锁。
 				    const structural = kind === "install" || kind === "remove";
-				    if (structural) setBusy(kind + ":" + ((payload && payload.id) || ""));
-				    if (kind === "activate") setBusy("activate:" + ((payload && payload.id) || ""));
+				    const busyKey = structural
+				      ? kind + ":" + ((payload && payload.id) || "")
+				      : (kind === "activate" ? "activate:" + ((payload && payload.id) || "") : "");
+				    if (busyKey) { setBusy(busyKey); busyRef.current = busyKey; }
 				    setNote(null);
 				    try {
 				      if (kind === "activate") {
@@ -18454,6 +18479,7 @@ window.__ModuleLoader__.load({
 				      setNote({ ok: false, text: weT("请求失败：{msg}", { msg: (e && e.message) || weT("网络错误") }) });
 				    } finally {
 				      setBusy("");
+				      busyRef.current = "";
 				    }
 				  };
 
@@ -18569,6 +18595,15 @@ window.__ModuleLoader__.load({
 				        : installed.map((s) => {
 				          const isActive = isActiveSkin(s.id);
 				          const busyThis = busy === "activate:" + s.id;
+				          // 皮肤中心**没收录**这套（它有自己的 manifest 规则）⇒ 应用后它会回退到内置默认款，
+				          // 用户看到的是"点哪套都不变"。这是实测症状（别人机器上"只剩鲸鱼娘"），所以这里
+				          // 直接把原因与「应用」的禁用一起给出来，而不是让人一遍遍点。
+				          // ⚠️ 只有 `=== false` 才下结论：`null` 表示"问不到它的 catalog"（未知），
+				          // 未知绝不能禁用按钮 —— 那会变成"替我猜错了就不让我点"。
+				          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 +18611,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 +18620,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,12 +139,66 @@ 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;
 
-async function fetchSiteSkins(force) {
-  const now = Date.now();
+/**
+ * 给"本机已装"逐条附上**皮肤中心是否收录**。
+ *
+ * 比对口径要宽：它的 catalog 以 `manifest.id` 为键，而我们的条目同时有 `id`（manifest）与
+ * `dirId`（目录名），且历史上站点 slug 可能带 `skin-` 前缀 ⇒ 三种形态都试，任一命中即算收录。
+ * `catalog === null`（问不到）时给 `null`：**未知不等于未收录**，界面不能据此禁用「应用」。
+ */
+function annotateCatalog(installed, catalog) {
+  if (!catalog) return installed.map((s) => ({ ...s, inCatalog: null, catalogWarnings: [] }));
+  return installed.map((s) => {
+    const hit = catalog.has(s.id) ? s.id
+      : catalog.has(s.dirId) ? s.dirId
+        : catalog.has(normSkinId(s.id)) ? normSkinId(s.id) : null;
+    return { ...s, inCatalog: Boolean(hit), catalogWarnings: hit ? catalog.get(hit) : [] };
+  });
+}
+
+async function fetchSiteSkins(force) {  const now = Date.now();
   if (!force && siteCache.at && now - siteCache.at < SITE_TTL_MS) return siteCache;
   const base = siteBase();
   if (!base) { siteCache.at = now; siteCache.items = []; siteCache.error = 'site-off'; return siteCache; }
@@ -342,8 +396,23 @@ 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"（实测症状）。
+      //
+      // ⚠️ 但"它没列出"**不能**只凭一次缓存就下定论：刚装完皮肤时，它自己的 catalog 可能还没
+      // 重扫（它按目录 mtime 做缓存），我们 30 秒的副本更可能比它更旧。实测：别人机器上刚装完
+      // 就被标成「皮肤中心未收录」，而打开它的设置页却是有的 —— 一次假红。
+      // 所以对账分两拍：先按缓存比，**出现"未收录"就强制重拉一次**再定论。
+      const hostHeader = req.headers && req.headers.host;
+      let catalog = skinCenter === 'present' ? await fetchSkinCenterCatalog(hostHeader, force) : null;
+      let installed = annotateCatalog(installedBase, catalog);
+      if (catalog && installed.some((s) => s.inCatalog === false)) {
+        catalog = await fetchSkinCenterCatalog(hostHeader, true);
+        installed = annotateCatalog(installedBase, catalog);
+      }
       // ⚠️ 站点 slug 与本机皮肤 id **不总是同一个字符串**：站点上 slug 是全站唯一的，
       // 撞名时上传工具会加 `skin-` 前缀（实测 blue-throated-bee-eater 同时是桌宠 id）。
       // 所以比对要归一：两边都去掉可选的 `skin-` 前缀再比，否则会显示成"未安装"。
@@ -475,11 +544,24 @@ export function registerSkinsRoutes(webServer, c) {
       const dir = resolveInside(root, id);
       if (!dir) { sendJson(res, 400, { ok: false, error: 'unsafe-id' }); return; }
       if (!existsSync(dir)) { sendJson(res, 404, { ok: false, error: 'not-installed' }); return; }
+      // 删之前先看它是不是"当前正在用的那套"：如果是，必须**先把选择清掉**再删目录，
+      // 否则 active 指向一个不存在的 id ⇒ 皮肤中心回退到内置默认款，用户看到的是
+      // "皮肤没换成我选的那套"（实测症状）。清空走同一套兜底链路（HTTP→状态文件）。
+      let clearedActive = false;
+      try {
+        const statePath = activeStatePath();
+        let cur = null;
+        try { cur = (JSON.parse(readFileSync(statePath, 'utf8')) || {}).active || null; } catch { cur = null; }
+        if (cur && (cur === id || normSkinId(cur) === normSkinId(id))) {
+          writeActiveStateFile(null);
+          clearedActive = true;
+        }
+      } catch { /* 清不掉也不阻塞删除：目录照删，只是 active 可能悬空（页签会显示"恢复默认外观"） */ }
       try { rmSync(dir, { recursive: true, force: true }); } catch (e) {
         sendJson(res, 500, { ok: false, error: 'remove-failed', detail: String(e && e.message).slice(0, 160) });
         return;
       }
-      sendJson(res, 200, { ok: true, id });
+      sendJson(res, 200, { ok: true, id, clearedActive });
     },
   }));
 

package/package.json

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