ldraw-nova：用 AI Agent 生成可拼装的 LEGO 模型

项目简介

ldraw-nova 是一个开源的 AI Agent 工具集，让大语言模型能够自主设计并生成可拼装的 LEGO 积木模型。给定一个创意描述，Agent 会规划所需零件、生成 LDraw 语言的源文件，并通过 Docker Web 应用提供 3D 查看、VR 预览（Meta Quest 3）和 Blender 可编辑的 glTF 文件。配套 Astra 与 Claude Opus 5.5 等模型驱动，作者本人也是 Jev System One AI 模型的协作者。

核心功能

• 自然语言建模：用文字描述想要的模型，Agent 自动完成从规划到生成的全流程。
• LDraw 源文件输出：生成标准的 .mpd 文件，可直接在 LDraw 兼容工具中查看和编辑。
• 3D / VR 预览：内置 3D 查看器、3D 播放器，以及 Meta Quest 3 上的 VR 交互模式。
• Blender 集成：导出 .glb 格式，元信息写入 Blender Custom Properties，便于二次精修。
• 零件语义检索：基于 TypeSafe 的 Jev System One AI 模型，配合 jev-rerank 做零件的语义搜索与重排序。
• 碰撞与缺口检测：自动检查零件放置的位置是否冲突或留有空隙。
• 多模型规划：支持子模型拆分，可构建由多个子模型组成的复杂作品。

技术实现

ldraw-nova 的关键在于让 Agent 学会"写代码生成模型"而不是"直接摆零件"。作者发现 LLM 对几何数学不擅长，但对"写 Python 代码来产出数学结果"却很在行，于是设计了 plan → generate.py → model.mpd 的三层架构：Agent 先产出结构化的 plan.json（描述零件、几何、组合方式），再由 plan 派生出 generator.py，最后执行 Python 脚本生成 LDraw 源文件。Agent 内置 instructions.md、视觉设计指南、车辆工作流等参考文档，运行时通过 Docker Compose 提供本地 Web 应用与 VR 入口。整套思路本质上是给 Agent 装上一套 LDraw 语言的"编译器"，让 3D CAD 由代码生成而非直接摆块。

快速上手

1. 克隆仓库与配套的 ldraw-nova-docker（同 tag）：git clone --branch v0.6.0 https://github.com/anteloc/ldraw-nova.git 与 git clone --branch v0.6.0 https://github.com/anteloc/ldraw-nova-docker.git。
2. 构建 Docker 镜像（首次需约 5GB 空间）：cd ldraw-nova-docker && docker compose build。
3. 启动应用：docker compose up -d。
4. 在浏览器打开 http://localhost:8765（HTTP）或 https://localhost:8443（HTTPS，支持 Quest 3 VR）。
5. 设置 TYPESAFE_API_KEY 可启用零件语义重排，否则回退到 FTS 全文本检索。

适用人群

• 想用 AI 自动生成实物模型的创客与硬件爱好者
• 研究 Agent 工具调用、代码生成、CAD 自动化的研究者
• LEGO 玩家，希望快速将脑洞落到可拼装文件
• 教学场景中演示"AI 写代码生成 3D 物体"全流程的讲师