戰(zhàn)：從自然語(yǔ)言到STEP/URDF/G-code的分層轉(zhuǎn)換與避坑指南)
1. 從一句話(huà)到三維模型text-to-cad 到底在解決什么問(wèn)題第一次聽(tīng)到 text-to-cad 這個(gè)詞我腦子里蹦出來(lái)的畫(huà)面是對(duì)著電腦敲一行字比如“一個(gè) 80x40x20 的鋁合金外殼四角帶 M4 沉頭孔壁厚 3 毫米”然后軟件啪一下把 STEP 文件吐出來(lái)。這個(gè)畫(huà)面在幾年前還屬于科幻范疇但現(xiàn)在已經(jīng)有一批工具和方案在往這個(gè)方向靠了。text-to-cad 本質(zhì)上是一類(lèi)把自然語(yǔ)言描述轉(zhuǎn)換成 CAD 可識(shí)別幾何模型的技術(shù)路線(xiàn)它的輸出通常不是某個(gè)私有格式而是 STEP、URDF、G-code 這類(lèi)通用性強(qiáng)的中間格式。為什么是這幾個(gè)格式因?yàn)?STEP 是工業(yè)界公認(rèn)的實(shí)體模型交換標(biāo)準(zhǔn)URDF 是機(jī)器人領(lǐng)域描述連桿和關(guān)節(jié)的通用語(yǔ)言G-code 則是從模型走向加工的最后一步。換句話(huà)說(shuō)text-to-cad 想打通的是“語(yǔ)言描述 → 幾何定義 → 可制造/可仿真文件”這條鏈路。這件事的價(jià)值在哪兒我舉個(gè)自己踩過(guò)的場(chǎng)景。做非標(biāo)設(shè)備的時(shí)候經(jīng)常需要根據(jù)客戶(hù)口頭描述快速出一個(gè)初步模型去對(duì)尺寸。傳統(tǒng)流程是聽(tīng)懂需求 → 打開(kāi) CAD 軟件 → 草圖 → 拉伸 → 打孔 → 導(dǎo)出。一套下來(lái)熟練工也得十幾分鐘而且中間任何一處尺寸理解錯(cuò)了返工成本很高。text-to-cad 的思路是把“草圖→拉伸→打孔”這些重復(fù)性勞動(dòng)交給程序人只負(fù)責(zé)用語(yǔ)言把關(guān)鍵約束說(shuō)清楚。它解決的不是“替代設(shè)計(jì)師”而是“把設(shè)計(jì)師從重復(fù)建模里撈出來(lái)”。適合關(guān)注這個(gè)方向的人其實(shí)挺雜的做機(jī)械設(shè)計(jì)的想提效做機(jī)器人仿真的想快速生成 URDF做 3D 打印的想從文字直接出 G-code甚至做教育的想讓學(xué)生用自然語(yǔ)言理解幾何約束。不同背景的人關(guān)注點(diǎn)不一樣但核心訴求是一致的——降低從想法到模型的門(mén)檻。我在這篇文章里會(huì)把這套東西拆開(kāi)講整體設(shè)計(jì)思路怎么定、核心格式之間怎么轉(zhuǎn)換、實(shí)操環(huán)節(jié)怎么落地、以及我實(shí)際折騰過(guò)程中遇到的一堆坑。內(nèi)容會(huì)涉及 STEP、URDF、G-code 的具體處理方式也會(huì)給一些可以直接抄的參數(shù)和代碼片段。不管你是剛接觸 CAD 二次開(kāi)發(fā)還是已經(jīng)在做參數(shù)化建模想往智能化靠應(yīng)該都能找到能用的東西。2. 整體設(shè)計(jì)思路為什么不是“直接生成”而是“分層轉(zhuǎn)換”2.1 核心架構(gòu)的選型邏輯很多人一開(kāi)始會(huì)想能不能訓(xùn)練一個(gè)模型輸入文字直接輸出 STEP 文件我試過(guò)類(lèi)似思路結(jié)論是現(xiàn)階段不現(xiàn)實(shí)。原因在于 STEP 文件本質(zhì)上是一堆 NURBS 曲面和拓?fù)潢P(guān)系的集合它的數(shù)據(jù)結(jié)構(gòu)極其嚴(yán)謹(jǐn)一個(gè)實(shí)體的邊界表示BRep要求面、邊、點(diǎn)之間的連接關(guān)系完全自洽。讓語(yǔ)言模型直接生成這種結(jié)構(gòu)化數(shù)據(jù)相當(dāng)于讓它逐字節(jié)寫(xiě)一個(gè)二進(jìn)制文件錯(cuò)誤率會(huì)高到?jīng)]法用。所以目前靠譜的方案都是分層的自然語(yǔ)言 → 中間參數(shù)化表示 → 幾何內(nèi)核操作 → 目標(biāo)格式導(dǎo)出。這個(gè)中間層可以是 JSON 描述的參數(shù)表也可以是 Python 腳本還可以是 OpenSCAD 那種聲明式代碼。我自己的方案選的是“自然語(yǔ)言 → 結(jié)構(gòu)化參數(shù) JSON → CadQuery/OpenCASCADE 內(nèi)核 → STEP/STL → 后處理”。為什么選 CadQuery因?yàn)樗?OpenCASCADE而 OpenCASCADE 是工業(yè)級(jí)幾何內(nèi)核對(duì) STEP 的支持非常成熟。另一個(gè)原因是 CadQuery 的 API 是鏈?zhǔn)降膶?xiě)起來(lái)接近自然語(yǔ)言的邏輯順序比如Workplane().box(80,40,20).faces(Z).workplane().hole(4)這種表達(dá)很容易和語(yǔ)言模型輸出的結(jié)構(gòu)對(duì)應(yīng)上。相比之下直接調(diào) OpenCASCADE 的 C 接口學(xué)習(xí)曲線(xiàn)太陡用 FreeCAD 的腳本又受限于它的對(duì)象模型。CadQuery 在靈活性和穩(wěn)定性之間取了一個(gè)不錯(cuò)的平衡點(diǎn)。這里有個(gè)關(guān)鍵決策點(diǎn)中間表示到底用“參數(shù)表”還是“代碼”。參數(shù)表的好處是安全模型只能從預(yù)定義的模板里選參數(shù)不會(huì)生成亂七八糟的幾何壞處是靈活性差遇到模板沒(méi)覆蓋的形狀就抓瞎。代碼的好處是靈活理論上能表達(dá)任意幾何壞處是語(yǔ)言模型生成的代碼可能跑不通甚至可能寫(xiě)出危險(xiǎn)操作。我的做法是混合常見(jiàn)形狀走參數(shù)表模板復(fù)雜形狀走代碼生成但代碼在執(zhí)行前會(huì)經(jīng)過(guò)一層 AST 靜態(tài)檢查禁止文件讀寫(xiě)和網(wǎng)絡(luò)調(diào)用。這個(gè)檢查步驟很關(guān)鍵我后面在避坑部分會(huì)詳細(xì)說(shuō)。2.2 格式轉(zhuǎn)換鏈的設(shè)計(jì)與取舍從幾何內(nèi)核出來(lái)之后往哪個(gè)格式走取決于下游用途。STEP 適合做精確的實(shí)體交換它的優(yōu)勢(shì)是保留了完整的 BRep 信息任何主流 CAD 軟件都能讀而且精度無(wú)損。但 STEP 有個(gè)問(wèn)題它不包含裝配約束和運(yùn)動(dòng)學(xué)信息你拿到的是一個(gè)靜態(tài)的幾何體。如果下游是機(jī)器人仿真就需要 URDF。URDF 描述的是連桿link和關(guān)節(jié)joint的樹(shù)狀結(jié)構(gòu)每個(gè) link 有自己的幾何形狀和慣性參數(shù)每個(gè) joint 有類(lèi)型旋轉(zhuǎn)、平移、固定和軸向。從 STEP 到 URDF 不是簡(jiǎn)單的格式轉(zhuǎn)換而是要把一個(gè)整體幾何拆成多個(gè) link再定義它們之間的關(guān)節(jié)關(guān)系。這一步目前沒(méi)有全自動(dòng)的可靠方案我的做法是在參數(shù) JSON 里就顯式定義好 link 和 joint 的結(jié)構(gòu)生成 STEP 的同時(shí)也生成 URDF兩者共享同一套尺寸參數(shù)。G-code 則是另一條路。它不關(guān)心幾何的精確表示只關(guān)心刀具軌跡。從模型到 G-code 通常要經(jīng)過(guò)切片3D 打印或 CAM 刀路規(guī)劃減材加工。text-to-cad 在這個(gè)環(huán)節(jié)的價(jià)值是語(yǔ)言描述里可以直接包含加工參數(shù)比如“層高 0.2填充 20%PLA 材料”這些參數(shù)和幾何參數(shù)一起進(jìn)入 JSON最后喂給切片引擎。我實(shí)測(cè)下來(lái)用 CadQuery 生成 STL再用 CuraEngine 的命令行模式切片整條鏈路可以完全腳本化。但要注意G-code 和 STEP 的精度要求完全不同STL 的網(wǎng)格精度如果設(shè)得太低薄壁特征會(huì)丟失打出來(lái)就是殘次品。目標(biāo)格式核心用途關(guān)鍵優(yōu)勢(shì)主要限制STEP精確實(shí)體交換無(wú)損 BRep通用性強(qiáng)無(wú)裝配運(yùn)動(dòng)信息URDF機(jī)器人仿真含關(guān)節(jié)與慣性需手動(dòng)拆分 linkG-code加工制造直接驅(qū)動(dòng)機(jī)床依賴(lài)切片/CAM 參數(shù)STL3D 打印/可視化簡(jiǎn)單通用網(wǎng)格精度有損2.3 語(yǔ)言理解層的設(shè)計(jì)邊界語(yǔ)言理解這塊我的建議是不要追求“大而全”。很多人一上來(lái)就想讓系統(tǒng)理解“一個(gè)復(fù)雜的機(jī)械臂”結(jié)果發(fā)現(xiàn)模型根本不知道從哪兒下手。正確的做法是限定領(lǐng)域詞匯表。比如你做的是板金件那就把“折彎”“沖孔”“沉頭”“翻邊”這些詞定義清楚每個(gè)詞對(duì)應(yīng)一組幾何操作和默認(rèn)參數(shù)。語(yǔ)言模型的任務(wù)只是把用戶(hù)的話(huà)映射到這些預(yù)定義操作上而不是自由發(fā)揮。我試過(guò)用純 prompt 讓模型輸出 CadQuery 代碼結(jié)果它經(jīng)常發(fā)明一些不存在的 API或者把hole和cboreHole搞混。后來(lái)改成“先分類(lèi)到操作模板再填參數(shù)”穩(wěn)定性大幅提升。另一個(gè)邊界是尺寸推理。用戶(hù)說(shuō)“一個(gè)差不多手掌大的盒子”這個(gè)“手掌大”到底是多大我的處理方式是維護(hù)一個(gè)常用尺寸映射表比如“手掌大”映射到 100mm 左右“拇指粗”映射到 20mm同時(shí)在輸出里明確標(biāo)注“按 100mm 估算如需精確請(qǐng)指定數(shù)值”。這樣既給了結(jié)果又留了修正余地。千萬(wàn)不要讓模型自己瞎猜一個(gè)精確到小數(shù)點(diǎn)后三位的數(shù)字那是在制造虛假精度。3. 核心細(xì)節(jié)解析STEP、URDF、G-code 的處理要點(diǎn)3.1 STEP 文件的生成與校驗(yàn)用 CadQuery 導(dǎo)出 STEP 就一行代碼cq.exporters.export(result, output.step)。但這一行背后有幾個(gè)坑。第一個(gè)坑是單位。CadQuery 默認(rèn)單位是毫米但 STEP 文件本身不強(qiáng)制單位有些軟件讀的時(shí)候會(huì)按英寸解釋。我遇到過(guò)導(dǎo)出的模型在另一個(gè)軟件里大了 25.4 倍就是因?yàn)閱挝粵](méi)對(duì)齊。解決辦法是在導(dǎo)出前顯式設(shè)置cq.Unit或者在文件頭里寫(xiě)入單位聲明。第二個(gè)坑是實(shí)體有效性。如果幾何操作產(chǎn)生了自相交或零厚度面STEP 文件可能能寫(xiě)出來(lái)但讀的時(shí)候會(huì)報(bào)錯(cuò)。我的習(xí)慣是在導(dǎo)出前跑一遍result.val().isValid()不通過(guò)就回退到上一個(gè)有效狀態(tài)。還有一個(gè)實(shí)際問(wèn)題是文件大小。一個(gè)帶很多小孔和圓角的零件STEP 文件可能幾十兆。如果只是做可視化沒(méi)必要用 STEP轉(zhuǎn)成 STL 或 glTF 更合適。我一般會(huì)在 JSON 里加一個(gè)output_format字段根據(jù)用途自動(dòng)選格式。如果是給下游 CAD 做進(jìn)一步編輯必須 STEP如果是給網(wǎng)頁(yè)預(yù)覽glTF 足夠如果是 3D 打印STL 加 G-code。import cadquery as cq # 從參數(shù)構(gòu)建模型 length, width, height 80.0, 40.0, 20.0 hole_dia 4.0 result ( cq.Workplane(XY) .box(length, width, height) .faces(Z) .workplane() .rect(length - 10, width - 10, forConstructionTrue) .vertices() .hole(hole_dia) ) # 校驗(yàn)實(shí)體有效性 if not result.val().isValid(): raise ValueError(生成的實(shí)體無(wú)效請(qǐng)檢查參數(shù)) # 導(dǎo)出 STEP cq.exporters.export(result, bracket.step)這段代碼里forConstructionTrue是個(gè)容易忽略的點(diǎn)。它表示這個(gè)矩形只用來(lái)定位頂點(diǎn)不參與實(shí)際幾何。如果不加這個(gè)參數(shù)矩形會(huì)被當(dāng)成實(shí)體的一部分切出來(lái)結(jié)果就完全不對(duì)了。這種細(xì)節(jié)在文檔里往往一筆帶過(guò)但實(shí)際用的時(shí)候不知道就會(huì)卡很久。3.2 URDF 的關(guān)節(jié)定義與慣性參數(shù)URDF 的難點(diǎn)不在幾何而在關(guān)節(jié)和慣性。幾何部分可以直接從 STEP 或 STL 引用 mesh 文件但關(guān)節(jié)類(lèi)型、軸向、限位這些必須顯式定義。我見(jiàn)過(guò)很多人把 URDF 寫(xiě)成了一堆固定關(guān)節(jié)的集合結(jié)果導(dǎo)入仿真環(huán)境后機(jī)器人根本動(dòng)不了。正確的做法是先想清楚運(yùn)動(dòng)鏈哪個(gè) link 是父、哪個(gè)是子、關(guān)節(jié)繞哪個(gè)軸轉(zhuǎn)、轉(zhuǎn)多少度。這些信息在 text-to-cad 的 JSON 里就應(yīng)該定義好而不是等到生成 URDF 時(shí)再補(bǔ)。慣性參數(shù)是另一個(gè)大坑。URDF 要求每個(gè) link 有質(zhì)量和慣性矩陣。如果隨便填一個(gè)值仿真時(shí)會(huì)出現(xiàn)奇怪的抖動(dòng)或者直接飛出去。我的做法是用幾何體積乘以材料密度估算質(zhì)量慣性矩陣用近似公式算。比如一個(gè)長(zhǎng)方體繞中心軸的慣性矩是m*(w^2h^2)/12。雖然不精確但比瞎填強(qiáng)得多。如果對(duì)精度要求高可以用 FreeCAD 或 Blender 算完再填進(jìn)去。link namebase_link visual geometry mesh filenamebase.stl scale0.001 0.001 0.001/ /geometry /visual collision geometry mesh filenamebase.stl scale0.001 0.001 0.001/ /geometry /collision inertial mass value0.5/ inertia ixx0.001 ixy0 ixz0 iyy0.001 iyz0 izz0.001/ /inertial /link注意scale那個(gè) 0.001。STL 通常以毫米為單位導(dǎo)出但 URDF 的標(biāo)準(zhǔn)單位是米所以必須縮放。這個(gè)坑我踩過(guò)不止一次導(dǎo)入后模型大得像個(gè)房子排查半天才發(fā)現(xiàn)是單位問(wèn)題。3.3 G-code 的切片參數(shù)與路徑規(guī)劃從模型到 G-code核心是切片參數(shù)。層高、壁厚、填充密度、打印速度、溫度這些參數(shù)直接決定成品質(zhì)量。text-to-cad 在這個(gè)環(huán)節(jié)的價(jià)值是把語(yǔ)言描述里的加工意圖翻譯成切片參數(shù)。比如用戶(hù)說(shuō)“要結(jié)實(shí)一點(diǎn)”那就把填充密度從 20% 提到 40%壁厚從 2 層加到 3 層。說(shuō)“表面要光滑”那就把層高降到 0.1mm。這些映射關(guān)系需要事先定義好不能指望切片軟件自己理解。我用的是 CuraEngine 的命令行模式因?yàn)樗梢酝耆_本化不需要打開(kāi)圖形界面。調(diào)用方式大概是CuraEngine slice -j fdmprinter.def.json -l model.stl -o output.gcode -s layer_height0.2 -s infill_sparse_density20 -s wall_line_count3這里-j指定打印機(jī)定義文件-l指定輸入模型-s覆蓋具體參數(shù)。實(shí)測(cè)下來(lái)這套流程跑通之后從文字到 G-code 可以做到全自動(dòng)。但有個(gè)前提模型必須是流形manifold的也就是沒(méi)有破面、沒(méi)有自相交。STL 如果是從有問(wèn)題的 STEP 轉(zhuǎn)過(guò)來(lái)的切片時(shí)會(huì)出現(xiàn)空洞或者錯(cuò)層。所以我在導(dǎo)出 STL 之前一定會(huì)做一次網(wǎng)格修復(fù)用trimesh或者admesh都行。4. 實(shí)操過(guò)程從一句話(huà)到可加工文件的完整鏈路4.1 環(huán)境搭建與依賴(lài)安裝先把環(huán)境說(shuō)清楚。我用的主力是 Python 3.10CadQuery 2.4CuraEngine 5.xtrimesh 3.x。CadQuery 的安裝推薦用 conda因?yàn)樗囊蕾?lài)?yán)镉?OpenCASCADE 的二進(jìn)制包pip 裝有時(shí)候會(huì)缺庫(kù)。conda create -n text2cad python3.10 conda activate text2cad conda install -c conda-forge cadquery pip install trimesh urdfpyCuraEngine 需要單獨(dú)下載編譯好的二進(jìn)制放到 PATH 里就行。如果你用的是 Windows注意把它的路徑加到系統(tǒng)環(huán)境變量不然命令行調(diào)用會(huì)找不到。我一開(kāi)始在 Windows 上折騰了半天后來(lái)發(fā)現(xiàn)是路徑里有空格導(dǎo)致解析出錯(cuò)換到?jīng)]有空格的目錄就好了。語(yǔ)言理解層我用的是本地部署的小模型加規(guī)則引擎不依賴(lài)外部接口。這樣做的好處是響應(yīng)快、數(shù)據(jù)不出本地壞處是理解能力有限。如果你的場(chǎng)景詞匯比較固定規(guī)則引擎加小模型完全夠用。如果場(chǎng)景很開(kāi)放那可能需要更大的模型但那就涉及到算力和部署成本的問(wèn)題了得自己權(quán)衡。4.2 參數(shù) JSON 的結(jié)構(gòu)設(shè)計(jì)整個(gè)鏈路的核心是那個(gè)參數(shù) JSON。它既是語(yǔ)言理解的輸出也是幾何生成的輸入。我的結(jié)構(gòu)大概長(zhǎng)這樣{ part_name: mounting_bracket, units: mm, geometry: { type: box_with_holes, length: 80, width: 40, height: 20, holes: [ {position: corners, diameter: 4, depth: through} ] }, material: aluminum_6061, output: [step, stl], manufacturing: { process: cnc, tolerance: 0.1 } }這個(gè)結(jié)構(gòu)的好處是清晰、可校驗(yàn)。geometry.type決定了用哪個(gè)模板holes數(shù)組描述了孔的位置和尺寸output決定導(dǎo)出哪些格式。語(yǔ)言理解層的任務(wù)就是把“一個(gè) 80 乘 40 乘 20 的鋁板四角打 4 毫米通孔”映射成這個(gè) JSON。映射規(guī)則可以寫(xiě)得很細(xì)比如“通孔”對(duì)應(yīng)depth: through“沉頭”對(duì)應(yīng)type: counterbore并附帶沉頭直徑和深度。我建議在 JSON 里加一個(gè)confidence字段記錄每個(gè)參數(shù)的可信度。如果某個(gè)尺寸是從模糊描述里猜的就標(biāo)低一點(diǎn)生成后在界面上高亮提示用戶(hù)確認(rèn)。這個(gè)做法在實(shí)際使用中能減少很多“我以為你懂我意思”的扯皮。4.3 幾何生成與格式導(dǎo)出的完整腳本把上面的東西串起來(lái)主流程大概是這樣import json import cadquery as cq from cadquery import exporters def build_from_json(params): geo params[geometry] if geo[type] box_with_holes: result cq.Workplane(XY).box(geo[length], geo[width], geo[height]) if geo.get(holes): result ( result.faces(Z).workplane() .rect(geo[length] - 10, geo[width] - 10, forConstructionTrue) .vertices() .hole(geo[holes][0][diameter]) ) else: raise ValueError(f不支持的幾何類(lèi)型: {geo[type]}) if not result.val().isValid(): raise ValueError(幾何無(wú)效) return result def export_all(model, params, basename): outputs params.get(output, [step]) if step in outputs: exporters.export(model, f{basename}.step) if stl in outputs: exporters.export(model, f{basename}.stl, tolerance0.01) if urdf in outputs: generate_urdf(model, params, f{basename}.urdf) if gcode in outputs: slice_to_gcode(f{basename}.stl, params, f{basename}.gcode)這里tolerance0.01是 STL 的網(wǎng)格精度單位是毫米。這個(gè)值越小網(wǎng)格越細(xì)文件越大。對(duì)于大多數(shù) 3D 打印件0.01 到 0.05 之間夠用了。如果零件有很小的特征比如 0.5mm 的細(xì)縫那得設(shè)到 0.005 以下不然縫就糊住了。4.4 從 STL 到 G-code 的切片實(shí)操切片這一步我單獨(dú)拎出來(lái)說(shuō)因?yàn)樗婕暗膮?shù)最多也最容易出問(wèn)題。以 CuraEngine 為例一個(gè)典型的調(diào)用需要指定打印機(jī)定義、材料定義和一堆覆蓋參數(shù)。我一般會(huì)把常用配置寫(xiě)成 JSON 文件調(diào)用時(shí)直接引用。CuraEngine slice \ -j fdmprinter.def.json \ -l bracket.stl \ -o bracket.gcode \ -s layer_height0.2 \ -s wall_line_count3 \ -s infill_sparse_density20 \ -s material_print_temperature210 \ -s material_bed_temperature60 \ -s speed_print50跑完之后一定要檢查 G-code 的開(kāi)頭和結(jié)尾。開(kāi)頭應(yīng)該有歸零和預(yù)熱指令結(jié)尾應(yīng)該有回抽和關(guān)機(jī)指令。如果這些不對(duì)打印機(jī)可能直接撞頭或者堵嘴。我習(xí)慣用gcode-parser之類(lèi)的工具快速掃一遍確認(rèn)沒(méi)有異常指令。還有一個(gè)實(shí)際經(jīng)驗(yàn)不同品牌的打印機(jī)對(duì) G-code 的方言支持不一樣。比如有的機(jī)器用M104設(shè)溫度有的用M109并等待。如果你的 G-code 是給特定機(jī)器用的最好在切片配置里選對(duì)機(jī)型或者手動(dòng)改一下起始和結(jié)束代碼。這個(gè)沒(méi)有通用解只能針對(duì)具體設(shè)備調(diào)。5. 常見(jiàn)問(wèn)題與排查技巧實(shí)錄5.1 幾何生成階段的典型報(bào)錯(cuò)問(wèn)題一實(shí)體無(wú)效isValid 返回 False。最常見(jiàn)的原因是布爾運(yùn)算產(chǎn)生了零厚度面或者自相交。比如在一個(gè)面上打孔孔的位置正好在邊緣上切出來(lái)的面就退化了。解決辦法是調(diào)整孔的位置留出至少一個(gè)壁厚的余量。如果必須貼邊那就把孔改成缺口用切除而不是打孔。問(wèn)題二圓角失敗。對(duì)一條邊做圓角如果相鄰面的夾角太小或者邊長(zhǎng)不夠圓角會(huì)失敗。CadQuery 的fillet會(huì)直接拋異常。我的做法是先用edges()選中要倒角的邊檢查它的長(zhǎng)度是否大于圓角半徑的兩倍不滿(mǎn)足就跳過(guò)或者減小半徑。問(wèn)題三導(dǎo)出 STEP 后文件打不開(kāi)。十有八九是單位或者編碼問(wèn)題。先確認(rèn)導(dǎo)出時(shí)單位設(shè)置正確再檢查文件路徑里有沒(méi)有中文或特殊字符。有些老版本的 CAD 軟件對(duì) UTF-8 路徑支持不好換成純英文路徑就能解決。5.2 URDF 導(dǎo)入仿真環(huán)境的常見(jiàn)坑URDF 導(dǎo)入 CoppeliaSim 或者 Gazebo 時(shí)最常見(jiàn)的問(wèn)題是 mesh 路徑不對(duì)。URDF 里的filename可以是相對(duì)路徑也可以是絕對(duì)路徑但不同仿真器對(duì)相對(duì)路徑的解析基準(zhǔn)不一樣。CoppeliaSim 通常相對(duì)于 URDF 文件所在目錄Gazebo 則相對(duì)于某個(gè)模型包路徑。我的做法是統(tǒng)一用package://前綴然后在仿真環(huán)境里配置好包路徑映射。如果嫌麻煩直接用絕對(duì)路徑也行但換機(jī)器就得改。另一個(gè)坑是關(guān)節(jié)軸向。URDF 里關(guān)節(jié)的axis是相對(duì)于 joint 坐標(biāo)系的不是相對(duì)于世界坐標(biāo)系。如果你定義了一個(gè)繞 Z 軸旋轉(zhuǎn)的關(guān)節(jié)但 joint 坐標(biāo)系本身被旋轉(zhuǎn)過(guò)那實(shí)際轉(zhuǎn)軸就不是世界 Z 軸了。這個(gè)在簡(jiǎn)單模型里不容易發(fā)現(xiàn)一旦模型復(fù)雜起來(lái)運(yùn)動(dòng)就會(huì)變得很奇怪。排查方法是把 URDF 導(dǎo)入后手動(dòng)拖一下關(guān)節(jié)看運(yùn)動(dòng)方向是否符合預(yù)期。5.3 G-code 打印失敗的排查清單現(xiàn)象可能原因排查方法第一層不粘平臺(tái)溫度低/調(diào)平不準(zhǔn)提高 bed 溫度重新調(diào)平中途斷層耗材卡住/溫度波動(dòng)檢查送絲機(jī)構(gòu)穩(wěn)定熱端溫度尺寸偏大材料收縮/步進(jìn)校準(zhǔn)校準(zhǔn) E 步調(diào)整收縮補(bǔ)償表面粗糙層高太大/速度太快降低層高和打印速度孔洞堵死填充重疊/網(wǎng)格問(wèn)題檢查 STL 流形性調(diào)整填充重疊率這張表是我自己打印失敗多次之后總結(jié)的基本上覆蓋了八成以上的常見(jiàn)問(wèn)題。其中“孔洞堵死”這個(gè)特別隱蔽因?yàn)槟Ｐ涂雌饋?lái)沒(méi)問(wèn)題切片預(yù)覽也正常但打出來(lái)孔就是實(shí)的。后來(lái)發(fā)現(xiàn)是 STL 網(wǎng)格在孔的位置有微小破面切片引擎把孔當(dāng)成了實(shí)體。用trimesh的repair功能修一下就好了。5.4 語(yǔ)言理解層的避坑心得語(yǔ)言理解這塊最大的坑是“過(guò)度自信”。模型對(duì)模糊描述會(huì)給出一個(gè)看起來(lái)很確定的答案但實(shí)際上它是在猜。比如“打幾個(gè)孔”它可能默認(rèn)打四個(gè)但用戶(hù)心里想的是六個(gè)。我的做法是在輸出 JSON 里加一個(gè)assumptions數(shù)組把所有猜測(cè)都列出來(lái)生成后顯示給用戶(hù)確認(rèn)。這個(gè)做法看起來(lái)麻煩但比事后返工強(qiáng)得多。另一個(gè)坑是單位混用。用戶(hù)可能說(shuō)“長(zhǎng) 8 厘米”也可能說(shuō)“長(zhǎng) 80 毫米”還可能說(shuō)“長(zhǎng) 8 公分”。這些都得映射到統(tǒng)一的毫米單位。我維護(hù)了一個(gè)單位映射表覆蓋厘米、毫米、米、英寸、公分這些常見(jiàn)說(shuō)法。英寸轉(zhuǎn)毫米是 25.4這個(gè)系數(shù)一定要記準(zhǔn)不然差之毫厘謬以千里。6. 工具選型與擴(kuò)展思路6.1 幾何內(nèi)核的對(duì)比與選擇OpenCASCADE 是功能最全的但學(xué)習(xí)曲線(xiàn)陡。CadQuery 封裝了它用起來(lái)舒服很多。FreeCAD 的 Part 模塊也是基于 OpenCASCADE但它的腳本接口更偏向于操作文檔對(duì)象不如 CadQuery 直接。如果你要做的是建筑或土木方向的模型那可能更適合用 Blender 的腳本或者 IfcOpenShell。選哪個(gè)內(nèi)核取決于你的幾何復(fù)雜度和團(tuán)隊(duì)的技術(shù)棧。我的建議是機(jī)械零件用 CadQuery建筑用 IfcOpenShell可視化用 trimesh 或 Blender。6.2 從 text-to-cad 到 text-to-cam 的延伸text-to-cad 的下一步自然是 text-to-cam。既然語(yǔ)言能描述幾何那也能描述加工策略。比如“先粗銑再精銑粗銑留 0.5 余量精銑轉(zhuǎn)速 8000”這些完全可以結(jié)構(gòu)化后喂給 CAM 引擎。FreeCAD 的 Path 工作臺(tái)支持腳本化生成刀路理論上可以和 text-to-cad 的 JSON 對(duì)接。我試過(guò)一個(gè)簡(jiǎn)單的例子從 JSON 讀取零件尺寸和加工參數(shù)自動(dòng)生成一個(gè)平面銑削的 G-code。雖然離實(shí)用還有距離但方向是通的。6.3 批量處理與自動(dòng)化集成如果你有一堆相似的零件要處理text-to-cad 的批量能力就體現(xiàn)出來(lái)了。把每個(gè)零件的描述寫(xiě)成一行文字批量轉(zhuǎn)成 JSON再批量生成模型和 G-code。我用這個(gè)方式處理過(guò)一批支架類(lèi)零件二十多個(gè)變體從描述到 G-code 全部自動(dòng)完成只花了不到十分鐘。如果手動(dòng)建模一個(gè)下午都搞不定。批量處理的關(guān)鍵是模板要足夠通用參數(shù)要足夠靈活。如果每個(gè)零件都要改代碼那就失去自動(dòng)化的意義了。7. 我個(gè)人在實(shí)際操作中的幾點(diǎn)體會(huì)這套東西我斷斷續(xù)續(xù)折騰了大半年最大的體會(huì)是不要追求一步到位。一開(kāi)始我想做一個(gè)“萬(wàn)能”的 text-to-cad 系統(tǒng)什么都能生成結(jié)果什么都做不好。后來(lái)把范圍縮到“板類(lèi)零件帶孔”反而穩(wěn)定了。先在一個(gè)窄領(lǐng)域里做到能用再慢慢擴(kuò)展比一開(kāi)始就鋪大攤子靠譜得多。第二個(gè)體會(huì)是校驗(yàn)比生成更重要。生成一個(gè)模型不難難的是保證它是對(duì)的。我現(xiàn)在花在校驗(yàn)上的時(shí)間比生成還多實(shí)體有效性檢查、尺寸范圍檢查、單位一致性檢查、網(wǎng)格流形性檢查。這些檢查看起來(lái)繁瑣但能擋住絕大多數(shù)低級(jí)錯(cuò)誤。沒(méi)有校驗(yàn)的自動(dòng)化就是在批量制造垃圾。第三個(gè)體會(huì)是保留人工干預(yù)的入口。全自動(dòng)聽(tīng)起來(lái)很酷但實(shí)際用的時(shí)候用戶(hù)總會(huì)有一些系統(tǒng)理解不了的需求。這時(shí)候如果能方便地手動(dòng)改參數(shù)、改代碼體驗(yàn)會(huì)好很多。我的做法是生成的 JSON 和 Python 腳本都保留下來(lái)用戶(hù)可以直接編輯后重新生成。這樣系統(tǒng)是“輔助”而不是“替代”接受度會(huì)高很多。最后分享一個(gè)小技巧如果你也在做類(lèi)似的東西建議把每次生成的輸入描述、中間 JSON、輸出文件和校驗(yàn)結(jié)果都存下來(lái)。攢夠幾百條之后你會(huì)發(fā)現(xiàn)哪些描述容易理解錯(cuò)、哪些參數(shù)經(jīng)常需要調(diào)整。這些數(shù)據(jù)是優(yōu)化系統(tǒng)的金礦比拍腦袋想規(guī)則有用得多。我現(xiàn)在就有一個(gè)這樣的日志庫(kù)每次遇到新的描述方式就加一條慢慢地把覆蓋率提上去了。 text-to-cad實(shí)戰(zhàn)：從自然語(yǔ)言到STEP/URDF/G-code的分層轉(zhuǎn)換與避坑指南
1. 從一句話(huà)到三維模型text-to-cad 到底在解決什么問(wèn)題第一次聽(tīng)到 text-to-cad 這個(gè)詞我腦子里蹦出來(lái)的畫(huà)面是對(duì)著電腦敲一行字比如“一個(gè) 80x40x20 的鋁合金外殼四角帶 M4 沉頭孔壁厚 3 毫米”然后軟件啪一下把 STEP 文件吐出來(lái)。這個(gè)畫(huà)面在幾年前還屬于科幻范疇但現(xiàn)在已經(jīng)有一批工具和方案在往這個(gè)方向靠了。text-to-cad 本質(zhì)上是一類(lèi)把自然語(yǔ)言描述轉(zhuǎn)換成 CAD 可識(shí)別幾何模型的技術(shù)路線(xiàn)它的輸出通常不是某個(gè)私有格式而是 STEP、URDF、G-code 這類(lèi)通用性強(qiáng)的中間格式。為什么是這幾個(gè)格式因?yàn)?STEP 是工業(yè)界公認(rèn)的實(shí)體模型交換標(biāo)準(zhǔn)URDF 是機(jī)器人領(lǐng)域描述連桿和關(guān)節(jié)的通用語(yǔ)言G-code 則是從模型走向加工的最后一步。換句話(huà)說(shuō)text-to-cad 想打通的是“語(yǔ)言描述 → 幾何定義 → 可制造/可仿真文件”這條鏈路。這件事的價(jià)值在哪兒我舉個(gè)自己踩過(guò)的場(chǎng)景。做非標(biāo)設(shè)備的時(shí)候經(jīng)常需要根據(jù)客戶(hù)口頭描述快速出一個(gè)初步模型去對(duì)尺寸。傳統(tǒng)流程是聽(tīng)懂需求 → 打開(kāi) CAD 軟件 → 草圖 → 拉伸 → 打孔 → 導(dǎo)出。一套下來(lái)熟練工也得十幾分鐘而且中間任何一處尺寸理解錯(cuò)了返工成本很高。text-to-cad 的思路是把“草圖→拉伸→打孔”這些重復(fù)性勞動(dòng)交給程序人只負(fù)責(zé)用語(yǔ)言把關(guān)鍵約束說(shuō)清楚。它解決的不是“替代設(shè)計(jì)師”而是“把設(shè)計(jì)師從重復(fù)建模里撈出來(lái)”。適合關(guān)注這個(gè)方向的人其實(shí)挺雜的做機(jī)械設(shè)計(jì)的想提效做機(jī)器人仿真的想快速生成 URDF做 3D 打印的想從文字直接出 G-code甚至做教育的想讓學(xué)生用自然語(yǔ)言理解幾何約束。不同背景的人關(guān)注點(diǎn)不一樣但核心訴求是一致的——降低從想法到模型的門(mén)檻。我在這篇文章里會(huì)把這套東西拆開(kāi)講整體設(shè)計(jì)思路怎么定、核心格式之間怎么轉(zhuǎn)換、實(shí)操環(huán)節(jié)怎么落地、以及我實(shí)際折騰過(guò)程中遇到的一堆坑。內(nèi)容會(huì)涉及 STEP、URDF、G-code 的具體處理方式也會(huì)給一些可以直接抄的參數(shù)和代碼片段。不管你是剛接觸 CAD 二次開(kāi)發(fā)還是已經(jīng)在做參數(shù)化建模想往智能化靠應(yīng)該都能找到能用的東西。2. 整體設(shè)計(jì)思路為什么不是“直接生成”而是“分層轉(zhuǎn)換”2.1 核心架構(gòu)的選型邏輯很多人一開(kāi)始會(huì)想能不能訓(xùn)練一個(gè)模型輸入文字直接輸出 STEP 文件我試過(guò)類(lèi)似思路結(jié)論是現(xiàn)階段不現(xiàn)實(shí)。原因在于 STEP 文件本質(zhì)上是一堆 NURBS 曲面和拓?fù)潢P(guān)系的集合它的數(shù)據(jù)結(jié)構(gòu)極其嚴(yán)謹(jǐn)一個(gè)實(shí)體的邊界表示BRep要求面、邊、點(diǎn)之間的連接關(guān)系完全自洽。讓語(yǔ)言模型直接生成這種結(jié)構(gòu)化數(shù)據(jù)相當(dāng)于讓它逐字節(jié)寫(xiě)一個(gè)二進(jìn)制文件錯(cuò)誤率會(huì)高到?jīng)]法用。所以目前靠譜的方案都是分層的自然語(yǔ)言 → 中間參數(shù)化表示 → 幾何內(nèi)核操作 → 目標(biāo)格式導(dǎo)出。這個(gè)中間層可以是 JSON 描述的參數(shù)表也可以是 Python 腳本還可以是 OpenSCAD 那種聲明式代碼。我自己的方案選的是“自然語(yǔ)言 → 結(jié)構(gòu)化參數(shù) JSON → CadQuery/OpenCASCADE 內(nèi)核 → STEP/STL → 后處理”。為什么選 CadQuery因?yàn)樗?OpenCASCADE而 OpenCASCADE 是工業(yè)級(jí)幾何內(nèi)核對(duì) STEP 的支持非常成熟。另一個(gè)原因是 CadQuery 的 API 是鏈?zhǔn)降膶?xiě)起來(lái)接近自然語(yǔ)言的邏輯順序比如Workplane().box(80,40,20).faces(Z).workplane().hole(4)這種表達(dá)很容易和語(yǔ)言模型輸出的結(jié)構(gòu)對(duì)應(yīng)上。相比之下直接調(diào) OpenCASCADE 的 C 接口學(xué)習(xí)曲線(xiàn)太陡用 FreeCAD 的腳本又受限于它的對(duì)象模型。CadQuery 在靈活性和穩(wěn)定性之間取了一個(gè)不錯(cuò)的平衡點(diǎn)。這里有個(gè)關(guān)鍵決策點(diǎn)中間表示到底用“參數(shù)表”還是“代碼”。參數(shù)表的好處是安全模型只能從預(yù)定義的模板里選參數(shù)不會(huì)生成亂七八糟的幾何壞處是靈活性差遇到模板沒(méi)覆蓋的形狀就抓瞎。代碼的好處是靈活理論上能表達(dá)任意幾何壞處是語(yǔ)言模型生成的代碼可能跑不通甚至可能寫(xiě)出危險(xiǎn)操作。我的做法是混合常見(jiàn)形狀走參數(shù)表模板復(fù)雜形狀走代碼生成但代碼在執(zhí)行前會(huì)經(jīng)過(guò)一層 AST 靜態(tài)檢查禁止文件讀寫(xiě)和網(wǎng)絡(luò)調(diào)用。這個(gè)檢查步驟很關(guān)鍵我后面在避坑部分會(huì)詳細(xì)說(shuō)。2.2 格式轉(zhuǎn)換鏈的設(shè)計(jì)與取舍從幾何內(nèi)核出來(lái)之后往哪個(gè)格式走取決于下游用途。STEP 適合做精確的實(shí)體交換它的優(yōu)勢(shì)是保留了完整的 BRep 信息任何主流 CAD 軟件都能讀而且精度無(wú)損。但 STEP 有個(gè)問(wèn)題它不包含裝配約束和運(yùn)動(dòng)學(xué)信息你拿到的是一個(gè)靜態(tài)的幾何體。如果下游是機(jī)器人仿真就需要 URDF。URDF 描述的是連桿link和關(guān)節(jié)joint的樹(shù)狀結(jié)構(gòu)每個(gè) link 有自己的幾何形狀和慣性參數(shù)每個(gè) joint 有類(lèi)型旋轉(zhuǎn)、平移、固定和軸向。從 STEP 到 URDF 不是簡(jiǎn)單的格式轉(zhuǎn)換而是要把一個(gè)整體幾何拆成多個(gè) link再定義它們之間的關(guān)節(jié)關(guān)系。這一步目前沒(méi)有全自動(dòng)的可靠方案我的做法是在參數(shù) JSON 里就顯式定義好 link 和 joint 的結(jié)構(gòu)生成 STEP 的同時(shí)也生成 URDF兩者共享同一套尺寸參數(shù)。G-code 則是另一條路。它不關(guān)心幾何的精確表示只關(guān)心刀具軌跡。從模型到 G-code 通常要經(jīng)過(guò)切片3D 打印或 CAM 刀路規(guī)劃減材加工。text-to-cad 在這個(gè)環(huán)節(jié)的價(jià)值是語(yǔ)言描述里可以直接包含加工參數(shù)比如“層高 0.2填充 20%PLA 材料”這些參數(shù)和幾何參數(shù)一起進(jìn)入 JSON最后喂給切片引擎。我實(shí)測(cè)下來(lái)用 CadQuery 生成 STL再用 CuraEngine 的命令行模式切片整條鏈路可以完全腳本化。但要注意G-code 和 STEP 的精度要求完全不同STL 的網(wǎng)格精度如果設(shè)得太低薄壁特征會(huì)丟失打出來(lái)就是殘次品。目標(biāo)格式核心用途關(guān)鍵優(yōu)勢(shì)主要限制STEP精確實(shí)體交換無(wú)損 BRep通用性強(qiáng)無(wú)裝配運(yùn)動(dòng)信息URDF機(jī)器人仿真含關(guān)節(jié)與慣性需手動(dòng)拆分 linkG-code加工制造直接驅(qū)動(dòng)機(jī)床依賴(lài)切片/CAM 參數(shù)STL3D 打印/可視化簡(jiǎn)單通用網(wǎng)格精度有損2.3 語(yǔ)言理解層的設(shè)計(jì)邊界語(yǔ)言理解這塊我的建議是不要追求“大而全”。很多人一上來(lái)就想讓系統(tǒng)理解“一個(gè)復(fù)雜的機(jī)械臂”結(jié)果發(fā)現(xiàn)模型根本不知道從哪兒下手。正確的做法是限定領(lǐng)域詞匯表。比如你做的是板金件那就把“折彎”“沖孔”“沉頭”“翻邊”這些詞定義清楚每個(gè)詞對(duì)應(yīng)一組幾何操作和默認(rèn)參數(shù)。語(yǔ)言模型的任務(wù)只是把用戶(hù)的話(huà)映射到這些預(yù)定義操作上而不是自由發(fā)揮。我試過(guò)用純 prompt 讓模型輸出 CadQuery 代碼結(jié)果它經(jīng)常發(fā)明一些不存在的 API或者把hole和cboreHole搞混。后來(lái)改成“先分類(lèi)到操作模板再填參數(shù)”穩(wěn)定性大幅提升。另一個(gè)邊界是尺寸推理。用戶(hù)說(shuō)“一個(gè)差不多手掌大的盒子”這個(gè)“手掌大”到底是多大我的處理方式是維護(hù)一個(gè)常用尺寸映射表比如“手掌大”映射到 100mm 左右“拇指粗”映射到 20mm同時(shí)在輸出里明確標(biāo)注“按 100mm 估算如需精確請(qǐng)指定數(shù)值”。這樣既給了結(jié)果又留了修正余地。千萬(wàn)不要讓模型自己瞎猜一個(gè)精確到小數(shù)點(diǎn)后三位的數(shù)字那是在制造虛假精度。3. 核心細(xì)節(jié)解析STEP、URDF、G-code 的處理要點(diǎn)3.1 STEP 文件的生成與校驗(yàn)用 CadQuery 導(dǎo)出 STEP 就一行代碼cq.exporters.export(result, output.step)。但這一行背后有幾個(gè)坑。第一個(gè)坑是單位。CadQuery 默認(rèn)單位是毫米但 STEP 文件本身不強(qiáng)制單位有些軟件讀的時(shí)候會(huì)按英寸解釋。我遇到過(guò)導(dǎo)出的模型在另一個(gè)軟件里大了 25.4 倍就是因?yàn)閱挝粵](méi)對(duì)齊。解決辦法是在導(dǎo)出前顯式設(shè)置cq.Unit或者在文件頭里寫(xiě)入單位聲明。第二個(gè)坑是實(shí)體有效性。如果幾何操作產(chǎn)生了自相交或零厚度面STEP 文件可能能寫(xiě)出來(lái)但讀的時(shí)候會(huì)報(bào)錯(cuò)。我的習(xí)慣是在導(dǎo)出前跑一遍result.val().isValid()不通過(guò)就回退到上一個(gè)有效狀態(tài)。還有一個(gè)實(shí)際問(wèn)題是文件大小。一個(gè)帶很多小孔和圓角的零件STEP 文件可能幾十兆。如果只是做可視化沒(méi)必要用 STEP轉(zhuǎn)成 STL 或 glTF 更合適。我一般會(huì)在 JSON 里加一個(gè)output_format字段根據(jù)用途自動(dòng)選格式。如果是給下游 CAD 做進(jìn)一步編輯必須 STEP如果是給網(wǎng)頁(yè)預(yù)覽glTF 足夠如果是 3D 打印STL 加 G-code。import cadquery as cq # 從參數(shù)構(gòu)建模型 length, width, height 80.0, 40.0, 20.0 hole_dia 4.0 result ( cq.Workplane(XY) .box(length, width, height) .faces(Z) .workplane() .rect(length - 10, width - 10, forConstructionTrue) .vertices() .hole(hole_dia) ) # 校驗(yàn)實(shí)體有效性 if not result.val().isValid(): raise ValueError(生成的實(shí)體無(wú)效請(qǐng)檢查參數(shù)) # 導(dǎo)出 STEP cq.exporters.export(result, bracket.step)這段代碼里forConstructionTrue是個(gè)容易忽略的點(diǎn)。它表示這個(gè)矩形只用來(lái)定位頂點(diǎn)不參與實(shí)際幾何。如果不加這個(gè)參數(shù)矩形會(huì)被當(dāng)成實(shí)體的一部分切出來(lái)結(jié)果就完全不對(duì)了。這種細(xì)節(jié)在文檔里往往一筆帶過(guò)但實(shí)際用的時(shí)候不知道就會(huì)卡很久。3.2 URDF 的關(guān)節(jié)定義與慣性參數(shù)URDF 的難點(diǎn)不在幾何而在關(guān)節(jié)和慣性。幾何部分可以直接從 STEP 或 STL 引用 mesh 文件但關(guān)節(jié)類(lèi)型、軸向、限位這些必須顯式定義。我見(jiàn)過(guò)很多人把 URDF 寫(xiě)成了一堆固定關(guān)節(jié)的集合結(jié)果導(dǎo)入仿真環(huán)境后機(jī)器人根本動(dòng)不了。正確的做法是先想清楚運(yùn)動(dòng)鏈哪個(gè) link 是父、哪個(gè)是子、關(guān)節(jié)繞哪個(gè)軸轉(zhuǎn)、轉(zhuǎn)多少度。這些信息在 text-to-cad 的 JSON 里就應(yīng)該定義好而不是等到生成 URDF 時(shí)再補(bǔ)。慣性參數(shù)是另一個(gè)大坑。URDF 要求每個(gè) link 有質(zhì)量和慣性矩陣。如果隨便填一個(gè)值仿真時(shí)會(huì)出現(xiàn)奇怪的抖動(dòng)或者直接飛出去。我的做法是用幾何體積乘以材料密度估算質(zhì)量慣性矩陣用近似公式算。比如一個(gè)長(zhǎng)方體繞中心軸的慣性矩是m*(w^2h^2)/12。雖然不精確但比瞎填強(qiáng)得多。如果對(duì)精度要求高可以用 FreeCAD 或 Blender 算完再填進(jìn)去。link namebase_link visual geometry mesh filenamebase.stl scale0.001 0.001 0.001/ /geometry /visual collision geometry mesh filenamebase.stl scale0.001 0.001 0.001/ /geometry /collision inertial mass value0.5/ inertia ixx0.001 ixy0 ixz0 iyy0.001 iyz0 izz0.001/ /inertial /link注意scale那個(gè) 0.001。STL 通常以毫米為單位導(dǎo)出但 URDF 的標(biāo)準(zhǔn)單位是米所以必須縮放。這個(gè)坑我踩過(guò)不止一次導(dǎo)入后模型大得像個(gè)房子排查半天才發(fā)現(xiàn)是單位問(wèn)題。3.3 G-code 的切片參數(shù)與路徑規(guī)劃從模型到 G-code核心是切片參數(shù)。層高、壁厚、填充密度、打印速度、溫度這些參數(shù)直接決定成品質(zhì)量。text-to-cad 在這個(gè)環(huán)節(jié)的價(jià)值是把語(yǔ)言描述里的加工意圖翻譯成切片參數(shù)。比如用戶(hù)說(shuō)“要結(jié)實(shí)一點(diǎn)”那就把填充密度從 20% 提到 40%壁厚從 2 層加到 3 層。說(shuō)“表面要光滑”那就把層高降到 0.1mm。這些映射關(guān)系需要事先定義好不能指望切片軟件自己理解。我用的是 CuraEngine 的命令行模式因?yàn)樗梢酝耆_本化不需要打開(kāi)圖形界面。調(diào)用方式大概是CuraEngine slice -j fdmprinter.def.json -l model.stl -o output.gcode -s layer_height0.2 -s infill_sparse_density20 -s wall_line_count3這里-j指定打印機(jī)定義文件-l指定輸入模型-s覆蓋具體參數(shù)。實(shí)測(cè)下來(lái)這套流程跑通之后從文字到 G-code 可以做到全自動(dòng)。但有個(gè)前提模型必須是流形manifold的也就是沒(méi)有破面、沒(méi)有自相交。STL 如果是從有問(wèn)題的 STEP 轉(zhuǎn)過(guò)來(lái)的切片時(shí)會(huì)出現(xiàn)空洞或者錯(cuò)層。所以我在導(dǎo)出 STL 之前一定會(huì)做一次網(wǎng)格修復(fù)用trimesh或者admesh都行。4. 實(shí)操過(guò)程從一句話(huà)到可加工文件的完整鏈路4.1 環(huán)境搭建與依賴(lài)安裝先把環(huán)境說(shuō)清楚。我用的主力是 Python 3.10CadQuery 2.4CuraEngine 5.xtrimesh 3.x。CadQuery 的安裝推薦用 conda因?yàn)樗囊蕾?lài)?yán)镉?OpenCASCADE 的二進(jìn)制包pip 裝有時(shí)候會(huì)缺庫(kù)。conda create -n text2cad python3.10 conda activate text2cad conda install -c conda-forge cadquery pip install trimesh urdfpyCuraEngine 需要單獨(dú)下載編譯好的二進(jìn)制放到 PATH 里就行。如果你用的是 Windows注意把它的路徑加到系統(tǒng)環(huán)境變量不然命令行調(diào)用會(huì)找不到。我一開(kāi)始在 Windows 上折騰了半天后來(lái)發(fā)現(xiàn)是路徑里有空格導(dǎo)致解析出錯(cuò)換到?jīng)]有空格的目錄就好了。語(yǔ)言理解層我用的是本地部署的小模型加規(guī)則引擎不依賴(lài)外部接口。這樣做的好處是響應(yīng)快、數(shù)據(jù)不出本地壞處是理解能力有限。如果你的場(chǎng)景詞匯比較固定規(guī)則引擎加小模型完全夠用。如果場(chǎng)景很開(kāi)放那可能需要更大的模型但那就涉及到算力和部署成本的問(wèn)題了得自己權(quán)衡。4.2 參數(shù) JSON 的結(jié)構(gòu)設(shè)計(jì)整個(gè)鏈路的核心是那個(gè)參數(shù) JSON。它既是語(yǔ)言理解的輸出也是幾何生成的輸入。我的結(jié)構(gòu)大概長(zhǎng)這樣{ part_name: mounting_bracket, units: mm, geometry: { type: box_with_holes, length: 80, width: 40, height: 20, holes: [ {position: corners, diameter: 4, depth: through} ] }, material: aluminum_6061, output: [step, stl], manufacturing: { process: cnc, tolerance: 0.1 } }這個(gè)結(jié)構(gòu)的好處是清晰、可校驗(yàn)。geometry.type決定了用哪個(gè)模板holes數(shù)組描述了孔的位置和尺寸output決定導(dǎo)出哪些格式。語(yǔ)言理解層的任務(wù)就是把“一個(gè) 80 乘 40 乘 20 的鋁板四角打 4 毫米通孔”映射成這個(gè) JSON。映射規(guī)則可以寫(xiě)得很細(xì)比如“通孔”對(duì)應(yīng)depth: through“沉頭”對(duì)應(yīng)type: counterbore并附帶沉頭直徑和深度。我建議在 JSON 里加一個(gè)confidence字段記錄每個(gè)參數(shù)的可信度。如果某個(gè)尺寸是從模糊描述里猜的就標(biāo)低一點(diǎn)生成后在界面上高亮提示用戶(hù)確認(rèn)。這個(gè)做法在實(shí)際使用中能減少很多“我以為你懂我意思”的扯皮。4.3 幾何生成與格式導(dǎo)出的完整腳本把上面的東西串起來(lái)主流程大概是這樣import json import cadquery as cq from cadquery import exporters def build_from_json(params): geo params[geometry] if geo[type] box_with_holes: result cq.Workplane(XY).box(geo[length], geo[width], geo[height]) if geo.get(holes): result ( result.faces(Z).workplane() .rect(geo[length] - 10, geo[width] - 10, forConstructionTrue) .vertices() .hole(geo[holes][0][diameter]) ) else: raise ValueError(f不支持的幾何類(lèi)型: {geo[type]}) if not result.val().isValid(): raise ValueError(幾何無(wú)效) return result def export_all(model, params, basename): outputs params.get(output, [step]) if step in outputs: exporters.export(model, f{basename}.step) if stl in outputs: exporters.export(model, f{basename}.stl, tolerance0.01) if urdf in outputs: generate_urdf(model, params, f{basename}.urdf) if gcode in outputs: slice_to_gcode(f{basename}.stl, params, f{basename}.gcode)這里tolerance0.01是 STL 的網(wǎng)格精度單位是毫米。這個(gè)值越小網(wǎng)格越細(xì)文件越大。對(duì)于大多數(shù) 3D 打印件0.01 到 0.05 之間夠用了。如果零件有很小的特征比如 0.5mm 的細(xì)縫那得設(shè)到 0.005 以下不然縫就糊住了。4.4 從 STL 到 G-code 的切片實(shí)操切片這一步我單獨(dú)拎出來(lái)說(shuō)因?yàn)樗婕暗膮?shù)最多也最容易出問(wèn)題。以 CuraEngine 為例一個(gè)典型的調(diào)用需要指定打印機(jī)定義、材料定義和一堆覆蓋參數(shù)。我一般會(huì)把常用配置寫(xiě)成 JSON 文件調(diào)用時(shí)直接引用。CuraEngine slice \ -j fdmprinter.def.json \ -l bracket.stl \ -o bracket.gcode \ -s layer_height0.2 \ -s wall_line_count3 \ -s infill_sparse_density20 \ -s material_print_temperature210 \ -s material_bed_temperature60 \ -s speed_print50跑完之后一定要檢查 G-code 的開(kāi)頭和結(jié)尾。開(kāi)頭應(yīng)該有歸零和預(yù)熱指令結(jié)尾應(yīng)該有回抽和關(guān)機(jī)指令。如果這些不對(duì)打印機(jī)可能直接撞頭或者堵嘴。我習(xí)慣用gcode-parser之類(lèi)的工具快速掃一遍確認(rèn)沒(méi)有異常指令。還有一個(gè)實(shí)際經(jīng)驗(yàn)不同品牌的打印機(jī)對(duì) G-code 的方言支持不一樣。比如有的機(jī)器用M104設(shè)溫度有的用M109并等待。如果你的 G-code 是給特定機(jī)器用的最好在切片配置里選對(duì)機(jī)型或者手動(dòng)改一下起始和結(jié)束代碼。這個(gè)沒(méi)有通用解只能針對(duì)具體設(shè)備調(diào)。5. 常見(jiàn)問(wèn)題與排查技巧實(shí)錄5.1 幾何生成階段的典型報(bào)錯(cuò)問(wèn)題一實(shí)體無(wú)效isValid 返回 False。最常見(jiàn)的原因是布爾運(yùn)算產(chǎn)生了零厚度面或者自相交。比如在一個(gè)面上打孔孔的位置正好在邊緣上切出來(lái)的面就退化了。解決辦法是調(diào)整孔的位置留出至少一個(gè)壁厚的余量。如果必須貼邊那就把孔改成缺口用切除而不是打孔。問(wèn)題二圓角失敗。對(duì)一條邊做圓角如果相鄰面的夾角太小或者邊長(zhǎng)不夠圓角會(huì)失敗。CadQuery 的fillet會(huì)直接拋異常。我的做法是先用edges()選中要倒角的邊檢查它的長(zhǎng)度是否大于圓角半徑的兩倍不滿(mǎn)足就跳過(guò)或者減小半徑。問(wèn)題三導(dǎo)出 STEP 后文件打不開(kāi)。十有八九是單位或者編碼問(wèn)題。先確認(rèn)導(dǎo)出時(shí)單位設(shè)置正確再檢查文件路徑里有沒(méi)有中文或特殊字符。有些老版本的 CAD 軟件對(duì) UTF-8 路徑支持不好換成純英文路徑就能解決。5.2 URDF 導(dǎo)入仿真環(huán)境的常見(jiàn)坑URDF 導(dǎo)入 CoppeliaSim 或者 Gazebo 時(shí)最常見(jiàn)的問(wèn)題是 mesh 路徑不對(duì)。URDF 里的filename可以是相對(duì)路徑也可以是絕對(duì)路徑但不同仿真器對(duì)相對(duì)路徑的解析基準(zhǔn)不一樣。CoppeliaSim 通常相對(duì)于 URDF 文件所在目錄Gazebo 則相對(duì)于某個(gè)模型包路徑。我的做法是統(tǒng)一用package://前綴然后在仿真環(huán)境里配置好包路徑映射。如果嫌麻煩直接用絕對(duì)路徑也行但換機(jī)器就得改。另一個(gè)坑是關(guān)節(jié)軸向。URDF 里關(guān)節(jié)的axis是相對(duì)于 joint 坐標(biāo)系的不是相對(duì)于世界坐標(biāo)系。如果你定義了一個(gè)繞 Z 軸旋轉(zhuǎn)的關(guān)節(jié)但 joint 坐標(biāo)系本身被旋轉(zhuǎn)過(guò)那實(shí)際轉(zhuǎn)軸就不是世界 Z 軸了。這個(gè)在簡(jiǎn)單模型里不容易發(fā)現(xiàn)一旦模型復(fù)雜起來(lái)運(yùn)動(dòng)就會(huì)變得很奇怪。排查方法是把 URDF 導(dǎo)入后手動(dòng)拖一下關(guān)節(jié)看運(yùn)動(dòng)方向是否符合預(yù)期。5.3 G-code 打印失敗的排查清單現(xiàn)象可能原因排查方法第一層不粘平臺(tái)溫度低/調(diào)平不準(zhǔn)提高 bed 溫度重新調(diào)平中途斷層耗材卡住/溫度波動(dòng)檢查送絲機(jī)構(gòu)穩(wěn)定熱端溫度尺寸偏大材料收縮/步進(jìn)校準(zhǔn)校準(zhǔn) E 步調(diào)整收縮補(bǔ)償表面粗糙層高太大/速度太快降低層高和打印速度孔洞堵死填充重疊/網(wǎng)格問(wèn)題檢查 STL 流形性調(diào)整填充重疊率這張表是我自己打印失敗多次之后總結(jié)的基本上覆蓋了八成以上的常見(jiàn)問(wèn)題。其中“孔洞堵死”這個(gè)特別隱蔽因?yàn)槟Ｐ涂雌饋?lái)沒(méi)問(wèn)題切片預(yù)覽也正常但打出來(lái)孔就是實(shí)的。后來(lái)發(fā)現(xiàn)是 STL 網(wǎng)格在孔的位置有微小破面切片引擎把孔當(dāng)成了實(shí)體。用trimesh的repair功能修一下就好了。5.4 語(yǔ)言理解層的避坑心得語(yǔ)言理解這塊最大的坑是“過(guò)度自信”。模型對(duì)模糊描述會(huì)給出一個(gè)看起來(lái)很確定的答案但實(shí)際上它是在猜。比如“打幾個(gè)孔”它可能默認(rèn)打四個(gè)但用戶(hù)心里想的是六個(gè)。我的做法是在輸出 JSON 里加一個(gè)assumptions數(shù)組把所有猜測(cè)都列出來(lái)生成后顯示給用戶(hù)確認(rèn)。這個(gè)做法看起來(lái)麻煩但比事后返工強(qiáng)得多。另一個(gè)坑是單位混用。用戶(hù)可能說(shuō)“長(zhǎng) 8 厘米”也可能說(shuō)“長(zhǎng) 80 毫米”還可能說(shuō)“長(zhǎng) 8 公分”。這些都得映射到統(tǒng)一的毫米單位。我維護(hù)了一個(gè)單位映射表覆蓋厘米、毫米、米、英寸、公分這些常見(jiàn)說(shuō)法。英寸轉(zhuǎn)毫米是 25.4這個(gè)系數(shù)一定要記準(zhǔn)不然差之毫厘謬以千里。6. 工具選型與擴(kuò)展思路6.1 幾何內(nèi)核的對(duì)比與選擇OpenCASCADE 是功能最全的但學(xué)習(xí)曲線(xiàn)陡。CadQuery 封裝了它用起來(lái)舒服很多。FreeCAD 的 Part 模塊也是基于 OpenCASCADE但它的腳本接口更偏向于操作文檔對(duì)象不如 CadQuery 直接。如果你要做的是建筑或土木方向的模型那可能更適合用 Blender 的腳本或者 IfcOpenShell。選哪個(gè)內(nèi)核取決于你的幾何復(fù)雜度和團(tuán)隊(duì)的技術(shù)棧。我的建議是機(jī)械零件用 CadQuery建筑用 IfcOpenShell可視化用 trimesh 或 Blender。6.2 從 text-to-cad 到 text-to-cam 的延伸text-to-cad 的下一步自然是 text-to-cam。既然語(yǔ)言能描述幾何那也能描述加工策略。比如“先粗銑再精銑粗銑留 0.5 余量精銑轉(zhuǎn)速 8000”這些完全可以結(jié)構(gòu)化后喂給 CAM 引擎。FreeCAD 的 Path 工作臺(tái)支持腳本化生成刀路理論上可以和 text-to-cad 的 JSON 對(duì)接。我試過(guò)一個(gè)簡(jiǎn)單的例子從 JSON 讀取零件尺寸和加工參數(shù)自動(dòng)生成一個(gè)平面銑削的 G-code。雖然離實(shí)用還有距離但方向是通的。6.3 批量處理與自動(dòng)化集成如果你有一堆相似的零件要處理text-to-cad 的批量能力就體現(xiàn)出來(lái)了。把每個(gè)零件的描述寫(xiě)成一行文字批量轉(zhuǎn)成 JSON再批量生成模型和 G-code。我用這個(gè)方式處理過(guò)一批支架類(lèi)零件二十多個(gè)變體從描述到 G-code 全部自動(dòng)完成只花了不到十分鐘。如果手動(dòng)建模一個(gè)下午都搞不定。批量處理的關(guān)鍵是模板要足夠通用參數(shù)要足夠靈活。如果每個(gè)零件都要改代碼那就失去自動(dòng)化的意義了。7. 我個(gè)人在實(shí)際操作中的幾點(diǎn)體會(huì)這套東西我斷斷續(xù)續(xù)折騰了大半年最大的體會(huì)是不要追求一步到位。一開(kāi)始我想做一個(gè)“萬(wàn)能”的 text-to-cad 系統(tǒng)什么都能生成結(jié)果什么都做不好。后來(lái)把范圍縮到“板類(lèi)零件帶孔”反而穩(wěn)定了。先在一個(gè)窄領(lǐng)域里做到能用再慢慢擴(kuò)展比一開(kāi)始就鋪大攤子靠譜得多。第二個(gè)體會(huì)是校驗(yàn)比生成更重要。生成一個(gè)模型不難難的是保證它是對(duì)的。我現(xiàn)在花在校驗(yàn)上的時(shí)間比生成還多實(shí)體有效性檢查、尺寸范圍檢查、單位一致性檢查、網(wǎng)格流形性檢查。這些檢查看起來(lái)繁瑣但能擋住絕大多數(shù)低級(jí)錯(cuò)誤。沒(méi)有校驗(yàn)的自動(dòng)化就是在批量制造垃圾。第三個(gè)體會(huì)是保留人工干預(yù)的入口。全自動(dòng)聽(tīng)起來(lái)很酷但實(shí)際用的時(shí)候用戶(hù)總會(huì)有一些系統(tǒng)理解不了的需求。這時(shí)候如果能方便地手動(dòng)改參數(shù)、改代碼體驗(yàn)會(huì)好很多。我的做法是生成的 JSON 和 Python 腳本都保留下來(lái)用戶(hù)可以直接編輯后重新生成。這樣系統(tǒng)是“輔助”而不是“替代”接受度會(huì)高很多。最后分享一個(gè)小技巧如果你也在做類(lèi)似的東西建議把每次生成的輸入描述、中間 JSON、輸出文件和校驗(yàn)結(jié)果都存下來(lái)。攢夠幾百條之后你會(huì)發(fā)現(xiàn)哪些描述容易理解錯(cuò)、哪些參數(shù)經(jīng)常需要調(diào)整。這些數(shù)據(jù)是優(yōu)化系統(tǒng)的金礦比拍腦袋想規(guī)則有用得多。我現(xiàn)在就有一個(gè)這樣的日志庫(kù)每次遇到新的描述方式就加一條慢慢地把覆蓋率提上去了。