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 覆盖。未声明身份验证。