SoundGame/docs/design/26-apply-dungeon.md

26-apply · 《回声地窟》重构施工单（26 号文档落地）

设计单正文见 16-dungeon.md 附录 C（一句话核心动作 / 状态 / 手势表 / 等待点 / 首 3 分钟脚本 / 失败表 / 台词账目 / 断点复述），本施工单不重复， 只写：实现接线（§11）、偏差记录（§12）、台词类别映射（§8）、测试记录（§10）。 交互规则权威来源：26-audio-interaction-playbook.md、 00-global-ux.md §5.3。台词登记 16-dungeon-voice-ids.md。 本次只动交互层：地窟生成、回声编码、战斗数值、遗产经济一概不动。

1. 一句话核心动作

朝四个方向滑动在洞窟里走，单击发出声波脉冲听地形，按住屏幕问路。

2. 玩家可感知的状态（3 个）与声音身份

状态	听感	来源
探索（轮到你）	洞穴环境垫 amb_cave（静默 20s 补一层）+ 脚步/回声/怪物脚步就是状态声	§4.1 ACTION
听讲（游戏在说）	教学/遭遇/结算语音，BGM 整链压低（floor.holdDuck）	§4.1 SPEAKING
危险（战斗）	battle/boss BGM；敌方前摇音 tel_* + beat 震；血 ≤25% warning 震	ACTION + 战斗曲即状态

撞墙 = 闷响 bump + invalid 回执，不算第四态（一次性教，见 §7）。

3. 新手手势表（四向滑动是玩法 → §4.3 裁定：帮助换到长按）

手势	含义	说明
四向滑动	面朝相对移动：上=前进一格；左=向左一格并转向；右=向右一格并转向；下=后退一格（面朝不变）	swipeCore，阶段 0 即核心，不按阶梯锁
单击	脉冲（探索）；楼梯格=下潜确认；战斗我的回合=挥击；敌方前摇窗内=格挡	核心动词；旧「双击=免冷却重发」「双击=格挡」废除
长按	我在哪（层[+血 if 伤]+面朝+目标方位，≤20 字）	longpressCore；旧「按住前进」废除；对局期关闭旁白快进
双击	新手期按单击处理；阶段 3 = 重听（结算/标题重听等待点句；探索 = 冷却外再脉冲）	禁绑「立刻免冷却重播」
下滑	探索/战斗=后退/逃跑（玩法占用）；菜单仅阶段 2 且 TITLE/SETTLE	00 §5.3

管道：makeInputPipeline({ ..., opts: { swipeCore: true, longpressCore: true } }) + attachGestures(root, pipe, { doubleTapWindow: 0 })。

4. 状态 × 手势矩阵（新手期）

状态 \ 手势	单击	四向滑动	长按	双击(未解锁)	连点/乱滑
TITLE	开始/继续 + ok	右=新周目；上=元进度链；左/下(未解锁)=invalid+解释	重听询问句	按单击	计入迷茫
教学作答	按步骤（脉冲/确认）	按步骤走/转向；步骤外 invalid+inv_drill	帮助（D5 即教学内容）	按单击	计入迷茫
探索(ACTION)	楼梯格=下潜；否则脉冲+回声组（silent-ok）；冷却中 invalid+inv_pulse	移动=脚步(silent-ok)；撞墙=bump+invalid+归因+方位真话	帮助（层/血/面朝/方位）	按单击（=再脉冲）	乱滑计入迷茫；冷却连点 invalid
描述在播	跳过这句 + ok	打断并移动	打断，帮助	按单击	第一下有效
战斗·我的回合	挥击（面前才中）	左/右=转身（缠斗怪 btl_no_turn 每场一次）；下=逃跑（Boss 拒绝）；上=战斗状态	帮助（血+敌方位）	按单击	计入迷茫
战斗·敌前摇	格挡（面对 ×0.2 / 未面对 ×1.0）	左/右=转身（来得及则面对）	invalid+inv_tel	按单击=格挡	只处理第一下
DESCEND 演出	跳句 + ok	打断演出（兜底定时器续流程）	同左	按单击	busy/ok
结算(critical 链)	busy 回执（死亡/通关归因链不打断）	busy 回执	busy 回执	busy	busy
结算(等待)	再探一次 + ok	上=元进度链；左=invalid+inv_settle；下(阶段2)=菜单	重听结算句	（阶段3）重听结算句	只处理第一下
菜单	确认当前项 + ok	右=下一项 / 左=上一项（hold）；上=帮助	重听菜单说明	按单击=确认	busy
迷茫 L2 期间	照常	只放行接管方向，其余 invalid（不移动）	照常	照常	照常

