1. 一句话需求变三维模型text-to-cad到底解决了什么问题不知道你有没有经历过这种场景脑子里已经有了一个零件的大致形状比如“一个带四个安装孔的圆形法兰”“一根一端有内螺纹的铝合金管”但要把它变成能拿去3D打印或者送厂加工的CAD文件还得老老实实坐在建模软件前拉草图、加约束、拉伸切除、倒角……一套流程下来快则半小时慢则半天。text-to-cad这条技术路线就是想把这个过程直接压缩成一句话。你只需要用自然语言描述自己想要的零件系统会结合大语言模型和参数化建模工具生成一个真正可编辑、可测量、可以导出的CAD模型而不仅仅是一张效果图或者一个封闭的三角网格。它输出的可以是STEP、STL也可以是CadQuery脚本方便后续二次修改。这个方向对三类人最有价值一是经常做快速原型验证的硬件工程师二是大量制作定制零件的3D打印玩家三是在自动化设计流程里需要批量生成标准件的开发者。它不一定能替代传统CAD软件但能帮你把那些重复度高、逻辑清晰的建模需求交给代码去完成。本质上看text-to-cad是“文本描述→程序化建模代码→三维几何体”这样一条链路中间的关键翻译者就是如今已经相当成熟的大语言模型。2. 为什么说“代码生成”才是聪明的落地方式2.1 直接让大模型“画”出模型听起来很美实际很难做最早大家做文本生成三维模型都是走“文本→图像生成中间态→三维重建”或者“文本→隐式神经场”这条路。确实有demo能生成一些类似椅子、桌子的点云或网格但真拿到工程软件里就发现完全没法用网格是三角形拼起来的没有圆角参数、没有特征树、没有尺寸标注更不用说把孔位改了之后整个零件自动更新。工程上需要的CAD模型核心是特征和参数。拉伸、旋转、倒角、打孔这些操作背后都对应着明确的几何约束。让大语言模型直接输出网格等于绕开了几何逻辑只给了结果不给过程。过程一旦缺失后续修改就变成重新生成一遍设计就成了“不可控的一次性输出”。2.2 代码生成路线把“写几何”变成“写程序”text-to-cad目前比较成熟的思路是让大模型输出一段程序化的建模脚本再由脚本引擎执行生成CAD模型。这里说的“代码”在多数场景下是CadQuery或OpenSCAD脚本。CadQuery是一个基于Python的参数化建模库它的设计理念和传统CAD的“特征建模”几乎一一对应你可以用Workplane对象做拉伸用.holes()打孔用.edges().fillet()做圆角写出来的每一行代码都对应一个特征操作。大模型训练数据里包含大量这类代码因此它天然擅长生成CadQuery脚本而不是直接生成STEP文件。把建模变成代码还有一个额外的好处版本管理和批量修改变得非常容易。一套CadQuery脚本传一个参数进去就能生成不同尺寸的法兰盘。这比在图形界面里手动拖动控制柄来改尺寸要可靠得多尤其适合标准件库、BOM管理这类场景。2.3 常见工具链对比目前做text-to-cad主要会接触到这几个工具我按自己的使用经验整理了一下工具建模方式语言适合场景缺点CadQuery程序化特征建模Python机械零件、装配体、批量参数化学习门槛稍高需要懂基本编程OpenSCADCSG实体建模自研脚本语言简单几何体、参数化设计圆角和复杂曲面处理弱Zoo Text-to-CAD在线文本转CadQueryPython快速验证提示词效果需要联网、受API响应影响Blender bpy多边形建模为主Python偏向外观原型非精密机械件不适合直接出工程数据我个人最推荐刚接触text-to-cad的人从CadQuery上手原因有两条一是它和传统CAD的思维方式高度接近逻辑上容易迁移二是它生成的STEP文件带精确边界表示导入FreeCAD或者Fusion 360之后可以直接继续编辑不会像网格那样“读到一堆三角形”。3. 完整实操从一句描述到一个可以加工的零件3.1 先装好本地环境先提醒一句虽然像Zoo这样的在线工具能帮你快速体验但真要拿text-to-cad到自己的工作流里本地环境必须自己搭。这里用Python加CadQuery方案干净且可控。安装其实很简单前提是你已经装好了Python 3.9以上的版本接着执行这样几步pip install cadquery pip install jupyter装完之后强烈建议装一个VS Code的Jupyter插件直接在notebook里写CadQuery脚本执行完立刻能看到三维预览比一次次跑命令行舒服太多。你以为到这儿就结束了没有。CadQuery虽然能生成几何但默认情况下它并不会自动调起一个三维查看器。想最直观地检查模型还有一个小工具要装叫cq-editor它相当于CadQuery的专属IDE左侧写代码右侧实时渲染是目前text-to-cad调试环节里体验很好的组合。3.2 准备一个高质量的提示词这一步是整个流程里最值得花心思的地方。很多人第一次用text-to-cad生成出来的模型压根没法看并不是工具不行而是提示词给得太模糊。举个例子如果你只写“帮我做一个法兰盘”大模型大概率会生成一个什么尺寸都不明确的圆盘但如果你写“生成一个外径80mm、内径40mm、厚度10mm的圆形法兰盘在直径60mm的圆周上均匀分布4个直径为6mm的贯通孔所有锐边倒角0.5mm”生成出来的东西立刻就能用。这里有一个比较少人提到的技巧提示词里尽量把“相对描述”换成“绝对尺寸”。比如不要写“厚一点的板子”要写“厚度12.5mm”不要写“几个螺丝孔”要写“6个M4通孔沿直径50mm的圆均布”。原因是语言模型对模糊量词的理解经常飘忽不定但对数字的感知相对可靠。单位也要写清楚默认情况下CadQuery使用毫米但如果你习惯英制请务必在提示词里说“单位是英寸”。3.3 用LLM生成CadQuery代码写好提示词之后把下面这段作为模板方式丢给大模型请用CadQuery生成一个零件要求如下 外径80mm内径40mm厚度10mm的圆形法兰盘 在直径60mm的圆周上均匀分布4个直径为6mm的贯通孔 所有锐边倒角0.5mm 代码需要包含完整的CadQuery工作平面操作 输出代码后用一句话解释每个主要特征对应的代码段。一个合格的模型会返回类似这样的代码import cadquery as cq # 创建外径80、内径40、厚度10的法兰盘 result ( cq.Workplane(XY) .circle(80 / 2) .extrude(10) .faces(Z) .circle(40 / 2) .cutBlind(-10) # 从顶面挖出内孔 .faces(Z) .workplane() .pushPoints([(60 / 2, 0), (0, 60 / 2), (-60 / 2, 0), (0, -60 / 2)]) .hole(6) .edges(|Z) .fillet(0.5) )这里顺便解释下代码里的关键点.circle()创建的是二维轮廓.extrude()负责拉伸成实体.faces(Z)选取顶面.pushPoints()一次在圆周上放置四个点然后.hole(6)在这四个点上打出直径6mm的孔最后.edges(|Z)选取竖边并倒一个0.5mm的圆角。3.4 验证、检查、迭代生成代码之后最忌讳的事情就是“看一眼觉得没问题就直接拿去切片”。我踩过最大的坑是模型表面看起来完全正常但导入切片软件发现内孔实际没有打通——原因是Cut操作时方向写反了。text-to-cad生成的是程序化模型它最大的特点是可复现但这也意味着代码里一个符号的错误会直接决定整个零件是否可用。所以每次生成完第一件事是在cq-editor里旋转视角、切换显示模式检查几个关键维度。尤其是孔径、壁厚、孔的位置用测量工具逐个核对。如果发现孔偏了不要重新描述整个零件只需要在提示词里追加一句修正比如“四个通孔应该均匀分布在直径60mm的圆上目前角度位置有偏移请修正”大模型通常能理解增量修改这比从头再来高效得多。4. 高级玩法从单一零件走向参数化系列4.1 给模型加可调参数text-to-cad比较吸引人的地方是同一段代码可以衍生出不同规格的零件。一个法兰盘只要把外径、孔径、孔数、厚度这些关键值从硬编码变成变量你手里就拥有了一整个法兰盘系列。实际做参数化时我习惯在CadQuery脚本顶部定义一个配置段把所有关键尺寸集中管理import cadquery as cq # 参数集中管理 outer_diameter 80 inner_diameter 40 thickness 10 hole_circle_diameter 60 hole_count 4 hole_diameter 6 fillet_radius 0.5 # 计算孔的位置角度 import math angles [360 / hole_count * i for i in range(hole_count)] ...这样写完之后想生成一个外径100、6个孔的法兰盘只需要改上方两个值然后重新执行脚本。配合ChatGPT或者本地大模型你甚至可以让它自动生成一套参数配置再跑一遍脚本相当于让代码帮你完成系列化设计。4.2 多实体与装配体思路单零件玩熟之后很多人自然会想尝试装配体。CadQuery里可以通过Workplane叠加多个实体也可以用cq.Compound把它们组合起来。text-to-cad现在处理多零件装配的能力还不是很强但有个技巧可以绕过去把装配拆成多个独立零件分别生成再在提示词里约定好配合尺寸。比如要做一个“内孔直径25mm的轴承座”先在提示词里规定轴承孔径是25然后生成座子再规定配合轴的直径是24.9留0.1mm间隙生成轴。分别导出STEP再导入FreeCAD里装配比一次性让模型生成一个完整装配体要可靠得多。nl这是一个非常实在的建议我自己试过直接生成装配体结果零件之间发生干涉的情况非常频繁因为大模型难以在一次推理中同时协调多个零件的空间关系。4.3 批量生成场景的工程化如果你需要一次生成20种尺寸的支架、50种规格的垫片手写提示词已经不够了。此时可以把提示词做成模板用脚本循环调用大模型API。我自己的做法是先写出一个基准提示词把尺寸作为变量然后用Python脚本读取一个尺寸表格逐行替换变量并调用大模型接口再把返回的代码保存到对应文件夹接着统一执行CadQuery脚本导出STL。整套流程跑下来一个小时生成上百个零件完全可行。这样做最大的价值不是省时间而是把设计过程变成了数据驱动尺寸表格就是产品规格表提示词模板就是设计规则。以后客户改一个尺寸你甚至不用打开CAD改表格里一行数字重新跑一遍流程就能拿到新模型这对小批量定制业务效率提升明显。5. 实操中经常踩的坑和排查办法5.1 生成的模型总是“差一点”提示词精度不足这是最常见的问题症状表现为模型大致形状对但孔位偏了、倒角没了、壁厚错了。原因基本都是提示词里缺少量化和空间关系的描述。前面我已经提过要写绝对尺寸和明确位置关系这里再补充一个技巧用“相对特征”来描述。比如“孔距离上表面5mm”比“孔在中间”要明确得多因为大模型对“中间”的理解不够稳定但对“距离xxx面xx mm”这种带参考基准的描述准确率会高很多。5.2 代码能执行但导入其他软件报错CadQuery生成的STEP文件大多数时候是没问题的但偶尔导入Fusion 360或SolidWorks会提示“几何不完整”或“面缺失”。我研究过多数情况是模型里有非常细小的碎面尤其是小圆角、薄壁特征附近。解决办法在生成阶段就要控制提示词里不要同时要求“极小的圆角”和“极薄的壁体”。圆角半径小于0.2mm、壁厚小于1mm时生成出错率会显著升高。如果必须做小特征我建议把圆角拆到CAD软件里手工处理而不是让text-to-cad一把梭。5.3 孔没有贯通孔未贯通的情况我已经提到过一次。这句话单独拿出来说是因为它太容易被忽略。有时你看到的代码里确实有.hole()操作但它通常会挖穿当前工作平面以下的所有材料如果工作平面选错了比如选到了内孔底面上孔可能只挖了一半。检查方法很简单生成之后用CtrlZ级别的历史操作回退看每步特征确认孔特征的位置。如果发现自己不太会看特征树也可以直接用CadQuery的.val().isValid()做一次布尔运算自检看有没有报“几何体无效”的异常信息。5.4 生成速度慢到无法接受不少在线text-to-cad工具在高峰期响应很慢一次生成要等一分多钟。你要是反复修改提示词那种体验真的很消磨耐心。我之前也遇到过类似的情况后面改成自建方案把任务拆成“离线批量生成代码本地渲染”不再依赖在线工具逐步反馈。也就是说先用大模型一次性生成所有零件的脚本再统一在本地执行CadQuery这样只有在代码出错时才需要调用大模型做针对性修复交互次数能从二十几次降到两三次。5.5 快速验证小技巧输出格式选择如果你打算3D打印导出STL几乎够用如果你还要机加工务必选STEP。CadQuery对STEP支持很好因为它本身就是精确建模内核。这里有一个很多新手不知道的细节STL是三角网格转成STL之后就不要指望还能编辑了所以建议把CadQuery脚本保存成.py文件作为源文件STL和STEP都作为成品输出。三个文件保留一套才算形成一个完整的设计闭环。我顺手整理了一份快速排查表遇到问题可以直接对照现象可能原因解决办法外形对但孔位偏提示词缺少角度或相对位置描述补充“孔沿直径xx的圆均布”倒角缺失特征选择边不对在提示词中写明“对顶面外边界倒角”导入SolidWorks报错碎面过多调大圆角半径或减少薄壁特征孔没有打通工作平面选择错误改用faces(Z)再执行孔操作尺寸整体偏大单位混乱在提示词中明确“是否毫米”6. 我认为这条技术路线的边界在哪里最后聊点实操之外的感受。我用了大概两个月的时间把text-to-cad从“玩具”阶段推进到能处理日常零件生成的阶段最大的感知是它的能力边界比想象中宽但取代不了设计师。它真正擅长的是标准件、简单结构件、参数化系列件——那些高度规则、边界清晰的建模任务它目前还做不了的是复杂的曲面造型、需要大量美学判断的产品外观以及需要深入考虑加工工艺的精密结构。所以我对它的定位是“设计师手边的一块快捷板”你和它打交道就像是和一个刚毕业、理解力强但是经验少的助理打交道——你把需求说得越具体它产出得越准确你如果只给一句“做个好玩的东西”那大概率得到的也是没法用的东西。提高text-to-cad可用性最重要的能力不是写代码而是把你的需求翻译成机器能理解的精确语言。如果你正打算入坑我建议先从最简单的零件开始比如一个带孔的法兰盘、一个L型支架跑通整个流程后再逐步增加特征复杂度。等你习惯了“描述需求→生成代码→检查修改”这个循环再回头看自己过去手动建模的那些重复劳动会发现自己多出了一个值得信任的自动化助手。