MikuMikuAR 文档

Appearance

状态: 🟢 已修复

日期: 2026-07-11 严重程度: 🔴 P1 影响范围: 全量（30+ 模块：env / lighting / VMD / proc-motion / perception / WASM 混合） 发现方式: 代码审核（七轮） 修复方案: 七轮审核共修复 3 个功能 BUG + 新增 disposeLighting + 接口去重 + 性能优化，详见各轮 buglog

七轮代码审核汇总（2026-07-11） ​

覆盖范围：环境 / 光照 / VMD / 程序化动作 / 感知 / WASM 混合 共 30+ 模块。

已修复问题索引 ​

轮次Buglog 文件核心修复
①env-water-setWorldMatrix.mdsetWorldMatrix/freezeWorldMatrix 不在 FreeCamera 继承链——调用不存在方法的潜伏 BUG
②env-particles-clouds-audit.mdgetContext('2d')! 守卫 / Vector3 复用 / 冗余 observer / instanceof 守卫
③env-impl-terrain-audit.mdedgeFadeTex 缓存泄漏 / getContext guard ×3 / 除零守卫
④lighting-tween-bugs.mdtransitionLighting animLoop 未调度 / _tweenValue 单帧中断 / disposeLighting
⑤vmd-layers-type-comments.md5 处双重 cast 安全注释
⑥perception-writeMatToBuffer.md_writeMatToBuffer for 循环 → buf.set() memcpy
⑦MmdRuntimeBoneExtended-dedup.mdMmdRuntimeBoneExtended 接口去重 + autodance re-export 修复

未修复（需后续跟进） ​

严重度问题模块
🔴 P1零测试覆盖env-clouds / env-particles / bone-override / vmd-layers / wasm-layers-blender 核心逻辑
🟠 P2超大模块（>250 LOC）lighting.ts (1229) / perception.ts (1155) / proc-motion-autodance.ts (540) / vmd-layers.ts (611)
🟠 P2实时渲染路径零测试perception.ts gaze/breathing/blink
🟡 P3循环依赖scene.ts ↔ wasm-layers-blender.ts ↔ perception.ts
🟡 P3对象池非线程安全perception.ts _v3()/_m()/_q() 下标竞争

统计 ​

  • 修复 BUG: 3 个功能 BUG（animLoop 未调度 / _tweenValue 单帧 / setWorldMatrix 不存在）
  • 新增函数: disposeLighting() 统一清理入口
  • 消除泄漏: _edgeFadeTexCache 缓存未释放
  • 消除 as any: 5 处替换为类型安全写法或精确注释
  • 消除 ! 非空断言: 5 处 getContext('2d')! 替换为 null guard
  • 接口去重: MmdRuntimeBoneExtended 从 2 个文件合并到 core/types.ts
  • 性能优化: _writeMatToBuffer memcpy / splash Vector3 复用