dsh-chubby-whale 1.1.50 → 1.1.53

package/CHANGELOG.md

@@ -4,6 +4,51 @@
 
 ## [未发布]
 
+## [1.1.53] - 2026-11-07
+
+### 修复（B66 缓存/存储分身）
+- **`memSet` 别名泄漏**：内存缓存直接存调用方对象引用，外部改一下就改到了缓存里（坑 27 同类）；现在入缓存即拷贝
+- **内存命中把并发写入的新值顶掉**：`getJson` 在 `await stat` 期间若被并发 `setJson` 改写，旧条目会被写回；现在命中后核对条目身份，顺带修掉 `memBytes` 漂移
+- **写失败残留 `.tmp`**：`atomic.writeFileAtomic` 的 `finally` 只 close 不删临时文件，`cache.setJson` 也只覆盖 rename 失败分支；现在写/rename 失败都会清掉半截临时文件
+
+### 修复（B67 主代理：封装基础设施）
+- **封装检查器假绿（坑 25 复发）**：`check-boundaries.mjs` 的 B5/B6 禁令清单把路径写成带引号的 `"'../cache.js'"`，却拿去掉引号的 `m[1]` 做 `indexOf`，恒为 -1——**规则从来没生效过**。已去引号并补 `prefs.js`；负向验证：临时塞一个 `import '../store.js'` 的路由会让检查器以 exit 1 拦下
+- **hash 纯函数上移到 `shared/hash.ts`**：`routes/asr.ts`、`routes/tts.ts` 只为 `hashBytes`/`hashKey` 就直连 `cache.js`，违反 ADR 0002；现在路由从 shared 取，`cache.ts` 与 `chat-core.ts` 也改从 shared 取（旧路径保留 re-export）
+- **ADR 0002 增补受控例外**：`chat-core.js` 是无状态纯函数模块（常量/归一化/消息拼装），明确列为允许；仍禁止 store / repos / cache / prefs / story-repo / data 实现
+
+### 测试
+- 新增 `scripts/test-store-cache.mjs`（86 条：cache 拷贝隔离/LRU/字节上限/TTL/并发/坏条目/BOM/prune + atomic 原子写/重试/隔离 + store 门面往返），接入 `npm test`
+- 全链 **2166 项 0 失败**（2080 + 86）；接口清单 119 模块 / 716 导出
+
+## [1.1.52] - 2026-11-07
+
+### 修复（B64 内容路由分身）
+- **坏数据能把念诗拖死（P1）**：`poem.total` 来自数据文件，被直接当成 `for (i < total)` 的循环上界；数据若给出 `1e9`/`Infinity`，每次念诗要空转上亿次、请求永不返回。现在 `total` 限 1..64 且必须有限（越界打 `POEM-TOTAL-CAP`）
+- **`?title=` 未命中缺少标记**：注释承诺「回落随机并告诉客户端 `matched:false`」，实际没下发；已补齐
+- **池空重来会撞上一则**：`culture` 一轮播完重置时不排除上一则，有 1/n 概率「刚讲完又立刻同一则」；已与念诗同口径排除
+
+### 修复（B65 渲染层分身）
+- **每次卸载漏撤 4 个 window 监听**：`addEventListener(..., true)` 捕获监听配的 `removeEventListener` 少传 `capture`，DOM 按三元组匹配，撤不掉；闭包一直攥着旧 stage 与回调（重挂载/HMR 会叠加）
+- **一帧绘制异常 = 鱼永久冻结**：`loop` 只在末尾排下一帧，任何异常都会断掉 rAF 链且无日志；现在单帧绘制抽 `drawFrame` + try/catch，连续 300 帧异常才停表，首帧 warn 一次
+- **画布状态栈不配平**：`save()` 与 `restore()` 之间没有 `finally`，异常后旋转/位移留在栈顶、恢复后逐帧叠加；已用 `finally` 配平
+- **无 window 环境直接 ReferenceError**：`menuStyle` 在 `menu` 非空时裸读 `window`（同函数里 `maxHeight` 却做了守卫）；`menu.x` 非数还会生成 `"NaNpx"` 被整条忽略。已收敛到 `viewportSize()` + NaN 回退
+- **375px 视口聊天面板落在屏外**：固定 `right:236/width:340` 时左边界 = −201px；现在按视口收缩（≥584×526 时取值与旧版完全一致）
+
+### 测试
+- 新增 `scripts/test-content-routes.mjs`（88 条）与 `scripts/test-render-layer.mjs`（73 条，基线快照上 14 项红），均接入 `npm test`
+- 全链 **2080 项 0 失败**（1919 + 88 + 73）
+
+## [1.1.51] - 2026-11-07
+
+### 修复（B63 主代理：连播开关收口）
+- **`chubby-story-auto` 三套口径并存**：`chat-route.ts` 写 `'on'`、`actions/culture.ts` 写 `'1'/'0'`、`render.ts` 读 `!== '0'`、`story.ts` 整本讲完写 `'0'`。功能上侥幸能跑（`'on'` 恰好被当成开），但以后谁改成 `=== '1'` 就会把 `'on'` 判成关
+- 新增 `client/story-auto.ts` 作为唯一读写口：读侧兼容 `'0'/'off'/'false'` 与历史 `'on'`，写侧统一 `'1'/'0'`；`isStoryAutoOn()` 在任何异常下都不抛（读不到按「开」）
+- 新增 `hasStoryAutoStorage()`：让开关能区分「开」与「读不到」——禁存储/隐私模式下退回内存的一次性开关，避免点一下方向翻反（这条是被 `test-menu-actions` 抓出来的回归，已修）
+
+### 测试
+- 新增 `scripts/test-story-auto.mjs`（24 条：键名/默认开/9 种脏值/写读回/存储抛错/无 localStorage），接入 `npm test`
+- 全链 **1919 项 0 失败**（1895 + 24）；接口清单 118 模块 / 713 导出
+
 ## [1.1.50] - 2026-11-07
 
 ### 修复（B61 菜单/动作分身）

