用途:诊断 Three.js(含 WebGPU/TSL)在运行时、渲染、API、资源或版本上的非预期行为,适用于具体故障、疑似上游回归或版本差异场景。
主要能力:以“先复现”为原则,把已安装源码与官方历史当作证据;按步骤建立单一案例记录,包含症状、预期行为、精确环境、最小复现、首个失败契约、本地证据、上游候选、恒定版本矩阵、结论、行动与限制,未知值记为 unknown。
使用方式:1)复现精确环境,记录包版本、THREE.REVISION、锁文件解析、导入入口、浏览器/系统、种子、资源版本与命令,渲染类结论需 WebGPURenderer 且 renderer.backend.isWebGPUBackend === true;2)命名被违反的契约与首个失败点;3)在不替换机制的前提下最小化;4)先查本地证据(导出映射、源码、类型、测试、示例、迁移材料);5)仅在本地证据不足、源码与文档冲突、疑似版本回归或用户询问已知问题时才做上游研究,并按分类给出所需证明;6)版本相关时保持恒定版本矩阵,一次只改一个 Three.js 版本;7)先做最窄遏制,再在原复现上验证,最后选择一种行动(应用修复、已发布升级、有界变通或锁定、上游报告、阻塞)。
适用场景:WebGPU/TSL 渲染异常、API 语义或数值不变量问题、资源与生命周期问题、版本回归定位。
限制:非渲染类 API、导出、资源或版本结论不应强加渲染器或后端门槛;不同渲染器、材质或表示只能定位故障,不能证明原路径正确;已关闭不等于分类,已合并不等于 npm 已发布修复;注册表不可用、未检查包或发布状态未知应记为证据不足;结论需有直接本地证据,涉及上游时需一手来源或发布证明。资料未提供具体命令、安装方式与价格信息。