按症状排查光影包
从症状进入
- 包未显示、加载失败或仍是旧效果
- 全黑、全白、天空或透明物体缺失
- MRT、输出位置与绑定冲突
- 同纹理读写、writer、顺序与 barrier
- resize、切包残留与 history 拖影
- Mod 材质未匹配与 mapping deferred
- 静态通过但 compile/link 或 FBO 失败
先记录,再缩小范围
记录宿主 commit、包/ZIP 指纹、选项、active selection、published generation、实际尺寸、世界/Mod、GPU/驱动及第一条错误。先做 pack validate,再做 scene/graph/interface,最后比较对应 report 与实际画面。不要在一个步骤中同时更换宿主、世界、源码与参数。
从错误到修复的完整实验包含三份明确标为反例的完整 ZIP,源码和新解压 ZIP 均实际拒绝,恢复后重新通过。
以 code 与来源定位
以稳定 code/family 和 file/pointer 定位;英文 message 是上下文。相同症状可能来自不同层,同一 family 也可能有多个来源。诊断参考说明稳定 family,Analyzer说明退出码与合同。