SolidWorks Automation Skill

CAD Studio 桌面端与 Skill/CLI/MCP 是平级入口：既可通过 Python COM 控制本机 SolidWorks/AutoCAD，也可在没有 CAD 软件时使用无头后端写入开放格式。实际可执行范围以根目录 capabilities.yaml 为唯一真源；未验证能力不会被包装成已完成的无人值守交付。

可靠性边界：当前真机基线为 SolidWorks 2024、SolidWorks 2026 SP01.1 和 AutoCAD 2024。SolidWorks 2026 仅对能力清单中列出 2026 的能力视为已验证；SolidWorks 2025 及其余未回归能力仍是兼容性目标。配置/设计表、钣金和焊件仍为参考或兼容目标；Simulation/FEA、Routing、复杂曲面和模具已进入受控 pilot 门禁，但不能冒充原生完整交付。

下载与首次启动

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

入口	适合用户	下载/安装
Skill / CLI / MCP	已在使用 Codex、Claude Code、Gemini CLI、OpenCode 或 OpenClaw	npx github:wzyn20051216/solidworks-automation-skill，也可手动克隆本仓库
CAD Studio 桌面版	希望用图形界面管理项目、对话、任务、预览和交付	从 GitHub Releases 下载 Windows 安装包或便携 ZIP

安装 Skill 后，进入 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。

---

中文

✨ 特性

• 🔧 零件建模 - 草图绘制、拉伸、旋转、倒角、圆角、阵列等
• 🧱 无 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 代理稳定性门禁，详见能力清单
• 🔩 装配体操作 - 添加组件、配合关系、干涉检查、爆炸视图
• 📐 工程图出图 - 三视图、剖视图、尺寸标注、BOM 表
• 💾 文件导出 - 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、外观、导出、审查和旋转马达
• 🔨 钣金设计（参考） - 文档与 API 路由已整理，当前不承诺无人值守交付
• ⚡ 焊件设计（参考） - 结构构件与切割清单尚无稳定回归执行器
• 📊 FEA 仿真（试点） - CalculiX 2.23 已真实求解线性静力、NLGEOM、受限塑性和双实体面接触样件，可解析最终步穿透/压力/滑移并执行线性或非线性网格收敛序列；结果统一保留人工复核，不等于安全认证
• 📝 自定义属性 - 文件属性读写可用；配置/设计表按能力清单限制使用
• 🏭 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 发布物
• 网格转换可选依赖: trimesh、pygltflib、numpy、Pillow

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

缺少环境时去哪下载

环境	什么时候需要	官方地址或安装命令
Python 3.10+	所有本地 Skill/CLI 工作流	Python for Windows 或 winget install -e --id Python.Python.3.12
pywin32 / comtypes	SolidWorks、AutoCAD COM 原生自动化	python -m pip install "pywin32>=305" "comtypes>=1.2.0"
ezdxf	DXF 无头读写、图层和实体检查	python -m pip install "ezdxf>=1.3,<2"
OCP / OCCT	STEP、IGES、BREP、GLB 无头几何写入	python -m pip install -r requirements-occt.txt
PyMuPDF	PDF 预览与矢量文字复核	python -m pip install -r requirements-pdf.txt
CalculiX	开放 FEA 求解	CalculiX 官方站；解压到 D/E 盘后设置 CADSTUDIO_CALCULIX_EXE 指向 ccx.exe
Agent CLI	AI 对话与任务执行，安装任意一个即可	Codex / Claude Code / Gemini CLI / OpenCode
SolidWorks	SLDPRT/SLDASM/SLDDRW 原生格式	SolidWorks 官方站；需要合法安装与可用许可
AutoCAD	原生 DWG 后端	AutoCAD 官方站；需要合法安装与可用许可

安装依赖后重新运行 python scripts/cad_studio.py doctor。不要为了补齐可选环境一次性安装全部依赖；只安装当前任务需要的后端即可。

🚀 快速开始

方式一：npx 一键安装（推荐）

npx github:wzyn20051216/solidworks-automation-skill

自动下载并安装到 Claude/Codex/OpenClaw 等已检测到的 skills 目录，并自动尝试把 SolidWorks MCP 注册到 Codex、Claude Code、Claude Desktop、Cursor、Windsurf 等本地 AI 客户端。

安装后如果客户端已经打开，建议重启对应客户端；部分客户端首次加载本地 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

