问题定位与向 AI 反馈

一次有效反馈应说明预期、实际、环境、复现步骤和证据。后端排障的方法同样适用于美术管线。

先确定问题发生在哪一层

源工程 → 导出文件 → 引擎导入子资源 → 场景组件 → 运行设备

源工程已经错误，就先修建模或动画；源工程正确、重导入错误，就查导出；文件重导入正确、Cocos错误，再查导入与组件；桌面正确、微信错误，再查平台与设备。

常见症状表

现象	最小定位步骤
模型大一百倍／倒下	比较包围盒、根矩阵、单位与轴转换
材质丢失	检查导出节点模式、外部图片、引擎材质与灯光
面消失	检查法线、负缩放、背面剔除与透明方式
角色只站立	查导出动画通道、导入片段、播放器和播放调用
骨骼动但网格不动	查 skin、骨骼绑定、权重与蒙皮组件
原地走路变成滑行	独立检查外层位移与动作速度、步幅
序列帧抖动	查画布中心、裁剪偏移、帧序、重复闭合帧
构建成功但画面空白	查启动场景、相机、脚本异常、资源路径和引擎初始化

可复制的反馈模板

环境：Blender 4.5.15 / Creator 3.8.8 / Chrome桌面。
资源：robot.glb，来自本次生成脚本，附文件散列。
预期：walk循环播放，双腿交替，角色根节点位置不变。
实际：左腿正常，右腿始终站直。
复现：打开最小Cocos工程，启动Main场景，观察0.5秒位置。
已查：源blend右腿有关键帧，重导入GLB后也正常。
请先比较导入后的骨骼路径与动画绑定，不要重新建模。

截图应该表达什么

提供相同角度、相同时间点的源工程与引擎对照，附 Outliner 层级、相关参数和控制台错误。截图能证明外观，文件和脚本能证明结构与复现。记录动画问题时，至少观察极值与循环接缝。

每次只改变一个关键条件

不要同时改模型、材质、导出器和引擎版本，然后把“似乎好了”当作根因。先制作一个基础材质、单动作、少量骨骼的最小资源。如果最小资源正确，再逐项恢复复杂度。

让 AI 保存诊断记录：假设、验证动作、观察结果、结论与下一步。最后删除无效尝试引入的修改，并补上针对实际问题的检查。