在 SolidWorks 里装一台会转的风扇:SolidWorks Automation Skill 装配体与 Motion Study 运动仿真实战

原创2026-10-14 20:53:481,722 阅读
文章标签:AI 技能MCP 服务工业制造桌面应用3D建模CLIAI 应用

在 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 零件与工程图

上图是代码驱动 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 目录 验收通过才允许交付

CAD Studio 本地工作台:SolidWorks 装配体与建模项目的管理工作流

第一步:自动生成 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)。

SolidWorks 自动化工作台桌面端界面:装配体任务、复核状态与交付管理

如何运行风扇装配示例

运行前提: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,它会列出缺失项与可复制的安装命令。

相关文档与代码位置

这台会转的迷你风扇只是起点——同一条"建模 → 装配 → 配合 → 运动仿真 → 自动验收"的链路,可以复用到电机、齿轮联动、铰链机构等更多运动型装配上。

登录后查看全文
solidworks-automation-skill