第二批反馈：引擎改造(限幅/SoundTouch不变调变速/长按快进/跳句/iOS闪光降级) + 6游戏状态BGM与试玩测试全绿

2026-08-30 16:45:42 +08:00
parent cc0f8c008d
commit 9a915d62c0
1163 changed files with 6346 additions and 208 deletions
@@ -37,7 +37,7 @@

 ### storyline《声命线》

- voice 双性别版（male/ 与 female/ 各 36 条）：旁白 + 系统音 = `help menu status1 status2 status3 p1–p8 n00_intro n01_wake n04_exit n05_signal n06_whistle n08_vent n09_dead n10_rain n11_child n13_leave n14_ignore n15_bridge n16_culvert n16b_culvert_c n17_cable n17b_cable_c n20_convoy n22_fight n23_tower e1_dawn e2_price e3_alone e4_static`
+- voice 双性别版（male/ 与 female/ 各 37 条（R6 +`skip_hint`）：旁白 + 系统音 = `help menu status1 status2 status3 p1–p8 n00_intro n01_wake n04_exit n05_signal n06_whistle n08_vent n09_dead n10_rain n11_child n13_leave n14_ignore n15_bridge n16_culvert n16b_culvert_c n17_cable n17b_cable_c n20_convoy n22_fight n23_tower e1_dawn e2_price e3_alone e4_static`
 - voice 角色台词（**不做双性别**，沿用平铺原文件）：

  | 角色 | speaker | 文件 id |
@@ -50,45 +50,52 @@

  约定：角色台词在两个性别目录下使用**同一份文件**（由开发复制/链接或引擎回退到平铺目录，见 round1-report）。
 - sfx（12）：`footsteps gunshot heartbeat radio_static rubble signal_beep struggle ui_confirm ui_menu water whistle wind`
- bgm（1）：`dark_drone`
+- bgm（2）：`dark_drone`（剧情）+ R6 新增 `menu`（菜单 pad，-24 LUFS 档）

 ### escape《暗室》（R2 重设计版，最终清单见 `round2-voice-ids.md`）

- voice 双性别版（male/ 与 female/ 各 74 条）：引导 `g0_intro g1_move g1_done g2_wall g3_left g4_down g5_inspect g5_key g6_doubletap g6_done g7_goal`、引导纠错 `guide_wrong_* guide_blunt_* guide_offpath guide_skip reopen_prompt`、三级提示 `stuck_ask stuck_{key,cabinet,box,gate}_{1,2,3}`、导航 `nav_{up,down,left,right}`、房间 `room_{storage,cabinet,power,gate}`、用时 `time_band1–4`、保留句 `wall start_room found_key inspect_* unlock_cabinet box_fixed fix_box escape use_fail inv_* replay again empty_1–3`、菜单 `help_ops menu_*`
+- voice 双性别版（male/ 与 female/ 各 75 条（R6 +`skip_hint`）：引导 `g0_intro g1_move g1_done g2_wall g3_left g4_down g5_inspect g5_key g6_doubletap g6_done g7_goal`、引导纠错 `guide_wrong_* guide_blunt_* guide_offpath guide_skip reopen_prompt`、三级提示 `stuck_ask stuck_{key,cabinet,box,gate}_{1,2,3}`、导航 `nav_{up,down,left,right}`、房间 `room_{storage,cabinet,power,gate}`、用时 `time_band1–4`、保留句 `wall start_room found_key inspect_* unlock_cabinet box_fixed fix_box escape use_fail inv_* replay again empty_1–3`、菜单 `help_ops menu_*`
 - voice 已删除（R2）：`n0–n9 nshi unit_min unit_sec time_prefix intro tutorial hint_key hint_cabinet hint_box hint_gate`（整句化替代）；平铺 `voice/` 旧文件全部移除
 - sfx（16）：`amb_drip amb_hum amb_wind`（保留）+ R2 新增 `amb_storage amb_cabinet amb_power amb_gate amb_gate_live`（Stable Audio 3，6s，统一 -25dB 均值，storage/power 偏左、cabinet 偏右 pan）+ `door_creak gate_open pickup power_on spark step unlock wall win_chime`；已删除 `ui_deny`（反馈改震动）
- bgm（1）：`drone`
+- bgm（2）：`drone`（探索）+ R6 新增 `menu`（菜单/结算 pad）

 ### simon《音序回响》（R2 重设计版，最终清单见 `round2-voice-ids.md`）

