在 SolidWorks 里装一台会转的风扇:SolidWorks Automation Skill 装配体与 Motion Study 运动仿真实战
在 SolidWorks 里装一台会转的风扇:SolidWorks Automation Skill 装配体与 Motion Study 运动仿真实战
SolidWorks Automation Skill 是一个面向 AI Agent 的 SolidWorks 自动化工具包(AI Skill + MCP toolkit),把 SolidWorks 的 COM 自动化封装成可被脚本与 AI 客户端调用的能力。本文用它的装配体自动化与 Motion Study 运动仿真能力,带你用一段 Python 脚本自动建模 4 个零件、创建装配体配合、添加 60RPM 旋转马达,最终在 SolidWorks 里"装"出一台会转的迷你风扇。
上图是代码驱动 SolidWorks 的真实生成演示。风扇案例走的是同一条自动化链路:建模 → 装配 → 配合 → 运动算例 → 自动验收。
为什么用脚本装一台风扇
手工在 SolidWorks 里装一台会转的风扇,需要完成建模、装配、配合、新建运动算例、添加马达、计算播放一连串操作,步骤多且容易漏配。用脚本装,好处很直接:
- 🔄 一次运行、稳定复现:同样的输入跑多少遍都得到一致结果,方便回归与批量。
- 🧩 步骤封装:配合关系(Mate)、旋转自由度保留、马达参数都沉淀在封装函数里,不用手写底层 COM 调用。
- ✅ 自动验收:脚本会自检运动算例是否真的"算得出来、能播放",而不是只看到时间轴图标就交付。
项目把常用操作拆成了几个脚本:装配体与配合在 scripts/sw_assembly.py,运动算例与马达在 scripts/sw_motion.py,连接与基础工具在 scripts/sw_connect.py。完整示例见 examples/README.md。
案例拆解:一台迷你风扇的自动组装流程
核心示例是 examples/08_mini_fan_motion_assembly.py,它一次性跑通完整链路:
| 阶段 | 产物 | 关键动作 |
|---|---|---|
| ① 零件建模 | 4 个 .SLDPRT |
底座、立柱、叶轮、防护前盖 |
| ② 装配体 | 1 个 .SLDASM |
添加组件 + 重合/同心/距离 Mate |
| ③ 自由度控制 | — | 固定静止件,叶轮保留旋转自由度 |
| ④ Motion Study | 运动算例 + 马达 | 60RPM 匀速旋转马达,计算并播放 |
| ⑤ 自审查报告 | review 目录 |
验收通过才允许交付 |
第一步:自动生成 4 个零件
脚本用"草图 + 拉伸"生成 4 个零件,每个零件保存后关闭,避免打开的文档过多:
- 底座 base:矩形板 + 中心凸台,深灰色外观。
- 立柱 stand:中心圆轴,是叶轮旋转的"轴"。
- 叶轮 impeller:圆毂 + 十字叶片,蓝色外观,是唯一的旋转件。
- 前盖 front_guard:带十字防护筋的圆环盖。
示例以"稳定可运行"为目标,刻意使用矩形叶片等稳定几何;圆角/倒角这类美化不作为成功标准(边线自动选择在不同版本、语言下差异较大)。
第二步:装配体配合,保留旋转自由度
这是"会转"的关键。脚本为组件添加三类配合(Mate):
- 重合 Mate:底座与立柱的基准面贴合。
- 同心 Mate:轴/孔对齐。叶轮与立柱之间的同心配合特意设置
lock_rotation=False,保留绕轴旋转自由度;其余同心配合则锁定旋转。 - 距离 Mate:限制叶轮的轴向窜动。
配合完成后,脚本把底座、立柱、前盖固定,而叶轮保持浮动——这样叶轮既能绕轴转,又不会四处乱飞。
💡 常见坑:轻化/压缩组件会导致 GetModelDoc2() 返回空,做 Mate 前要先 resolve_component() 解析组件。详见 references/assembly.md。
第三步:Motion Study 运动算例与 60RPM 旋转马达
装配体就绪后,脚本创建真实运动算例并添加马达:
study = create_motion_study(asm, name="..._60RPM_loop", duration=4.0)
add_constant_speed_rotary_motor_by_cylinders(study, ..., rpm=60.0)
calculate_and_play(study, play=False)
audit = validate_motion_studies(asm, study_name="...", require_results=True)
其中 validate_motion_studies() 是验收门禁:它不仅检查马达是否存在、时长是否达标,还确认 GetResults() 能返回真实结果、结果不是过期状态。只有 validation.status == "pass" 才会进入交付。Motion Study 的 COM 细节(类型库、动态成员)已沉淀在 references/motion-study.md,也支持对已有装配体单独加马达(examples/07_motion_study_rotary_motor.py)。
如何运行风扇装配示例
运行前提:Windows + 已安装 SolidWorks(真机基线为 2024 / 2026)+ Python 3.10+,且已安装 pywin32。
git clone https://gitcode.com/gh_mirrors/so/solidworks-automation-skill
cd solidworks-automation-skill
pip install pywin32
启动 SolidWorks 后运行示例:
python examples/08_mini_fan_motion_assembly.py
运行结果会写入 C:\temp\solidworks_mini_fan_demo\,包含 4 个零件、mini_fan_motion_assembly.SLDASM 装配体、运动算例验收 JSON 和自审查报告。
想检查本机环境是否就绪,可运行
python scripts/cad_doctor.py,它会列出缺失项与可复制的安装命令。
相关文档与代码位置
- 风扇案例源码:examples/08_mini_fan_motion_assembly.py
- 装配体与配合参考:references/assembly.md
- Motion Study 与旋转马达参考:references/motion-study.md
- 能力清单(唯一真源):capabilities.yaml
- MCP Server(把装配 / Mate / 运动马达封装成 AI 工具):mcp-server/README.md
这台会转的迷你风扇只是起点——同一条"建模 → 装配 → 配合 → 运动仿真 → 自动验收"的链路,可以复用到电机、齿轮联动、铰链机构等更多运动型装配上。


