dsh-folia 4.0.6 → 4.0.8

package/lib/boot/index.js

@@ -9,7 +9,7 @@
  *  3. **任何异常都必须放行**。注入的脚本顶层 try/catch，超时自毁，绝不把用户挡在门外。
  */
 import { createHash } from 'node:crypto';
-import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { existsSync, mkdirSync, readFileSync, readdirSync, renameSync, rmSync, statSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { extname, join } from 'node:path';
 
@@ -96,8 +96,42 @@ export function clipMetaFile(id) {
   if (!String(id || '')) return null;
   return join(bootDir(), clipStem(id) + '.json');
 }
+/** 旧命名规则下的路径：`<id>.mp4`（id 当年被限制成 ASCII 安全字符，所以能直接用）。 */
+function legacyClipFile(id) {
+  const raw = String(id || '');
+  if (!/^[a-z0-9][a-z0-9._-]*$/i.test(raw)) return null;
+  return join(bootDir(), raw + '.mp4');
+}
+
+/**
+ * 找出这个 id 实际对应的片段文件。
+ *
+ * 为什么需要"找"而不是直接算：4.0.2 把磁盘命名从 `<id>.mp4` 改成了
+ * `<id>-<hash>.mp4`（为了支持中文 slug），于是**升级前下载的片段**还叫旧名字。
+ * 列表是按文件名枚举的，所以旧文件看得见；可点「使用」时按新名字找不到 ⇒ `not-installed`。
+ * 这里按"新名字 → 旧名字"的顺序找，找到旧名字就**顺手迁移**成新名字（幂等）。
+ */
+export function resolveClipFile(id) {
+  const next = clipFile(id);
+  if (next && existsSync(next) && statSync(next).size > 0) return next;
+  const legacy = legacyClipFile(id);
+  if (legacy && existsSync(legacy) && statSync(legacy).size > 0) {
+    try {
+      if (next && !existsSync(next)) writeFileSync(next, readFileSync(legacy));
+      try { renameSync(legacy, next); } catch { /* 跨盘/占用：复制已经够用，旧文件留着无害 */ }
+      try { rmSync(legacy); } catch { /* ignore */ }
+      const metaPath = clipMetaFile(id);
+      if (metaPath && !existsSync(metaPath)) {
+        writeFileSync(metaPath, JSON.stringify({ id, migratedFrom: 'legacy' }, null, 2) + '\n');
+      }
+    } catch { /* 迁移失败也不影响这次使用 */ }
+    return next || legacy;
+  }
+  return next;
+}
+
 export function clipExists(id) {
-  const p = clipFile(id);
+  const p = resolveClipFile(id);
   return Boolean(p && existsSync(p) && statSync(p).size > 0);
 }
 
@@ -128,11 +162,13 @@ export function listLocalClips() {
 }
 
 export function removeClip(id) {
-  const p = clipFile(id);
-  if (!p) return false;
-  try { if (existsSync(p)) rmSync(p); } catch { return false; }
+  const paths = [clipFile(id), legacyClipFile(id)].filter(Boolean);
+  let removed = false;
+  for (const p of paths) {
+    try { if (existsSync(p)) { rmSync(p); removed = true; } } catch { /* 继续尝试下一个 */ }
+  }
   try { const m = clipMetaFile(id); if (m && existsSync(m)) rmSync(m); } catch { /* ignore */ }
-  return true;
+  return removed || true;
 }
 
 /* ── 注入的启动屏幕脚本 ─────────────────────────────────────────────────────

package/lib/routes/boot.js

@@ -14,7 +14,7 @@ import { join } from 'node:path';
 import { sendJson } from '../json-response.js';
 import { bodyReader } from '../http-body.js';
 import { resolveModules } from './modules.js';
-import { clipExists, clipFile, clipMetaFile, listLocalClips, readBoot, removeClip, writeBoot } from '../boot/index.js';
+import { clipExists, clipFile, clipMetaFile, listLocalClips, readBoot, removeClip, resolveClipFile, writeBoot } from '../boot/index.js';
 
 /**
  * 站点基址。开机动画的候选**从站点分类取**（`?category=boot-animation`），
@@ -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;
 
@@ -397,7 +402,8 @@ export function registerBootRoutes(webServer, c) {
     handler: async (req, res) => {
       const boot = readBoot();
       const id = boot.clipId;
-      const file = clipFile(id);
+      // 旧命名的片段（升级前下载的）也要能播 —— 解析器会顺手迁移成新名字。
+      const file = resolveClipFile(id);
       if (!file || !existsSync(file)) { res.statusCode = 404; res.end('no clip'); return; }
       const size = statSync(file).size;
       const range = String((req.headers && req.headers.range) || '');

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