img2threejs：一個使用純程式碼幾何重建參考圖像物件的程序化 Three.js 模型生成器

它解決了什麼問題

img2threejs 將單張物件、角色或生物的參考圖像轉換為程序化的 Three.js 模型。與攝影測量或網格提取不同，它使用基元和著色器生成純程式碼模型，確保結果輕量、可直接動畫，且可直接在瀏覽器中執行，無需外部網格檔案或美術套件。

工作原理

本專案使用分階段的雕塑管線，將圖像轉換為技術規格，然後透過多次迭代的階段建構模型，包括：粗略布局、結構、形態、材質、表面、光照、互動與優化。

它被設計為與代理無關，可在 Claude Code、Codex 或 OpenCode 等 AI 程式碼代理中執行。管線使用確定性的 Python 腳本進行驗證與品質門檻，而 AI 代理負責視覺判斷與程式碼生成。對於角色，則採用具解剖意識的流程，結合參數化模板與標誌點擬合，以最大化相似度。

目標對象

需要快速從圖像生成可在瀏覽器中使用的 3D 資產的開發者與 3D 藝術家，特別是尋求程序化、程式碼驅動幾何而非靜態網格的使用者。

重點特色

• 純程式碼重建：產生 TypeScript 工廠，從基元與程序化著色器建立模型。
• 即時動畫：生成包含樞紐、插槽與碰撞體的執行時層級結構，便於立即動畫化。
• 細節優先分析：使用嚴格的品質門檻，要求在生成前完整列出身份定義細節（如倒角、鉚釘與磨損）。
• 主題專屬管線：包含硬表面物件、人形角色與生物（四足、鳥類等）的專屬流程。
• 詳細審核門檻：實施嚴格檢查，包含 CS2 專屬武器合約與 CIEDE2000 色彩計算以確保精確度。