Bug 日志索引

排障记录共 53 篇：34 篇按日期归档、19 篇早期记录（命名规范确立前）。每篇记录现象、根因、修复与验证方式，供回归时快速比对。

写作规范见 Buglog 规范。

2026 年 8 月（12）

• 2026-08-10 @overlay 测试在 headless 下点击不可达（环境硬伤，未修复）
• 2026-08-09 model-manager 测试：@ts-nocheck 全局抑制 + 直接访问 private 字段
• 2026-08-03 E2E @web 冒烟失败：web 入口加载后未渲染 #btnMainAction
• 2026-08-03 换装/替换模型后，新模型眼睛变纯黑且不受光照影响
• 2026-08-03 用户指南 10 页缺失操作截图（README 铁律「能配图必须配图」未达标）
• 2026-08-03 babymmd 骨骼绑定告警刷屏（Binding failed 预期行为 + 生产静音）
• 2026-08-02 schema-driven E2E action 交互自动化：三类控件驱动/断言链路坑
• 2026-08-02 模型/换装/音频加载失败无提示
• 2026-08-02 镜面几何参数持久化缺失（config.json 链路断在 Go 端）
• 2026-08-02 E2E @web 冒烟失败：vite preview 4174 起不来 [主因已修，见进展]
• 2026-08-02 动作模块 ensureActive 早期 return 跳过重烤（跨模块同源 bug）
• 2026-08-01 网页版界面文本全变 key 字符串（locales/*.json 404）

2026 年 7 月（22）

• 2026-07-31 babylon-mmd -dist git 依赖产物三类 ESM 解析缺陷（build 绿但 vitest 全挂）
• 2026-07-29 自定义 slog.Handler WithAttrs 违反契约导致 exe 启动挂起
• 2026-07-28 pre-push 门禁连环阻断：三元语句 lint error + 过时测试断言
• 2026-07-25 网页端 ZIP 内子目录 PMX 贴图读取失配（多维 zip 加载不出贴图）
• 2026-07-25 网页端不同目录同名 PMX 纹理键互相覆盖（静默错渲染）
• 2026-07-21 切后台回来渲染器冻结：visibilitychange 误 disposeScene
• 2026-07-20 GroundMesh.render 崩溃：ShaderMaterial._effect 为 null
• 2026-07-19 测试修复：env-context mock 缺失 + 测试断言过时
• 2026-07-17 水面预设点击后水面消失且开关/滑条不可逆（NaN uniform 污染）
• 2026-07-17 骨骼覆盖父子骨冲突：_computeOverride weight≥1 丢弃父骨传播旋转
• 2026-07-17 ADR-124 文件系统迁移踩坑记录
• 2026-07-16 缩略图缓存 miss（网格不认图）BUG 追踪
• 2026-07-16 缩略图宽高比连环坑：从FOV误解、投影矩阵时序到UI网格自适应
• 2026-07-16 环境状态恢复失败：config.json 写入时机不可靠 + 场景文件 env 被 skipEnv 跳过
• 2026-07-15 设置菜单两处功能缺陷（2026-07-15）
• 2026-07-15 路径覆写失效：多个函数绕过 OverridePaths 导致幽灵目录与统计数据不准
• 2026-07-11 第⑤轮审核 — VMD 加载 + 图层类型安全修复
• 2026-07-11 七轮代码审核汇总（2026-07-11）
• 2026-07-11 第⑥轮审核 — perception.ts _writeMatToBuffer 优化
• 2026-07-11 第⑦轮审核 — MmdRuntimeBoneExtended 接口去重
• 2026-07-11 第④轮审核 — 光照模块 tween 功能 BUG + 资源管理
• 2026-07-11 env-water: setWorldMatrix / freezeWorldMatrix 运行时不存在于 FreeCamera

早期记录（19）

命名规范（YYYY-MM-DD-简短英文描述.md）确立前的记录，按标题排序。

• 菜单两套导航机制，AI 难重写
• 程序化动作脚穿透地面
• 程序化动作切换与缩略图截帧时序冲突
• 程序化动作应用到角色无效（动作1 / 基础槽位）
• 单一全局音量控制所有声音
• 骨骼变换覆写无效（视线追踪 程序化骨骼旋转）
• 两套物理引擎并存，性能差 3-5 倍
• 水面关掉后不恢复
• 纹理不显示：模型无颜色
• 用户 VMD 加载后角色呼吸消失
• CORS：Wails WebView 跨域被拦
• Ctrl+Space 被三个模块同时注册，静默覆盖
• grid 切换后地面变纯色，重启才恢复
• PMX 加载失败：is not pmx file
• 安全审计 CVE 记录
• Shader 404：textureAlphaChecker.vertex.fx
• UI 硬编码中文，无法切换语言
• VMD 播放无反应
• WASM 404：index_bg.wasm 无法加载