dsh-chubby-whale 1.1.59 → 1.1.60

package/CHANGELOG.md

@@ -4,6 +4,28 @@
 
 ## [未发布]
 
+## [1.1.60] - 2026-11-07
+
+### 修复（B87 数据端口收口：路由不再直读 data/）
+- **`/poem-titles` 与 `/melodies`、`/melody` 直读 `data/`**：违反 ADR 0002「路由只经端口取数据」，且 `poem-titles` 的 handler 连 `dataPort` 参数都没有。现在 `DataPort` 增**可选**方法 `readPoemTitles()` / `readMelodies()`：本地带 mtime 缓存 + BOM 容错 + 坏 JSON 返回 null 并留痕；云端声明就拉、未声明/网络坏时回退本地
+- 路由口径：**端口存在即权威**（返回 null 也不回读文件），只有端口缺方法时才走文件回退（回退分支注释写明移除条件）；`/melody` 响应字段完全未变
+- 装配漏注入：`index.ts` 给 `poem-titles` 补上 `dataPort`（此前不注入等于永远走回退）
+- 过时文案：`test-data-layer` 端口面断言 6 项→8 项；`test-content-routes` 的「已知缺口」改为「已收口」
+
+### 修复（B88 念诗回调与待命出声）
+- **同一使用方连念两首，旧诗的 onDone 会清新诗的锁**：`client.ts` 的 `narrateOwner` 是**按使用方**分的，菜单「念首诗」两次共用同一句柄、ownerId 不变，挡不住。现在 `culture.ts` 加 per-call 令牌 `poemGen`：只有最新一首的 onDone 能停进度、清锁、说「念完啦」，且同一次收尾只放行一次
+- **`sayLine` 用 `bridge.get()`**：待命关着刷新后 `get()` 为 null，开场问候/情绪台词只有气泡没声（而念诗/说书/提醒走 `ensure()` 一直有声）。改为 `ensure()`，与其它朗读路径一致；真正管静音的是「语音朗读」开关（关掉后 ensure/spoken 都不动）
+- 念诗 `speak` 同步抛错时补 `release()`（与 `actions/content.ts` 同口径），不再等 5 分钟叙述锁自愈
+- 语音实例的卸载回收不再依赖 `earOn`：`ensure()` 可能在待命关着时建实例，原来那种情况 SPA 卸载不会 dispose
+
+### 变更（B86 主代理）
+- `VoiceStats.asrBusyDropped`：ASR「忙则丢」的丢段次数计入统计（原来只在 diag 流里可见）
+- 文档：《坑》补坑 47（叙述锁只有一份 / 持有者令牌 / `narrateOverdue` 读法）、坑 48（ASR 无单飞无纪元与取舍）；《并发纪律》更正「纪元只覆盖对话」→ 覆盖对话与 ASR，规则 5 补 `clearNarrate` 只认持有者
+
+### 测试
+- 新增 `test-dataport-poem.mjs`(56)、`test-poem-narration.mjs`(34)，均接入 `npm test`
+- 全链 **2936 项 0 失败**（`node tools/test-count.mjs`：41 个套件，失败 0，未识别 0）
+
 ## [1.1.59] - 2026-11-07
 
 ### 修复（B82 装配层分身：云端 TTS 从未接线）

package/dist/client.js

@@ -14,7 +14,7 @@
   }
 
   // src/client/version.ts
-  var VERSION = "1.1.59";
+  var VERSION = "1.1.60";
 
   // src/client/styles.ts
   var W = 240;
@@ -1256,6 +1256,7 @@
       skippedSilent: 0,
       uploaded: 0,
       asrFail: 0,
+      asrBusyDropped: 0,
       asrRetry: 0,
       asrTexts: 0,
       heard: 0,
