ghbalf/freecad-ai

FreeCAD AI – 在 FreeCAD 内进行 AI 辅助的 3D 建模

这是什么 – 一个 FreeCAD 工作台，添加了聊天式助手。你输入自然语言命令（例如 “做一个 50 mm × 30 mm × 20 mm 的盒子”），助手会生成 Python 代码，或调用一组预定义的“工具”来在 FreeCAD 中执行请求的操作。结果会直接插入当前活动的 FreeCAD 文档。

主要功能

• 聊天界面 停靠在 FreeCAD 内，可从 22 个受支持的 LLM 提供商（OpenAI、Anthropic、Ollama、Gemini 等）流式传输响应。
• Plan 与 Act：Plan 会显示生成的代码供你审查；Act 可以自动执行代码，或更推荐地，调用包装在安全撤销事务中的结构化工具调用。
• 工具库：50 个内置 FreeCAD 操作（创建基本体、草图、凸台、凹槽、布尔运算、圆角、阵列、导出等），以及一个供用户添加自己 Python 函数的钩子系统。
• 视觉支持 – 附加到聊天中的图像会发送给具备视觉能力的模型；否则由回退 MCP 服务器处理。
• 会话管理 – 保存/加载聊天会话、自动上下文摘要，以及当提供商不可用时的回退配置文件。
• 零外部依赖 – 该工作台仅使用 Python 标准库。

如何获取

1. 安装 FreeCAD 1.0+。
2. 克隆 repo 并在 FreeCAD 的 Mod 目录中创建符号链接（或复制）（路径因操作系统而异，请参阅 README）。
3. 重启 FreeCAD；FreeCAD AI 工作台会出现在选择器中。
4. 打开工作台，通过 Edit → Preferences → FreeCAD AI 或齿轮图标设置对话框配置 LLM 提供商（API 密钥或本地 Ollama），然后开始聊天。

典型工作流程

1. 输入描述。
2. 在 Plan 模式下，检查生成的 Python 并按 Execute（如果失败则按 Fix with AI）。
3. 在 Act 模式下，让模型直接调用工具以进行更安全的建模，或回退到原始代码执行。
4. 使用内置工具（export_model、capture_viewport 等），或通过 .py 或 .FCMacro 文件添加自定义工具。

适用对象 – 想要在不离开 FreeCAD 的情况下尝试自然语言驱动建模的 CAD 设计师、爱好者或开发者。它仍处于 alpha 阶段；预计会出现崩溃和破坏性变更，因此请经常备份。