Text-to-CAD实战：自然语言生成参数化CAD模型的技术原理与工程落地

上个月客户让我临时补一个带沉孔的法兰盘手头CAD软件还没开我索性在Text-to-CAD工具的输入框里敲了一行描述“一个直径120mm、厚8mm的圆盘中心一个30mm通孔圆周均布4个6mm沉孔”。十来秒后工具跑完代码窗口里出现了一个可编辑的参数化实体。那一刻我意识到这个把自然语言变成CAD模型的工作流已经从实验室玩具变成了能落地干活的生产力。这种体验是过去十几年建模经历里少有的你不用再盯着约束草图、拉伸、阵列一步步点只要把脑子里的设计意图用文字说明白剩下的几何构建交给AI去完成。本文就从从业者角度聊聊Text-to-CAD到底是什么、它背后怎么实现、真实项目里怎么用、以及我踩过的坑无论你是机械工程师、工业设计师还是想快速出模型的3D打印爱好者都能从中找到可复用的经验。1. 一句话认识Text-to-CAD从手绘草图到自然语言建模1.1 什么是Text-to-CAD它改变了什么Text-to-CAD字面意思就是“文本转CAD”目前大家讨论的更多是“用自然语言描述来生成CAD模型”。传统CAD流程中你需要在软件里画草图、加约束、拉伸、打孔、倒角一步步构建出实体Text-to-CAD把这个过程压缩成“描述-生成-微调”三个动作。我见过最快的例子是从输入“做一个带M5螺纹孔的铝制底座”到拿到可编辑的STEP文件只花了不到一分钟。它改变的不仅是速度更是人机交互方式。过去你学的是“机器的语言”——几何操作、约束图、特征树现在机器开始理解你的语言——尺寸、位置、凹凸关系、对称性。这意味着很多本来需要系统学习CAD软件操作才能表达的设计意图现在只要你会说清楚“这个东西长什么样”就能有一个从0到1的起点。当然这个起点离最终可用零件还有距离后面3D打印或加工往往还要人工调一版但起点高度的提升是实打实的。1.2 适合谁用能解决什么问题先说适合的场景。我总结下来有四类机械结构快速概念验证前期结构方案比较时用自然语言批量生成几种支架、底座、连接件的初版外形比逐个建模效率高太多。非设计师出身的创业者、手作爱好者有想法但不会用专业软件一句话生成模型后直接3D打印完成从想法到实物的闭环。CAD操作熟练但想提效的工程师把重复性的参数化零件描述写成模板比如各种规格的钣金支架、线槽盖板交给AI执行省下的是重复劳动。需要大量变体模型的场景比如同一产品不同尺寸的包装托盘用文本改几个数字就能得到新模型不需要重新建模。不适合的场景也很明显。追求毫米级精密配合的模具设计、复杂的自由曲面外观设计、动辄上百零件的装配体现阶段老老实实用专业软件更稳。Text-to-CAD擅长的是“规则几何体特征组合”而不是“天马行空的雕塑”。把它当一把快刀别当万能钥匙。2. 技术原理拆解自然语言是怎么变成CAD实体的2.1 三条技术路线先搞清楚差别我常跟人解释Text-to-CAD的原理把它分三条路线来理解。第一条路线是“直接生成几何表示”。模型由大量文本-三维数据训练输出体素、点云或隐式曲面然后再把这些数据转换成CAD实体。这条路线看似直接但体素和点云天然是离散的转成精确的B-Rep边界表示时容易出现破面、误差多数情况下只能做一个“形似”的网格后续要转成可加工的实体反而更费劲。第二条路线是“程序化生成”。语言模型不直接画几何而是生成一段参数化建模代码比如CadQuery、OpenSCAD或FreeCAD宏。执行代码后CAD内核按逻辑构建实体。这条路线下的输出是精确的、参数化的还能进特征树编辑是目前工具化落地最常见的做法。第三条路线是“特征序列生成”。模型理解文本后生成的不是代码而是有序的CAD特征操作序列比如“创建草图、拉伸60mm、贯穿打孔、阵列4处”再由CAD内核逐条执行。它的可控性介于前两者之间在学术研究里很常见。三种路线都绕不开同一个核心问题让AI同时理解“文本语义”和“几何操作语义”。“我要一个圆角”这句话不仅涉及语义理解还涉及圆角应该加在哪条边、半径多大、圆角会不会把相邻特征吃掉等几何推理。这也是为什么纯端到端模型目前还很难取代基于代码生成的工具。2.2 为什么目前主流工具都选择“程序化生成”以目前比较成熟的在线Text-to-CAD工具为例底层基本都绑定了CadQuery这种基于Python的参数化建模库。为什么不直接端到端输出网格我讲几个实际原因。第一精确性。CAD模型最终要进CAM加工或3D打印必须是非流形的精确实体每个顶点、每条边的坐标都有明确的数学定义。代码生成天然有这种确定性神经网络直接输出几何则很难保证拓扑正确性。第二可编辑性。代码是可阅读的你不仅可以改提示词重新生成还能直接改代码里的尺寸参数、调整特征顺序。这非常符合工程师的工作习惯——我拿到一个初版会想加个肋板、改个孔位而不是重新从头描述一遍。第三解释性。当模型生成错误时代码能告诉你问题出在哪是坐标系选错还是布尔运算失败。这一点对调试极其重要而不是面对一团网格无从下手。但这套方案也有天花板生成质量的上限很大程度取决于CadQuery这类库的表达能力。你无法让模型生成一个库本身不具备的特征。所以你会发现Text-to-CAD在“板、块、孔、槽、法兰”等规则特征上表现不错一到复杂曲面就开始力不从心。2.3 关键模块拆解从“一句话”到“一根轴”我从一个典型例子来看整个流程。假设你输入“一根长100mm、直径20mm的轴一端有一个10mm长的M10螺纹段”。第一个模块是意图理解与实体抽取。语言模型会从这句话里抽取关键信息主体形状是圆柱长度100mm、直径20mm特征是在一端附加螺纹规格M10。第二个模块是参数与单位规范化。把“长100mm”映射为建模坐标系上的Z方向拉伸长度把“M10”转成标准螺距和牙型参数把“一端”转成起点面与朝向。第三个模块是建模动作生成。模型把它翻译成一串CadQuery调用先创建半径10mm的圆柱长度100mm再在一端额外生成一个M10的螺纹柱体最后用布尔并集融合。执行完打开视图你看到的就是一个有台阶的轴。这里最容易被忽视的是“单位规范化”。很多失败案例都不是模型不懂语义而是对“多少”没有概念。你在提示词里写“长一点”“厚一点”模型只能随机给个默认值写成“长100mm”它才能精准落地。这就是为什么同样一个工具有人用起来顺手有人觉得是随机生成器。3. 实操用Text-to-CAD生成一个真正能用的零件3.1 环境准备与工具选型如果你只是想快速试试直接用现成的在线Text-to-CAD服务就行打开网页、输入描述、等几秒就能看到结果。如果你想把它纳入自己的设计流程我更推荐配置一套本地环境安装CadQuery库准备好一个能跑Python的编辑器再接入一个大模型对话接口。我先放一个最简单的验证流程。第一步安装CadQuery。在终端执行pip install cadquery建议用Python 3.10以上的版本老版本容易踩依赖坑。装完后可以运行一个5行代码验证环境是否正常比如import cadquery as cq result cq.Workplane(XY).box(10, 20, 5) show_object(result)在Jupyter里运行时需要开启cadquery display插件命令行环境也可以直接导出STEP文件查看。第二步准备大模型调用入口。你可以使用支持函数调用的大模型服务也可以选择本地部署的开源模型。无论哪种方式核心目标只有一个让模型输出可执行的CadQuery代码而不是输出一堆描述文字。具体做法是给模型一个System Prompt明确告诉它“直接输出完整Python代码不要解释”并把CadQuery的常用API文档作为参考内容。第三步建立一条自动化链路文本描述 - LLM生成代码 - 执行代码 - 导出STEP/STL - 导入CAD审查。别看这五步简单很多翻车都发生在模型生成了“看起来正确但执行报错”的代码。为了避免这一点我建议在链路里加一个自动检查环节捕获执行异常并反馈给模型让它根据报错信息重新修正。这个“生成-执行-报错重试”的循环是我认为目前最稳的落地方式。3.2 提示词工程让模型听懂你的一句话实测下来提示词写得好不好直接决定生成质量的上限。我总结了五个高频技巧第一尺寸全部量化不要用感觉词。“一个支架的底板是40*30”优于“一个不大不小的底板”。第二把复杂零件拆成特征请求按建模顺序描述。“主体是一个60406的方板四角倒R3圆角顶面有两个直径6mm的贯通孔分别位于距左边10mm和距上边15mm处”比“一个带孔的板子”好用一个数量级。第三明确方向和坐标基准。CAD里“上面”“下面”“前后面”都有歧义最好指明工作平面或轴向比如“在XY平面上”“沿Z轴方向拉伸”“在顶面中心”。第四显式说明约束关系。比如“孔和边缘的距离是10mm”而不是“孔靠近边缘”比如“4个孔均布”而不是“有4个孔”。第五迭代优于一次到位。先描述主体外形让它生成一个干净的基础件确认无误后再追加孔、槽、倒角。一次描述太多特征模型经常顾此失彼。这很像带新人你先把大形状定下来再一步步加细节它就不会手足无措。我经常用的一个标准模板长这样请用CadQuery生成一个{零件名}。 整体形状{主体几何描述含尺寸和方向}。 附加特征1{特征类型}{位置/方向}{尺寸}{约束}。 附加特征2{特征类型}{位置/方向}{尺寸}{约束}。 导出格式生成后调用export(output.step)导出STEP格式。把你要做的零件往里填信息基本上第一次生成的成功率就能上去一大截。3.3 生成结果的后处理与再编辑拿到模型后别急着欢呼我习惯按三步走。第一步是实体检查。在CAD软件里导入生成的文件先看“特性”里的体积如果模型是一堆面片而不是闭合实体体积会是0或无法计算。这个检查只要10秒能滤掉一大半翻车样例。第二步是历史树查看。如果工具直接给你CadQuery源码把源码和最终模型对照着看能发现很多“表面正常但尺寸错位”的问题。比如有的模型看着是一个方块其实拉伸方向反了或者坐标系挂错了面。直接在源码里改参数通常比重画还快。第三步是标准化整理。按你的企业或项目规范补上材质、公差、表面粗糙度等属性再导出STEP、IGES或STL。如果需要还可以在FreeCAD里重建约束关系让模型更符合后续工艺流程。这里我想强调一个经验Text-to-CAD生成的东西最适合当“概念雏形”而不是“最终交付品”。把它当作一个有经验的实习生出的第一版你再花10分钟做评审和修正这个工作流才算完整。下面是几个提示词效果对比可以参考描述方式实际效果“做一个带孔的板”尺寸随机孔的位置靠猜大概率不能直接用“60406mm铝板中心一个直径5mm贯穿孔四角R3圆角”一次成型直接导入即可做基础版4. 踩坑实录新手最常见的4个问题4.1 生成结果破面、实体化失败这是所有使用者碰到的第一道坎症状是模型在预览里看起来完好一导入专业软件就报“非实体”“破面”。原因很典型模型生成的CadQuery代码里出现了非流形的边最常见的是两个面刚好共面但没合并或者布尔交集生成了零厚度薄片。解决办法有三个方向一是在提示词里刻意避开“刚好相切”“完全贴合”这类表述给特征之间留一点重叠量二是让模型多用union合并而不是简单叠加三是把公差调低比如在导出前开启更精细的网格精度选项。还有个补救技巧如果破面实在修不了就把模型转成STL网格用网格修复工具先补洞再通过“曲面化”命令转回实体。4.2 尺寸总是不对偏差让我怀疑人生一开始我以为模型在“乱画”后来用脚本统计了50次生成结果才意识到很多尺寸偏差都是提示词里的数值没有落到正确的特征上。比如你写“板厚4mm”模型可能把4mm用在了高度上而板的主体宽度用了默认值又比如“直径20mm的孔”它可能在四方体上给你挖了个直径20mm的圆柱洞但圆柱长度只贯穿了一半。我的排查方法是拿到生成源码后先搜索所有涉及尺寸的函数参数逐个核对输入值。如果你不想看源码就在提示词里把每个尺寸和形状绑定起来写比如“直径20mm的贯穿圆柱孔z方向穿透整个板厚8mm”这样模型就很难把数字错挂到别的特征上。4.3 装配体和复杂结构AI维系不住Text-to-CAD单零件表现尚可但一旦涉及装配比如“一个底座上有两个轴承座中间穿一根轴”绝大多数工具会生成三个彼此无关的文件完全没有装配约束关系。原因很简单装配涉及空间关系、自由度约束和碰撞检查这些语义恰恰是自然语言最容易含糊的部分。我的建议是把装配体拆成一个个独立零件分别生成然后在专业CAD软件里做装配或者用文本描述零部件清单和约束关系再通过脚本按坐标摆放。后者对提示词的要求很高我不太推荐新手一上来就挑战。4.4 商业项目要留个心眼Text-to-CAD工具和训练数据的许可协议是一个容易被忽略但必须重视的问题。用个人测试无所谓但一旦进入商业产品、外包项目甚至专利申报环节你需要确认生成代码和模型的版权归属、使用限制以及底层依赖库的开源协议是否符合你的商用要求。我的做法是建立一个工具清单表记录每个工具或模型的开源协议、商用条款和版本信息在项目启动前给法务看一眼。这个动作花不了半小时却能避免后期很多麻烦。同样公司内部如果有设计数据安全要求也要确认在线工具是否允许你上传公司图纸或文档用于生成任务必要时优先选本地部署方案。4.5 常见问题速查问题现象可能原因快速解法预览正常但导入报错非流形体/重合面降低公差、增加特征重叠、网格修复后转实体尺寸与描述不符数字挂错特征核对生成源码参数提示词绑定特征与尺寸多次生成结果差异大提示词有歧义量化所有参数明确方向和约束代码执行报错API版本不匹配固定CadQuery版本提供正确API示例装配体没有约束关系工具不支持装配语义拆件生成后到专业CAD中装配商业使用有风险协议未确认开工前查许可协议必要时本地部署5. 一些真实体会Text-to-CAD还能怎么玩5.1 我把Text-to-CAD当成“设计意图编译器”用了一段时间后我越来越觉得它不像“AI设计师”更像一个“设计意图编译器”你把脑子里的设计意图用自然语言表达出来它负责翻译成CAD操作语言。理解这一点后我对它的期待合理了很多。我不会再要求它凭空设计出什么惊人结构而是专注在“我把需求说清楚了吗”这件事上。需求越清晰输出越稳定这和给一个初级工程师布置任务没有区别。这种思维方式的转变比学会任何一个具体工具都重要。5.2 还能往哪个方向扩展在实际项目中我已经把Text-to-CAD接进了几个周边流程。一是参数化变体批量生成写一个模板提示词通过脚本替换尺寸数字一口气生成十几个规格的零件模型然后自动导出STEP前端同事拿去做装配预览。二是和3D打印切片联动生成模型后直接导出STL再用打印机的切片软件自动排版处理完成从需求到实物的一次性流水线。三是反馈进BOM系统从提示词里结构化提取物料属性生成零件后自动关联编码、材质和数量减少手工录入。我个人的下一步计划是把筛选出来的稳定零件描述整理成企业内部的“设计语料库”让新人也能用自然语言快速调出符合公司标准的模型。这个方向看起来不起眼但真做起来对团队效率的提升比单纯追新工具来得实在。这些都做完了Text-to-CAD对我而言就不再是“会不会用某个网站”的问题而是一整套围绕自然语言建模的新工作流。我还在持续摸索也建议你从今天开始拿一个最简单的支架练手把一句“给我一个带孔的板”变成“给我一块60mm乘40mm、厚6mm的铝板中心开四个直径5mm的贯穿孔”你会明显感觉到这条路已经通了。