package/dist/client.js

@@ -14,7 +14,7 @@
   }
 
   // src/client/version.ts
-  var VERSION = "1.1.50";
+  var VERSION = "1.1.53";
 
   // src/client/styles.ts
   var W = 240;
@@ -62,24 +62,44 @@
     boxShadow: "0 2px 8px rgba(0,0,0,0.35)",
     zIndex: 10003
   };
-  var menuStyle = (menu) => ({
-    position: "fixed",
-    // 窄视口（<220px）时 innerWidth-220 为负会把菜单甩出左边；夹到 8px 保底
-    left: (menu ? Math.max(8, Math.min(menu.x, window.innerWidth - 220)) : 0) + "px",
-    top: (menu ? Math.max(8, Math.min(menu.y, window.innerHeight - 520)) : 0) + "px",
-    width: 210,
-    maxHeight: typeof window !== "undefined" ? Math.max(200, Math.min(480, window.innerHeight - 32)) : 480,
-    overflowY: "auto",
-    paddingBottom: 10,
-    background: "rgba(12,28,52,0.98)",
-    border: "1px solid #2E6BB8",
-    borderRadius: 10,
-    boxShadow: "0 12px 32px rgba(0,0,0,0.5)",
-    zIndex: 10001,
-    font: '13px/1.5 "Microsoft YaHei", sans-serif',
-    display: menu ? "block" : "none",
-    color: "#cfe9ff"
-  });
+  function viewportSize() {
+    try {
+      if (typeof window === "undefined") return { w: 0, h: 0 };
+      const w = Number(window.innerWidth);
+      const h = Number(window.innerHeight);
+      return { w: isFinite(w) && w > 0 ? w : 0, h: isFinite(h) && h > 0 ? h : 0 };
+    } catch (e) {
+      return { w: 0, h: 0 };
+    }
+  }
+  function finiteOr(v, fallback) {
+    const n = Number(v);
+    return isFinite(n) ? n : fallback;
+  }
+  var menuStyle = (menu) => {
+    const vp = viewportSize();
+    const mx = finiteOr(menu && menu.x, 8);
+    const my = finiteOr(menu && menu.y, 8);
+    return {
+      position: "fixed",
+      // 窄视口（<220px）时 innerWidth-220 为负会把菜单甩出左边；夹到 8px 保底
+      left: (menu ? Math.max(8, Math.min(mx, vp.w > 0 ? vp.w - 220 : 8)) : 0) + "px",
+      top: (menu ? Math.max(8, Math.min(my, vp.h > 0 ? vp.h - 520 : 8)) : 0) + "px",
+      width: 210,
+      // 无 window 时用固定上限；有 window 时至少 200，避免窄视口把菜单压没
+      maxHeight: vp.h > 0 ? Math.max(200, Math.min(480, vp.h - 32)) : 480,
+      overflowY: "auto",
+      paddingBottom: 10,
+      background: "rgba(12,28,52,0.98)",
+      border: "1px solid #2E6BB8",
+      borderRadius: 10,
+      boxShadow: "0 12px 32px rgba(0,0,0,0.5)",
+      zIndex: 10001,
+      font: '13px/1.5 "Microsoft YaHei", sans-serif',
+      display: menu ? "block" : "none",
+      color: "#cfe9ff"
+    };
+  };
   var menuItemStyle = (active) => ({
     padding: "6px 14px",
     cursor: "pointer",
@@ -95,21 +115,28 @@
     display: "flex",
     justifyContent: "space-between"
   });
