TechMoon 科技月球
WordPress、SEO 與 AI 工具實測指南
TechMoon 科技月球
WordPress、SEO 與 AI 工具實測指南

Text-to-CAD 是把 CAD 引擎裝進編碼代理的開源外掛:代理寫 build123d Python 腳本、本機 OpenCASCADE 引擎建模,實測改寬度參數重跑只要 0.02 秒,並匯出 STEP、STL、3MF 接進下游加工流程。
用 AI 摘要這篇文章:
2026 年用 AI 做 3D 模型,主流路線長得一樣:打開一個網站,輸入一段描述,換回一個網格模型,想改就再生成一次。earthtojake 的 Text-to-CAD 賭的是另一條路,而且賭得很徹底:它不安裝成一個新網站,也不包一個新的桌面 App,而是變成你本來就在用的編碼代理(Claude Code、Codex、Cursor、Gemini CLI 這些)的一組外掛與技能,把一整套 CAD 引擎裝在你自己的電腦上。你跟代理說要做一塊什麼尺寸的安裝板,代理寫出 Python 腳本,本機引擎把它建出來,之後改尺寸也是改腳本重跑。
我在 macOS 上實際跑了一輪:第一次建模型冷啟 39 秒(其中大部分是 CAD 核心首次載入),把寬度參數從 40 改成 80 之後重跑,只花 0.02 秒,而且是同一份文件原地更新。匯出的 STEP 檔打開來看,是 OpenCASCADE 8.0 寫出的 AP242 格式,能直接進下游 CAD 軟體或切片程式。這組數字背後的設計判斷,比「AI 會畫 3D」這句話值得拆開來看。
先給結論:你已經訂閱任何一個主流編碼代理、而且要做的東西是機能零件、外殼、治具或 3D 列印模型,Text-to-CAD 值得裝來用;你想要的如果是拖曳滑鼠的圖形介面建模、或看起來漂亮就好的角色網格,它目前幫不上忙,文末會給替代方向。
先把它的形態講清楚,因為這決定了後面所有的事。Text-to-CAD 本體是一個 MIT 授權的開源專案(GitHub 上 earthtojake/text-to-cad,2026 年 4 月 22 日建立,主要語言是 Python),營運主體是 Thompson Labs LLC。它不提供 AI 模型服務:智慧在你自己的代理那一端,工具這一端提供三樣東西,安裝進代理的技能文件(教代理怎麼寫建模腳本、怎麼匯出)、一個在本機常駐的 CAD 伺服器(以 build123d 這個 Python CAD 程式庫驅動 OpenCASCADE 幾何核心)、以及一個綁在 127.0.0.1 的瀏覽器檢視器,模型建好即時顯示。
官網列出的相容代理清單有 21 個,從 Claude Code、Codex、Cursor、Gemini、Grok、GitHub Copilot 到 Windsurf、Zed 都在內。安裝文檔認得的六個主要 App 各有專屬整合:Claude Code 拿到技能目錄與外掛、Claude Desktop 的設定檔被寫入 CAD 的 MCP 伺服器(聊天分頁裡能直接出現可旋轉的模型卡片)、Codex 有自己的外掛市集機制、Cursor 與 Grok Build 載入 Claude Code 那份外掛(各讀自己的清單、含 CAD 伺服器)、Gemini CLI 則把同一份外掛資料夾掛成 extension。其餘代理走共通的技能安裝器。這份清單本身就是一個表態:它假設你的代理已經是你每天工作的入口,新的能力應該長在那個入口上,不必再開一個新分頁。
這條路線跟把 3D 生成包成 agentic 服務的那類產品、或 TRELLIS 那種一張圖換一個網格的研究路線,解決的是不同任務。網格生成擅長外觀,長於形似;參數化 CAD 擅長的是每個尺寸都講得出來、改一個尺寸其他都不動的工程零件。兩者可以並存,但你想做的東西最後要加工、要列印、要鎖螺絲,你需要的會是後者。
實測環境是 macOS,走官方安裝腳本同一條路(uvx 從 PyPI 拉 cad-server 0.11.11,用官方鎖定的 Python 3.14 執行),刻意不動我自己的代理設定,先驗引擎本體。第一個測試是官方文件裡的範例形態:一塊 40 × 20 × 6 mm 的板子,中間減去一個直徑 8 mm 的圓柱通孔,整個模型是一個被 @model 裝飾的 Python 函式,尺寸就是另一個輔助函式的三個參數。
第一次執行,工具先把 CAD 核心環境裝進 ~/.cache/cad(下載約 240 MB,只此一次),然後冷建置花了 39.23 秒,輸出寫得很明白:1 個實體、邊界 40 × 20 × 6 mm、零關節,配一個本機檢視器網址。接著把腳本裡的寬度參數從 40 改成 80,再跑同樣的指令,0.02 秒完成,文件編號不變,邊界直接更新成 80 × 20 × 6 mm,日誌還標註這次重放跑了哪些步驟、哪些直接沿用(4 miss、2 hit)。修改是精準的手術,成本遠低於重新生成一次。
匯出也實際驗了。一行指令把這塊板子匯成三種檔案:STEP 21.5 KB、STL 5.9 KB、3MF 1.9 KB,三個各在 0.01 到 0.02 秒間寫完。STEP 檔頭親自查過,是 OpenCASCADE 8.0 的 AP242 實體幾何,CAD 界通用的交換格式,SolidWorks、Fusion、FreeCAD 這類 CAD 軟體都吃得到,多數主流切片軟體也能直接匯入。另外用 snapshot 指令輸出了一張 1600 × 1200 的模型快照,渲染乾淨,直接可以放進報告。整輪測完一行 cad stop 停掉伺服器,乾淨收尾。

