跳转到正文

按症状排查光影包 ​

从症状进入 ​

先记录,再缩小范围 ​

记录宿主 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说明退出码与合同。

作者文档 · Manifest v5 / Scene ABI v2