日期:2026-10-25 | 范围:游戏-鲸鱼魔盗团(源码 + dist + 游戏发布快照)| 方法:静态引用追踪(清单 ↔ 播放入口 ↔ 打包产物三方对账)+ 运行时守护脚本 + mutation test
| 问题 | 结论 |
|---|---|
| 46 个音频文件是否登记进游戏清单 | ✅ 已全部登记(src/game/audio.mjs 四张表 + assets/runtime-catalog.json 46 条 + assets/provenance/audio-manifest.json) |
| 接线前运行时实际播放 | ⚠️ 仅 30/46;16 个登记但无触发点(14 语音 + amb_ops + ui),约 554 KB |
| 接线后运行时实际播放 | ✅ 46/46 全部有触发点(守护脚本静态证明) |
| 主项目 dist | ✅ 已重建(148 文件 / 46 mp3 / verify-build 0 缺失),音频全部在包内 |
| 游戏发布快照 dist(原 P0) | ✅ 已刷新:原为接线前旧构建(0 mp3),现 46 mp3 全部入包,8 项接线检查全绿 |
| 回归守护 | ✅ 新增 scripts/verify-audio-usage.mjs:任何资产被摘除触发点即 FAIL;7/7 mutation 全杀 |
| 遗留(非本次引入) | ⚠️ verify-world.mjs 五章模拟通关 FAIL——并行会话 17:06 改写 world.mjs 诱饵逻辑所致,与音频接线零耦合(该脚本不引用 main.mjs/audio),基线 16:54 曾 PASS |
| 语音 | 台词 | 接入位置 | 触发时机 |
|---|---|---|---|
| voice_hero_confirm | 收到,出发! | main.mjs worldEvent command-receipt | 每章首次指令成功执行(chapterOrderPlayed 章节级一次性) |
| voice_hero_charge | 冲锋! | main.mjs storyMotionSound voices 表 | 剧情 fx water(鲸形冲刺) |
| voice_hero_scan | 扫描完成! | main.mjs storyMotionSound 说话人判别 | 剧情 fx scan 且说话人为 DeepSeek(序章观察) |
| voice_grok_charge | 就是现在,冲! | storyMotionSound voices 表 | 剧情 fx impact(破障) |
| voice_grok_pickup | 数据到手啦! | worldEvent sound 分支 | delivery 数据交付 |
| voice_grok_cheer | 嘿嘿,小菜一碟! | worldEvent chapter-result | 章末结算 |
| voice_grok_evacuate | 走走走,别磨蹭! | worldEvent evacuation-status | 与 hero_evacuate 按里程碑轮换(奇数次播 Grok) |
| voice_claude_analyze | 正在分析…… | worldEvent analysis-open | 打开分析面板 |
| voice_claude_careful | 小心些,慢慢来。 | worldEvent sound 分支 | guard-warning 守卫逼近(第 5 章) |
| voice_claude_record | 记录已归档。 | storyMotionSound voices 表 | 剧情 fx record(×9 次出现) |
| voice_claude_alert | 发现异常,请留意。 | worldEvent sound 分支 | alarm 警戒器报警 |
| voice_glm_scan | 扫描完成,一切正常。 | storyMotionSound voices 表 | 剧情 fx scan 非 DeepSeek 说话人(GLM 扫描,×3) |
| voice_glm_warn | 警戒值上升,请注意。 | ① frame() 警戒 false→true 转换;② storyMotionSound fx alert | 警戒值跨 70 阈值 / 剧情警报节拍 |
| voice_glm_route | 撤离路线已计算完毕。 | storyMotionSound voices 表 | 剧情 fx beacon(返航信标,×14 次出现) |
设计约束:每条剧情节拍最多播 1 条语音(取首个命中 fx),语音 8 秒/条冷却(hero_encourage 6 秒),不与现有 6 条已接线语音冲突。
| 资产 | 接入位置 | 说明 |
|---|---|---|
| amb_ops.mp3 | audio.mjs setScene | 第 1–4 章(harbor/investigation)与 amb_harbor 叠加;撤离/菜单场景停止;结算/失败屏显式停止 |
| ui.mp3 | main.mjs act() + UI_CLICK_ACTIONS 白名单 | 37 个菜单/导航类动作播放;指令面板、剧情翻页等有专属音频的动作不播 |
evacuation-status 语音由"每次 hero_evacuate"改为 hero/grok 轮换——让两条撤离语音都有播出机会,首次通知仍为 hero。chapter-result / 失败屏新增 stopAmbience('ops'),防止机房氛围音漏进结算屏。scripts/verify-audio-usage.mjs(已被 verify-all.ps1 自动收录):
emit('sound') 事件源、playVoice 角色+类型组合含动态角色展开、setScene 音乐映射值、main.mjs 裸字面量——裸字面量检查前会剥掉 stop* 调用,防止"停止引用"冒充触发)guard-warning 事件无对应文件,走合成器兜底(既有设计,未改)mutation test(scripts/mutation-audio-usage.mjs,7/7 全杀):
| # | 变异 | 守护反应 |
|---|---|---|
| M1 | 删 delivery→grok_pickup 分支 | KILLED(grok_pickup 成孤儿) |
| M2 | 删 setScene 的 playAmbience('ops') | KILLED(ops 成孤儿;首轮曾存活——裸字面量被 stopAmbience('ops') 冒充证据,已修守护) |
| M3 | 删剧情 beacon→glm_route 映射 | KILLED |
| M4 | 删 grok_evacuate 轮换调用 | KILLED |
| M5 | 摘除清单中 glm_warn 条目 | KILLED(磁盘完整性:文件在盘未登记) |
| M6 | 删 hero_scan 说话人判别 | KILLED |
| M7 | 删 alarm→claude_alert 分支 | KILLED |
基线 PASS → 每条变异 FAIL → 还原后字节级一致且 PASS。
| 脚本 | 结果 |
|---|---|
| verify-audio-usage(新) | ✅ PASS 46/46 全触发 |
| mutation-audio-usage(新) | ✅ 7/7 killed |
| build-game + verify-build | ✅ 148 文件 / 46 音频 / 0 缺失引用 |
| verify-core / verify-main-flow / verify-story-ui / verify-input / verify-experience / verify-runtime-save | ✅ PASS |
| verify-story-flow | ✅ 18/18 PASS(修复 harness:补 storyArtFor/Image/FakeAudio 完整音频面——该缺口源于 16:09 音频接线与 17:03 剧情美术预埋改动未同步测试桩,非本次引入) |
| verify-stress-main | ✅ 5/5 PASS(2050 次转换) |
| verify-world | ❌ FAIL(五章模拟通关 health-depleted @close-hatch)——并行会话 17:06 改写 world.mjs 诱饵逻辑所致;该脚本纯世界模拟、不引用 main.mjs/audio,与音频接线零耦合;16:54 基线曾 PASS。待并行会话修复后复跑 |
| 产物 | 状态 |
|---|---|
| 游戏-鲸鱼魔盗团/dist | ✅ 46 mp3 + 完整清单 + 全部接线的 main.js/audio.js |
| 游戏发布快照/dist | ✅ 已刷新(src/assets/dist/index.html/story-theater.html 同步自主项目),46 mp3 入包,8 项检查全绿 |
| 线上发布站点 | 未重新部署(按约定需用户当次明确要求) |
src/game/audio.mjs(setScene 叠 amb_ops)、src/main.mjs(14 语音 + ui 音效接线,纯增量)scripts/verify-audio-usage.mjs(守护)、scripts/mutation-audio-usage.mjs(变异测试)、scripts/refresh-snapshot.mjs(快照刷新)scripts/verify-story-flow.mjs(VM 测试桩补 storyArtFor / Image / FakeAudio 音频面)output/qa-audio-wiring/*.txt