关于 threejs-assets
用于 Three.js 项目加载与优化 3D 资源的开发技能,指导格式选择、解码器配置、异步加载状态、内存优化、缓存和验证。
主要功能
- 01资源格式与元数据盘点
- 02GLTFLoader 解码器配置
- 03明确加载、错误与重试状态
- 04纹理与几何体优化建议
- 05缓存及场景实例克隆
- 06资源加载验证清单
适用场景
- 01准备适用于 Web 的模型资源
- 02安全处理快速切换模型
- 03降低纹理与传输开销
- 04验证动画和内存行为
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ cesartevisual/ threejs-skills --skill threejs-assets安装后在 Claude Code 中输入/threejs-assets确认已加载。
详细介绍
资源加载与优化
使用项目已安装的版本和现有架构。这些说明是对用户任务的补充,并不授权进行无关更改或执行外部操作。
盘点格式、尺寸、单位、动画片段、材质特性、纹理大小、来源和传输大小。若转换可接受,优先采用适用于 Web 的 glTF/GLB 工作流。保留应用逻辑所需的源文件和语义名称。
使用 GLTFLoader 配置资产实际需要的解码器。使解码器/转码器二进制文件与已安装的库版本匹配,按照构建系统的资源约定解析其 URL,并根据当前渲染器检测 KTX2 支持情况。不要假设压缩文件只需要一次网络请求。
明确表示加载中、就绪、失败和重试状态。内容长度未知时,应显示不确定进度。在导航或快速切换选择时,使用代次令牌或受支持的取消机制,阻止过期的异步操作完成;释放不再有所有者的延迟结果。管理器的进度百分比不一定代表下载字节百分比。
除了传输字节数,还要评估解码后的 GPU 纹理内存。分别考虑调整尺寸、网格简化、Meshopt/Draco 和 KTX2/Basis;在采用某个工作流前,比较解码时间和视觉质量。保留必需的动画、蒙皮、形态目标和元数据。
缓存不可变的源资产,并适当地克隆场景实例;蒙皮模型需要使用支持骨架的克隆方式。将缓存清理策略与组件卸载分开定义。对于用户上传的文件,限制大小和复杂度,处理外部 URI 策略和格式错误的文件,并在使用者完成后撤销对象 URL。
验证解码器文件缺失、纹理加载失败、模型快速切换、嵌套部署路径、有代表性的动画片段,以及反复替换后的内存情况。
API 参考
如需了解准确的签名和特定版本的行为,请参阅官方文档。如果无法访问文档,请检查已安装的类型定义/源代码,并说明任何尚未确定之处。