| name | fdm-3d-print-agent |
| description | FDM 3D打印智能体；验证模型可打印性(壁厚/悬垂/桥接/流形)、通过Blender参数化修改与导出STL/3MF、母版模板快速生成。触发词：3D打印、FDM、STL验证、壁厚检查、悬垂检测、模型修复、参数化建模、Blender导出、母版生成、打印可行性、切片前检查。 |
| dependency | {"python":["numpy>=1.24.0","trimesh>=4.0.0","scipy>=1.10.0"],"system":["blender>=3.0"]} |
FDM 3D打印智能体
核心流程
用户输入 → 分类路由 → FDM规则验证 → CAD修改/母版生成 → 导出STL/3MF → 完成
1. 模型分类路由
调用 scripts/model_analyzer.py 判断工程件/艺术件，决定路由到 Blender 还是生成 Fusion 360 脚本。
python scripts/model_analyzer.py --input <file> --user-hint "<描述>"
输出: {"type": "engineering"|"artistic", "confidence": 0.0-1.0, "reason": "..."}
- 工程件 → Blender 参数化修改 或 生成 Fusion 360 Add-In 脚本
- 艺术件 → Blender 修改器处理
2. FDM 规则验证
调用 scripts/fdm_rules.py 执行可打印性检查：
python scripts/fdm_rules.py --input <mesh_file> --check-all --tolerance-type <tight|sliding>
| 检查项 | 阈值 | 严重级别 |
|---|
| 壁厚 | ≥1.2mm(强制) / ≥2.0mm(推荐) | error/warning |
| 悬垂角 | ≤45° | warning |
| 桥接跨度 | ≤10mm(PLA) | warning |
| 流形性 | 水密 | error |
| 公差 | 0.15mm(紧密) / 0.3mm(活动) | 参考 |
也可单独检查: --check-wall, --check-overhang, --check-bridge, --check-manifold
3. CAD 修改与导出
Blender 驱动 (推荐)
python scripts/blender_driver.py --input <file> --modifier <SOLIDIFY|BOOLEAN|REMESH|BEVEL|REPAIR> --output <path> --format <STL|3MF|OBJ>
| 修改器 | 关键参数 | 用途 |
|---|
| SOLIDIFY | --thickness | 加薄壁 |
| BOOLEAN | --operation UNION/DIFFERENCE/INTERSECT --object1 --object2 | 布尔运算 |
| REMESH | --voxel-size | 重网格化 |
| BEVEL | --width --segments | 倒角(减少悬垂) |
| REPAIR | (无额外参数) | 自动修复非流形边+孔洞 |
导出前自动检测流形性，REPAIR 模式自动修复。
Fusion 360 脚本生成
python scripts/fusion360_driver.py --action generate-script --script-type <get_parameters|set_parameter|export_stl> --param-name <name> --param-value <value>
生成 Fusion 360 Add-In 脚本（使用 adsk.core/adsk.fusion API），用户需在 Fusion 360 内执行。
不支持 COM 直接调用——Fusion 360 无 COM ProgID。
4. 母版模板快速生成
python scripts/master_model_manager.py --action <list|load|set-param|validate|generate-spec|generate-script> --template <name> --params-json '{"width":40}'
内置模板: box, cylinder, gearbox, enclosure, vase
用户自定义模板放入 assets/templates/ (JSON 格式，参见该目录 README.md)。
5. 专用生成器
python scripts/generate_mic_handle.py --mic-width 30 --mic-depth 20 --tolerance 0.15 --output <path>
麦克风把手生成器，所有尺寸可参数化。
资源索引
脚本
参考
资产
注意事项
- Blender 驱动需
blender 已加入系统 PATH
- Fusion 360 驱动生成的是 Add-In 脚本，需在 Fusion 内部执行（非 COM）
- 导出前务必执行 FDM 规则验证
- 非流形几何 → 使用
--modifier REPAIR 自动修复
- 3MF 导出需 Blender 启用 3MF 插件（Edit → Preferences → Add-ons）
- 大尺寸模型(>500mm)需特殊打印考虑，验证器会发出 warning
