dsh-folia 4.0.7 → 4.0.8

package/lib/routes/boot.js

@@ -122,7 +122,7 @@ async function fetchClipBytes(url, chunks = 4) {
  *   MP4/MOV  ISO BMFF —— 偏移 4..8 是 `ftyp`
  *   WebM     EBML    —— 开头 4 字节是 1A 45 DF A3
  */
-export function sniffVideo(buf) {
+function sniffVideo(buf) {
   if (!buf || buf.length < 1024) return null;
   if (buf.length >= 12 && buf.toString('latin1', 4, 8) === 'ftyp') {
     const brand = buf.toString('latin1', 8, 12);
@@ -134,6 +134,7 @@ export function sniffVideo(buf) {
   return null;
 }
 
+export { sniffVideo };
 /** 读请求体里的 `{ id }`。 */
 async function readIdBody(req) {
   try {
@@ -237,6 +238,10 @@ async function fetchCandidatesUncached() {
   }
 }
 
+/** 注入契约（ADR-0013 D12）：本族从 `c` 消费的**必需**键。
+ *  判据 test/verify-inject-contracts.mjs 会把它与调用点逐键对账 —— 少一个就红，
+ *  所以新增依赖（哪怕只是 `log`）也必须同步写在这里。 */
+export const DEPS = ['disposers','base','log'];
 export function registerBootRoutes(webServer, c) {
   const { disposers, base: BASE, log } = c;
 

package/lib/routes/inventory.js

@@ -232,8 +232,10 @@ function foliaTypeOfEntry(it) {
 
 /** 条目的分类 slug（没有就返回空串）。 */
 function foliaCategoryOf(it) {
-  const c = it && it.category;
-  return String((c && c.slug) || '').trim().toLowerCase();
+  // ⚠️ 形参**不要**叫 c：test/verify-inject-contracts.mjs 会把 c.<键> 读成"从注入面消费了
+  // 该键"，这里一个分类对象曾经让对账表凭空多出 slug。名字取得像注入面就会被当成注入面。
+  const category = it && it.category;
+  return String((category && category.slug) || '').trim().toLowerCase();
 }
 
 /**
@@ -465,10 +467,11 @@ async function foliaRefresh(force = false) {
 
 // 启动预热：插件一装好就在后台抓一次站点清单，这样**重启后的第一次打开面板**也不冷。
 // 有意不 await、失败静默 —— 预热只是优化，绝不能影响启动。
-export function warmInventorySiteCache() {
+function warmInventorySiteCache() {
   try { foliaRemote(true).catch(() => {}); } catch { /* ignore */ }
 }
 
+export { warmInventorySiteCache };
 export function registerInventoryRoutes(webServer, c) {
   const { disposers, base: BASE, mediaOriginApi, buildInventory, componentsProbe } = c;
 

package/lib/routes/modules.js

@@ -170,10 +170,15 @@ export async function resolveModules(force = false) {
 
 // 启动预热：模块索引很小（~1.6KB），但第一跳要走站点代理；提前拉一次，
 // 开机动画页签第一次打开就不用等这一跳。
-export function warmModulesCache() {
+function warmModulesCache() {
   try { resolveModules(true).catch(() => {}); } catch { /* ignore */ }
 }
 
+/** 注入契约（ADR-0013 D12）：本族从 `c` 消费的**必需**键。
+ *  判据 test/verify-inject-contracts.mjs 会把它与调用点逐键对账 —— 少一个就红，
+ *  所以新增依赖（哪怕只是 `log`）也必须同步写在这里。 */
+export const DEPS = ['disposers','base'];
+export { warmModulesCache };
 export function registerModulesRoutes(webServer, c) {
   const { disposers, base: BASE } = c;
 

package/lib/routes/site-thumb.js

@@ -55,6 +55,10 @@ function allowed(url) {
   }
 }
 
+/** 注入契约（ADR-0013 D12）：本族从 `c` 消费的**必需**键。
+ *  判据 test/verify-inject-contracts.mjs 会把它与调用点逐键对账 —— 少一个就红，
+ *  所以新增依赖（哪怕只是 `log`）也必须同步写在这里。 */
+export const DEPS = ['disposers','base','ensureImagePreview','log'];
 export function registerSiteThumbRoutes(webServer, c) {
   const { disposers, base: BASE, ensureImagePreview, log } = c;
 

package/package.json

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