方式三：Claude CLI 安装

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

方式四：手动克隆

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 已经运行,然后执行:

import sys
sys.path.insert(0, r"./scripts")

from sw_preflight import run_preflight
from sw_connect import connect_solidworks, mm, deg, new_document
from sw_part import start_sketch, sketch_rectangle, end_sketch, extrude_boss

run_preflight()

# 连接 SolidWorks
sw, model = connect_solidworks()

# 创建新零件
model = new_document(sw, "part")

# 在前视基准面上绘制矩形
start_sketch(model, "Front Plane")
sketch_rectangle(model, 0, 0, mm(50), mm(30))
end_sketch(model)

# 拉伸 10mm
extrude_boss(model, "Sketch1", mm(10))

print("零件创建完成!")

📚 文档结构

solidworks-automation-skill/
├── scripts/              # Python 脚本模块
│   ├── sw_session.py    # 友好会话 API
│   ├── sw_preflight.py  # 运行前自检、依赖补齐、SolidWorks 检测
│   ├── sw_macro_guard.py # 多模型 Prompt、VBA 校验、重试与模板兜底
│   ├── sw_connect.py    # 连接与文档管理
│   ├── sw_appearance.py # 外观与材质
│   ├── sw_part.py       # 零件建模
│   ├── sw_assembly.py   # 装配体操作
│   ├── sw_motion.py     # Motion Study 与旋转马达
│   ├── sw_drawing.py    # 工程图
│   ├── sw_export.py     # 文件导出
│   └── sw_review.py     # 多视角预览与自审查报告
├── references/          # API 参考文档
│   ├── openclaw.md
│   ├── appearance.md
│   ├── review.md
│   ├── api-lookup.md
│   ├── part-modeling.md
│   ├── assembly.md
│   ├── motion-study.md
│   ├── drawing.md
│   ├── export.md
│   ├── advanced.md
│   └── troubleshooting.md
├── subskills/           # 专项子技能矩阵
│   ├── solidworks-vibecad/              # 自然语言 -> 参数化设计计划
│   ├── solidworks-fillet-chamfer-cnc/   # CNC 多圆角/倒角机加工件
│   ├── solidworks-threaded-holes/       # 螺纹孔、攻丝底孔和孔口倒角
│   └── autocad-automation/              # AutoCAD DWG/DXF 二维绘图和线稿矢量化
├── docs/                # 产品化、市场调研和技能地图
│   ├── market-research-2026.md          # 市场调研与产品定位
│   ├── product-mvp-spec.md              # 本地桌面软件 MVP 规格
│   └── skill-map.md                     # 技能矩阵和路由说明
├── apps/                # 产品化应用
│   ├── desktop/                         # PySide6 本地桌面软件原型
│   └── workbench-ui/                    # React + Motion 高质感前端界面原型
├── examples/            # 示例代码
├── mcp-server/          # 本地 stdio MCP Server
├── SUBSKILLS.md         # 多子技能索引和路由说明
└── README.md

🖥️ CAD Studio 桌面软件

正式桌面端位于 apps/workbench-ui/，采用 React + Tauri。它与 Skill/CLI/MCP 共用任务协议、能力清单和证据系统，不是 Skill 的必需前置。没有 CAD 软件时可选择无头开放格式后端；需要 SLDPRT/SLDASM/SLDDRW/DWG 时再路由到对应原生后端。

开发预览：

cd apps/workbench-ui
npm install
npm run dev

构建 Windows 安装包：

cd apps/workbench-ui
npm ci
npm run desktop:bundle

安装包内置运行所需的 skill、脚本和规范文档，但真实 CAD 自动化仍需要用户合法安装 Python、对应 Agent CLI、SolidWorks 或 AutoCAD。完整说明见 用户说明书。

🧩 子技能矩阵

本仓库按“大仓库 + 多子技能”的方式组织。根技能提供 SolidWorks COM 连接、文档管理、建模 API、导出、自审查和 MCP Server；专项能力放在 subskills/ 下，每个子技能自包含 SKILL.md、README.md、manifest.yaml、脚本和实测参考。

