dsh-folia 4.2.0 → 4.3.0

package/lib/client.js

@@ -17270,7 +17270,7 @@ window.__ModuleLoader__.load({
 				  ));
 
 				  children.push(React.createElement("div", { key: "hint", className: "we-picker__hint", style: { margin: "6px 0 10px" } },
-				    weT("桌宠由本插件自己绘制（雪碧图逐帧），不依赖其它宠物插件。安装后会立刻出现在右下角，可拖动，点一下会挥手。")));
+				    weT("桌宠由本插件自己绘制（雪碧图逐帧），不依赖其它宠物插件。它会跟着模型状态换动作：干活时换成工作行、干完变完成、出错变失败；安装后出现在右下角，可拖动，点一下会挥手并出声。")));
 
 				  children.push(React.createElement("div", { key: "opts", style: { ...PET_STYLE.row, margin: "2px 0 8px" } },
 				    React.createElement("label", { style: { display: "flex", gap: "6px", alignItems: "center", fontSize: "12px" } },
@@ -17282,6 +17282,32 @@ window.__ModuleLoader__.load({
 				      }),
 				      weT("显示桌宠"),
 				    ),
+				    React.createElement("label", { style: { display: "flex", gap: "6px", alignItems: "center", fontSize: "12px" } },
+				      React.createElement("input", {
+				        type: "checkbox",
+				        checked: Boolean(cfg.sound),
+				        disabled: Boolean(busy),
+				        onChange: (e) => act("config", { sound: e.target.checked }, ""),
+				      }),
+				      weT("声音"),
+				    ),
+				    React.createElement("label", { style: { display: "flex", gap: "4px", alignItems: "center", fontSize: "12px" } },
+				      weT("音量"),
+				      React.createElement("select", {
+				        className: "we-picker__playlist-select",
+				        value: String(cfg.volume == null ? 0.6 : cfg.volume),
+				        disabled: Boolean(busy) || !cfg.sound,
+				        onChange: (e) => act("config", { volume: Number(e.target.value) }, ""),
+				      },
+				      [[0.2, "20%"], [0.4, "40%"], [0.6, "60%"], [0.8, "80%"], [1, "100%"]].map(([v, lb]) =>
+				        React.createElement("option", { key: String(v), value: String(v) }, lb)),
+				      ),
+				    ),
+				    React.createElement("button", {
+				      type: "button", className: "we-picker__btn", disabled: Boolean(busy),
+				      title: weT("把桌宠挪回右下角"),
+				      onClick: () => { try { localStorage.removeItem("wePetPos"); } catch { /* ignore */ } setNote({ ok: true, text: weT("位置已复位（下一次出现回到右下角）") }); },
+				    }, weT("复位位置")),
 				    React.createElement("label", { style: { display: "flex", gap: "4px", alignItems: "center", fontSize: "12px" } },
 				      weT("大小"),
 				      React.createElement("select", {
@@ -17395,14 +17421,113 @@ 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 };
 				const PET_DEFAULT_FRAME_MS = 120;
+				/**
+				 * 活动检测：DSH 的客户端 `ctx` 只暴露 effect/get/slots/surface，没有会话事件，
+				 * 所以"模型在不在干活"只能从**页面本身**读。两条独立信号，任一命中即认为在工作：
+				 *   ① DOM 特征：选择器（默认覆盖常见的 streaming / 生成中 标记）
+				 *   ② 文本特征：屏幕上出现"正在生成 / 思考中 / Stop generating"这类字眼
+				 * 两条都读不到时**安静地停在 idle** —— 宁可不动，也不要让宠物乱跳。
+				 */
+				const PET_ACTIVITY_SELECTORS = [
+				  '[data-dsh-streaming]', '[data-streaming="true"]', '.ds-streaming',
+				  '[class*="streaming"]', '[class*="isGenerating"]', '[aria-busy="true"]',
+				];
+				const PET_ACTIVITY_TEXTS = ['正在生成', '思考中', '停止生成', 'Stop generating', 'Thinking'];
+				/** 检测节流（毫秒）：一次 body 扫描比一次布局还便宜，但没必要每帧跑。 */
+				const PET_ACTIVITY_POLL_MS = 500;
 				/** 光标静止后多久切回 idle（毫秒）。 */
 				const PET_WAVE_IDLE_MS = 9000;
 
+				/**
+				 * 声音：包内 `sounds/<事件>.ogg|mp3|wav` 优先（manifest.sounds 显式声明），
+				 * 没有就用 Web Audio 合成 —— 一只宠物没声音比"声音是版权素材"糟得多。
+				 * 全部失败都静默：声音是可选项，不该有能力打断渲染。
+				 */
+				function petVoice(ctxWindow, sounds, cfg) {
+				  const enabled = Boolean(cfg && cfg.sound);
+				  const volume = Math.max(0, Math.min(1, Number(cfg && cfg.volume) || 0));
+				  let audioCtx = null;
+				  const cache = new Map();
+
+				  function ensureCtx() {
+				    if (audioCtx || typeof ctxWindow.AudioContext !== 'function') return audioCtx;
+				    try { audioCtx = new ctxWindow.AudioContext(); } catch { audioCtx = null; }
+				    return audioCtx;
+				  }
+
+				  /** 合成提示音：不同事件不同音高与波形，短、克制。 */
+				  function synth(kind) {
+				    const ac = ensureCtx();
+				    if (!ac) return;
+				    const spec = kind === "done" ? { f: 880, d: 0.09, w: "sine" }
+				      : kind === "fail" ? { f: 220, d: 0.16, w: "sawtooth" }
+				      : { f: 620, d: 0.08, w: "triangle" };
+				    try {
+				      const osc = ac.createOscillator();
+				      const gain = ac.createGain();
+				      osc.type = spec.w;
+				      osc.frequency.value = spec.f;
+				      gain.gain.value = 0.0001;
+				      osc.connect(gain);
+				      gain.connect(ac.destination);
+				      const now = ac.currentTime;
+				      gain.gain.exponentialRampToValueAtTime(Math.max(0.0001, volume * 0.25), now + 0.01);
+				      gain.gain.exponentialRampToValueAtTime(0.0001, now + spec.d);
+				      osc.start(now);
+				      osc.stop(now + spec.d + 0.02);
+				    } catch { /* 合成失败就算了 */ }
+				  }
+
+				  function file(kind) {
+				    const url = sounds && sounds[kind];
+				    if (!url) return null;
+				    let el = cache.get(kind);
+				    if (!el) {
+				      try { el = new ctxWindow.Audio(apiUrl(url)); } catch { return null; }
+				      el.preload = "auto";
+				      cache.set(kind, el);
+				    }
+				    return el;
+				  }
+
+				  return {
+				    get enabled() { return enabled; },
+				    play(kind) {
+				      if (!enabled || volume <= 0) return;
+				      const el = file(kind);
+				      if (el) {
+				        try { el.currentTime = 0; el.volume = volume; const p = el.play(); if (p && p.catch) p.catch(() => synth(kind)); return; } catch { /* 落回合成 */ }
+				      }
+				      synth(kind);
+				    },
+				    destroy() {
+				      cache.clear();
+				      try { if (audioCtx && typeof audioCtx.close === "function") audioCtx.close(); } catch { /* ignore */ }
+				      audioCtx = null;
+				    },
+				  };
+				}
+
+				/** 页面里现在像不像"模型在干活"。任何异常都当 false。 */
+				function petActivityProbe() {
+				  try {
+				    if (typeof document === 'undefined' || !document.body) return false;
+				    for (const sel of PET_ACTIVITY_SELECTORS) {
+				      if (document.querySelector(sel)) return true;
+				    }
+				    const text = document.body.innerText || "";
+				    for (const marker of PET_ACTIVITY_TEXTS) {
+				      if (text.indexOf(marker) !== -1) return true;
+				    }
+				  } catch { /* ignore */ }
+				  return false;
+				}
+
 				/**
 				 * 桌宠实例：一只宠物一条生命周期（换宠物 = 销毁重来）。
 				 * 不导出（构建期内联进同一作用域），只由 mountPetLayer 使用。
 				 */
-				function createPetLayer(layerEl, canvas, pet, scale) {
+				function createPetLayer(layerEl, canvas, pet, scale, cfg) {
 				  const ctx = canvas.getContext("2d");
 				  const img = new Image();
 				  let frame = 0;
@@ -17414,6 +17539,11 @@ window.__ModuleLoader__.load({
 				  let idleSince = 0;
 				  let dragging = null;
 				  let ready = false;
+				  const voice = petVoice(typeof window !== "undefined" ? window : {}, pet.sounds, cfg || {});
+				  let activity = false;
+				  let activityTimer = null;
+				  /** 一次性动作（done/fail）播完自动回 idle 的时间戳。 */
+				  let holdUntil = 0;
 
 				  const cw = Math.max(1, Number(pet.cell && pet.cell.width) || 192);
 				  const ch = Math.max(1, Number(pet.cell && pet.cell.height) || 208);
@@ -17461,6 +17591,24 @@ window.__ModuleLoader__.load({
 				    if (!last) last = now;
 				    acc += now - last;
 				    last = now;
+				    // 活动状态变化时先切行（work/done/fail 优先于 idle/wave）。
+				    if (activityTimer === null && typeof setInterval === "function") {
+				      activityTimer = setInterval(() => {
+				        const nowActive = petActivityProbe();
+				        if (nowActive === activity && now < holdUntil) return;
+				        activity = nowActive;
+				        if (activity) {
+				          holdUntil = 0;
+				          if (row !== PET_ROW.work) setRow(PET_ROW.work);
+				        } else if (row === PET_ROW.work) {
+				          // 干完活 → 完成行一小会儿，再回 idle（"被看见"的反馈）
+				          setRow(PET_ROW.done);
+				          holdUntil = Date.now() + 1600;
+				          voice.play("done");
+				        }
+				      }, PET_ACTIVITY_POLL_MS);
+				    }
+				    if (holdUntil && now >= holdUntil) { holdUntil = 0; setRow(PET_ROW.idle); }
 				    const ms = frameMs(row, frame);
 				    if (acc >= ms) {
 				      acc = 0;
@@ -17469,6 +17617,7 @@ window.__ModuleLoader__.load({
 				        frame = 0;
 				        // 一次性动作（挥手 / 跳）播完回 idle
 				        if (row === PET_ROW.wave || row === PET_ROW.jump) row = PET_ROW.idle;
+				        // done / fail 由 holdUntil 计时收尾，不在这里回 idle（否则刚出现的反馈会被吞掉）。
 				      }
 				    }
 				    draw();
@@ -17511,6 +17660,7 @@ window.__ModuleLoader__.load({
 				    if (!moved) {
 				      // 单击 = 挥手（给用户一个"它有反应"的反馈），之后自动回 idle
 				      setRow(PET_ROW.wave);
+				      voice.play("wave");
 				    } else {
 				      try { localStorage.setItem("wePetPos", JSON.stringify({ left: layerEl.style.left, top: layerEl.style.top })); } catch { /* ignore */ }
 				    }
@@ -17530,6 +17680,9 @@ window.__ModuleLoader__.load({
 
 				  function destroy() {
 				    dead = true;
+				    if (typeof clearInterval === "function" && activityTimer !== null) clearInterval(activityTimer);
+				    activityTimer = null;
+				    try { voice.destroy(); } catch { /* ignore */ }
 				    if (typeof cancelAnimationFrame === "function") cancelAnimationFrame(raf); else clearTimeout(raf);
 				    canvas.removeEventListener("pointerdown", onPointerDown);
 				    if (typeof window !== "undefined") {
@@ -17538,7 +17691,13 @@ window.__ModuleLoader__.load({
 				    }
 				  }
 
-				  return { destroy, setRow, resize };
+				  return {
+				    destroy, setRow, resize,
+				    /** 外部事件注入（面板操作失败等）：一次性播放失败行并出声。 */
+				    fail() { setRow(PET_ROW.fail); holdUntil = Date.now() + 1600; voice.play("fail"); },
+				    cheer() { setRow(PET_ROW.done); holdUntil = Date.now() + 1600; voice.play("done"); },
+				    get row() { return row; },
+				  };
 				}
 
 				/**
@@ -17593,7 +17752,7 @@ window.__ModuleLoader__.load({
 				    const canvas = document.createElement("canvas");
 				    layerEl.appendChild(canvas);
 				    document.body.appendChild(layerEl);
-				    instance = createPetLayer(layerEl, canvas, pet, scale);
+				    instance = createPetLayer(layerEl, canvas, pet, scale, cfg);
 				  }
 
 				  sync();

package/lib/routes/pets.js

@@ -26,6 +26,7 @@ import { homedir } from 'node:os';
 import { basename, dirname, extname, join } from 'node:path';
 
 /** 注入契约（ADR-0013 D12）。 */
+export { unzip };
 export const DEPS = ['disposers', 'base', 'log'];
 
 const DEFAULT_COLUMNS = 8;
@@ -92,6 +93,23 @@ function readPet(dir, id) {
     bytes: (() => { try { return statSync(sheetPath).size; } catch { return null; } })(),
     cell, columns, frames, tracks,
     sheet: '/folia/pets/sheet?v=' + encodeURIComponent(id),
+    // 音效：manifest 里显式给了 `sounds`（事件 → 包内文件）才生效；
+    // 没有就由前端用 Web Audio 合成，避免"没声音"变成默认行为。
+    sounds: (() => {
+      const src = (manifest.sounds && typeof manifest.sounds === 'object') ? manifest.sounds : null;
+      if (!src) return null;
+      const out = {};
+      for (const [ev, file] of Object.entries(src)) {
+        if (typeof file !== 'string') continue;
+        const rel = file.replace(/\\/g, '/');
+        if (!/^sounds\/[^/]+\.(ogg|mp3|wav|m4a|webm)$/i.test(rel)) continue;
+        const abs = join(dir, rel);
+        if (!existsSync(abs)) continue;
+        // 原样带 sounds/ 前缀：资源路由按 sounds/<文件> 白名单校验，剥掉前缀就对不上了。
+        out[ev] = '/folia/pets/asset?v=' + encodeURIComponent(id) + '&f=' + encodeURIComponent(rel);
+      }
+      return Object.keys(out).length ? out : null;
+    })(),
   };
 }
 
@@ -120,9 +138,11 @@ function readConfig() {
       enabled: raw.enabled === true,
       petId: typeof raw.petId === 'string' ? raw.petId : '',
       scale: Number.isFinite(Number(raw.scale)) ? Math.min(3, Math.max(0.5, Number(raw.scale))) : 1,
+      sound: raw.sound === true,
+      volume: Number.isFinite(Number(raw.volume)) ? Math.min(1, Math.max(0, Number(raw.volume))) : 0.6,
     };
   } catch {
-    return { enabled: false, petId: '', scale: 1 };
+    return { enabled: false, petId: '', scale: 1, sound: false, volume: 0.6 };
   }
 }
 function writeConfig(next) {
@@ -131,6 +151,8 @@ function writeConfig(next) {
     enabled: next.enabled === undefined ? cur.enabled : Boolean(next.enabled),
     petId: next.petId === undefined ? cur.petId : String(next.petId || ''),
     scale: next.scale === undefined ? cur.scale : Math.min(3, Math.max(0.5, Number(next.scale) || 1)),
+    sound: next.sound === undefined ? cur.sound : Boolean(next.sound),
+    volume: next.volume === undefined ? cur.volume : Math.min(1, Math.max(0, Number(next.volume) || 0)),
   };
   try {
     ensureDir(dirname(configPath()));
@@ -181,8 +203,12 @@ function unzip(buf, opts = {}) {
     const localOff = buf.readUInt32LE(p + 42);
     const name = buf.toString('utf8', p + 46, p + 46 + nameLen);
     p += 46 + nameLen + extraLen + commentLen;
-    // 路径安全：只收单层文件名，任何目录跳转一律丢弃
-    if (!name || name.includes('/') || name.includes('\\') || name.includes('..')) continue;
+    // 路径安全：只收「根文件」与「sounds/<文件>」两种形态 —— 任何 `..`、绝对路径、
+    // 其它子目录一律丢弃。宠物包只需要雪碧图/清单/音效三类东西，收窄比放行安全。
+    const safeName = String(name).replace(/\\/g, '/');
+    const okShape = safeName.includes('..') || safeName.startsWith('/') ? false
+      : (safeName.indexOf('/') === -1 || /^sounds\/[^/]+$/.test(safeName));
+    if (!safeName || !okShape) continue;
     if (compSize > maxEntry) continue;
     const lNameLen = buf.readUInt16LE(localOff + 26);
     const lExtraLen = buf.readUInt16LE(localOff + 28);
@@ -300,6 +326,35 @@ export function registerPetsRoutes(webServer, c) {
     },
   }));
 
+  // ── GET /pets/asset?v=<dirId>&f=<相对路径>（包内音频等额外资源） ───────────
+  disposers.push(webServer.register({
+    kind: 'exact',
+    path: `${BASE}/pets/asset`,
+    handler: async (req, res) => {
+      let q = null;
+      try { q = new URL(req.url || '/', 'http://x').searchParams; } catch { q = null; }
+      const id = q ? String(q.get('v') || '') : '';
+      const rel = q ? String(q.get('f') || '').replace(/\\/g, '/') : '';
+      if (!id || /[\\/]/.test(id) || id.includes('..') || !rel) { res.statusCode = 400; res.end(); return; }
+      // 只放行 sounds/ 下的已知音频扩展名：这条路由不充当通用文件读口。
+      if (!/^sounds\/[^/]+\.(ogg|mp3|wav|m4a|webm)$/i.test(rel)) { res.statusCode = 400; res.end(); return; }
+      const file = join(dataRoot(), id, rel);
+      let size = 0;
+      try { size = statSync(file).size; } catch { size = 0; }
+      if (!size || size > 16 * 1024 * 1024) { res.statusCode = 404; res.end(); return; }
+      const ext = extname(file).toLowerCase();
+      const type = ext === '.mp3' ? 'audio/mpeg' : ext === '.wav' ? 'audio/wav'
+        : ext === '.m4a' ? 'audio/mp4' : ext === '.webm' ? 'audio/webm' : 'audio/ogg';
+      if (typeof res.setHeader === 'function') {
+        res.setHeader('content-type', type);
+        res.setHeader('content-length', String(size));
+        res.setHeader('cache-control', 'public, max-age=31536000, immutable');
+      }
+      res.statusCode = 200;
+      createReadStream(file).pipe(res);
+    },
+  }));
+
   // ── POST /pets/config（开关 / 选中 / 缩放） ───────────────────────────────
   disposers.push(webServer.register({
     kind: 'exact',
@@ -358,7 +413,13 @@ export function registerPetsRoutes(webServer, c) {
       const dir = join(dataRoot(), id);
       try {
         ensureDir(dir);
-        for (const [name, data] of entries) writeFileSync(join(dir, basename(name)), data);
+        for (const [name, data] of entries) {
+          const rel = String(name).replace(/\\/g, '/');
+          const safe = rel.indexOf('/') === -1 ? basename(rel) : rel;   // sounds/x.ogg 保留一层
+          const target = join(dir, safe);
+          ensureDir(dirname(target));
+          writeFileSync(target, data);
+        }
       } catch (e) {
         try { rmSync(dir, { recursive: true, force: true }); } catch { /* ignore */ }
         sendJson(res, 500, { ok: false, error: 'write-failed', detail: String((e && e.message) || e) });

package/package.json

@@ -1,6 +1,6 @@
 {
     "name":  "dsh-folia",
-    "version":  "4.2.0",
+    "version":  "4.3.0",
     "description":  "Folia 壁纸引擎：把本机 Wallpaper Engine 壁纸搬进 DSH 界面（场景实时渲染 / 视频 / 网页），内置液态玻璃与 Folia 吉祥物，并可从自建站点拉取壁纸。单包形态（组件已合并）。",
     "type":  "module",
     "engines":  {
@@ -191,7 +191,8 @@
                     "verify:all":  "node test/run-guards.mjs all",
                     "prepack":  "node scripts/prepare.mjs",
                     "test:boot":  "node test/boot-http.mjs",
-                    "gate":  "node scripts/build-client.mjs \u0026\u0026 node test/run-guards.mjs smoke \u0026\u0026 node test/boot-http.mjs"
+                    "test:pets":  "node test/pets-http.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"
                 },
     "peerDependencies":  {
                              "@deepseek-ai/cordis":  "^4.0.4",