← 返回记录总览

音频接入核查报告-2026-10-25

来源:游戏-鲸鱼魔盗团/docs/音频接入核查报告-2026-10-25.md · 7.3 KB


《鲸鱼魔盗团》音频接入核查与全量接线报告

日期: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

二、接线明细(16 个闲置资产 → 触发点)

2.1 语音 14 条

语音台词接入位置触发时机
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 条已接线语音冲突。

2.2 环境音与 UI 音效

资产接入位置说明
amb_ops.mp3audio.mjs setScene第 1–4 章(harbor/investigation)与 amb_harbor 叠加;撤离/菜单场景停止;结算/失败屏显式停止
ui.mp3main.mjs act() + UI_CLICK_ACTIONS 白名单37 个菜单/导航类动作播放;指令面板、剧情翻页等有专属音频的动作不播

2.3 行为变更说明(音频 flavor,非游戏逻辑)

三、回归守护与变异测试

scripts/verify-audio-usage.mjs(已被 verify-all.ps1 自动收录):

  1. 解析 audio.mjs 四张清单,对每个 key 断言存在≥1 个触发证据(play/playMusic/playAmbience 调用、world.mjs emit('sound') 事件源、playVoice 角色+类型组合含动态角色展开、setScene 音乐映射值、main.mjs 裸字面量——裸字面量检查前会剥掉 stop* 调用,防止"停止引用"冒充触发)
  2. 清单 ↔ 磁盘完整性:46 个登记文件全部在盘、盘中 mp3 全部登记
  3. 反向检查(信息级):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。

四、验证结果(终态,证据在 output/qa-audio-wiring/)

脚本结果
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 项检查全绿
线上发布站点未重新部署(按约定需用户当次明确要求)

六、文件清单