| name | freecad-automation |
| description | FreeCAD CAD 自动化技能，通过 Python 脚本直接驱动 FreeCAD 进行参数化建模。
覆盖完整工程工作流：零件建模（Part Design + Sketcher）、装配体、工程图（TechDraw）、文件导出。
跨平台（Windows / macOS / Linux），无需 GUI 亦可脚本批量运行。
兼容 FreeCAD 0.21 及 1.0+。
触发场景：用户提到 FreeCAD、开源 CAD、参数化建模、零件设计、草图、3D 建模脚本、
STEP/STL/IGES 导出、FreeCAD 宏、FEM 仿真、钣金、工程图等相关需求时使用。
触发关键词：FreeCAD、开源CAD、Part Design、Sketcher、TechDraw、FCStd、FreeCAD宏、
FreeCAD Python、FreeCAD脚本、导出STEP、导出STL、免费CAD。
|
FreeCAD 自动化技能
快速开始
环境要求
- FreeCAD 0.21+ 已安装（freecad.org）
- 运行方式三选一：
- GUI 宏：FreeCAD → 工具 → 宏 → 创建/编辑
- 无头脚本：
freecadcmd myscript.py（macOS/Linux）或 FreeCADCmd.exe myscript.py（Windows）
- 嵌入 Python：将 FreeCAD lib 路径加入
sys.path 后 import FreeCAD
连接 / 初始化
import sys; sys.path.insert(0, r"SKILL_DIR/scripts")
from fc_connect import new_document, open_document, save_document, mm, deg
doc = new_document("MyPart")
doc = open_document("/path/to/file.FCStd")
将 SKILL_DIR 替换为本技能的实际安装路径。
核心工作流
根据用户需求选择对应模块：
| 需求 | 脚本 | 参考文档 |
|---|
| 文档管理 | scripts/fc_connect.py | — |
| 草图 + 特征建模（Part Design） | scripts/fc_part.py | references/part-modeling.md |
| 轻量几何操作（Part 工作台） | scripts/fc_part.py → part_* 系列函数 | references/part-modeling.md |
| 装配体 | scripts/fc_assembly.py | references/assembly.md |
| 工程图（TechDraw） | scripts/fc_drawing.py | references/drawing.md |
| 文件导出 | scripts/fc_export.py | references/export.md |
| 钣金 / FEM / 曲面 | — | references/advanced.md |
| 常见错误排查 | — | references/troubleshooting.md |
使用流程
- 创建或打开文档（
fc_connect.py）
- 建模：Part Design 路线（Body → Sketch → Pad/Pocket/…）或 Part 路线（几何体 + 布尔运算）
- 导出文件（
fc_export.py）
- 保存
.FCStd（save_document(doc, path)）
关键注意事项
- 单位：FreeCAD API 内部使用毫米（mm）。
mm(5) 仅为可读性封装，直接填数字即可
- recompute：每次修改属性后需调用
doc.recompute() 才会更新模型
- Part Design vs Part：复杂参数化零件用 Part Design（Body+Feature 树）；简单几何体或布尔运算用 Part 工作台直接操作 Shape
- 无头模式：GUI 不可用时，所有
FreeCADGui 调用需跳过；导出仍可正常工作
- 基准面名称：
XY_Plane（= Top/XY）、XZ_Plane（= Front/XZ）、YZ_Plane（= Right/YZ）
