huangserva/3DCellForge

解決的問題

3DCellForge（3D模型工作室）提供一個統一且互動式的環境，用於從2D影像生成與檢視3D模型。它消除了在多個影像轉3D AI提供者與獨立的3D檢視軟體之間切換的需要，將生成、品質評估與展示整合至單一工作室環境中。

如何運作

此專案是一個基於React與Three.js的應用程式，連接到各種影像轉3D AI後端。使用者上傳參考影像，選擇一個生成提供者（如Hyper3D、Tripo、Fal.ai，或本地Hunyuan3D實例），系統將生成一個GLB檔案。

關鍵技術元件包括：

• WebGL舞台：使用React Three Fiber建構的中央檢視器，支援即時模型檢視與軌道控制。
• 後端整合：Node.js後端安全地管理API金鑰，並將生成的模型本地快取，避免重複的API呼叫。
• AI分析：可選整合OpenAI的視覺能力，自動分類資產、建議材質並優化提示詞，以獲得更佳的3D生成效果。
• 持久化：使用IndexedDB與localStorage，確保模型資料庫與生成歷史在頁面重新整理後仍能保留。

適用對象

此工具專為需要從影像快速原型化3D資產，並以專業、電影級方式展示，而無需複雜3D軟體的3D藝術家、產品設計師與開發者設計。

主要亮點

• 多提供者支援：無縫切換雲端提供者（如Tripo、Fal.ai、Hyper3D）或使用本地Hunyuan3D API。
• 物件感知檢查器：自動分類模型（如車輛、飛機、有機標本），並提供特定元資料與品質評分。
• 電影級示範模式：隱藏UI面板，使用針對資產類型定制的自動相機路徑（如飛機使用飛行路徑）進行示範。
• 整合品質評分：根據三角形數量、檔案大小與紋理數量評估生成的GLB，判斷其是否「適合示範」。
• 本地GLB匯入：支援匯入現有的.glb或.gltf檔案以進行檢視與展示。