dsh-folia 2.4.1 → 2.4.4

package/lib/client.js

@@ -16244,10 +16244,15 @@ window.__ModuleLoader__.load({
 				    setLoading(true);
 				    setError(null);
 				    try {
-				      const r = await apiJson("/skins" + (force ? "?refresh=1" : ""));
+				      // ⚠️ `apiJson` 返回的是 **`{ ok, status, data, error }` 包装对象**，不是响应体本身
+				      //（见 src/api-client.js 的 apiFetch）。最初按裸体取值 ⇒ `list=[] 且 error=null`，
+				      // 界面显示"没有匹配的皮肤包"却没有任何错误提示 —— 静默空列表比报错难查得多。
+				      // `parse: "always"` 让非 2xx 的 `{error}` 也能被读到。
+				      const resp = await apiJson("/skins" + (force ? "?refresh=1" : ""), { parse: "always" });
+				      const r = (resp && resp.data) || null;
 				      setList((r && r.skins) || []);
 				      setActive((r && r.active) || null);
-				      setError((r && r.error) || null);
+				      setError((r && r.error) || (resp && resp.error) || null);
 				      setHarnessFound(!r || r.harnessFound !== false);
 				    } catch (e) {
 				      setError("network");
@@ -16259,20 +16264,43 @@ window.__ModuleLoader__.load({
 
 				  React.useEffect(() => { load(false); }, [load]);
 
+				  /**
+				   * 执行一个动作（install / activate / remove）。
+				   *
+				   * ⚠️ **「使用」必须立刻有反馈**：切换皮肤只写 `skin-center-active.json`，host 端 6 ms 就应，
+				   * 而皮肤要重启才生效 —— 如果等一次 `?refresh=1`（约 600 ms）再改标记，用户看到的就是
+				   * "点了一下，半天没反应"。所以「使用」走**乐观更新**：先本地翻转 active 并把提示打出来，
+				   * 请求失败再回滚重拉。装 / 删仍然要重拉（已装标记与体积都变了）。
+				   */
 				  async function act(kind, id, label) {
 				    if (busy) return;
 				    setBusy(id);
 				    setNote(null);
+				    const prevActive = active;
+				    if (kind === "activate") {
+				      // 乐观：先给反馈，再等网络
+				      setActive(id);
+				      setList((prev) => prev.map((x) => ({ ...x, active: x.id === id })));
+				      setNote({ kind: "ok", text: weT("正在切换到「") + label + weT("」…") });
+				    }
 				    try {
-				      const r = await apiPostJson("/skins/" + kind, { id });
-				      if (r && r.ok) {
+				      // 同样是包装对象：`ok` 是 HTTP 2xx，业务结论在 `data.ok`（宿主回 `{ok:false,error}`）。
+				      const resp = await apiPostJson("/skins/" + kind, { id }, { parse: "always" });
+				      const r = (resp && resp.data) || null;
+				      if (resp && resp.ok && r && r.ok) {
 				        if (kind === "install") {
 				          setNote({ kind: "ok", text: weT("已安装：") + label });
 				          await load(true);
 				        } else if (kind === "activate") {
-				          setActive(id);
-				          setNote({ kind: "ok", text: weT("已切换到「") + label + weT("」，重启 DSH 后生效") });
-				          await load(true);
+				          setNote({
+				            kind: "ok",
+				            text: weT("已切换到「") + label + weT("」"),
+				            // 皮肤中心是在**页面启动时**拉 `/api/skin-center/v2/active` 再注入样式的，
+				            // 所以"换皮肤"只需刷新这一页（不重启 DSH 进程）：下面的按钮就做这件事。
+				            // 不自动刷：用户可能正在输入，突然刷新会打断。
+				            reload: true,
+				          });
+				          // 不再整表重拉：本地标记已经对了，省掉那 600 ms 的"没反应"窗口。
 				        } else if (kind === "remove") {
 				          setNote({ kind: "ok", text: weT("已删除：") + label });
 				          await load(true);
@@ -16281,9 +16309,18 @@ window.__ModuleLoader__.load({
 				        const code = (r && r.error) || "failed";
 				        const detail = (r && r.detail) ? "（" + r.detail + "）" : "";
 				        setNote({ kind: "err", text: weT("操作失败：") + code + detail });
+				        if (kind === "activate") {
+				          // 回滚乐观更新
+				          setActive(prevActive);
+				          setList((prev) => prev.map((x) => ({ ...x, active: x.id === prevActive })));
+				        }
 				      }
 				    } catch (e) {
 				      setNote({ kind: "err", text: weT("请求失败：") + (e && e.message ? e.message : weT("网络错误")) });
+				      if (kind === "activate") {
+				        setActive(prevActive);
+				        setList((prev) => prev.map((x) => ({ ...x, active: x.id === prevActive })));
+				      }
 				    } finally {
 				      setBusy("");
 				    }
@@ -16320,6 +16357,22 @@ window.__ModuleLoader__.load({
 				  }
 
 				  const children = [React.createElement("div", { className: "we-picker__section", key: "sec" }, header)];
+				  // 常驻一行「当前皮肤」：切换只写文件、皮肤要重启才生效，不给这一行用户就无从判断
+				  // 刚才那次点击到底成没成（这是"点了没反应"的一半原因）。
+				  if (active) {
+				    const activeName = (list.find((x) => x.id === active) || {}).name || active;
+				    children.push(React.createElement("div", {
+				      key: "active",
+				      className: "we-picker__hint",
+				      style: { margin: "4px 0 8px", display: "flex", gap: "8px", alignItems: "center", flexWrap: "wrap" },
+				    },
+				    React.createElement("span", null, weT("当前皮肤：") + activeName),
+				    React.createElement("span", {
+				      style: { fontSize: "11px", padding: "1px 6px", borderRadius: "999px", background: "rgba(142,230,168,0.16)", color: "#8ee6a8" },
+				    }, weT("重启 DSH 生效")),
+				    ));
+				  }
+
 				  if (error) {
 				    children.push(React.createElement("div", {
 				      key: "err",
@@ -16331,8 +16384,29 @@ window.__ModuleLoader__.load({
 				    children.push(React.createElement("div", {
 				      key: "note",
 				      className: "we-picker__hint",
-				      style: { color: note.kind === "err" ? "#ff9a9a" : "#8ee6a8", margin: "6px 0 10px" },
-				    }, note.text));
+				      style: {
+				        color: note.kind === "err" ? "#ff9a9a" : "#8ee6a8",
+				        margin: "6px 0 10px",
+				        display: "flex",
+				        gap: "10px",
+				        alignItems: "center",
+				        flexWrap: "wrap",
+				      },
+				    },
+				    React.createElement("span", null, note.text),
+				    note.reload
+				      ? React.createElement("button", {
+				        type: "button",
+				        className: "we-picker__btn we-picker__btn--primary",
+				        style: { fontSize: "11.5px", padding: "3px 10px" },
+				        onClick: () => {
+				          // 只刷新这个前端页面（皮肤中心启动时重新拉 active），不必重启 DSH 进程。
+				          try { window.location.reload(); } catch { /* 极端环境刷不动就留着让用户手动重启 */ }
+				        },
+				        title: weT("重新加载界面以应用新皮肤（对话与设置都在宿主侧，不会丢）"),
+				      }, weT("立即生效"))
+				      : null,
+				    ));
 				  }
 				  children.push(React.createElement("div", {
 				    key: "search",
@@ -17332,6 +17406,9 @@ window.__ModuleLoader__.load({
 				  // 两页，外加壁纸页。
 				  const QP_TABS = [
 				    { id: "wallpaper", get label() { return weT("壁纸"); } },
+				    // 「皮肤包」与设置页那个页签是**同一个组件**（SkinsTabPanel）：首页这里只是把它挂进抽屉，
+				    // 不另写一份列表逻辑 —— 两份实现迟早会漂移。
+				    { id: "skins", get label() { return weT("皮肤包"); } },
 				    { id: "appearance", get label() { return weT("外观"); } },
 				    { id: "playback", get label() { return weT("播放"); } },
 				  ];
@@ -17977,11 +18054,17 @@ window.__ModuleLoader__.load({
 				          target: "playback",
 				          title: weT("在设置页打开「播放」页签 —— 出图来源 / 实时帧 / 帧率上限在那里"),
 				        }
-				        : {
-				          label: weT("壁纸引擎设置 ›"),
-				          target: "",
-				          title: weT("打开设置对话框的「壁纸引擎」分区（外观 / 播放 / 系统与全部配置）"),
-				        };
+				        : qpTab === "skins"
+				          ? {
+				            label: weT("皮肤包设置 ›"),
+				            target: "skins",
+				            title: weT("在设置页打开「皮肤包」页签 —— 下载 / 切换 / 删除皮肤包"),
+				          }
+				          : {
+				            label: weT("壁纸引擎设置 ›"),
+				            target: "",
+				            title: weT("打开设置对话框的「壁纸引擎」分区（外观 / 播放 / 系统与全部配置）"),
+				          };
 
 				    return React.createElement("div", { className: "we-qp we-qp--" + dock },
 				      qpRenderCurrent(sel, current, playbackLive),
@@ -18011,7 +18094,10 @@ window.__ModuleLoader__.load({
 				          })
 				          : qpTab === "playback"
 				            ? qpRenderPlaybackPane(sel, switchQpTab)
-				            : null),
+				            // 皮肤包：直接挂设置页那个同一个组件（它自己管列表/下载/激活状态）。
+				            : qpTab === "skins"
+				              ? React.createElement(SkinsTabPanel, null)
+				              : null),
 				        !(qpTab === "wallpaper" && userPropsPanelOpen() && propsAvailable) && qpTab === "wallpaper" && React.createElement(React.Fragment, null,
 				                // ── 壁纸列表（搜索 + 视图切换 + 快切）──
 				                // 库还没回来 / 扫描失败：**只有这一页**给一句话 —— 外观 / 播放两页不依赖库，

package/package.json

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