dsh-chubby-whale 1.1.53 → 1.1.56

package/CHANGELOG.md

@@ -4,6 +4,49 @@
 
 ## [未发布]
 
+## [1.1.56] - 2026-11-07
+
+### 修复（B69 动作剩余分身）
+- **叙述锁被旧 onDone 提前解掉**：`content.ts` 里每个朗读 onDone 都直接 `clearNarrate()`，而 TTS 是排队串行的——「今日一句没念完就点今日简报」时，前一段播完会把简报刚上的锁解掉，朗读还在响、麦克风提前拾音。现在锁按**代次**归属，只解自己且只解一次；`speak` 同步抛错也当场放锁
+- **「选本书」无防连点**：连点会并发两个请求、后到的气泡顶掉前者；已补 `beginOnce`
+- **导入没有二次确认**：备份导入是整字段覆盖、无撤销入口；现在落盘前确认（可注入 `confirm`，无对话框环境不拦）
+- **413 文案误判**：导入走 `sendTooLarge` 回 `too large`（小写），而客户端只认 `TOO_LARGE` → 超限被说成「备份文件读不了」；两处归一
+- 换唤醒词的气泡不再谎报生效时机（配合下方根因修复）
+
+### 修复（B70 杂项路由分身）
+- **`/config` 可能回显 Key**：注入方把 Key 读取器当布尔传进来时，响应会原样带回 `sk-live-...`；现在所有布尔字段走 `safeBool`
+- **`/stats` 亲密度与 `/state` 不同口径**（250 vs 100）、NaN 写进 JSON（`uptimeMs:null`）、`tts`/`backup` 自检字段原样透传怪值；已逐项归一
+- **`/briefing` 无方法校验**：POST 也 200 且每次都外呼天气；`exp:-5` 显示「初识（-5）」；提醒数组含 `null` 会让整段待办消失
+- **`/balance` 上游怪回包**：200 + `[{}]` 时响应只剩 `{ok:true}`（`balance`/`currency` 键被丢掉）；现在恒有值或回可诊断 `BAD_RESPONSE`
+- **喂食加分失败时显示亲密度 0**（实际值还在）：已回落 `loadIntimacy`
+
+### 修复（主代理：唤醒词立即生效）
+- **换唤醒词必须重开语音待命**：唤醒门只在桥接实例创建时读一次词表；现在每次判定前按当前词表同步（原地替换数组，保留 30 秒有效窗），诊断面板与提示文案也读当前词表
+
+### 测试
+- 新增 `scripts/test-actions-rest.mjs`（37 条）与 `scripts/test-misc-routes.mjs`（97 条），均接入 `npm test`
+- 全链 **2403 项 0 失败**（2173 + 37 + 97 + 96）
+
+
+### 修复（B72 客户端聊天分身，4 处）
+- **人设情绪在默认路径上从不触发**：`reactTo` 原来放在 `tryStream` 之后，而流式（默认开）成功就在同一行 return 掉了——夸/凶/剩饭/胖/泡面五类情绪、气泡表情、爱心基本从未生效。已移到点播路由之后、`tryStream` 之前（点播命中已提前 return，不会误触发）
+- **流式回退普通 /chat 前缺纪元校验**：`await tryStream()` 之后直接走普通请求，被新提问顶掉的旧回复仍会多发一条 `/chat` 并残留占线。已补 `isCurrent(myEpoch)`
+- **P0 打断漏说书占线**：条件只有 `narrating || ttsPlaying`，而叙述锁过期看门狗只清 `narrating`、不清 `storyBusy`，TTS 退避期也会把 `ttsPlaying` 置 false → 旁白会在回答后再抢话筒。已补 `storyBusy`
+- **占线阈值手写 35000**：与 `busy.ts` 的 `BUSY_STALE_MS` 不一致，自定义 staleMs 的实例会出现「看门狗已解锁、发送入口还当忙」。已改用常量
+
+### 测试（B72）
+- 新增 `scripts/test-chat-client.mjs`（96 条：纪元/打断/占线/消息入列/情绪触发），接入 `npm test`
+
+## [1.1.54] - 2026-11-07
+
+### 修复（B68 主代理：缩放被拖拽抹掉）
+- **「先缩放再拖」会丢缩放**：`client.ts` 的 `applyPos` 在拖动时直接写 `el.style.transform = translate3d(...)`、松手写 `transform = ''`，把 `stageStyle` 里的 `scale(...)` 整个覆盖；React 认为 style 没变不会写回，于是拖一次缩放就没了
+- 新增 `styles.stageTransform(scale, tx, ty)` 作为**唯一**的 stage transform 构造函数（位移 + 缩放一起给），`stageStyle` 与 `applyPos` 共用；位移按屏幕像素走，不受缩放倍数影响
+
+### 测试
+- `scripts/test-render-layer.mjs` 补 7 条：合成顺序/NaN 位移归零/`stageStyle` 与构造器一致，以及 `client.ts` 三分支静态契约（拖动带 scale、静置保留 scale、不再清空 transform）
+- 全链 **2173 项 0 失败**；接口清单 119 模块 / 717 导出
+
 ## [1.1.53] - 2026-11-07
 
 ### 修复（B66 缓存/存储分身）