- voice 双性别版（male/ 与 female/ 各 68 条）：交互教学 `t0_welcome t0_goal t1_up–t6_double t_try t_ok t_wrong_* t_blunt_* t7_ready t7_retry t_skip`、轮次 `round_01–round_20 round_more`（整句）、成绩 `score_band1–6`（整句）、流程 `your_turn chances_out retry_use relisten replay rules_prompt rules gameover`、反馈 `correct wrong chance_plus new_record`、菜单 `menu_*`
+- voice 双性别版（male/ 与 female/ 各 69 条（R6 +`skip_hint`）：交互教学 `t0_welcome t0_goal t1_up–t6_double t_try t_ok t_wrong_* t_blunt_* t7_ready t7_retry t_skip`、轮次 `round_01–round_20 round_more`（整句）、成绩 `score_band1–6`（整句）、流程 `your_turn chances_out retry_use relisten replay rules_prompt rules gameover`、反馈 `correct wrong chance_plus new_record`、菜单 `menu_*`
 - voice 已删除（R2）：`di lun num_shi num_0–num_9 score_pre best_pre`（拼接件）+ `intro teach_* listen`（旧连播教学）；平铺 `voice/` 旧文件全部移除
 - sfx（7）：`gameover tone_doubletap tone_down tone_left tone_right tone_tap tone_up`；已删除 `correct wrong newrecord`（反馈改震动）
- bgm：**已于 R1 按用户要求移除**（原 `theme`，代码引用由开发删除）
+- bgm：游玩**无 BGM**（用户要求）；R6 新增 `menu`（菜单/结算极轻 pad，volume 0.3，10 文档 §4）

 ### rhythm《节拍行者》（R3 重构版，台词依据 `docs/design/03-rhythm-voice-ids.md`）

- voice 双性别版（male/ 与 female/ 各 31 条）：开场流程 `welcome welcome_back tut_1 tut_2 tut_3 tut_done tut_skip mid_song`、教学纠正 `retry_early retry_late retry_gesture retry_listen retry_skip`、选曲解锁 `select_hint song1_name song2_name song3_name song_locked unlock_song2 unlock_song3`、结算 `grade_s grade_a grade_b grade_c new_best_combo restart`、菜单规则 `rules settings_hint menu_main menu_resume menu_lobby`
+- voice 双性别版（male/ 与 female/ 各 32 条（R6 +`skip_hint`）：开场流程 `welcome welcome_back tut_1 tut_2 tut_3 tut_done tut_skip mid_song`、教学纠正 `retry_early retry_late retry_gesture retry_listen retry_skip`、选曲解锁 `select_hint song1_name song2_name song3_name song_locked unlock_song2 unlock_song3`、结算 `grade_s grade_a grade_b grade_c new_best_combo restart`、菜单规则 `rules settings_hint menu_main menu_resume menu_lobby`
 - voice 已删除（R3）：`tut_start`（平铺旧 id 全部移除，其余旧 id 均在 R2 已替换）
 - voice 修订（R5）：`menu_main` 改词重录为「菜单。单击切换选项，双击确认。」（对齐 round2-review 裁决②全球菜单约定；选曲界面非模态菜单不受影响）
 - sfx（7，R3 补齐）：`inst_kick inst_snare inst_hat_l inst_hat_r inst_tom_hi inst_tom_lo inst_accent`（演奏乐器音，详见 round3-report §7；hat_l 闭合镲极左 / hat_r 开放镲极右，accent 为 A minor 合成亮音）；已删除 `judge_* tick tick_accent`（R3）与 `cue_*`（R3 收尾，重构不再使用指令音）
- bgm（3，R3 重制）：`track90`（90.01 BPM，85.33s）`track105`（104.99 BPM，73.14s）`track120`（120.00 BPM，72.00s），A minor 电子乐，整数小节无缝循环，loudnorm -20 LUFS；旧 `groove` 已删除
+- bgm（3，R3 重制）：`track90`（90.01 BPM，85.33s）`track105`（104.99 BPM，73.14s）`track120`（120.00 BPM，72.00s），A minor 电子乐，整数小节无缝循环，loudnorm -20 LUFS；旧 `groove` 已删除；R6 新增 `menu`（选曲/结算 pad）

 ### space《盲航》（R3 备产，台词依据 `docs/design/04-space-voice-ids.md`）