-  var chatPanelStyle = (open) => ({
-    position: "fixed",
-    right: 236,
-    bottom: 146,
-    width: 340,
-    background: "linear-gradient(180deg, rgba(18,40,74,0.98), rgba(10,24,46,0.98))",
-    border: "1px solid rgba(93,160,240,0.55)",
-    borderRadius: 18,
-    boxShadow: "0 18px 48px rgba(0,0,0,0.55)",
-    font: '14px/1.6 "Microsoft YaHei", sans-serif',
-    color: "#dbeaff",
-    overflow: "hidden",
-    zIndex: 1e4,
-    display: open ? "block" : "none"
-  });
+  var CHAT_PANEL_W = 340;
+  var CHAT_PANEL_H = 380;
+  var chatPanelStyle = (open) => {
+    const vp = viewportSize();
+    const right = vp.w > 0 ? Math.min(236, Math.max(8, vp.w - CHAT_PANEL_W - 8)) : 236;
+    const bottom = vp.h > 0 ? Math.min(146, Math.max(8, vp.h - CHAT_PANEL_H)) : 146;
+    return {
+      position: "fixed",
+      right,
+      bottom,
+      width: CHAT_PANEL_W,
+      background: "linear-gradient(180deg, rgba(18,40,74,0.98), rgba(10,24,46,0.98))",
+      border: "1px solid rgba(93,160,240,0.55)",
+      borderRadius: 18,
+      boxShadow: "0 18px 48px rgba(0,0,0,0.55)",
+      font: '14px/1.6 "Microsoft YaHei", sans-serif',
+      color: "#dbeaff",
+      overflow: "hidden",
+      zIndex: 1e4,
+      display: open ? "block" : "none"
+    };
+  };
   var headStyle = {
     display: "flex",
     justifyContent: "space-between",
@@ -3395,16 +3422,12 @@
       }
       ctx.restore();
     }
-    function loop(t) {
-      if (!running) return;
+    function drawFrame(t) {
       const dt = Math.max(0, Math.min(50, t - last));
       last = t;
       maintCountdown -= 1;
       if (maintCountdown <= 0) maintain();
-      if (!visible) {
-        raf = requestAnimationFrame(loop);
-        return;
-      }
+      if (!visible) return;
       ctx.clearRect(0, 0, cw, ch);
       if (t >= nextWagAt) {
         wagStart = t;
@@ -3413,38 +3436,67 @@
       }
       const wagP = wagStart >= 0 && t >= wagStart && t <= wagStart + WAG_MS ? (t - wagStart) / WAG_MS : -1;
       ctx.save();
-      if (wagP >= 0) {
-        const env = Math.sin(Math.PI * wagP);
-        const angle = Math.sin(wagP * Math.PI * 6) * 0.012 * env;
-        const bob = Math.sin(wagP * Math.PI * 4) * 1.6 * env;
-        ctx.translate(cw / 2, ch);
-        ctx.rotate(angle);
-        ctx.translate(0, bob);
-        ctx.translate(-cw / 2, -ch);
-      }
-      drawHalo(t);
-      if (img.complete && img.naturalWidth > 0) {
-        ctx.drawImage(img, 0, 0, 1696, 1504, 0, 0, cw, ch);
-      }
-      drawFinDots(t);
-      blinkT += dt;
-      if (!blinkClosed && blinkT > blinkGap) {
-        blinkClosed = true;
-        blinkT = 0;
-      }
-      if (blinkClosed && blinkT > 150) {
-        blinkClosed = false;
-        blinkT = 0;
-        blinkGap = 3200 + Math.random() * 1800;
-      }
-      if (blinkClosed) {
-        drawEye(EYE_L, true);
-        drawEye(EYE_R, true);
-      }
-      if (t < state.talkUntil) drawMouth(Math.sin(t / 90) > 0);
-      drawSplashes(dt);
-      ctx.restore();
+      try {
+        if (wagP >= 0) {
+          const env = Math.sin(Math.PI * wagP);
+          const angle = Math.sin(wagP * Math.PI * 6) * 0.012 * env;
+          const bob = Math.sin(wagP * Math.PI * 4) * 1.6 * env;
+          ctx.translate(cw / 2, ch);
+          ctx.rotate(angle);
+          ctx.translate(0, bob);
+          ctx.translate(-cw / 2, -ch);
+        }
+        drawHalo(t);
+        if (img.complete && img.naturalWidth > 0) {
+          ctx.drawImage(img, 0, 0, 1696, 1504, 0, 0, cw, ch);
+        }
+        drawFinDots(t);
+        blinkT += dt;
+        if (!blinkClosed && blinkT > blinkGap) {
+          blinkClosed = true;
+          blinkT = 0;
+        }
+        if (blinkClosed && blinkT > 150) {
+          blinkClosed = false;
+          blinkT = 0;
+          blinkGap = 3200 + Math.random() * 1800;
+        }
+        if (blinkClosed) {
+          drawEye(EYE_L, true);
+          drawEye(EYE_R, true);
+        }
+        if (t < state.talkUntil) drawMouth(Math.sin(t / 90) > 0);
+        drawSplashes(dt);
+      } finally {
+        ctx.restore();
+      }
       drawHearts(dt / 1e3);
+    }
+    const FRAME_ERROR_LIMIT = 300;
+    let frameErrors = 0;
+    function loop(t) {
+      if (!running) return;
+      try {
+        drawFrame(t);
+        frameErrors = 0;
+      } catch (e) {
+        frameErrors += 1;
+        if (frameErrors === 1) {
+          try {
+            console.warn("[chubby-whale] canvas 绘制异常，已继续排帧重试：", e);
+          } catch (e2) {
+          }
+        }
+        if (frameErrors >= FRAME_ERROR_LIMIT) {
+          try {
+            console.warn("[chubby-whale] canvas 连续 " + FRAME_ERROR_LIMIT + " 帧绘制异常，停止动画（已画出的画面保留）");
+          } catch (e2) {
+          }
+          stop();
+          return;
+        }
+      }
+      if (!running) return;
       raf = requestAnimationFrame(loop);
     }
     function start() {
@@ -3893,6 +3945,49 @@
     };
   }
 