package/dist/client.js

@@ -14,7 +14,7 @@
   }
 
   // src/client/version.ts
-  var VERSION = "1.1.53";
+  var VERSION = "1.1.56";
 
   // src/client/styles.ts
   var W = 240;
@@ -23,6 +23,7 @@
   var CH = 426;
   var SX = CW / 1696;
   var SY = CH / 1504;
+  var stageTransform = (scale, tx = 0, ty = 0) => "translate3d(" + (tx || 0) + "px," + (ty || 0) + "px,0) scale(" + (scale || 1) + ")";
   var stageStyle = (scale, hidden) => ({
     position: "fixed",
     left: 0,
@@ -34,7 +35,7 @@
     zIndex: 9999,
     cursor: "grab",
     touchAction: "none",
-    transform: "scale(" + scale + ")",
+    transform: stageTransform(scale),
     // 缩放原点用左上角：与 stage.ts 的 clampPos（按左上坐标 + W*s 宽高钳制）同口径；
     // 原先 100% 100%（右下）会让缩放后的鱼贴边溢出约 96px。
     transformOrigin: "0 0",
@@ -3654,9 +3655,28 @@
     let voice = null;
     let pendingVoice = readStoredVoiceName();
     const gate = createWakeGate({ words: loadCustomWakeWords() });
+    let wakeWordsSig = "";
+    function syncWakeWords() {
+      let next;
+      try {
+        const custom = loadCustomWakeWords();
+        next = (custom && custom.length ? custom : WAKE_WORDS).slice();
+      } catch (e) {
+        return;
+      }
+      const sig = next.join("|");
+      if (sig === wakeWordsSig) return;
+      wakeWordsSig = sig;
+      try {
+        gate.words.length = 0;
+        for (const w of next) gate.words.push(w);
+      } catch (e) {
+      }
+    }
     const wakeStats = { passed: 0, dropped: 0, hits: 0, lastHitAt: 0, dropNotifiedAt: 0 };
     let asrNoKeyNotified = false;
     function wakeInfo() {
+      syncWakeWords();
       const now = Date.now();
       const remainingMs = gate.remainingMs(now);
       return {
@@ -3728,6 +3748,7 @@
             }
           } catch (e) {
           }
+          syncWakeWords();
           const r = gate.check(text);
           if (r.hit) {
             wakeStats.hits++;
@@ -4537,15 +4558,31 @@
     if (!first.length && !second.length) return null;
     return { first: first.join("\n"), second: second.join("\n") };
   }
+  var narrateGen = 0;
   function showAndSpeak(host, shown, speech, ms2) {
     host.bubble(shown, ms2);
     host.talkFor(5e3);
     if (!host.voiceOn()) return;
+    const my = ++narrateGen;
     host.narrate(estimateSpeakMs(speech));
-    host.speak(speech, { rate: host.narrationRate(), onDone: () => host.clearNarrate() });
+    let released = false;
+    const release = () => {
+      if (released) return;
+      released = true;
+      if (my === narrateGen) host.clearNarrate();
+    };
+    try {
+      host.speak(speech, { rate: host.narrationRate(), onDone: release });
+    } catch (e) {
+      release();
+    }
   }
   function registerContentActions(table) {
     table.define("story-books", (host) => {
+      if (!beginOnce("story-books")) {
+        host.bubble("正在翻书单，稍等～", 2e3);
+        return;
+      }
       getJson("/story/books", { cache: "no-store" }).then((d) => {
         const books = parseBookList(d);
         if (!books.length) {
@@ -4770,9 +4807,12 @@
       return false;
     }
   }
+  function isTooLargeError(err) {
+    return str(err).replace(/[^A-Za-z]/g, "").toUpperCase() === "TOOLARGE";
+  }
   function exportFailText(d) {
-    const err = d && typeof d === "object" ? String(d.error || "") : "";
-    return err === "TOO_LARGE" ? "备份太大（超过 2MB），导出没成功" : "导出没成功";
+    const err = d && typeof d === "object" ? d.error : "";
+    return isTooLargeError(err) ? "备份太大（超过 2MB），导出没成功" : "导出没成功";
   }
   function exportBackup(host) {
     const fetchJson = host.getJson || getJson;
@@ -4887,11 +4927,29 @@
     }
   }
   function importFailText(d) {
-    const err = d && typeof d === "object" ? String(d.error || "") : "";
-    if (err === "TOO_LARGE") return "备份太大（超过 2MB），没导入";
-    if (err === "BAD_BODY") return "备份文件格式不对，没导入";
+    const err = d && typeof d === "object" ? str(d.error).trim() : "";
+    if (isTooLargeError(err)) return "备份太大（超过 2MB），没导入";
+    if (err.toUpperCase() === "BAD_BODY") return "备份文件格式不对，没导入";
     return "备份文件读不了";
   }
+  var IMPORT_CONFIRM_TEXT = "导入会按备份整字段覆盖本机的记忆/人格/成长/鱼粮/提醒，确定吗？";
+  function askImportConfirm(host) {
+    const injected = host && typeof host.confirm === "function" ? host.confirm : null;
+    if (injected) {
+      try {
+        return !!injected(IMPORT_CONFIRM_TEXT);
+      } catch (e) {
+        return false;
+      }
+    }
+    try {
+      const w = typeof window !== "undefined" ? window : null;
+      if (w && typeof w.confirm === "function") return !!w.confirm(IMPORT_CONFIRM_TEXT);
+    } catch (e) {
+      return false;
+    }
+    return true;
+  }
   function clearChatCache(host) {
     try {
       const del = typeof host.delJson === "function" ? host.delJson : delJson;
@@ -4923,6 +4981,10 @@
             host.bubble("备份文件读不了", 6e3);
             return;
           }
+          if (!askImportConfirm(host)) {
+            host.bubble("没确认，导入取消", 4e3);
+            return;
+          }
           let p;
           try {
             p = Promise.resolve(sendJson("/data/import", body));
@@ -5292,6 +5354,28 @@
   }
 
   // src/client/actions/voice.ts
+  function wakeWordsLive(host, want) {
+    let info = null;
+    try {
+      info = host.wakeInfo ? host.wakeInfo() : null;
+    } catch (e) {
+      info = null;
+    }
+    const live = info && Array.isArray(info.words) ? info.words.map((x) => str(x)) : null;
+    if (!live || !live.length) return true;
+    if (live.length !== want.length) return false;
+    for (let i = 0; i < want.length; i++) {
+      if (live[i] !== want[i]) return false;
+    }
+    return true;
+  }
+  function wakeHint(host, want) {
+    try {
+      return wakeWordsLive(host, want) ? "" : "（重开语音待命后生效）";
+    } catch (e) {
+      return "";
+    }
+  }
   function registerVoiceActions(table) {
     table.define("wake", (host) => {
       host.toggleStandby();
@@ -5396,11 +5480,13 @@
           return;
         }
         const on2 = setCustomWakeWord(String(input));
-        host.bubble(on2 ? "唤醒词：" + String(input).trim().slice(0, 12) : "唤醒词：默认（大肥鱼/肥鲸等）");
+        const stored2 = String(input).trim().slice(0, 12);
+        host.bubble(on2 ? "唤醒词：" + stored2 + wakeHint(host, [stored2]) : "唤醒词：默认（大肥鱼/肥鲸等）" + wakeHint(host, WAKE_WORDS));
         return;
       }
       const on = setCustomWakeWord(word);
-      host.bubble(on ? "唤醒词：" + word : "唤醒词：默认（大肥鱼/肥鲸等）");
+      const stored = word.slice(0, 12);
+      host.bubble(on ? "唤醒词：" + stored + wakeHint(host, [stored]) : "唤醒词：默认（大肥鱼/肥鲸等）" + wakeHint(host, WAKE_WORDS));
     });
   }
 
@@ -7050,12 +7136,12 @@
       abortStream();
       const d0 = diag();
       if (d0) d0.lastChat = { stage: "entry", busy: host.busy.isBusy(), tts: !!host.ttsPlaying(), at: Date.now() };
-      if (host.busy.isBusy() && host.busy.age() < 35e3) {
+      if (host.busy.isBusy() && host.busy.age() < BUSY_STALE_MS) {
         if (d0) d0.lastChat.stage = "blocked-busy";
         host.bubble("本鲸还在想上一句呢，稍等～", 2500);
         return;
       }
-      if (host.narrating.current || host.ttsPlaying()) {
+      if (host.narrating.current || host.storyBusy.current || host.ttsPlaying()) {
         try {
           host.stopSpeak();
         } catch (e) {
@@ -7082,10 +7168,6 @@
         host.setMessages((m) => [...m, { who: "me", text }]);
       } catch (e) {
       }
-      try {
-        if (await tryStream(text, opts, myEpoch)) return;
-      } catch (e) {
-      }
       try {
         const hit = host.persona.reactTo(text);
         if (hit) {
@@ -7094,6 +7176,11 @@
         }
       } catch (e) {
       }
+      try {
+        if (await tryStream(text, opts, myEpoch)) return;
+      } catch (e) {
+      }
+      if (!host.epoch.isCurrent(myEpoch)) return;
       try {
         if (opts && opts.voice && !host.ttsPlaying() && Math.random() < 0.25) host.say(host.persona.line("waiting"), 3e3);
       } catch (e) {
@@ -8204,15 +8291,16 @@
           const p = clampPos(x, y, W * s, H * s, window.innerWidth, window.innerHeight);
           x = p.x;
           y = p.y;
+          const vs = scaleRef.current || 1;
           const d = dragRef.current;
           if (d && d.dragging) {
             const bx = typeof d.baseX === "number" ? d.baseX : x;
             const by = typeof d.baseY === "number" ? d.baseY : y;
-            el.style.transform = "translate3d(" + (x - bx) + "px," + (y - by) + "px,0)";
+            el.style.transform = stageTransform(vs, x - bx, y - by);
           } else {
             el.style.left = x + "px";
             el.style.top = y + "px";
-            el.style.transform = "";
+            el.style.transform = stageTransform(vs);
           }
           posRef.current = { x, y };
         }

package/dist/host/routes/briefing.js

@@ -1,12 +1,25 @@
 /**
  * host/routes/briefing.ts —— 今日简报路由（可复用模块）
  * 内容：日期/星期 + 北海天气（wttr.in）+ 提醒数 + 成长阶段
- * 注意：当前前端未使用，保留备查（C# 版已砍掉每日简报，菜单不再调用）
+ *
+ * 调用方：菜单动作「今日简报」（client/actions/content.ts 的 briefing-card → getJson('/briefing')），
+ * 回包形状固定为 { ok, text }，客户端按行切成「日期/天气/成长」与「待办」两段。
+ * 只读：只认 GET/HEAD；非 GET 回 405，也不会因为一次误调去外呼天气。
  */
 import { growthStage } from '../../shared/growth.js';
 import { sendJson } from '../respond.js';
+/** 非负整数（经验展示与 /growth 同口径：NaN/负数/小数归零或取整） */
+function nonNegInt(value) {
+    const n = Number(value);
+    return Number.isFinite(n) && n > 0 ? Math.floor(n) : 0;
+}
 export function createBriefingHandlers(opts) {
-    async function handleBriefing(_req, res) {
+    async function handleBriefing(req, res) {
+        const method = req && req.method ? String(req.method).toUpperCase() : 'GET';
+        if (method !== 'GET' && method !== 'HEAD') {
+            sendJson(res, { ok: false, error: 'METHOD_NOT_ALLOWED' }, 405);
+            return;
+        }
         const parts = [];
         try {
             const now = new Date();
@@ -24,18 +37,21 @@ export function createBriefingHandlers(opts) {
             }
         }
         catch { }
-        // 成长
+        // 成长（与 /growth 同口径：非负整数；g 为 null/怪值时不陪葬其它段）
         try {
-            const g = opts.loadGrowth();
-            const st = growthStage(Number(g.exp) || 0);
-            parts.push('肥鲸成长：' + st.name + '（' + (Number(g.exp) || 0) + '）');
+            const g = opts.loadGrowth() || {};
+            const exp = nonNegInt(g.exp);
+            const st = growthStage(exp);
+            parts.push('肥鲸成长：' + st.name + '（' + exp + '）');
         }
         catch { }
-        // 提醒
+        // 提醒（非数组说明读不到，就别编一个"0 条"；坏项丢弃，好项照数）
         try {
-            const rs = opts.loadReminders() || [];
-            const pending = rs.filter((r) => !r.done).length;
-            parts.push('待办提醒：' + pending + ' 条');
+            const rs = opts.loadReminders();
+            if (Array.isArray(rs)) {
+                const pending = rs.filter((r) => Boolean(r) && !r.done).length;
+                parts.push('待办提醒：' + pending + ' 条');
+            }
         }
         catch { }
         sendJson(res, { ok: true, text: parts.join('\n') });

package/dist/host/routes/config.js

@@ -10,6 +10,8 @@
  *         hasDeepseekKey, hasSiliconflowKey }   // 只报"有没有"，绝不回 Key 内容
  *
  * 约定：不因读取失败而 500——各字段各自兜底，读不到就给缺省值。
+ * 布尔字段统一经 safeBool 出口：即使注入方误把「读 Key」的函数直接接进来（返回 Key 原文），
+ * 也只会变成 true/false，配置视图没有任何回显 Key 内容的通路。
  */
 import { sendJson } from '../respond.js';
 export function createConfigViewHandler(opts) {
@@ -25,6 +27,24 @@ export function createConfigViewHandler(opts) {
             return fallback;
         }
     }
+    /**
+     * 布尔字段的唯一出口：非布尔一律 Boolean 化，绝不把原值原样塞进响应。
+     * 这道闸门的意义是「接口契约不许回显 Key 内容」不依赖注入方自觉——即使 hasDeepseekKey
+     * 被误接成 readApiKey（返回 "sk-..."），这里也只产出 true；异常/空值按缺省值。
+     */
+    function safeBool(fn, fallback) {
+        try {
+            if (typeof fn !== 'function')
+                return fallback;
+            const v = fn();
+            if (v === true || v === false)
+                return v;
+            return v == null ? fallback : Boolean(v);
+        }
+        catch {
+            return fallback;
+        }
+    }
     async function handleConfig(req, res) {
         try {
             const method = req && req.method ? String(req.method).toUpperCase() : 'GET';
@@ -34,15 +54,15 @@ export function createConfigViewHandler(opts) {
             }
             sendJson(res, {
                 ok: true,
-                enabled: safe(opts.enabled, true),
+                enabled: safeBool(opts.enabled, true),
                 dataSource: String(safe(opts.dataSource, 'local')),
                 model: String(safe(opts.model, '')),
-                personalityLearning: safe(opts.personalityLearning, true),
-                personalityWriting: safe(opts.personalityWriting, true),
-                cacheEnabled: safe(opts.cacheEnabled, true),
-                // 只报有没有 Key，绝不回内容
-                hasDeepseekKey: safe(opts.hasDeepseekKey, false),
-                hasSiliconflowKey: safe(opts.hasSiliconflowKey, false),
+                personalityLearning: safeBool(opts.personalityLearning, true),
+                personalityWriting: safeBool(opts.personalityWriting, true),
+                cacheEnabled: safeBool(opts.cacheEnabled, true),
+                // 只报有没有 Key，绝不回内容（safeBool 兜最后一道）
+                hasDeepseekKey: safeBool(opts.hasDeepseekKey, false),
+                hasSiliconflowKey: safeBool(opts.hasSiliconflowKey, false),
             });
         }
         catch {

package/dist/host/routes/misc.js

@@ -68,9 +68,20 @@ export function createMiscHandlers(opts) {
                 return;
             }
             const data = r.data;
-            const infos = data?.balance_infos || [];
-            const cny = infos.find((x) => x.currency === 'CNY') || infos[0] || null;
-            sendJson(res, { ok: true, balance: cny ? cny.total_balance : null, currency: cny ? cny.currency : 'CNY' });
+            // 200 但回包形状不对（不是对象 / balance_infos 不是数组）属于上游坏了：
+            // 给可诊断的 BAD_RESPONSE，别把 "infos.find is not a function" 这种内部报错当错误文案
+            if (!data || typeof data !== 'object' || !Array.isArray(data.balance_infos)) {
+                console.error('[misc] BALANCE-SHAPE 回包缺少 balance_infos 数组');
+                sendJson(res, { ok: false, error: 'BAD_RESPONSE', balance: null });
+                return;
+            }
+            const infos = data.balance_infos;
+            const cny = infos.find((x) => Boolean(x) && x.currency === 'CNY') || infos.find((x) => Boolean(x)) || null;
+            // balance / currency 必须恒有值：undefined 会被 JSON.stringify 整个丢掉，
+            // 客户端拿到「ok:true 但没有 balance 字段」会当成没刷出来（而不是"没有余额信息"）
+            const balance = cny && cny.total_balance != null ? cny.total_balance : null;
+            const currency = cny && typeof cny.currency === 'string' && cny.currency ? cny.currency : 'CNY';
+            sendJson(res, { ok: true, balance, currency });
         }
         catch (err) {
             // 超时/网络错误：照旧回 ok:false + balance:null，日志里留 BALANCE-TIMEOUT 标签
@@ -117,15 +128,20 @@ export function createMiscHandlers(opts) {
                 const pet = opts.feedPet();
                 // 亲密度以 state.json 为准：喂食只负责"加"，不再让 pet_state.intimacy 自成一套
                 let intimacy = cleanIntimacy(pet && pet.intimacy);
+                let bumped = false;
                 if (opts.bumpIntimacy) {
                     try {
                         const v = Number(opts.bumpIntimacy(2));
-                        if (Number.isFinite(v))
+                        if (Number.isFinite(v)) {
                             intimacy = cleanIntimacy(v);
+                            bumped = true;
+                        }
                     }
                     catch (e) { }
                 }
-                else if (opts.loadIntimacy) {
+                // 加分失败（写 state.json 出错/返回非数字）时仍要显示当前亲密度：
+                // 用 loadIntimacy 兜底，否则喂一次食会把面板显示成 0，而 state 里的值其实还在
+                if (!bumped && opts.loadIntimacy) {
                     try {
                         const v = Number(opts.loadIntimacy());
                         if (Number.isFinite(v))

package/dist/host/routes/stats.js

@@ -9,11 +9,15 @@
  *     cache: { tts, chat, asr },                       // 三个缓存目录的条目数
  *     fishfood: { chatTokens, storyTokens, total },    // total = chat + story（与 /fishfood 同口径）
  *     growth: { exp, stage, nextExp },                 // 与 /growth 同口径
- *     intimacy,                                        // state.json
+ *     intimacy,                                        // state.json，0..100（与 /state 同口径）
  *     personality: { catchphrases, preferences, notes, selfNarrative },
  *     uptimeMs                                         // 插件本次装配至今
  *   }
  *
+ * 数值口径：所有数字字段都是有限非负整数——NaN / Infinity / 负数 / 数字字符串都在这里归一，
+ * 不让 NaN 进 JSON（JSON.stringify 会把 NaN 变成 null，客户端拿到 null 会显示成"没有值"）。
+ * intimacy 和 /state 一样夹到 [0, 100]：同一份 state.json 不许在两个接口给出两个亲密度。
+ *
  * 数据全部来自现有 store / cache / 人格仓储的读取器，不新增任何持久化文件，也不写盘。
  */
 import { growthStage } from '../../shared/growth.js';
@@ -23,6 +27,15 @@ function count(value) {
     const n = Number(value);
     return Number.isFinite(n) && n > 0 ? Math.floor(n) : 0;
 }
+/** 亲密度上限（与 host/repos/state.ts、host/routes/misc.ts 同一口径） */
+const INTIMACY_MAX = 100;
+/** 亲密度展示口径：非数字/负数归 0，超 100 截到 100（与 /state 同口径，不许两个接口两个值） */
+function intimacyOf(value) {
+    const n = Number(value);
+    if (!Number.isFinite(n))
+        return 0;
+    return Math.max(0, Math.min(INTIMACY_MAX, Math.floor(n)));
+}
 function strList(value) {
     return (Array.isArray(value) ? value : []).filter((x) => typeof x === 'string');
 }
@@ -46,13 +59,18 @@ export function createStatsHandler(opts) {
         const state = opts.loadState() || {};
         const p = opts.loadPersonality ? (opts.loadPersonality() || {}) : {};
         const startedAt = Number(opts.startedAt) || 0;
-        const uptimeMs = startedAt > 0 ? Math.max(0, Math.floor(nowFn() - startedAt)) : 0;
+        const elapsed = nowFn() - startedAt;
+        // 时钟坏了（now() 非有限数）时 elapsed 是 NaN，JSON 会把它写成 null；这里给 0，保持数字类型
+        const uptimeMs = startedAt > 0 && Number.isFinite(elapsed) ? Math.max(0, Math.floor(elapsed)) : 0;
+        // 自检字段是"外部注入"的：形状由调用方决定，这里逐项归一再出包
+        const ttsRaw = opts.tts || {};
+        const backupRaw = opts.backup || {};
         return {
             ok: true,
             cache: { tts: count(cache.tts), chat: count(cache.chat), asr: count(cache.asr) },
             fishfood: { chatTokens, storyTokens, total: chatTokens + storyTokens },
             growth: { exp, stage: stage.name, nextExp: stage.nextExp },
-            intimacy: count(state.intimacy),
+            intimacy: intimacyOf(state.intimacy),
             personality: {
                 catchphrases: strList(p.catchphrases),
                 preferences: strList(p.preferences),
@@ -60,11 +78,15 @@ export function createStatsHandler(opts) {
                 selfNarrative: typeof p.selfNarrative === 'string' ? p.selfNarrative : '',
             },
             uptimeMs,
-            // 自检：数据源 / 模型 / TTS 引擎 / 备份（缺省不报错）
+            // 自检：数据源 / 模型 / TTS 引擎 / 备份（缺省不报错；坏值也不许把 null/负数/怪类型漏出去）
             dataSource: String(opts.dataSource || 'local'),
             model: String(opts.model || ''),
-            tts: opts.tts || { available: false, interpreter: '', cooling: false },
-            backup: opts.backup || { lastAt: 0, count: 0 },
+            tts: {
+                available: ttsRaw.available === true,
+                interpreter: typeof ttsRaw.interpreter === 'string' ? ttsRaw.interpreter : '',
+                cooling: ttsRaw.cooling === true,
+            },
+            backup: { lastAt: count(backupRaw.lastAt), count: count(backupRaw.count) },
         };
     }
     async function handleStats(req, res) {

package/docs//345/217/221/345/270/203/350/247/204/350/214/203.md

@@ -12,14 +12,14 @@
 
 | 项 | 值 |
 | --- | --- |
-| `package.json` version | 1.1.48 |
-| `src/client/version.ts` VERSION | 1.1.48（由 `scripts/gen-version.mjs` 生成） |
-| 最近 Gitee tag | `v1.1.48`（提交 `d58d078`） |
-| Gitee `main` HEAD | `34bd8c3`（含渠道政策落档） |
-| GitHub `main` | `1d98e86`；tag `v1.1.48` → `77d1536`（版本核对 1.1.48） |
-| npm latest | **1.1.48**（2026-11-07 实读；发布返回 202，约 4 分钟后可见） |
+| `package.json` version | 1.1.53 |
+| `src/client/version.ts` VERSION | 1.1.53（由 `scripts/gen-version.mjs` 生成） |
+| 最近 Gitee tag | `v1.1.53`（提交 `ee4b3dd`） |
+| Gitee `main` HEAD | `ee4b3dd` |
+| GitHub `main` | `1c1d38c`；tag `v1.1.53` → `1c1d38c`（API 解包核对 1.1.53） |
+| npm latest | **1.1.53**（2026-11-07 实读；发布返回 202，约 2–4 分钟后可见）。已发布版本：1.1.48 / 1.1.50 / 1.1.51 / 1.1.53；1.1.49、1.1.52 仅 Gitee+GitHub（跳档不影响 `latest`） |
 | README 版本 | 无硬编码版本号 |
-| `npm test` | **1757 项**：861 单测 + 59 限额 + 58 流式 + 17 说书安全 + 110 行为回归 + 50 语音契约 + 18 客户端冒烟 + 18 宿主冒烟 + 171 语音队列 + 32 TTS 引擎 + 79 数据层 + 112 仓储 + 83 人格 + 57 说书 + 32 平台 |
+| `npm test` | **2166 项**：861 单测 + 59 限额 + 58 流式 + 17 说书安全 + 110 行为回归 + 50 语音契约 + 18 客户端冒烟 + 18 宿主冒烟 + 171 语音队列 + 32 TTS 引擎 + 79 数据层 + 112 仓储 + 83 人格 + 57 说书 + 31 聊天路由 + 33 菜单动作 + 74 说书客户端 + 24 连播开关 + 88 内容路由 + 73 渲染层 + 86 缓存存储 + 32 平台 |
 | `npm pack --dry-run` | **128 个文件 / 17.1 MB**（包）；`data/cache`、运行数据、`config.json`、`src/`、`scripts/`、`tools/` 均不进包 |
 ## 一、版本号规则
 

package/docs//346/250/241/345/235/227/346/216/245/345/217/243/346/270/205/345/215/225.md

@@ -5,7 +5,7 @@
 > 架构宪章：**模块只对外暴露这些导出，外部不得读取模块内部实现**。
 > 新增/修改导出 = 接口变更，必须同步调用点并在提交信息里写明。
 
-> 统计：119 个模块文件，716 个导出项。
+> 统计：119 个模块文件，717 个导出项。
 
 ## 宿主（Node）（`src/host/`）
 
@@ -113,7 +113,7 @@
 | `stage.ts` | `DragInputHandlers`、`DragState`、`INERTIA_DECAY`、`INERTIA_MAX`、`INERTIA_STOP`、`Pos`、`beginDrag`、`bindDragInput`、`clampPos`、`clampVelocity`、`createDragState`、`decayVelocity`、`endDrag`、`homePos`、`moveDrag`、`pickInputMode`、`pointOf` |
 | `story-auto.ts` | `STORY_AUTO_KEY`、`hasStoryAutoStorage`、`isStoryAutoOn`、`setStoryAuto` |
 | `story.ts` | `StoryController`、`StoryHost`、`StoryRefs`、`createStoryController` |
-| `styles.ts` | `CH`、`CW`、`H`、`SX`、`SY`、`VERSION`、`W`、`bodyStyle`、`canvasStyle`、`chatPanelStyle`、`headStyle`、`inputRowStyle`、`inputStyle`、`menuItemStyle`、`menuStyle`、`menuSubStyle`、`msgStyle`、`recoverDotStyle`、`sendStyle`、`stageStyle` |
+| `styles.ts` | `CH`、`CW`、`H`、`SX`、`SY`、`VERSION`、`W`、`bodyStyle`、`canvasStyle`、`chatPanelStyle`、`headStyle`、`inputRowStyle`、`inputStyle`、`menuItemStyle`、`menuStyle`、`menuSubStyle`、`msgStyle`、`recoverDotStyle`、`sendStyle`、`stageStyle`、`stageTransform` |
 | `text.ts` | `Deduper`、`SentenceBuffer`、`collapsePoemBody`、`collapseText`、`createDeduper`、`createSentenceBuffer`、`echoKey`、`estimateSpeakMs`、`isShortEchoFragment`、`normalizePlain`、`stripStageDirections`、`taleParts` |
 | `util.ts` | `clearI`、`clearT`、`evPrevent`、`evStop`、`str` |
 | `version.ts` | `VERSION` |

package/docs//350/267/250/345/271/263/345/217/260/344/270/216/345/210/206/345/267/245.md

@@ -110,3 +110,8 @@
 | B65 | 2026-11-07 | 渲染层分身：`stage.dispose` 按 capture=true 撤监听（漏撤 4 个）/ `anim` 单帧异常续帧 + save/restore finally / `styles` 无 window 守卫 + NaN 坐标 + 窄视口面板溢出；新增 `test-render-layer.mjs`(73)；版本 1.1.52 | 双 tsc 0 / build 0(+1751B) / 2080 项 0 失败 | 见 git |
 | B66 | 2026-11-07 | 缓存/存储分身：`memSet` 补拷贝 / `getJson` 命中核对条目身份（防旧值复辟、`memBytes` 漂移）/ `setJson` 与 `writeFileAtomic` 写失败清 `.tmp`；新增 `test-store-cache.mjs`(86)；版本 1.1.53 | 双 tsc 0 / build 0 / 2166 项 0 失败 | 见 git |
 | B67 | 2026-11-07 | 封装基础设施：修 `check-boundaries` B5/B6 引号 bug（规则从未生效，已负向验证会拦）+ 补 `prefs.js`；`hashKey/shortHash/hashBytes` 上移 `shared/hash.ts`，路由不再为 hash 直连 cache；ADR 0002 增补 `chat-core` 受控例外；接口清单 119 模块/716 导出；版本 1.1.53 | 双 tsc 0 / build 0 / 2166 项 0 失败 / 检查器 exit 0（违规探针 exit 1） | 见 git |
+| B68 | 2026-11-07 | 主代理：`styles.stageTransform(scale,tx,ty)` 收口 stage transform，修「先缩放再拖会丢缩放」（`applyPos` 曾用 `translate3d` 覆盖 `scale`、松手清空）；`stageStyle` 与 `applyPos` 共用同一构造器；`test-render-layer` 补 7 条（含 client.ts 静态契约）；版本 1.1.54 | 双 tsc 0 / build 0 / **2173 项 0 失败** / 119 模块 717 导出 | 见 git |
+| B69 | 2026-11-07 | 动作剩余分身：`content` 叙述锁按代次归属（旧 onDone 不解新锁、朗读起不来当场放锁）+ 选书防连点；`data` 413 归一 `TOO_LARGE`/`too large` + 导入二次确认；`voice` 唤醒词气泡补生效时机；新增 `test-actions-rest.mjs`(37)；版本 1.1.56 | 双 tsc 0 / build 0(+2050B) / 2307 项 0 失败 | 见 git |
+| B70 | 2026-11-07 | 杂项路由分身：`/config` 布尔 safeBool（杜绝 Key 回显）/ `/stats` 亲密度同口径 + NaN 归一 / `/briefing` 只认 GET·HEAD + exp 非负 + 坏项守卫 / `/balance` 恒有值 + `BAD_RESPONSE` / 喂食失败回落亲密度；新增 `test-misc-routes.mjs`(97)；版本 1.1.56 | 双 tsc 0 / build 0 / 2307 项 0 失败 | 见 git |
+| B71 | 2026-11-07 | 主代理：唤醒词立即生效——`voice-bridge` 判定前同步 `loadCustomWakeWords()`（原地换数组、保留 30s 有效窗），诊断与提示同源；版本 1.1.56 | 双 tsc 0 / build 0 / 2307 项 0 失败 | 见 git |
+| B72 | 2026-11-07 | 客户端聊天分身：`reactTo` 移到流式之前（修「人设情绪在默认路径从不触发」）/ 流式回退前补纪元守卫 / P0 打断条件补 `storyBusy` / 占线阈值改用 `BUSY_STALE_MS`；新增 `test-chat-client.mjs`(96)；版本 1.1.56 | 双 tsc 0 / build 0(+85B) / 2403 项 0 失败 | 见 git |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-chubby-whale",
-  "version": "1.1.53",
+  "version": "1.1.56",
   "description": "DSH 网页版桌面宠物「肥鲸」——蓝发鲸鱼娘，固定在 harness 页面右下角：会眨眼、能拖拽、点击可聊天，支持语音对话、念诗说书、饭点提醒。",
   "keywords": [
     "dsh",
@@ -74,7 +74,7 @@
   "scripts": {
     "build": "node scripts/gen-version.mjs && node scripts/check-bom.mjs && tsc -p tsconfig.json && tsc -p tsconfig.client.json && esbuild src/client.ts --bundle --format=iife --external:react --charset=utf8 --outfile=dist/client.js",
     "prepublishOnly": "npm run build",
-    "test": "tsc -p tsconfig.json && tsc -p tsconfig.client.json && node scripts/check-imports.mjs && node scripts/gen-module-index.mjs --check && node scripts/check-boundaries.mjs && node scripts/check-diag-keys.mjs && node scripts/check-text.mjs && node scripts/test.mjs && node scripts/test-chat-limits.mjs && node scripts/test-stream-ledger.mjs && node scripts/test-story-security.mjs && node scripts/test-behavior-regressions.mjs && node scripts/verify-voice.mjs && node scripts/smoke-client.mjs && node scripts/ape-bench.mjs && node scripts/smoke-host.mjs && node scripts/test-voice-queue.mjs && node scripts/test-tts-engine.mjs && node scripts/test-data-layer.mjs && node scripts/test-repos.mjs && node scripts/test-personality.mjs && node scripts/test-story-player.mjs && node scripts/test-chat-routes.mjs && node scripts/test-menu-actions.mjs && node scripts/test-story-client.mjs && node scripts/test-story-auto.mjs && node scripts/test-content-routes.mjs && node scripts/test-render-layer.mjs && node scripts/test-store-cache.mjs && node scripts/platform-check.mjs",
+    "test": "tsc -p tsconfig.json && tsc -p tsconfig.client.json && node scripts/check-imports.mjs && node scripts/gen-module-index.mjs --check && node scripts/check-boundaries.mjs && node scripts/check-diag-keys.mjs && node scripts/check-text.mjs && node scripts/test.mjs && node scripts/test-chat-limits.mjs && node scripts/test-stream-ledger.mjs && node scripts/test-story-security.mjs && node scripts/test-behavior-regressions.mjs && node scripts/verify-voice.mjs && node scripts/smoke-client.mjs && node scripts/ape-bench.mjs && node scripts/smoke-host.mjs && node scripts/test-voice-queue.mjs && node scripts/test-tts-engine.mjs && node scripts/test-data-layer.mjs && node scripts/test-repos.mjs && node scripts/test-personality.mjs && node scripts/test-story-player.mjs && node scripts/test-chat-routes.mjs && node scripts/test-menu-actions.mjs && node scripts/test-story-client.mjs && node scripts/test-story-auto.mjs && node scripts/test-content-routes.mjs && node scripts/test-render-layer.mjs && node scripts/test-store-cache.mjs && node scripts/test-actions-rest.mjs && node scripts/test-misc-routes.mjs && node scripts/test-chat-client.mjs && node scripts/platform-check.mjs",
     "version:check": "node tools/version-check.mjs",
     "typecheck": "node scripts/gen-version.mjs && tsc -p tsconfig.json --noEmit && tsc -p tsconfig.client.json --noEmit",
     "smoke:client": "node scripts/smoke-client.mjs",