- voice 双性别版（male/ 与 female/ 各 52 条）：演练 `drill_*`（14）、保护期 `protect_*`（5）、功能引入 `feat_* shield_ready shield_block`（6）、被撞归因 `hit_*`（5）、里程碑 `ms_10 ms_25 ms_50 ms_100`、结算 `time_1–4 dodge_1–4 new_record restart_hint`、菜单系统 `second_run_ask menu_* help_recap settings_hint paused`
+- voice 双性别版（male/ 与 female/ 各 53 条（R6 +`skip_hint`）：演练 `drill_*`（14）、保护期 `protect_*`（5）、功能引入 `feat_* shield_ready shield_block`（6）、被撞归因 `hit_*`（5）、里程碑 `ms_10 ms_25 ms_50 ms_100`、结算 `time_1–4 dodge_1–4 new_record restart_hint`、菜单系统 `second_run_ask menu_* help_recap settings_hint paused`
 - voice 修订（R4）：`menu_main` 改词重录为「菜单。单击切换选项，双击确认。」（对齐 round2-review 裁决②全球菜单约定）
 - voice 已删除（R3）：`num0–9 num_shi num_bai n_time n_sec n_dodge n_ge n_milestone intro1–4 hit1 hit2 gameover restart`（数字拼接与旧教学弃用）；平铺旧文件全部移除
 - sfx（12）：`alarm boost crash dodge hit shield shield_block whoosh_down whoosh_left whoosh_right whoosh_up`
- bgm（1）：`engine`
+- bgm（2）：`engine`（对局）+ R6 新增 `menu`（菜单/结算 pad）

 ### rpg《剑与声》（R4 新游戏第一章，台词依据 `docs/design/05-rpg-ch1-voice-ids.md` + `05-rpg-addendum.md`）

- voice 旁白双性别版（male/ 与 female/ 各 108 条，male=Uncle_Fu 说书人 / female=Serena 武侠故事）：序章 `intro_1–3`、系统状态 `sys_* help_* settings_hint st_*`、场景 `desc_*`（16）、选项 `opt_*`（18）、事件 `evt_*`（6）、战斗 `btl_* cmd_* tut_*`（27，含 R5 补录 `btl_half_bandit`）、商店 `shop_*`（7）、敌方档位 `foe_hp_high/mid/low`（addendum §6.2 补录）
+- voice 旁白双性别版（male/ 与 female/ 各 113 条，male=Uncle_Fu 说书人 / female=Serena 武侠故事）：序章 `intro_1–3`、R6 新增首次战斗教学 `tut_battle_1–5`、系统状态 `sys_* help_* settings_hint st_*`、场景 `desc_*`（16）、选项 `opt_*`（18）、事件 `evt_*`（6）、战斗 `btl_* cmd_* tut_*`（27，含 R5 补录 `btl_half_bandit`）、商店 `shop_*`（7）、敌方档位 `foe_hp_high/mid/low`（addendum §6.2 补录）
 - voice NPC 单音色平铺（14 条，落 `voice/` 根，引擎平铺回退）：村长 `npc_headman_1–4`（Uncle_Fu·慈祥和缓）、老猎人 `npc_hunter_1–4`（Eric·沙哑豪爽）、寨丁头目 `npc_elite_1/half/die`（Dylan·凶狠）、黑风寨主 `npc_boss1_1/2/die`（Uncle_Fu·低沉阴狠，与村长同 speaker 不同 instruct）
 - sfx（35）：前摇 `tel_wolf tel_bandit tel_spider tel_elite tel_boss1 tel_croc tel_shaman tel_puppet tel_boss2`（1.0s 格挡窗口）；战斗 `atk_swing atk_hit parry skill_slash enemy_die potion` + SYN `hurt flee`；探索 `chest drink_water rest door_heavy` + SYN `step coin levelup`；环境 `amb_village amb_path amb_fork amb_chest amb_stream amb_hunter amb_deepwood amb_gate amb_hall amb_swamp amb_peak`（5s 无缝循环，均值 -25dB）；`ui_deny` 按设计不做
- bgm（4，Mureka）：`village battle boss ending`（90s 无缝循环，loudnorm -20）；探索期无音乐（addendum §3），`amb_*` 由游戏层手动 loop 接 sfx 总线
+- bgm（6，Mureka）：`village battle boss ending`（R4）+ R6 新增 `menu`（菜单 pad）与 `explore`（探索轻垫乐，10 文档 §7 恢复，volume 0.35）；90s 无缝循环；`amb_*` 由游戏层手动 loop 接 sfx 总线
 - 再生成方法见 `web/rpg/gen/README.md`

