dsh-folia 3.2.0 → 3.4.0

package/cordis.patch.yml

@@ -18,3 +18,21 @@
 - insert:
     - id: folia
       name: 'dsh-folia'
+
+# ── 内嵌皮肤中心（3.4.0 起）────────────────────────────────────────────────────
+# 皮肤的**渲染**由皮肤中心负责：catalog、强制作用域化 CSS、六层装饰、hooks 运行时、
+# 背景媒体、以及它自己的「设置 → 皮肤」页面（试穿 / 应用）。它的控制器不外露，所以
+# "完整应用"只能由它自己的前端半区完成 —— 而 DSH 是**按行派发前端模块**的，
+# 因此必须在这里给它一行，否则只有宿主路由、没有界面。
+#
+# 依赖已在 package.json 里声明（@linxin666/dsh-client-ui-skin-center），
+# 所以用户装本插件就自动带上，不需要单独安装。
+#
+# ⚠️ 如果另一个 bundle 也挂了同一个包（典型：@linxin666/dsh-web-all 的
+#     `web-ui-skin-center` 行），就会**重复挂载**。此时请二选一：
+#       · 保留本行，把 dsh-web-all 里的 web-ui-skin-center 关掉；或
+#       · 把本行标成 `disabled: true`
+#    本插件会在「皮肤包」页签顶部把这个冲突**显式报出来**，不会静默。
+- insert:
+    - id: folia-skin-center
+      name: '@linxin666/dsh-client-ui-skin-center'

package/lib/client.js