验收：无空格、无「没有声音」的格子；连点/乱滑无破坏性效果（重开走菜单二次确认）。

5. 等待点配置表（教学期）与探索期接管

教学等待点（6s/15s 两档；wrong 手势 = invalid 回执 + explainOnce，三级接管后 75s 兜底自动过步）：

步	期待	指令句（full）	short
D0	单击	d0_new「黑暗。点一下，听回声。」（critical）	sys_first_tap_short「点一下。」
D1	再单击（巩固）	tut_praise + tut_front_rule（回声规则）	「点一下。」
D2	上滑（前进）	sys_turn_teach → tut_move「朝前，滑一下。」	hint_swipe「滑一下。」
D3	左/右滑（侧移转向）	tut_side_move「向左滑，转身走。」	hint_swipe
D4	走到金币格（四向）	tut_coin「房里有金币，走过去捡。」→ 拾取即 ladder.onGoal()	hint_swipe
D5	长按	tut_help_hold「迷路了，按住屏幕。」→ 帮助链即答案	「按住屏幕。」
D6	教学战：前摇单击格挡→单击挥击	tut_mob → tut_parry_tap → tut_attack	btl_turn_short「点一下，打。」
D7	自行走到楼梯→单击下潜	tut_stairs「铁器的回声，就是下潜的楼梯。」	hint_swipe

其他等待点：

id	期待	full	short	静默	L3 演示
title	tap/right	sys_first_tap / sys_continue_ask	「点一下。」	12s/30s	提示音
battle	tap/left/right	gd_turn「轮到你了。单击挥击。」	btl_turn_short「点一下，打。」	8s/15s	游戏替你挥一拳
settle	tap	settle_again「单击，再探一次。」	「点一下。」	20s/45s	提示音
menu	tap/left/right	menu_help	menu_help	20s/45s	提示音

探索期（无固定等待点，静默 40s 起每 20s 喂迷茫信号）三级接管：

级	做什么	台词
1	说目标（铁器暗示/窟主守梯，30s 台账去重）	stair_hint_a「找找铁器的回声，那是楼梯。」/ stair_hint_b
2	只放行最短路首步方向（面朝相对换算）	sys_only_*「现在，只要向左滑。」
3	听我做一次：游戏自己朝楼梯走一步	sys_demo + 脚步声 + sys_now_you

进展事件（拾取/击杀/踏上楼梯/下潜/下潜层）清零重来。

6. 首 3 分钟逐秒脚本

时间	游戏说 / 播	期待玩家做	没做	做错
0~3s	amb_cave →「黑暗。点一下，听回声。」（critical）	单击脉冲	6s：「点一下。」15s：提示音	滑动：invalid + inv_drill
3~8s	pulse + echo + 材质 →「对。」「回声回来越快，墙就越近。」	再点一次（巩固）	「点一下。」	冷却内连点：invalid + inv_pulse
8~10s	第二组回声 + 奖励音（levelup 低音量）= 第一次成功	—
10~25s	「听到这个声音，就是轮到你了。」→ 交话轮 →「朝前，滑一下。」	上滑前进	「滑一下。」	撞墙：bump + wall + wall_dir_front
25~40s	「向左滑，转身走。」→ 转身声+脚步	左/右滑侧移	「滑一下。」	其他方向也走（D3 接受左右）
40~60s	「房里有金币，走过去捡。」→ 拾金币 + onGoal	四向滑动	三档提示	撞墙归因
60~75s	「迷路了，按住屏幕。」→ 帮助链（层/面朝/楼梯方位）	长按	「按住屏幕。」	其他：inv_drill
75~90s	「前面有东西！放心，它伤不到你。」→ 教学蝠逼近	听脚步	接管	乱动：战斗内纠错
90~180s	「听到动静，单击格挡。」→ 前摇单击格挡 →「现在单击，挥拳打它」至击杀 →「铁器的回声，就是下潜的楼梯」→ 自行走到楼梯 →「楼梯就在脚下。单击，下潜。」	单击	三档/接管	挥空：btl_swish 每场一次