+## 响度与爆音标准（R6 起）
+
+- sfx one-shot：峰值归一 **-3dBFS**（真峰值经 ogg 解码回读校验，见 round6-report §1）；首尾 8ms cos² 淡入淡出；去直流。
+- loop（amb_*/bgm）：首尾交叉淡化保证循环连续，不加淡入淡出；仅做直流/峰值检查。
+- voice：沿用 R1 峰值 0.89 归一策略，不动。
+- bgm：loudnorm -20 LUFS（主题曲）/ -24 LUFS（menu pad）。
+
 ## 发音质量

 ### 本轮已采取的规避措施
@@ -2,12 +2,12 @@

 | 游戏 | ogg | m4a | 0字节 | 解码失败 | voice male/female id 一致 |
 |---|---|---|---|---|---|
-| storyline | 133 | 133 | 0 | 0 | ✅ 各 36（平铺 48 个角色/NPC 句，豁免） |
-| escape | 166 | 166 | 0 | 0 | ✅ 各 74 |
-| simon | 143 | 143 | 0 | 0 | ✅ 各 68 |
-| rhythm | 72 | 72 | 0 | 0 | ✅ 各 31 |
-| space | 116 | 116 | 0 | 0 | ✅ 各 52 |
-| rpg | 269 | 269 | 0 | 0 | ✅ 各 108（平铺 14 个角色/NPC 句，豁免） |
+| storyline | 136 | 136 | 0 | 0 | ✅ 各 37（平铺 48 个角色/NPC 句，豁免） |
+| escape | 169 | 169 | 0 | 0 | ✅ 各 75 |
+| simon | 146 | 146 | 0 | 0 | ✅ 各 69 |
+| rhythm | 75 | 75 | 0 | 0 | ✅ 各 32 |
+| space | 119 | 119 | 0 | 0 | ✅ 各 53 |
+| rpg | 283 | 283 | 0 | 0 | ✅ 各 114（平铺 14 个角色/NPC 句，豁免） |

 ## 结论

@@ -15,6 +15,7 @@

 ## 附注