@@ -16629,6 +16629,8 @@ window.__ModuleLoader__.load({
 				  const [harnessFound, setHarnessFound] = React.useState(true);
 				  // 皮肤中心是否在台：决定"应用"这一步交给谁（见文件头那段分工说明）
 				  const [skinCenter, setSkinCenter] = React.useState(false);
+				  // 谁提供了皮肤中心行（用于检测重复挂载，见下方警示块）
+				  const [providers, setProviders] = React.useState([]);
 				  const [busy, setBusy] = React.useState("");       // 正在安装 / 激活的那个 id
 				  const [note, setNote] = React.useState(null);      // 一次性提示（成功 / 失败原因）
 				  const [q, setQ] = React.useState("");
@@ -16648,6 +16650,7 @@ window.__ModuleLoader__.load({
 				      setError((r && r.error) || (resp && resp.error) || null);
 				      setHarnessFound(!r || r.harnessFound !== false);
 				      setSkinCenter(Boolean(r && r.skinCenter));
+				      setProviders(Array.isArray(r && r.skinCenterProviders) ? r.skinCenterProviders : []);
 				    } catch (e) {
 				      setError("network");
 				      setList([]);
@@ -16784,6 +16787,23 @@ window.__ModuleLoader__.load({
 				    }, loading ? weT("加载中…") : weT("刷新")),
 				  );
 
+				  // ── 重复挂载警示（内嵌皮肤中心的副作用）────────────────────────────────────
+				  // 我们的 patch 加了一行 folia-skin-center；如果用户还装着 dsh-web-all，它那行
+				  // web-ui-skin-center 指向同一个包 ⇒ 同一个插件挂两次。DSH 不拦这种事，所以必须
+				  // 在界面上说清楚"去关掉一处"，而不是让用户去猜为什么皮肤行为怪。
+				  if (providers.length > 1) {
+				    children.push(React.createElement("div", {
+				      key: "dup",
+				      className: "we-picker__hint",
+				      style: {
+				        margin: "4px 0 10px", padding: "7px 10px", borderRadius: "8px",
+				        background: "rgba(255,120,120,0.14)", color: "#ff9a9a", lineHeight: 1.5,
+				      },
+				    }, weT("⚠️ 检测到 ") + providers.length + weT(" 处挂载了皮肤中心（")
+				      + providers.map((p) => p.bundle).join(" / ")
+				      + weT("）。请只保留一处：把 dsh-web-all 里的皮肤中心行关掉，或在插件管理里停用其一，否则会重复挂载。")));
+				  }
+
 				  // 分工提示：皮肤中心在台 ⇒ 我们只做"选"，应用由它的设置页完成（原生路径，完整）。
 				  // 不在台 ⇒ 明说我们在兜底，避免用户以为"点了却坏了"。
 				  if (list.length > 0) {

package/lib/index.js

@@ -94,7 +94,7 @@ import { registerPropsRoutes } from './routes/props.js';
 import { registerLiveFrameRoutes } from './routes/live-frame.js';
 import { registerSettingsRoutes } from './routes/settings.js';
 import { registerCacheDirRoutes } from './routes/cache-dir.js';
-import { registerSkinRoutes } from './routes/skins.js';
+import { registerSkinRoutes, harnessRoot as foliaHarnessRoot } from './routes/skins.js';
 // C8′/C6 出户的组件行（P2-1 / P2-2）：组件入口**静态** import（不是动态）—— `test/verify-reachability.mjs`
 // 只从 ENTRY 沿 import 边走，动态加载的组件入口会被判定为不可达，棘轮当场变红。
 // 组件名 → 实现表的登记在 `applyComponent` **函数体内**（P2-1b 起；模块级常量会让门面求值期
@@ -504,6 +504,13 @@ export function apply(ctx) {
     disposers, base: BASE, log,
   });
 
+  // 皮肤中心自动挂载（可选，默认关闭）。它是标准 cordis 插件（name / inject / apply），
+  // 所以能被动态挂上 —— 用户不必再装 @linxin666/dsh-web-all 才有皮肤渲染能力。
+  // 默认关闭的原因：DSH 对"同一插件挂两次"没有保护，我们踩过（重复行 → 安全模式）。
+  try { maybeMountSkinCenter(ctx, log); } catch (err) {
+    try { log('[folia] 皮肤中心自动挂载失败（忽略）：' + (err && err.message ? err.message : err)); } catch { /* ignore */ }
+  }
+
   // fiber disposer 的语义（先逐个 disposer、再 releaseKernelLease(hostKernel)——内核引用计数
   // 归零才 `transcodeKit.dispose()`——再 destroy 在途流、清 activeStreams / mediaMap）
   // 逐字搬进 lib/kernel/host-session.js 的 `dispose()`。
@@ -587,6 +594,72 @@ function componentProbe() {
  * —— 那条纪律写在组件入口文件头，并由 `test/verify-bundle-rows.mjs` 的判据钉住；彻底解耦（拆环）
  * 留给 P2-2b。
  */
+/**
+ * 是否已经有别的 bundle 把皮肤中心挂上了（默认假设"有"，避免重复挂载）。
+ *
+ * 判据落在磁盘上的 patch 行：从 harness 根出发，扫每个 profile 的 package.json
+ * dsh.profile.bundles，把每个 bundle 包的 cordis.patch.yml 读出来，看有没有行指向
+ * @linxin666/dsh-client-ui-skin-center。有 ⇒ 别人挂了，我们不插手。
+ * 读不到 / 结构不认识 ⇒ 同样按"已挂载"处理（宁可少挂一次，也不能挂两次）。
+ */
+function skinCenterPatchedElsewhere(harnessRoot) {
+  try {
+    const { readdirSync, readFileSync, existsSync } = require('node:fs');
+    const { join } = require('node:path');
+    const profilesDir = join(harnessRoot, 'profiles');
+    if (!existsSync(profilesDir)) return true;
+    const SKIN_CENTER = '@linxin666/dsh-client-ui-skin-center';
+    for (const name of readdirSync(profilesDir)) {
+      if (name.startsWith('.')) continue;
+      const pkgPath = join(profilesDir, name, 'package.json');
+      if (!existsSync(pkgPath)) continue;
+      let prof;
+      try { prof = JSON.parse(readFileSync(pkgPath, 'utf8')); } catch { continue; }
+      const bundles = (prof && prof.dsh && prof.dsh.profile && prof.dsh.profile.bundles) || [];
+      for (const b of bundles) {
+        const patchPath = join(profilesDir, name, 'node_modules', b, 'cordis.patch.yml');
+        if (!existsSync(patchPath)) continue;
+        let text = '';
+        try { text = readFileSync(patchPath, 'utf8'); } catch { continue; }
+        if (text.includes(SKIN_CENTER)) return true;
+      }
+    }
+    return false;
+  } catch {
+    return true;
+  }
+}
+
+/**
+ * 按需动态挂载皮肤中心。默认关闭，用 DSH_FOLIA_MOUNT_SKIN_CENTER=1 开启。
+ * 开启后仍先查"别人挂了吗"，已挂则跳过 —— 重复挂载是能让 DSH 起不来的事故。
+ */
+function maybeMountSkinCenter(ctx, log) {
+  const flag = String(process.env.DSH_FOLIA_MOUNT_SKIN_CENTER || '').trim().toLowerCase();
+  if (flag !== '1' && flag !== 'on' && flag !== 'true') return;
+
+  const harness = (() => { try { return foliaHarnessRoot(); } catch { return null; } })();
+  if (!harness) {
+    try { log('[folia] 皮肤中心自动挂载跳过：找不到 harness 根目录'); } catch { /* ignore */ }
+    return;
+  }
+  if (skinCenterPatchedElsewhere(harness)) {
+    try { log('[folia] 皮肤中心已由其它 bundle 挂载，跳过自动挂载'); } catch { /* ignore */ }
+    return;
+  }
+  import('@linxin666/dsh-client-ui-skin-center').then((mod) => {
+    try {
+      if (!mod || typeof mod.apply !== 'function') { log('[folia] 皮肤中心模块形态不对，跳过'); return; }
+      ctx.plugin(mod);
+      log('[folia] 已自动挂载皮肤中心（DSH_FOLIA_MOUNT_SKIN_CENTER=1）');
+    } catch (err) {
+      try { log('[folia] 自动挂载皮肤中心失败：' + (err && err.message ? err.message : err)); } catch { /* ignore */ }
+    }
+  }).catch((err) => {
+    try { log('[folia] 找不到皮肤中心（可选依赖），跳过：' + (err && err.message ? err.message : err)); } catch { /* ignore */ }
+  });
+}
+
 export function applyComponent(root, rawConfig, component) {
   const impls = componentImpls();
   const impl = impls.get(component);

package/lib/routes/skins.js

@@ -114,6 +114,47 @@ export function harnessRoot() {
 
 /* ── 索引 ────────────────────────────────────────────────────────────────── */
 
+/**
+ * 列出**所有**提供了皮肤中心行的 bundle（跨 profile 扫 patch 文件）。
+ *
+ * 为什么必须报出来：我们在自己的 patch 里加了一行内嵌皮肤中心（folia-skin-center）。
+ * 如果用户同时还装着 @linxin666/dsh-web-all，它的 patch 里也有一行（web-ui-skin-center）
+ * 指向同一个包 ⇒ 同一个插件被挂两次。这种事要显式告诉用户去关掉一处，不能静默。
+ */
+function skinCenterProviders() {
+  const out = [];
+  try {
+    const harness = harnessRoot();
+    if (!harness) return out;
+    const profilesDir = join(harness, 'profiles');
+    if (!existsSync(profilesDir)) return out;
+    const SKIN_CENTER = '@linxin666/dsh-client-ui-skin-center';
+    for (const prof of readdirSync(profilesDir)) {
+      if (prof.startsWith('.')) continue;
+      const pkgPath = join(profilesDir, prof, 'package.json');
+      if (!existsSync(pkgPath)) continue;
+      let doc;
+      try { doc = JSON.parse(readFileSync(pkgPath, 'utf8')); } catch { continue; }
+      const bundles = (doc && doc.dsh && doc.dsh.profile && doc.dsh.profile.bundles) || [];
+      for (const b of bundles) {
+        const patchPath = join(profilesDir, prof, 'node_modules', b, 'cordis.patch.yml');
+        if (!existsSync(patchPath)) continue;
+        let text;
+        try { text = readFileSync(patchPath, 'utf8'); } catch { continue; }
+        if (!text.includes(SKIN_CENTER)) continue;
+        const ids = [];
+        const re = /-\s*id:\s*([A-Za-z0-9_-]+)\s*\n\s*name:\s*'([^']+)'/g;
+        let m;
+        while ((m = re.exec(text)) !== null) {
+          if (m[2].includes('dsh-client-ui-skin-center')) ids.push(m[1]);
+        }
+        if (ids.length) out.push({ profile: prof, bundle: b, rows: ids });
+      }
+    }
+  } catch { /* 扫描失败只是少一条提示，不影响功能 */ }
+  return out;
+}
+
 /**
  * 拉站点索引并**精简**成客户端要的形状。永不抛；失败返回 `{ items: [], error }`。
  *
@@ -371,6 +412,7 @@ export function registerSkinRoutes(webServer, c) {
         site: skinsSiteBase(),
         harness,
         harnessFound: Boolean(harness),
+        skinCenterProviders: skinCenterProviders(),
         skinCenter: await skinCenterMounted(
           'http://' + ((req && req.headers && req.headers.host) || '127.0.0.1'),
           (() => {

package/package.json

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