FreeCAD 技能

描述

使用参数化操作在 FreeCAD 中创建或修改 3D CAD 模型。

适用场景

当用户提出以下请求时使用：

• 创建对象（基本图元，如长方体、圆柱体、球体、圆锥体、圆环体）
• 修改几何体（缩放、平移、旋转、倒圆角、切割、并集等）
• 生成 CAD 文件
• 执行复杂的多步骤 CAD 操作

输入（JSON）

{ "operation": "create_primitive | boolean | transform | batch | export | inspect | modifier | array | profile", "parameters": { ... } }

输出（JSON 返回值）

执行成功后，脚本将 JSON 负载打印至 stdout，其中包含所有当前活动对象的名称、包围盒（bounding box）及元数据。该输出作为你的可视化反馈接口。

操作说明

1. 将用户请求转换为 JSON 格式。可使用 batch 操作合并多个步骤。
2. 调用命令： python {baseDir}/scripts/cad_engine.py '' 从 stdout 读取返回的 JSON，查看生成对象的名称与包围盒信息。
3. 使用 inspect 操作可主动查询文档状态，且不进行任何修改。

规则

• 严禁自行生成 FreeCAD 代码
• 仅允许调用 CAD 引擎
• 必须始终传入结构化的 JSON 输入
• 对于复杂形状，应使用 batch 操作将其拆解为基本图元、变换操作与布尔运算的组合。

输出文件

• model.FCStd
• model.step

示例

创建一个基本图元： { "operation": "create_primitive", "parameters": { "type": "box", "length": 100, "width": 100, "height": 50, "name": "MyBox", "position": [0, 0, 0] } }

批量执行 CSG 运算（在长方体上开孔）： { "operation": "batch", "parameters": { "steps": [ { "operation": "create_primitive", "parameters": { "type": "box", "length": 50, "width": 50, "height": 10, "name": "BaseBox" } }, { "operation": "create_primitive", "parameters": { "type": "cylinder", "radius": 5, "height": 10, "name": "HoleCyl", "position": [25, 25, 0] } }, { "operation": "boolean", "parameters": { "type": "cut", "base": "BaseBox", "tool": "HoleCyl", "name": "ResultShape" } } ] } }

缩放操作： { "operation": "scale_object", "parameters": { "scale_factor": 0.8 } }