dsh-folia 2.5.7 → 2.5.9

package/lib/client.js

@@ -16991,6 +16991,9 @@ window.__ModuleLoader__.load({
 				  const [state, setState] = React.useState(null);
 				  const [busy, setBusy] = React.useState("");
 				  const [note, setNote] = React.useState(null);
+				  // 下载没有进度通道（宿主一次性 fetch 完才返回），但等待必须"看得见"：
+				  // 每秒 +1 的秒表足以让用户知道它没卡死。
+				  const [tick, setTick] = React.useState(0);
 
 				  const load = React.useCallback(async (force) => {
 				    try {
@@ -17004,9 +17007,16 @@ window.__ModuleLoader__.load({
 
 				  React.useEffect(() => { load(false); }, [load]);
 
+				  React.useEffect(() => {
+				    if (!busy) return undefined;
+				    const t = setInterval(() => setTick((n) => n + 1), 1000);
+				    return () => clearInterval(t);
+				  }, [busy]);
+
 				  async function act(kind, payload, label) {
 				    if (busy) return;
 				    setBusy(payload && payload.id ? payload.id : kind);
+				    setTick(0);
 				    setNote(null);
 				    try {
 				      const resp = await apiPostJson("/boot/" + kind, payload || {}, { parse: "always" });
@@ -17120,7 +17130,7 @@ window.__ModuleLoader__.load({
 				        }, label);
 				        const actions = [];
 				        if (!c.installed) {
-				          actions.push(btn(isBusy ? weT("下载中…") : weT("下载"), () => act("download", { id: c.id }, c.title), false, true));
+				          actions.push(btn(isBusy ? (weT("下载中… ") + tick + "s") : weT("下载"), () => act("download", { id: c.id }, c.title), false, true));
 				        } else if (!isActive) {
 				          actions.push(btn(weT("使用"), () => act("select", { id: c.id }, c.title), false, true));
 				          actions.push(btn(weT("删除"), () => act("remove", { id: c.id }, c.title), isBusy, false));
@@ -17451,7 +17461,7 @@ window.__ModuleLoader__.load({
 				      React.createElement("span", { className: "we-qp__item-thumb" },
 				        w.preview
 				          ? React.createElement("img", {
-				              src: w.preview, alt: "", loading: "lazy",
+				              src: w.preview, alt: "", loading: "lazy", decoding: "async",
 				              onError: (e) => { e.target.style.display = "none"; },
 				              onLoad: (e) => { e.target.style.opacity = "1"; },
 				            })
@@ -17479,7 +17489,7 @@ window.__ModuleLoader__.load({
 				    },
 				      w.preview
 				        ? React.createElement("img", {
-				            src: w.preview, alt: "", loading: "lazy",
+				            src: w.preview, alt: "", loading: "lazy", decoding: "async",
 				            onError: (e) => { e.target.style.display = "none"; },
 				            onLoad: (e) => { e.target.style.opacity = "1"; },
 				          })

package/lib/index.js

@@ -80,6 +80,7 @@ export { extOf };
 import { registerInventoryRoutes } from './routes/inventory.js';
 import { registerModulesRoutes } from './routes/modules.js';
 import { registerBootRoutes } from './routes/boot.js';
+import { registerSiteThumbRoutes } from './routes/site-thumb.js';
 import { installBootInjection } from './boot/index.js';
 import { registerDiagRoutes } from './routes/diag.js';
 // 遮挡消息桥族（上游新增域模块）：hub 处理 x11 遮挡探针，路由对外暴露状态/控制面。
@@ -303,6 +304,9 @@ export function apply(ctx) {
   // 开机动画 → lib/routes/boot.js（HTTP 面）+ lib/boot/index.js（注入与屏幕脚本）。
   // 注入是「关就一行都不注」：没有选片时不产生任何脚本、不产生任何请求。
   registerBootRoutes(webServer, { disposers, base: BASE, log });
+
+  // 站点图片缩略图代理 → lib/routes/site-thumb.js。卡片用 320px 小图，不再每张下 500 KB 原图。
+  registerSiteThumbRoutes(webServer, { disposers, base: BASE, ensureImagePreview, log });
   installBootInjection(ctx, (m) => { try { log(m); } catch { /* ignore */ } });
 
   // 3./3a. 派生媒体族路由（源元信息 / 抽帧转码 + 进度 / 视频缩略图）→ lib/routes/media-derived.js。

package/lib/routes/inventory.js

@@ -126,6 +126,10 @@ const FOLIA_API_CATEGORY = 'wallpaper';
 /** 明确**不是**壁纸的分类。没列进来的（含未来新增的）一律放行 —— 宁可多显示，不静默丢。 */
 const FOLIA_NON_WALLPAPER_CATEGORIES = ['boot-animation', 'skin-pack', 'skin', 'pet', 'pets', 'assistant-skin'];
 /** 分页上限：防止站点游标异常时无限翻页（每页 12~24，20 页足够几百条）。 */
+/** 每次请求要多少条：接口支持 `?limit=`（实测 limit=5 生效），一次要 100 条能把
+ *  几百张图的清单压到个位数请求。 */
+const FOLIA_API_LIMIT = 100;
+/** 条目总数上限（防止站点数据异常时无限翻页）。100 × 20 = 2000 条。 */
 const FOLIA_API_MAX_PAGES = 20;
 const FOLIA_CATALOG_PATH = '/data/catalog.json';
 const FOLIA_MANIFEST_PATH = '/manifest.json';
@@ -206,6 +210,13 @@ function foliaItemFromCatalog(it, base) {
   const media = foliaAbs(base, it && it.url);
   if (!media) return null;
   const slug = String((it && (it.slug || it.id)) || '');
+  // 站点图片的预览走宿主缩略图代理：卡片只下 ~10 KB，不再下 500 KB 原图。
+  // （视频没有封面，保持 null —— 卡片会显示「无预览」，不会去拉整段视频。）
+  // 预览优先级：**站点自己给的 preview 最高**（省掉宿主这一跳，也最省流量）；
+  // 站点没给才退回宿主缩略图代理。只有预览走小图，`media` 永远是原图 ——
+  // 应用壁纸用的是 `media`，所以画质不受影响。
+  const sitePreview = foliaAbs(base, it && (it.preview || it.poster)) || null;
+  const thumb = sitePreview ? null : (type === 'image' ? '/folia/site-thumb?u=' + encodeURIComponent(media) : null);
   const extHit = String(media).match(/\.([a-z0-9]{2,5})(?:[?#]|$)/i);
   const num = (v) => (Number.isFinite(Number(v)) && Number(v) > 0 ? Number(v) : undefined);
   return {
@@ -217,7 +228,7 @@ function foliaItemFromCatalog(it, base) {
     media,                                  // 绝对 URL
     mediaExt: '.' + (extHit ? extHit[1].toLowerCase() : (type === 'video' ? 'mp4' : 'jpg')),
     // 站点目录可能带 preview/poster；图片没封面时用自己当预览，视频没有就留空（卡片会是黑块）
-    preview: foliaAbs(base, it && (it.preview || it.poster)) || (type === 'image' ? media : null),
+    preview: sitePreview || thumb || null,
     frameUrl: null,
     schemeColor: null,
     sceneLiveSrc: null,
@@ -323,7 +334,7 @@ async function foliaRemote(force = false) {
     const out = [];
     let cursor = null;
     for (let page = 0; page < FOLIA_API_MAX_PAGES; page++) {
-      const scope = '?category=' + encodeURIComponent(FOLIA_API_CATEGORY);
+      const scope = '?category=' + encodeURIComponent(FOLIA_API_CATEGORY) + '&limit=' + FOLIA_API_LIMIT;
       const qs = cursor ? FOLIA_API_PATH + scope + '&cursor=' + encodeURIComponent(cursor) : FOLIA_API_PATH + scope;
       const { doc, error } = await fetchJson(qs);
       if (!doc || !doc.ok || !doc.data) return { items: out, error: error || 'api-shape' };

package/lib/routes/site-thumb.js

@@ -0,0 +1,109 @@
+/**
+ * routes/site-thumb.js — 站点图片的**缩略图代理**。
+ *
+ * 为什么需要它：站点上的壁纸是 1024×1024 起的原图（实测一张 536 KB）。卡片网格一页
+ * 9~12 张，一次要下 5 MB 左右，在慢网络上就是"站点壁纸加载很慢"。
+ *
+ * 做法：宿主把原图抓一次存到缓存，然后用**已有的** `ensureImagePreview`（ffmpeg 缩到
+ * 320px、q=5，约 10 KB）生成小图，之后每次都直接发小图。原图只下一次、只在第一次。
+ *
+ * 三条纪律：
+ *   · **只代理白名单主机**（站点基址与素材桶），避免变成任意 URL 的开放代理；
+ *   · 任何失败都 **302 回原图** —— 慢一点但一定能显示，绝不 404；
+ *   · 缩略图与源图都按 URL 的 sha1 命名，天然幂等，不需要失效逻辑。
+ */
+import { createHash } from 'node:crypto';
+import { createReadStream, existsSync, mkdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { extname, join } from 'node:path';
+
+const MAX_SOURCE_BYTES = 32 * 1024 * 1024;
+const FETCH_TIMEOUT_MS = 30000;
+
+const DEFAULT_SITE = 'https://folia-5ve.pages.dev';
+const DEFAULT_ASSETS = 'https://pub-1275321f146e479eaac54948f4cdad6f.r2.dev';
+
+function siteBase() {
+  const raw = process.env.DSH_FOLIA_SITE;
+  if (typeof raw === 'string' && raw.trim().toLowerCase() === 'off') return null;
+  const base = (typeof raw === 'string' && raw.trim()) ? raw.trim() : DEFAULT_SITE;
+  return base.replace(/\/+$/, '');
+}
+function assetsBase() {
+  const raw = process.env.DSH_FOLIA_ASSETS;
+  const base = (typeof raw === 'string' && raw.trim()) ? raw.trim() : DEFAULT_ASSETS;
+  return base.replace(/\/+$/, '');
+}
+
+/** 源图缓存目录（与 config.json 同一个数据根）。 */
+function sourceDir() {
+  const base = process.env.DSH_FOLIA_HOME || join(homedir(), '.dsh-folia');
+  const d = join(base, 'site-src');
+  try { if (!existsSync(d)) mkdirSync(d, { recursive: true }); } catch { /* 只读盘：后面会失败并回退 */ }
+  return d;
+}
+
+/** 只允许抓我们自己的两个主机。 */
+function allowed(url) {
+  try {
+    const u = new URL(url);
+    if (!/^https?:$/.test(u.protocol)) return false;
+    const hosts = [siteBase(), assetsBase()].filter(Boolean).map((b) => { try { return new URL(b).host; } catch { return ''; } });
+    return hosts.includes(u.host);
+  } catch {
+    return false;
+  }
+}
+
+export function registerSiteThumbRoutes(webServer, c) {
+  const { disposers, base: BASE, ensureImagePreview, log } = c;
+
+  disposers.push(webServer.register({
+    kind: 'exact',
+    path: `${BASE}/site-thumb`,
+    handler: async (req, res) => {
+      let target = '';
+      try { target = new URL(req.url || '/', 'http://x').searchParams.get('u') || ''; } catch { target = ''; }
+
+      const redirect = () => {
+        res.statusCode = 302;
+        if (typeof res.setHeader === 'function') res.setHeader('location', target);
+        res.end();
+      };
+
+      if (!target || !allowed(target)) { redirect(); return; }
+
+      const key = createHash('sha1').update(target).digest('hex');
+      let ext = '.jpg';
+      try { ext = extname(new URL(target).pathname) || '.jpg'; } catch { /* 用默认 */ }
+      const src = join(sourceDir(), key + (ext.length <= 5 ? ext : '.jpg'));
+
+      try {
+        if (!existsSync(src) || statSync(src).size === 0) {
+          const r = await fetch(target, { signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) });
+          if (!r.ok) { redirect(); return; }
+          const ct = String(r.headers.get('content-type') || '');
+          if (!/^image\//i.test(ct)) { redirect(); return; }
+          const buf = Buffer.from(await r.arrayBuffer());
+          if (buf.length === 0 || buf.length > MAX_SOURCE_BYTES) { redirect(); return; }
+          writeFileSync(src, buf);
+        }
+        // 已有套件：缩到 320px（失败返回 null ⇒ 回落原图）
+        const thumb = await ensureImagePreview(src).catch(() => null);
+        const file = thumb && existsSync(thumb) ? thumb : src;
+        const size = statSync(file).size;
+        if (typeof res.setHeader === 'function') {
+          res.setHeader('content-type', 'image/jpeg');
+          res.setHeader('content-length', String(size));
+          res.setHeader('cache-control', 'public, max-age=31536000, immutable');
+        }
+        res.statusCode = 200;
+        createReadStream(file).pipe(res);
+      } catch (e) {
+        if (typeof log === 'function') log(`[site-thumb] ${String((e && e.message) || e)}`);
+        try { if (existsSync(src)) rmSync(src); } catch { /* ignore */ }
+        redirect();
+      }
+    },
+  }));
+}

package/package.json

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