那 0.02 秒來自架構本身。在 Text-to-CAD 裡,模型的唯一真相來源是那個 .py 檔:幾何由 build123d 程式碼定義,尺寸是函式的參數,單位固定是公釐、Z 軸朝上。文件的編號由腳本路徑加函式名決定,所以同一個模型每次跑都是同一份文件,開著的檢視器頁面跟著更新。本機伺服器會記住每個模型的建置過程,你改了一行程式碼,它只重跑受影響的操作,沒動到的直接沿用;官方文件甚至明說,改註解什麼都不會重跑,改尺寸只重跑讀取它的那些步驟。組裝體則由零件的函式互相呼叫組成,跑一次組裝腳本,每個零件保有自己的文件,事後單獨改某個零件再跑組裝即可。
這個設計把「改模型」從圖形介面操作換成了程式碼編輯,而程式碼編輯正好是編碼代理最強的事。你跟代理說「把長度改成 80、孔往上移 5 mm」,它做的就是改兩行程式碼然後重跑,過程可 diff、可進版本控制、可重現。對本來就把專案放在 Git 裡的團隊,模型跟著程式碼一起走審查,這在傳統 CAD 軟體裡要靠 PDM 系統才做得到。代理也不必每次從頭理解模型:腳本本身就是完整的設計意圖紀錄。
同一個架構也決定了它的極限:它是文字與腳本驅動的建模,沒有滑鼠拖曳、沒有特徵樹面板。它與 Fusion、SolidWorks 的關係,定位是輔助產出而非替代,官方文件本身不談這個比較。真的想要「旁邊有對話窗、旁邊也能用手調整模型」的桌面體驗,官方社群區收錄了一個建立在它之上的開源桌面 App(Text-to-CAD Studio,Mac 與 Windows,由第三方開發者維護),把模型、工程圖、應力檢查與版本放在聊天旁邊,等於社群生態自己補了這塊。
有一個常見誤解值得單獨拆開:有人以為匯出 STEP 之後,回到 SolidWorks 還能像原生模型一樣改尺寸、調特徵。事實不是這樣,官方文件寫得直白,STEP 帶走的是實體幾何、組裝的擺放、每個零件的名字與顏色,帶不走的是建模歷史與機構約束,原文就一句 a STEP is placements only。匯入其他 CAD 軟體後能不能編輯、怎麼編輯,取決於接收端軟體的匯入方式,通常你拿到的是一個啞實體(dumb solid):幾何完整,參數化關係已經不在檔案裡。
所以在這套工作流裡,想改尺寸就要回到 .py 腳本,那才是參數的家。這是優點也是門檻:優點是真相來源永遠單一、永遠可重跑;門檻是你和你的代理都要接受「模型等於程式碼」這個心智模型。順帶一提,它自己還有 .xbf 原生格式,廠商的 STEP 轉一次 xbf 之後讀取快很多(官方文件的說法是讀取同一顆馬達的模型檔),適合把現成零件反覆塞進自己的模型;反過來 mesh 類的 STL 永遠升不回 STEP,方向是單向的。
資料流向要拆成兩層看,這是很多同類工具會混過去的地方。第一層是 CAD 引擎:模型建置、幾何運算、檔案匯出全部在你的電腦上,檢視器綁本機、無帳號、無雲端儲存,隱私政策開頭第一段就寫明:你的提示、模型、圖檔留在你的電腦上,他們不收這些。第二層是 AI:你描述零件的那段話,會先進你所用代理背後的語言模型,也就是 OpenAI、Anthropic 或其他家的雲端。工具本身沒有任何 AI 遞送,但你的零件規格有。
對一般專案這沒問題;對機敏的機構圖面,這層就是評估重點。緩解的方式存在而且單純:換一個本地部署、支援外掛機制的代理,或者對描述先做去敏再送。費用也是同樣兩層:工具本身開源免費,代理的訂閱或 API 帳單是你原本就在付的那筆,裝這個外掛沒有新增任何訂閱。
隱私政策裡的遙測段落,是我近期看過寫得最仔細的一份。遙測預設打開,但有一個緩衝設計:第一次執行 cad 指令時,輸出會明講這個工具會送使用統計與當機報告、以及怎麼關,在那之前什麼都不送。送什麼也逐項列出:隨機安裝識別碼、版本、作業系統、處理器類型、代理名稱、每五分鐘彙總一次的工具呼叫與失敗計數(失敗原因用固定集合的詞,明確排除錯誤訊息、檔名、路徑與你輸入的任何內容)、當機報告只帶例外類型與原始碼位置,不含任何值。伺服器端從 IP 反查國家後不留 IP,資料交給 PostHog 分析,關掉遙測會同時刪除安裝識別碼並要求對方刪除既有資料,重新打開會換一個新識別碼,兩者連不起來。
這些宣稱我挑了一項實測:在環境變數 CAD_TELEMETRY=0 與 DO_NOT_TRACK=1 下執行,cad telemetry status 如政策所述回覆遙測已在此環境關閉。關閉的正式管道有三個:cad telemetry off 指令、檢視器選單、直接請代理代關;環境變數則能在不改設定的前提下對單一程序關閉。另外還有每小時一次的版本檢查連到 api.texttocad.dev,不帶識別碼,CAD_UPDATE_CHECK=0 可關。整體是 opt-out 設計,但 opt-out 的路徑、範圍與刪除行為都給足了文件,CI 與開發安裝預設什麼都不送,比多數免費工具誠實一個量級。
CAD 建模只是八個技能中的一個。同一套機制還教代理畫 KiCad 電路板(含電性規則檢查與生產檔)、用 CalculiX 做應力分析(峰值應力、安全係數、變形量畫在模型上)、產出有視圖與標註的工程圖 PDF、用 Blender 出寫實渲染與轉盤動畫、把雷切 DXF 對著 SendCutSend 的規則預檢、用 OrcaSlicer 切片送去 Bambu Connect 或 Bambu Studio、以及寫 URDF、SRDF、MJCF 這類機器人模擬描述檔。repo 裡的範例模型目錄也展示了企圖心:F1 賽車、F-14、獵鷹重型(Falcon Heavy)、超跑都在列。
這些技能的能力存在與文件完整可以確認,各域的實際產出品質則要動手用過才準;前面那組實測數字,代表的是建模與匯出這條主線。但光是「應力、工程圖、製造檢查跟建模共用同一份腳本真相來源」這一點,方向就與 Blender 接上 AI 出片那類單點整合不同,它瞄準的是把工程流程整條腳本化。對做硬體的新創或個人開發者,替製造業設計的代理技能會是同一個脈絡裡的鄰居。

