Three.js 品質套件 — 資源、方法、檢查清單
這個技能回答一個問題:是什麼讓我們的 Three.js 影片從「堆疊的基本幾何體」變成一部有綁定角色、真實城市與乾淨場景調度的電影? 三件事:隨著專案逐步添加的資源、一套工作方法,以及系統性的審閱。兄弟技能 threejs-code-video 包含技術細節(管線、角色、攝影機、迴圈、陷阱);而這個技能是總覽與入門套件。
內容
| 檔案 | 用途 |
|---|---|
| references/ressources.md | 完整清單:倉庫、技能、網站、工具、服務 — 各項資源的用途、安裝方式、授權條款 |
| references/methode.md | 逐步工作方法,以及真正提升品質的 6 個槓桿 |
| references/checklist.md | 可勾選的檢查清單:安裝、編碼前、編碼期間、發送前 |
scripts/install-kit.js | 在專案中安裝套件的公開技能(克隆 + 複製,無相依性) |
scripts/planche.js | 影片 → 分鏡表(每秒 1 幀),用於完整審閱渲染結果 |
scripts/polyfork-fetch.js | 搜尋並下載 Polyfork 模型(可參數化的 .mjs 模組) |
scripts/face-landmarks.py、scripts/face-measure.py | 透過照片測量臉部(使用 MediaPipe),取代肉眼估計 |
一分鐘了解資源
| 需求 | 資源 | 在我們的專案中 |
|---|---|---|
| 最新的 Three.js (r186)、R3F、著色器、燈光… | 13 個 threejs-* 技能 — CloudAI-X/threejs-skills | 已安裝,每次組合時查閱 |
| 逐幀影片渲染 | 8 個 Remotion 技能 — remotion-dev/skills | 已安裝 |
| 程式碼影片方法 + 範本 | 技能 threejs-code-video + 倉庫 Alex-sia99/threejs-code-video | 由我們編寫,公開 |
| 物件、場景、低多邊形角色 | Polyfork(polyfork.dev,索引 lucas-martinic/polyfork-catalog) | 用於影片 v3 — .mjs 模組從未重新分發 |
| 動畫角色 | Mixamo 骨架與片段 | 影片 v3 的綁定角色 |
| 根據照片實現相似度 | img2threejs/img2threejs + MediaPipe Face Landmarker | 採用「測量,而非估計」的方法 |
| 建模前的參考圖像 | Kie.ai nano-banana-2-lite | 用於比例與場景 |
| 語音、音效、音樂 | ElevenLabs、Suno、FFmpeg | 完整的管線 |
| 程式碼 2D 繪圖(另一種風格) | alexgreensh/anidoodle、html-anime | 已安裝,但非 Three.js |
詳細資訊、連結與注意事項:references/ressources.md。
十步驟方法
- 先找參考:分析風格影片分鏡、參考圖片、測量照片。
- 技能先於程式碼:載入相關的
threejs-*或remotion-*技能,絕不憑記憶撰寫 API。 - 研究好程式碼,再重寫:閱讀一個寫得好的模組,記下方法,然後編寫自己的。
- 一切都是幀數的純函數:固定種子、距離行進、無累積狀態。
- 腳本 → 語音 → 時間軸:場景調度應對齊台詞(
at("l14")),永遠不要使用硬編碼的秒數。 - 每個問題一個工作坊:臉部用
Lab組合、身體用RigLab、有疑問時進行一排實驗。 - 渲染、觀看、修正:靜態圖片 → 場景分鏡 → 以每秒 1 幀重新審閱最終影片。
- 大改版前,讓新眼睛進行嚴厲審計。
- 儘早進行人工驗證:在長時間渲染之前,確認角色與風格方向。
- 累積經驗:每個遇到的陷阱都記錄到
pitfalls.md,每個方法都變成一個技能。
詳細資訊:references/methode.md。
不可協商的規則
- 絕不發送未經觀看的渲染結果。 靜態圖片不足以判斷電影品質:必須以分鏡表重新審閱最終影片。
- 風格優先於精確度。 在風格化世界中出現寫實臉部已被拒絕兩次;相似度應透過形狀與少數清晰特徵來實現。
- 遵守授權條款。 Polyfork:可自由用於影片,但
.mjs模組與烘焙片段絕不能放在公開倉庫或套件中。 - 一個特徵 = 一個體積、一個地點 = 一個可辨識的物件、一句台詞 = 一個能呈現它的視覺畫面。
將套件傳遞給學生
此套件已發佈在倉庫 **https://github.com/Alex-sia99/threejs-quality-kit**:只需發送此連結即可。README 是為學生編寫的(先備知識、三步驟安裝、要提供給其 AI 代理的提示詞);install.js 會自動下載公開技能與入門專案,因此倉庫保持輕量且更新。切勿在裡面加入 Polyfork .mjs 模組、anim-*.json 片段、API 金鑰、照片或個人語音。