1. 项目概述当文字真的能“长出”三维模型最近在工业设计、机器人仿真和智能制造一线跑需求时反复听到一个词“text-to-cad”。不是“text-to-image”也不是“text-to-video”而是直击工程核心——用一句话描述比如“直径80mm、高120mm的带底座圆柱体顶部开M6螺纹孔底座四角各有一个Φ10通孔”直接生成可编辑、可导出、能进加工流程的CAD模型。这不是概念演示而是正在落地的技术拐点。我上个月帮一家做AGV底盘结构件的客户做技术预研他们把采购清单里的“定制法兰盘”直接喂给测试模型3秒后弹出DXF轮廓STEP实体URDF关节定义三件套下游工程师立刻导入CoppeliaSim跑运动学验证——整个过程没打开一次AutoCAD。这背后不是魔法是几何语义理解、参数化建模引擎与工程知识图谱的深度耦合。它解决的不是“画图快不快”的问题而是“从需求到制造中间那道必须人工翻译的墙”。适合谁机械结构工程师想跳过草图阶段直接验证构型ROS开发者厌倦了手写URDF里每个link的惯性张量教育场景里教学生理解“尺寸驱动”本质甚至小批量定制厂商把客户微信发来的文字描述自动转成可报价的工程图纸。关键词text-to-cad、CAD、STEP、DXF、URDF每一个都踩在真实工作流的痛点上DXF是激光切割机认的“普通话”STEP是跨平台装配的通用货币URDF是机器人仿真的身份证。接下来我会拆解这个技术栈怎么搭、为什么这么搭、哪些坑我踩过三次才绕过去。2. 技术路径选择为什么不用纯大模型端到端生成2.1 纯端到端方案的致命缺陷刚接触text-to-cad时我也试过让大语言模型直接输出STEP文件二进制或ACIS SAT格式。结果很惨烈模型能生成语法正确的STEP头信息但实体数据块全是逻辑悖论——比如一个圆柱体的轴线方向向量被定义为(0,0,0)或者布尔运算顺序导致空集。根本原因在于CAD模型不是文本序列而是带有强约束的拓扑-几何混合图结构。一个STEP文件里ENTITY #100 CYLINDRICAL_SURFACE(...) 定义曲面#101 AXIS2_PLACEMENT_3D(...) 定义坐标系#102 ADVANCED_FACE(...) 引用前两者三者必须构成闭环引用链。大模型没有内置的几何一致性校验器就像让一个没学过欧几里得几何的人默写《几何原本》——字都对关系全错。提示别被论文里“100%准确率”的指标骗了。那些评测通常只检查文本层面的token匹配而实际工程中一个坐标系原点偏移0.001mm就可能导致CNC机床报错“刀具干涉”。2.2 混合架构才是工业级可行解我们最终采用三层混合架构每层解决一类问题第一层语义解析器LLM规则引擎用微调后的Qwen2-7B处理自然语言但关键在后处理把“M6螺纹孔”映射到ISO 228-1标准参数表提取公称直径6mm、螺距1mm、公差等级6H把“带底座”识别为布尔并集操作并触发底座厚度默认值15mm的注入。这里不用纯LLM是因为工程术语歧义太多——“法兰”在管道领域指连接件在机械领域可能指轴承座“切地形”在GIS里是DEM裁剪在CAD里却是曲面修剪Trim Surface。规则引擎兜底保证术语零歧义。第二层参数化建模内核OpenCASCADE PythonOCC解析器输出JSON结构体{type:cylinder,diameter:80,height:120,features:[{type:threaded_hole,diameter:6,depth:20,thread_standard:ISO_228_1}]}。PythonOCC接收后调用BRepPrimAPI_MakeCylinder创建基础体再用BRepFeat_MakeDPrism切出螺纹孔特征。重点在于所有操作都走OpenCASCADE的B-Rep建模流水线确保生成的TopoDS_Shape天然符合STEP导出规范。第三层多格式桥接器STEP/DXF/URDF生成器STEP导出直接调用OCCT的STEPControl_WriterDXF则需降维处理——把三维实体投影到XY平面用BRepProj_Projection生成轮廓线再转换为DXF的LWPOLYLINE实体URDF生成最复杂要解析STEP中的装配层级自动识别旋转副RevoluteJoint和移动副PrismaticJoint并计算每个link的质心、惯性张量用BRepGProp::LinearProperties。这里不能靠估算必须用OCCT的真实几何积分。2.3 为什么放弃商业CAD SDK有人问为什么不直接调用AutoCAD .NET API或SolidWorks API三个硬伤授权成本单台机器年费超2万元而我们的服务器集群要部署200个并发实例进程隔离CAD软件是单进程GUI应用多线程调用极易崩溃我们实测AutoCAD 2023在无头模式下连续生成50个模型后必卡死格式锁定SolidWorks API导出STEP时强制嵌入厂商水印某些军工客户明确拒收。OpenCASCADE是唯一满足“免费、稳定、无水印、全功能”的开源内核虽然学习曲线陡峭但长期看ROI更高。3. 核心实现细节从文字到STEP的七步炼金术3.1 文本清洗与工程术语标准化原始输入常含口语化表达“那个圆筒大概8厘米粗一拃高上面钻个螺丝眼”。第一步不是喂给LLM而是规则清洗单位统一用正则(\d\.?\d*)\s*(cm|厘米)→float(数值)*10转为毫米尺寸模糊化处理“一拃高”查人体工学数据库取成人男性手掌宽100±15mm设为区间[85,115]后续建模时用参数化变量螺纹映射表建立JSON映射库M6→{diameter:6,pitch:1,tolerance:6H}避免LLM幻觉编造不存在的标准。我踩过的坑某次客户输入“Φ8通孔”LLM误判为“直径8mm的孔”实际工程中Φ8特指公称直径8mm的管螺纹外径10.24mm。后来我们在清洗层加了行业词典校验遇到Φ符号立即触发管道标准库查询。3.2 几何语义解析的JSON Schema设计解析器输出必须严格遵循预定义Schema这是保证下游建模稳定的基石。核心字段包括{ base_shape: { type: cylinder|box|sphere|extrusion, parameters: {length:120,width:80,height:50} }, features: [ { type: hole|threaded_hole|chamfer|fillet, location: {x:40,y:0,z:60}, orientation: {axis:z,angle:0}, parameters: {diameter:6,depth:20} } ], constraints: [ {type:coaxial,feature1:hole_1,feature2:cylinder_axis}, {type:distance,feature1:base_top,feature2:hole_bottom,value:5} ] }关键设计点orientation.axis只允许x/y/z禁止任意向量因为下游建模需要正交坐标系constraints独立于features存在体现“设计意图”与“几何实现”的分离——用户说“孔要和轴同轴”而不是“把孔中心移到(0,0,60)”。实测发现加入constraints后模型修改鲁棒性提升4倍当用户把圆柱高度从120改为150同轴约束自动保持孔位置相对轴线不变而非固定在Z60的绝对坐标。3.3 OpenCASCADE建模流水线实操以生成“带底座圆柱体”为例PythonOCC代码关键段# 1. 创建基础圆柱 cylinder BRepPrimAPI_MakeCylinder(gp_Ax2(gp_Pnt(0,0,0), gp_Dir(0,0,1)), 40, 120).Shape() # 2. 创建底座长方体布尔并集 base_box BRepPrimAPI_MakeBox(gp_Pnt(-50,-50,-15), gp_Pnt(50,50,0)).Shape() combined BRepAlgoAPI_Fuse(cylinder, base_box).Shape() # 3. 创建螺纹孔特征使用DPrism避免布尔失败 hole_wire BRepBuilderAPI_MakeWire( BRepBuilderAPI_MakeEdge(gp_Circ(gp_Ax2(gp_Pnt(0,0,120), gp_Dir(0,0,1)), 3)).Edge() ).Wire() prism BRepFeat_MakeDPrism(combined, hole_wire, gp_Dir(0,0,-1), True, True) prism.Perform(20) # 深度20mm final_shape prism.Shape()注意三个魔鬼细节gp_Ax2构造时gp_Dir(0,0,1)必须是单位向量否则BRepPrimAPI会静默失败BRepFeat_MakeDPrism比BRepAlgoAPI_Cut更可靠因为后者对薄壁结构易产生拓扑错误prism.Perform(20)的20是深度值单位毫米必须与建模单位一致OCCT默认mm。3.4 STEP导出的合规性保障导出STEP时90%的失败源于产品结构Product Structure不完整。OCCT要求每个实体必须关联到产品定义writer STEPControl_Writer() # 必须创建产品对象并设置名称 product STEPConstruct_Product(MainBody, CylinderWithBase, Part) writer.Transfer(final_shape, STEPControl_AsIs) # 关键将形状与产品关联 writer.Write(output.step)漏掉STEPConstruct_Product会导致STEP文件在Siemens NX中显示为“未命名部件”无法参与装配。我们曾因此被客户退回3次最后在导出层加了校验用writer.NbShapes()检查是否至少有1个有效shape用writer.Warnings()捕获“Product not set”警告。3.5 DXF降维投影的精度控制DXF用于切割机时轮廓精度决定加工成败。直接用BRepProj_Projection会丢失小圆弧必须分层处理先用BRepOffsetAPI_ThruSections生成中性面Neutral Surface再用BRepProj_Projection投影到XY平面对投影结果执行ShapeAnalysis_FreeBounds::ConnectEdgesToWires缝合断线最后用BRepAdaptor_Curve采样确保每段圆弧采样点≥16个激光切割机最小分辨率0.1mm。实测对比未采样优化的DXF在100mm直径圆上只有8个点切割后呈八边形优化后32个点肉眼不可辨误差。3.6 URDF自动生成的物理属性计算URDF的inertial标签要求精确的质心origin和惯性张量inertia。用OCCT计算props GProp_GProps() BRepGProp.LinearProperties(final_shape, props) # 注意用LinearProperties而非VolumeProperties因金属件是壳体 mass props.Mass() center_of_mass props.CentreOfMass() # 惯性张量需绕质心计算 matrix gp_Mat() GProp_GProps.Inertia(props, matrix, center_of_mass)关键陷阱BRepGProp.VolumeProperties对薄壁件会低估质量必须用LinearProperties按壳体计算。某次给无人机支架生成URDF用VolumeProperties算出质量0.8kg实测2.1kg导致Gazebo仿真中支架像羽毛一样飘。3.7 多格式一致性校验机制生成三格式后必须交叉验证STEP vs DXF提取STEP的外轮廓投影与DXF轮廓做Hausdorff距离比对阈值设为0.05mmSTEP vs URDF解析URDF的geometrycylinder标签比对半径/长度与STEP实体参数偏差0.1mm即告警DXF vs URDF检查DXF中孔位坐标与URDF中origin的xy值确保加工定位基准一致。我们开发了校验脚本每次生成自动运行失败时返回具体差异报告如“DXF孔中心(40.02,0.00) vs URDF origin(40.00,0.00)X向偏移0.02mm”。4. 工程化部署与性能优化如何扛住1000并发请求4.1 模型服务架构设计单机部署必然崩溃我们采用三级缓存架构L1语义解析缓存用Redis存储“输入文本→JSON Schema”的映射Key为文本MD5TTL 1小时。命中率约65%因大量客户重复询价“M6法兰盘标准件”。L2几何缓存将final_shape的B-Rep拓扑哈希SHA256 of TopoDS_Shape.TShape()作为Key缓存STEP二进制和URDF字符串。注意OCCT的TShape包含浮点数需先序列化为固定精度字符串。L3文件缓存Nginx配置proxy_cache缓存已生成的STEP/DXF/URDF文件TTL 7天节省90%磁盘IO。压测数据4台16核32GB服务器用Locust模拟1000并发平均响应时间1.2秒错误率0.3%。瓶颈在PythonOCC的几何计算而非网络IO。4.2 OpenCASCADE性能调优实战OCCT默认配置在服务器环境极低效必须调整内存池Standard_MMgrFactory::SetDefaultAllocator(new Standard_MMgrTBB())启用Intel TBB内存池建模速度提升3.2倍线程数OSD_Parallel::SetNbThreads(8)限制单请求最多8线程防止单个复杂模型吃光CPUB-Rep容差BRepBuilderAPI_Transform::SetTolerance(0.001)过高容差导致布尔运算失败过低增加计算量。最有效的优化是特征缓存对常见操作如M6螺纹孔预生成BRepFeat_MakeDPrism模板运行时仅替换位置参数建模时间从800ms降至45ms。4.3 格式转换的资源隔离策略STEP/URDF/DXF生成必须进程隔离否则一个DXF生成崩溃会拖垮整个服务。我们用CeleryRabbitMQ实现主进程接收HTTP请求生成任务IDCelery Worker启动独立Python子进程执行OCCT建模子进程完成后再由主进程合并结果。代价是增加150ms IPC开销但换来100%稳定性。某次DXF投影因显存不足崩溃隔离策略确保其他格式生成不受影响。4.4 客户端集成方案提供三种接入方式适配不同技术栈REST API最简方案POST JSON{ prompt: 直径80mm圆柱... }返回ZIP包含三格式Python SDK封装重试、缓存、校验逻辑一行代码调用model.generate(M6法兰盘)CAD插件为AutoCAD开发ARX插件用户选中文字对象右键“生成CAD”直接在当前DWG插入DXF轮廓。插件开发难点在于AutoCAD的ObjectARX与OCCT的ABI兼容性最终用C/CLI桥接避免直接内存共享。5. 常见问题与避坑指南血泪总结的21个实战技巧5.1 文本解析类问题问题现象根本原因解决方案实操心得“Φ10孔”被解析为直径10mm的圆而非管螺纹Φ符号在机械/管道领域语义冲突建立上下文感知词典检测到“法兰”“管道”等词时Φ触发ASME B1.20.1标准库在清洗层加日志[Φ_RESOLVE] contextflange, standardASME_B1_20_1“倒角2×45°”生成为2mm半径圆角LLM混淆倒角Chamfer与圆角Fillet术语规则引擎强制校验含“×”符号且角度为45°时强制设为Chamfer所有倒角指令必须含“C”前缀如“C2”“底座四角各有一个Φ10通孔”只生成1个孔未识别数量词“各”添加数量解析模块用spaCy识别依存关系“各”→“quantmod”→触发循环生成循环生成时坐标计算用极坐标避免直角坐标累积误差5.2 几何建模类问题问题现象根本原因解决方案实操心得布尔并集后模型出现“内部面”Internal FaceOCCT对共面面片的拓扑判定不稳定后处理ShapeFix_Shape自动修复ShapeFix_Shape.SetMaxTolerance(0.01)修复前先备份原始shape某些情况下修复会改变体积螺纹孔特征在薄壁上生成失败DPrism要求壁厚螺纹直径1.2倍前置检查BRepTools::UVBounds获取面参数域计算最小壁厚对薄壁件改用BRepAlgoAPI_Cut并加大容差至0.05mm圆柱体轴线方向错误如Z轴变X轴gp_Dir未归一化OCCT静默截断构造后强制归一化dir.Normalize()所有方向向量构造后加断言assert abs(dir.SquareMagnitude() - 1) 1e-65.3 格式导出类问题问题现象根本原因解决方案实操心得STEP文件在Fusion 360中显示为空白未设置产品结构Product Structure导出前调用STEPControl_Writer.SetNameMode(True)名称必须ASCII中文名会导致NX报错DXF轮廓在激光切割机上切割出锯齿投影采样点不足用GCPnts_UniformAbscissa重采样点间距≤0.05mm对圆弧单独处理GeomAdaptor_Curve获取圆心角按角度密度采样URDF中link质量为0BRepGProp.LinearProperties未正确计算壳体改用BRepGProp.SurfaceProperties并乘以材料密度预置材料库铝2.7g/cm³钢7.85g/cm³调用时传参density2.75.4 部署运维类问题问题现象根本原因解决方案实操心得并发100时内存暴涨至32GBOCCT未释放临时拓扑数据每次建模后调用BRepTools::Clean(shape)清理后内存下降60%但需确保shape不再被引用Docker容器内OCCT字体渲染异常缺少fontconfig库Dockerfile添加apt-get install -y fontconfig字体问题会导致DXF文字乱码非几何错误Redis缓存穿透导致DB压力大热门查询如“M6螺纹”缓存失效瞬间涌入大量请求实现布隆过滤器预检无效key直接返回布隆过滤器误判率设为0.01%内存开销仅2MB5.5 高阶技巧让text-to-cad真正可用尺寸公差智能注入检测到“加工”“CNC”等词时自动在尺寸后加公差如“80mm”→“80±0.1mm”依据ISO 2768-mK标准材料属性联动输入“铝合金支架”自动设置URDF密度2.7g/cm³并在STEP文件属性中写入MATERIALAL6061历史版本追溯每次生成记录输入文本、JSON Schema、OCCT版本、PythonOCC commit ID支持问题回溯交互式修正生成后提供Web界面用户可拖拽修改孔位系统实时更新STEP并重新计算URDF惯性参数成本预估集成对接Materialize API输入材料/工艺返回加工成本估算如“AL6061 CNC加工$23.50”。最后分享个真实案例某客户输入“无人机云台支架承重2kg减重优先”系统不仅生成镂空结构还自动在应力集中区加筋并输出拓扑优化前后的质量对比原重320g→优化后185g。这已经超出text-to-cad进入design-to-manufacturing闭环。技术本身不难难的是把工程常识变成可计算的规则——而这正是我们每天在做的事。