ghbalf/freecad-ai

它解决了什么问题

FreeCAD AI 为 FreeCAD 中的 3D 建模提供了一个自然语言接口。它允许用户通过使用简单的英文描述其目标，而不是手动操作复杂的软件 UI 和 Python API，来创建复杂的 3D 模型、修改几何形状以及管理装配体。

工作原理

该项目将聊天界面直接作为工作台集成到 FreeCAD 中。它连接到各种 LLM 提供商（包括像 Ollama 这样的本地选项），将用户描述转换为可执行的 Python 代码。它以两种主要模式运行：

• Plan Mode：AI 生成代码，由用户进行审查并手动执行。
• Act Mode：AI 使用包含 50 多个结构化工具（例如 create_primitive, boolean_operation, fillet_edges）的库自动执行操作，或者退回到原始代码生成模式。

为了提高可靠性，它包含一个用于代码验证的沙盒、错误自我修正（失败时自动重试）以及“Skills”——用于特定任务（如创建齿轮或电子设备外壳）的可重用指令集。

面向对象

• FreeCAD 用户：希望加快建模工作流程的人。
• 初学者：觉得 FreeCAD Python API 或 UI 难以上手的人。
• 开发者：希望使用自定义 AI 可调用 Python 工具来扩展 FreeCAD 功能的人。

亮点

• 广泛的提供商支持：兼容超过 20 种 LLM 提供商，包括 Anthropic、OpenAI、Gemini 以及本地 Ollama 实例。
• 结构化工具：使用 50 多个预验证的操作，与原始代码生成相比可减少错误。
• 可扩展架构：支持用户定义的 Python 工具和用于复杂、可重复任务的 "Skills"。
• 视觉集成：支持视口截图和图像附件，为 AI 提供模型的视觉上下文。
• 零依赖：仅使用 Python 标准库构建，简化了安装过程。