@@ -1770,6 +1771,10 @@
         return;
       }
       if (asrBusy) {
+        try {
+          stats.asrBusyDropped = (stats.asrBusyDropped || 0) + 1;
+        } catch (e) {
+        }
         try {
           opts.onDiag && opts.onDiag({ stage: "asr-busy-drop", hint: "上一段还在识别，这一段丢弃（不排队）" });
         } catch (e) {
@@ -4434,6 +4439,7 @@
     recentStarts.set(key, now);
     return true;
   }
+  var poemGen = 0;
   function recitePoem(host, poem) {
     if (!beginOnce("poem")) {
       host.bubble("正在念呢，稍等～", 2e3);
@@ -4451,21 +4457,28 @@
     host.bubble("念诗·" + poem.title + "（" + author + "）" + (totalLines > 1 ? "· 共 " + totalLines + " 句" : ""), 15e3);
     host.talkFor(6e3);
     const speech = intro + collapsePoemBody(body);
+    const my = ++poemGen;
     host.narrate(estimateSpeakMs(speech));
     host.say(host.persona.line("poemStart"), 4e3);
+    let released = false;
+    const release = () => {
+      if (released) return;
+      released = true;
+      if (my !== poemGen) return;
+      try {
+        stopProgress();
+      } catch (e) {
+      }
+      host.clearNarrate();
+      host.say(host.persona.line("poemDone"), 6e3, { rate: "-8%", pitch: "+15Hz" });
+    };
     try {
       host.speak(speech, {
         rate: poemRate(host.narrationRate()),
-        onDone: () => {
-          try {
-            stopProgress();
-          } catch (e) {
-          }
-          host.clearNarrate();
-          host.say(host.persona.line("poemDone"), 6e3, { rate: "-8%", pitch: "+15Hz" });
-        }
+        onDone: release
       });
     } catch (e) {
+      release();
     }
   }
   function finishSpeech(host, doneText) {
@@ -9352,11 +9365,17 @@
           return reminderPoller.start();
         }, []);
         R.useEffect(() => {
-          if (!earOnRef.current) return;
-          void bridge.start();
-          return () => {
-            bridge.dispose();
+          const cleanup = () => {
+            try {
+              bridge.dispose();
+            } catch (e) {
+            }
           };
+          if (earOnRef.current) {
+            void bridge.start();
+            return cleanup;
+          }
+          return cleanup;
         }, []);
         function speakText(text, o) {
           try {
@@ -9397,7 +9416,7 @@
           }
           try {
             if (localStorage.getItem("chubby-voice") === "off") return;
-            const v = bridge.get();
+            const v = bridge.ensure();
             if (v && v.speak && !v.speaking()) v.speak(text, { rate: voiceOpts && voiceOpts.rate || chatRate(), pitch: voiceOpts && voiceOpts.pitch || "" });
           } catch (e) {
           }

package/dist/host/data/cloud.js

@@ -6,6 +6,9 @@
  *   culture/chengyu.json、culture/idioms.json、culture/minsu-00..09.json、
  *   story/index.json、story/<书名>.json。
  *
+ * 诗名索引 / 曲库（2026-11-07 端口收口新增）也按同一口径处理：云端清单里声明了
+ * poem-titles.json / melodies.json 就按需拉取，没声明就回退本地实现（包内只读文件）。
+ *
  * 策略：
  *   · 按需拉：用到哪本小说/哪类文化/哪片诗才拉哪个文件；
  *   · 内存缓存：拉过的文件留在进程内；清单每 30 秒最多检查一次，
@@ -353,5 +356,58 @@ export function createCloudDataPort(opts) {
             return out;
         }, () => local.readDaily());
     }
-    return { readStoryIndex, readStoryBook, readCulture, readPoemsChunk, readDuilian, readDaily };
+    /**
+     * 回退到本地实现的可选端口方法：老宿主 / 测试假端口可能没实现 readPoemTitles /
+     * readMelodies（DataPort 上它们是可选方法）。缺失或抛错都按「本地也没数据」（null）
+     * 处理，绝不把异常带出数据层——路由拿到的不是数据就是 null。
+     */
+    async function localOrNull(read) {
+        if (typeof read !== 'function')
+            return null;
+        try {
+            return await read.call(local);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * 诗名索引：云端清单声明了 poem-titles.json 就取云端，否则回退本地包内文件。
+     * 清单没声明属于「数据缺失」（DataUnavailable）：静默回退、不进 60 秒冷却；
+     * 坏 JSON / 网络失败走链路失败分支：记 CLOUD-DATA-FAIL 后回退本地，绝不抛。
+     */
+    async function readPoemTitles() {
+        return withFallback('readPoemTitles', async () => {
+            const raw = await readFile('poem-titles.json');
+            const titles = [];
+            if (raw && Array.isArray(raw.titles)) {
+                for (const item of raw.titles)
+                    if (typeof item === 'string' && item)
+                        titles.push(item);
+            }
+            if (titles.length === 0)
+                dataUnavailable('poem titles empty');
+            return { titles };
+        }, () => localOrNull(local.readPoemTitles));
+    }
+    /**
+     * 曲库：云端清单声明了 melodies.json 就取云端，否则回退本地。
+     * 返回顶层浅拷贝 + 新 songs 数组：fileCache 里的原始 parse 结果不直接递给路由
+     * （与 normalize 系列同一条所有权纪律）。非对象结构按数据缺失处理。
+     */
+    async function readMelodies() {
+        return withFallback('readMelodies', async () => {
+            const raw = await readFile('melodies.json');
+            if (!raw || typeof raw !== 'object')
+                dataUnavailable('melodies bad structure');
+            const songs = Array.isArray(raw.songs)
+                ? raw.songs.filter((s) => s && typeof s === 'object').map((s) => ({ ...s }))
+                : [];
+            return { ...raw, songs };
+        }, () => localOrNull(local.readMelodies));
+    }
+    return {
+        readStoryIndex, readStoryBook, readCulture, readPoemsChunk, readDuilian, readDaily,
+        readPoemTitles, readMelodies,
+    };
 }

package/dist/host/data/local.js

@@ -35,10 +35,15 @@ export function createLocalDataPort(opts) {
     const POEMS_FILE = join(opts.dataDir, 'poems.json');
     const DUILIAN_FILE = join(opts.dataDir, 'duilian.json');
     const DAILY_FILE = join(opts.dataDir, 'daily.json');
+    /** 诗名索引 / 曲库：随包只读数据文件（路由经 DataPort 的同名可选方法取，见 ports.ts） */
+    const POEM_TITLES_FILE = join(opts.dataDir, 'poem-titles.json');
+    const MELODIES_FILE = join(opts.dataDir, 'melodies.json');
     const cultureCache = new Map();
     let poemsCache = null;
     let duilianCache = null;
     let dailyCache = null;
+    let poemTitlesCache = null;
+    let melodiesCache = null;
     /**
      * 文件最后修改时间（读不到返回 0）；缓存据此失效，改数据不必重启。
      * mtimeMs 在 NTFS / ext4 / APFS 上可靠；FAT / exFAT 只有 2 秒精度，
@@ -85,6 +90,31 @@ export function createLocalDataPort(opts) {
             out.note = d.note;
         return out;
     }
+    /**
+     * 诗名索引：只认 {titles:[...]}，过滤空串/非字符串（与改造前 poem-titles 路由的过滤口径一致）；
+     * 空表按「没数据」处理（调用方返回 null，路由走既有 ok:false 兜底）。
+     */
+    function pickTitles(raw) {
+        const list = raw && Array.isArray(raw.titles) ? raw.titles : [];
+        const out = [];
+        for (const item of list)
+            if (typeof item === 'string' && item)
+                out.push(item);
+        return out;
+    }
+    /**
+     * 曲库：保留整份对象（路由自己取 songs / notes / lyrics），songs 条目浅拷贝后返回，
+     * 缓存本体不交给调用方（与其它读口同一条缓存所有权纪律）。
+     * 合法 JSON 但不是对象（例如字面量 null / 数字）按不可用处理，路由走既有失败兜底。
+     */
+    function cloneMelodies(raw) {
+        if (!raw || typeof raw !== 'object')
+            return null;
+        const songs = Array.isArray(raw.songs)
+            ? raw.songs.filter((s) => s && typeof s === 'object').map((s) => ({ ...s }))
+            : [];
+        return { ...raw, songs };
+    }
     async function readStoryIndex() {
         try {
             const books = await opts.story.listBooks();
@@ -166,5 +196,49 @@ export function createLocalDataPort(opts) {
         dailyCache = { value: out, mtimeMs: mt };
         return cloneItems(out);
     }
-    return { readStoryIndex, readStoryBook, readCulture, readPoemsChunk, readDuilian, readDaily };
+    /**
+     * 诗名索引：缺文件 / 坏 JSON / 空表一律 null（不抛），路由按既有 ok:false 兜底。
+     * 缓存口径与其它读口一致：按 mtime 失效，坏 JSON 这类确定性失败可以记空缓存，
+     * 瞬时读错误不写缓存（否则一次文件占用会把诗名永久锁成空）。
+     */
+    async function readPoemTitles() {
+        const mt = fileMtime(POEM_TITLES_FILE);
+        if (poemTitlesCache && mt > 0 && poemTitlesCache.mtimeMs === mt) {
+            const hit = poemTitlesCache.value;
+            return hit ? { titles: hit.titles.slice() } : null;
+        }
+        const loaded = await loadJsonFile(POEM_TITLES_FILE, 'POEM-TITLES-LOAD-FAIL');
+        let out = null;
+        if (loaded.ok) {
+            const titles = pickTitles(loaded.raw);
+            if (titles.length > 0)
+                out = { titles };
+            // 合法 JSON 但结构不对/空表：留痕，与「文件坏了」同口径按不可用处理
+            else
+                console.error('POEM-TITLES-LOAD-FAIL file=' + POEM_TITLES_FILE + ' err=empty or bad structure');
+        }
+        if (!loaded.cacheable)
+            return out;
+        poemTitlesCache = { value: out, mtimeMs: mt };
+        return out ? { titles: out.titles.slice() } : null;
+    }
+    /** 曲库：缺文件 / 坏 JSON / 非对象一律 null（不抛）；返回副本，缓存本体不外泄 */
+    async function readMelodies() {
+        const mt = fileMtime(MELODIES_FILE);
+        if (melodiesCache && mt > 0 && melodiesCache.mtimeMs === mt) {
+            return melodiesCache.value === null ? null : cloneMelodies(melodiesCache.value);
+        }
+        const loaded = await loadJsonFile(MELODIES_FILE, 'MELODIES-LOAD-FAIL');
+        const out = loaded.ok ? cloneMelodies(loaded.raw) : null;
+        if (loaded.ok && !out)
+            console.error('MELODIES-LOAD-FAIL file=' + MELODIES_FILE + ' err=bad structure');
+        if (!loaded.cacheable)
+            return out;
+        melodiesCache = { value: out, mtimeMs: mt };
+        return out ? cloneMelodies(out) : null;
+    }
+    return {
+        readStoryIndex, readStoryBook, readCulture, readPoemsChunk, readDuilian, readDaily,
+        readPoemTitles, readMelodies,
+    };
 }

package/dist/host/routes/culture.js

@@ -6,7 +6,8 @@
  *   读到旧格式 {"chengyu:名称": true} 时自动迁移成新结构。
  * 一轮讲完只清空同一类别的记录，别的类别进度保留；一轮重来时先排除上一则，
  * 避免「刚讲完又立刻同一则」（与念诗同口径，见 poem.ts 的同名处理）。
- * 数据经 DataPort 取（本地/云端由 index.ts 注入）；数据源读不到只记 CULTURE-LOAD-FAIL，按空池处理，绝不整类报错。
+ * 数据经 DataPort 取（本地/云端由 index.ts 注入；曲库走 readMelodies，见下方回退注释）；
+ * 数据源读不到只记 CULTURE-LOAD-FAIL，按空池处理，绝不整类报错。
  * 原子写/坏文件隔离走 host/atomic.ts，JSON 响应走 host/respond.ts。
  */
 import { readFile } from 'node:fs/promises';
@@ -30,6 +31,26 @@ export function createCultureHandlers(opts) {
             return [];
         }
     }
+    /**
+     * 曲库数据：优先经 DataPort.readMelodies（ADR 0002「路由只经端口取数据」）。
+     * 端口存在该方法就只认端口：返回 null 由调用方按既有 ok:false 语义兜底，不再回读文件。
+     */
+    async function loadMelodies() {
+        const port = opts.dataPort;
+        if (port && typeof port.readMelodies === 'function') {
+            return await port.readMelodies();
+        }
+        /**
+         * 过渡回退（2026-11-07，B86 数据端口收口）：`DataPort.readMelodies` 是本次新增的
+         * 可选方法。离线单测、旧宿主、以及还没升级装配层的假端口可能没有它；直接删掉
+         * 文件读取会让这些环境的曲库整体消失。端口实现存在时本分支不会执行。
+         *
+         * 移除条件：`readMelodies` 改为必选、且所有装配都注入实现后，删掉本分支、
+         * 以及本文件顶部 `readFile`（node:fs/promises）这个 import。
+         * 注意 `join` 仍被 SEEN_FILE 使用，不能一起删。
+         */
+        return JSON.parse(await readFile(join(opts.dataDir, 'melodies.json'), 'utf8'));
+    }
     // 新格式字段 ← 内部前缀；民间故事写 tales + minsu 两份，让 C# 也能读
     function splitKey(k) {
         const i = k.indexOf(':');
@@ -199,8 +220,10 @@ export function createCultureHandlers(opts) {
     }
     async function handleMelodies(_req, res) {
         try {
-            const txt = await readFile(join(opts.dataDir, 'melodies.json'), 'utf8');
-            const data = JSON.parse(txt);
+            const data = await loadMelodies();
+            // 端口/文件都给不出数据（null）时沿用既有失败语义：ok:false + songs:[]
+            if (data == null)
+                throw new Error('melodies unavailable');
             const songs = (data?.songs || []).map((s) => ({ name: s.name, bpm: s.bpm }));
             sendJson(res, { ok: true, songs });
         }
@@ -212,8 +235,9 @@ export function createCultureHandlers(opts) {
         try {
             const url = new URL(req.url, 'http://x');
             const name = url.searchParams.get('name') || '';
-            const txt = await readFile(join(opts.dataDir, 'melodies.json'), 'utf8');
-            const data = JSON.parse(txt);
+            const data = await loadMelodies();
+            if (data == null)
+                throw new Error('melodies unavailable');
             const song = (data?.songs || []).find((s) => s.name === name);
             if (!song) {
                 sendJson(res, { ok: false, error: 'song not found' });

package/dist/host/routes/poem-titles.js

@@ -8,7 +8,12 @@
  *
  * 为什么单独一条路由：634 个标题约 11 KB，原先内联在 client bundle 里，
  * 改成按需下发后只有真正点诗的人付这份体积。
- * 数据是随包发布的只读文件：读成功后在内存里缓存一份；失败不缓存，补回文件即恢复。
+ *
+ * 取数口径（ADR 0002「路由只经端口取数据」）：
+ *   · 优先 `opts.dataPort.readPoemTitles()`（DataPort 上的可选方法，本地/云端各自实现）。
+ *     端口存在就**只认端口**：返回 null / 空表都按既有 ok:false 兜底，不再回读文件；
+ *   · 只有端口**根本没有该能力**（旧宿主装配 / 离线单测的假端口）时才回退读包内文件，
+ *     原因与移除条件见 loadTitlesFromFile 上方注释。
  */
 import { readFileSync } from 'node:fs';
 import { join } from 'node:path';
@@ -16,31 +21,62 @@ import { sendJson } from '../respond.js';
 export function createPoemTitlesHandler(opts) {
     // 生产装配（index.ts）总会传 DATA_DIR；这里兜底用 cwd/data（与 client seedFromDisk 的查找出发点一致）
     const FILE = join(opts.dataDir || join(process.cwd(), 'data'), 'poem-titles.json');
-    /** 成功读到的标题（只缓存成功结果：文件后来补上时不用重启就能恢复） */
+    /** 成功读到的标题（只缓存成功结果：文件后来补上时不用重启就能恢复）——仅文件回退分支使用 */
     let cached = null;
-    function loadTitles() {
+    /** 过滤空串/非字符串：端口与文件两条路径共用同一口径，响应字段不变 */
+    function pickTitles(list) {
+        const out = [];
+        if (!Array.isArray(list))
+            return out;
+        for (const item of list)
+            if (typeof item === 'string' && item)
+                out.push(item);
+        return out;
+    }
+    /**
+     * 过渡回退：从包内 data/poem-titles.json 读（改造前的唯一取数路径）。
+     *
+     * 为什么还留着：`DataPort.readPoemTitles` 是 2026-11-07（B86 数据端口收口）才加的
+     * 可选方法。离线环境、测试里的最小假端口、以及还没升级装配层的旧宿主都可能没有
+     * 这个方法；若把它当必选，这些宿主会直接拿不到诗名。端口能力存在时本函数**不会被调用**
+     * （见 handlePoemTitles 的 fromPort 判断），所以不影响新装配。
+     *
+     * 移除条件：`DataPort.readPoemTitles` 改为必选、且装配层已注入端口
+     * （index.ts 的 `createPoemTitlesHandler({ dataDir: DATA_DIR, dataPort })`）之后，
+     * 删掉本函数、FILE、cached 以及 node:fs / node:path 两个 import。
+     */
+    function loadTitlesFromFile() {
         if (cached)
             return cached;
         const raw = readFileSync(FILE, 'utf8');
         const data = JSON.parse(String(raw).replace(/^\uFEFF/, ''));
-        const list = Array.isArray(data && data.titles) ? data.titles : [];
-        const titles = [];
-        for (const item of list)
-            if (typeof item === 'string' && item)
-                titles.push(item);
+        const titles = pickTitles(data && data.titles);
         if (titles.length === 0)
             throw new Error('empty titles');
         cached = titles;
         return titles;
     }
     async function handlePoemTitles(_req, res) {
+        // 只看「端口有没有这个方法」：有就只认端口（null 也算端口给出的结论），绝不再碰文件
+        const fromPort = typeof (opts.dataPort && opts.dataPort.readPoemTitles) === 'function';
         try {
-            const titles = loadTitles();
+            let titles;
+            if (fromPort) {
+                // 端口实现承诺不抛（坏 JSON/缺文件 → null）；空表按没数据走既有失败兜底
+                const data = await opts.dataPort.readPoemTitles();
+                titles = pickTitles(data && data.titles);
+                if (titles.length === 0)
+                    throw new Error('empty titles');
+            }
+            else {
+                titles = loadTitlesFromFile();
+            }
             sendJson(res, { ok: true, count: titles.length, titles });
         }
         catch (err) {
             // 读不到就明确报失败：客户端会降级为「不识别具体诗名」，其他意图照常
-            console.error('POEM-TITLES-LOAD-FAIL file=' + FILE + ' err=' + String((err && err.message) || err));
+            const src = fromPort ? ' source=dataPort' : ' file=' + FILE;
+            console.error('POEM-TITLES-LOAD-FAIL' + src + ' err=' + String((err && err.message) || err));
             sendJson(res, { ok: false, titles: [], error: String((err && err.message) || err) });
         }
     }

package/dist/index.js

@@ -275,7 +275,7 @@ export function apply(ctx, rawConfig) {
     const culture = createCultureHandlers({ dataDir: DATA_DIR, runtimeDir: RUNTIME_DIR, dataPort });
     const poem = createPoemHandler({ runtimeDir: RUNTIME_DIR, dataPort });
     // 诗名索引：客户端点诗识别按需拉取（数据是包内只读文件，读一次后进程内缓存）
-    const poemTitles = createPoemTitlesHandler({ dataDir: DATA_DIR });
+    const poemTitles = createPoemTitlesHandler({ dataDir: DATA_DIR, dataPort });
     const briefing = createBriefingHandlers({
         loadGrowth: store.loadGrowth,
         loadReminders: store.loadReminders,

package/docs//345/235/221.md

@@ -530,4 +530,19 @@ dsh: warning: 1 entry did not activate
 
 **修复**：补 `scripts/test-stream-ledger.mjs`（58 项，含**静态接线断言**：`index.ts` 的装配块必须含四个依赖）+ 负向验证（注释掉 `loadState` 必须红）。
 
-**教训**：修关键路径要同时留**回归测试**，否则下一轮重构会静默改回去。
+**教训**：修关键路径要同时留**回归测试**，否则下一轮重构会静默改回去。
+
+## 坑 47：叙述锁只有一份，谁都能解（诗尾 onDone 解掉说书的锁）
+
+- **现象**：念诗播到一半点「讲段书」，诗那一段播完的 `clearNarrate()` 会把说书刚上的锁清掉——说书段从此没有叙述锁、气泡不更新，麦克风还会在朗读中途开始拾音（把 TTS 当主人说话）。
+- **原因**：`narration.ts` 只有一份 `until`，`clearNarrate` 是无条件清；而念诗/说书/菜单动作三个使用方共用同一对 `narrate/clearNarrate`。TTS 是**串行排队**的，上一段的 onDone 天然晚到。
+- **现在做法**（2026-11-07，B84）：`client.ts` 用 `makeNarrateHandle(label)` 给每个使用方发一个**持有者令牌**（`narrateOwner`）；`clearNarrate()` 先撤自己的探针，**只有仍是自己持有时才清锁**。「停止说话」与叙述锁过期看门狗走**权威清锁** `resetNarration()`（不看持有者，立刻静音）。
+- **还挡不住的**：同一使用方连点两次（连念两首），两次共用一个令牌；彻底修要 per-call token（改 culture/content 的 host 签名）。
+- **诊断**：`__chubbyWhale.narrateOverdue`（计数）与 `narrateOverdueInfo`（`label/estMs/afterMs/lockLeftMs/at`）。只说书长段（估算 >2 分钟、`story.ts` 不挂兜底）会打点：到 `max(30s, 1.5×估算)` 仍是持有者且说书 busy 为 true 时**只报警不放锁**。看到计数涨 = 朗读 onDone 可能丢了，不是锁坏了。
+
+## 坑 48：ASR 既没有单飞也没有纪元
+
+- **现象**：极短时间两段录音会让两个 `/asr` 并发（第二个照发、`uploaded` 计 2）；Stop→start 之后上一轮的识别结果仍被当成本轮的新话送进聊天；P0 打断只停 TTS、不停在途识别；主动 abort 还会被计成「识别失败」。
+- **原因**：`onWindowDone` 可重入，没有在途标志；只有 `if (!running) return`，而 Stop→start 后 `running` 又为 true。
+- **现在做法**（2026-11-07，B83）：`asrBusy` 单飞（**忙则丢，不排队**：识别是「说完马上回话」的交互，排队会让第二句等第一段，断网时队列还会无界）；`asrEpoch` 在 `start()`/`stop()`/`stopSpeaking()` 各 +1，`prepare` 之后、`res.json()` 之后、catch 里都校验，过期一律不送、不写缓存、不改状态；`abortAsrFlight()` 负责早退清理。
+- **取舍要记住**：打断让在途识别作废是规格要求（epoch+1）的必然结果——极端「鱼在说话 + 主人同期开口 + 同时停止说话」时，那句要重说。

package/docs//345/271/266/345/217/221/347/272/252/345/276/213.md

@@ -73,6 +73,9 @@ TTS 结束 → 再等 700ms（ECHO_MUTE_MS）让混响散掉
 ASR 结果与本鱼最近说过的 6 句做相似度比对 → 命中即判回声丢弃
 ```
 
+   > 2026-11-07 补充（B84）：叙述锁现在**按持有者令牌归属**——`clearNarrate()` 只在仍是自己持有时才清锁，
+   > 旧段 onDone（TTS 串行排队，天然晚到）不会再把新使用方的锁解掉；「停止说话」与过期看门狗走权威清锁。
+   > 想读长段朗读是否卡住：看 `__chubbyWhale.narrateOverdue` / `narrateOverdueInfo`（只报警，不动锁）。
 ## 四、状态机
 
 ```
@@ -105,7 +108,9 @@ ASR 结果与本鱼最近说过的 6 句做相似度比对 → 命中即判回
 
 - **没有真正的任务队列**：P1/P2 用"空闲轮询 + 标志位"实现，不是调度器。极端情况下（连续多次提醒）仍会串行播报，只是不会互相打断。
 - **恢复性打断有代价**：P0 打断说书后，说书的进度停在当前段，需要主人点「接着说」继续。
-- **纪元机制只覆盖对话**：说书进度、提醒、ASR 各自用自己的标志，没有统一事务。
+- **纪元机制覆盖对话与 ASR**（2026-11-07 起）：说书进度、提醒仍各用自己的标志，没有统一事务。
+  对话走 `chatEpoch`，ASR 走 `asrEpoch`（start/stop/stopSpeaking 各 +1，await 后逐个校验）；两者互不覆盖，
+  但都要遵守同一条：**过期结果不许再改任何状态**。
 - 并发问题难用自动化测出来（需要真实麦克风 + 真实网络抖动），本文的规则来自实际故障复盘，**未做压力测试**。
 
 ---

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

@@ -127,3 +127,6 @@
 | B83 | 2026-11-07 | ASR 并发治理：单飞（忙则丢）+ 纪元（start/stop/stopSpeaking 各 +1，await 后校验）+ 打断作废在途 + 主动作废不计失败；新增 `test-asr-concurrency.mjs`(49) | 双 tsc 0 / verify-voice 50 / voice-queue 171 / 2845 项 0 失败 | 见 git |
 | B84 | 2026-11-07 | 组件入口分身：叙述锁**持有者令牌**（诗尾 onDone 不解说书的锁）/ 说书长段只报警探针（`narrateOverdue`）/ 待命与唤醒文案改真 / `wakeHint` 恒空；新增 `test-entry-narration.mjs`(37) | 双 tsc 0 / 2845 项 0 失败 | 见 git |
 | B85 | 2026-11-07 | `tools/test-count.mjs` 精确统计断言数（逐脚本取最后汇总行），修正人工加总可能的漏项 | 39 套件 / 2845 项 / 失败 0 | 见 git |
+| B86 | 2026-11-07 | 主代理：文档口径（坑 47 叙述锁持有者 / 坑 48 ASR 单飞与纪元；并发纪律「纪元覆盖对话与 ASR」+ `clearNarrate` 只认持有者）；`VoiceStats.asrBusyDropped` 计入丢段 | 2845→2846 项 0 失败 | 4dddf98 / 4373330 |
+| B87 | 2026-11-07 | 数据端口分身：`DataPort` 增可选 `readPoemTitles`/`readMelodies`（本地 mtime 缓存+BOM 容错+拷贝隔离，云端声明即拉/缺失回退）；`poem-titles`/`culture` 端口优先、文件回退仅限方法缺失；`index.ts` 补注入 `dataPort`；`test-data-layer` 端口面 6→8；新增 `test-dataport-poem.mjs`(56) | 双 tsc 0 / 2936 项 0 失败 | 见 git |
+| B88 | 2026-11-07 | 念诗/待命分身：`poemGen` per-call 令牌（旧诗 onDone 不再清新诗的锁）/ `sayLine` 改 `bridge.ensure()`（待命关刷新后问候有声音）/ speak 抛错补 `release()` / 语音清理器不依赖 `earOn`；新增 `test-poem-narration.mjs`(34，含 3 条收尾契约) | 双 tsc 0 / 2936 项 0 失败 | 见 git |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-chubby-whale",
-  "version": "1.1.59",
+  "version": "1.1.60",
   "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/test-actions-rest.mjs && node scripts/test-misc-routes.mjs && node scripts/test-chat-client.mjs && node scripts/test-prefs-config.mjs && node scripts/test-media-reminders.mjs && node scripts/test-image-reader.mjs && node scripts/test-boundaries-guard.mjs && node scripts/test-assembly.mjs && node scripts/test-asr-concurrency.mjs && node scripts/test-entry-narration.mjs && node scripts/test-voice-bridge.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-dataport-poem.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/test-prefs-config.mjs && node scripts/test-media-reminders.mjs && node scripts/test-image-reader.mjs && node scripts/test-boundaries-guard.mjs && node scripts/test-assembly.mjs && node scripts/test-asr-concurrency.mjs && node scripts/test-entry-narration.mjs && node scripts/test-poem-narration.mjs && node scripts/test-voice-bridge.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",