子技能	状态	用途
solidworks-vibecad	experimental	自然语言需求 -> 参数化设计计划、制造规则检查、执行摘要、审查门禁
solidworks-fillet-chamfer-cnc	stable	CNC 安装座、连接块、支架、多圆角/倒角、孔槽和减重口袋
solidworks-threaded-holes	stable	M3-M12 螺纹孔、攻丝底孔、孔口倒角、螺纹属性和 STEP 输出
autocad-automation	verified / pilot / blocked	DXF 无头预览与结构审查；AutoCAD 2024 .NET 白名单后端须经最近连续三次证据复验后为 verified；COM 原生写入仍受门禁

更多路由说明见 SUBSKILLS.md。

🔌 MCP Server

本仓库包含一个本地 stdio MCP Server，可让 Codex / Claude Code / Claude Desktop / Cursor / Windsurf 等 MCP 客户端通过工具调用 SolidWorks：

pip install -r mcp-server\requirements.txt
python mcp-server\server.py

推荐使用多客户端注册器：

powershell -ExecutionPolicy Bypass -File .\mcp-server\register_all_ai_mcp.ps1 -InstallDependencies
codex mcp list
claude mcp list

该注册器会自动尝试：

• Codex：调用 codex mcp add
• Claude Code：调用 claude mcp add --scope user
• Claude Desktop：写入 claude_desktop_config.json
• Cursor：写入 ~/.cursor/mcp.json
• Windsurf：写入 ~/.codeium/windsurf/mcp_config.json

通过 npx github:wzyn20051216/solidworks-automation-skill 安装时会自动运行注册器。若使用某些客户端的纯 skill 导入功能，客户端可能不会执行安装脚本，此时让 AI 运行上面的注册命令即可。

客户端手动配置示例：

{
  "mcpServers": {
    "solidworks": {
      "command": "python",
      "args": [
        "C:\\path\\to\\solidworks-automation-skill\\mcp-server\\server.py"
      ]
    }
  }
}

第一阶段已暴露 solidworks_connect、solidworks_open_document、solidworks_save_document、solidworks_export_active、solidworks_review_active、solidworks_add_rotary_motor 等工具。CAD Studio 侧还暴露 cadstudio_write_open_format、cadstudio_check_dfm、cadstudio_check_routing、cadstudio_fea_preflight、cadstudio_prepare_fea 和 cadstudio_review_advanced_geometry。更多说明见 mcp-server/README.md。

当前 MCP 还包含 solidworks_health_check、solidworks_create_basic_part、solidworks_add_component、solidworks_add_coincident_mate、solidworks_add_distance_mate、solidworks_add_concentric_mate、solidworks_set_component_fixed、solidworks_set_appearance 等基础工具。复杂圆角/倒角仍建议作为后续专项优化，不作为基准 demo 的成功标准。

🎯 使用示例

推荐写法：Session API

import sys
sys.path.insert(0, r"./scripts")

from sw_preflight import run_preflight
from sw_connect import mm
from sw_part import sketch, sketch_circle, extrude_boss
from sw_session import SolidWorksSession

run_preflight()
session = SolidWorksSession()
model = session.new_part()

with sketch(model, "Front Plane") as sketch_name:
    sketch_circle(model, 0, 0, mm(25))

extrude_boss(model, sketch_name, mm(50))
session.save(model, r"C:\temp\cylinder.sldprt")
session.export(model, r"C:\temp\cylinder.step")

多模型 VBA 宏防护

当需要由 GPT / Kimi / Claude 生成 SolidWorks VBA 宏时，先使用 sw_macro_guard.py 统一处理格式差异：

from sw_macro_guard import build_prompt, fallback_macro_for_request, validate_vba_macro

prompt = build_prompt("画一个 50mm 圆柱", model_name="claude")
macro = fallback_macro_for_request("画一个 50mm 圆柱")
result = validate_vba_macro(macro)
assert result.ok, result.issues

策略：

• GPT 系列沿用简洁提示词。
• Kimi / Claude / 未知模型自动使用强格式约束 Prompt，只允许输出 VBA 源码。
• 校验 SldWorks、ModelDoc2、Sub、End Sub 后再执行。
• 模型输出解析失败时自动重试 1~2 次；仍失败则按“立方体 / 圆柱 / 拉伸 / 草图”等关键词调用本地模板兜底。

创建零件

from sw_connect import connect_solidworks, mm, new_document
from sw_part import *

sw, _ = connect_solidworks()
model = new_document(sw, "part")

# 绘制草图
start_sketch(model, "Front Plane")
sketch_circle(model, 0, 0, mm(25))
end_sketch(model)

