dsh-folia 4.3.1 → 4.5.0

package/lib/client.js

@@ -17212,12 +17212,21 @@ window.__ModuleLoader__.load({
 				  const [state, setState] = React.useState(null);
 				  const [busy, setBusy] = React.useState("");
 				  const [note, setNote] = React.useState(null);
+				  const [importable, setImportable] = React.useState([]);
 
 				  const load = React.useCallback(async (force) => {
 				    try {
 				      const resp = await apiJson("/pets/list" + (force ? "?refresh=1" : ""), { parse: "always" });
 				      const doc = (resp && resp.data) || null;
-				      if (resp && resp.ok && doc && doc.ok) setState(doc);
+				      if (resp && resp.ok && doc && doc.ok) {
+				        setState(doc);
+				        // 顺带问一下本机其它宠物插件里有哪些可导入的（失败不影响主列表）。
+				        try {
+				          const im = await apiJson("/pets/importable", { parse: "always" });
+				          const imDoc = (im && im.data) || null;
+				          if (imDoc && imDoc.ok) setImportable(imDoc.pets || []);
+				        } catch { /* 无外部目录是正常情况 */ }
+				      }
 				      else setNote({ ok: false, text: weT("读取失败：") + ((resp && resp.error) || "unknown") });
 				    } catch (e) {
 				      setNote({ ok: false, text: weT("请求失败：") + ((e && e.message) || weT("网络错误")) });
@@ -17235,6 +17244,7 @@ window.__ModuleLoader__.load({
 				      if (resp && resp.ok && r && r.ok) {
 				        if (kind === "install") setNote({ ok: true, text: weT("已安装并启用：") + (label || "") });
 				        if (kind === "remove") setNote({ ok: true, text: weT("已卸载：") + (label || "") });
+				        if (kind === "import") setNote({ ok: true, text: weT("已导入并启用：") + (label || "") });
 				        if (kind === "config") setNote({ ok: true, text: weT("已保存") });
 				        await load(true);
 				      } else {
@@ -17369,6 +17379,26 @@ window.__ModuleLoader__.load({
 				      : React.createElement("div", { className: "we-picker__hint" }, weT("还没有安装任何桌宠 —— 从下面的站点清单里挑一只。")),
 				  ));
 
+				  // 本机其它宠物插件里可导入的（dsh-pet 等下载的宠物就落在 $DSH_HOME/pets）
+				  if (importable.length) {
+				    children.push(React.createElement("div", { key: "impHead", className: "we-picker__section-head", style: { marginTop: "14px" } },
+				      React.createElement("span", { className: "we-picker__section-label" },
+				        weT("本机可导入") + "  ·  " + importable.length),
+				    ));
+				    children.push(React.createElement("div", { key: "imp", style: PET_STYLE.grid },
+				      importable.map((it) => {
+				        const isBusy = busy === "import:" + it.id;
+				        return React.createElement("div", { key: "imp:" + it.id, style: PET_STYLE.card },
+				          React.createElement("div", { style: PET_STYLE.title }, it.name || it.id),
+				          React.createElement("div", { style: PET_STYLE.meta },
+				            weT("来自其它宠物插件 · ") + petFmtBytes(it.bytes)),
+				          React.createElement("div", { style: PET_STYLE.row },
+				            btn(isBusy ? weT("导入中…") : weT("导入"), () => act("import", { id: it.id }, it.name || it.id), Boolean(busy))),
+				        );
+				      }),
+				    ));
+				  }
+
 				  // 站点：未装的可安装
 				  const available = site.filter((s) => !installedIds.has(s.id));
 				  children.push(React.createElement("div", { key: "siteHead", className: "we-picker__section-head", style: { marginTop: "14px" } },
@@ -17430,6 +17460,25 @@ window.__ModuleLoader__.load({
 
 				const PET_LAYER_ID = "we-pet-layer";
 				const PET_ROW = { idle: 0, runRight: 1, runLeft: 2, wave: 3, jump: 4, fail: 5, wait: 6, work: 7, done: 8 };
+				/**
+				 * 行号 → 轨道名的**候选表**。
+				 *
+				 * ⚠️ dsh-pet 的 manifest 用的是 kebab 命名（`running-right` / `waving` / `failed` …），
+				 * 我最初按驼峰（`runRight` / `wave`）去查，结果**一次都没命中** —— 每帧都退回默认 120ms，
+				 * 于是所有动作的节奏都是同一个硬速度，看起来就像"动作不对/没几个动作"。
+				 * 这里按「标准名 → 驼峰别名 → 其它常见写法」依次找，命中即用。
+				 */
+				const PET_TRACK_ALIASES = [
+				  ['idle'],
+				  ['running-right', 'runRight', 'right'],
+				  ['running-left', 'runLeft', 'left'],
+				  ['waving', 'wave'],
+				  ['jumping', 'jump'],
+				  ['failed', 'fail'],
+				  ['waiting', 'wait'],
+				  ['running', 'working', 'work'],
+				  ['review', 'done', 'completed'],
+				];
 				const PET_DEFAULT_FRAME_MS = 120;
 				/**
 				 * 活动检测：DSH 的客户端 `ctx` 只暴露 effect/get/slots/surface，没有会话事件，
@@ -17476,7 +17525,7 @@ window.__ModuleLoader__.load({
 				  return petNow();
 				}
 				/** 两次随机动作之间的间隔范围（毫秒）。 */
-				const PET_IDLE_GAP_MS = [5000, 11000];
+				const PET_IDLE_GAP_MS = [3000, 7000];
 
 				/**
 				 * 声音：包内 `sounds/<事件>.ogg|mp3|wav` 优先（manifest.sounds 显式声明），
@@ -17590,7 +17639,10 @@ window.__ModuleLoader__.load({
 				  let walkSpeed = 0;
 				  /** 走动剩余时长（毫秒）。 */
 				  let walkLeft = 0;
+				  /** 单击轮换到第几号轨道。 */
+				  let clickIdx = 0;
 
+				  let scaleCur = Number(scale) > 0 ? Number(scale) : 1;
 				  const cw = Math.max(1, Number(pet.cell && pet.cell.width) || 192);
 				  const ch = Math.max(1, Number(pet.cell && pet.cell.height) || 208);
 				  const cols = Math.max(1, Number(pet.columns) || 8);
@@ -17600,15 +17652,24 @@ window.__ModuleLoader__.load({
 				    const n = Number(frames[r]);
 				    return Number.isFinite(n) && n > 0 ? Math.min(cols, n) : cols;
 				  }
+				  /** 该行的轨道配置（按别名表找；找不到返回 null）。 */
+				  function trackOf(r) {
+				    const names = PET_TRACK_ALIASES[r] || [];
+				    for (const n of names) {
+				      const tr = pet.tracks && pet.tracks[n];
+				      if (tr && Array.isArray(tr.durations) && tr.durations.length) return tr;
+				    }
+				    return null;
+				  }
 				  function frameMs(r, f) {
-				    const t = pet.tracks && pet.tracks[Object.keys(PET_ROW)[r] === undefined ? "" : Object.keys(PET_ROW)[r]];
-				    const d = t && Array.isArray(t.durations) ? t.durations[f] : null;
+				    const tr = trackOf(r);
+				    const d = tr ? tr.durations[f] : null;
 				    return Number.isFinite(Number(d)) && Number(d) > 0 ? Number(d) : PET_DEFAULT_FRAME_MS;
 				  }
 
 				  function resize() {
-				    const w = Math.round(cw * scale);
-				    const h = Math.round(ch * scale);
+				    const w = Math.round(cw * scaleCur);
+				    const h = Math.round(ch * scaleCur);
 				    const dpr = Math.min(3, Math.max(1, (typeof window !== "undefined" && window.devicePixelRatio) || 1));
 				    canvas.width = Math.round(w * dpr);
 				    canvas.height = Math.round(h * dpr);
@@ -17627,8 +17688,8 @@ window.__ModuleLoader__.load({
 				    const sx = frame * cw;
 				    const sy = row * ch;
 				    try {
-				      ctx.clearRect(0, 0, cw * scale, ch * scale);
-				      ctx.drawImage(img, sx, sy, cw, ch, 0, 0, cw * scale, ch * scale);
+				      ctx.clearRect(0, 0, cw * scaleCur, ch * scaleCur);
+				      ctx.drawImage(img, sx, sy, cw, ch, 0, 0, cw * scaleCur, ch * scaleCur);
 				    } catch { /* 贴图还没解码完：下一帧再画 */ }
 				  }
 
@@ -17734,10 +17795,10 @@ window.__ModuleLoader__.load({
 				      const maxX = Math.max(0, (window.innerWidth || 1920) - layerEl.offsetWidth);
 				      if ((dir > 0 && p0.left >= maxX - 2) || (dir < 0 && p0.left <= 2)) {
 				        setRow(dir > 0 ? PET_ROW.runLeft : PET_ROW.runRight);
-				        walkSpeed = -dir * (0.9 * scale);
+				        walkSpeed = -dir * (0.9 * scaleCur);
 				      } else {
 				        setRow(dir > 0 ? PET_ROW.runRight : PET_ROW.runLeft);
-				        walkSpeed = dir * (0.9 * scale);
+				        walkSpeed = dir * (0.9 * scaleCur);
 				      }
 				      walkLeft = action.ms;
 				      return;
@@ -17783,14 +17844,101 @@ window.__ModuleLoader__.load({
 				      // 单击 = 挥手（给用户一个"它有反应"的反馈），之后自动回 idle
 				      walkSpeed = 0;
 				      walkLeft = 0;
-				      setRow(PET_ROW.wave);
+				      // 单击 = 演下一个动作（按 9 条轨道轮换），让用户能逐个看到它会什么。
+				      clickIdx = (clickIdx + 1) % PET_TRACK_ALIASES.length;
+				      const nextRow = clickIdx === 0 ? PET_ROW.idle : clickIdx;
+				      setRow(nextRow);
 				      holdUntil = petNow() + 1400;
-				      voice.play("wave");
+				      voice.play(nextRow === PET_ROW.fail ? "fail" : nextRow === PET_ROW.done ? "done" : "wave");
 				    } else {
 				      try { localStorage.setItem("wePetPos", JSON.stringify({ left: layerEl.style.left, top: layerEl.style.top })); } catch { /* ignore */ }
 				    }
 				  }
 
+				  /* ── 右键菜单：换宠物之外的全部互动都在这里 ────────────────────────────
+				   * 为什么自己做：宿主的页签要打开面板才能操作，而"摸它"这件事应该发生在宠物身上。
+				   * 菜单条目 = 9 条动作各一条（点一下立刻试演）+ 声音/大小/复位/隐藏。
+				   */
+				  let menu = null;
+				  function closeMenu() {
+				    if (menu && menu.parentNode) menu.parentNode.removeChild(menu);
+				    menu = null;
+				  }
+				  function buildMenuItem(label, onClick) {
+				    const b = document.createElement("button");
+				    b.type = "button";
+				    b.textContent = label;
+				    b.style.cssText = "display:block;width:100%;padding:6px 10px;background:transparent;border:0;color:inherit;text-align:left;font-size:12px;cursor:pointer;white-space:nowrap";
+				    b.addEventListener("mouseenter", () => { b.style.background = "rgba(255,255,255,0.10)"; });
+				    b.addEventListener("mouseleave", () => { b.style.background = "transparent"; });
+				    b.addEventListener("click", (ev) => { ev.stopPropagation(); onClick(); });
+				    return b;
+				  }
+				  function openMenu(clientX, clientY) {
+				    closeMenu();
+				    menu = document.createElement("div");
+				    menu.style.cssText = [
+				      "position:fixed", "z-index:2147482001", "min-width:150px", "padding:6px 0",
+				      "border-radius:8px", "font-size:12px", "color:#eee",
+				      "background:rgba(28,32,40,0.96)", "border:1px solid rgba(255,255,255,0.16)",
+				      "box-shadow:0 10px 30px rgba(0,0,0,0.45)", "backdrop-filter:blur(8px)",
+				    ].join(";");
+				    const titles = ["闲置", "向右走", "向左走", "挥手", "跳一下", "失败", "发呆", "干活", "完成"];
+				    const head = document.createElement("div");
+				    head.textContent = "试演动作";
+				    head.style.cssText = "padding:4px 10px 6px;opacity:0.55;font-size:11px";
+				    menu.appendChild(head);
+				    titles.forEach((name, r) => {
+				      menu.appendChild(buildMenuItem(name, () => {
+				        walkSpeed = 0; walkLeft = 0;
+				        setRow(r);
+				        holdUntil = petNow() + 1600;
+				        voice.play(r === PET_ROW.fail ? "fail" : r === PET_ROW.done ? "done" : "wave");
+				        closeMenu();
+				      }));
+				    });
+				    const hr = document.createElement("div");
+				    hr.style.cssText = "height:1px;margin:6px 0;background:rgba(255,255,255,0.14)";
+				    menu.appendChild(hr);
+				    menu.appendChild(buildMenuItem("再大一点", () => { applyScale(scale + 0.2); closeMenu(); }));
+				    menu.appendChild(buildMenuItem("再小一点", () => { applyScale(Math.max(0.5, scale - 0.2)); closeMenu(); }));
+				    menu.appendChild(buildMenuItem("回右下角", () => {
+				      try { localStorage.removeItem("wePetPos"); } catch { /* ignore */ }
+				      layerEl.style.left = ""; layerEl.style.top = "";
+				      layerEl.style.right = "24px"; layerEl.style.bottom = "16px";
+				      closeMenu();
+				    }));
+				    menu.appendChild(buildMenuItem("不显示它", () => {
+				      // 只隐藏本地这一层；真正的开关在面板里（下一次轮询会被尊重）。
+				      if (layerEl) layerEl.style.display = "none";
+				      closeMenu();
+				    }));
+				    document.body.appendChild(menu);
+				    const w = menu.offsetWidth || 160;
+				    const h = menu.offsetHeight || 320;
+				    const maxX = (window.innerWidth || 1920) - w - 8;
+				    const maxY = (window.innerHeight || 1080) - h - 8;
+				    menu.style.left = Math.max(8, Math.min(maxX, clientX)) + "px";
+				    menu.style.top = Math.max(8, Math.min(maxY, clientY)) + "px";
+				  }
+				  function onContextMenu(e) {
+				    e.preventDefault();
+				    openMenu(e.clientX, e.clientY);
+				  }
+				  function onDocDown(e) {
+				    if (menu && !menu.contains(e.target)) closeMenu();
+				  }
+				  /** 菜单里的缩放：改本地样式并写回配置（下一次轮询沿用）。 */
+				  function applyScale(next) {
+				    const v = Math.max(0.5, Math.min(3, Number(next) || 1));
+				    try { apiPostJson("/pets/config", { scale: v }, { parse: "always" }); } catch { /* 本地先变 */ }
+				    scaleCur = v;
+				    resize();
+				    draw();
+				  }
+
+				  canvas.addEventListener("contextmenu", onContextMenu);
+				  if (typeof document !== "undefined" && document.addEventListener) document.addEventListener("pointerdown", onDocDown);
 				  img.onload = () => { ready = true; resize(); draw(); };
 				  img.onerror = () => { destroy(); };
 				  img.src = apiUrl(pet.sheet || "/pets/sheet?v=" + encodeURIComponent(pet.dirId || pet.id));
@@ -17810,6 +17958,9 @@ window.__ModuleLoader__.load({
 				    try { voice.destroy(); } catch { /* ignore */ }
 				    if (typeof cancelAnimationFrame === "function") cancelAnimationFrame(raf); else clearTimeout(raf);
 				    canvas.removeEventListener("pointerdown", onPointerDown);
+				    canvas.removeEventListener("contextmenu", onContextMenu);
+				    if (typeof document !== "undefined" && document.removeEventListener) document.removeEventListener("pointerdown", onDocDown);
+				    closeMenu();
 				    if (typeof window !== "undefined") {
 				      window.removeEventListener("pointermove", onPointerMove);
 				      window.removeEventListener("pointerup", onPointerUp);
@@ -17914,6 +18065,76 @@ window.__ModuleLoader__.load({
 
 				// 仅供单测驱动（构建期内联时会剥掉 export，不影响产物）。
 
+				// ── 内联模块：src/features.js —— 客户端功能注册表：页签条 / 整区面板 / 常驻挂载层。装配点（quick-panel、client.js）只查表，不写功能名（构建期注入；勿手改本段）──
+				/**
+				 * features.js（客户端）— **功能注册表**：页签声明、面板工厂、挂载钩子。
+				 *
+				 * 为什么需要它：加一个功能过去要改五处共享文件（client.js 挂载 / quick-panel 的 QP_TABS 与
+				 * 渲染点 / settings-schema / build-client 的内联表 / lib/index.js 的路由注册）。前两处是纯
+				 * "接线"，写错了症状是「页签在、点开空白」或「渲染层根本没挂」。把这些收成一份声明后：
+				 *
+				 *   · 页签条 = WE_FEATURE_TABS（顺序就是用户看到的顺序）
+				 *   · 整区面板 = WE_FEATURE_PANELS（哪些页签整区交给功能自己的面板）
+				 *   · 常驻层   = WE_FEATURE_MOUNTS（随插件生命周期挂载/卸载的浮动层，例如桌宠）
+				 *
+				 * 谁也别再往 quick-panel 里写 `qpTab === "xxx"` —— 那是把功能名焊死进装配点。
+				 * 判据：test/verify-features.mjs 会检查 quick-panel 里不再出现具体功能分支。
+				 *
+				 * ⚠️ 内联顺序：本文件必须排在**它引用的所有符号之后**（panel-tabs-boot / panel-tabs-pets /
+				 * pet-layer），且排在 quick-panel.js 与 client.js **之前** —— 那两处在模块顶层读本表。
+				 */
+
+				/** 页签条（顺序 = 界面顺序）。label 用 getter：语言切换后能立刻生效。 */
+				const WE_FEATURE_TABS = [
+				  // 开机动画与壁纸并列：它们回答的是同一个问题"开机/桌面看到什么"，不是壁纸的子功能。
+				  { id: "boot", get label() { return weT("开机动画"); } },
+				  { id: "wallpaper", get label() { return weT("壁纸"); } },
+				  { id: "appearance", get label() { return weT("外观"); } },
+				  { id: "playback", get label() { return weT("播放"); } },
+				  // 桌宠是"桌面上多出来的一只东西"，与壁纸/开机动画并列。
+				  { id: "pets", get label() { return weT("桌宠"); } },
+				];
+
+				/**
+				 * 整区面板：这个页签的内容**整个**由功能自己的组件渲染（而不是 quick-panel 内的通用列表）。
+				 * 没登记的页签走 quick-panel 自己的通用布局（壁纸列表 / 外观节 / 播放节）。
+				 */
+				const WE_FEATURE_PANELS = {
+				  boot: BootTabPanel,
+				  pets: PetsTabPanel,
+				};
+
+				/**
+				 * 常驻层：插件挂载时启动、卸载时归还。每个都必须返回 cleanup（或 undefined）。
+				 * 它们自己决定"要不要显示"（例如桌宠要读配置才知道是否启用），装配点不参与判断。
+				 */
+				const WE_FEATURE_MOUNTS = [
+				  { id: "pets", mount: mountPetLayer },
+				];
+
+				/** 页签 → 功能归属（宿主清单 lib/features.js 的客户端镜像，供守卫对账）。 */
+				const WE_FEATURE_TAB_IDS = WE_FEATURE_TABS.map((t) => t.id);
+
+				/**
+				 * 页签底部那枚「去设置里改」的引导条。
+				 *
+				 * 为什么要收进注册表：它原本是 quick-panel 里的一条 `qpTab === "boot"` 分支 —— 属于
+				 * 「功能名焊死进装配点」。功能自己声明自己的引导语，装配点只查表。
+				 * 没声明的页签走 quick-panel 的通用文案（壁纸 / 外观 / 播放那三档是泛型布局，留在原地）。
+				 */
+				const WE_FEATURE_FOOTERS = {
+				  boot: {
+				    get label() { return weT("打开设置 ›"); },
+				    target: "",
+				    get title() { return weT("开机动画的全部参数都在侧栏「壁纸引擎」设置里"); },
+				  },
+				  pets: {
+				    get label() { return weT("打开设置 ›"); },
+				    target: "",
+				    get title() { return weT("桌宠的开关 / 大小 / 声音都在「桌宠」页签里调整"); },
+				  },
+				};
+
 				// ── 内联模块：src/quick-panel.js —— 快捷播放面板（官方侧栏 tab 与低版本抽屉共用同一份内容）：当前壁纸 + 轮播 + 列表快切 + 声音 + 设置入口。列表虚拟滚动（spacer + 可视窗口）（构建期注入；勿手改本段）──
 				/**
 				 * quick-panel.js — 快捷播放面板（侧边栏的**唯一**内容）：当前壁纸 + 轮播 + 三档页签
@@ -18083,15 +18304,9 @@ window.__ModuleLoader__.load({
 				  // 位置在「轮播」之下：当前壁纸与轮播在三档页签下都显示（调外观 / 播放参数时想换一张
 				  // 对照很常见）。与设置页的页签表（PICKER_TABS）是两件事 —— 这里只镜像用户点名要的
 				  // 两页，外加壁纸页。
-				  const QP_TABS = [
-				    // 开机动画放在「壁纸」左边：它和壁纸是并列的两种"开机时看到什么"，不是壁纸的子功能。
-				    { id: "boot", get label() { return weT("开机动画"); } },
-				    { id: "wallpaper", get label() { return weT("壁纸"); } },
-				    { id: "appearance", get label() { return weT("外观"); } },
-				    { id: "playback", get label() { return weT("播放"); } },
-				    // 桌宠是"桌面上多出来的一只东西"，与壁纸/开机动画并列，不是它们的子功能。
-				    { id: "pets", get label() { return weT("桌宠"); } },
-				  ];
+				  // 页签条从**功能注册表**取（src/features.js）：这里不再出现具体功能名。
+				  // 加功能只该动注册表，不该动装配点 —— 否则又变成"每加一个功能改五处"。
+				  const QP_TABS = WE_FEATURE_TABS;
 				  // 页签记忆（同 picker-tab / qp-view 口径：仅 UI 状态，localStorage，不进 config.json）。
 				  const QP_TAB_KEY = "dsh-folia:qp-tab";
 				  /** 读页签偏好；缺失 / 非法回落「壁纸」。 */
@@ -18765,12 +18980,11 @@ window.__ModuleLoader__.load({
 				    // 设置页同名页签 —— 玻璃详细调节仍只在侧栏（本页，折叠块），设置页那边留玻璃预设、
 				    // 全量配置与**字体节**（三次修订后字体节两档都画）；播放页的出图来源 /
 				    // 实时帧仍住设置页。
-				    const foot = qpTab === "boot"
-				      ? {
-				        label: weT("打开设置 ›"),
-				        target: "",
-				        title: weT("开机动画的全部参数都在侧栏「壁纸引擎」设置里"),
-				      }
+				    // 引导条：整区面板类页签的文案由**功能注册表**给（WE_FEATURE_FOOTERS），装配点只查表；
+				    // 外观 / 播放 / 壁纸是泛型布局，文案留在原地。
+				    const featFooter = WE_FEATURE_FOOTERS[qpTab] || null;
+				    const foot = featFooter
+				      ? featFooter
 				      : qpTab === "appearance"
 				      ? {
 				        label: weT("更多外观设置 ›"),
@@ -18803,10 +19017,10 @@ window.__ModuleLoader__.load({
 				      React.createElement("div", { className: tabBodyClass, ref: qpPaneRef },
 				        qpTab === "wallpaper" && userPropsPanelOpen() && propsAvailable
 				          && React.createElement("div", { className: "we-qp__propsview we-qp__propsview--drill" }, renderUserPropsPanel()),
-				        // 开机动画档：整区就是那个面板（它自己管加载/下载/开关）。
-				        qpTab === "boot" && React.createElement(BootTabPanel, null),
-				        qpTab === "pets" && React.createElement(PetsTabPanel, null),
-				        !(qpTab === "wallpaper" && userPropsPanelOpen() && propsAvailable) && qpTab !== "boot" && (qpTab === "appearance"
+				        // 整区面板：由注册表声明哪些页签整块交给功能自己的组件（开机动画 / 桌宠）。
+				        // 装配点只查表，不写功能名 —— 判据见 test/verify-features.mjs。
+				        Boolean(WE_FEATURE_PANELS[qpTab]) && React.createElement(WE_FEATURE_PANELS[qpTab], null),
+				        !(qpTab === "wallpaper" && userPropsPanelOpen() && propsAvailable) && !WE_FEATURE_PANELS[qpTab] && (qpTab === "appearance"
 				          ? qpRenderAppearancePane(sel, {
 				            fontOpen, onToggleFontSection: toggleFontSection,
 				            uiColorOpen, onToggleUiColorSection: toggleUiColorSection,
@@ -32138,9 +32352,13 @@ window.__ModuleLoader__.load({
 		  if (ctx.effect && typeof document !== "undefined") {
 		    ctx.effect(() => installSkinInterop() || undefined);
 		  }
-		  // 3c. 桌宠层：自己拉 /pets/list 决定是否出宠物，随 fiber 注销（不依赖面板打开过）。
-		  if (ctx.effect && typeof document !== "undefined") {
-		    ctx.effect(() => mountPetLayer() || undefined);
+		  // 3c. 常驻层：由**功能注册表**声明（src/features.js 的 WE_FEATURE_MOUNTS）。
+		  // 装配点不再点名具体功能 —— 每个 mount 自己决定要不要显示（例如桌宠先读配置）。
+		  if (typeof WE_FEATURE_MOUNTS !== "undefined") {
+		    for (const feat of WE_FEATURE_MOUNTS) {
+		      if (!ctx.effect || typeof document === "undefined") break;
+		      ctx.effect(() => feat.mount() || undefined);
+		    }
 		  }
 
 		  // 3. Chat-interface rope dock: the draggable pull-cord + glass repo side

package/lib/features.js

@@ -0,0 +1,260 @@
+/**
+ * lib/features.js — **功能清单**（单一真源）。
+ *
+ * 为什么需要这张表：这个插件已经长到 19 个宿主路由文件 + 70 个客户端文件 + 24k 行，
+ * 而"某个功能到底由哪些文件负责"过去只存在于人脑里。后果是真实的：
+ *   · 加一个功能要同时改 client.js / quick-panel.js / settings-schema.js / build-client.mjs
+ *     / lib/index.js 五处接线，漏一处就"功能看着在、点开是空的"；
+ *   · 有的功能（如站点缩略图）横跨 host + client，谁都能往里塞逻辑，边界逐渐糊掉。
+ *
+ * 这张表把"归属"写成数据，并由 test/verify-features.mjs 机器校验：
+ *   ① 表里每个文件都必须真实存在；
+ *   ② `lib/routes/*.js` 里的**每一个文件都必须被且仅被一个功能认领**（不许有孤儿路由）；
+ *   ③ 每个 `tab` 必须真的出现在客户端 QP_TABS 里（不许有幽灵页签）；
+ *   ④ 用到的站点分类必须在这里登记（站点是数据源，分类就是功能的入口）。
+ *
+ * 这张表**不改变运行行为**（运行时仍按各文件自己的注册方式装配），它的价值是：
+ * 让"模块化"变成可失败的判据，而不是口头承诺。下次要加功能，先在这里登记，再动手。
+ */
+
+/**
+ * @typedef {object} Feature
+ * @property {string} id            功能 id（与 tab / 站点分类对齐）
+ * @property {string} name          中文名（界面与文档用）
+ * @property {string} role          这一层负责什么（一句话）
+ * @property {string[]} host        宿主侧文件（相对仓库根）
+ * @property {string[]} client      浏览器侧文件（相对仓库根）
+ * @property {string[]} [tab]       客户端页签 id（没有页签的写 null）
+ * @property {string[]} [site]      使用的站点分类 slug（站点数据源入口）
+ * @property {string[]} [settings]  拥有的设置键前缀（可空）
+ */
+
+/** @type {Feature[]} */
+export const FEATURES = [
+  {
+    id: 'wallpaper',
+    name: '壁纸',
+    role: '本机/上传/站点三源合并成壁纸库；着色、图层、播放与轮换由客户端接管',
+    host: [
+      'lib/routes/inventory.js',
+      'lib/routes/media-bytes.js',
+      'lib/routes/media-derived.js',
+      'lib/routes/scene-frame.js',
+      'lib/routes/scene-media.js',
+      'lib/routes/scene-serve.js',
+      'lib/routes/live-frame.js',
+      'lib/routes/occlusion.js',
+      'lib/routes/props.js',
+      'lib/routes/we-assets.js',
+      'lib/routes/upload.js',
+      'lib/inventory.js',
+      'lib/wallpaper-scan.js',
+      'lib/upload-store.js',
+      'lib/scene-manifest.js',
+      'lib/faststart.js',
+      'lib/mp4-vfs.js',
+      'lib/media/frame-store.js',
+      'lib/media/transcode.js',
+      'lib/media/video-preview.js',
+      'lib/media/image-preview.js',
+      'lib/media/scene-probe.js',
+      'lib/media/mp4-probe.js',
+      'lib/media/media-dirs.js',
+    ],
+    client: [
+      'src/quick-panel.js',
+      'src/picker-modal.js',
+      'src/picker-model.js',
+      'src/picker-props-panel.js',
+      'src/panel-tabs-wallpaper.js',
+      'src/video-layer.js',
+      'src/layer-core.js',
+      'src/live-layer.js',
+      'src/live-layer-watch.js',
+      'src/live-layer-gate.js',
+      'src/live-layer-pointer.js',
+      'src/live-layer-underlay.js',
+      'src/live-layer-diag.js',
+      'src/media-prep.js',
+      'src/client-media-frame.js',
+      'src/client-rotation.js',
+      'src/client-audio-playback.js',
+      'src/occlusion.js',
+    ],
+    tab: ['wallpaper'],
+    site: ['wallpaper'],
+  },
+  {
+    id: 'site',
+    name: '站点数据源',
+    role: '把站点当唯一数据源：清单拉取、分类过滤、缩略图代理、模块索引',
+    host: [
+      'lib/routes/site-thumb.js',
+      'lib/routes/modules.js',
+    ],
+    client: [],
+    tab: [],
+    site: ['wallpaper', 'boot-animation', 'desktop-pet', 'assistant-skin'],
+  },
+  {
+    id: 'boot',
+    name: '开机动画',
+    role: '站点候选 → 并行下载 → 本地目录 → 启动注入播放（脚本在宿主侧注入，不依赖应用挂载）',
+    host: [
+      'lib/routes/boot.js',
+      'lib/boot/index.js',
+    ],
+    client: ['src/panel-tabs-boot.js'],
+    tab: ['boot'],
+    site: ['boot-animation'],
+    settings: ['boot'],
+  },
+  {
+    id: 'pets',
+    name: '桌宠',
+    role: '自渲染：站点/本机宠物 → 安装解包 → canvas 逐帧绘 sprite2d + 动作状态机 + 语音',
+    host: ['lib/routes/pets.js'],
+    client: ['src/panel-tabs-pets.js', 'src/pet-layer.js'],
+    tab: ['pets'],
+    site: ['desktop-pet'],
+    settings: ['pet'],
+  },
+  {
+    id: 'appearance',
+    name: '外观',
+    role: '玻璃、主题、字体、预设、页签样式 —— 纯客户端表现层',
+    host: [
+      'lib/routes/settings.js',
+      'lib/routes/presets.js',
+      'lib/settings-schema.js',
+      'lib/components/fonts/routes/fontsets.js',
+      'lib/components/fonts/routes/system-fonts.js',
+    ],
+    client: [
+      'src/panel-tabs-appearance.js',
+      'src/glass.js',
+      'src/glass-panel.js',
+      'src/glass-surfaces.js',
+      'src/glass-extra.js',
+      'src/theme-follow.js',
+      'src/system-fonts.js',
+      'src/fontset-store.js',
+      'src/preset-store.js',
+      'src/styles-base.js',
+      'src/styles-chrome.js',
+      'src/styles-ext.js',
+      'src/styles-panel.js',
+      'src/styles-quick.js',
+      'src/styles-settings.js',
+      'src/styles-shell.js',
+      'src/styles-sidebar.js',
+      'src/about-assets.js',
+      'src/nav-icon.js',
+    ],
+    tab: ['appearance'],
+  },
+  {
+    id: 'playback',
+    name: '播放',
+    role: '音量、静音、轮换节奏与播放控制（壁纸的播放面，独立页签）',
+    host: [],
+    client: [
+      'src/panel-tabs-advanced.js',
+      'src/effects.js',
+      'src/adapter.js',
+    ],
+    tab: ['playback'],
+  },
+  {
+    id: 'components',
+    name: '可选组件行',
+    role: '上游形态保留的 7 个组件行（fx/parallax/fonts/mascot-avatar/media-bridge/pet-link/about-notice），各自独立装载',
+    host: [
+      'lib/components/fx/index.js',
+      'lib/components/parallax/index.js',
+      'lib/components/fonts/index.js',
+      'lib/components/mascot-avatar/index.js',
+      'lib/components/media-bridge/index.js',
+      'lib/components/pet-link/index.js',
+      'lib/components/about-notice/index.js',
+    ],
+    client: [],
+    tab: [],
+  },
+  {
+    id: 'system',
+    name: '系统',
+    role: '诊断、缓存目录、设置存储、客户端装配骨架（不属于任何单个功能）',
+    host: [
+      'lib/routes/diag.js',
+      'lib/routes/cache-dir.js',
+      'lib/index.js',
+      'lib/kernel/host-kernel.js',
+      'lib/kernel/host-session.js',
+      'lib/kernel/config.js',
+      'lib/kernel/data-dir.js',
+      'lib/diag-trace.js',
+      'lib/cache-dir.js',
+      'lib/serve.js',
+      'lib/http-body.js',
+      'lib/http-lifecycle.js',
+      'lib/json-response.js',
+      'lib/pkg-read.js',
+      'lib/log.js',
+      'lib/notice.js',
+      'lib/host-boot.js',
+      'lib/subpackage-boot.js',
+      'lib/startup-sweep.js',
+      'lib/fs-paths.js',
+      'lib/upload-dir.js',
+      'lib/steam-discovery.js',
+      'lib/shim-seed.js',
+      'lib/we-props.js',
+      'lib/we-focus-guard.js',
+      'lib/media-origin.js',
+      'lib/types/index.d.ts',
+      'lib/types/client.d.ts',
+    ],
+    client: [
+      'src/client.js',
+      'src/api-client.js',
+      'src/persistence.js',
+      'src/extension-registry.js',
+      'src/i18n.js',
+      'src/i18n-copy.js',
+      'src/i18n-copy-core.js',
+      'src/i18n-copy-ext.js',
+      'src/i18n-copy-font.js',
+      'src/i18n-copy-glass.js',
+      'src/i18n-copy-live.js',
+      'src/i18n-copy-panel.js',
+      'src/i18n-copy-pet-link.js',
+      'src/i18n-copy-picker.js',
+      'src/we-base.js',
+      'src/we-cond.js',
+      'src/module-reset.js',
+      'src/focus-handback.js',
+      'src/sidebar-right.js',
+      'src/section-head.js',
+      'src/avatar-import.js',
+      'src/avatar-layer.js',
+      'src/ext-avatar.js',
+      'src/panel-tabs.js',
+      'src/panel-tabs-effects.js',
+      'src/panel-tabs-mascot.js',
+    ],
+    tab: [],
+  },
+];
+
+/** 页签 id → 功能 id（供校验与文档使用）。 */
+export const TAB_OWNERS = FEATURES.reduce((acc, f) => {
+  for (const t of f.tab || []) acc[t] = f.id;
+  return acc;
+}, {});
+
+/** 站点分类 slug → 功能 id。 */
+export const SITE_OWNERS = FEATURES.reduce((acc, f) => {
+  for (const s of f.site || []) acc[s] = f.id;
+  return acc;
+}, {});

package/lib/routes/pets.js

@@ -21,7 +21,7 @@
  */
 import { createHash } from 'node:crypto';
 import { inflateRawSync } from 'node:zlib';
-import { createReadStream, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
+import { cpSync, createReadStream, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from 'node:fs';
 import { homedir } from 'node:os';
 import { basename, dirname, extname, join } from 'node:path';
 
@@ -50,6 +50,35 @@ function siteBase() {
 /** 站点上的桌宠分类 slug（站点 `/api/public/categories` 里就有这一条）。 */
 const PET_CATEGORY = 'desktop-pet';
 
+/**
+ * 别的宠物插件把用户下载的宠物放在 `$DSH_HOME/pets/<id>/`（dsh-pet 的公开契约）。
+ *
+ * 为什么提供"导入"而不是"共用目录"：共用会让两边的生命周期纠缠在一起（对方删一只、
+ * 我们这边跟着消失）。**复制一份进我们自己的目录**，两边互不影响，代价只是多占几 MB。
+ */
+function externalPetsDir() {
+  const home = process.env.DSH_HOME || join(process.env.APPDATA || homedir(), 'dsh-desktop', 'harness');
+  return join(home, 'pets');
+}
+
+/** 本机其它宠物插件目录里、我们还没装的那些（只读扫描，不写对方目录）。 */
+function listImportable() {
+  const src = externalPetsDir();
+  const out = [];
+  let names = [];
+  try { names = readdirSync(src); } catch { return out; }
+  const mine = new Set(listInstalled().map((p) => p.dirId));
+  for (const name of names) {
+    if (mine.has(name)) continue;
+    const dir = join(src, name);
+    try { if (!statSync(dir).isDirectory()) continue; } catch { continue; }
+    const pet = readPet(dir, name);
+    if (!pet) continue;
+    out.push({ id: name, name: pet.name, bytes: pet.bytes, columns: pet.columns, cell: pet.cell });
+  }
+  return out;
+}
+
 function ensureDir(p) {
   if (!existsSync(p)) mkdirSync(p, { recursive: true });
   return p;
@@ -355,6 +384,43 @@ export function registerPetsRoutes(webServer, c) {
     },
   }));
 
+  // ── GET /pets/importable（本机其它宠物插件里可导入的） ────────────────────
+  disposers.push(webServer.register({
+    kind: 'exact',
+    path: `${BASE}/pets/importable`,
+    handler: async (req, res) => {
+      let pets = [];
+      try { pets = listImportable(); } catch (e) { sendJson(res, 200, { ok: true, pets: [], error: String((e && e.message) || e) }); return; }
+      sendJson(res, 200, { ok: true, pets, dir: externalPetsDir() });
+    },
+  }));
+
+  // ── POST /pets/import（把本机另一只宠物复制进来） ─────────────────────────
+  disposers.push(webServer.register({
+    kind: 'exact',
+    path: `${BASE}/pets/import`,
+    handler: async (req, res) => {
+      if (req.method !== 'POST') { sendJson(res, 405, { ok: false, error: 'method' }); return; }
+      const text = await readBodyText(req);
+      let id = '';
+      try { id = String((JSON.parse(text || '{}') || {}).id || '').trim(); } catch { id = ''; }
+      if (!id || /[\\/]/.test(id) || id.includes('..') || id.length > 120) { sendJson(res, 400, { ok: false, error: 'bad-id' }); return; }
+      const src = join(externalPetsDir(), id);
+      if (!existsSync(src)) { sendJson(res, 404, { ok: false, error: 'not-found' }); return; }
+      if (!readPet(src, id)) { sendJson(res, 422, { ok: false, error: 'invalid-pet' }); return; }
+      const dst = join(dataRoot(), id);
+      try {
+        ensureDir(dirname(dst));
+        cpSync(src, dst, { recursive: true, force: true });
+      } catch (e) { sendJson(res, 500, { ok: false, error: 'copy-failed', detail: String((e && e.message) || e) }); return; }
+      const pet = readPet(dst, id);
+      if (!pet) { sendJson(res, 422, { ok: false, error: 'install-invalid' }); return; }
+      const cfg = writeConfig({ enabled: true, petId: id });
+      if (typeof log === 'function') log('[pets] imported ' + id + ' from ' + externalPetsDir());
+      sendJson(res, 200, { ok: true, id, pet, config: cfg });
+    },
+  }));
+
   // ── POST /pets/config（开关 / 选中 / 缩放） ───────────────────────────────
   disposers.push(webServer.register({
     kind: 'exact',

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "dsh-folia",
-    "version":  "4.3.1",
+    "version":  "4.5.0",
     "description":  "Folia 壁纸引擎：把本机 Wallpaper Engine 壁纸搬进 DSH 界面（场景实时渲染 / 视频 / 网页），内置液态玻璃与 Folia 吉祥物，并可从自建站点拉取壁纸。单包形态（组件已合并）。",
     "type":  "module",
     "engines":  {
@@ -155,7 +155,8 @@
                   "README.md",
                   "README.en.md",
                   "README.beginner.md",
-                  "lib/components/"
+                  "lib/components/",
+                  "lib/features.js"
               ],
     "dsh":  {
                 "bundle":  {
@@ -193,7 +194,8 @@
                     "test:boot":  "node test/boot-http.mjs",
                     "test:pets":  "node test/pets-http.mjs",
                     "test:pets-layer":  "node test/pets-layer.mjs",
-                    "gate":  "node scripts/build-client.mjs \u0026\u0026 node test/run-guards.mjs smoke \u0026\u0026 node test/boot-http.mjs \u0026\u0026 node test/pets-http.mjs \u0026\u0026 node test/pets-layer.mjs"
+                    "test:features":  "node test/verify-features.mjs",
+                    "gate":  "node scripts/build-client.mjs \u0026\u0026 node test/run-guards.mjs smoke \u0026\u0026 node test/verify-features.mjs \u0026\u0026 node test/boot-http.mjs \u0026\u0026 node test/pets-http.mjs \u0026\u0026 node test/pets-layer.mjs"
                 },
     "peerDependencies":  {
                              "@deepseek-ai/cordis":  "^4.0.4",