FreeCAD 与 AI:开源社区驱动的另一条路线
FreeCAD 核心项目没有内置 AI 设计功能,也没有公开的相关计划;AI 能力来自社区在其 Python 接口基座上独立维护的接入项目。本文梳理接口基座及其缺口、四个社区项目的功能覆盖与交互响应,并讨论这条路线的优势与代价。

文章目录
FreeCAD 是以 LGPL 许可发布的开源参数化建模软件,由社区开发,并由非营利机构 FreeCAD 项目协会(FreeCAD Project Association,FPA)提供资金与行政支持。2026 年,它发布了 1.1 版(公告日期为 3 月 25 日)、修复版 1.1.4(9 月 28 日),新版本 26.3 的第二个候选版在 10 月 18 日发布 [1][3][4]。
本文梳理 FreeCAD 在 AI 辅助设计方面的现状:核心项目有没有内置的 AI 设计功能或公开计划,它为 AI 提供了怎样的接口基座,社区开发了哪些 AI 接入项目、功能覆盖和交互响应如何,以及后续值得关注的事项。资料核对截至 2026 年 10 月 25 日;本文未对任何 AI 插件做实测,文中的星标、下载量等只是关注度指标,不代表质量或使用规模。
1. 核心项目:没有内置的 AI 设计功能,但提供接口基座
1.1 内置功能与规划
FreeCAD 1.1 的发布公告和发布说明页列出的新功能包括零件设计预览、交互式拖拽、装配与有限元改进、新的 CAM 刀具库等,其中没有 AI 相关功能 [1][2]。项目 2025 年度报告列出的 2026 年重点是文档、测试和发布周期的稳定性,同样没有 AI [10]。
对于把 AI 助手做进程序界面的想法,公开记录中的做法是留给社区。2026 年 6 月,有人在核心仓库提出了一个可停靠聊天面板的原型:由大模型把自然语言转成 FreeCAD 的 Python 命令并执行。维护者回复“请在论坛或 Discord 讨论这类事项”,该议题随即以“不计划处理”关闭 [11]。本文据此认为,核心项目目前没有公开的内置 AI 设计功能计划;这一判断基于公开记录,不排除内部讨论。
1.2 接口基座
没有内置 AI,不等于不能被 AI 使用。判断一个 CAD 能否被外部 AI 驱动,关键在于它是否提供完整、可编程的操作接口。FreeCAD 在这方面有四项公开的基础能力:
| 基础能力 | 官方文档的说明 | 对 AI 接入的意义 |
|---|---|---|
| 内置 Python 解释器 | Python 控制台中可使用 FreeCAD 的全部 Python 模块,如 Part、BIM、Draft,且核心模块无需导入 [9] | AI 生成的脚本可直接创建和修改对象,覆盖面与程序界面同级 |
| 操作即命令 | 界面中的每个操作都会输出对应的 Python 命令,可录制为宏,也可不录制而直接写宏 [8] | 提供大量可供模型参照的操作样例,并可把验证过的脚本固化为宏 |
| 无界面运行 | 可用 FreeCADCmd 启动;也可作为标准 Python 库导入,在外部脚本中调用完整接口 [9] | AI 工作流可在没有桌面界面的服务器或批处理中运行 |
| 开放的插件机制 | 第三方插件通过插件管理器分发,工作台与宏均可扩展界面 [5][8] | 接入层可以作为插件发布,不需要改动核心 |
这一基座有三点限制。其一,官方文档提醒,无界面模式下直接操作界面组件的接口“非常有限,通常不受支持”[9],依赖视图和选择状态的操作仍需要完整界面。其二,基座提供的是“可以做什么”,并不保证脚本生成的几何有效,这需要上层的接入项目自行检查(见第 2 节)。
其三,脚本路径与界面路径的行为未必一致。2026 年 10 月,一位用户用 MCP 驱动 CAM 工作台生成 G 代码时发现,标签(Tag)等切削附加操作在界面中正常,通过 Python 创建时却会多留一个原始切削,使工件与毛坯分离。维护者复现了该问题,原因是这类操作的原始切削只在界面的视图提供者中被移除,纯脚本路径没有这一步;议题标题称另有九项类似操作,截至核对日仍未关闭 [12]。这说明,AI 通过 Python 接口能覆盖的范围,取决于各工作台的脚本接口是否与界面行为一致。
2. 社区接入 AI:在基座上搭建的项目
2.1 四个代表性项目
由于有上述基座,外部项目不需要修改核心就能接入 AI。本文核对了四个有代表性的项目 [5][6][7][13]:
| 项目 | 形态 | 许可 | 公开信息 |
|---|---|---|---|
| neka-nat/freecad-mcp | MCP 服务器加 FreeCAD 内的插件 | MIT | GitHub 约 3.1k 星标、362 个分支、29 位贡献者;文档列出 17 个工具,可创建和编辑模型、运行 Python 脚本、检查文档、运行有限元分析 [6] |
| spkane/freecad-addon-robust-mcp-server | MCP 服务器加 FreeCAD 内的 MCP Bridge 工作台 | MIT | GitHub 约 259 星标、64 个分支;README 称提供 150 多个工具,按类别列出草图、拉伸、倒角、阵列、导入导出、宏管理等,支持 XML-RPC、套接字、无界面等运行模式 [13] |
| MCP Bridge(CREATeNG) | FreeCAD 插件管理器中的插件 | MIT | 官网插件列表中收录,版本 0.1.24,2026-10-24 更新,累计下载 3,066 次;让 AI 代理访问已打开的 FreeCAD 会话,配合本地 MCP 客户端使用 [5] |
| ghbalf/freecad-ai | FreeCAD 内的聊天面板工作台 | LGPL-2.1 与 CC0 | GitHub 约 589 星标;Plan/Act 两种模式、50 种结构化操作、支持 24 个模型提供方(含本地 Ollama);自述为 Alpha 软件,会出现“大模型生成代码导致 FreeCAD 偶发崩溃” [7] |

