round2: 看门狗礼仪F1(不重播/单句升级/idle-skip) + 分档归因F2 + 交接count-in/answer F3 + 教学看表现F4-F5 + 警报去叠F6 + 回绕F7 + 开场瘦身F8 + 10句新语音 + 测试全绿(6playtest零改动+guide52断言+资产终检)

docs/design/14-guide-layer.md

@@ -57,3 +57,60 @@
   逐个口播签名音，列为 v2 候选（需逐游戏改教学台词，涉及台词表返工）。
 - 向导插播语音目前挂在引擎 voice 队列；若游戏层 `stopVoice()` 会顺带丢弃排队中的
   向导句（作废语义，可接受）。
+
+---
+
+# 14 · 向导交互层设计裁定（round2 v1.1 增补）
+
+> 依据：research/04-playtests/round1/synthesis.md（F1~F9 + §3 新语音表，唯一事实源）。
+> 本文只做**追加**，上文 v1 基线裁定不回改；实现载体同 v1（`web/engine/guide.js`
+> + 各游戏 game.js 接线），全部改动已落地。
+
+## 5. round2 裁定落地摘要（F1~F9）
+
+| # | 裁定 | 落地 |
+|---|---|---|
+| F1.1 | storyline 看门狗礼仪 | at `[8s,20s]`→**`[25s,50s]`**；say `[gd_continue, gd_again]`；**删除升级重播 help+进度+当前节点的 `playHelpAndResume` 逻辑**（`_guideHelped` 一并移除）；两级用尽彻底静默（引擎既有）。 |
+| F1.2 | simon 25s 升级去泄题 | **取消免扣机会自动重播序列**（`_guideAutoRelisten`/`GUIDE_AUTO_RELISTEN_MAX` 删除）→ 改为 `guide.turn({haptic:true})`（confirm 震 + turn earcon，纯标记无语音）。 |
+| F1.3 | rpg PLAYER_SELECT 看门狗 | 60s→**30s**（`gd_stall` 不变）。 |
+| F1.4 | 空闲才播（idle-only） | `guide._say` 对 **error / watchdog** 两类：`audio.isVoicePlaying()` 为 true 时**跳过语音只发事件（事件带 `skipped:true`）**——修「纠错句排到语音链尾迟到误导」；**turn 保持 queue 不变**。error 的 onceKey 只在语音真的播出时才计数（没听到不算说过）。space 的 `gd_hit_hint`/`gd_last_life` 接线点随之外移到受击归因链播完后的空闲点，否则会被自家归因句判为「在播」整段跳过。 |
+| F2.1 | rhythm 教学首次归因 | 教学步**首次失败**即在纠正链（retry_* + retry_listen）播完后的空闲点发分档句：方向错 `gd_miss_wrong` / 抢拍 `gd_miss_early` / 慢拍 `gd_miss_late`；判定沿用 `_tutAttempts`（手势错 > dt<0 > dt>0），**无窗内尝试（没出手）归入 `gd_miss_late`**；第二次失败走 retry_skip 不再叠加归因。正片连 2 Miss 仍用 `gd_miss`。 |
+| F2.2 | space 受击经济透明 | 第 2 次受击在 `hit_<dir>`+`hit_last` 链播完后发 `gd_last_life`（见 F1.4 接线点说明）。 |
+| F2.3 | escape 撞墙报方位 | 撞墙在既有 `voice/wall` 播完后接既有 `guide_blunt_<dir>` 方向句（资产 v1 已有，纯逻辑接线；被下一次移动打断则自然作废）。全档位生效（游戏反馈层，非 full 档专属）。 |
+| F3.1 | rhythm 交接提前 | `gd_answer` 不再走 guide 的 queue——由 `guide.turn({})` 发 turn earcon、语音由**曲谱定时队列**（`_timed`，首个应答窗口前一小节头）在 full 档直接落下，保证窗口前听到。 |
+| F3.2 | 断点续播 count-in | 暂停菜单恢复时网格/BGM 整体后移一小节，前 4 拍用底鼓（`inst_kick` 0.7）+beat 轻震做 count-in（走既有 `_sched` 网格排程）；**off 档保持原即时续播**（零改动路径）。 |
+| F4 | rpg 教学看表现 | T2 格挡**成功**通过时插 `tut_b2b`「挡得漂亮。」再进 T3；失败路径（tut_b4）不变。 |
+| F5 | simon 经济透明 | 教学收尾链改为 t7_ready→t7_retry→**`gd_economy`**→开局（guard 12s→20s）。作为游戏规则句随教学链播（全档位），与 skip_hint 同类。 |
+| F6 | space 警报叠爆 | 警报音效按 soft/loud 两档各自 **600ms 窗口去重**（双陨石同时逼近只起一波渐强警报，单颗两段渐强不受影响）；danger 震全局限 **≥400ms** 间隔。 |
+| F7 | rpg 菜单回绕 | 探索选项列表与战斗指令循环：右滑回首项→`gd_wrap_first`、左滑到末项→`gd_wrap_last`；full 档 queue 跟在本项报名之后，**同一次菜单打开内每句最多 1 次**（`_wrapShown` 在进场景/进入玩家回合时重置）；被下一次滑动打断则自然作废。 |
+| F8 | storyline 开场瘦身 | 开场链最前插 `gd_brief`（full 档，brief→intro）；intro 长句资产保留不动。 |
+| F9 | 语速演示 | round2 会话剧本在 storyline 段演示 `settings.speed=2.2` 切换（转写可见），产品代码零改动（v1 已支持）。 |
+
+## 6. round2 新增语音资产台词表（10 句 ×2 性别 = 20 文件）
+
+全文与 synthesis §3 逐字一致；speaker/instruct 沿用各游戏旁白 pair 常量：
+
+| 游戏 | id | 全文 | 触发 |
+|---|---|---|---|
+| storyline | `gd_brief` | 单击继续剧情。请选择的时候，左右滑动。 | 开场链最前（F8，full 档） |
+| storyline | `gd_again` | 还在吗？单击继续。 | 看门狗 50s 升级（F1.1，替代重播 help） |
+| rhythm | `gd_miss_early` | 抢拍了。等声音落下再滑。 | 教学 Miss 且抢拍（F2.1） |
+| rhythm | `gd_miss_late` | 慢了半拍。跟着节拍走。 | 教学 Miss 且慢拍/没出手（F2.1） |
+| rhythm | `gd_miss_wrong` | 方向不对。跟着音色滑。 | 教学 Miss 且手势方向错（F2.1） |
+| simon | `gd_economy` | 记不住就双击重新听，免费机会有两次，用完要扣一次机会。 | 开局教学末尾（F5，全档位） |
+| space | `gd_last_life` | 这是最后一次机会，撑住。 | 第 2 次受击（F2.2，归因链后空闲点） |
+| rpg | `tut_b2b` | 挡得漂亮。 | 教学 T2 格挡成功（F4，全档位） |
+| rpg | `gd_wrap_first` | 回到第一个。 | 菜单/指令循环切回首项（F7，full 档） |
+| rpg | `gd_wrap_last` | 最后一个了。 | 循环切到末项（F7，full 档） |
+
+## 7. round2 验证记录
+
+- 6 playtest（guide=off）：**断言零改动全绿**（storyline 54 / escape 103 / simon 108 /
+  rhythm 81 / space 113 / rpg 139，与 v1 基线一致）。
+- `web/harness/guide.test.mjs` 52 断言全绿：storyline 25s/50s 新节奏 + 无重播断言、
+  simon 25s 无序列重播 + confirm 震/turn 事件、F1.4 idle-skip 直连断言（watchdog/
+  error 在播跳过 + 空闲播放 + turn 保持 queue）、off 档全静零定时器。
+- `tools/check_all_assets.py` 全绿（双格式配对、无 0 字节、全可解码、双性别集合一致）；
+  `tools/extract_voice_text.py` 已刷新 `web/harness/voice_text.json`（428 句）。
+- 转写渲染适配：实际播出的 `voice/gd_*` 由 play 捕获照常渲染；被 idle-skip 的
+  向导句单独标注「本句按 idle-only 跳过未播」。