dsh-folia 4.10.0 → 4.10.1

package/lib/client.js

@@ -801,6 +801,13 @@ window.__ModuleLoader__.load({
 				  "下载地址不在白名单里": "The download host is not allow-listed",
 				  "站点被关闭了（DSH_FOLIA_SITE=off）": "The site is disabled (DSH_FOLIA_SITE=off)",
 				  "这个文件不是 zip": "This file is not a zip",
+
+				  // ── 助手皮肤：皮肤中心缺失时的引导（4.10.1）──────────────────────────
+				  "皮肤中心没装：它是**独立插件** @linxin666/dsh-client-ui-skin-center（不在 dsh-web-all 里，那个只是聚合包）。装它才能启用皮肤：": "The skin centre is not installed: it is its own plugin, @linxin666/dsh-client-ui-skin-center (dsh-web-all is only an aggregate). Install it to enable skins:",
+				  "已复制安装命令": "Install command copied",
+				  "复制失败，请手动选中上面的命令": "Copy failed — select the command above manually",
+				  "复制命令": "Copy command",
+				  "先装皮肤中心，否则皮肤装好也没法启用": "Install the skin centre first, or the skin cannot be enabled",
 				};
 
 				// ── 内联模块：src/i18n-copy-picker.js —— 英文词表域：壁纸选择器与快捷面板（picker-* · quick-panel · sidebar-right · theme-follow）（构建期注入；勿手改本段）──
@@ -18343,11 +18350,33 @@ window.__ModuleLoader__.load({
 				    }, weT("刷新")),
 				  ));
 
-				  children.push(React.createElement("div", {
-				    key: "hint",
-				    className: "we-picker__hint",
-				    style: { margin: "6px 0 4px", opacity: 0.8 },
-				  }, weT("皮肤包安装到皮肤中心目录；装完到「设置 → 皮肤中心」里点选即可启用。皮肤中心与本插件读同一个目录，无需重启。")));
+				  // 皮肤中心在不在，决定这段提示说什么：
+				  //   在   → "装完去皮肤中心点它"（本页签只负责落盘）
+				  //   不在 → 明说它是个**独立插件**（不在 dsh-web-all 里），给一条可复制的安装命令
+				  //   unknown（探测失败）→ 保守地按"在"讲，不吓唬用户
+				  const skinCenter = (state && state.skinCenter) || "unknown";
+				  if (skinCenter === "absent") {
+				    children.push(React.createElement("div", {
+				      key: "hint-absent",
+				      className: "we-picker__hint",
+				      style: { margin: "6px 0 4px", color: "#ffd08a", lineHeight: "1.6" },
+				    }, weT("皮肤中心没装：它是**独立插件** @linxin666/dsh-client-ui-skin-center（不在 dsh-web-all 里，那个只是聚合包）。装它才能启用皮肤：")));
+				    children.push(React.createElement("div", { key: "cmd", style: { display: "flex", gap: "8px", alignItems: "center", margin: "0 0 6px" } },
+				      React.createElement("code", {
+				        style: { fontSize: "11px", padding: "3px 8px", borderRadius: "6px", background: "rgba(255,255,255,0.08)" },
+				      }, "dsh plugin --profile web add @linxin666/dsh-client-ui-skin-center"),
+				      React.createElement("button", {
+				        className: "we-picker__btn", type: "button",
+				        onClick: () => { try { navigator.clipboard.writeText("dsh plugin --profile web add @linxin666/dsh-client-ui-skin-center"); setNote({ ok: true, text: weT("已复制安装命令") }); } catch { setNote({ ok: false, text: weT("复制失败，请手动选中上面的命令") }); } },
+				      }, weT("复制命令")),
+				    ));
+				  } else {
+				    children.push(React.createElement("div", {
+				      key: "hint",
+				      className: "we-picker__hint",
+				      style: { margin: "6px 0 4px", opacity: 0.8 },
+				    }, weT("皮肤包安装到皮肤中心目录；装完到「设置 → 皮肤中心」里点选即可启用。皮肤中心与本插件读同一个目录，无需重启。")));
+				  }
 
 				  // 提示行常驻占位（与开机动画/桌宠页签同一条纪律：不因 note 出现/消失让面板跳高度）
 				  children.push(React.createElement("div", {
@@ -18405,6 +18434,7 @@ window.__ModuleLoader__.load({
 				            : React.createElement("button", {
 				              className: "we-picker__btn", type: "button",
 				              disabled: Boolean(busy),
+				              title: skinCenter === "absent" ? weT("先装皮肤中心，否则皮肤装好也没法启用") : undefined,
 				              onClick: () => act("install", { id: s.id, url: s.url }, s.title),
 				            }, busyThis ? weT("安装中…") : weT("安装")),
 				        );

package/lib/routes/skins.js

@@ -49,6 +49,30 @@ function siteBase() {
   return base.replace(/\/+$/, '');
 }
 
+/**
+ * 皮肤中心是否在线。
+ *
+ * 为什么由宿主探而不是前端探：两个插件跑在同一个 webServer 上，用请求自带的 Host 就能问到自己 —— 
+ * 前端也能问，但宿主这一侧拿到的结果与"装没装"一一对应，而且不受浏览器缓存/跨源策略影响。
+ * 判据用**它自己的 catalog 路由**：该路由不需要鉴权（实测 200），404 就是没装。
+ */
+const skinCenterProbe = { at: 0, state: 'unknown' };
+async function probeSkinCenter(hostHeader, force) {
+  const now = Date.now();
+  if (!force && skinCenterProbe.at && now - skinCenterProbe.at < 30000) return skinCenterProbe.state;
+  let state = 'unknown';
+  if (hostHeader) {
+    try {
+      const r = await fetch('http://' + hostHeader + '/api/skin-center/v2/catalog', { signal: AbortSignal.timeout(4000) });
+      state = r.status === 404 ? 'absent' : (r.ok ? 'present' : 'present');
+      // 401/403 也说明插件在（只是该路由被别的版本加了鉴权）；只有 404 才代表没装。
+    } catch { state = 'unknown'; }
+  }
+  skinCenterProbe.at = now;
+  skinCenterProbe.state = state;
+  return state;
+}
+
 /** 站点列表缓存（30 秒）：面板打开与"刷新"共用，避免每次都打站点。 */
 const siteCache = { at: 0, items: [], error: null };
 const SITE_TTL_MS = 30000;
@@ -238,6 +262,7 @@ export function registerSkinsRoutes(webServer, c) {
       const force = /[?&]refresh=1/.test(req.url || '');
       const site = await fetchSiteSkins(force);
       const installed = listInstalled();
+      const skinCenter = await probeSkinCenter(req.headers && req.headers.host, force);
       // ⚠️ 站点 slug 与本机皮肤 id **不总是同一个字符串**：站点上 slug 是全站唯一的，
       // 撞名时上传工具会加 `skin-` 前缀（实测 blue-throated-bee-eater 同时是桌宠 id）。
       // 所以比对要归一：两边都去掉可选的 `skin-` 前缀再比，否则会显示成"未安装"。
@@ -248,6 +273,7 @@ export function registerSkinsRoutes(webServer, c) {
       }
       sendJson(res, 200, {
         ok: true,
+        skinCenter,
         siteBase: siteBase(),
         siteError: site.error,
         installed,

package/package.json

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