图 1:以 neka-nat/freecad-mcp 的 README 为依据绘制的接入结构:AI 客户端启动 MCP 服务器,通过本地远程调用连接 FreeCAD 内运行的插件,插件再调用 FreeCAD 的 Python 接口。图由 CADFrontier 绘制。
2.2 功能覆盖与交互响应
先看功能覆盖。freecad-mcp 的文档给出了较完整的工具清单和执行模型 [6]:
| 方面 | 文档中的做法 |
|---|---|
| 文档与对象 | 创建和列出文档,创建、编辑、删除和查询对象,重新加载被外部脚本修改的文档 |
| 视觉反馈 | 部分操作默认返回当前视图截图,可指定等轴测、前视、俯视等视角;可用 --only-text-feedback 关闭截图以减少 token |
| 代码执行 | 三种模式:在界面线程执行;后台异步执行并轮询状态;在独立的 freecadcmd 进程中无界面执行 |
| 领域功能 | 从 FreeCAD 零件库插入零件;对已有分析运行 CalculiX 有限元求解,返回最大等效应力、位移等摘要 |
freecad-mcp 以通用的代码执行为主,覆盖面基本等于 FreeCAD 的 Python 接口。Robust MCP Server 与 freecad-ai 则把常见建模步骤拆成结构化工具,如在草图中画线、拉伸、挖槽、倒角、阵列和导出 STEP [7][13]。本文认为,结构化工具让每一步的参数可检查,代码执行覆盖面最广、风险也最大,两种做法各有取舍;本文没有找到对它们的对比评测。
再看交互响应。freecad-mcp 的文档披露了几项机制和限制 [6]:
- 界面线程上的操作按先进先出顺序逐个执行;
execute_code默认的排队和执行预算均为 90 秒,可通过参数提高,上限 1800 秒。 - 操作一旦在界面线程开始就无法安全取消;超时后任务仍会继续,但结果被丢弃;若某操作超过执行预算,后续界面操作会被拒绝,直到它返回。
- 耗时的几何运算建议放到异步或无界面模式:后者在独立进程中运行,原生崩溃只会结束该进程,界面和已打开的文档不受影响。
- 文档提示,脚本运行成功不能证明几何有效。
可见,响应速度受界面单线程限制,长任务需要调用方遵循异步或无界面模式。本文没有做实测,以上均为项目文档的自述。
2.3 小结:两点差异与一项风险
第一,接入方式与商业软件有明显区别:它们都由第三方维护,需要用户自行安装,连接默认在本机完成 [6];支持本地模型的项目,使设计数据不必上传到云端成为可能 [7]。第二,成熟度参差:已有项目自述为 Alpha 并提示崩溃风险 [7],本文没有找到针对这些项目的独立评测。
此外还有安全风险。freecad-mcp 的文档说明,execute_code 以用户的权限在 FreeCAD 内运行任意 Python;默认只监听本机,开启远程连接时应设置认证令牌,且流量不加密 [6]。接入 AI 的便利和代码执行的权限是同一件事。
3. 讨论与结论
与已介绍的商业软件相比,FreeCAD 走的是不同的路线。Autodesk Fusion 已有产品内助手和三个厂商文档化的 MCP 服务器,SOLIDWORKS 与 西门子 NX 也有官方的 AI 功能或预告;FreeCAD 的核心项目没有内置 AI 设计功能,也没有公开的相关计划,但提供了 Python 接口、宏和无界面运行等基座,AI 设计能力来自社区在其上独立维护的接入项目。
本文认为,这条路线的优势是结构性的:接口基座完整而开放、许可宽松、可以接本地模型、数据可留在本机、接入层可以由社区快速迭代。它的代价同样明显:接入项目质量不一、缺少官方背书和统一评测;脚本路径与界面行为可能不一致 [12];代码执行的权限需要用户自行管控。因此,社区驱动路线在可控性和开放性上有优势,但就 AI 设计能力的成熟度而言,目前公开资料不足以得出它领先或落后的结论。
后续值得关注四件事:26.3 的正式发布;脚本接口与界面行为不一致的问题(如 CAM 的附加操作)是否被修复;核心项目是否改变“不做内置 AI 设计功能”的现状,哪怕只是提供官方的 AI 接口规范;以及这几个接入项目能否在插件生态中积累起稳定的用户和维护者。
资料来源与延伸阅读
- FreeCAD 博客:FreeCAD 1.1 released ↗来源地区: 全球/跨地区
- FreeCAD 1.1 发布说明页 ↗来源地区: 全球/跨地区
- FreeCAD 博客:FreeCAD 1.1.4 released ↗来源地区: 全球/跨地区
- FreeCAD 博客:FreeCAD 26.3 Release Candidate 2 ↗来源地区: 全球/跨地区
- FreeCAD 官网:插件列表(MCP Bridge) ↗来源地区: 全球/跨地区
- GitHub:neka-nat/freecad-mcp(README 与 docs/ 文档) ↗来源地区: 全球/跨地区
- GitHub:ghbalf/freecad-ai ↗来源地区: 全球/跨地区
- FreeCAD 文档:Macros(宏) ↗来源地区: 全球/跨地区
- FreeCAD 文档:Headless FreeCAD(无界面运行) ↗来源地区: 全球/跨地区
- FreeCAD 博客:2025 年度报告与 2026 年计划 ↗来源地区: 全球/跨地区
- FreeCAD 仓库:议题 #30896(AI 助手面板提案) ↗来源地区: 全球/跨地区
- FreeCAD 仓库:议题 #33599(CAM 附加操作经 Python/MCP 的差异) ↗来源地区: 全球/跨地区
- GitHub:spkane/freecad-addon-robust-mcp-server ↗来源地区: 全球/跨地区