+  // src/client/story-auto.ts
+  var STORY_AUTO_KEY = "chubby-story-auto";
+  function storage() {
+    try {
+      return typeof localStorage === "undefined" ? null : localStorage;
+    } catch (e) {
+      return null;
+    }
+  }
+  function isStoryAutoOn() {
+    const s = storage();
+    if (!s) return true;
+    let raw = null;
+    try {
+      raw = s.getItem(STORY_AUTO_KEY);
+    } catch (e) {
+      return true;
+    }
+    if (raw === null) return true;
+    const v = String(raw).trim().toLowerCase();
+    return !(v === "0" || v === "off" || v === "false");
+  }
+  function hasStoryAutoStorage() {
+    const s = storage();
+    if (!s) return false;
+    try {
+      s.getItem(STORY_AUTO_KEY);
+      return true;
+    } catch (e) {
+      return false;
+    }
+  }
+  function setStoryAuto(on) {
+    const s = storage();
+    if (!s) return false;
+    try {
+      s.setItem(STORY_AUTO_KEY, on ? "1" : "0");
+      return true;
+    } catch (e) {
+      return false;
+    }
+  }
+
   // src/client/http.ts
   var API_BASE = "/api/chubby-whale";
   function apiUrl(path) {
@@ -4256,12 +4351,10 @@
       host.story.reset();
     });
     function storyAutoPref(host) {
-      try {
-        const s = localStorage.getItem("chubby-story-auto");
-        return s === null ? true : s !== "0";
-      } catch (e) {
+      if (!hasStoryAutoStorage()) {
         return host && host.storyState && host.storyState.auto ? !!host.storyState.auto.current : true;
       }
+      return isStoryAutoOn();
     }
     table.define("story-auto", (host) => {
       const next = !storyAutoPref(host);
@@ -4269,10 +4362,7 @@
         if (host.storyState && host.storyState.auto) host.storyState.auto.current = next;
       } catch (e) {
       }
-      try {
-        localStorage.setItem("chubby-story-auto", next ? "1" : "0");
-      } catch (e) {
-      }
+      setStoryAuto(next);
       host.bubble(next ? "连播：开——讲完这段自动接下一段" : "连播：关——讲完这段就停", 4e3);
     });
     table.definePrefix("narration-rate:", (host, suffix) => {
@@ -5999,9 +6089,9 @@
       } catch (e) {
       }
     };
