Solidworks Automation
SolidWorks CAD 自动化技能,优先覆盖经验证的零件、孔槽、装配、工程图、导出和交付复核;所有能力等级以 capabilities.yaml 为准,未验证能力必须走人工复核。
- Skill ID
- wzyn20051216/solidworks-automation-skill/solidworks-automation
- Publisher
- wzyn20051216
- Repository
- solidworks-automation-skill
- Installs
- 0
- Files
- 389
- Synced
- Sep 23, 2026
Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.
wzyn20051216/solidworks-automation-skill/solidworks-automationInstalls these files- .github/workflows/star-history.yml
- .github/workflows/windows-cad-regression.yml
- .github/workflows/windows-release.yml
- .gitignore
- .mcpbignore
- CONTRIBUTING.md
- LICENSE
- README.md
- SECURITY.md
- SKILL.md
- SUBSKILLS.md
- agents/openai.yaml
- ai_team/delivery-gate-e2e.cjs
- ai_team/nsis-install-e2e.ps1
- ai_team/preview-viewport-e2e.cjs
- ai_team/provider-ui-e2e.cjs
- ai_team/release-portable-e2e.cjs
- ai_team/ui-layout-check.cjs
- ai_team/workbench-e2e-final.cjs
- apps/desktop/DESIGN.md
- apps/desktop/README.md
- apps/desktop/__init__.py
- apps/desktop/build_exe.ps1
- apps/desktop/cad_workbench/__init__.py
- apps/desktop/cad_workbench/agent_contracts.py
- apps/desktop/cad_workbench/agent_providers.py
- apps/desktop/cad_workbench/app.py
- apps/desktop/cad_workbench/artifact_ledger.py
- apps/desktop/cad_workbench/cad_core_contracts.py
- apps/desktop/cad_workbench/core.py
- apps/desktop/cad_workbench/engineering_orchestrator.py
- apps/desktop/cad_workbench/knowledge_retrieval.py
- apps/desktop/cad_workbench/mock_runner.py
- apps/desktop/cad_workbench/queue_worker.py
- apps/desktop/cad_workbench/reviewer_gate.py
- apps/desktop/cad_workbench/schemas/advanced_geometry.schema.json
- apps/desktop/cad_workbench/schemas/advanced_surface.schema.json
- apps/desktop/cad_workbench/schemas/automation_job.schema.json
- apps/desktop/cad_workbench/schemas/codex_final_response.schema.json
- apps/desktop/cad_workbench/schemas/evidence_graph.schema.json
- apps/desktop/cad_workbench/schemas/fea_analysis.schema.json
- apps/desktop/cad_workbench/schemas/neutral_cad_document.schema.json
- apps/desktop/cad_workbench/schemas/preview_manifest.schema.json
- apps/desktop/cad_workbench/style.py
- apps/desktop/cad_workbench/worker_health.py
- apps/desktop/preview_main_window.png
- apps/desktop/requirements.txt
- apps/desktop/run.py
- apps/desktop/start_desktop.ps1
- apps/workbench-ui/README.md
- apps/workbench-ui/docs/automation-queue-protocol.md
- apps/workbench-ui/index.html
- apps/workbench-ui/package-lock.json
- apps/workbench-ui/package.json
- apps/workbench-ui/preview-workbench-ui-appearance.png
- apps/workbench-ui/preview-workbench-ui-desktop.png
- apps/workbench-ui/preview-workbench-ui-mobile.png
- apps/workbench-ui/src-tauri/.gitignore
- apps/workbench-ui/src-tauri/Cargo.lock
- apps/workbench-ui/src-tauri/Cargo.toml
- apps/workbench-ui/src-tauri/build.rs
- apps/workbench-ui/src-tauri/capabilities/default.json
- apps/workbench-ui/src-tauri/examples/verify_updater_signature.rs
- apps/workbench-ui/src-tauri/icons/128x128.png
- apps/workbench-ui/src-tauri/icons/128x128@2x.png
- apps/workbench-ui/src-tauri/icons/32x32.png
- apps/workbench-ui/src-tauri/icons/Square107x107Logo.png
- apps/workbench-ui/src-tauri/icons/Square142x142Logo.png
- apps/workbench-ui/src-tauri/icons/Square150x150Logo.png
- apps/workbench-ui/src-tauri/icons/Square284x284Logo.png
- apps/workbench-ui/src-tauri/icons/Square30x30Logo.png
- apps/workbench-ui/src-tauri/icons/Square310x310Logo.png
- apps/workbench-ui/src-tauri/icons/Square44x44Logo.png
- apps/workbench-ui/src-tauri/icons/Square71x71Logo.png
- apps/workbench-ui/src-tauri/icons/Square89x89Logo.png
- apps/workbench-ui/src-tauri/icons/StoreLogo.png
- apps/workbench-ui/src-tauri/icons/icon.icns
- apps/workbench-ui/src-tauri/icons/icon.ico
- apps/workbench-ui/src-tauri/icons/icon.png
- apps/workbench-ui/src-tauri/src/lib.rs
- apps/workbench-ui/src-tauri/src/main.rs
- apps/workbench-ui/src-tauri/tauri.conf.json
- apps/workbench-ui/src/App.tsx
- apps/workbench-ui/src/CadPreview.tsx
- apps/workbench-ui/src/assets/WALLPAPER_CREDITS.md
- apps/workbench-ui/src/assets/default-blossom-poster.webp
- apps/workbench-ui/src/assets/default-blossom-wallpaper.mp4
- apps/workbench-ui/src/assets/wallpaper-anime-sky.webp
- apps/workbench-ui/src/assets/wallpaper-fuji.webp
- apps/workbench-ui/src/assets/wallpaper-tokyo-neon.webp
- apps/workbench-ui/src/components/AppUpdatePanel.tsx
- apps/workbench-ui/src/components/ArtifactBrowser.tsx
- apps/workbench-ui/src/components/ConversationControls.tsx
- apps/workbench-ui/src/components/EnvironmentRemediationPanel.tsx
- apps/workbench-ui/src/components/ManualReviewPanel.tsx
- apps/workbench-ui/src/components/ProjectSwitcher.tsx
- apps/workbench-ui/src/components/TaskSequence.tsx
- apps/workbench-ui/src/domain/artifacts.ts
- apps/workbench-ui/src/domain/delivery.ts
- apps/workbench-ui/src/domain/jobs.ts
- apps/workbench-ui/src/domain/projects.ts
- apps/workbench-ui/src/domain/updateProgress.test.ts
- apps/workbench-ui/src/domain/updateProgress.ts
- apps/workbench-ui/src/main.tsx
- apps/workbench-ui/src/persistence.test.ts
- apps/workbench-ui/src/persistence.ts
- apps/workbench-ui/src/preview/DxfViewport.tsx
- apps/workbench-ui/src/preview/ModelViewport.tsx
- apps/workbench-ui/src/preview/PreviewEvidencePanel.tsx
- apps/workbench-ui/src/preview/PreviewInspector.tsx
- apps/workbench-ui/src/preview/PreviewShowcase.tsx
- apps/workbench-ui/src/preview/PreviewStatus.tsx
- apps/workbench-ui/src/preview/PreviewToolbar.tsx
- apps/workbench-ui/src/preview/demoScenes.ts
- apps/workbench-ui/src/preview/dxfWorker.ts
- apps/workbench-ui/src/preview/previewTypes.ts
- apps/workbench-ui/src/preview/previewUtils.ts
- apps/workbench-ui/src/styles.css
- apps/workbench-ui/src/types.ts
- apps/workbench-ui/tsconfig.json
- apps/workbench-ui/vite.config.ts
- assets/douyin-balance.jpg
- assets/showcase/solidworks-engineering-drawing-demo.gif
- assets/star-history-dark.svg
- assets/star-history.svg
- capabilities.yaml
- docs/CAD_STUDIO_USER_MANUAL.md
- docs/agent-framework/enterprise-agent-control-plane.md
- docs/market-research-2026.md
- docs/product-mvp-spec.md
- docs/research/week1-js-cad-viewers.md
- docs/skill-map.md
- docs/weekly-delivery-plan.md
- dotnet/CadStudio.SolidWorks.AddinHost/CadStudio.AddinHost.snk.base64
- dotnet/CadStudio.SolidWorks.AddinHost/CadStudio.SolidWorks.AddinHost.csproj
- dotnet/CadStudio.SolidWorks.AddinHost/HostDiagnostics.cs
- dotnet/CadStudio.SolidWorks.AddinHost/Properties/AssemblyInfo.cs
- dotnet/CadStudio.SolidWorks.AddinHost/PropertyPageHandler.cs
- dotnet/CadStudio.SolidWorks.AddinHost/SwAddin.cs
- dotnet/CadStudio.SolidWorks.AddinHost/TaskPaneControl.cs
- examples/01_basic_part.py
- examples/02_complex_part.py
- examples/03_assembly.py
- examples/04_batch_export.py
- examples/05_drawing.py
- examples/06_friendly_api.py
- examples/07_motion_study_rotary_motor.py
- examples/08_mini_fan_motion_assembly.py
- examples/README.md
- examples/fea_tetra_static.json
- examples/generate_fea_convergence_example.py
- examples/ocp_loft_adapter.json
- examples/weldment/coremark_hss1x1x16ga.json
- golden-workflows.yaml
- install.js
- manifest.json
- mcp-server/README.md
- mcp-server/register_all_ai_mcp.js
- mcp-server/register_all_ai_mcp.ps1
- mcp-server/register_codex_mcp.ps1
- mcp-server/requirements.txt
- mcp-server/server.py
- package.json
- project.yaml
- pyproject.toml
- references/advanced.md
- references/agent-provider-architecture.md
- references/api-lookup.md
- references/appearance.md
- references/assembly.md
- references/complex-hole-features.md
- references/complex-mechanical-routing.md
- references/drawing.md
- references/enterprise-agent-rag.md
- references/export.md
- references/gears.md
- references/language-backend-routing.md
- references/mcp-server.md
- references/mesh-reference-import.md
- references/motion-study.md
- references/openclaw.md
- references/part-modeling.md
- references/review.md
- references/solidworks-addin-host.md
- references/troubleshooting.md
- requirements-mesh.txt
- requirements-occt.txt
- requirements-pdf.txt
- requirements.txt
- scripts/__init__.py
- scripts/advanced_geometry.py
- scripts/advanced_geometry_ocp.py
- scripts/advanced_surface_ocp.py
- scripts/backend_router.py
- scripts/build_smithery_mcpb.py
- scripts/build_windows_release.ps1
- scripts/cad_diagnostics.py
- scripts/cad_doctor.py
- scripts/cad_installation.py
- scripts/cad_studio.py
- scripts/capabilities.py
- scripts/delivery_compare.py
- scripts/dfm_profiles.py
- scripts/dfm_review.py
- scripts/drawing_spec.py
- scripts/dxf_preview_scene.py
- scripts/fea_analysis.py
- scripts/fea_convergence.py
- scripts/generate_star_history.py
- scripts/headless_cad_writer.py
- scripts/headless_occt_service.py
- scripts/release_check.py
- scripts/routing_review.py
- scripts/stability_regression.py
- scripts/sw_addin_host.ps1
- scripts/sw_addin_host.py
- scripts/sw_appearance.py
- scripts/sw_assembly.py
- scripts/sw_capability_probe.py
- scripts/sw_connect.py
- scripts/sw_delivery.py
- scripts/sw_document_data.py
- scripts/sw_drawing.py
- scripts/sw_drawing_review.py
- scripts/sw_entity_reference.py
- scripts/sw_export.py
- scripts/sw_gear.py
- scripts/sw_hole_features.py
- scripts/sw_import_mesh_reference.py
- scripts/sw_macro_guard.py
- scripts/sw_motion.py
- scripts/sw_part.py
- scripts/sw_preflight.py
- scripts/sw_review.py
- scripts/sw_session.py
- scripts/sw_sheet_metal.py
- scripts/sw_weldment.py
- scripts/sync_bundled_skill.py
- scripts/validate_mcp.py
- scripts/validate_skill.py
- scripts/verify_updater_release.ps1
- setup.py
- subskills/autocad-automation/README.md
- subskills/autocad-automation/SKILL.md
- subskills/autocad-automation/dotnet/CadStudio.AutoCAD2024/CadStudio.AutoCAD2024.csproj
- subskills/autocad-automation/dotnet/CadStudio.AutoCAD2024/CadStudioCommands.cs
- subskills/autocad-automation/dotnet/CadStudio.AutoCAD2024/NuGet.Config
- subskills/autocad-automation/evals/evals.json
- subskills/autocad-automation/examples/draw_mounting_plate.py
- subskills/autocad-automation/manifest.yaml
- subskills/autocad-automation/references/api-lookup.md
- subskills/autocad-automation/references/engineering-patterns.md
- subskills/autocad-automation/references/troubleshooting.md
- subskills/autocad-automation/scripts/acad_dotnet_preflight.py
- subskills/autocad-automation/scripts/acad_dotnet_regression.py
- subskills/autocad-automation/scripts/acad_draw.py
- subskills/autocad-automation/scripts/acad_headless.py
- subskills/autocad-automation/scripts/acad_preflight.py
- subskills/autocad-automation/scripts/acad_preview.py
- subskills/autocad-automation/scripts/acad_review.py
- subskills/autocad-automation/scripts/acad_session.py
- subskills/solidworks-engineering-drawing/README.md
- subskills/solidworks-engineering-drawing/SKILL.md
- subskills/solidworks-engineering-drawing/manifest.yaml
- subskills/solidworks-engineering-drawing/references/api-lookup.md
- subskills/solidworks-engineering-drawing/references/drawing.md
- subskills/solidworks-engineering-drawing/references/review.md
- subskills/solidworks-engineering-drawing/schemas/drawing_spec.schema.json
- subskills/solidworks-engineering-drawing/scripts/__init__.py
- subskills/solidworks-engineering-drawing/scripts/drawing_review.py
- subskills/solidworks-engineering-drawing/scripts/drawing_spec.py
- subskills/solidworks-engineering-drawing/scripts/drawing_workflow.py
- subskills/solidworks-fillet-chamfer-cnc/README.md
- subskills/solidworks-fillet-chamfer-cnc/SKILL.md
- subskills/solidworks-fillet-chamfer-cnc/agents/openai.yaml
- subskills/solidworks-fillet-chamfer-cnc/evals/evals.json
- subskills/solidworks-fillet-chamfer-cnc/examples/cnc_mount_precision_params.json
- subskills/solidworks-fillet-chamfer-cnc/examples/open_source_corner_bracket_case.json
- subskills/solidworks-fillet-chamfer-cnc/manifest.yaml
- subskills/solidworks-fillet-chamfer-cnc/references/cnc-fillet-chamfer-lessons.md
- subskills/solidworks-fillet-chamfer-cnc/scripts/advanced_fillet_strategy.py
- subskills/solidworks-fillet-chamfer-cnc/scripts/cnc_strategy.py
- subskills/solidworks-fillet-chamfer-cnc/scripts/create_cnc_mount_template.py
- subskills/solidworks-fillet-chamfer-cnc/scripts/hold_line_bridge.py
- subskills/solidworks-fillet-chamfer-cnc/scripts/native/HoldLineBridge.cs
- subskills/solidworks-fillet-chamfer-cnc/scripts/native/NativeHoldLineAddin.cpp
- subskills/solidworks-fillet-chamfer-cnc/scripts/native/NativeHoldLineAddin.def
- subskills/solidworks-fillet-chamfer-cnc/scripts/native/NativeHoldLineMacro.swb
- subskills/solidworks-fillet-chamfer-cnc/scripts/verify_advanced_fillets.py
- subskills/solidworks-fillet-chamfer-cnc/scripts/verify_open_source_bracket.py
- subskills/solidworks-fillet-chamfer-cnc/scripts/verify_open_source_complex_case.py
- subskills/solidworks-threaded-holes/README.md
- subskills/solidworks-threaded-holes/SKILL.md
- subskills/solidworks-threaded-holes/agents/openai.yaml
- subskills/solidworks-threaded-holes/manifest.yaml
- subskills/solidworks-threaded-holes/references/threaded-hole-lessons.md
- subskills/solidworks-threaded-holes/references/threaded-hole-roadmap.md
- subskills/solidworks-threaded-holes/scripts/create_threaded_hole_template.py
- subskills/solidworks-vibecad/README.md
- subskills/solidworks-vibecad/SKILL.md
- subskills/solidworks-vibecad/examples/motor_mount_brief.txt
- subskills/solidworks-vibecad/examples/motor_mount_execution.md
- subskills/solidworks-vibecad/examples/motor_mount_plan.json
- subskills/solidworks-vibecad/knowledge/manufacturing_rules.yaml
- subskills/solidworks-vibecad/manifest.yaml
- subskills/solidworks-vibecad/prompts/solidworks_parametric_planner.md
- subskills/solidworks-vibecad/references/vibecad-roadmap.md
- subskills/solidworks-vibecad/schemas/design_plan.schema.json
- subskills/solidworks-vibecad/scripts/plan_from_brief.py
- subskills/solidworks-vibecad/scripts/sw_execution_outline.py
- tests/autocad_week4_drawing_regression.py
- tests/cad_studio_weekly_regression.py
- tests/calculix_nonlinear_convergence_regression.py
- tests/calculix_nonlinear_regression.py
- tests/solidworks_add_component_regression.py
- tests/solidworks_addin_host_regression.py
- tests/solidworks_appearance_regression.py
- tests/solidworks_configuration_family_regression.py
- tests/solidworks_drawing_version_matrix.py
- tests/solidworks_loadfile4_import_regression.py
- tests/solidworks_sheet_metal_regression.py
- tests/solidworks_sketch_selection_regression.py
- tests/solidworks_spur_gear_regression.py
- tests/solidworks_week3_delivery_regression.py
- tests/solidworks_week4_drawing_regression.py
- tests/solidworks_weldment_regression.py
- tests/test_acad_dotnet_preflight.py
- tests/test_acad_dotnet_regression.py
- tests/test_acad_headless.py
- tests/test_acad_script_backend.py
- tests/test_acad_session.py
- tests/test_advanced_geometry.py
- tests/test_advanced_geometry_ocp.py
- tests/test_advanced_surface_ocp.py
- tests/test_agent_providers.py
- tests/test_cad_core_contracts.py
- tests/test_cad_reliability.py
- tests/test_cad_studio_cli.py
- tests/test_cad_studio_weekly_regression.py
- tests/test_cnc_fillet_chamfer_subskill.py
- tests/test_delivery_compare.py
- tests/test_desktop_mock_runner.py
- tests/test_dfm_queue_worker.py
- tests/test_dfm_review.py
- tests/test_domain_evidence_status.py
- tests/test_drawing_subskill.py
- tests/test_dxf_preview_scene.py
- tests/test_engineering_orchestrator.py
- tests/test_fea_analysis.py
- tests/test_fea_convergence.py
- tests/test_generate_star_history.py
- tests/test_headless_cad_writer.py
- tests/test_headless_occt_service.py
- tests/test_job_evidence_fields.py
- tests/test_knowledge_retrieval.py
- tests/test_language_backend_matrix.py
- tests/test_mcp_backend_router.py
- tests/test_mcp_configuration_tools.py
- tests/test_mcp_drawing_tools.py
- tests/test_mcp_headless_open_format.py
- tests/test_open_source_cnc_complex_case.py
- tests/test_release_check.py
- tests/test_routing_review.py
- tests/test_solidworks_drawing_version_matrix.py
- tests/test_stability_regression.py
- tests/test_sw_addin_host.py
- tests/test_sw_addin_host_probe.py
- tests/test_sw_assembly_aliases.py
- tests/test_sw_assembly_interference.py
- tests/test_sw_batch_export.py
- tests/test_sw_bom_traceability.py
- tests/test_sw_capability_probe.py
- tests/test_sw_connect_open_document.py
- tests/test_sw_delivery.py
- tests/test_sw_document_data.py
- tests/test_sw_drawing_structure.py
- tests/test_sw_entity_reference.py
- tests/test_sw_gear.py
- tests/test_sw_hole_features.py
- tests/test_sw_motion_audit.py
- tests/test_sw_part_sketch_selection.py
- tests/test_sw_review_geometry.py
- tests/test_sw_review_pdf.py
- tests/test_sw_sheet_metal.py
- tests/test_sw_weldment.py
- tests/test_sync_bundled_skill.py
- tests/test_threaded_hole_subskill.py
- tests/test_workbench_queue_worker.py
- uv.lock
What this skill tells the agent
SolidWorks 自动化技能
快速开始
环境要求
- Windows 系统;原生 SolidWorks 格式需要 SolidWorks,开放格式无头写入不要求安装 CAD 软件
- Python 3.10+;原生 Windows CAD 自动化另需
pywin32/comtypes - MCP/工具化调用需要
mcp/pydantic - 工程图最终交付审查需要
PyMuPDF;它从 SolidWorks 导出 PDF 回读实际尺寸文字边界,已包含在requirements.txt - 处理 GLB/GLTF/OBJ/STL 网格参考模型时,可能还需要
trimesh/pygltflib/numpy/Pillow - 如果通过 OpenClaw 使用,确保技能目录位于
~/.openclaw/skills/solidworks-automation/或~/.agents/skills/solidworks-automation/
入口自检
所有代理在执行 SolidWorks 自动化前,先运行技能自检:
python SKILL_DIR/scripts/sw_preflight.py桌面端或 CLI 执行前建议先运行环境诊断:
python SKILL_DIR/scripts/cad_studio.py doctorcapabilities.yaml 是 Skill、MCP、队列和 UI 共用的能力唯一真源。能力等级为 verified、pilot、reference_only 或 not_implemented;后两者不得作为无人值守交付。该清单还维护 Python、C# PIA/Add-in、原生 C++、SWBasic、OCCT 和外部求解器的原子操作路由;执行前可用 python scripts/backend_router.py --list 查询,规则见 references/language-backend-routing.md。
多入口与多后端
- CAD Studio 与 Skill/CLI/MCP 是平级入口,共用 Automation Job、NeutralCadDocument、Preview Manifest、Evidence Graph 和能力清单。
- 检测不到 SolidWorks/AutoCAD 时,只阻断
SLDPRT/SLDASM/SLDDRW/DWG等原生格式;开放格式任务优先路由到headless_open_format_writing。 - 无头写入使用
scripts/headless_cad_writer.py;OCCT/OCP 隔离进程真实写入 STEP、IGES、BREP、STL、OBJ、GLB,二维后端写入 DXF、SVG、PDF、PNG,并生成几何与 SHA-256 证据。 - DXF 交付会额外生成
preview_scene;已有 DXF 可通过python scripts/cad_studio.py preview-dxf --input drawing.dxf --output drawing.scene.json或 MCPcadstudio_build_dxf_preview_scene转成受限 PreviewScene。该命令只读白名单实体并拒绝覆盖旧文件。 - OCCT 当前覆盖盒体、圆柱、布尔合并、圆柱孔切除、直纹/受限平滑 Loft、直线/单圆弧 Sweep、闭壳 Knit 和开放面 Thicken;复杂路径、自交偏置或缺少 OCP 运行时时保持
blocked。禁止通过改扩展名或空文件伪造支持。 delivery-preview只允许显示当前任务真实产物;固定样例必须标记demo-showcase与isDemo: true,不得进入交付判断。
规则:
- 检测到缺少
comtypes/win32com/pythoncom时,向用户弹出友好确认:检测到当前 Python 环境缺少 comtypes / win32com 库,是否授权 AI 自动为您配置本地环境?[Y/N] - 用户输入
Y/yes后,代理可在本地 shell 中自动执行python -m pip install "pywin32>=305" "comtypes>=1.2.0"补齐依赖;用户拒绝时停止并给出手动安装命令。 - 检测不到 SolidWorks 安装或 COM 注册时,停止原生 SolidWorks 操作;若原生格式并非必需且
fallbackPolicy=allow_open_formats,继续执行无头开放格式后端,不要把整个任务误标为失败。
Python 依赖提醒
按任务最小化安装依赖,不要在普通零件建模时强制安装网格转换库;工程图交付需要标准 requirements.txt 中的 PyMuPDF:
# 核心 SolidWorks COM 自动化依赖
python -m pip install -r SKILL_DIR\requirements.txt
# 仅在需要 GLB/GLTF/OBJ/STL 网格检查、缩放或转换时安装
python -m pip install -r SKILL_DIR\requirements-mesh.txt执行涉及 GLB/GLTF/FBX/BLEND 转 OBJ/STL 的任务前,先用 importlib.util.find_spec() 检查 trimesh、pygltflib、PIL 是否可用;缺失时先提示用户需要安装哪些库和用途,再安装或给出手动命令。
连接 SolidWorks
import sys; sys.path.insert(0, r"SKILL_DIR/scripts")
from sw_connect import mm
from sw_part import sketch, sketch_circle, extrude_boss
from sw_session import SolidWorksSession
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")将 SKILL_DIR 替换为此技能的实际安装路径。核心工作流
根据用户需求选择对应模块:
| 需求 | 脚本 | 参考文档 |
|---|---|---|
| 入口自检与依赖补齐 | scripts/sw_preflight.py | references/troubleshooting.md |
| 无 CAD 开放格式写入 | scripts/headless_cad_writer.py、scripts/cad_studio.py write-open-format | capabilities.yaml、公共 CAD Core Schema |
| 高级能力/类型库探测 | scripts/sw_capability_probe.py | references/complex-mechanical-routing.md |
| Python/C#/C++/SWBasic/OCCT 后端选择 | scripts/backend_router.py | references/language-backend-routing.md、capabilities.yaml |
| C# 进程内 Add-in 宿主、事件与 UI | scripts/sw_addin_host.ps1、scripts/sw_addin_host.py | references/solidworks-addin-host.md |
| 多模型宏生成防护 | scripts/sw_macro_guard.py | references/openclaw.md |
| 友好会话 API | scripts/sw_session.py | - |
| 连接与文档管理 | scripts/sw_connect.py | - |
| 外观与材质 | scripts/sw_appearance.py | references/appearance.md |
| 零件建模(草图+特征) | scripts/sw_part.py | references/part-modeling.md |
| 标准外啮合直齿轮实体 | scripts/sw_gear.py | references/gears.md |
| 盲孔/沉孔/沉头孔/半圆端槽与孔位验收 | scripts/sw_hole_features.py、scripts/sw_review.py | references/complex-hole-features.md、references/review.md |
| 自然语言到参数化设计计划 / VibeCAD | subskills/solidworks-vibecad/scripts/plan_from_brief.py | subskills/solidworks-vibecad/SKILL.md、subskills/solidworks-vibecad/README.md |
| 多圆角/倒角 CNC 机加工件 | subskills/solidworks-fillet-chamfer-cnc/scripts/create_cnc_mount_template.py;高级圆角用 verify_advanced_fillets.py | subskills/solidworks-fillet-chamfer-cnc/SKILL.md、subskills/solidworks-fillet-chamfer-cnc/references/cnc-fillet-chamfer-lessons.md |
| 螺丝孔/螺纹孔、攻丝底孔 | subskills/solidworks-threaded-holes/scripts/create_threaded_hole_template.py | subskills/solidworks-threaded-holes/SKILL.md、subskills/solidworks-threaded-holes/references/threaded-hole-lessons.md |
| AutoCAD DWG/DXF 二维绘图、线稿转 CAD、批量改图 | subskills/autocad-automation/scripts/acad_draw.py、subskills/autocad-automation/scripts/acad_review.py | subskills/autocad-automation/SKILL.md、subskills/autocad-automation/references/troubleshooting.md |
| 装配体操作、齿轮联动/铰链/可拖动运动配合 | scripts/sw_assembly.py | references/assembly.md |
| Motion Study 运动算例、旋转马达与结果审计 | scripts/sw_motion.py | references/motion-study.md、references/complex-mechanical-routing.md |
| 工程图出图 | scripts/sw_drawing.py | references/drawing.md |
| 文件导出 | scripts/sw_export.py | references/export.md |
| 配置族创建/激活、参数修改与自定义属性 | scripts/sw_document_data.py | references/advanced.md |
| 装配 BOM CSV 与 Pack and Go | scripts/sw_delivery.py | references/export.md |
| OBJ/STL 高还原网格参考导入 | scripts/sw_import_mesh_reference.py | references/mesh-reference-import.md |
| 结果自审查 | scripts/sw_review.py | references/review.md |
| 语义实体引用 | scripts/sw_entity_reference.py | 逐步替代 Face1/Edge1 和屏幕坐标 |
| DFM 制造风险复核 | scripts/dfm_review.py、scripts/dfm_profiles.py、scripts/cad_studio.py check-dfm | 供应商 profile、B-Rep 证据、机加工、钣金、激光切割和 3D 打印的结构化规则检查 |
| Routing 中性复核与前置 | scripts/routing_review.py、scripts/cad_studio.py check-routing、scripts/cad_studio.py routing-preflight | 端点、分段、长度、弯曲半径、碰撞/间隙、支撑、Routing BOM;原生写入必须等加载项/许可证证据 |
| FEA 前置、输入与受限求解 | scripts/fea_analysis.py、scripts/fea_convergence.py、scripts/cad_studio.py fea-preflight/prepare-fea/run-fea/run-fea-convergence | CalculiX 2.23 已验证线性/非线性静力、塑性、面接触、最终步 COPEN/CPRESS/CSLIP 与线性/非线性网格收敛;全部仍需工程复核 |
| 复杂曲面与模具 | scripts/advanced_geometry.py、scripts/advanced_geometry_ocp.py、scripts/advanced_surface_ocp.py、scripts/cad_studio.py review-advanced-geometry/create-ocp-loft/create-ocp-surface | 直纹/平滑 Loft、受限 Sweep/Knit/Thicken 可写并重开 B-Rep;G1/G2 和曲率半径只返回离散采样证据 |
| 本地 MCP Server | mcp-server/server.py | mcp-server/README.md、references/mcp-server.md |
| MCP 协议验证 | scripts/validate_mcp.py | mcp-server/README.md |
| 未封装 API 查证 | - | references/api-lookup.md |
| OpenClaw 控制 SolidWorks | - | references/openclaw.md |
| 钣金/焊件/仿真/属性 | - | references/advanced.md |
| 企业 Agent / 本地优先与云 RAG | apps/desktop/cad_workbench/knowledge_retrieval.py | references/enterprise-agent-rag.md |
| Codex/Claude/Gemini/OpenCode Provider Adapter | apps/desktop/cad_workbench/agent_providers.py | references/agent-provider-architecture.md |
| 综合机械工程 DAG 自动编排 | apps/desktop/cad_workbench/engineering_orchestrator.py | references/complex-mechanical-routing.md |
| 常见错误排查 | - | references/troubleshooting.md |
Pack and Go 在 SW2026 SP01.1 的基础两零件装配上已连续三次通过原生回归:SavePackAndGo() 实际输出装配体和两个零件,状态码均为 0,未使用暂存回退。部分版本的 GetDocumentNames() 仍可能在保存前只枚举顶层文件;不要用 AddExternalDocuments 补装配体原生零件,应先执行原生保存,再审计实际落盘依赖。若落盘仍缺依赖,scripts/sw_delivery.py::pack_and_go() 默认按 GetDependencies2 生成带 manifest 和 SHA-256 的 pilot 暂存包;需要严格原生语义时使用 fallback_policy="blocked"。外部引用、Toolbox、配置和工程图仍必须人工复核,因此总能力保持 pilot。
OpenClaw 协作方式
- 先确认 SolidWorks 版本、界面语言、输入文件路径、输出路径,以及目标操作(建模 / 装配 / 出图 / 导出)。
- 优先复用
{baseDir}/scripts下已有模块,不要重复手写 COM 连接逻辑。 - 在 OpenClaw 的
exec/shell能力中执行短小、一次性的 Python 脚本,最小导入集如下:
Use this skill in a project
Open any RiverX project, search the Skills panel for wzyn20051216/solidworks-automation-skill/solidworks-automation, and install it in one click.
