dsh-folia 4.5.0 → 4.7.0

package/lib/client.js

@@ -666,6 +666,85 @@ window.__ModuleLoader__.load({
 				  "裁切失败": "Cropping failed",
 				  "读不出图片尺寸": "Could not read the image dimensions",
 
+
+				  // ── 开机动画 / 桌宠（本轮新增界面）──────────────────────────────────────
+				  //    这两组文案只有几十条，并进 panel 域最省；将来若继续长，再按 fonts/glass 的做法拆域。
+				  "已下载：{name}": "Downloaded: {name}",
+				  "已选中「{name}」，下次启动生效": "Selected \"{name}\" — takes effect on next start",
+				  "已删除：{name}": "Removed: {name}",
+				  "开机动画已开启": "Boot animation enabled",
+				  "开机动画已关闭": "Boot animation disabled",
+				  "已保存": "Saved",
+				  "操作失败：{code}（{detail}）": "Action failed: {code} ({detail})",
+				  "操作失败：{code}": "Action failed: {code}",
+				  "请求失败：{msg}": "Request failed: {msg}",
+				  "网络错误": "network error",
+				  "🎬 开机动画": "🎬 Boot animation",
+				  "启用（下次启动播放）": "Enable (plays at next start)",
+				  "当前：{name}": "Current: {name}",
+				  "未选择": "None selected",
+				  "候选清单读不到：{msg}": "Cannot read the candidate list: {msg}",
+				  "进入方式": "Enter mode",
+				  "播完再进（默认）": "Play to the end (default)",
+				  "界面就绪就进": "Enter once the UI is ready",
+				  "点一下才进": "Enter on click",
+				  "淡出时长": "Fade out",
+				  "0.4 秒": "0.4s",
+				  "0.6 秒": "0.6s",
+				  "0.9 秒": "0.9s",
+				  "1.2 秒": "1.2s",
+				  "1.6 秒": "1.6s",
+				  "带声音": "With sound",
+				  "最短显示": "Minimum on screen",
+				  "不限制": "No minimum",
+				  "2 秒": "2s",
+				  "最长停留": "Maximum on screen",
+				  "10 秒": "10s",
+				  "20 秒（默认）": "20s (default)",
+				  "30 秒": "30s",
+				  "60 秒": "60s",
+				  "已下载 {done} / {total}": "Downloaded {done} / {total}",
+				  "下载中… {s}s": "Downloading… {s}s",
+				  "下载": "Download",
+				  "使用中": "In use",
+				  "没有可用的开机动画": "No boot animations available",
+				  "读取失败：{msg}": "Load failed: {msg}",
+				  "已安装并启用：{name}": "Installed and enabled: {name}",
+				  "已卸载：{name}": "Uninstalled: {name}",
+				  "已导入并启用：{name}": "Imported and enabled: {name}",
+				  "正在读取桌宠…": "Loading pets…",
+				  "🐾 桌宠": "🐾 Desktop pet",
+				  "显示桌宠": "Show pet",
+				  "把桌宠挪回右下角": "Move the pet back to the bottom-right corner",
+				  "位置已复位（下一次出现回到右下角）": "Position reset — it returns to the bottom-right next time",
+				  "复位位置": "Reset position",
+				  "大小": "Size",
+				  "卸载": "Uninstall",
+				  "{cols} 列 · {size}": "{cols} cols · {size}",
+				  "还没有安装任何桌宠 —— 从下面的站点清单里挑一只。": "No pets installed yet — pick one from the site list below.",
+				  "本机可导入": "Importable from this machine",
+				  "来自其它宠物插件 · {size}": "From another pet plugin · {size}",
+				  "站点桌宠": "Pets on the site",
+				  "安装": "Install",
+				  "安装中…": "Installing…",
+				  "导入": "Import",
+				  "试演动作": "Try an action",
+				  "闲置": "Idle",
+				  "向右走": "Walk right",
+				  "向左走": "Walk left",
+				  "挥手": "Wave",
+				  "跳一下": "Jump",
+				  "失败": "Fail",
+				  "发呆": "Wait",
+				  "干活": "Work",
+				  "完成": "Done",
+				  "再大一点": "Bigger",
+				  "再小一点": "Smaller",
+				  "回右下角": "Back to corner",
+				  "不显示它": "Hide it",
+				  "站点上还没有桌宠。": "No pets on the site yet.",
+				  "站点不可达": "Site unreachable",
+				  "预览尺寸": "Preview-size",
 				};
 
 				// ── 内联模块：src/i18n-copy-picker.js —— 英文词表域：壁纸选择器与快捷面板（picker-* · quick-panel · sidebar-right · theme-follow）（构建期注入；勿手改本段）──
@@ -17022,18 +17101,18 @@ window.__ModuleLoader__.load({
 				      const resp = await apiPostJson("/boot/" + kind, payload || {}, { parse: "always" });
 				      const r = (resp && resp.data) || null;
 				      if (resp && resp.ok && r && r.ok) {
-				        if (kind === "download") setNote({ ok: true, text: weT("已下载：") + label });
-				        if (kind === "select") setNote({ ok: true, text: weT("已选中「") + label + weT("」，下次启动生效") });
-				        if (kind === "remove") setNote({ ok: true, text: weT("已删除：") + label });
+				        if (kind === "download") setNote({ ok: true, text: weT("已下载：{name}", { name: label }) });
+				        if (kind === "select") setNote({ ok: true, text: weT("已选中「{name}」，下次启动生效", { name: label }) });
+				        if (kind === "remove") setNote({ ok: true, text: weT("已删除：{name}", { name: label }) });
 				        if (kind === "toggle") setNote({ ok: true, text: payload.enabled ? weT("开机动画已开启") : weT("开机动画已关闭") });
 				        if (kind === "settings") setNote({ ok: true, text: weT("已保存") });
 				        await load(true);
 				      } else {
 				        const code = (r && r.error) || "failed";
-				        setNote({ ok: false, text: weT("操作失败：") + code + (r && r.detail ? "（" + r.detail + "）" : "") });
+				        setNote({ ok: false, text: r && r.detail ? weT("操作失败：{code}（{detail}）", { code, detail: String(r.detail) }) : weT("操作失败：{code}", { code }) });
 				      }
 				    } catch (e) {
-				      setNote({ ok: false, text: weT("请求失败：") + (e && e.message ? e.message : weT("网络错误")) });
+				      setNote({ ok: false, text: weT("请求失败：{msg}", { msg: (e && e.message) ? e.message : weT("网络错误") }) });
 				    } finally {
 				      setBusy("");
 				    }
@@ -17047,7 +17126,7 @@ window.__ModuleLoader__.load({
 				  const children = [];
 
 				  children.push(React.createElement("div", { className: "we-picker__section-head", key: "head" },
-				    React.createElement("span", { className: "we-picker__section-label" }, weT("🎬 开机动画") + (clips.length ? "  ·  " + clips.length : "")),
+				    React.createElement("span", { className: "we-picker__section-label" }, weT("🎬 开机动画")),
 				    React.createElement("button", {
 				      type: "button", className: "we-picker__btn", style: { marginLeft: "auto" },
 				      disabled: Boolean(busy), onClick: () => load(true),
@@ -17066,7 +17145,7 @@ window.__ModuleLoader__.load({
 				    weT("启用（下次启动播放）"),
 				  ),
 				  React.createElement("span", { className: "we-picker__hint" },
-				    activeId ? weT("当前：") + ((clips.find((c) => c.id === activeId) || {}).title || activeId) : weT("未选择")),
+				    activeId ? weT("当前：{name}", { name: (clips.find((c) => c.id === activeId) || {}).title || activeId }) : weT("未选择")),
 				  ));
 
 				  children.push(React.createElement("div", { key: "hint", className: "we-picker__hint", style: { margin: "2px 0 6px", opacity: 0.75 } },
@@ -17074,7 +17153,7 @@ window.__ModuleLoader__.load({
 
 				  if (state && state.error && !clips.length) {
 				    children.push(React.createElement("div", { key: "err", className: "we-picker__hint", style: { color: "#ff9a9a" } },
-				      weT("候选清单读不到：") + state.error));
+				      weT("候选清单读不到：{msg}", { msg: String(state.error) })));
 				  }
 
 				  if (note) {
@@ -17107,7 +17186,7 @@ window.__ModuleLoader__.load({
 				        React.createElement("option", { value: "click" }, weT("点一下才进")),
 				        ),
 				      ),
-				      opt(weT("淡出时长"), "fadeMs", [[400, "0.4 秒"], [600, "0.6 秒"], [900, "0.9 秒"], [1200, "1.2 秒"], [1600, "1.6 秒"]]),
+				      opt(weT("淡出时长"), "fadeMs", [[400, weT("0.4 秒")], [600, weT("0.6 秒")], [900, weT("0.9 秒")], [1200, weT("1.2 秒")], [1600, weT("1.6 秒")]]),
 				      // 声音：默认关（带声音的自动播放会被浏览器策略拦）。打开后若仍被拦，
 				      // 脚本会自动退回静音播放 —— 画面优先，不会黑屏。
 				      React.createElement("label", { style: { display: "flex", gap: "6px", alignItems: "center", fontSize: "12px" } },
@@ -17119,13 +17198,13 @@ window.__ModuleLoader__.load({
 				        }),
 				        weT("带声音"),
 				      ),
-				      opt(weT("最短显示"), "minShowMs", [[0, "不限制"], [600, "0.6 秒"], [1200, "1.2 秒"], [2000, "2 秒"]]),
-				      opt(weT("最长停留"), "maxHoldMs", [[10000, "10 秒"], [20000, "20 秒（默认）"], [30000, "30 秒"], [60000, "60 秒"]]),
+				      opt(weT("最短显示"), "minShowMs", [[0, weT("不限制")], [600, weT("0.6 秒")], [1200, weT("1.2 秒")], [2000, weT("2 秒")]]),
+				      opt(weT("最长停留"), "maxHoldMs", [[10000, weT("10 秒")], [20000, weT("20 秒（默认）")], [30000, weT("30 秒")], [60000, weT("60 秒")]]),
 				    ));
 				  }
 
 				  children.push(React.createElement("div", { key: "count", className: "we-picker__hint", style: { margin: "2px 0 4px" } },
-				    weT("已下载 ") + installedCount + " / " + clips.length));
+				    weT("已下载 {done} / {total}", { done: installedCount, total: clips.length })));
 
 				  if (clips.length) {
 				    children.push(React.createElement("div", { key: "grid", style: BOOT_STYLE.grid },
@@ -17141,7 +17220,7 @@ window.__ModuleLoader__.load({
 				        }, label);
 				        const actions = [];
 				        if (!c.installed) {
-				          actions.push(btn(isBusy ? (weT("下载中… ") + tick + "s") : weT("下载"), () => act("download", { id: c.id }, c.title), false, true));
+				          actions.push(btn(isBusy ? weT("下载中… {s}s", { s: tick }) : 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));
@@ -17227,9 +17306,9 @@ window.__ModuleLoader__.load({
 				          if (imDoc && imDoc.ok) setImportable(imDoc.pets || []);
 				        } catch { /* 无外部目录是正常情况 */ }
 				      }
-				      else setNote({ ok: false, text: weT("读取失败：") + ((resp && resp.error) || "unknown") });
+				      else setNote({ ok: false, text: weT("读取失败：{msg}", { msg: (resp && resp.error) || "unknown" }) });
 				    } catch (e) {
-				      setNote({ ok: false, text: weT("请求失败：") + ((e && e.message) || weT("网络错误")) });
+				      setNote({ ok: false, text: weT("请求失败：{msg}", { msg: (e && e.message) || weT("网络错误") }) });
 				    }
 				  }, []);
 
@@ -17242,17 +17321,17 @@ window.__ModuleLoader__.load({
 				      const resp = await apiPostJson("/pets/" + kind, payload || {}, { parse: "always" });
 				      const r = (resp && resp.data) || null;
 				      if (resp && resp.ok && r && r.ok) {
-				        if (kind === "install") setNote({ ok: true, text: weT("已安装并启用：") + (label || "") });
-				        if (kind === "remove") setNote({ ok: true, text: weT("已卸载：") + (label || "") });
-				        if (kind === "import") setNote({ ok: true, text: weT("已导入并启用：") + (label || "") });
+				        if (kind === "install") setNote({ ok: true, text: weT("已安装并启用：{name}", { name: label || "" }) });
+				        if (kind === "remove") setNote({ ok: true, text: weT("已卸载：{name}", { name: label || "" }) });
+				        if (kind === "import") setNote({ ok: true, text: weT("已导入并启用：{name}", { name: label || "" }) });
 				        if (kind === "config") setNote({ ok: true, text: weT("已保存") });
 				        await load(true);
 				      } else {
 				        const code = (r && r.error) || "failed";
-				        setNote({ ok: false, text: weT("操作失败：") + code });
+				        setNote({ ok: false, text: weT("操作失败：{code}", { code }) });
 				      }
 				    } catch (e) {
-				      setNote({ ok: false, text: weT("请求失败：") + ((e && e.message) || weT("网络错误")) });
+				      setNote({ ok: false, text: weT("请求失败：{msg}", { msg: (e && e.message) || weT("网络错误") }) });
 				    } finally {
 				      setBusy("");
 				    }
@@ -17272,7 +17351,7 @@ window.__ModuleLoader__.load({
 
 				  children.push(React.createElement("div", { className: "we-picker__section-head", key: "head" },
 				    React.createElement("span", { className: "we-picker__section-label" },
-				      weT("🐾 桌宠") + (pets.length ? "  ·  " + pets.length : "")),
+				      weT("🐾 桌宠")),
 				    React.createElement("button", {
 				      type: "button", className: "we-picker__btn", style: { marginLeft: "auto" },
 				      disabled: Boolean(busy), onClick: () => load(true),
@@ -17372,7 +17451,7 @@ window.__ModuleLoader__.load({
 				          }),
 				          React.createElement("div", { style: PET_STYLE.title }, p.name),
 				          React.createElement("div", { style: PET_STYLE.meta },
-				            (p.columns || 8) + weT(" 列 · ") + (p.cell ? p.cell.width + "×" + p.cell.height : "")),
+				            weT("{cols} 列 · {size}", { cols: p.columns || 8, size: p.cell ? p.cell.width + "×" + p.cell.height : "" })),
 				          React.createElement("div", { style: PET_STYLE.row }, actions),
 				        );
 				      })
@@ -17383,7 +17462,7 @@ window.__ModuleLoader__.load({
 				  if (importable.length) {
 				    children.push(React.createElement("div", { key: "impHead", className: "we-picker__section-head", style: { marginTop: "14px" } },
 				      React.createElement("span", { className: "we-picker__section-label" },
-				        weT("本机可导入") + "  ·  " + importable.length),
+				        weT("本机可导入")),
 				    ));
 				    children.push(React.createElement("div", { key: "imp", style: PET_STYLE.grid },
 				      importable.map((it) => {
@@ -17391,7 +17470,7 @@ window.__ModuleLoader__.load({
 				        return React.createElement("div", { key: "imp:" + it.id, style: PET_STYLE.card },
 				          React.createElement("div", { style: PET_STYLE.title }, it.name || it.id),
 				          React.createElement("div", { style: PET_STYLE.meta },
-				            weT("来自其它宠物插件 · ") + petFmtBytes(it.bytes)),
+				            weT("来自其它宠物插件 · {size}", { size: petFmtBytes(it.bytes) })),
 				          React.createElement("div", { style: PET_STYLE.row },
 				            btn(isBusy ? weT("导入中…") : weT("导入"), () => act("import", { id: it.id }, it.name || it.id), Boolean(busy))),
 				        );
@@ -17403,7 +17482,7 @@ window.__ModuleLoader__.load({
 				  const available = site.filter((s) => !installedIds.has(s.id));
 				  children.push(React.createElement("div", { key: "siteHead", className: "we-picker__section-head", style: { marginTop: "14px" } },
 				    React.createElement("span", { className: "we-picker__section-label" },
-				      weT("站点桌宠") + (site.length ? "  ·  " + site.length : "")),
+				      weT("站点桌宠")),
 				    state.siteError
 				      ? React.createElement("span", { className: "we-picker__hint", style: { marginLeft: "auto" } }, weT("站点不可达"))
 				      : null,
@@ -17883,9 +17962,11 @@ window.__ModuleLoader__.load({
 				      "background:rgba(28,32,40,0.96)", "border:1px solid rgba(255,255,255,0.16)",
 				      "box-shadow:0 10px 30px rgba(0,0,0,0.45)", "backdrop-filter:blur(8px)",
 				    ].join(";");
-				    const titles = ["闲置", "向右走", "向左走", "挥手", "跳一下", "失败", "发呆", "干活", "完成"];
+				    // 九条轨道的中文名是**界面文案**（右键菜单里给用户点的）⇒ 必须走 weT；
+				    // 上面 PET_ACTIVITY_TEXTS 那几条是拿去匹配页面文字的，翻不动，登记在 i18n 的 VALUE_ALLOW。
+				    const titles = [weT("闲置"), weT("向右走"), weT("向左走"), weT("挥手"), weT("跳一下"), weT("失败"), weT("发呆"), weT("干活"), weT("完成")];
 				    const head = document.createElement("div");
-				    head.textContent = "试演动作";
+				    head.textContent = weT("试演动作");
 				    head.style.cssText = "padding:4px 10px 6px;opacity:0.55;font-size:11px";
 				    menu.appendChild(head);
 				    titles.forEach((name, r) => {
@@ -17900,15 +17981,15 @@ window.__ModuleLoader__.load({
 				    const hr = document.createElement("div");
 				    hr.style.cssText = "height:1px;margin:6px 0;background:rgba(255,255,255,0.14)";
 				    menu.appendChild(hr);
-				    menu.appendChild(buildMenuItem("再大一点", () => { applyScale(scale + 0.2); closeMenu(); }));
-				    menu.appendChild(buildMenuItem("再小一点", () => { applyScale(Math.max(0.5, scale - 0.2)); closeMenu(); }));
-				    menu.appendChild(buildMenuItem("回右下角", () => {
+				    menu.appendChild(buildMenuItem(weT("再大一点"), () => { applyScale(scale + 0.2); closeMenu(); }));
+				    menu.appendChild(buildMenuItem(weT("再小一点"), () => { applyScale(Math.max(0.5, scale - 0.2)); closeMenu(); }));
+				    menu.appendChild(buildMenuItem(weT("回右下角"), () => {
 				      try { localStorage.removeItem("wePetPos"); } catch { /* ignore */ }
 				      layerEl.style.left = ""; layerEl.style.top = "";
 				      layerEl.style.right = "24px"; layerEl.style.bottom = "16px";
 				      closeMenu();
 				    }));
-				    menu.appendChild(buildMenuItem("不显示它", () => {
+				    menu.appendChild(buildMenuItem(weT("不显示它"), () => {
 				      // 只隐藏本地这一层；真正的开关在面板里（下一次轮询会被尊重）。
 				      if (layerEl) layerEl.style.display = "none";
 				      closeMenu();
@@ -18482,7 +18563,7 @@ window.__ModuleLoader__.load({
 				        ? React.createElement("span", {
 				            className: "we-qp__card-badge",
 				            style: { right: "auto", left: "6px", background: "rgba(255,196,120,0.9)", color: "#3a2600" },
-				            title: weT("这张图只有 ") + w.width + "×" + w.height + weT("，当壁纸会糊 —— 建议在站点上传原图"),
+				            title: weT("这张图只有 {size}，当壁纸会糊 —— 建议在站点上传原图", { size: w.width + "×" + w.height }),
 				          }, weT("预览尺寸"))
 				        : null,
 				      w.id === sel.id && React.createElement("span", { className: "we-qp__card-badge" }, weT("当前")),

package/lib/index.js

@@ -77,11 +77,7 @@ import { assertSubpackagesResolvable, assertSubpackagesResolvableInHost, httpVie
 // `extOf` 反向传给会话段（清单载荷的容器后缀判据 ⇒ 见该文件头）。
 import { createHostSession } from './kernel/host-session.js';
 export { extOf };
-import { registerInventoryRoutes, warmInventorySiteCache } from './routes/inventory.js';
-import { registerModulesRoutes, warmModulesCache } from './routes/modules.js';
-import { registerBootRoutes } from './routes/boot.js';
-import { registerSiteThumbRoutes } from './routes/site-thumb.js';
-import { registerPetsRoutes } from './routes/pets.js';
+import { registerFeatureRoutes, warmFeatureCaches } from './route-registry.js';
 import { installBootInjection } from './boot/index.js';
 import { registerDiagRoutes } from './routes/diag.js';
 // 遮挡消息桥族（上游新增域模块）：hub 处理 x11 遮挡探针，路由对外暴露状态/控制面。
@@ -291,30 +287,17 @@ export function apply(ctx) {
     }
   }
 
-  // 1. Inventory JSON → lib/routes/inventory.js（路径/头/状态码/错误文案逐字未变）。
-  //    `componentsProbe` 是**只读**行状态面（与 3c-6 的 /diag-log 同一个探针、同一批账）：
-  //    浏览器半边按它在 `/inventory` 里的 `components` 字段决定"该组件的界面渲不渲染"
-  //    （ADR-0013 D3 的状态面；形状与失效口径写在那个族的文件头）。
-  registerInventoryRoutes(webServer, {
-    disposers, base: BASE, mediaOriginApi, buildInventory, componentsProbe: componentProbe,
+  // 1. 功能族路由：**注册表驱动**（lib/route-registry.js）。
+  //    装配点不再逐个点名 —— 加一个功能只改注册表，这里永远是同一次调用。
+  //    已迁移：inventory / modules / boot / site-thumb / pets；
+  //    未迁移的族列在 INLINE_ROUTE_FAMILIES（棘轮，只许缩小），仍由下面的显式调用装载。
+  registerFeatureRoutes(webServer, {
+    disposers, base: BASE, log, mediaOriginApi, buildInventory,
+    componentProbe, ensureImagePreview,
   });
-  // 数据模块索引（站点侧声明「有哪些数据模块」）→ lib/routes/modules.js。
-  // 与 inventory 同一套站点基址；读不到就退回内置集合，绝不让面板因为索引文件而空白。
-  registerModulesRoutes(webServer, { disposers, base: BASE });
-
-  // 开机动画 → 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 });
 
   // 启动预热（有意不阻塞）：站点清单与模块索引各拉一次，让第一次打开面板不冷。
-  // 桌宠：自渲染（不依赖第三方宠物插件）—— 站点当分发通道，我们负责安装与绘制。
-  registerPetsRoutes(webServer, { disposers, base: BASE, log });
-
-  warmInventorySiteCache();
-  warmModulesCache();
+  warmFeatureCaches();
   installBootInjection(ctx, (m) => { try { log(m); } catch { /* ignore */ } });
 
   // 3./3a. 派生媒体族路由（源元信息 / 抽帧转码 + 进度 / 视频缩略图）→ lib/routes/media-derived.js。

package/lib/route-registry.js

@@ -0,0 +1,115 @@
+/**
+ * lib/route-registry.js — **功能路由注册表**（宿主侧）。
+ *
+ * 为什么要它：`lib/index.js` 过去逐个 `registerXxxRoutes(webServer, {…})`，加一个功能就得
+ * 在那个 400 行装配文件里挑一处插进去，并保证依赖对象拼对。客户端已经收口成注册表
+ * （`src/features.js`），宿主侧对称过来，装配点就只剩一次循环。
+ *
+ * 纪律（由 `test/verify-route-registry.mjs` 机器校验）：
+ *   · 本表里写出的族**必须在** `lib/routes/` 里真实存在，且 `deps` 只从传入的上下文取键；
+ *   · `INLINE_ROUTE_FAMILIES` 是**尚未迁移**的族（大依赖：mediaMap / hub / 转码器等），
+ *     它是**棘轮**：只许缩小 —— 迁一个删一个，不许往回调；
+ *   · 两表并集必须覆盖 `lib/routes/*.js`（不许有第三处偷偷注册的族）。
+ *
+ * 迁移一个族的步骤：把 `lib/index.js` 里那段调用删掉 → 在 `FEATURE_ROUTE_FAMILIES` 加一条 →
+ * 从 `INLINE_ROUTE_FAMILIES` 删掉 → 跑守卫。
+ */
+
+import { registerInventoryRoutes, warmInventorySiteCache } from './routes/inventory.js';
+import { registerModulesRoutes, warmModulesCache } from './routes/modules.js';
+import { registerBootRoutes } from './routes/boot.js';
+import { registerSiteThumbRoutes } from './routes/site-thumb.js';
+import { registerPetsRoutes } from './routes/pets.js';
+
+/**
+ * 已迁移的功能族。
+ *
+ * `deps(c)` 只从上下文取键 —— 这样"某个族需要什么"是**声明式**的，装配点不需要知道。
+ * 上下文由门面按需提供（见 lib/index.js 的 `registerFeatureRoutes(webServer, { … })`）。
+ *
+ * @type {{ id: string, file: string, register: Function, deps: (c: any) => any, warm?: Function }[]}
+ */
+export const FEATURE_ROUTE_FAMILIES = [
+  {
+    id: 'inventory',
+    file: 'lib/routes/inventory.js',
+    register: registerInventoryRoutes,
+    // 清单族需要"本机清单构建器 + 组件行状态探针 + 媒体源访问器"：三者都是门面现算的，
+    // 所以只能由调用方传进来（族自己拿不到）。
+    deps: (c) => ({
+      disposers: c.disposers,
+      base: c.base,
+      mediaOriginApi: c.mediaOriginApi,
+      buildInventory: c.buildInventory,
+      componentsProbe: c.componentProbe,
+    }),
+    warm: warmInventorySiteCache,
+  },
+  {
+    id: 'modules',
+    file: 'lib/routes/modules.js',
+    register: registerModulesRoutes,
+    deps: (c) => ({ disposers: c.disposers, base: c.base }),
+    warm: warmModulesCache,
+  },
+  {
+    id: 'boot',
+    file: 'lib/routes/boot.js',
+    register: registerBootRoutes,
+    deps: (c) => ({ disposers: c.disposers, base: c.base, log: c.log }),
+  },
+  {
+    id: 'site-thumb',
+    file: 'lib/routes/site-thumb.js',
+    register: registerSiteThumbRoutes,
+    // 缩略图复用内核的 ffmpeg 套件（ensureImagePreview），不自己 spawn。
+    deps: (c) => ({ disposers: c.disposers, base: c.base, ensureImagePreview: c.ensureImagePreview, log: c.log }),
+  },
+  {
+    id: 'pets',
+    file: 'lib/routes/pets.js',
+    register: registerPetsRoutes,
+    deps: (c) => ({ disposers: c.disposers, base: c.base, log: c.log }),
+  },
+];
+
+/**
+ * **尚未迁移**的族（棘轮：只许缩小）。
+ *
+ * 为什么留在门面里：它们的依赖是内核的活对象（mediaMap / occlusionHub / transcodeKit /
+ * sceneFrameSlot / uploadStoreKit …），搬进本表需要把那些对象也传进来，属于另一轮改动。
+ * 这张清单存在的意义是**把"还剩多少"写下来**，守卫据此防止有人往回调。
+ */
+export const INLINE_ROUTE_FAMILIES = [
+  // 每条写「族 id + 门面里的注册函数名」：两者**不总同形**（presets → registerGlassPresetsRoutes），
+  // 靠名字猜会在守卫里制造假红。迁移一个族 = 在 FEATURE_ROUTE_FAMILIES 加一条 + 删这里一行。
+  { id: 'media-bytes', fn: 'registerMediaBytesRoutes' },
+  { id: 'media-derived', fn: 'registerMediaDerivedRoutes' },
+  { id: 'scene-frame', fn: 'registerSceneFrameRoutes' },
+  { id: 'scene-serve', fn: 'registerSceneServeRoutes' },
+  { id: 'scene-media', fn: 'registerSceneMediaRoutes' },
+  { id: 'live-frame', fn: 'registerLiveFrameRoutes' },
+  { id: 'props', fn: 'registerPropsRoutes' },
+  { id: 'occlusion', fn: 'registerOcclusionRoutes' },
+  { id: 'diag', fn: 'registerDiagRoutes' },
+  { id: 'we-assets', fn: 'registerWeAssetsRoutes' },
+  { id: 'upload', fn: 'registerUploadRoutes' },
+  { id: 'presets', fn: 'registerGlassPresetsRoutes' },
+  { id: 'settings', fn: 'registerSettingsRoutes' },
+  { id: 'cache-dir', fn: 'registerCacheDirRoutes' },
+];
+
+/** 按注册表挂载全部已迁移族；`warm` 钩子显式调用（预热是有意不阻塞的）。 */
+export function registerFeatureRoutes(webServer, ctx) {
+  for (const fam of FEATURE_ROUTE_FAMILIES) {
+    fam.register(webServer, fam.deps(ctx));
+  }
+}
+
+/** 启动预热（站点清单与模块索引各拉一次）。失败静默 —— 预热只是优化。 */
+export function warmFeatureCaches() {
+  for (const fam of FEATURE_ROUTE_FAMILIES) {
+    if (typeof fam.warm !== 'function') continue;
+    try { fam.warm(); } catch { /* 预热失败不影响启动 */ }
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "dsh-folia",
-    "version":  "4.5.0",
+    "version":  "4.7.0",
     "description":  "Folia 壁纸引擎：把本机 Wallpaper Engine 壁纸搬进 DSH 界面（场景实时渲染 / 视频 / 网页），内置液态玻璃与 Folia 吉祥物，并可从自建站点拉取壁纸。单包形态（组件已合并）。",
     "type":  "module",
     "engines":  {
@@ -156,7 +156,8 @@
                   "README.en.md",
                   "README.beginner.md",
                   "lib/components/",
-                  "lib/features.js"
+                  "lib/features.js",
+                  "lib/route-registry.js"
               ],
     "dsh":  {
                 "bundle":  {