-    const del = (el, t, fn) => {
+    const del = (el, t, fn, opts) => {
       try {
-        el.removeEventListener(t, fn);
+        el.removeEventListener(t, fn, opts);
       } catch (e) {
       }
     };
@@ -6143,10 +6233,10 @@
     const dispose = () => {
       if (target && win) {
         if (mode === "pointer") {
-          del(win, "pointerdown", onPointerDownCapture);
-          del(win, "pointermove", onPointerMoveCapture);
-          del(win, "pointerup", onPointerEndCapture);
-          del(win, "pointercancel", onPointerEndCapture);
+          del(win, "pointerdown", onPointerDownCapture, true);
+          del(win, "pointermove", onPointerMoveCapture, true);
+          del(win, "pointerup", onPointerEndCapture, true);
+          del(win, "pointercancel", onPointerEndCapture, true);
           del(win, "pointermove", onMove);
           del(win, "pointerup", onEnd);
           del(win, "pointercancel", onEnd);
@@ -6339,10 +6429,7 @@
               }
             } else {
               refs.auto.current = false;
-              try {
-                localStorage.setItem("chubby-story-auto", "0");
-              } catch (e) {
-              }
+              setStoryAuto(false);
               host.bubble(host.persona.line("poemDone") + "（《" + String(d && d.book || refs.book.current || "这本") + "》讲完啦，连播已关；想接着听点「接着说」）", 8e3);
             }
           }
@@ -6612,7 +6699,7 @@
         host.bubble("（点播）接着说", 3e3);
         try {
           host.storyState.auto.current = true;
-          localStorage.setItem("chubby-story-auto", "on");
+          setStoryAuto(true);
         } catch (e) {
         }
         host.story.start(host.storyState.book.current || "");
@@ -7776,7 +7863,7 @@
     let ttsVoice = "zh-CN-XiaoyiNeural";
     let chatLang = "auto";
     try {
-      storyAuto = localStorage.getItem("chubby-story-auto") !== "0";
+      storyAuto = isStoryAutoOn();
       streamOn = localStorage.getItem("chubby-stream") !== "off";
       ttsVoice = localStorage.getItem("chubby-tts-voice") || "zh-CN-XiaoyiNeural";
       chatLang = localStorage.getItem("chubby-chatlang") || "auto";

package/dist/host/atomic.js

@@ -126,7 +126,7 @@ export function writeFileAtomic(file, data) {
     mkdirSync(dirname(file), { recursive: true });
     const tmp = file + '.' + process.pid + '.' + Math.random().toString(36).slice(2, 8) + '.tmp';
     // POSIX：创建即 0600（umask 无法把权限放回去）；Windows 忽略 mode 参数
-    const fd = openSync(tmp, 'w', 0o600);
+    const fd = openSync(tmp, 'w', 0o600); // 打开就失败（EACCES/ENOSPC）：临时文件还没建出来，无需清理
     try {
         if (typeof data === 'string')
             writeFileSync(fd, data, 'utf8');
@@ -140,12 +140,23 @@ export function writeFileAtomic(file, data) {
             catch { } // 个别文件系统不支持 fsync，失败不当错误
         }
     }
-    finally {
+    catch (err) {
+        // 写到一半失败（磁盘满 / data 参数非法）：半截临时文件必须删掉。
+        // 文件头承诺「失败清掉临时文件」，不走 rename 的失败路径同样适用。
         try {
             closeSync(fd);
         }
         catch { }
+        try {
+            unlinkSync(tmp);
+        }
+        catch { }
+        throw err;
+    }
+    try {
+        closeSync(fd);
     }
+    catch { }
     chmodPrivateFile(tmp); // 兜底：临时文件若已存在，'w' 会保留旧权限
     try {
         renameWithRetry(() => renameSync(tmp, file));

package/dist/host/cache.js

@@ -14,7 +14,6 @@
  *     FAT / exFAT 只有 2 秒精度，会出现「刚写就被判过期/排序并列」的偶发现象，属已知限制，
  *     只影响缓存命中率，不影响正确性（宁可重算，不返回错内容）。
  */
-import { createHash } from 'node:crypto';
 import { readFile, writeFile, mkdir, readdir, unlink, stat, rename } from 'node:fs/promises';
 import { join } from 'node:path';
 import { isRetriableRenameError, chmodPrivateDir, stripBom } from './atomic.js';
@@ -23,17 +22,9 @@ const RENAME_RETRY_LIMIT = 3;
 const RENAME_RETRY_DELAY_MS = 20;
 /** prune 节流窗口：每次写都全量 readdir+stat 会把磁盘扫描串进回复延迟 */
 const PRUNE_INTERVAL_MS = 30000;
-export function hashKey(text) {
-    return createHash('sha1').update(text).digest('hex');
-}
-/** 短指纹（md5 前 8 位）：拼缓存 key 用（如长期记忆摘要的指纹） */
-export function shortHash(text) {
-    return createHash('md5').update(String(text || '')).digest('hex').slice(0, 8);
-}
-/** 二进制内容 hash（ASR 音频用完整字节，避免只取前 4000 字符撞 key） */
-export function hashBytes(buf) {
-    return createHash('sha1').update(buf).digest('hex');
-}
+// hash 纯函数已移到 shared/hash.ts（路由也能直接 import，不必为了算 hash 依赖缓存实现）。
+// 这里保留同名 re-export：旧导入路径（历史代码 / 测试）继续可用。
+export { hashKey, shortHash, hashBytes } from '../shared/hash.js';
 function sizeOf(value) {
     if (value == null)
         return 0;
@@ -162,13 +153,22 @@ export function createCache(opts) {
                 catch {
                     alive = false;
                 }
+                // await 期间可能有并发 setJson 改写了同一条目（记住：它先同步写内存、再落盘）。
+                // 这时绝不能拿手里的旧 hit 去 delete/set —— 那会把刚写进去的新值顶回旧值，
+                // 而且绕过了 forget 的字节扣减，memBytes 从此漂移（容量越用越小）。
+                const cur = mem.get(key);
+                if (cur !== hit) {
+                    if (!cur || !fresh(cur, maxAgeMs))
+                        return null;
+                    return cloneHit(cur.v); // 只认新条目，旧值绝不回写
+                }
             }
             if (alive) {
                 mem.delete(key);
                 mem.set(key, hit); // 命中后挪到队尾（LRU）
                 return cloneHit(hit.v);
             }
-            forget(key);
+            forget(key); // 走到这里 mem.get(key) 仍是 hit（没有 await：同步段内不会变）
         }
         try {
             const file = join(opts.dir, key + '.' + ext);
@@ -200,19 +200,21 @@ export function createCache(opts) {
             // 原子写：先写唯一临时文件再 rename 覆盖（并发同 key 不会交错产出坏文件）
             const target = join(opts.dir, key + '.' + ext);
             const tmp = target + '.' + process.pid + '.' + Math.random().toString(36).slice(2, 8) + '.tmp';
-            // POSIX：创建即 0600；Windows 忽略 mode。写出统一 UTF-8 无 BOM
-            if (ext === 'json')
-                await writeFile(tmp, JSON.stringify(value), { encoding: 'utf8', mode: 0o600 });
-            else
-                await writeFile(tmp, value, { mode: 0o600 });
             try {
+                // POSIX：创建即 0600；Windows 忽略 mode。写出统一 UTF-8 无 BOM
+                if (ext === 'json')
+                    await writeFile(tmp, JSON.stringify(value), { encoding: 'utf8', mode: 0o600 });
+                else
+                    await writeFile(tmp, value, { mode: 0o600 });
                 await renameWithRetry(tmp, target);
             }
             catch (e) {
+                // 写失败（磁盘满 / 参数非法）与改名失败一样不能留半截临时文件：它会被
+                // 目录计数（prune 上限）和事后排障当成"缓存条目"。
                 try {
                     await unlink(tmp);
                 }
-                catch { } // 改名失败别留垃圾
+                catch { }
                 throw e;
             }
             await prune();
@@ -277,8 +279,8 @@ export function createCache(opts) {
             pruning = false;
         }
     }
-    // 内存直写：和 setJson 一样经 remember 打 at（可选 ttl），过期判定不会拿到没有时间的条目
-    function memSet(key, value, ttlMs = 0) { remember(key, value, ttlMs); }
+    // 内存直写：和 setJson 一样经 remember 打 at（可选 ttl）并拷贝入缓存（坑 27：绝不把调用方对象存进内部）
+    function memSet(key, value, ttlMs = 0) { remember(key, cloneHit(value), ttlMs); }
     /** 清空缓存（内存 + 磁盘文件）；用于「清空聊天缓存」「清除记忆」 */
     async function clear() {
         let n = 0;

package/dist/host/chat-core.js

@@ -8,7 +8,7 @@
  *   · 历史截断 / 上下文指纹 / prompt 片段与消息组装
  * 不涉及 HTTP、不涉及 fetch、不持有任何状态，便于离线断言（scripts/selftest.mjs 仍用 chat.ts 的再导出）。
  */
-import { shortHash, hashKey } from './cache.js';
+import { shortHash, hashKey } from '../shared/hash.js';
 import { fetchJson } from './http.js';
 /** DeepSeek 对话接口地址（聊天与摘要共用） */
 export const CHAT_URL = 'https://api.deepseek.com/chat/completions';

package/dist/host/routes/asr.js

@@ -4,7 +4,7 @@
  * Key 由入口注入（getKey），路由不再自己读 config.json / 环境变量。
  * 体积：请求体（base64）上限 12MB → 413；解码后音频上限 8MB；外呼超时 60 秒
  */
-import { hashBytes } from '../cache.js';
+import { hashBytes } from '../../shared/hash.js';
 import { isInterruptWord, isNoiseText } from '../../shared/noise.js';
 import { fetchJson, isTimeoutError, sendTooLarge } from '../http.js';
 import { readJsonBody } from '../body.js';

package/dist/host/routes/culture.js

@@ -4,7 +4,8 @@
  *   {"allusions":[...],"tales":[...],"idioms":[...],"minsu":[...]}
  *   元素为「名称」或「书名|标题」；民间故事同时写 tales（C# 读它）和 minsu。
  *   读到旧格式 {"chengyu:名称": true} 时自动迁移成新结构。
- * 一轮讲完只清空同一类别的记录，别的类别进度保留。
+ * 一轮讲完只清空同一类别的记录，别的类别进度保留；一轮重来时先排除上一则，
+ * 避免「刚讲完又立刻同一则」（与念诗同口径，见 poem.ts 的同名处理）。
  * 数据经 DataPort 取（本地/云端由 index.ts 注入）；数据源读不到只记 CULTURE-LOAD-FAIL，按空池处理，绝不整类报错。
  * 原子写/坏文件隔离走 host/atomic.ts，JSON 响应走 host/respond.ts。
  */
@@ -16,6 +17,8 @@ import { sendJson, sendError } from '../respond.js';
 export function createCultureHandlers(opts) {
     const SEEN_FILE = join(opts.runtimeDir || opts.dataDir, 'culture-seen.json');
     let seen = null;
+    /** 上一次讲出来的条目键（按类别）：一轮重来时先排除它，避免「刚讲完又立刻同一则」 */
+    const lastServed = new Map();
     /** 文化数据经数据源端口取（本地/云端由 index.ts 注入）；实现已兜底，这里只防注入实现意外抛错 */
     async function loadCulture(kind) {
         try {
@@ -132,6 +135,8 @@ export function createCultureHandlers(opts) {
     /**
      * 随机挑一条没讲过的。一轮讲完只清掉同类前缀的记录，
      * 别的类别（典故/故事/成语）的进度不受影响。
+     * 一轮重来后先排除刚讲过的上一条（池子只有一条时只能照旧重复）：
+     * 否则新一轮第一则有 1/n 概率与上一则完全相同，用户看到的就是「刚讲完又讲一遍」。
      */
     function pickUnseen(arr, prefix, keyOf) {
         if (!arr || arr.length === 0)
@@ -145,10 +150,14 @@ export function createCultureHandlers(opts) {
                     delete sn[k];
             }
             saveSeen();
-            pool = arr.slice();
+            const last = lastServed.get(prefix) || '';
+            pool = arr.filter((x) => full(x) !== last);
+            if (pool.length === 0)
+                pool = arr.slice();
         }
         const item = pool[Math.floor(Math.random() * pool.length)];
         sn[full(item)] = true;
+        lastServed.set(prefix, full(item));
         saveSeen();
         return item;
     }

package/dist/host/routes/poem.js

@@ -11,6 +11,12 @@ import { join } from 'node:path';
 import { writeJsonAtomic } from '../atomic.js';
 import { sendJson, sendError } from '../respond.js';
 import { poemKeyOf } from '../../shared/poem.js';
+/**
+ * 分片数上限：正常数据是云端 poems-00..14 共 15 片（本地固定 1 片），这里留足余量。
+ * total 来自数据文件（外部输入），**绝不能直接当循环上界**：坏数据里的 1e9 / Infinity
+ * 会让每次念诗都空转上亿次、请求永不返回（分片越界时数据层快速返回空片，await 也拦不住）。
+ */
+const POEM_MAX_CHUNKS = 64;
 export function createPoemHandler(opts) {
     const SEEN_FILE = join(opts.runtimeDir || opts.dataDir || '.', 'poem-seen.json');
     let seen = null;
@@ -25,7 +31,12 @@ export function createPoemHandler(opts) {
             const first = await opts.dataPort.readPoemsChunk(0);
             // 数据层（local/cloud）已经归一化过去重过，这里不再重复归一化（737 首诗每请求扫一遍纯属浪费）
             const out = Array.isArray(first && first.items) ? first.items.slice() : [];
-            const total = Math.max(1, Number(first && first.total) || 1);
+            // 只认 1..POEM_MAX_CHUNKS 的有限数；NaN（缺字段/坏字符串）按 1 片，避免循环上界不可控
+            const declared = Number(first && first.total);
+            const total = Number.isFinite(declared) ? Math.min(Math.max(1, Math.trunc(declared)), POEM_MAX_CHUNKS) : 1;
+            if (declared > POEM_MAX_CHUNKS || declared === Infinity) {
+                console.error('POEM-TOTAL-CAP raw=' + String(declared) + ' used=' + total);
+            }
             for (let i = 1; i < total; i++) {
                 const chunk = await opts.dataPort.readPoemsChunk(i);
                 if (chunk && Array.isArray(chunk.items))
@@ -80,6 +91,7 @@ export function createPoemHandler(opts) {
             }
             // 指定标题：按「完整标题 = 」优先，其次「包含」，命中就直接背这一首（不参与随机池）
             let want = '';
+            let titleMissed = false;
             try {
                 const u = new URL(String(req?.url || ''), 'http://local');
                 want = String(u.searchParams.get('title') || '').trim();
@@ -104,6 +116,7 @@ export function createPoemHandler(opts) {
                     return;
                 }
                 // 没匹配到就回落随机（并告诉客户端 matched:false）
+                titleMissed = true;
             }
             const sn = loadSeen();
             let pool = list.filter((p) => !sn.has(poemKeyOf(p)));
@@ -122,6 +135,8 @@ export function createPoemHandler(opts) {
             saveSeen();
             sendJson(res, {
                 ok: true,
+                // 带了 ?title= 但库里没有：明确告诉客户端这是随机回落（不带 title 时维持原响应，不多出字段）
+                ...(titleMissed ? { matched: false } : {}),
                 item: {
                     title: p.title,
                     author: p.author,

package/dist/host/routes/tts.js

@@ -4,7 +4,7 @@
  * 缓存：文本+音色+语速+音调 hash → 复用 mp3（省时间、省调用）
  * 语速由请求体 rate 决定（说书 -15%，普通聊天 +0%），服务端不再写死。
  */
-import { hashKey } from '../cache.js';
+import { hashKey } from '../../shared/hash.js';
 import { sendTooLarge } from '../http.js';
 import { readJsonBody } from '../body.js';
 import { sendJson, sendBuffer } from '../respond.js';

package/dist/shared/hash.js

@@ -0,0 +1,25 @@
+/**
+ * shared/hash.ts —— 纯 hash 工具（host / client / routes 共用）
+ *
+ * 为什么从 host/cache.ts 搬出来（2026-11-07）：`routes/asr.ts`、`routes/tts.ts` 只需要
+ * `hashBytes`/`hashKey` 这两个**纯函数**，却因此直接 import 了缓存实现，违反 ADR 0002
+ * 「路由只经端口依赖能力」。把 hash 放到 shared 后：
+ *   · 路由 import shared/hash.js —— 合法（shared 是公共层）；
+ *   · host/cache.ts 继续 re-export 同名函数，旧导入路径不受影响。
+ *
+ * 纯函数、无 I/O、无平台分支：Node 与浏览器（只要 bundler 提供 node:crypto polyfill）都可用。
+ * 客户端目前不用它；留在 shared 是为了以后客户端要「内容指纹」时不至于再抄一份。
+ */
+import { createHash } from 'node:crypto';
+/** 内容 sha1（十六进制，40 字符）：缓存 key 用 */
+export function hashKey(text) {
+    return createHash('sha1').update(text).digest('hex');
+}
+/** 短指纹（md5 前 8 位）：拼缓存 key 用（如长期记忆摘要的指纹） */
+export function shortHash(text) {
+    return createHash('md5').update(String(text || '')).digest('hex').slice(0, 8);
+}
+/** 二进制内容 hash（ASR 音频用完整字节，避免只取前 4000 字符撞 key） */
+export function hashBytes(buf) {
+    return createHash('sha1').update(buf).digest('hex');
+}

package/docs/adr/0002-/346/250/241/345/235/227/346/216/245/345/217/243/345/245/221/347/272/246.md

@@ -23,6 +23,10 @@
 - 反向依赖：`host` 不引 `client`；`shared` 不引 `client/host`；`client` 不引 `host`；
 - 深引用/绝对路径：不得引用 `dist/**`、`file:`、绝对路径；
 - **路由越界**（本次新增）：`src/host/routes/**` 不得直接 import `repos/`、`store.js`、`cache.js`、`chat-core.js`、`prefs.js`——必须经 `ports` 注入；
+  > 2026-11-07 修订：`chat-core.js` 列为**受控例外**。它是无状态的 chat 领域纯函数
+  > （常量 / 归一化 / 消息拼装 / 读请求体），不持有存储、不做 I/O 以外的事；把 12 个纯函数
+  > 塞进端口注入只增加仪式、不增加隔离收益。仍在禁令内的是 **store / repos / cache / prefs /
+  > story-repo / data 实现**——这些才是「改实现会波及路由」的真依赖。
 - **循环风险**（本次新增）：`src/client/**` 子模块不得反向 import 组件入口 `client.ts`。
 
 ### 3. 打包白名单（`package.json.files` 精确化）

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 @@
 > 架构宪章：**模块只对外暴露这些导出，外部不得读取模块内部实现**。
 > 新增/修改导出 = 接口变更，必须同步调用点并在提交信息里写明。
 
-> 统计：117 个模块文件，709 个导出项。
+> 统计：119 个模块文件，716 个导出项。
 
 ## 宿主（Node）（`src/host/`）
 
@@ -111,6 +111,7 @@
 | `render.ts` | `ChatPanelCtx`、`HFunction`、`MenuEntry`、`MenuItemRenderCtx`、`MenuListCtx`、`MenuRuntime`、`listMenuEntries`、`menuRootProps`、`readMenuRuntime`、`renderChatPanel`、`renderMenuHeader`、`renderMenuItems` |
 | `sim.ts` | `RepeatOptions`、`bigrams`、`isRepeat`、`normalizeText`、`similarity` |
 | `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` |
 | `text.ts` | `Deduper`、`SentenceBuffer`、`collapsePoemBody`、`collapseText`、`createDeduper`、`createSentenceBuffer`、`echoKey`、`estimateSpeakMs`、`isShortEchoFragment`、`normalizePlain`、`stripStageDirections`、`taleParts` |
@@ -132,6 +133,7 @@
 | 模块 | 导出（接口） |
 | --- | --- |
 | `growth.ts` | `GROWTH_STAGES`、`growthStage` |
+| `hash.ts` | `hashBytes`、`hashKey`、`shortHash` |
 | `immutable.ts` | `deepFreeze` |
 | `noise.ts` | `INTERRUPT_WORDS`、`NOISE_TEXTS`、`isInterruptWord`、`isNoiseText`、`normalizeNoiseKey` |
 | `poem.ts` | `poemKeyOf` |

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

@@ -105,3 +105,8 @@
 | B60 | 2026-11-07 | 聊天链路分身：流式末帧 flush（假回复进记忆）/ 摘要计数器移入 handler / 空白缓存判空同口径 / `/chat` 状态读写 try 包住（不吞已付费回复）/ 记忆缺失日志；新增 `test-chat-routes.mjs`(31) 并入 npm test；版本 1.1.49 | 双 tsc 0 / build 0 / **1788 项 0 失败** / 接口清单 117 模块 709 导出 | 见 git |
 | B61 | 2026-11-07 | 菜单/动作分身：连播开关与菜单同源读存储（修「点一下关不掉」）/ cache-toggle 加在途锁与失败回滚（连点双发、回执乱序）/ chatLang·ttsVoice 脏值归一；新增 `test-menu-actions.mjs`(33)；版本 1.1.50 | 双 tsc 0 / build 0(+912B) / 1895 项 0 失败 | 见 git |
 | B62 | 2026-11-07 | 客户端说书分身：`beginRound` 即置 narrating（P0 在途可打断，修「回答后面接着说书」）/ 整本讲完把连播写 `0` / `TimeoutError` 归入超时；新增 `test-story-client.mjs`(74)；顺带修正 `test.mjs` 头注释与断言矛盾；版本 1.1.50 | 双 tsc 0 / build 0(+328B) / 1895 项 0 失败 | 见 git |
+| B63 | 2026-11-07 | 主代理收口：新增 `client/story-auto.ts` 统一连播开关（读侧兼容 `on`/`1`/`0`/`off`/`false`，写侧统一 `1`/`0`），4 处调用改走单一入口；新增 `hasStoryAutoStorage()` 区分「开」与「读不到」，保住禁存储时的内存兜底；新增 `test-story-auto.mjs`(24) 并入 npm test；版本 1.1.51 | 双 tsc 0 / build 0 / **1919 项 0 失败** / 接口清单 118 模块 713 导出 | 见 git |
+| B64 | 2026-11-07 | 内容路由分身：`poem.total` 加 1..64 上界（防坏数据把请求空转死）/ `?title=` 未命中下发 `matched:false` / `culture` 池空重来排除上一则；新增 `test-content-routes.mjs`(88)；版本 1.1.52 | 双 tsc 0 / build 0 / 2080 项 0 失败 | 见 git |
+| 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 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-chubby-whale",
-  "version": "1.1.50",
+  "version": "1.1.53",
   "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/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/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",