1. 项目概述：当文字真的能“长出”三维模型——text-to-CAD不是科幻，是正在落地的工程范式革命
“text-to-CAD”这四个字最近在工程师茶水间、设计院晨会和CAE仿真组的 Slack 频道里出现频率陡增。它不是AI画图那种“看起来像”的视觉生成，而是直指工业设计最硬核的底层——用自然语言描述一个零件的功能、约束、装配关系和制造要求，系统就能输出符合ISO标准、可直接用于数控加工（CAM）、结构仿真（CAE）甚至3D打印的参数化CAD模型（如STEP AP242或Parasolid格式）。我去年在某汽车零部件厂做产线数字化升级时，亲眼见过一位老工程师对着语音助手说：“生成一个带M6内螺纹、外径42mm、轴向通孔Φ8mm、两端倒角C1.5、材料为6061-T6铝合金的连接法兰盘”，37秒后，SolidWorks里就弹出了一个完全合规、特征树清晰、尺寸驱动可编辑的实体模型——他没点过一次鼠标，也没拖过一条草图线。这背后不是魔法，是几何推理引擎、约束求解器与大语言模型在工程语义空间里的深度耦合。它解决的痛点极其具体：传统CAD建模中，70%以上时间花在“把脑中的形状翻译成软件指令”这个低效转换上；而text-to-CAD直接跳过中间层，让“意图”直达“几何”。它适合三类人：一是被重复建模压得喘不过气的初级工程师，二是需要快速验证多个概念方案的创新团队，三是想把历史设计知识沉淀为可检索、可复用语义资产的企业知识管理者。别被“text-to-anything”的泛化宣传带偏——text-to-CAD的成败，不取决于文生图的美学精度，而取决于对GD&T（几何尺寸与公差）、ASME Y14.5标准、特征识别逻辑、拓扑约束传递等工业语义的毫厘级理解。这才是它和普通AIGC工具的本质分水岭。
2. 核心技术拆解：为什么“说句话就出模型”比“说句话就出画”难十倍？
2.1 工程语义解析：从“螺纹”到“M6×1-6H内螺纹”的精准映射
自然语言里一句“做个带螺纹的孔”，对人类是模糊共识，对CAD系统却是灾难性歧义。text-to-CAD的第一道生死关，是工程语义解析（Engineering Semantic Parsing）。它必须将口语化描述，无损映射到ISO 22081或ASME B1.1定义的精确参数空间。比如“螺纹”这个词，在不同上下文里可能指向：
- 紧固件螺纹（如M6×1-6H）：需解析出公称直径6mm、螺距1mm、公差等级6H；
- 管螺纹（如G1/4）：需识别锥度、牙型角55°、密封方式；
- 自攻螺纹（如ST3.5×12）：需关联底孔直径、攻入深度、材料适配性。
我实测过几个开源模型，发现它们常把“M6螺纹”错误解析为“直径6mm的圆柱孔”，完全丢失螺距、公差、旋向等关键维度。真正可靠的方案，必须内置一个轻量级但完备的工程本体库（Ontology），其节点不是“螺纹”这种宽泛概念，而是“ISO_Metric_Thread_M6x1_Left_Hand_6g”。这个本体库的构建逻辑很务实：我们不是从零造轮子，而是把《机械设计手册》第3卷、GB/T 197-2018《普通螺纹 公差》、ISO 965-1:2022的PDF文本，用规则+微调LLM的方式结构化抽取，形成一个可查询、可推理的语义图谱。当用户输入“内螺纹”，系统先查图谱，确认当前上下文是“孔”，再根据材料（铝合金）、用途（连接法兰）、载荷（静载）等约束，自动推荐最常用规格M6×1-6H，并将参数注入后续几何生成模块。这个过程没有“猜测”，只有基于标准的确定性推理。> 提示：很多初学者误以为用ChatGPT微调就能搞定语义解析，实测结果是——它能把“倒角”理解成“斜面”，但无法区分C1.5（45°倒角）和1×45°（同样是45°但标注法不同），更别说处理“未注倒角C0.5”这种隐含规则。工程语义的刚性，决定了必须用规则引擎兜底，LLM只负责模糊匹配和上下文消歧。
2.2 几何生成引擎：从“意图”到“B-Rep”的不可逆压缩
拿到精准语义后，text-to-CAD的核心挑战才真正开始：如何把“带M6内螺纹的法兰盘”这个意图，转化为SolidWorks里那个由拉伸、旋转、螺纹切削特征构成的、可参数驱动的B-Rep（边界表示）模型？这里存在一个根本性矛盾：自然语言是高度压缩的，而CAD模型是信息极度冗余的。一句话描述可能只有20个token，但一个中等复杂度的STEP文件动辄数万行AP242实体数据。生成引擎必须完成一次“有损但可控”的信息膨胀。目前主流方案有两条技术路径：
路径一：基于草图的渐进式生成（Sketch-Driven Generation）
这是最贴近人类设计师工作流的方式。系统先解析出核心轮廓（如“外径42mm的圆盘”），生成一个带尺寸约束的二维草图；再识别“轴向通孔Φ8mm”，在草图上添加同心圆；最后处理“M6内螺纹”，不是直接建模螺纹牙型（那会爆炸式增加面片数），而是调用SolidWorks API的FeatureManager.CreateThread方法，传入标准螺纹参数。这种方式的优势是特征树干净、可编辑性强，但瓶颈在于草图约束求解器的鲁棒性——当用户说“在离边缘10mm处开孔”，系统必须准确识别“边缘”是哪个环形边，且在多环共存时无歧义。我们团队曾为某泵阀企业定制此方案，发现超过35%的失败案例源于草图约束冲突，最终靠引入一个“约束冲突预测器”（用图神经网络预判哪些尺寸标注组合会导致欠约束/过约束）才将成功率从68%提升至92%。
路径二：基于体素的隐式建模（Voxel-Based Implicit Modeling）
这条路绕过传统CAD的显式建模流程，直接用神经辐射场（NeRF）或SDF（符号距离函数）生成三维占据网格，再通过Marching Cubes算法提取表面，最后用拓扑修复算法（如OpenCASCADE的ShapeFix_Shape）转为合规B-Rep。它的优势是能处理“有机曲面”“拓扑奇异”等传统CAD难以表达的形态，比如用户说“设计一个仿生蜂巢结构散热片”，它能直接生成带周期性六边形单元的曲面。但代价巨大：单个中等模型生成耗时超2分钟，内存占用峰值达16GB，且生成的STEP文件常因面片质量不达标被NX拒绝导入。我们做过对比测试：对标准法兰盘这类规则件，Sketch-Driven方案平均耗时4.2秒，模型大小127KB；而Voxel方案耗时118秒，模型大小2.3MB，且在ANSYS Workbench中网格划分时报错率高达41%。所以，工业级text-to-CAD绝不是“选哪个先进就用哪个”，而是根据目标场景（规则件批量建模 vs 概念创意生成）做技术栈裁剪。
2.3 约束求解与参数化闭环：让模型“活”起来的关键
text-to-CAD最易被忽视、却最体现工程价值的环节，是参数化闭环（Parametric Loop Closure）。一个真正可用的模型，不能是“一次性快照”，而必须支持后续修改。比如用户生成法兰盘后说：“把螺纹改成M8”，系统不该重新走一遍全流程，而应定位到螺纹特征，仅更新其直径、螺距、公差参数，并自动调整底孔直径（从Φ5.0→Φ6.8）、倒角尺寸（C1.5→C2.0）等关联约束。这要求生成引擎内部维护一个动态约束图（Constraint Graph），其中每个节点是几何实体（点、线、面、特征），每条边是约束关系（平行、同心、距离、相切）。当用户修改一个参数，系统通过拓扑遍历+增量求解，只刷新受影响的子图。我们曾用某开源框架生成一个带6个安装孔的支架，当尝试将孔径从Φ6改为Φ8时，系统花了17秒重新计算全部特征，原因是它把整个模型当做一个黑盒重算。后来我们重构了约束图，明确区分“主干约束”（决定整体拓扑）和“枝叶约束”（决定局部细节），使同类修改响应时间降至1.3秒。> 注意：很多演示视频里模型“秒变”，实际是前端做了缓存动画，后台仍在苦算。真正的参数化闭环，必须在STEP/AP242层级实现约束继承——即导出的STEP文件里，geometric_tolerance和dimensional_size实体必须携带完整的applied_condition和tolerance_value，否则下游CAE软件读取时会丢失公差信息，导致仿真结果失真。
3. 实操落地指南：从零搭建一个可验证的text-to-CAD最小可行系统
3.1 环境准备与工具链选型：避开那些“看似强大实则坑深”的陷阱
搭建text-to-CAD系统，第一步不是写代码，而是选对“地基”。我见过太多团队栽在工具链选择上：花三个月用PyTorch从头训练一个几何生成模型，结果发现连最基础的“画直线”都抖动，因为忽略了CAD内核的数值稳定性要求。以下是经过我们12个工业客户验证的最小可行工具链（MVP Stack），兼顾开发效率与工程可靠性：
| 模块 | 推荐方案 | 关键理由 | 替代方案风险提示 |
|---|---|---|---|
| CAD内核 | SolidWorks API (C#) 或 FreeCAD + OpenCASCADE | SolidWorks API提供最成熟的CreateThread、CreateFillet等工业级特征创建接口，且其约束求解器经30年验证；FreeCAD开源免费，OpenCASCADE是STEP标准官方参考实现，对AP242支持最全 | 使用Blender Python API：虽有bpy.ops.mesh.primitive_cylinder_add，但生成的网格模型无法导出带参数的STEP，下游CAM软件报错 |
| 语义解析 | spaCy + 自定义规则引擎（基于JSON Schema） | spaCy的NER（命名实体识别）可精准提取“M6”、“42mm”、“C1.5”等工程实体；规则引擎用JSON Schema定义约束（如“螺纹直径必须为标准值序列[1,1.2,1.4,1.6,1.8,2,2.2,...]”），保证输出绝对合规 | 微调Llama-3：在小样本下能泛化，但无法保证“M6”不被误为“M60”，且无标准值校验能力 |
| 几何生成 | Sketch-Driven（SolidWorks）或 OCC-BRep（FreeCAD） | 对规则件，Sketch-Driven生成速度<5秒，特征树可编辑；OCC-BRep可直接操作B-Rep拓扑，生成的STEP文件被所有主流CAE软件100%兼容 | 使用Diffusion模型（如Point-E）：生成点云后转网格，但点云密度不均，转STEP时常出现“非流形边”，NX导入时报“Invalid topology” |
| 部署接口 | FastAPI + WebSocket | FastAPI提供自动文档和高并发，WebSocket支持实时建模进度推送（如“正在创建螺纹...”），用户体验远超HTTP轮询 | Flask：无原生异步支持，建模耗时>10秒时用户易刷新页面，导致重复提交 |
特别强调一个血泪教训：绝对不要用AutoCAD作为text-to-CAD的生成内核。AutoCAD的DXF/DWG本质是绘图指令流，不是参数化模型。它没有“特征树”概念，无法表达“这个孔是拉伸出来的”，更无法关联“修改孔径自动更新倒角”。我们曾为某建筑公司做BIM构件生成，强行用AutoCAD API，结果导出的DWG被Revit读取后，所有尺寸都变成静态文本，无法做工程量统计。记住：text-to-CAD的终点必须是参数化B-Rep，不是二维图形。
3.2 核心代码实现：一个可运行的“文字生成法兰盘”完整流程
下面是一个基于SolidWorks API的C#核心实现（已脱敏，可直接编译运行）。它展示了从文本解析到STEP导出的全链路，重点看三个关键设计：
- 语义解析的防御性编程：对非标输入（如“M6.5螺纹”）自动降级为最接近标准值（M6）并告警；
- 特征创建的事务化封装：所有CAD操作包裹在
swModel.Extension.StartTransaction()中，失败时自动回滚； - STEP导出的合规性保障：强制指定
swStepAP242标准，并设置IncludeDrawings = false避免图纸干扰。
// C# - SolidWorks API text-to-CAD核心逻辑（简化版） public class TextToCADProcessor { private SldWorks swApp; private ModelDoc2 swModel; // 1. 语义解析：将文本转为结构化参数 public CADParameters ParseText(string input) { var paramsObj = new CADParameters(); // 使用正则提取尺寸（例："外径42mm" → 42.0） var diameterMatch = Regex.Match(input, @"外径\s*(\d+\.?\d*)\s*mm"); if (diameterMatch.Success) paramsObj.OuterDiameter = RoundToStandard(diameterMatch.Groups[1].Value, StandardDiameters); // 提取螺纹规格（例："M6内螺纹" → M6×1-6H） var threadMatch = Regex.Match(input, @"M(\d+)(?:×(\d+\.?\d*))?[\s\S]*内螺纹"); if (threadMatch.Success) { string nominalDiameter = threadMatch.Groups[1].Value; string pitch = threadMatch.Groups[2].Success ? threadMatch.Groups[2].Value : "1"; // 默认螺距1mm // 关键：校验是否为标准螺纹（GB/T 196-2003） var standardThread = FindClosestStandardThread(nominalDiameter, pitch); if (standardThread == null) throw new Exception($"非标螺纹M{nominalDiameter}×{pitch}，已降级为{GetDefaultStandardThread(nominalDiameter)}"); paramsObj.ThreadSpec = standardThread; } return paramsObj; } // 2. 几何生成：调用SolidWorks API创建参数化模型 public void GenerateModel(CADParameters paramsObj) { try { swApp.Extension.StartTransaction("Text-to-CAD Generation"); // 开启事务 // 创建新零件 swModel = (ModelDoc2)swApp.NewDocument("C:\\Program Files\\SOLIDWORKS Corp\\SOLIDWORKS\\lang\\chinese-simplified\\Part.asmdrwd", (int)swDocumentTypes_e.swDocPART, 0, 0); // 第一步：创建基准面（前视基准面） var sketch = swModel.CreateDrawnSketch(0, 0, 0); // 简化示意，实际需获取基准面 // 第二步：绘制外圆草图 sketch.CreateCircle(0, 0, 0, paramsObj.OuterDiameter / 2); // 第三步：拉伸成盘体（厚度默认12mm） var feature = swModel.FeatureManager.FeatureExtrusion2( true, false, false, 0, 0, 12, 0, false, false, false, false, 0, 0, false, false, false, false, false, true, true, false); // 第四步：创建中心孔（Φ8mm） var holeSketch = swModel.CreateDrawnSketch(0, 0, 0); holeSketch.CreateCircle(0, 0, 0, 4); // Φ8mm半径 swModel.FeatureManager.FeatureExtrusion2( true, false, false, 0, 0, 12, 0, false, false, false, false, 0, 0, false, false, false, false, false, true, true, false); // 第五步：添加M6内螺纹（调用原生螺纹特征） var threadFeature = swModel.FeatureManager.CreateThread( paramsObj.ThreadSpec.NominalDiameter, // 6.0 paramsObj.ThreadSpec.Pitch, // 1.0 (int)swThreadTypes_e.swThreadType_INTERNAL, (int)swThreadCalloutTypes_e.swThreadCalloutType_DIN, paramsObj.ThreadSpec.ToleranceClass); // "6H" swApp.Extension.CommitTransaction(); // 提交事务 } catch (Exception ex) { swApp.Extension.RollbackTransaction(); // 失败则回滚 throw new Exception($"建模失败: {ex.Message}"); } } // 3. STEP导出：确保AP242合规 public void ExportToSTEP(string filePath) { var exportData = (IStepExportData)swApp.GetExportFileData((int)swExportDataFileType_e.swExportDataSTEP); exportData.AP242Export = true; // 强制AP242 exportData.IncludeDrawings = false; exportData.IncludeConfigurationInformation = true; bool result = swModel.Extension.SaveAs( filePath, (int)swSaveAsVersion_e.swSaveAsCurrentVersion, (int)swSaveAsOptions_e.swSaveAsOptions_Silent, exportData, 0, 0); if (!result) throw new Exception("STEP导出失败，请检查文件路径权限"); } }这段代码的实操价值在于：它把抽象的“text-to-CAD”概念，锚定在SolidWorks这个工程师每天都在用的工具上。你不需要懂NeRF或SDF，只要会调用CreateThread和SaveAs，就能产出真实可用的STEP文件。我们给某电机厂部署时，就是基于此框架，用3天时间教会他们的工艺员用Excel批量填写参数（A列：描述；B列：材料；C列：热处理），一键生成200个接线盒模型，导出的STEP被西门子NX12无缝导入，直接用于冲压模具NC编程。
3.3 STEP文件质量验证：为什么你的模型在SolidWorks里完美，到了ANSYS里就报错？
生成STEP文件只是万里长征第一步，真正的考验是下游软件能否正确解读。我统计过152个客户案例，发现38%的text-to-CAD项目卡在STEP验证环节。常见问题及解决方案如下：
| 问题现象 | 根本原因 | 解决方案 | 验证工具 |
|---|---|---|---|
| ANSYS Workbench报错：“Failed to import geometry due to invalid topology” | 生成的STEP包含“非流形边”（Non-manifold Edge），如两个面共享一条边但法向相反 | 在导出前调用swModel.Extension.HealGeometry()修复几何；或用OpenCASCADE的ShapeFix_Shape进行拓扑净化 | ANSYS SpaceClaim的“诊断”功能 |
| NX提示：“Imported STEP has no valid solid bodies” | STEP文件中solid_model实体缺失，或manifold_solid_brep未正确关联shell_based_surface_model | 导出时确保IncludeConfigurationInformation = true，且模型必须是闭合实体（无开放面） | NX的“信息→部件→STEP”查看实体类型 |
| SolidWorks打开后显示“重建失败”，特征树灰色 | STEP中geometric_tolerance实体未绑定到具体面，或公差值单位错误（如mm写成inch） | 在语义解析阶段，强制将所有尺寸单位统一为mm，并在STEP导出前用swModel.Extension.GetToleranceValues()校验公差实体完整性 | SolidWorks的“评估→检查”工具 |
| Creo读取后尺寸缩放1000倍 | STEP文件使用si_unit但未声明length_unit = millimeter，Creo默认按meter解析 | 在STEP导出配置中，显式设置LengthUnit = "millimeter"（SolidWorks API需通过IStepExportData.LengthUnit属性） | 文本编辑器打开STEP文件，搜索SI_UNIT和LENGTH_UNIT |
最有效的验证方法，是建立一个“三软件交叉验证流水线”：
- 上游验证：用FreeCAD打开STEP，运行
Part → Check Geometry，确保“Non-manifold edges: 0”； - 中游验证：用SolidWorks打开，执行
评估 → 检查 → 所有检查项，重点关注“实体完整性”和“公差关联性”； - 下游验证：在ANSYS Workbench中导入，运行
Mesh → Generate Mesh，若能成功划分10万单元以上的高质量四面体网格，则证明STEP质量达标。
我们给某航天院做的项目，就因忽略NX验证，导致生成的卫星支架STEP在NX中无法布尔运算，返工两周。后来我们把这三步验证写成Python脚本，集成到生成流程末尾，任何一步失败自动邮件告警，彻底杜绝此类问题。
4. 行业应用全景：text-to-CAD正在重塑哪些真实工作流？
4.1 快速原型与概念验证：从“画三天草图”到“说三句话出模”
在消费电子行业，ID设计团队常面临一个悖论：市场部催着要“能拿去展会的手板”，结构工程师却还在为“这个弧面R角到底是3.2还是3.5”和ID反复扯皮。text-to-CAD在这里的价值，是把概念验证周期从“周级”压缩到“小时级”。以某TWS耳机充电仓为例：
- 传统流程：ID提供渲染图 → 结构工程师手动描图建模（2天）→ 内部评审发现R角太大影响开盖力 → 修改模型（半天）→ 重新渲染（1天）→ 最终确认（1天）→ 总耗时约5天；
- text-to-CAD流程：ID在会议中口述：“仓体长85mm、宽52mm、高30mm，顶面R3.2圆角，底部带防滑纹理，USB-C接口居中开孔，孔径8.5mm，四周倒角C0.3” → 系统32秒生成SolidWorks模型 → 工程师直接在此模型上做壁厚分析、跌落仿真 → 2小时内输出可行性报告。
关键突破在于：系统能理解“防滑纹理”不是指一个图案，而是调用SolidWorks的Texture特征，自动生成符合ISO 1302标准的Ra3.2粗糙度符号，并关联到对应面。我们实测发现，这种模式使概念验证阶段的模型迭代次数从平均7.3次降至1.8次，因为工程师不再纠结“怎么画”，而聚焦于“画得对不对”。
4.2 标准件库自动化：让“查手册、画图、存档”成为历史
制造业最大的隐形成本，是标准件建模。某工程机械厂每年需新建/更新约1200个螺栓、螺母、垫圈模型，占CAD工程师35%工时。text-to-CAD对此的解法，是构建一个“语义驱动的标准件库”（Semantic Standard Part Library）。其核心不是存储模型文件，而是存储参数化规则：
// 标准件规则库片段（JSON Schema） { "part_type": "hex_nut", "standard": "GB/T 6170-2015", "size_range": ["M3", "M4", "M5", "M6", "M8", "M10"], "parameter_rules": { "height": "0.8 * nominal_diameter", "across_flats": "1.7 * nominal_diameter", "thread_depth": "0.5 * nominal_diameter" }, "step_export": { "ap242_compliant": true, "include_gdt": ["position_tolerance", "surface_roughness"] } }当用户输入“GB/T 6170 M12六角螺母”，系统不查模型库，而是实时调用此规则，用nominal_diameter=12代入公式，生成完全符合国标的参数化模型。我们为该厂部署后，标准件建模时间从平均22分钟/个降至18秒/个，且所有模型自带GB/T 1182-2018公差标注，直接满足下游供应商图纸要求。> 实操心得：很多团队试图用text-to-CAD生成非标件，这是误区。它的最大价值在“标准化”而非“个性化”。把标准件、通用接口、典型结构（如法兰、支架、壳体）的生成自动化，释放工程师精力去攻克真正需要创造力的非标设计，这才是ROI最高的路径。
4.3 设计知识沉淀：把老师傅的“经验之谈”变成可执行的代码
在船舶制造领域，老师傅常说：“这个肋骨板，厚度不能小于16mm，否则焊接变形大；开孔位置离边缘至少50mm，不然应力集中。”这些经验散落在老师傅脑子里，新员工要学三年才能掌握。text-to-CAD提供了一种知识固化新范式：把经验转化为可执行的语义规则。例如，我们将某船厂总工的127条经验，编码为：
# 船体结构经验规则（Python伪代码） def validate_rib_plate(params): if params.material == "Q345B" and params.thickness < 16: return {"status": "warning", "message": "厚度<16mm，建议≥16mm以防焊接变形"} if params.hole_distance_to_edge < 50: return {"status": "error", "message": "开孔距边缘<50mm，应力集中风险高，强制修正为50mm"} # 自动修正 params.hole_distance_to_edge = max(params.hole_distance_to_edge, 50) return {"status": "success"} # 当用户输入“Q345B肋骨板，厚14mm，开孔距边45mm”，系统自动： # 1. 触发警告：厚度不足； # 2. 强制修正开孔位置为50mm； # 3. 在生成的STEP文件中，用GD&T标注`POSITION TOLERANCE`框注明修正依据。这套系统上线半年后，该船厂新员工设计返工率下降63%，因为所有“踩坑点”都在建模时被实时拦截并指导修正。text-to-CAD在这里的角色，已从“建模工具”升维为“设计教练”。
5. 常见问题与避坑指南：那些只有亲手摔过才懂的真相
5.1 “为什么我的text-to-CAD生成的模型，尺寸全是e+05这种科学计数法？”
这是CAD新手最常问的问题，根源在单位系统错位。当你在SolidWorks里看到“2.1616e+05”，实际是216160mm（即216米），但你以为是216mm。根本原因有两个：
- 输入文本单位缺失：用户说“外径42”，没写“42mm”，系统默认按SolidWorks模板单位（常为m）解析，42m=42000mm，显示为4.2e+04；
- STEP导出单位未锁定：即使建模时单位正确，导出STEP时若未显式设置
LengthUnit = "millimeter"，部分阅读器（如在线STEP查看器）会按默认meter解析。
终极解决方案：
- 在语义解析层，强制所有尺寸后缀校验。正则表达式必须匹配
(\d+\.?\d*)\s*(mm|cm|m|inch)，无后缀则抛异常并提示“请指定单位”； - 在STEP导出层，SolidWorks API中必须设置：
IStepExportData exportData = (IStepExportData)swApp.GetExportFileData((int)swExportDataFileType_e.swExportDataSTEP); exportData.LengthUnit = "millimeter"; // 关键！ - 在用户界面，用下拉菜单替代纯文本输入，选项为“42 mm”、“42 cm”、“42 inch”，从源头杜绝歧义。
我们曾帮一家医疗器械公司解决此问题，他们原流程是销售在CRM里填“外径42”，ERP自动同步到CAD系统，结果生成的手术器械手柄模型大了1000倍。加了单位校验后，错误率归零。
5.2 “生成的STEP文件，为什么在网页里打不开？”
“网页打开STEP文件”是热搜词，但背后是巨大的技术鸿沟。当前没有任何浏览器原生支持STEP解析，所谓“网页打开”，本质是：
- 方案A（推荐）：服务端用OpenCASCADE解析STEP，转为glTF/WebGL格式，前端Three.js渲染。优点：显示准确，支持测量；缺点：需服务器资源，大模型加载慢；
- 方案B（妥协）：用FreeCAD导出为OBJ/STL，前端用Potree或3Dmol.js渲染。优点：轻量；缺点：丢失B-Rep拓扑，无法测量，且STL面片过多时网页卡死。
避坑要点：
- 绝对不要用“在线STEP转换网站”，它们常把AP242降级为AP203，丢失公差和配置信息；
- 若必须网页预览，优先选择方案A，并在后端加缓存：同一STEP文件首次解析后，将glTF存入Redis，后续请求直接返回，响应时间从8秒降至200ms；
- 在用户提示语中明确告知：“网页预览为可视化参考，精确尺寸请用SolidWorks/NX等专业软件打开STEP原文件”。
5.3 “CAD复制草图到SW草绘中，为什么总是失败？”
这个热搜词暴露了一个深层认知偏差：text-to-CAD不是“复制粘贴”，而是“意图重建”。当用户想把AutoCAD的DWG草图导入SolidWorks，失败的根本原因是：DWG是矢量图形集合，没有“约束”概念；而SolidWorks草绘必须有“水平”、“垂直”、“相切”等约束才能驱动。text-to-CAD的正确做法，是抛弃DWG，直接用自然语言描述草图意图。例如：
- ❌ 错误输入：“把这张DWG里的六边形复制过来”；
- ✅ 正确输入：“绘制一个正六边形，中心在原点，外接圆直径50mm，所有边等长，相邻边夹角120°”。
系统会调用sketch.CreatePolygon并自动添加Equal、Angle约束，生成的草图完全参数化。我们测试过，对同一六边形，用DWG导入平均需手动添加11个约束才能驱动，而text-to-CAD一次生成即具备全部约束。
5.4 “为什么生成的模型，导入SolidWorks后特征树是空的？”
这是Sketch-Driven方案最常见的“幻觉”问题。表面看模型完美，但双击任何特征都提示“特征已完全定义”，无法编辑。根源在于：生成时未启用“特征记录”（Feature Recording）。在SolidWorks API中，必须在创建草图前调用：
swModel.Extension.SetUserPreferenceToggle((int)swUserPreferenceToggle_e.swUseFeatureManager, true); swModel.Extension.SetUserPreferenceIntegerValue((int)swUserPreferenceIntegerValue_e.swSketchOnFeatureCreation, (int)swSketchOnFeatureCreation_e.swSketchOnFeatureCreation_AllFeatures);否则，所有操作被视为“直接建模”，不生成特征树。我们曾为某汽车厂做POC，因漏掉此设置，客户当场质疑“这算什么参数化”，紧急补丁后才挽回信任。> 重要提醒：在SolidWorks中，一个模型是否“真参数化”，唯一判断标准是——能否在特征树中双击任意尺寸，弹出修改对话框。如果不能，说明生成流程有致命缺陷，必须回溯检查API调用顺序。
6. 未来演进与个人实践体会：text-to-CAD的终点不是替代，而是赋能
text-to-CAD不会取代CAD工程师，就像ATM机没有取代银行柜员。它的终点，是把工程师从“翻译官”（把脑中想法翻译成软件指令）解放为“指挥官”（定义目标、设定约束、评判结果）。我过去十年最深刻的体会是：所有成功的text-to-CAD落地项目，都有一个共同点——它们不追求“100%全自动”，而是聚焦“关键路径提效”。比如在某核电设备厂，我们只自动化了“压力容器筒体”的建模（占设计工时40%），而封头、接管等复杂曲面仍由工程师手动精修。结果是整体设计周期缩短31%，且因筒体模型100%标准化，后续应力分析报告一次通过率从68%升至94%。
未来三年，text-to-CAD会向三个方向深化：
第一，与PLM深度耦合。当你说“生成新版法兰盘”，系统不仅建模，还自动在Teamcenter中创建物料号、关联BOM、触发变更审批流；
第二，制造工艺前置嵌入。输入“这个支架用6061-T6铝，CNC加工”，系统自动生成刀具路径建议、夹具定位点、甚至模拟加工变形量；
第三，多模态意图理解。不只是听文字，还能看草图照片（手机拍张手绘稿）、读Excel表格（BOM清单）、甚至分析仿真报告（“此处应力超限，请优化壁厚”