安裝腳本本身值得一提,因為它把供應鏈風險做得很低。macOS 與 Linux 一行 curl 就裝,但腳本支援 –dry-run 先印出計畫不動任何東西,–only codex 這種參數限定只接某幾個代理,–version 可以釘住特定版本,每個 release 都附 SHA256SUMS 讓你先驗再跑,腳本說明裡甚至教你想保守一點就抓該版附的 install.sh 對照雜湊後再執行。Windows 有對應的 PowerShell 版。要關遙測就在安裝時加 –no-telemetry,或裝完跑 cad telemetry off。磁碟負擔主要是 CAD 核心環境:下載約 240 MB,裝妥後約佔 620 MB,Python 環境由安裝器自理(PyPI 上要求 3.13 以上)。診斷也有現成指令:cad doctor –check 只報告不修改,cad status 列出伺服器狀態,出問題時官方請你把 cad doctor –check 的輸出連同模型腳本附進 issue。
裝之前該知道的限制,集中在這裡:第一次冷啟要等核心載入(我這輪 39 秒,官方安裝腳本則說第一次執行要下載核心、約需一分鐘);沒有圖形編輯介面,一切修改走腳本;STEP 不回存特徵樹,前面講過;專案迭代非常快(下面給數字),指令與行為在版本間會變,重要的工作流建議用 –version 鎖版本。Windows 有一個硬限制值得單獨記:CAD 核心用的 OCP 模組(OpenCASCADE 的 Python 綁定)wheel 未簽署,Windows 11 的 Smart App Control 在全新安裝預設開啟時會直接擋下,所有 cad 指令與 import 都會失敗,而且 Smart App Control 沒有單 App 例外,官方給的解法是要嘛整個關掉(關了要重灌 Windows 才能再開)、要嘛改跑 WSL。
MIT 授權,商用沒有額外限制,你做的模型與圖檔依服務條款完全歸你,條款裡還有一句值得抄下來的提醒:生成的模型、工程圖與製造檔,在加工、下單或依賴之前先自己檢查。專案活躍度相當驚人:26,692 顆星、2,543 個 fork,公開 releases 清單裡最舊的一版是 0.1.16(2026 年 5 月 30 日發布),到 11 月 17 日的 v0.11.11 已累積 109 個 release,光 11 月就連發多版,11 月 17 日當天仍有新 issue 進來(純 issue 開啟數 7 個,計入 PR 的 41 個)。維護者是 X 上的 @earthtojake,營運主體 Thompson Labs LLC,社群有 Discord,問題回報與安全回報(SECURITY.md)路徑都齊。
一個供應鏈小觀察:PyPI 上的 cad 套件名在 2020 年有別人發過 1.x 版本,2026 年 11 月起這個名字換由 text-to-cad 團隊從 0.10.0 開始發布(現行 0.11.x;0.10 之前這套工具用的套件名是 cadgen),所以網路上找 cad 套件的舊資料會看到兩個時期,安裝時認清 earthtojake 的版本即可。這種節奏代表作者投入度極高,也代表它還在快速塑形期,把它放進生產流程的人建議固定版本、看著 changelog 升級。