节奏检查 ✓：3s 内脉冲；~8s 第一次成功（听懂回声）；每 30s 有可听进展（金币/击杀/下潜）；开场零规则念白（intro_1/intro_2 砍掉）。

7. 失败表

失败类型	判定	归因句	回到哪里	新手期代价
撞墙	目标格越界	首次 wall「那边是墙。」；每方向整局一次 wall_dir_{front,left,right,back}，之后只 bump+invalid	原地	无伤
脉冲冷却	1.2s 内再点	inv_pulse「回声还没回来，稍等。」（状态×手势一次）	原地	无
挥空	怪不在面前	btl_swish 每场一次（之后只挥空声）	本回合	无
格挡失败	前摇内未点/未面对	「慢了。听到就点。」= tut_parry_miss（教学期）；背后 = btl_behind 每场一次	下回合	L1–2 怪打不死你
转身无效	缠斗怪时左右滑	btl_no_turn 每场一次，之后仅 invalid	本回合	无
死亡	HP≤0	die_cause_* 按 lastHit；die_adv_* 按真实格挡/逃跑账（critical 链，不许打断）	SETTLE→新周目，金币入 meta	学期不可能死
迷路	迷茫信号	接管 L1→L2→L3	原地	无

8. 台词表（类别标注；清单见 tools/voice_lines_26/dungeon.md）

• critical：d0_new（开场指令 <3s）；死亡链 die_intro→…→settle_again 整链（结局，§4.6）；通关链同
• content：intro 砍掉后的教学链（tut_praise/tut_move/tut_side_move/tut_coin/tut_help_hold/tut_stairs/tut_mob/tut_attack…）、st_（层/血/金/面朝/威胁）、evt_、btl_（遭遇/半血/击杀/战利）、unlock_、settle_win_*、tut_stairs_on
• hint：长按帮助链（st_floor/st_face/stair_dir_*）、gd_turn、btl_turn_short、hint_swipe、sys_first_tap(_short)、sys_continue_ask、stair_hint_a/b、menu_help
• feedback：wall、wall_dir_、inv_（pulse/title/settle/drill/tel/menu_locked）、btl_swish、btl_behind、btl_no_turn、tut_parry_miss、die_cause_、die_adv_、sys_only_*、sys_demo、sys_now_you、menu_restart_confirm
• 通用系统句与 storyline 逐字一致：sys_first_tap / sys_turn_teach / sys_say_again / sys_unlock_down / sys_unlock_dt（00 号 §5.2 阶梯表）。
• 数字全分档整句不变（层 7 / 血 4 / 面朝 4 / 威胁 4 / 战利 3 / 死因 3 / 建议 3 / 元进度 3； 金位 = meta_gold 3 档 + gold_some 真话句——旧上滑状态链的 st_gold_1..4 随链下线）。
• 净变化：新增 35、修改 4、删除 25（明细见 tools/voice_lines_26/dungeon.md）；127 → 137 句 ×2 性别。

9. 断点复述句

• 保存：拾取/战斗胜负/下潜/死亡/菜单保存/stop() 自动存（schema 1，summary 字段不变：第{floor}层 · {血量档} · 金币{meta.gold} · 遗产{n}/5）。
• 回来：TITLE 播 sys_continue_ask → 交出话轮；单击 = 恢复 + 复述链 [st_floor_N, st_hp_X, st_face_X, 楼梯方位句]（窟主未清换 stair_hint_b）→ 回 ACTION；右滑 = 新周目（meta 保留，开局 sys_new_run + 同款复述链）。

