从写代码到出 3D 图纸，AI进军制造业了

text-to-cad 这个项目，6 个月 18K Star，MIT 协议，MIT 开源。

它做的事很直接：把你的 AI 编程智能体（Claude Code、Codex都行）装上 CAD 能力，一句话描述零件，它出真能用参数化工程图纸。

SECTION 0101 它是什么

大多数”AI 生成 3D”项目吐出来的是三角面片（STL 那种网格），看着像模型，但改尺寸要重新生成，做不了布尔运算，精度不够。text-to-cad 不一样：你让它画一个”长 40mm、宽 20mm、厚 5mm、四角 R2、中间一个 M6 通孔”的底座，它出的是 STEP 格式的参数化 BRep 实体，可以直接丢进 SolidWorks、Fusion 360、FreeCAD 继续改。

它会做工程图纸（PDF，带视图、隐藏线、尺寸标注、孔位、标题栏）、2D DXF 切割图、机器人描述文件（URDF/SRDF/SDF），还能把模型切成 G-code、推到你 Bambu Lab 3D 打印机，或在 SendCutSend 做激光切割/CNC 前做预检。

1.1 核心能力

它的能力是把建模到制造整条链路铺了：

1.2 实测

我装到 Claude Code 上跑了一遍。最舒服的一点是几何感知的增量编辑：第一次让 Agent 画一个齿轮，它生成后给你一个 @cad[…] 句柄；你说”把模数改成 2″，Agent 通过句柄定位到那个齿轮，改完重新生成。不用每次把整个项目推倒重来。

SECTION 0202 原理

它不靠 LLM 直接吐模型。

text-to-cad 的技术路线：你的 Agent 收到自然语言描述后，写一段 Python 代码调 build123d 库。build123d 底层是 OpenCascade（OCP）的 Python 绑定，专门做参数化实体建模。Agent 把你的描述翻译成精确的几何代码，build123d 执行这段代码，生成真实 BRep 实体。

Hacker News 上有人专门扒了项目的 requirements.txt 确认了这条链路：build123d、ezdxf、trimesh、vtk，全是正经工程库。

作者 softservo 在 HN 评论区说自己是”刷了 10 年软件后重新学机器人，被 Onshape 等现代 CAD 工具教育之后做的这个项目”。

SECTION 0303 能做什么

它擅长”脑子里有个零件/支架/齿轮/小机器人，但懒得开 SolidWorks”这种场景。

比如给机械臂设计一个 QDD 执行器（quasi-direct-drive actuator）：先描述结构，它出 STEP 模型，再出工程图纸 PDF，然后调 DFM 检查拔模角和倒扣，最后切 G-code 推 Bambu 打印机。

从”一句话”到”打印机开跑”，整条线本地跑完，不经过云端模型服务。

SECTION 0404 怎么上手

依赖三样：Python（uv 管理）、build123d + OpenCascade、本地 Agent 环境。

• Windows 11 用户注意：OCP 以 unsigned native module 发布，Windows Smart App Control 默认开着会拦掉，cadgen 命令直接 ImportError: DLL load failed。两个解法：关 Smart App Control（关掉后只能重装 Windows 恢复），或跑 WSL。

• Agent 越强，出图越准：用 Claude Code 和用弱模型跑，几何精度差距很大。

安装方式很简单，各 Agent 有各自的插件命令（Claude Code、Codex、Cursor、Gemini、Grok 都有对应路径），也可以只装 skills 不装插件。

SECTION 0505 值不值得用

它解决的问题很清晰：把”自然语言到可制造 CAD”这一步的成本降到了极低。对机械设计、3D 打印、机器人、CNC 这些方向的读者，直接抄走整套流程就有用。

短板也清楚：复杂装配体（几百个零件、干涉检查、运动学仿真）替代不了正经 CAD 软件，text-to-cad 的 DFM 能帮你发现问题，但完整设计流程还是得用专业工具。Windows 的 Smart App Control 坑，新手第一次跑容易卡住。

SECTION 06写在最后

AI 能出工程图纸了，能把图纸推到你 3D 打印机上了。

它碰实物的边界，每个月都在往外扩一格。

GitHub：https://github.com/earthtojake/text-to-cad