solidworks-automation-skill

SolidWorks Automation Skill

CAD Studio 桌面端与 Skill/CLI/MCP 是平级入口：这个仓库同时可以作为 Skill 包和 MCP Server 使用。Skill 适合导入支持 skills 的客户端，MCP 适合做本地工具连接；两者共用同一套能力和脚本。实际可执行范围以根目录 capabilities.yaml 为唯一真源；未验证能力不会被包装成已完成的无人值守交付。

可靠性边界：当前真机基线为 SolidWorks 2024、SolidWorks 2026 SP01.1 和 AutoCAD 2024。SolidWorks 2026 仅对能力清单中列出 2026 的能力视为已验证；SolidWorks 2025 及其余未回归能力仍是兼容性目标。配置族、钣金 U 型轮廓法兰/展开 DXF，以及 HSS 矩形焊接框架/切割清单已进入 pilot；设计表与复杂钣金/焊件仍是兼容目标。C# Add-in 宿主已在 SW2026 SP1.1 完成进程内 callback、应用事件、CommandGroup、TaskPane、PropertyManagerPage 和 JSON 诊断回归；正式部署必须使用 64 位 RegAsm /codebase /tlb。Simulation/FEA、Routing、复杂曲面和模具也处于受控 pilot 门禁，不能冒充原生完整交付。

下载与首次启动

三种入口互相独立，按使用习惯任选其一：

如果本机还没有 Smithery CLI，先安装一次：

npm install -g @smithery/cli

已能运行 smithery --version 的用户可跳过这一步。其他客户端可把命令中的 --client codex 替换为 --client claude、--client cursor、--client windsurf 等 Smithery 支持的目标。

Smithery 安装后，可在 MCP 客户端调用 solidworks_health_check 检查本机环境。使用 npx 或手动克隆的用户，也可以进入 Skill 目录执行诊断：

python scripts/cad_doctor.py
python scripts/cad_studio.py doctor

诊断结果中的 remediations 会列出缺失项、影响范围、官方地址和可复制的安装命令。缺少 SolidWorks/AutoCAD 时只阻断对应原生格式，STEP/IGES/BREP/STL/OBJ/GLB/DXF/SVG/PDF/PNG 等开放格式仍可继续。桌面端会在“设置”和“帮助”中显示相同建议。

需要提交问题时，再生成脱敏诊断包：

python scripts/cad_studio.py export-diagnostics --output .\cad-studio-diagnostics.zip

诊断包只包含版本、阶段、错误码和耗时等脱敏信息，不包含 Prompt、模型内容、API Key 或完整私人路径。

队列任务也可脱离桌面端操作：

python scripts/cad_studio.py status
python scripts/cad_studio.py run --enable-mock
python scripts/cad_studio.py retry <job-id>
python scripts/cad_studio.py cancel <job-id>
python scripts/cad_studio.py write-open-format --input .\part.cadstudio.json --out-dir .\output
python scripts/cad_studio.py preview-dxf --input .\drawing.dxf --output .\output\drawing.scene.json
python scripts/cad_studio.py check-dfm --input .\part.cadstudio.json --output .\output\dfm.json --profile .\supplier-profile.json
python scripts/cad_studio.py check-routing --input .\route.json --output .\output\routing_report.json
python scripts/cad_studio.py fea-preflight --solver auto
python scripts/cad_studio.py prepare-fea --input .\fea.json --out-dir .\output\fea
python scripts/cad_studio.py run-fea --input .\fea.json --out-dir .\output\fea --timeout 120
python scripts/cad_studio.py run-fea-convergence --input .\fea-convergence.json --out-dir .\output\fea-convergence --timeout-per-case 120
python scripts/cad_studio.py review-advanced-geometry --input .\surface-plan.json --output .\output\surface_report.json
python scripts/cad_studio.py create-ocp-loft --input .\loft.json --out-dir .\output\loft
python scripts/cad_studio.py create-ocp-surface --input .\smooth-loft.json --out-dir .\output\surface

English | 中文

CAD Studio 桌面版：下载、环境要求和完整操作流程见 CAD Studio 用户说明书。Windows 安装包与便携 ZIP 发布在 GitHub Releases。

中文

🎞️ 真机案例：复杂测试件工程图

这个案例不是概念动画：solidworks-engineering-drawing 在 SolidWorks 2026 SP01.1 中读取 NIST 公共领域复杂测试件，核对 141.421 × 141.421 × 17 mm 包围盒，并生成原生 SLDPRT + SLDDRW + PDF + evidence/review JSON。工程图包含三视图、等轴测图、A-A 剖视和 10 个必需尺寸；当前工程图定向测试为 70 项通过，实验产物的 PDF 可提取文字边界为 0 重叠。