# 拉伸
extrude_boss(model, "Sketch1", mm(50))

装配体操作

from sw_connect import connect_solidworks, new_document
from sw_assembly import add_component, add_mate_coincident

sw, _ = connect_solidworks()
asm = new_document(sw, "assembly")

# 添加零件
comp1 = add_component(asm, r"C:\parts\part1.sldprt", 0, 0, 0)
comp2 = add_component(asm, r"C:\parts\part2.sldprt", 0.1, 0, 0)

# 添加配合
add_mate_coincident(asm, "Face1@part1", "FACE", "Face1@part2", "FACE")

Motion Study 旋转马达

from sw_connect import mm
from sw_motion import (
    create_motion_study,
    add_constant_speed_rotary_motor_by_cylinders,
    calculate_and_play,
)

# 前提：叶轮已通过同心 Mate 装到轴上，且 lock_rotation=False。
study = create_motion_study(asm, name="叶轮_60RPM_循环转动", duration=4.0)
add_constant_speed_rotary_motor_by_cylinders(
    study,
    shaft_component=stand_comp,
    rotor_component=impeller_comp,
    shaft_radius=(mm(4.5), mm(5.5)),
    rotor_radius=(mm(10.5), mm(11.5)),
    rpm=60.0,
    name="叶轮旋转马达_60RPM",
)
calculate_and_play(study)

导出文件

from sw_connect import connect_solidworks, open_document
from sw_export import export_to_step, export_to_stl

sw, _ = connect_solidworks()
model = open_document(sw, r"C:\parts\mypart.sldprt")

# 导出 STEP
export_to_step(model, r"C:\output\mypart.step")

# 导出 STL
export_to_stl(model, r"C:\output\mypart.stl", quality="fine")

🔑 核心概念

单位转换

SolidWorks API 使用米作为基本单位,使用辅助函数进行转换:

from sw_connect import mm, deg

length = mm(50)      # 50mm → 0.05m
angle = deg(90)      # 90° → 1.5708 弧度

实体选择

操作特征前需要先选择实体:

model.Extension.SelectByID2(
    "Front Plane",  # 实体名称
    "PLANE",        # 实体类型
    0, 0, 0,        # 坐标
    False,          # 追加选择
    0,              # 标记
    None,           # 标注
    0               # 选择标记
)

基准面名称

英文版	中文版	法线方向
Front Plane	前视基准面	Z 轴
Top Plane	上视基准面	Y 轴
Right Plane	右视基准面	X 轴

从当前版本开始，start_sketch() 会自动在中英文默认基准面名称之间兜底切换，更适合代理在不同语言版本的 SolidWorks 中执行。

🛠️ 高级功能

• 批量处理: 批量打开、转换、导出文件
• 外观材质: 设置文档、特征、组件级颜色；复杂颜色建议拆成多零件装配体
• 配置管理: 创建和切换配置,修改配置参数
• 自定义属性: 读写零件属性,支持配置特定属性
• 设计表: 通过 Excel 驱动参数化设计，仍需专项回归后才能无人值守交付
• 钣金展开: 导出 DXF 展开图用于激光切割
• 仿真分析: CalculiX 2.23 已真实执行线性静力、NLGEOM、受限塑性、面接触和网格序列，并读取最终步 COPEN/CPRESS/CSLIP；大型接触、全过程穿透允许值、屈曲、模态与热耦合仍未完成，不能作为安全认证
• CAD Agent 自审查: 自动导出多视角预览图、生成 review_report.json、给出 pass/warn/fail 与修复建议
• API 查证工作流: 对尚未封装的 SolidWorks API，先查官方 API Help / 本地 SDK，再写最小验证脚本并沉淀稳定封装

详见 references/ 目录下的完整文档。

🔎 Agent API 查证约定

本 skill 不把 SolidWorks 全量 API 硬塞进上下文。遇到 scripts/ 里尚未封装的接口时，代理应先读取 references/api-lookup.md，再查询 SolidWorks 官方 API Help 或本地 SDK，确认签名、枚举、返回值和版本差异；实现后必须真实运行、保存/导出文件，并用 sw_review.py 或桌面截图自审查结果。

⭐ Star History

❓ 常见问题

OpenClaw 里没有识别到这个 skill？

检查：