- storyline 平铺 48 个 = 12 个角色台词（林晚/猎狗/小满/林晨/广播，单音色永久保留）+ 36 个 R1 旁白旧文件（与 male/ 内容重复的遗产，待引擎切换验证后清理，见 round1-report §2）。
- rpg 平铺 14 个 = NPC 句（设计如此，单音色）。
- 终检脚本：`tools/check_all_assets.py`（可重复执行）。
+- storyline 平铺 = 角色台词（单音色永久保留）+ R1 旁白旧文件（遗产，待清理）。
+- rpg 平铺 = NPC 句（设计如此，单音色）。
+- R6 起 sfx 峰值标准为 -3dBFS（真峰值经解码回读校验）；voice 目录响度策略不变（峰值 0.89）。
+- 终检脚本：`tools/check_all_assets.py`；爆音扫描/修复：`tools/scan_clicks.py` / `tools/fix_clicks.py`。
@@ -0,0 +1,60 @@
+# R6 音频轮次报告（2026-08-30，音乐音效总监）
+
+本轮主题：爆音资产排查修复 + 状态 BGM 7 首 + RPG 战斗教学/全局跳过提示语音。Mureka 本轮 $0.21 / $1.00，**累计 $0.63 / $2.00**。
+
+## 1. 爆音排查与修复
+
+**工具**：`tools/scan_clicks.py`（扫描）/ `tools/fix_clicks.py`（修复），全程可复跑；原件备份在 `tools/asset_fix_backup/`（71 个文件）。
+
+**扫描口径**：峰值 >-1dBFS / 首尾电平突变（首末 1ms 幅值 > 局部 50ms 峰值 15%，局部低于 -40dB 的静音区不判）/ 直流偏置 |DC|>0.001。voice 目录按任务要求**不动**（峰值 0.89 归一策略保留）。
+
+**初扫结果（899 个 ogg 全量）**：
+
+| 类别 | 数量 | 说明 |
+|---|---|---|
+| sfx/bgm 峰值过热 | 27 | 其中 rpg 15 个 SA3 one-shot 解码峰值高达 +0.9~+6.6dBFS（真·爆音源） |
+| sfx/bgm 直流偏置 | 43 | 最大 0.076（rpg/atk_swing） |
+| sfx/bgm 首尾突变 | 48 | 老资产无淡入淡出（storyline/escape/simon/space 为主） |
+| voice 过热 | 340 | 不修（语音响度策略不动，见任务说明） |
+
+**根因发现（重要）**：R4 的 rpg SA3 one-shot 源是近满幅高密度波形（rms 0.84 / 峰值 0dBFS，>15kHz 能量 22%），MDCT 有损编码（vorbis/aac/opus 全部）重建时过冲 +4~8dB——ffmpeg `volumedetect` 走 s16 中间格式把超幅削到 0.0dB 显示，**之前的 QC 完全没发现**。本轮修复 encode 环节改为「编码→解码回读真峰值→超 -3dB 则降增益 + 首轮 18kHz 低通→重编」（最多 3 次迭代）。
+
+**修复结果**：71 个 sfx/bgm 文件重处理（storyline 10 / escape 10 / simon 7 / rhythm 7 / space 11 / rpg 26），统一标准：one-shot 去直流 + 首尾 8ms cos² 淡入淡出 + 峰值 -3dBFS（真峰值校验后）；loop（amb_*/bgm）只去直流（交叉淡化循环不加首尾淡入淡出，避免破坏循环）。rpg one-shot 从 staging 无损 wav 重做，其余从备份初代源修复（避免多次有损转码）。
+
+**复扫（终态）**：sfx/bgm 99 个 —— 过热 0 / 直流 0 / 首尾突变 0。**全绿。**
+
+## 2. 状态 BGM（7 首，docs/design/10-feedback2-state-bgm.md）
+
+| 资产 | task id | 响度 | 成品 |
+|---|---|---|---|
+| storyline `bgm/menu` | 158096439705601 | -24 LUFS（menu pad 档） | 90s 循环，mean -24.4dB |
+| escape `bgm/menu` | 158096580149249 | -24 | mean -26.1dB |
+| simon `bgm/menu` | 158096714629126 | -24（引擎再按 volume 0.3） | mean -25.8dB |
+| rhythm `bgm/menu` | 158096850812929 | -24 | mean -25.3dB |
+| space `bgm/menu` | 158097039425538 | -24 | mean -25.1dB |
+| rpg `bgm/menu` | 158097182294017 | -24 | mean -25.9dB |
+| rpg `bgm/explore`（恢复） | 158097360420865 | -20（引擎 volume 0.35） | mean -22.3dB |
+
+全部一次成功选候选 0；强 onset 起点 + 90s + 3s crossfade 无缝循环 + ogg q3/m4a。既有主题曲全部不动（storyline dark_drone、escape drone、rhythm track90/105/120、space engine、rpg village/battle/boss/ending）。状态→BGM 映射与切换时机以 10 文档 §2-§7 为准。
+
+## 3. 新语音（22 条，双性别）
+
+| id | 游戏 | 条数 | 文案 |
+|---|---|---|---|
+| `tut_battle_1..5` | rpg | 5×2 | 首次战斗教学：回合制说明 / 左右滑选招式单击出手 / 听前摇双击格挡 / 防御减半与金疮药 / 开场收束 |
+| `skip_hint` | 全 6 游戏 | 1×2×6 | 「单击可跳过旁白。」（各游戏既有 instruct 常量） |
+
+均已合入 `tools/gen_voice_dual.py` 台词表并落盘 male/female 双格式。rpg 旁白现 113 id ×2（+NPC 14 平铺）。
+
+## 4. 给游戏层的接线约定
+
+1. **菜单/结算音乐**：所有游戏统一 `bgm/menu` id；切换时机与淡入时长按 10 文档逐游戏表（storyline 500ms、escape 400ms/结算 1500ms、simon 600ms/结算延后 1000ms、rhythm 800ms、space 300ms、rpg 战斗 400ms 快切）。
+2. simon 游玩全程不得加载任何 bgm；`bgm/menu` 仅菜单与结算，volume 0.3。
+3. rpg 双层：BGM 层报状态（menu/explore/village/battle/boss/ending），sfx 层 amb 报场景（手动 loop 接 `_sfxBus`，不变）；胜利过渡 = battle 淡出 1500ms → explore 淡入 2000ms。
+4. `tut_battle_1..5`：首场战斗（enc_teach_wolf）B_START 时按序链播，二周目起跳过；`skip_hint` 为备选通用句，接入与否由游戏层定。
+5. `bgm=0` 时全部状态音乐不加载（含 menu pad 与 space engine——10 文档 §1.5 裁定）。
+
+## 5. 复跑与终检
+
+- `tools/check_all_assets.py` 终检已更新（`docs/audio/final-asset-check.md`）：928 ogg + 928 m4a，双格式/0 字节/解码/性别集合一致性全绿。
+- 遗留：voice 层 340 个文件峰值 >-1dBFS 属 R1 既定归一（0.89 峰值），非爆音（有 TTS 天然淡入）；如需统一可考虑 R7 评估，但会破坏既有响度平衡，不建议。