前言¶

在 DeepSeek Harness（DSH）里做机械相关智能体时，常见做法是调用通用 API 或脚本间接操作 CAD，模型与真实 SOLIDWORKS 会话往往脱节。若你希望智能体直接驱动本机或虚拟机里正在运行的 SOLIDWORKS 2016 及以上版本——建零件、装配件、查干涉、统计 BOM、出工程图，并默认以只读方式打开已有文件——社区插件 dsh-solidworks（维护者 dshworks，分类：客户端）提供了一条可核对的路径：通过捆绑的 swbridge.exe 桥接 DSH 与 SOLIDWORKS API，无需单独安装运行时，也不要求管理员权限。

下面介绍插件定位、能力边界、安装步骤与典型用法。事实以 GitHub 仓库 与 SkillHub 目录页 为准。

这是什么¶

dsh-solidworks 是面向 DSH 的 npm 包 @dshworks/dsh-solidworks（当前发布版本 0.2.1，MIT 许可证）。它在 README 中的定位是：在桌面已打开的 SOLIDWORKS 上完成建模、装配、检查、出图与导出；同一台 Windows PC，或在 Mac 上通过 Windows 虚拟机运行 SOLIDWORKS 均可。插件声明在 SOLIDWORKS 2016 SP1、2019 SP0 上验证，并与 dsh 0.2.0-rc.2 对齐验证；对外暴露 21 个工具，几何与单位约定在文档中写清（长度毫米、角度度、模型空间 Y 向上等）。

DSH 生态强调「一切皆插件」；SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系。安装插件前，建议自行查看源码与许可证；插件以当前 dsh 进程权限运行，对本地 SOLIDWORKS 与文件系统具备相应能力。

核心功能¶

README 与简介中可核对的能力包括：

1. 零件建模：用自然语言描述零件，在 SOLIDWORKS 中生成几何；示例中包含法兰（圆盘、 hub、孔、螺栓孔、圆角等）及体积校验。
2. 读选择与探测：可读取 SOLIDWORKS 当前面/边选择（sw_probe），按点拾取面、边或顶点，或比较两实体间距与角度。
3. 装配与 fit 检查：新建或打开装配、放置零件、检查干涉（interference）；可统计仅接触的面，并列出 BOM。
4. 工程图：按第三角投影布置视图、带入模型尺寸，并导出 PDF；另有 sw_view 等多视角查看方式。
5. 已有文档工作流：打开 .sldprt / .sldasm / .slddrw（默认只读）、检视特征树、参数与方程、质量属性、编辑尺寸/配置后单次重建等。

工具入口以 sw_status 为先（查看 SOLIDWORKS 版本、实例、打开文档及对话框状态），其余如 sw_open、sw_new、sw_inspect、sw_features、sw_parameters、sw_components、sw_mass_properties、sw_edit 等覆盖文档与建模链路。完整列表见仓库 README「Tools」一节。

不会做的事：README 设有「What it will not do」「When to skip it」等章节，部署前应阅读，避免对云端渲染或未安装 SOLIDWORKS 的环境抱错误预期。

安装与启用¶

前置条件（来自 README「Get started」）：

• dsh 0.2.0-rc.2 或更高；dsh plugin add 使用 pnpm，需保证 pnpm 在 PATH 中。
• 已安装并可启动 SOLIDWORKS 2016 或更高。

dsh 与 SOLIDWORKS 在同一台 Windows PC¶

在主机上执行官方安装命令：

dsh plugin --profile web add @dshworks/dsh-solidworks

先启动 SOLIDWORKS，再启动 dsh 并提问。首次涉及 SOLIDWORKS 的问题时，插件会运行包内捆绑的 swbridge.exe，无需配对或额外安装步骤。

Mac 上跑 dsh，SOLIDWORKS 在 Windows 虚拟机¶

1. 在 Mac 上执行 dsh plugin --profile web add @dshworks/dsh-solidworks，并启动 dsh 一次；进程会监听桥接并写出配对套件（pairing kit）。
2. 在虚拟机中，以使用 SOLIDWORKS 的 Windows 用户登录，打开 Parallels 共享路径 \\Mac\Home\.dsh\dsh-solidworks\windows\，双击 pair.cmd。

pair.cmd 会为该 Windows 用户安装桥接、连接到 dsh，并在每次登录时启动桥接。桥接主动连出到 dsh，Windows 侧无需开入站端口或管理员/firewall 规则。若在配对前就向 dsh 提问，回复会说明套件位置。

VMware、另一台 PC，或无 Parallels 共享时，可将 ~/.dsh/dsh-solidworks/windows/ 复制到 Windows 机器后运行 pair.cmd。若虚拟机访问 Mac 的地址不在套件列表中，可在配置中声明广播地址，例如：

# ~/.dsh/profiles/web/cordis.patch.yml
- id: dsh-solidworks
  config:
    advertise: ['10.211.55.2']   # Parallels 常见主机地址

在虚拟机中卸载桥接：

%LOCALAPPDATA%\dsh-solidworks\swbridge.exe uninstall

其他 MCP 客户端（Windows 本机）¶

swbridge.exe mcp 提供与插件相同的 21 个工具的 stdio MCP 服务；可执行文件位于包内 bin/swbridge.exe，GitHub Release 亦提供并附带 SHA-256。示例：

claude mcp add solidworks -- C:\tools\swbridge.exe mcp

典型用法¶

以下场景均来自 README 演示说明，非虚构用户案例。

一段描述生成零件并自检：描述法兰几何后，插件在 SOLIDWORKS 中建模，并用质量属性核对体积（README 示例中算术与 SOLIDWORKS 报告一致），再从多个方向查看模型。

基于当前选择编辑：在 SOLIDWORKS 中选中面，说明操作（如对该面所有边 2 mm 圆角）；插件读取选择（边数等），执行特征并解释体积变化原因。

轴与法兰装配：分别建模并保存零件，装配时轴穿过孔、法兰抬升指定距离；调用干涉检查（示例为 0 对干涉），并生成 BOM；README 还提到轴径与孔径相等时的 line-to-line fit 说明。

出图导出：生成第三角投影工程图、选用适合图纸的最大标准比例、带入尺寸，工作区得到 PDF。

智能体侧只需在 dsh 对话中用自然语言驱动上述步骤；具体工具名与参数形状以 llms.txt 与 README 工具表为准。

适用场景与注意¶

更适合：已在 Windows（或 Mac + Windows VM）部署 SOLIDWORKS 2016+，希望 DSH 智能体直接操作真实会话、复用现有 .sld* 文件，且接受默认只读打开策略的团队或个人。

需要留意：

• 依赖本机 SOLIDWORKS 与桥接进程；无 SOLIDWORKS 的环境无法替代桌面 CAD。
• Mac 场景依赖配对与网络可达性；非 Parallels 需自行拷贝配对目录并可能配置 advertise。
• 引擎要求 Node >=22，包声明 dsh 为 ^0.2.0-rc.1；与 README 写的 dsh 0.2.0-rc.2 验证信息一并考虑升级节奏。
• 插件 MIT 开源，GitHub 星标为 0（目录页数据）；使用前请阅读「What it will not do」及 Issues，并确认桥接与文件访问符合本单位安全策略。

结尾¶

dsh-solidworks 把 DSH 接到你已打开的 SOLIDWORKS：21 个工具覆盖状态、打开文档、建模编辑、装配干涉、BOM 与出图，默认只读保护现有文件，同一 PC 或虚拟机配对即可起步。

• 目录页：https://www.skillhub.cn/plugins/dshworks/dsh-solidworks
• GitHub：https://github.com/dshworks/dsh-solidworks