dsh-folia 4.14.3 → 4.15.0

package/lib/client.js

@@ -18384,7 +18384,7 @@ window.__ModuleLoader__.load({
 				    const structural = kind === "install" || kind === "remove";
 				    const busyKey = structural
 				      ? kind + ":" + ((payload && payload.id) || "")
-				      : (kind === "activate" ? "activate:" + ((payload && payload.id) || "") : "");
+				      : (kind === "activate" || kind === "repair" ? kind + ":" + ((payload && payload.id) || "") : "");
 				    if (busyKey) { setBusy(busyKey); busyRef.current = busyKey; }
 				    setNote(null);
 				    try {
@@ -18451,14 +18451,28 @@ window.__ModuleLoader__.load({
 				      const r = (resp && resp.data) || null;
 				      if (resp && resp.ok && r && r.ok) {
 				        if (kind === "install") {
+				          // 安装时宿主会把 skin.json **规范化**成皮肤中心一定收的样子（它的规则比我们严：
+				          // id 必须等于目录名、必须 v2、name/nameEn/author/stylesheet 齐全、不允许未知顶层键）。
+				          // 这一步做了什么要如实告诉用户，否则"为什么它动了我的清单"会变成新的疑问。
+				          const fixed = r.manifestFixed === true
+				            ? weT("（已按皮肤中心规则规范化清单：{what}）", { what: (r.manifestFixes || []).join("、") })
+				            : "";
 				          setNote({
 				            ok: true,
 				            text: r.exists
 				              ? weT("已安装过：{name}", { name: label || "" })
-				              : weT("已安装：{name} —— 点「应用」就能切换", { name: label || "" }),
+				              : weT("已安装：{name} —— 点「应用」就能切换", { name: label || "" }) + fixed,
 				          });
 				        }
 				        if (kind === "remove") setNote({ ok: true, text: weT("已卸载：{name}", { name: label || "" }) });
+				        if (kind === "repair") {
+				          setNote({
+				            ok: true,
+				            text: r.changed
+				              ? weT("已按皮肤中心规则修复清单：{what} —— 点「刷新」后应能被收录", { what: (r.fixes || []).join("、") })
+				              : weT("这套清单本来就合规（没有可修的）；若仍未被收录，把卡片上的原因发我"),
+				          });
+				        }
 				        await load(true);
 				      } else {
 				        const code = (r && r.error) || "failed";
@@ -18601,8 +18615,14 @@ window.__ModuleLoader__.load({
 				          // ⚠️ 只有 `=== false` 才下结论：`null` 表示"问不到它的 catalog"（未知），
 				          // 未知绝不能禁用按钮 —— 那会变成"替我猜错了就不让我点"。
 				          const notListed = s.inCatalog === false;
+				          // 它给出的**具体拒收原因**（catalog diagnostics 里 subject = 目录名）。
+				          // 有原因就直接显示原因，比我们复述规则更有用。
+				          const whyDetail = notListed && Array.isArray(s.catalogWarnings) && s.catalogWarnings.length
+				            ? "：" + s.catalogWarnings.slice(0, 2).join("；")
+				            : "";
 				          const notListedWhy = notListed
-				            ? weT("皮肤中心仍未收录这套（它按 manifest 规则筛选：id 必须等于目录名、必须 v2、name/nameEn/author/stylesheet 齐全）。点「刷新」会强制它对账一次；若仍显示这条，说明确实被它拒收")
+				            ? weT("皮肤中心未收录这套（它按自己的 manifest 规则筛选：id 必须等于目录名、必须 v2、name/nameEn/author/stylesheet 齐全、不允许未知顶层键）。可点「修复清单」按它的规则补一次；修完点刷新")
+				              + whyDetail
 				            : "";
 				          return React.createElement("div", {
 				            key: s.id,
@@ -18624,6 +18644,16 @@ window.__ModuleLoader__.load({
 				                title: notListed ? notListedWhy : (applyBlockedReason || undefined),
 				                onClick: () => act("activate", { id: s.id }, s.name),
 				              }, busyThis ? weT("切换中…") : weT("应用")),
+				            // 未被皮肤中心收录时给一个**可执行**的出口：按它的规则就地修一次清单。
+				            // 只是补/裁 skin.json 的字段，不动 skin.css / hooks / 资产。
+				            notListed
+				              ? React.createElement("button", {
+				                className: "we-picker__btn", type: "button",
+				                disabled: Boolean(busy),
+				                title: notListedWhy,
+				                onClick: () => act("repair", { id: s.dirId || s.id }, s.name),
+				              }, busy === "repair:" + (s.dirId || s.id) ? weT("修复中…") : weT("修复清单"))
+				              : null,
 				            React.createElement("button", {
 				              className: "we-picker__btn", type: "button",
 				              disabled: Boolean(busy) || isActive,

package/lib/routes/skins.js

@@ -153,14 +153,17 @@ async function probeSkinCenter(hostHeader, force) {
 // 快照缓存：写进 Map 而不是给模块级对象赋值 —— 后者正是 require-atomic-updates 判红的形态，
 // 而这里本来就是「最后一次完整快照胜出」的语义，用 Map.set 更贴合且不触发该规则。
 const catalogCacheStore = new Map();
-function readCatalogCache() { return catalogCacheStore.get('v') || { at: 0, map: null }; }
-function setCatalogCache(at, map) { catalogCacheStore.set('v', { at, map }); }
+function readCatalogCache() { return catalogCacheStore.get('v') || { at: 0, map: null, diag: null }; }
+function setCatalogCache(at, map, diag) { catalogCacheStore.set('v', { at, map, diag }); }
 async function fetchSkinCenterCatalog(hostHeader, force) {
   const now = Date.now();
   const snapshot = readCatalogCache();
-  if (!force && snapshot.at && now - snapshot.at < 30000) return snapshot.map;
-  if (!hostHeader) return readCatalogCache().map;
+  if (!force && snapshot.at && now - snapshot.at < 30000) return { map: snapshot.map, diag: snapshot.diag };
+  if (!hostHeader) return { map: readCatalogCache().map, diag: readCatalogCache().diag };
   let map = null;
+  // `diagnostics` 是它给出的**拒收原因**（subject = 目录名，errors = 具体字段问题）。
+  // 拿它挂在卡片 title 上，"未收录"才不是一句无解的话。
+  let diag = null;
   try {
     const r = await fetch('http://' + hostHeader + '/api/skin-center/v2/catalog', { signal: AbortSignal.timeout(5000) });
     if (r.ok) {
@@ -171,10 +174,16 @@ async function fetchSkinCenterCatalog(hostHeader, force) {
         const id = s && s.manifest && s.manifest.id;
         if (typeof id === 'string' && id) map.set(id, Array.isArray(s.warnings) ? s.warnings : []);
       }
+      const list = (doc && Array.isArray(doc.diagnostics)) ? doc.diagnostics : [];
+      diag = new Map();
+      for (const d of list) {
+        const subject = d && d.subject;
+        if (typeof subject === 'string' && subject) diag.set(subject, Array.isArray(d.errors) ? d.errors.map(String) : []);
+      }
     }
-  } catch { map = readCatalogCache().map; }
-  setCatalogCache(now, map);
-  return map;
+  } catch { map = readCatalogCache().map; diag = readCatalogCache().diag; }
+  setCatalogCache(now, map, diag);
+  return { map, diag };
 }
 
 /** 站点列表缓存（30 秒）：面板打开与"刷新"共用，避免每次都打站点。 */
@@ -188,13 +197,15 @@ const SITE_TTL_MS = 30000;
  * `dirId`（目录名），且历史上站点 slug 可能带 `skin-` 前缀 ⇒ 三种形态都试，任一命中即算收录。
  * `catalog === null`（问不到）时给 `null`：**未知不等于未收录**，界面不能据此禁用「应用」。
  */
-function annotateCatalog(installed, catalog) {
+function annotateCatalog(installed, catalog, diag) {
   if (!catalog) return installed.map((s) => ({ ...s, inCatalog: null, catalogWarnings: [] }));
   return installed.map((s) => {
     const hit = catalog.has(s.id) ? s.id
       : catalog.has(s.dirId) ? s.dirId
         : catalog.has(normSkinId(s.id)) ? normSkinId(s.id) : null;
-    return { ...s, inCatalog: Boolean(hit), catalogWarnings: hit ? catalog.get(hit) : [] };
+    // 未收录时把它的 `diagnostics`（按目录名）附上：卡片 title 直接显示"为什么被拒"。
+    const why = hit || !diag ? [] : (diag.get(s.dirId) || diag.get(s.id) || []);
+    return { ...s, inCatalog: Boolean(hit), catalogWarnings: hit ? catalog.get(hit) : why };
   });
 }
 
@@ -372,6 +383,80 @@ function sendJson(res, code, payload) {
   res.end(JSON.stringify(payload));
 }
 
+/**
+ * 把一份 skin.json 规范化成**皮肤中心一定收的样子**。
+ *
+ * 它的规则（0.4.12 `validateSkinManifestV2` 逐条读出来的，不是猜）：
+ *   · `skinManifestVersion === 2`
+ *   · `id` 必须 `^[a-z][a-z0-9-]{0,31}$`，且**必须等于目录名**
+ *   · `name` / `nameEn` / `author` 非空字符串；`version` 必须是 SemVer
+ *   · `contributes.stylesheet` 必须是**存在的相对路径**
+ *   · **顶层不允许未知键**（`unknown field` 是 error，不是 warning）
+ *   · `accent` 若存在必须是 `#rrggbb`
+ *
+ * 站点里的包来自不同来源（有的还是 v1），常常缺 nameEn/author 或带 v1 键 ⇒ 被它整套排除，
+ * 用户看到的是"装好了、皮肤中心里没有、点了也不生效"。这里按上面几条补齐/裁掉，
+ * 原文件保留为 `skin.json.orig` 便于追溯。返回 `{ changed, fixes }` 供界面如实说明。
+ */
+function normalizeSkinManifest(manifestPath, base) {
+  const fixes = [];
+  let doc;
+  try { doc = JSON.parse(readFileSync(manifestPath, 'utf8')); } catch { return { changed: false, fixes }; }
+  if (!doc || typeof doc !== 'object' || Array.isArray(doc)) return { changed: false, fixes };
+  const dir = join(manifestPath, '..');
+  const before = JSON.stringify(doc);
+  const ALLOWED = new Set([
+    '$schema', 'skinManifestVersion', 'id', 'name', 'nameEn', 'version', 'author',
+    'tagline', 'description', 'tags', 'accent', 'order', 'preview', 'license', 'licenseUrl',
+    'noticeUrl', 'sourceUrl', 'attribution', 'requires', 'contributes', 'facets',
+  ]);
+  for (const k of Object.keys(doc)) {
+    if (!ALLOWED.has(k)) { delete doc[k]; fixes.push('drop:' + k); }
+  }
+  if (doc.skinManifestVersion !== 2) { doc.skinManifestVersion = 2; fixes.push('v2'); }
+  const idOk = (v) => typeof v === 'string' && /^[a-z][a-z0-9-]{0,31}$/.test(v);
+  const wantId = idOk(doc.id) ? doc.id : (idOk(base.id) ? base.id : safeSlugId(base.slug || base.id || 'skin'));
+  if (doc.id !== wantId) { doc.id = wantId; fixes.push('id'); }
+  const str = (v) => (typeof v === 'string' && v.trim() ? v.trim() : '');
+  const name = str(doc.name) || str(base.title) || wantId;
+  if (doc.name !== name) { doc.name = name; fixes.push('name'); }
+  const nameEn = str(doc.nameEn) || name;
+  if (doc.nameEn !== nameEn) { doc.nameEn = nameEn; fixes.push('nameEn'); }
+  const author = str(doc.author) || 'folia';
+  if (doc.author !== author) { doc.author = author; fixes.push('author'); }
+  const ver = typeof doc.version === 'string' && /^\d+\.\d+\.\d+/.test(doc.version) ? doc.version : '0.1.0';
+  if (doc.version !== ver) { doc.version = ver; fixes.push('version'); }
+  if (!doc.contributes || typeof doc.contributes !== 'object' || Array.isArray(doc.contributes)) {
+    doc.contributes = {};
+    fixes.push('contributes');
+  }
+  const cssPath = str(doc.contributes.stylesheet);
+  const cssExists = cssPath && (() => { try { return statSync(join(dir, cssPath)).isFile(); } catch { return false; } })();
+  if (!cssExists) {
+    let pick = '';
+    try {
+      pick = readdirSync(dir).find((n) => n.toLowerCase().endsWith('.css') && statSync(join(dir, n)).isFile()) || '';
+    } catch { pick = ''; }
+    if (pick) { doc.contributes.stylesheet = pick; fixes.push('stylesheet'); }
+    else { delete doc.contributes.stylesheet; fixes.push('stylesheet-missing'); }
+  }
+  if (doc.accent !== undefined && !/^#[0-9a-fA-F]{6}$/.test(String(doc.accent))) { delete doc.accent; fixes.push('accent'); }
+  const after = JSON.stringify(doc);
+  if (after !== before) {
+    try { writeFileSync(manifestPath + '.orig', before, 'utf8'); } catch { /* 保留原文件失败不影响规范化 */ }
+    writeFileSync(manifestPath, JSON.stringify(doc, null, 2) + '\n', 'utf8');
+    return { changed: true, fixes };
+  }
+  return { changed: false, fixes };
+}
+
+/** 由任意字符串造一个合法 skin id（首字符必须是字母）。 */
+function safeSlugId(raw) {
+  const s = String(raw || '').toLowerCase().replace(/[^a-z0-9-]+/g, '-').replace(/-+/g, '-').replace(/^-|-$/g, '').slice(0, 32);
+  if (/^[a-z][a-z0-9-]{0,31}$/.test(s)) return s;
+  return ('skin-' + s).replace(/[^a-z0-9-]/g, '-').slice(0, 32) || 'skin';
+}
+
 function readJsonBody(req, limit = 64 * 1024) {
   return new Promise((resolve) => {
     let acc = '';
@@ -407,11 +492,15 @@ export function registerSkinsRoutes(webServer, c) {
       // 就被标成「皮肤中心未收录」，而打开它的设置页却是有的 —— 一次假红。
       // 所以对账分两拍：先按缓存比，**出现"未收录"就强制重拉一次**再定论。
       const hostHeader = req.headers && req.headers.host;
-      let catalog = skinCenter === 'present' ? await fetchSkinCenterCatalog(hostHeader, force) : null;
-      let installed = annotateCatalog(installedBase, catalog);
+      let snap = skinCenter === 'present' ? await fetchSkinCenterCatalog(hostHeader, force) : { map: null, diag: null };
+      let catalog = snap.map;
+      let diag = snap.diag;
+      let installed = annotateCatalog(installedBase, catalog, diag);
       if (catalog && installed.some((s) => s.inCatalog === false)) {
-        catalog = await fetchSkinCenterCatalog(hostHeader, true);
-        installed = annotateCatalog(installedBase, catalog);
+        snap = await fetchSkinCenterCatalog(hostHeader, true);
+        catalog = snap.map;
+        diag = snap.diag;
+        installed = annotateCatalog(installedBase, catalog, diag);
       }
       // ⚠️ 站点 slug 与本机皮肤 id **不总是同一个字符串**：站点上 slug 是全站唯一的，
       // 撞名时上传工具会加 `skin-` 前缀（实测 blue-throated-bee-eater 同时是桌宠 id）。
@@ -487,8 +576,16 @@ export function registerSkinsRoutes(webServer, c) {
       if (!manifestEntry) { sendJson(res, 422, { ok: false, error: 'no-skin-json' }); return; }
       let manifest;
       try { manifest = JSON.parse(manifestEntry.data.toString('utf8')); } catch { sendJson(res, 422, { ok: false, error: 'bad-skin-json' }); return; }
-      // 目录名以 skin.json 的 id 为准（不信任 URL/调用方给的名字）。
-      const skinId = safeSkinId(manifest && manifest.id) || hinted;
+      // 目录名必须**同时**满足：安全（不越界）与皮肤中心的 id 规则（`^[a-z][a-z0-9-]{0,31}$`，
+      // 且等于目录名）。旧实现只用 safeSkinId（允许大写/下划线/点），于是 `My_Skin` 这种 id
+      // 会建出同名目录，而皮肤中心按严格规则把它整套排除 —— "装了但列表里没有"。
+      // 现在统一走 safeSlugId：合法就原样，不合法就规范化成合法 id。
+      const skinId = (() => {
+        const raw = String((manifest && manifest.id) || '');
+        if (raw && /^[a-z][a-z0-9-]{0,31}$/.test(raw)) return raw;
+        const fromManifest = raw && safeSkinId(raw);
+        return safeSlugId(fromManifest || hinted || 'skin');
+      })();
       if (!skinId) { sendJson(res, 422, { ok: false, error: 'bad-skin-id' }); return; }
       const dir = resolveInside(root, skinId);
       if (!dir) { sendJson(res, 400, { ok: false, error: 'unsafe-id' }); return; }
@@ -511,12 +608,20 @@ export function registerSkinsRoutes(webServer, c) {
           writeFileSync(target, e.data);
           written += 1;
         }
+        // **规范化清单**：皮肤中心对 skin.json 有硬规则（id 必须 `^[a-z][a-z0-9-]{0,31}$`
+        // 且等于目录名、必须 v2、name/nameEn/author/version 齐全、stylesheet 必须是存在的相对路径、
+        // **不允许未知顶层键**）。站点上的包来自不同来源，常常缺字段或带 v1 键 ⇒ 它直接把整套
+        // 皮肤排除在 catalog 之外，表现为"能装、装完不在皮肤中心的列表里、点了也不生效"。
+        // 这里按它的规则把清单补齐/裁掉多余键，落地成它一定收的样子（原文件留在 skin.json.orig）。
+        const fixed = normalizeSkinManifest(join(dir, 'skin.json'), { id: skinId, slug: hinted, title: String(manifest.title || manifest.name || '') });
         const check = JSON.parse(readFileSync(join(dir, 'skin.json'), 'utf8'));
         if (!check || !check.id) throw new Error('manifest lost after write');
         sendJson(res, 200, {
           ok: true,
           id: skinId,
           name: String(check.name || check.nameEn || skinId),
+          manifestFixed: fixed.changed,
+          manifestFixes: fixed.fixes,
           dir,
           written,
           skipped,
@@ -590,6 +695,31 @@ export function registerSkinsRoutes(webServer, c) {
     return out;
   }
 
+  /* ③b 修复清单：把**已经装在盘上**但不符合皮肤中心规则的 skin.json 就地规范化。
+   *
+   * 为什么需要它：安装路径已经会规范化（见 normalizeSkinManifest），但用户在此之前装的、
+   * 或从别处拷进来的皮肤仍然可能带着 v1 键/缺字段 ⇒ 皮肤中心整套排除、点了不生效。
+   * 让用户能就地修一次，比让他卸载重装更符合"别让他替我擦屁股"的原则。
+   */
+  disposers.push(webServer.register({
+    kind: 'exact',
+    path: `${base}/skins/repair`,
+    handler: async (req, res) => {
+      if ((req.method || 'GET').toUpperCase() !== 'POST') { sendJson(res, 405, { ok: false, error: 'method-not-allowed' }); return; }
+      const body = await readJsonBody(req);
+      const id = safeSkinId(body && body.id);
+      if (!id) { sendJson(res, 400, { ok: false, error: 'bad-id' }); return; }
+      const dir = resolveInside(skinsRoot(), id);
+      if (!dir) { sendJson(res, 400, { ok: false, error: 'unsafe-id' }); return; }
+      const manifestPath = join(dir, 'skin.json');
+      if (!existsSync(manifestPath)) { sendJson(res, 404, { ok: false, error: 'not-installed' }); return; }
+      let title = '';
+      try { const m = JSON.parse(readFileSync(manifestPath, 'utf8')); title = String(m.title || m.name || ''); } catch { /* 交给规范化去兜 */ }
+      const fixed = normalizeSkinManifest(manifestPath, { id, slug: id, title });
+      sendJson(res, 200, { ok: true, id, changed: fixed.changed, fixes: fixed.fixes });
+    },
+  }));
+
   disposers.push(webServer.register({
     kind: 'exact',
     path: `${base}/skins/activate`,

package/package.json

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