dsh-folia 4.15.1 → 4.15.3

package/lib/client.js

@@ -18653,6 +18653,17 @@ window.__ModuleLoader__.load({
 				            [s.version ? "v" + s.version : "", skinFmtBytes(s.bytes), s.hasHooks ? weT("含动效钩子") : "",
 				              notListed ? weT("皮肤中心未收录") : ""]
 				              .filter(Boolean).join(" · ")),
+				          // 未收录时把**原因直接印在卡片上**（不只放在 title 里）：实测用户看不到悬浮提示，
+				          // 只能看到一句"未收录"，于是只能来问"为什么"。
+				          notListed
+				            ? React.createElement("div", {
+				              style: { fontSize: "11px", lineHeight: "1.5", color: "#ffd08a", opacity: 0.95, margin: "2px 0 4px" },
+				            }, weT("原因：{why}", {
+				              why: (Array.isArray(s.catalogWarnings) && s.catalogWarnings.length)
+				                ? s.catalogWarnings.slice(0, 2).join("；")
+				                : weT("皮肤中心没有给出原因（常见于它还没重扫，或它的用户皮肤目录与我们的不同）"),
+				            }))
+				            : null,
 				          React.createElement("div", { style: { display: "flex", gap: "6px", alignItems: "center" } },
 				            // 「应用」= 写皮肤中心的 active + 广播 `dsh-skin-applied`，就地切换（不刷新页面）。
 				            isActive

package/lib/routes/site-media.js

@@ -276,6 +276,47 @@ export function registerSiteMediaRoutes(webServer, c) {
     }
   }
 
+  // ── 计数与统计：别的机器"慢"到底慢在哪，必须有可读的数字，而不是靠感觉 ──────────
+  // hits/misses 区分"没缓存所以每次都要下"与"缓存生效但网络慢"；
+  // bytes/ms 给出每次都真实吞吐；writable 说明那台机器的缓存目录到底能不能写。
+  const stats = { hits: 0, misses: 0, bytes: 0, ms: 0, failures: 0, since: Date.now() };
+
+  disposers.push(webServer.register({
+    kind: 'exact',
+    path: `${BASE}/site-media-stats`,
+    handler: (req, res) => {
+      let total = 0;
+      let files = 0;
+      try {
+        const dir = cacheRoot();
+        for (const name of readdirSync(dir)) {
+          if (name.endsWith('.part') || name.endsWith('.part.json')) continue;
+          try { total += statSync(join(dir, name)).size; files += 1; } catch { /* ignore */ }
+        }
+      } catch { /* 目录不存在即 0 */ }
+      const dirRoot = cacheRoot();
+      const body = JSON.stringify({
+        ok: true,
+        root: dirRoot,
+        writable: ensureCache(dirRoot),
+        files,
+        bytesOnDisk: total,
+        capBytes: capBytes(),
+        hits: stats.hits,
+        misses: stats.misses,
+        failures: stats.failures,
+        avgMBps: stats.ms > 0 ? Number(((stats.bytes / 1048576) / (stats.ms / 1000)).toFixed(2)) : null,
+        uptimeSec: Math.round((Date.now() - stats.since) / 1000),
+      });
+      try {
+        res.statusCode = 200;
+        res.setHeader('content-type', 'application/json; charset=utf-8');
+        res.setHeader('cache-control', 'no-store');
+        res.end(body);
+      } catch { /* ignore */ }
+    },
+  }));
+
   disposers.push(webServer.register({
     kind: 'prefix',
     // 路径尾部只是给客户端留一个"像文件名"的段（客户端按 `url.split('/').pop()` 取 token 做
@@ -301,6 +342,7 @@ export function registerSiteMediaRoutes(webServer, c) {
       const abs = join(dir, key);
 
       if (ensureCache(dir) && existsSync(abs)) {
+        stats.hits += 1;
         touch(abs);
         // 与 miss 对称的可观测头：页签/诊断据此区分"网络慢"与"我们没有缓存"。
         try { res.setHeader('x-folia-cache', 'hit'); } catch { /* ignore */ }
@@ -317,7 +359,13 @@ export function registerSiteMediaRoutes(webServer, c) {
         redirect(res, u);
         return;
       }
-      const task = download(u, key, req, res, headOnly);
+      stats.misses += 1;
+      const t0 = Date.now();
+      const task = download(u, key, req, res, headOnly).then((ok) => {
+        stats.ms += Date.now() - t0;
+        if (ok) { try { stats.bytes += statSync(abs).size; } catch { /* ignore */ } }
+        return ok;
+      }).catch((e) => { stats.failures += 1; throw e; });
       inflight.set(key, task);
       let ok = false;
       try { ok = await task; } finally { inflight.delete(key); }

package/lib/routes/skins.js

@@ -39,8 +39,44 @@ const SKIP_EXEC_RE = /\.(exe|dll|bat|cmd|com|scr|ps1|sh|msi|vbs|wsf|hta|lnk|jar)
 function dshHome() {
   return process.env.DSH_HOME || join(process.env.APPDATA || homedir(), 'dsh-desktop', 'harness');
 }
-/** 皮肤根：与皮肤中心同一个目录（它读 `$DSH_HOME/skins`）。 */
-function skinsRoot() { return join(dshHome(), 'skins'); }
+/** 皮肤根：**皮肤中心真正在用的那个目录**下的 `skins`（见 skinCenterHome 的发现逻辑）。 */
+function skinsRoot() { return join(skinCenterHome().root, 'skins'); }
+
+/**
+ * **发现皮肤中心真正在用的那个数据目录**（而不是假定它就是我们的 `$DSH_HOME`）。
+ *
+ * 为什么必须发现：皮肤中心解析用户皮肤目录走的是它自己的 `resolveHarnessPaths()` ——
+ * 优先 `$DSH_HOME`，其次安装布局，**最后才是 `~/.dsh`**；而我们这边用的是
+ * `$DSH_HOME || %APPDATA%/dsh-desktop/harness`。两者在"便携安装 / 没设 DSH_HOME"的机器上
+ * 会指向**不同目录**：我们把皮肤装进 harness/skins，它却去 `~/.dsh/skins` 找 ⇒ 它列表里
+ * 只剩内置那一套，用户点哪套都无效（实测症状：只剩鲸鱼娘/blue-fantasy）。
+ *
+ * 判据不看猜：**它自己会把 `skin-center-active.json` 写在 `<它的用户皮肤目录>/..`**，
+ * 所以"哪个候选目录里存在这个文件、且最近被写过"，那个就是它在用的目录。
+ * 拿不到任何线索时退回我们自己的目录（也就是今天的行为，不会更差）。
+ */
+const homeCache = { at: 0, value: null };
+function skinCenterHome(force) {
+  const now = Date.now();
+  if (!force && homeCache.value && now - homeCache.at < 30000) return homeCache.value;
+  const candidates = [];
+  const push = (root) => { if (root) candidates.push(root); };
+  push(dshHome());
+  push(join(homedir(), '.dsh'));
+  if (process.env.DSH_SKINS_DIR) push(join(process.env.DSH_SKINS_DIR, '..'));
+  let best = null;
+  for (const root of candidates) {
+    const statePath = join(root, 'skin-center-active.json');
+    const at = (() => { try { return statSync(statePath).mtimeMs; } catch { return 0; } })();
+    if (!best || at > best.at) best = { root, statePath, at };
+  }
+  // 没有任何 state 文件时，退回"我们的根"：安装路径保持不变，行为与之前一致。
+  const chosen = (best && best.at > 0) ? best : { root: dshHome(), statePath: activeStatePathFallback(), at: 0 };
+  homeCache.at = now;
+  homeCache.value = chosen;
+  return chosen;
+}
+function activeStatePathFallback() { return join(dshHome(), 'skin-center-active.json'); }
 
 /**
  * 皮肤中心持久化"当前皮肤"的那个文件。
@@ -52,7 +88,7 @@ function skinsRoot() { return join(dshHome(), 'skins'); }
  * 并且客户端每 2 秒轮询一次 GET 收敛 —— 所以写这个文件等价于"替它记下选择"，可靠且即时。
  * 语义上只改 `active` 一个键，其余原样保留。
  */
-function activeStatePath() { return join(dshHome(), 'skin-center-active.json'); }
+function activeStatePath() { return skinCenterHome().statePath; }
 
 /** 把 `active` 写进皮肤中心的持久层（保留其它字段；原子替换，失败不破坏原文件）。 */
 function writeActiveStateFile(id) {
@@ -433,10 +469,11 @@ function normalizeSkinManifest(manifestPath, base) {
   const cssPath = str(doc.contributes.stylesheet);
   const cssExists = cssPath && (() => { try { return statSync(join(dir, cssPath)).isFile(); } catch { return false; } })();
   if (!cssExists) {
-    let pick = '';
-    try {
-      pick = readdirSync(dir).find((n) => n.toLowerCase().endsWith('.css') && statSync(join(dir, n)).isFile()) || '';
-    } catch { pick = ''; }
+    const pick = (() => {
+      try {
+        return readdirSync(dir).find((n) => n.toLowerCase().endsWith('.css') && statSync(join(dir, n)).isFile()) || '';
+      } catch { return ''; }
+    })();
     if (pick) { doc.contributes.stylesheet = pick; fixes.push('stylesheet'); }
     else { delete doc.contributes.stylesheet; fixes.push('stylesheet-missing'); }
   }
@@ -518,6 +555,11 @@ export function registerSkinsRoutes(webServer, c) {
         skinCenterDisabled: market.skinCenterDisabled,
         skinCenterMarketKnown: market.known,
         skinCenterDetail: skinCenterProbe.detail || '',
+        // 诊断用：我们**实际读写**的目录 vs 皮肤中心自己的数据根。
+        // 便携安装 / 未设 DSH_HOME 的机器上两者曾不一致（它去 `~/.dsh` 找，我们写进 harness）
+        // ⇒ 它的列表里只剩内置款、点哪套都无效。现在由 skinCenterHome() 发现并统一，这里透出结果。
+        skinsRoot: skinsRoot(),
+        skinCenterRoot: skinCenterHome().root,
         // 版本线索：我们随身携带的是 0.4.12（engines 要求 dsh >= 0.2.1-rc.3）。
         // 低于该内核的机器会被市场 keep off —— 页签据此告诉用户"要么升级桌面端、要么别指望它"。
         skinCenterHint: skinCenter === 'present'

package/package.json

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