dsh-folia 4.15.2 → 4.15.3

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/package.json

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