ghbalf/freecad-ai

解決的問題

FreeCAD AI 為 FreeCAD 中的 3D 建模提供自然語言介面。使用者無需手動瀏覽複雜的 CAD 軟體選單或撰寫 Python 程式碼，只需以普通英文描述需求，即可建立、修改與分析 3D 模型。

工作原理

此專案將聊天介面直接整合至 FreeCAD 作為工作台。它連接到多種 LLM 提供商（如 OpenAI、Anthropic 或本地 Ollama 實例），將使用者提示轉換為可執行的 Python 程式碼。系統主要以兩種模式運作：「規劃」模式下，使用者可在執行前審查並驗證程式碼；「執行」模式則可使用包含 50 多個結構化工具（如 create_primitive、boolean_operation、fillet_edges）的程式庫自動執行操作，以提升可靠性。

適用對象

適合希望加速設計流程、自動化重複性建模任務，或透過 AI 協助降低 3D 參數化建模入門門檻的 FreeCAD 使用者。

主要特色

• 多提供者支援：相容 21 個 LLM 提供者，包含本地與雲端選項。
• 工具呼叫：使用結構化操作，相比原始程式碼生成，能實現更安全、更可靠的 3D 建模。
• 視覺整合：支援檢視窗截圖與圖片附件，讓 AI 可取得模型的視覺上下文。
• MCP 伺服器：可作為 Model Context Protocol (MCP) 伺服器公開，讓外部 AI 客戶端（如 Claude Desktop）控制 FreeCAD。
• 自我修正：自動偵測失敗程式碼並送回 LLM 重試（最多 3 次）。
• 零外部相依：僅使用 Python 標準程式庫建構，無需任何外部套件。