工程图能力当前仍为 pilot。自动检查可以发现缺失输出和明显碰撞，但图框、尺寸链、孔表及制造语义仍要求工程师做最终目视复核。测试件来源为 NIST 公共领域资料，并非仓库自创的官方基准模型。

更多已验证案例

✨ 特性

• 🔧 零件建模 - 草图绘制、拉伸、旋转、倒角、圆角、阵列等
• ⚙️ 标准直齿轮（试点） - 真实渐开线采样齿廓、中心孔、齿宽、根切预警与 SolidWorks 2026 交付复核；实体建模与 Gear Mate 严格分路
• 🧭 多语言后端路由 - 按原子操作在 Python、C# PIA/Add-in、原生 C++、SWBasic、OCCT 和外部求解器之间选择，区分 Automation 等价语义与精确原生接口
• 🧩 C# Add-in 宿主（SW2026 已验证） - net48/x64 强名称程序集覆盖应用事件、三命令 CommandGroup、TaskPane、完整 PMP Handler 与 JSON 诊断；Machine /codebase /tlb 注册和真机 Probe 见 references/solidworks-addin-host.md
• 🧱 无 CAD 开放格式后端 - OCCT/OCP 隔离进程真实写入 STEP、IGES、BREP、STL、OBJ、GLB，二维后端写入 DXF、SVG、PDF、PNG；复杂特征按能力门禁阻断
• 🧠 VibeCAD 参数化规划 - 将自然语言需求转换为设计计划、制造规则检查、SolidWorks API 执行摘要和审查门禁
• 🧵 螺纹孔建模 - 攻丝底孔、M3/M4/M5/M6/M8 盲孔/通孔、孔口倒角、装饰螺纹与可见螺旋线兜底
• 🧾 AutoCAD / DWG 子技能 - DXF 无头预览与结构审查可用；AutoCAD 原生 DWG 绘图仍受本机 ActiveX 代理稳定性门禁，详见能力清单
• 🔄 签名自动更新 - Windows 桌面版启动后静默检查 GitHub Release，发现新版本后由用户确认下载和安装；失败时保留手动下载入口
• 🔩 装配体操作 - 添加组件、配合关系、干涉检查、爆炸视图
• 📐 工程图出图 - 三视图、剖视图、尺寸标注、BOM 表
• 🧾 工程图专业子技能 - solidworks-engineering-drawing 独立负责 GB/T 第一角工程图、尺寸链、孔表、BOM、PDF/BMP 证据和制造交付审视，可由根技能或任意相关子技能按需连接
• 💾 文件导出 - STEP、STL、IGES、PDF、DXF/DWG、Parasolid；SW2026 SP01.1 基础装配已通过原生 Pack and Go 连续回归，复杂引用缺失时仍按门禁生成带哈希清单的 pilot 暂存包
• 🧩 网格参考导入 - 将公开 GLB/OBJ/STL 外观参考模型缩放、转换并导入为 SolidWorks 参考零件
• 🎨 外观材质 - 文档、特征、组件级颜色设置，支持装配体分色建模
• 🎬 Motion Study - 自动创建运动算例、匀速旋转马达并计算/播放动画
• 🔌 MCP Server - 将 SolidWorks COM 自动化封装成 Codex / Claude / Cursor 可调用的本地 MCP 工具，覆盖基础建模、装配、Mate、外观、导出、审查和旋转马达
• 🔨 钣金设计（试点） - SW2026 已验证开放 U 型轮廓双折弯、板厚/半径/K 因子重开回读及含折弯线 DXF；复杂钣金仍需人工复核
• ⚡ 焊件设计（试点） - SW2026 已验证自定义 .sldlfp、四根 HSS 斜接框架、按长度/数量分组的原生切割清单及 CSV；回归数据来自 MIT 许可的 Coremark Weldment Profiles
• 📊 FEA 仿真（试点） - CalculiX 2.23 已真实求解线性静力、NLGEOM、受限塑性和双实体面接触样件，可解析最终步穿透/压力/滑移并执行线性或非线性网格收敛序列；结果统一保留人工复核，不等于安全认证
• 📝 配置与属性 - SW2026 已真机验证三配置创建/切换、配置尺寸/属性和保存重开；设计表仍按能力清单限制使用
• 🏭 DFM 制造复核（试点） - 机加工、钣金、激光切割和 3D 打印的结构化风险检查，支持供应商 profile 与 B-Rep 证据绑定；规则通过仍需人工确认
• 🧭 Routing 中性复核（试点） - 校验端点、分段、长度、弯曲半径、碰撞/间隙、支撑间距和 Routing BOM；未发现 Routing 加载项/许可证时原生写入保持 blocked
• 🧰 复杂曲面/模具（试点） - OCP 可真实生成并重开受限直纹/平滑 Loft、直线/圆弧 Sweep、闭壳 Knit 和开放面 Thicken；G1/G2 与局部曲率半径只代表离散采样证据，不替代全局无自交、Class-A 或模具设计
• 👀 结果自审查 - 导出多视角预览图、review_report.json 与 Markdown 摘要，帮助代理复核模型是否符合意图
• 🔎 API 查证优先 - 未封装接口先查官方 API Help / 本地 SDK，再实现、运行、自审查并沉淀

