Rupa3D

讓助理建構 3D CAD、網格與物理場景，並對其進行量測，把憑證嵌入 GLB 檔案。

可以做什麼

Rupa3D 用來建構 3D 資產：以 OpenCascade 進行精確 b-rep CAD（基本體、布林運算、圓角、2D 草圖轉實體、STEP/IGES/STL/GLB 匯出）、透過無介面 Blender 產生網格，以及帶 Rapier 物理、可發布為單一 HTML 頁面的 three.js 場景。它接著以閉式參考或獨立量測來量測所建構的內容，並把憑證嵌入 GLB 的 asset.extras.rupa3d，使其隨檔案一起傳遞。工具包括用於依規格檢查任意 GLB 的 rupa_periksa、用於拓撲與紋素密度的 rupa_topologi 和 rupa_tekstur、用於凸碰撞體的 rupa_proksi，以及 rupa_cad_* 與 rupa_adegan_* 系列。命令列閘門會傳回結束碼 0、1 或 2，可供 CI 使用。

適用情境

當助理需要產生或檢查 3D 資產，而且你希望取得可驗證的量測結果，而不是核心的 ok 旗標時使用，例如在沒有 Blender 的情況下依規格檢查他人的 GLB、產生附近似誤差報告的精確 CAD 幾何，或建構物理場景。它目前不能取代 Blender 或 Spline。命令列閘門適合必須在資產不符必要規則時予以拒絕的 CI 流程。

執行需求

需要本機 Node.js 執行環境，版本 22.14 或更高，透過 npx rupa3d 以 stdio 方式執行。Blender 為選用：36 個工具中有 23 個不需要 Blender，其餘 13 個需要 Blender 執行檔，可在 PATH、C:Program FilesBlender Foundation 下或透過環境變數 RUPA3D_BLENDER 指定。工作區預設位於 ~/.rupa3d，可用 RUPA3D_RUANG 覆寫。未宣告驗證機制。