Three.js(官方 LLM 参考) 是做什么的?
此技能内嵌了官方 Three.js LLM 文档包,使代理能够生成正确的现代 three.js 代码,而不会臆造过时的 CDN / r128 API。
适配当前技术栈(本应用构建器)
您当前处于一个 TanStack Start + React 工作区,而非纯 HTML 页面:
| 官方文档模式 | 请在此处改为这样做 |
|---|---|
<script type="importmap"> + CDN 引入 three | npm install three(如有需要也可安装 @types/three);从 "three" / "three/addons/…" 导入 |
| 原生 HTML 画布启动 | 游戏/UI 集成优先使用 @react-three/fiber + drei(参见 building-games + 3d-libs.md) |
独立的 WebGLRenderer 示例 | 适用于独立的画布模块;但仍需通过 npm 安装 three,以确保 Vercel 构建时可用 |
| 始终使用 CDN “最新”版本 | 在 package.json 中锁定版本,使开发环境和部署环境一致 |
three 并非预装——请使用 npm 添加,并保留在 package.json 中。
何时加载什么
- 游戏 / 交互式 3D 产品 → 从
building-games开始(循环、控制、朝向、相机、首次运行、转向标志)。 - R3F / drei / rapier 集成 → 查阅
building-games/references/3d-libs.md。 - 深入 three API、TSL、WebGPU、材质、加载器、后期处理 → 加载
references/llms-full.txt(本技能的官方完整转储)。
对于简单的 2D 画布游戏(如乒乓球、俄罗斯方块等),不要加载 llms-full.txt。
完整参考
按需读取:
references/llms-full.txt
来源:https://threejs.org/docs/llms-full.txt(为离线沙箱使用保留的固定副本)。
内容包括:现代导入方式、WebGLRenderer vs WebGPURenderer、TSL 完整参考、NodeMaterial、加载器、后期处理、计算以及 API 表格。
本产品的快速默认设置
- 除非用户需要 TSL/WebGPU 计算,否则优先使用 WebGLRenderer(或 R3F 默认值)。
- 限制像素比率(
renderer.setPixelRatio(Math.min(devicePixelRatio, 2))或 R3F 中的dpr={[1,2]})。 - 在销毁时 dispose 几何体/材质/纹理(three 不会自动回收 GPU 资源)。
- 对于游戏:仍然遵守
building-games中的控制和朝向自检规则。
完成检查
- three(以及如果使用 R3F 栈)已列在
package.json中,且导入可解析。 - 无 r128 / cdnjs script-tag 模式。
- 如果使用了 TSL/WebGPU:材质和导入与
llms-full匹配(节点材质,await renderer.init())。