📋 环境要求

• 操作系统: Windows 10/11
• SolidWorks/AutoCAD: 原生格式操作需要合法安装；当前真机版本为 SolidWorks 2024/2026 和 AutoCAD 2024，具体能力以 capabilities.yaml 的版本字段为准
• Python: 3.10 或更高版本
• Windows 原生 CAD 依赖库: pywin32、comtypes
• 无头写入: 不要求安装 SolidWorks/AutoCAD；DXF 需要 ezdxf
• OCCT 几何后端: 安装 requirements-occt.txt 后启用 STEP/IGES/BREP/GLB 和布尔孔切除
• 开放 FEA: CalculiX 可作为外部 GPL 求解器放在 D/E 盘；程序不会把其二进制打包进 MIT 发布物
• 工程图最终审查依赖: PyMuPDF，用于读取 SolidWorks 导出 PDF 的实际尺寸文字边界；已包含在 requirements.txt
• 网格转换可选依赖: trimesh、pygltflib、numpy、Pillow

运行前可执行 python scripts/sw_preflight.py。如果缺少 comtypes / win32com，脚本会先询问是否授权 AI 自动配置本地环境；如果未检测到 SolidWorks，会直接停止并提示先手动安装 SolidWorks。

缺少环境时去哪下载

安装依赖后重新运行 python scripts/cad_studio.py doctor。不要为了补齐可选环境一次性安装全部依赖；工程图交付除外，它要求 requirements.txt 中的 PyMuPDF。

🚀 快速开始

方式一：Skill 安装（推荐给支持 skill 的客户端）

npx github:wzyn20051216/solidworks-automation-skill

如果客户端支持直接导入 skill，也可以使用：

claude skill add https://github.com/wzyn20051216/solidworks-automation-skill

方式二：Smithery 安装 MCP

npm install -g @smithery/cli
smithery mcp add wzyn20051216/solidworks-automation-skill --client codex --config '{}'

如果已经安装 Smithery CLI，第一行可以跳过。wzyn20051216/solidworks-automation-skill 是 Smithery 上的本地 stdio MCP 包；不要用 server.smithery.ai/... URL 安装这个包。

Codex 以外的客户端可把 --client codex 改为 Smithery 支持的目标，例如 claude、cursor、vscode、windsurf 或 opencode。

安装后如果客户端已经打开，建议重启对应客户端；部分客户端首次加载本地 MCP 时可能还需要在界面中确认信任。

方式三：OpenClaw / 龙虾 使用

OpenClaw 兼容本 skill 的 SKILL.md + scripts/ + references/ 目录结构。推荐把技能放在以下任一目录：

~/.openclaw/skills/solidworks-automation/
~/.agents/skills/solidworks-automation/

安装后，可直接在 OpenClaw 中使用自然语言驱动 SolidWorks，例如：

用 SolidWorks 新建一个 120x80x10 mm 的安装板，四角各打一个 phi6 孔，保存到 C:\temp\plate.sldprt，并导出 STEP 到 C:\temp\plate.step

OpenClaw 侧的接入约定、执行模板与排障说明见：

references/openclaw.md

方式四：手动克隆

1. 克隆仓库

git clone https://github.com/wzyn20051216/solidworks-automation-skill.git
cd solidworks-automation-skill

2. 安装当前任务需要的依赖

python -m pip install -r requirements.txt

如果需要处理 GLB/GLTF/OBJ/STL 等公开网格参考模型，并进行包围盒检查、尺度缩放或格式转换，额外安装：

python -m pip install -r requirements-mesh.txt

3. 诊断环境

python scripts/cad_studio.py doctor

4. 运行示例

确保 SolidWorks 已经运行,然后执行: