SuperAPI AI 工具集

threejs-debugging

编程与开发

查看项目

更新于 10-15 20:11

技能介绍

用途:用于诊断 Three.js 项目中的渲染故障,包括画布全黑、模型/Object 缺失、颜色错误、画面闪烁、拾取(picking)异常以及 WebGL 上下文丢失。定位为诊断辅助,直接补充用户当前任务,不授权做无关改动或外部操作。

主要能力:

  • 排查空白画布:先验证容器/绘制尺寸非零、渲染循环存活、渲染器创建成功、相机投影与取景、对象可见性与图层、变换是否为有效有限值;再用无光照诊断材质替换问题材质,以区分光照问题与几何体问题。
  • 排查资源加载失败:检查 HTTP 状态、响应内容、CORS、解码器路径与构建 base path;注意状态码 200 返回 HTML 回退页并不是有效 GLB。
  • 排查颜色问题:沿光照、色调映射与输出转换链路追踪纹理分类。
  • 排查闪烁:检查共面几何、near/far 精度、透明排序、重复渲染循环和多个变换写入者。
  • 排查拾取:核对画布/视图相对坐标、矩阵、图层、实例化,以及着色器变形不一致。
  • 上下文/设备丢失:提供清晰的恢复路径,而非无限重建渲染器。

使用方式:先记录可见症状、控制台错误、失败请求、已安装版本、后端和最小复现,再依照症状树缩小原因。每次只减少一个失败场景特征并保留证据。修复后验证原失败操作,并检查共享同一代码的相邻状态。避免无关依赖升级,也不要为消除症状而关闭所有错误检查。说明原因与证据,而不只是改动的那一行。

限制:需使用项目已安装的版本和现有架构;API 签名与版本相关行为应以官方文档为准,若无文档可访问则检查已安装的类型/源码,并说明仍存在的不确定性。