1. 目录是否放在 ~/.openclaw/skills/solidworks-automation/ 或 ~/.agents/skills/solidworks-automation/
2. 目录根下是否存在 SKILL.md
3. 当前会话是否在安装后重新开始
4. Python / pywin32 / comtypes 是否已就绪；可先运行 python scripts/sw_preflight.py

无法连接 SolidWorks?

确保:

1. SolidWorks 已经运行
2. Python 位数与 SolidWorks 一致(通常为 64 位)
3. 已安装依赖: pip install "pywin32>=305" "comtypes>=1.2.0"

特征创建失败?

检查:

1. 草图是否闭合
2. 单位是否正确(使用 mm() 转换)
3. 实体是否正确选择；SW2024 中文版优先使用 with sketch(...) 或 end_sketch() 返回值，不要只靠 SelectByID2("SKETCH")
4. 查看 troubleshooting.md

🤝 贡献

欢迎提交 Issue 和 Pull Request!

1. Fork 本仓库
2. 创建特性分支 (git checkout -b feature/AmazingFeature)
3. 提交更改 (git commit -m '添加某个功能')
4. 推送到分支 (git push origin feature/AmazingFeature)
5. 开启 Pull Request

📄 许可证

本项目采用 MIT 许可证 - 详见 LICENSE 文件

🙏 致谢

• SolidWorks API 文档
• pywin32 项目
• 所有贡献者

---

English

✨ Features

• 🔧 Part Modeling - Sketching, extrusion, revolution, chamfer, fillet, patterns
• 🔩 Assembly Operations - Add components, mates, interference detection, exploded views
• 📐 Drawing Creation - Standard views, section views, dimensions, BOM tables
• 💾 File Export - STEP, STL, IGES, PDF, DXF/DWG, Parasolid; native Pack and Go remains capability-gated
• 🎨 Appearance and Materials - Document, feature, and component-level color workflows
• 🔨 Sheet Metal (reference only) - No unattended feature or flat-pattern delivery is claimed
• ⚡ Weldments (reference only) - No unattended structural-member or cut-list delivery is claimed
• 📊 FEA Simulation (pilot) - CalculiX 2.23 runs restricted linear static, NLGEOM, plastic-curve, surface-contact, and mesh-sequence jobs; engineering review remains mandatory
• 🧰 Surface Modeling (pilot) - Restricted ruled/smooth loft, line/arc sweep, closed-shell knit, and open-face thicken produce and reopen real BREP artifacts; G1/G2 remains sampled evidence only
• 📝 Custom Properties - Read/write file properties, configuration management
• 👀 CAD Agent Self-Review - Export multi-view previews, JSON reports, Markdown summaries, and pass/warn/fail evaluations
• 🔎 Verified API Workflow - Look up official API Help or local SDK docs before using unwrapped SolidWorks APIs

📋 Requirements

• OS: Windows 10/11
• SolidWorks: 2024 and 2026 are tested only for the workflows listed in capabilities.yaml; 2025 remains a compatibility target, and 2020-2023 are compatibility support only
• Python: 3.10+
• Dependencies: pywin32, comtypes

🚀 Quick Start

Option 1: Install with npx

npx github:wzyn20051216/solidworks-automation-skill

This installs the skill into detected Claude/Codex/OpenClaw skill directories.

Option 2: Clone Manually

git clone https://github.com/wzyn20051216/solidworks-automation-skill.git
cd solidworks-automation-skill
python -m pip install "pywin32>=305" "comtypes>=1.2.0"
python scripts/sw_preflight.py

Run Example

Make sure SolidWorks is running, then:

import sys
sys.path.insert(0, r"./scripts")

from sw_connect import connect_solidworks, mm, new_document
from sw_part import start_sketch, sketch_rectangle, end_sketch, extrude_boss

# Connect to SolidWorks
sw, model = connect_solidworks()

# Create new part
model = new_document(sw, "part")

# Draw rectangle on Front Plane
start_sketch(model, "Front Plane")
sketch_rectangle(model, 0, 0, mm(50), mm(30))
end_sketch(model)

# Extrude 10mm
extrude_boss(model, "Sketch1", mm(10))

print("Part created!")

📚 Documentation

See references/ for focused workflows:

• references/openclaw.md for OpenClaw agent usage.
• references/review.md for CAD self-review.
• references/api-lookup.md for verified use of unwrapped SolidWorks APIs.
• references/troubleshooting.md for common COM and modeling failures.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

📄 License

This project is licensed under the MIT License - see LICENSE file for details.