viettranx/3dviz-pro-max

3Dviz Pro Max – AI 驅動的 3D 場景創作

是什麼 – 一個為 Claude Code、Codex 及類似 LLM 代理設計的 獨立技能，可將自然語言意圖（例如 「建構一個帶有移動生物的小型奇幻村莊」）轉化為完整且可渲染的 Three.js 場景。該技能提供 10 步工作流程、可搜尋的 223 個「食譜」目錄、440 筆知識記錄、22 個現成的套件藍圖、風格設定檔，以及 Python 輔助工具，用於捕獲渲染畫格，供代理檢視。

如何運作

1. 意圖 → 推理 – 代理解析使用者請求，決定所需物件、風格與行為。
2. 重用／適應套件 – 從目錄中選擇套件藍圖（例如地形、小屋、齒輪組），或自行撰寫新藍圖。
3. 建構首個視圖 – 使用選定的資源、照明裝置、相機設定等填入 Vite + Three.js 模板。
4. 執行並捕獲 – scripts/capture.py 啟動無頭 Chromium 實例（透過 Playwright），在真實 GPU 上渲染場景，並寫入 PNG 畫格與日誌。
5. 優化 – 代理將觀察到的畫格與預期描述比對，調整參數，重複直到報告與證據相符。
6. 報告 – 最終輸出為建構內容的簡要描述，以及捕獲的影像。

提供項目

項目	數量	說明
食譜	223	24 個主題方向（環境、解剖學、機械工程等）
知識記錄	440	風格、照明、相機、材質的預設設定
套件藍圖	22	經 SHA‑256 驗證的已驗證 Three.js 模組（T0–T3 層級；T4 未提供）
風格設定檔	37	帶數值預設值的命名外觀
範例研究	37	完全可執行的示範（心臟解剖、齒輪機械、奇幻村莊等）
展示畫格	21	實際 GPU 捕獲（1920×1080）儲存在 docs/demos/

安裝 – skills/3dviz-pro-max/ 資料夾整體即為外掛。

# Claude Code（外掛目錄）
ln -s $(pwd)/skills/3dviz-pro-max ~/.claude/skills/3dviz-pro-max
# 或以 zip 加載
claude --plugin-dir 3dviz-pro-max-0.1.0-plugin.zip

對於 Codex，將資料夾複製到 Codex 的技能目錄中。僅捕獲步驟需要 Playwright（用於 Chromium）和可選的 Blender 4.2+；其餘部分使用一般 Node 即可執行。

執行示範

cd examples
pnpm install          # 安裝 Vite + Three.js 依賴
pnpm dev               # 提供 http://localhost:4180/<demo-id>/

每個示範資料夾包含提示、生成的場景、原始參考與限制。

典型用途

• 快速原型設計：僅用一句話建構遊戲關卡資源或科學可視化。
• 教學：學生讓 LLM 描述一個概念（例如 「展示一個 3:2 比例的齒輪對」），並獲得一個可互動的 Three.js 模型進行探索。
• LLM 接地性評估：技能內建的檢索案例測試，讓研究者可衡量代理將意圖轉化為可觀測圖形的能力。

誠實的限制

• 此技能僅 捕獲 畫格，不保證每個食譜都成功渲染。
• 知識記錄為編輯審核，非由執行時觀察推導。
• 未提供 T4 級別藍圖；最高保真度資產為兩個 Blender 烘焙的 GLB（T3 級別）。
• 評估分數基於每條件單次執行，因此為指示性而非結論性。
• 若無 Playwright/Chromium 或 Blender，捕獲步驟將中止，代理需報告缺失畫格。

授權 – 倉儲程式碼、資料與原創媒體採用 MIT 授權。第三方資產保留其原始授權（例如 BodyParts3D 網格採用 CC BY‑SA 2.1 JP）。

---

所有細節均直接取自倉儲的 README；未添加任何外部假設。