MikuMikuAR 文档

Appearance

v1.8.0 ​

新功能 ​

纹理系统 (ADR-189 延伸) ​

  • 多候选路径 fallback：深子目录贴图可被带目录前缀的 PMX 声明命中
  • 声明路径别名注册：目录名异写兜底（tex\ vs Texture\）
  • 检测 PMX 声明但缺失的纹理并提示用户
  • 统一资源加载失败汇总提示（模型纹理 / 换装 / 音频缺失）

声明式菜单与交互自动化 (ADR-229) ​

  • schema-driven 交互行为自动化（action 字段），导航元数据上移注册器
  • DOM 契约统一：dom-contract 单源 + 快照携带选择器 (§9)
  • 菜单 schema 快照泛型化

地面视觉 (ADR-231) ​

  • 地面自发光地屏 + scan / glowEdge 叠加落地
  • 镜面几何参数迁入 envState，修复持久化缺失
  • 地面 scan 环动画覆盖贴图地面，相位连续不跳变

材质与渲染 ​

  • KTX2 转码挂到设置开关（修复 toktx v4.4.2 语法）
  • SSS 材质类型收窄与鸭子类型标记移除
  • 抗锯齿唯一入口移至设置页，后处理面板增加还原默认
  • AI 灯光守卫用户反馈

程序化动作与运动 ​

  • proc-motion 深拷贝与 per-mode 兜底参数修复
  • 程序化动作统一进动作详情页 (ADR-207)
  • 程序化动作覆盖审计收尾 (P3/P4)

工程治理 ​

  • ADR 取代关系扫描脚本 gen-adr-supersede + 文档守护链补全（funcmap / menumap / 路由冲突检测）
  • 用户指南自动生成文档索引 + 指南覆盖缺口扫描 gen-guide-gap

修复 ​

  • 镜面几何参数持久化缺失
  • 守卫拒绝日志去重，过渡动画测试补全
  • 水下焦散守卫 + 地形原地 emissive（ADR-231 P1/P2）
  • e2e 渲染后端稳定性：vitePage 改用 --use-gl=swiftshader / ANGLE 绕开共享内存 bug
  • 12 处 🟠 P2 + 3 处 🔴 P1（五会话审计遗留）修复
  • 渲染过渡失效 / 水下焦散门控 / SSS 落盘与自动保存

工程 ​

  • E2E 分级门禁：快烟阻塞 + 全量非阻塞 (@dom 标记非阻塞，headless 无 GPU 环境硬伤)
  • 文档自动化工具链：frontmatter 字段语义校验、ADR supersede --check 仅对漏标(②)失败
  • 知识卡 tests 字段自动登记，补内容层验证入口

统计 ​

  • 330 次提交 (自 v1.7.0)
  • 839 文件变更
  • +39411 / −11412 行