10. 测试记录

• 无头 playtest：tools/node/bin/node web/dungeon/test/playtest.mjs，11 场景 + 资产审计， 断言 1551 条全绿、退出码 0（2026-10-02，seed 42/2026 等种子复现）。覆盖：
  1. seed 复现与七层网格不变式（两次构造逐格相等 / 连通 / 楼梯=最远房 / 安全区 / 密度 / L1 教学硬约束）；
  2. 新教学链 D0~D7 全走通 + 回声调度全扫描（全地板格 ×4 面向 ===grid 真值，含延迟/音量/侧向时序）+ 下潜复现；
  3. 四向相对移动矩阵 / 撞墙归因（wall + wall_dir_* 每方向一次）/ 脉冲冷却 invalid / 双击（阶段 3）冷却外再脉冲 / 长按帮助 / 呼吸层；
  4. 战斗数学（单击格挡 ×0.2 / 缠斗纠错 / 下滑逃跑 / Boss 拒绝 / 绕位背刺 / 半血 ATK+1 / 自动喝药）；
  5. 死亡归因真话 + 遗产自动购置 + 结算 critical 链（在途手势全 busy）+ 菜单（左右滑换项 / 单击确认 / 重开二次确认）；
  6. 断点复述（stop 自动存档 / continue_ask / 复述链 / 右滑新周目 meta 保留）；
  7. 迷茫接管三级（静默 40s 起 L1 目标句 → 乱撞 L2 sys_only_* 只放行 → 连续无效 L3 演示+交回；进展事件清零重来）；
  8. 屏蔽 voice 资产流程不卡死（_sayFlow/_drillChain 兜底）；
  9. L1..L7 全网格回声一致性 + 贴身即接战；
  10. 管道契约（stateName / invalidHint / PIPELINE_OPTS = { swipeCore, longpressCore }）；
  11. §6.2 乱点机器人（150 步）：无声操作 0 / 打断失败 0（防连点 busy 回执不计——§4.2 刻意抑制且已有可听反馈）/ 被动原句重复 0 / 首次操作 ≤10s / 首次成功 ≤20s。
• 资产审计：静态引用 192 id 全量双格式（ogg+m4a）齐全；新句以 PENDING_VOICE 35 条虚拟资产 模拟（照常播放可断言），主会话生成落地后清空清单即自动转实物断言（台词数断言 127 → 137， 口径见 tools/voice_lines_26/dungeon.md「生成与验收」）。
• 真人冷启动：待测。

11. 实现接线（引擎六模块，对齐 escape 参考）

• 装配（game.js 构造器 + index.html）：this.receipts / this.floor / this.confusion / this.invalidHints(= new InvalidHints().bind(floor)) / this.ladder 全部暴露； audio.setRateBoostEnabled(false)（长按=帮助是核心手势，不触发旁白快进）。 get PIPELINE_OPTS() = { swipeCore: true, longpressCore: true }；index.html 照 escape： makeInputPipeline({ floor, confusion, receipts, invalidHints, game, ladder, opts }) + attachGestures(root, pipe, { doubleTapWindow: 0 })。
• onGesture 收口：返回 'ok' | 'hold' | 'invalid' | 'silent-ok'（移动=脚步声 silent-ok；撞墙/冷却/步骤外=invalid；转身（玩家回合）=hold 不消耗回合）。 stateName() → title/drill/explore/battle/tel/settle/menu/descend；invalidHint(state, g) → inv_pulse / inv_title / inv_settle / inv_drill / inv_tel / menu_help / locked=null （四向+长按均核心，无锁态）。
• floor 状态流：探索/教学自由步 floor.enterAction()（玩法声即状态）；描述/归因/ 帮助链走 floor.speak（_sayContent，播完回 ACTION 或等待点）；流程链 _sayFlow （自然播完或超时先到先推进，资产缺失不卡死）；教学链 _drillChain（arm 有界兜底）。 等待点 WaitPoint：drill0..7 / title / battle / settle / menu，全配 full/short/ silenceMs/expected/onDemo（§5 表）。
• confusion：record 由管道喂（新手门之前，锁定手势也喂信号）；探索态静默喂信号 40s 首次、每 8s 再喂（窗口内两记静默可累计权重 2）；onConfused → 等待点 takeover （wp.takeover），探索态/教学态走游戏侧 _takeover / _drillTakeover（三级，台账去重）。
• novice 阶梯：D4 拾金币 = ladder.onGoal()（阶段 1；返回的 up 教学对四向玩法 无意义，与 escape 同样忽略）；死亡/通关 = ladder.onGameDone()（阶段 2/3），返回的 teachLine（已带 voice/ 前缀，2026-10 novice.js 修复后不要再加前缀）接在结算链尾。
• 存档：schema 1、summary 第{floor}层 · {血量档} · 金币{meta.gold} · 遗产{n}/5 字段不动；拾取/战斗/下潜/死亡/菜单/stop() 自动存。

