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 Canvas 引導 | 偏好使用 @react-three/fiber + drei 來進行遊戲/UI 整合(building-games + 3d-libs.md) |
獨立的 WebGLRenderer 示範 | 對於獨立的 Canvas 模組沒問題;仍然透過 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(此技能的完整官方文件 dump)。
對於簡單的 2D Canvas 遊戲(例如打磚塊、俄羅斯方塊等),請不要載入 llms-full.txt。
完整參考資料
按需讀取:
references/llms-full.txt
來源:https://threejs.org/docs/llms-full.txt(為離線沙盒使用而保留的副本)。
內容包含:現代匯入方式、WebGLRenderer 與 WebGPURenderer 的比較、TSL 完整參考資料、NodeMaterial、載入器、後處理、計算以及 API 表格。
此產品的快速預設值
- 偏好使用 WebGLRenderer(或 R3F 預設值),除非使用者需要 TSL/WebGPU 計算。
- 限制像素比(
renderer.setPixelRatio(Math.min(devicePixelRatio, 2))或 R3F 的dpr={[1,2]})。 - 在拆卸時釋放幾何體/材質/紋理(Three.js 不會自動回收 GPU 資源)。
- 對於遊戲:仍然遵循
building-games的控制項與方向自我測試。
完成檢查
- three(以及如果有使用的 R3F 技術棧)已列於
package.json中,且匯入可以正確解析。 - 沒有使用 r128 / cdnjs script-tag 模式。
- 如果使用了 TSL/WebGPU:材質與匯入方式需與
llms-full相符(節點材質、await renderer.init())。