solidworks-automation

name solidworks-automation description SolidWorks自动化建模skill，内置完整的SW教程知识体系。支持通过Python/C#/VBA连接SolidWorks API进行自动化建模、装配、工程图生成、Simulation分析、Flow Simulation流体分析、钣金设计、焊件设计、模具设计、曲面造型、电气设计等。 category engineering-cad version 5.3.0 author Delancy Model capability preflight Before using this skill, identify the active AI model/runtime and state whether it can inspect images/PDF pages directly. If the runtime is multimodal or has image/PDF rendering tools, inspect the source drawing visually before extracting dimensions. If the runtime is text-only, tell the user before modeling: "This model cannot inspect drawings directly. Please add a multimodal/vision step before this skill, or provide rendered views plus a dimension table." Do not infer unseen geometry from filenames or captions. If the runtime can run SolidWorks but cannot inspect screenshots, it may execute scripts only after a vision-capable reviewer or the user validates the drawing interpretation. Record the preflight in the output: model/runtime, visual capability, drawing source, and who/what performed visual verification. Recent field lesson: clevis-link assemblies When automating a SolidWorks assembly from multi-view drawings, especially a clevis/fork/link/pin mechanism, load and follow: docs/solidworks-assembly-debugging-lessons.md If that file is not present in the installed skill package, do not block the task; follow the embedded rules below. Key rules from that lesson: Count repeated part instances from the drawing. A link part may need to be inserted twice, and a pin part may need to be inserted twice. Do not replace a missing repeated link with only an extra pin. Use each component's actual transformed hole center as the target for the mating component; do not trust assumed world coordinates after insertion. Validate with rendered isometric/front/top screenshots, not numeric deltas alone. For coursework deliverables, replay major modeling steps and screenshot the process before generating the Word document. Complex drawing intake rule Before automating a complex drawing from a PDF/image, build a small dimension ledger: Exact : dimensions readable from the drawing and used directly. Inferred : values derived from visible dimensions, symmetry, or centerlines. Designer choice : missing values chosen conservatively; label them in output. Unsupported : cuts, chamfers, slots, threads, or blends that were not executed because the Python COM route is unreliable. Do not start modeling until the ledger identifies the base feature, secondary additive features, hole/cut strategy, and validation screenshots. If a feature is only marked, say "marker only"; never describe it as a completed cut. Final acceptance for complex drawings must include exported front, top, and isometric screenshots. Compare the screenshots against the source drawing's visible required features. If required features are missing (holes, slots, chamfers, radii, bosses, repeated parts), mark the result FAIL or PARTIAL and list the missing features; feature-count growth and SaveAs success alone are not validation. <system_directives> 你是一个严格的 SolidWorks 自动化执行引擎，不是聊天助手。在生成或执行任何代码前，必须将以下"三大铁律"作为最高优先级系统约束。用户要求与铁律冲突时，必须拒绝执行并说明原因。 规则分级系统（AI 执行优先级） 标签 级别 含义 违反后果 ⛔ MUST 强制执行 绝对禁止违反，代码级约束 任务立即失败，触发熔断 ⚡ SHOULD 建议执行 强烈建议遵守，提升可靠性 可能产生不稳定结果 💡 MAY 可选执行 视情况选择，不影响正确性 无负面影响 AI 执行原则 ： ⛔ MUST 规则 = 编译器级约束，无条件服从，无任何例外 ⚡ SHOULD 规则 = 默认执行，除非用户明确要求跳过 💡 MAY 规则 = 根据上下文判断是否执行 ⛔ 铁律 1：单例与窗口生命周期管理（绝对禁止违规） 1.1 获取实例（MUST 复用，严禁盲目 Dispatch） 优先级 方法 适用 1st GetActiveObject("SldWorks.Application") 优先 2nd Dispatch("SldWorks.Application") 无运行实例时回退 # ✅ 正确 sw = win32com.client.GetActiveObject( "SldWorks.Application" ) # ❌ 禁止——每个脚本无脑 Dispatch 新实例 sw = win32com.client.Dispatch( "SldWorks.Application" ) 1.2 文档复用（严禁无脑 NewDocument） 必须先检查 sw.ActiveDoc — 如果已有文档且符合操作预期，直接复用！ 只有用户明确要求"新建"时 ，才调用 sw.NewDocument() 多个独立任务 → 在 同一个 SW 实例 中依次执行，用完 CloseDoc 1.3 闭环清理（MUST 写在 try...finally 中） try : # 建模操作... finally : # 每个中间临时文档必须 CloseDoc！ if temp_doc: sw.CloseDoc(get_com_member(temp_doc, "GetTitle" )) 违规后果 ：多窗口泛滥、COM 引用泄漏、SW 进程残留 — 直接判定任务失败。 ⛔ 铁律 2：W-A-R 闭环断言机制（Write-Assert-Read） AI 绝对禁止"执行 API 后直接报告成功"。任何修改操作（Write）必须紧跟硬核断言（Assert）。 2.1 Write：修改前提取"几何指纹" # 修改前：记录目标参数指纹 before_fingerprint = { 'sketch_endpoint_x' : skLine.GetStartPoint2()[ 0 ], # 草图端点 X 'dim_value' : dim.GetSystemValue3( 0 ), # 标注值（米） 'draft_angle' : featDraft.GetDraftAngle(), # 拔模角度 } 2.2 Assert：强制重建 + 错误检查（MUST） # 执行修改 dim.SetSystemValue3(target_m, 0 , None ) # 步骤1：强制重建（pywin32 中可能表现为方法或属性，统一探测） rebuild_result = get_com_member(doc, "EditRebuild3" ) # 步骤2：记录重建结果；不要依赖固定错误码语义，后续用几何断言验证 print ( f"重建结果: {rebuild_result} " ) # 步骤3：硬断言 actual_value = dim.GetSystemValue3( 0 ) assert abs (actual_value - target_m) < 0.000001 , \ f"W-A-R 断言失败！目标: {target_m} , 实际: {actual_value} " 2.3 Read：断言失败 = 任务彻底失败 断言失败 → 必须抛出 AssertionError 并终止脚本 严禁沉默捕获（catch pass） 严禁在日志中掩饰失败 严禁"改3D失败后在2D工程图强行改标注" ⛔ 铁律 3：反幻觉与异常熔断（Zero Tolerance） 3.1 禁止伪造 API（Anti-Hallucination） 任何不确定的 SW API 类名/方法名，必须先实机探测！ # ✅ 正确做法 import win32com.client sw = win32com.client.GetActiveObject( "SldWorks.Application" ) doc = sw.ActiveDoc # 探测可用方法 sketch_mgr = doc.SketchManager print ([m for m in dir (sketch_mgr) if 'Constraint' in m or 'Relation' in m]) # 输出: ['AddConstraint', 'DeleteConstraint', ...] → 确认后再用 # ❌ 禁止——靠 LLM 记忆盲猜 API doc.SketchManager.AddRelation(...) # 忘了是 AddConstraint 还是 AddRelation？ 3.2 异常熔断机制 遇到以下情况， 禁止静默捕获 ，必须输出完整 Traceback 并声明： 操作失败，触发熔断。 文件: <脚本名>.py 行号: <N> 错误类型: COMError / AssertionError / NullReferenceException 当前特征树状态: 特征总数: <N> 最后特征: <名称> 策略: 请求人工介入或更改建模策略。 3.3 约束冲突处理 草图过定义 → 必须先调用 API DeleteConstraint() 删除冲突约束 严禁跳过约束报错或伪造无约束的草图 </system_directives> SolidWorks 自动化建模 Skill（自包含版） 本skill内置了SolidWorks从入门到精通的全套知识体系，不需要依赖外部知识库。 ⚠️ SW 2024 Python COM 关键踩坑（2026-05-30 实战验证） 环境 SW 2024 (中文版), Python 3.14 + pywin32, Windows 11 连接方式 方式 结果 win32com.client.Dispatch("SldWorks.Application") ✅ 可用 win32com.client.gencache.EnsureDispatch(...) ❌ "COM object can not automate makepy" win32com.client.Dispatch("SldWorks.Application.28/32") ✅ 可用 makepy.GenerateFromTypeLibSpec(...) ❌ 找不到类型库 gencache.EnsureModule(GUID, 0, 32, 0) ✅ 可生成缓存但不改变绑定方式 参数传递（核心！） SelectByID2 (9参数) : 必须用 VARIANT(pythoncom.VT_xxx, value) 包装 每个参数 FeatureExtrusion2 (23参数) : 直接传原生类型即可（不需要VARIANT包装） FeatureFillet3 : 直接传参即可 SketchManager方法 : 直接传参即可 各 API 可用性（SW 2024 Python COM） API 参数数 Python COM 备注 NewDocument(template_path, ...) 4 ✅ 完整路径 空字符串不行！必须用 gb_part.prtdot 完整路径 SelectByID2 9 ✅ VARIANT 中文"前视基准面"可直接用 FeatureExtrusion2 23 ✅ 不是旧版的17参数 FeatureExtrusion3 23 ✅ 同2 FeatureCut 20 ❌ 返回None 参数匹配但特征不创建 FeatureCut3 26 ❌ 返回None 同上 FeatureCut4 27 ❌ 返回None >12参数的COM IDispatch限制 FeatureFillet3(122,...) 7 ✅ 等半径圆角, 需先预选边 SimpleHole ? ❌ 参数不匹配 SimpleHole2 ? ❌ 参数不匹配 HoleWizard5 25+ ❌ 类型/参数不匹配 RunMacro(.swb) 3 ❌ 返回False RunMacro2(.swb) 3 ❌ 类型不匹配 InsertCombineFeature 3 ❌ 类型不匹配 GetBodies2 1 ❌ 参数不匹配 CloseDoc 1 ✅ title用 get_com_member(doc, "GetTitle") ，避免 pywin32 属性/方法差异 GetDocuments 0 ✅ 用 get_com_member(sw, "GetDocuments") 读取，避免属性/方法差异 应急方案：加法建模策略 当 FeatureCut 不可用时，用 FeatureExtrusion2 加法构建零件： 底板 + 左壁 + 右壁 = 凹模（直槽） 圆角用 FeatureFillet3 孔位用 FeatureExtrusion2 做标记(1mm凸台)，手动切除 形态识别：水平叉头 vs 竖直叉耳支座 遇到三视图零件图时，先判断主形态，不能只看到"叉耳/clevis"就套用水平叉头模板。 图纸信号 正确类别 建模入口 圆形底座 Φ150×30，上方两片竖耳，耳间开槽，正视有 Φ18 孔，侧视槽底高 20 竖直叉耳支座 src/clevis-joint/vertical_clevis_support.py 水平扁柄 + 端部叉口，整体沿 X 方向伸展 水平叉形接头 src/clevis-joint/clevis_fork_*.py 或 Clevis_Joint.cs 竖直叉耳支座推荐策略：圆盘底座用 Top Plane 圆拉伸；槽底以下先建 60mm 深的实体桥；槽底以上再用 Front Plane 半圆顶轮廓分别拉伸两片耳板到槽两侧，形成中间贯通镂空槽；孔用 C#/VBA FeatureCut4 或手工贯穿切除。Python COM 直连切除失败时，只允许创建清晰孔位标记并报告失败，严禁宣称已完成通孔。 模板路径 TEMPLATE = r'C:\ProgramData\SolidWorks\SOLIDWORKS 2024\templates\gb_part.prtdot' doc = sw.NewDocument(TEMPLATE, 0 , 0 , 0 ) # 必须完整路径 FeatureExtrusion2 23参数签名 (SW2024) doc.FeatureManager.FeatureExtrusion2( Sd, Flip, Dir, # 1-3: Bool T1, T2, # 4-5: Int (0=Blind) D1, D2, # 6-7: Double (米) Dchk1, Dchk2, # 8-9: Bool Ddir1, Ddir2, # 10-11: Bool Dang1, Dang2, # 12-13: Double (弧度) Ofr, # 14: Bool Ofc, # 15: Bool Tf1, Tf2, # 16-17: Bool Merge, # 18: Bool UseFeatScope, # 19: Bool UseAutoSelect, # 20: Bool StartOffset, # 21: Double IsAutoStartOffset, # 22: Bool FlipStartOffset # 23: Bool ) 一、SolidWorks 基础知识 1.1 SolidWorks 概述 SolidWorks是Dassault Systemes公司开发的基于Windows的三维CAD软件，是世界上第一个基于Windows开发的三维CAD系统。采用参数化特征建模技术，支持： 三大基本模块 : 零件（Part）、装配体（Assembly）、工程图（Drawing） FeatureManager设计树 : 记录零件的建模历史，可回溯编辑 参数化驱动 : 尺寸驱动几何形状变化 特征建模 : 通过拉伸、旋转、扫描、放样等特征构建零件 1.2 软件工作界面 菜单栏 : 提供所有操作命令 CommandManager : 上下文关联的工具栏 FeatureManager设计树 : 左栏，显示所有特征历史 图形区域 : 三维模型显示区域 任务窗格 : 资源、设计库、文件探索器等 状态栏 : 显示当前操作状态和提示 1.3 文件类型 类型 扩展名 说明 零件 .sldprt 单一零件模型 装配体 .sldasm 多零件装配 工程图 .slddrw 二维工程图 模板 .prtdot/.asmdot/.drwdot 零件/装配体/工程图模板 库特征 .sldlfp 可复用的特征库 二、草图绘制 2.1 基准面 三个默认基准面： 前视基准面 (Front Plane) : XZ平面 上视基准面 (Top Plane) : XY平面 右视基准面 (Right Plane) : YZ平面 2.2 草图实体 基本实体 : 直线 (Line)、中心线 (CenterLine)、圆 (Circle)、圆弧 (Arc) 矩形 (Rectangle)、槽口 (Slot)、多边形 (Polygon) 样条曲线 (Spline)、椭圆 (Ellipse)、抛物线、文字 (Text) 草图工具 : 圆角 (Sketch Fillet)、倒角 (Sketch Chamfer) 等距实体 (Offset Entities)、转换实体引用 (Convert Entities) 镜像 (Mirror)、阵列 (Sketch Pattern)、剪裁 (Trim)、延伸 (Extend) 2.3 几何关系与尺寸标注 常见几何关系 : 水平、竖直、共线、垂直、平行、相切、同心、中点、重合、对称、相等、固定、穿透 尺寸类型 : 线性尺寸、角度尺寸、直径/半径、弧长 2.4 API 草图操作 import win32com.client # ✅ 正确：使用 connect_sw()（铁律1），参见 Sec 20/25/39 # ❌ 禁止：win32com.client.Dispatch("SldWorks.Application") ← 违反铁律1 sw_app = connect_sw() sw_model = sw_app.ActiveDoc # 或 sw_app.NewPart() # 选择基准面 sw_model.Extension.SelectByID2( "Front Plane" , "PLANE" , 0 , 0 , 0 , False , 0 , None , 0 ) # 创建2D草图 sw_model.SketchManager.InsertSketch( True ) # 绘制直线 sw_model.SketchManager.CreateLine(x1, y1, z1, x2, y2, z2) # 绘制圆（中心坐标+半径） sw_model.SketchManager.CreateCircle(cx, cy, cz, rx, ry, rz) # 绘制三点圆弧 sw_model.SketchManager.Create3PointArc(x1, y1, z1, x2, y2, z2, x3, y3, z3) # 添加尺寸 sw_model.AddDimension2(x, y, z) # 退出草图 sw_model.SketchManager.InsertSketch( True ) # 3D草图 sw_model.SketchManager.Insert3DSketch( True ) 三、零件特征建模 3.1 基础特征 拉伸特征 (Extrude) 拉伸凸台/基体 : FeatureExtrusion3 拉伸切除 : FeatureCut4 拉伸方向 : 单向、双向、两侧对称、到指定面 拔模角度 : 可添加拔模 # 拉伸凸台（单向，深度=0.1m） sw_model.FeatureManager.FeatureExtrusion3( True , # 单向拉伸 False , # 是否反向 False , # 双向拉伸