12. 偏差记录（与 26 号/16 号的落地差异及理由）

1. D1 巩固步等待点不即时挂：设计单口径「巩固等待立即挂上」，实现改为回声组落地 （+1.3s）后播规则链、链播完才 yieldTurn——管道契约是「onGesture 返回时 floor 在 YOUR_TURN 即视为完成当前等待点」，手势内同步 yieldTurn 的新等待点会被当已完成摘掉， 随后 invalid 解释链播完无人恢复话轮（floor 停 BUSY 吞手势，D1 卡死根因）。0~1.3s 窗口由回声组内容音覆盖；窗口内抢先单击照常成立（case 1 直答）。
2. 孤儿 BUSY 看门狗（_healOrphanBusy，800ms 周期，仅 stop() 停）：引擎 InvalidHints 解释链的 onDone 只在「挂着等待点」时恢复话轮，探索/教学自由步没有 等待点，链播完 floor 停 BUSY——管道在 floor.handleInput 就拦下 busy，游戏层永远 收不到手势。看门狗按当前态拉回规范态（探索=ACTION / 答题步=重挂等待点 / 前摇= ACTION / TITLE·SETTLE=重交话轮）。引擎缺口：InvalidHints/feedback 链结束后 的状态恢复依赖调用方，建议引擎侧统一兜底（escape 用无条件 resumeTurn 达成同效）。
3. 教学态接管不走 wp.takeover：其 L2（restrictLine/short 兜底）无 30s 台账检查， 会把刚说过的指令句原样重播，违反「被动原句重复 = 0」红线；改走游戏侧 _drillTakeover（L1 短句 → L2 重教指令句 → L3 _drillDemo，全过台账）。 引擎缺口：WaitPoint.takeover(2) 建议补台账去重。
4. 战斗玩家回合转身返回 hold：转身不消耗回合，hold 让管道 settleWaitPoint(false) 保住战斗等待点（血量/敌方位长按链播完要回它；silent-ok 会把等待点当已完成摘掉）。
5. D4 推进走 1.6s 有界定时：evt_coin 链被乱手势打断也不丢 onGoal/进 D5（对齐 _sayFlow 兜底语义，步骤号先守恒）。
6. tut_praise 不进 D4 链：原则 9 逐字重复禁令（D2/D3 已各一次「对。」），D4 直接 布置任务 tut_coin。
7. 遭遇自动面对落在 _encounter：走进怪格/相邻扑来先把玩家面朝转到怪的方向 （报名「就在你面前」即真话），保证 D6 单击格挡教学确定性（16 号 §5「遭遇自动面对」）。
8. btl_no_turn 补 onDone：链播完回战斗等待点（无 onDone 会孤儿 BUSY，见偏差 2）。
9. 教学不存步骤：断点回来教学未完从头再练（16 号 §10 口径），DRILL 步骤不进存档。