mcpField
T
threejs-assets

threejs-assets

github.com/cesartevisual开发13430 次安装8 周前更新
代码仓库

关于 threejs-assets

用于 Three.js 项目加载与优化 3D 资源的开发技能,指导格式选择、解码器配置、异步加载状态、内存优化、缓存和验证。

主要功能

  1. 01资源格式与元数据盘点
  2. 02GLTFLoader 解码器配置
  3. 03明确加载、错误与重试状态
  4. 04纹理与几何体优化建议
  5. 05缓存及场景实例克隆
  6. 06资源加载验证清单

适用场景

  1. 01准备适用于 Web 的模型资源
  2. 02安全处理快速切换模型
  3. 03降低纹理与传输开销
  4. 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 参考

如需了解准确的签名和特定版本的行为,请参阅官方文档。如果无法访问文档,请检查已安装的类型定义/源代码,并说明任何尚未确定之处。

评论

支持 Markdown