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 标准库构建，无需任何外部包。