``` ___ _ __ dsh-solidworks / __| \ / / \__ \\ \/\/ / DeepSeek Harness 的 SOLIDWORKS 连接器： |___/ \_/\_/ 在你桌面上的 SOLIDWORKS 里建模、装配、检查、出图、导出 ``` **让 dsh 直接操作你已经打开的 SOLIDWORKS：2016 及以后版本，同一台 PC 或 Mac 上的 Windows 虚拟机都行。**

21 个工具 · 已在 SOLIDWORKS 2016 SP1 和 2019 SP0 上实测 · 一个 bridge exe，无需安装运行时、无需管理员权限 · 你的文件默认只读 · MIT

CI npm MIT SOLIDWORKS 2016 及以后 已在 dsh 0.2.0-rc.2 上验证

看它工作 · 开始使用 · 工具 · 它不会做什么 · 工作原理 · 证据 · English

---

dsh 根据一段话在 SOLIDWORKS 2019 里建出管法兰：圆盘、轮毂、中心孔、六个螺栓孔、圆角，再核对体积并从四个方向查看

**一段话进去，一个法兰出来。** 你描述零件，dsh 就在你桌面上的 SOLIDWORKS 里把它建出来，用它自己的算术核对体积 （两边都是 158,983.493 mm³），再从四个方向看一遍。它还能把零件装起来、检查干涉、汇总物料清单、出工程图， 也能处理你已有的文件：除非你同意，一律只读。 ## 看它工作 每个片段都是一次真实会话：dsh 0.2.0-rc.2 加 `deepseek-flash`，SOLIDWORKS 2019 SP0 跑在 Parallels 虚拟机里， 画面录自 SOLIDWORKS 窗口。字幕是这次会话自己的工具调用和结果，以及模型自己的结束语。模型思考的时间被快进， 没有剪掉或调换任何内容。[片段是怎么做的](scripts/clips/README.md)。 ### 指给它看 你在 SOLIDWORKS 里选中一个面，告诉它要做什么。dsh 读取你的选择（法兰的上表面，8 条边），把这些边全部倒 2 mm 圆角，并解释为什么体积减少了 360.218 mm³，尽管其中一个圆角是在加材料。

在 SOLIDWORKS 里选中的面变成蓝色；dsh 读取选择并把它的八条边倒圆角

### 装起来，检查是否合得上 建一根轴，两个零件都保存，再装配：轴穿过中心孔，法兰离轴端 40 mm。干涉：0 对。dsh 还把只是贴合的面也算了一遍， 指出 30 mm 的轴配 30 mm 的孔是零间隙配合。最后给出物料清单。

dsh 建出轴、保存两个零件、装配轴和法兰、检查干涉并列出 BOM

### 出图 工程图按投影关系布置视图，取能放进图纸的最大标准比例，导入模型尺寸，并以 PDF 的形式回到你的工作区。

dsh 以 1:2 第三角投影为法兰出图并导出 PDF

导出的 PDF：法兰的前视、上视、右视和等轴测视图，1:2，带尺寸 sw_view：法兰的前视、上视、右视和等轴测拼在一张图上

左：导出的 PDF。右：sw_view 把四个视图拼在一张图上，dsh 就是这样看它做出来的东西。

## 开始使用 需要 dsh 0.2.0-rc.2 或更高版本（它的 `dsh plugin add` 依赖 pnpm，PATH 里要有 pnpm），以及一个正在 运行的 SOLIDWORKS 2016 或更高版本。 ### dsh 和 SOLIDWORKS 在同一台 Windows PC 上 ``` dsh plugin --profile web add @dshworks/dsh-solidworks ``` 启动 SOLIDWORKS、启动 dsh、直接提问。插件会在第一次涉及 SOLIDWORKS 的提问时运行自带的 `swbridge.exe`，不需要配对，也不需要安装任何东西。 ### dsh 在 Mac 上，SOLIDWORKS 在 Windows 虚拟机里 1. 在 Mac 上执行 `dsh plugin --profile web add @dshworks/dsh-solidworks`，然后启动一次 dsh。 它会开始监听 bridge，并写出一个配对包。 2. 在虚拟机里，以使用 SOLIDWORKS 的那个用户登录，打开 `\\Mac\Home\.dsh\dsh-solidworks\windows\` （Parallels 把你的 Mac 主目录共享在这里），双击 `pair.cmd`。 这一步会为该 Windows 用户安装 bridge、连上 dsh，并设置为每次登录自动启动。不需要管理员，不需要 防火墙规则：bridge 主动连向 dsh，Windows 一侧不开任何端口。配对前就向 dsh 提问的话，回答会告诉你 配对包在哪里。 在 VMware、另一台 PC，或没有开启 Parallels 共享的 Mac 上，把 `~/.dsh/dsh-solidworks/windows/` 文件夹 复制到 Windows 上再运行 `pair.cmd`。如果虚拟机访问 Mac 用的地址不在配对包列出的地址里，手动指定： ```yaml # ~/.dsh/profiles/web/cordis.patch.yml - id: dsh-solidworks config: advertise: ['10.211.55.2'] # Parallels 常见的宿主机地址 ``` 在虚拟机里撤销：`%LOCALAPPDATA%\dsh-solidworks\swbridge.exe uninstall`。 ### 在 Windows PC 上配合其他 MCP 客户端 `swbridge.exe mcp` 是一个普通的 stdio MCP server，提供同样的 21 个工具： ``` claude mcp add solidworks -- C:\tools\swbridge.exe mcp ``` exe 在本包的 `bin/swbridge.exe`，每个 [GitHub release](https://github.com/dshworks/dsh-solidworks/releases) 也附带它和 SHA-256。 ## 工具 长度一律用毫米，角度用度，质量用千克，与文档自身单位无关；字段名里写明单位（`value_mm`、`mass_kg`）。 几何在所有工具里都用同一个坐标空间：模型空间的点 `[x, y, z]`，单位 mm，Y 轴朝上，前视基准面是 z = 0， 上视是 y = 0，右视是 x = 0。面和边用其上的一个点来选取。`doc` 是已打开文档的路径、文件名或标题， 默认是当前活动文档。
全部 21 个工具 | 工具 | 作用 | | --- | --- | | `sw_status` | 版本（2016 SP1、2019 SP0 ……）、所有 SOLIDWORKS 实例、已打开文档，以及 SOLIDWORKS 正在等待的对话框。首先调用。 | | `sw_open` | 打开 `.sldprt`、`.sldasm` 或 `.slddrw`，默认只读，并设为活动文档。 | | `sw_new` | 用 SOLIDWORKS 的默认模板新建一个空的零件或装配体。 | | `sw_inspect` | 类型、单位、配置、材料、自定义属性、包围盒、实体数和零部件数。 | | `sw_features` | 特征树，含压缩状态和重建错误。 | | `sw_parameters` | 所有尺寸（`D1@Sketch1`、数值、单位、是否从动）和方程式，标出全局变量。 | | `sw_components` | 装配体的零部件树：文件、配置、状态、是否固定、位置。 | | `sw_mass_properties` | 质量、体积、表面积、密度、质心。 | | `sw_probe` | 某个点上是什么：那里的面、边或顶点，及其曲面或曲线类型、面积或长度、法向或轴线、直径和生成它的特征。不给点时，读取用户此刻在 SOLIDWORKS 里选中的东西。两个对象还会给出它们之间的距离和夹角。 | | `sw_edit` | 在内存中修改后统一重建一次：配置、压缩/解除压缩、全局变量、尺寸、自定义属性。每项修改都返回修改前后的值和各自的结果。 | | `sw_build` | 分步建模一个零件：在基准面或面上画草图（直线、多段线、矩形、圆、圆弧、中心线），拉伸或切除（给定深度、完全贯穿、两侧对称、拔模），旋转，圆角，倒角，抽壳，偏移基准面，删除。某一步失败时撤销本次调用。返回每个特征及其尺寸，以及零件的体积和包围盒。 | | `sw_study` | 一次调用里试最多 50 组尺寸和变量取值，每组都重建并测量（质量、体积、面积、质心、尺寸）；结束后把每个值恢复原样并核对。 | | `sw_rebuild` | 重建并列出每个失败的特征及原因。 | | `sw_assemble` | 把已保存的零件插入到指定原点位置，配合基准面、面、边或顶点（重合、同心、平行、垂直、相切、距离、角度），固定或浮动。 | | `sw_interference` | 所有相互重叠的零部件对及重叠体积，按体积从大到小。 | | `sw_bom` | 物料清单：每个文件和配置的数量及自定义属性，可展开到零件或只看顶层；可选输出 CSV。 | | `sw_drawing` | 为已保存的模型出图：按第一角或第三角投影布置视图，取能放进图纸的最大标准比例，并导入模型尺寸。 | | `sw_export` | 导出副本：STEP、IGES、Parasolid、ACIS、STL、PDF、DXF/DWG、eDrawings、JPG/PNG/TIF 或原生格式。返回路径、大小和 SHA-256；bridge 在另一台机器上时会自动取回到 dsh 工作区。 | | `sw_save` | 另存为允许的文件夹里的新文件（新文档就是这样得到文件的），或在 bridge 以 `--allow-save` 启动时覆盖源文件。 | | `sw_close` | 关闭文档；只有这个 bridge 自己做的未保存修改才会被丢弃。 | | `sw_view` | 渲染一张 PNG：一个标准视图，或最多六个视图拼在一张带标注的图上，着色、线框或消隐。之后恢复用户原来的视图。 |
## 它不会做什么 这些规则在 Windows 一侧、文件所在的地方执行。dsh 可以提出任何请求，最终由 bridge 决定。 - **不经允许修改你的文件。** 文档默认只读打开；`sw_edit`、`sw_build`、`sw_study` 和 `sw_assemble` 只改内存；`sw_save` 把新文件写到允许的文件夹里，只有 bridge 以 `--allow-save` 启动时才覆盖源文件。 - **删掉你的工作。** `sw_build` 只删除它在本次 bridge 会话里建的特征，被这些特征吸收的你自己的草图会保留； 你的特征只能压缩，不能删除。退回控制棒不在特征树末尾时它拒绝建模，因为新特征会落在你的特征中间。 `sw_study` 会把每个值恢复原样并核对。 - **写到允许的文件夹之外。** 导出、另存的副本和 BOM 文件只能写到 `Documents\dsh-solidworks`， 或你用 `--allow-write` 允许的文件夹。已存在的文件只有在明确要求时才会被替换。 - **丢掉别人的工作。** 只有当文档是这个 bridge 打开或新建的、且调用带了 `discard`，才会关闭有未保存修改的文档。 - **启动、关闭或点击 SOLIDWORKS。** 它连接你面前的那个 SOLIDWORKS，从不启动或退出它，也从不替你 回答对话框，而是把对话框的文字告诉你，因为回答是你的决定。 - **执行代码。** 没有宏、脚本或“调用任意 API”的工具。它能做的每一次 SOLIDWORKS 调用都列在 [`bridge/compat/members.tsv`](bridge/compat/members.tsv) 里。 - **把配对令牌放进模型上下文。** “未连接”的回答只说明配对包在哪里，从不包含令牌，所以对话记录里不会有它。 dsh 和另一台机器上的 bridge 之间的连接是双向认证的（双方在任何调用之前，用各自的新随机数做 HMAC-SHA256 证明自己持有令牌），但没有加密。它面向仅主机的虚拟机网络或本地网络；跨越其他网络时， 请通过 SSH 或 VPN 传输。详见 [SECURITY.md](SECURITY.md)。 ## 工作原理
逐条设计说明 - **几何只有一个坐标空间。** 草图点、选取点、探测点、零部件原点和包围盒都是模型空间的毫米值。bridge 用草图 自身的变换把每个草图点映射进去，所以面上的圆会出现在模型说的位置，不管 SOLIDWORKS 给那个面的草图取了什么轴。 选取时会让每个面或边给出离目标最近的点，所以结果不依赖视角、缩放或前面挡着什么，也从不改动你的选择。 - **对照意图检查。** `sw_build` 返回零件的体积和包围盒，`sw_probe` 返回面积和距离，`sw_interference` 返回重叠体积：都是模型可以拿来和它想做的东西对照的数字。做到一半失败的建模会删掉它做过的部分，所以零件要么建好， 要么保持原样。 - **一个 exe 支持所有版本。** bridge 不引用任何 SOLIDWORKS interop 程序集，每次调用都按名字走 `IDispatch`，所以驱动 2016 的同一个构建也能驱动 2019 及以后的版本，并且可以在 Linux CI 上构建。 `dynamic` 和 PowerShell 的 COM 适配器在跨进程访问 SOLIDWORKS 对象时都会失败 （`TYPE_E_ELEMENTNOTFOUND`，实测），`Type.InvokeMember` 不会。 - **2016 兼容性是检查出来的，不是假设的。** `bridge/compat/members.tsv` 列出 bridge 调用的 200 个成员及其接口。如果 bridge 调用了未列出的成员、没有用字面量写成员名，或列出的成员在 SOLIDWORKS 2016 SP1 interop 中不存在，测试就会失败。`SaveAs2`（2019 SP1+）、`Get6`（2018+）、`IEquationMgr.GlobalVariable` （2016 SP4+）就是这样被挡在外面的。 - **连接你正在看的那个实例。** 每个 SOLIDWORKS 都会在桌面会话的运行对象表里注册 `SolidWorks_PID_`。bridge 选择可见、且窗口层级最靠前的那个，而不是 `GetActiveObject` 随便返回的 一个。我们见过一台机器上同时有四个实例，其中三个不可见、卡在启动对话框上。 - **忙，而不是卡死。** 所有调用都在一个带 OLE 消息过滤器的 STA 线程上执行，SOLIDWORKS 忙时会重试。 超出预算的调用返回 `TIMEOUT`，并说明它是否还可能完成；之后的调用会立即返回 `SW_BUSY`，不会排在后面等， `sw_status` 依然能回答，并说出 SOLIDWORKS 正在等待的对话框。 - **主动连出，而不是监听。** 在另一台机器上时，由 bridge 连向 dsh。Windows 防火墙默认阻止入站，开端口 需要管理员；出站连接两者都不需要，而且能穿过虚拟机的 NAT。先连上的 bridge 保持连接；它离开后，心跳会在 几秒内释放这个位置。 - **一份契约。** `protocol/tools.json` 定义名称、参数结构、时间预算和错误码。bridge 内嵌它；插件用 dsh 自己的 `createMcpToolDefinition` 从它构建 dsh 工具，所以参数校验、错误结果和图片准入与任何 MCP server 的行为一致。
## 证据 本页的每一条说法都在 2026-10-18 对真实 SOLIDWORKS 跑过。 | 内容 | 结果 | | --- | --- | | 端到端实测，SOLIDWORKS 2016 SP1（24.1.0） | 66 项检查全部通过，经由真实的主动连出链路，用的就是发布的 exe | | 端到端实测，SOLIDWORKS 2019 SP0（27.0.0） | 66 项检查全部通过，同一个 exe | | 真实 dsh 0.2.0-rc.2 + `deepseek-flash`，dsh 在 Linux、SOLIDWORKS 2019 在虚拟机（listen） | 即上面四个片段：分别 12、17、23 和 13 次工具调用；其中一次被拒绝（对零件要 BOM：`WRONG_DOC_TYPE`，模型随即改正），其余全部完成 | | 真实 dsh 0.2.0-rc.2 + `deepseek-flash`，dsh 就在那台 Windows PC 上（spawn） | 在 0.1.0 上跑过，此后未改动：插件通过 dsh 的子进程服务启动自带 bridge；5 次工具调用全部完成；dsh 退出后没有残留 bridge 进程 | | 发布的 `swbridge.exe` | CI 从源码重新构建，得到同一个 SHA-256（`bridge/swbridge.exe.sha256`） | | 用生成的 `pair.cmd` 配对、登录自启、`uninstall` | 在 0.1.0 上跑过，此后未改动：无需管理员即装好；互斥锁下只有一个实例；卸载后不留痕迹 | | 单元测试（Linux，无需 SOLIDWORKS） | 48，包括 2016 成员检查和双方契约检查 | | `swbridge selftest`（Windows，无需 SOLIDWORKS） | 路径、单位、JSON、工程图布局和比例、图片留边、CSV，以及与插件共用的 HMAC 测试向量 |
实测检查的对照标准，以及各操作耗时 端到端检查用工具没有自己声明过的东西来检验每个回答。建模类检查的标准答案都由所要求的几何算出：上面那块板必须是 6000·20 − π·10²·20 − 4·25·(1 − π/4)·20 mm³，顶面面积是它除以 20；50 mm 立方体抽壳 2 mm、一面开口必须是 50³ − 46²·48 = 23,432 mm³；内外径 10/20 mm、长 30 mm 的旋转管加 1 mm 倒角必须是 π(20² − 10²)·30 − π·(20 − 1/3)； 设计研究取 10 mm 和 40 mm 时必须是顶面面积乘以 10 和 40，结束后板厚回到 20；两块面对面配合的板不能干涉，第三块压进 两者各 10 mm 时，与每块的重叠必须正好是顶面面积乘以 10；BOM 必须数出 3 件；工程图必须有四个与图纸比例一致的视图， 并能导出为 `%PDF-`。归属类检查基于一个不是 bridge 建的草图（保存、关闭再打开，bridge 已不记得它）：在它上面建模失败、 以及删除在它上面建的特征，都必须让这个草图保留；第二个图元就失败的草图必须让特征树保持原样。画在实体下方基准面上的给定深度切除必须自动反向，并正好去掉 π·5²·4 mm³； 和零件同名保存的工程图，用它的 `.slddrw` 名字导出的必须是工程图本身。0.1.0 的读取类检查也照常运行：样例 `box.sldprt` 在 `sw_edit` 把深度改成 150 mm 后必须是 325,500 mm³，取回的 STEP 必须与 bridge 的 SHA-256 一致，各种拒绝必须返回对应的错误码。2016 上的那次运行用的是一个 别人开着 58 个文档的装配体的 SOLIDWORKS；有一项检查确认他们的文档、修改标记、活动文档，以及他们装配体加载的 57 个零件都原样恢复。 经由链路在 0.2.1 的实测中测得，SOLIDWORKS 在 Windows 11 ARM64 上以 x64 仿真运行（较慢的一端是同时开着那个 58 个文档 装配体的 2016）：五步建板 3.2-4.3 s，一次探测 0.3-0.9 s，四视图拼图 2.5-3.4 s，出一张工程图 1.9-3.9 s，三零件装配体 干涉检查 1.1-3.2 s，打开零件 1.3-1.5 s，导出 STEP 0.4-0.5 s。
尚未验证：SOLIDWORKS 2020 及以后、Windows 10、x64 实机。欢迎反馈：[提一个 issue](https://github.com/dshworks/dsh-solidworks/issues/new/choose)， 并贴上 `swbridge status` 的输出。 ## 何时不适合用 - **需要放样、扫描、阵列、异型孔向导或钣金。** `sw_build` 只覆盖草图、拉伸、切除、旋转、圆角、倒角、抽壳和 基准面。草图几何是精确的，但不带草图尺寸和几何关系；特征自身的尺寸（深度、半径、角度）有名字，可以驱动。 - **文件是 STEP 或 IGES。** `sw_open` 只打开 SOLIDWORKS 文档，请先在 SOLIDWORKS 里导入。 - **想在 SOLIDWORKS 窗口里对话。** 没有任务窗格，对话在 dsh 里。 - **要遍历五万个面。** 跨进程 COM 每次调用都有往返开销，一次探测要问遍点附近的每个面。工具返回摘要； 重几何的工作适合插件（add-in）或导出的 STEP。 - **多台 SOLIDWORKS 机器同时接入一个 dsh。** 同一时间只有一个 bridge 持有连接。 ## 开发 ``` npm install && npm test # 插件、契约和 2016 成员检查，无需 Windows npm run build:bridge # 需要 .NET 8 SDK；为 net48 构建 bin/swbridge.exe SW_LINK_TOKEN=... node tests/live/e2e.mjs # 对一个连向本机的 bridge 做实测 ``` [CONTRIBUTING.md](CONTRIBUTING.md) 有其余说明，包括如何对你自己的 SOLIDWORKS 跑实测。`node scripts/format-contract.mjs` 让 `protocol/tools.json` 保持既定排版。MIT 许可，见 [LICENSE](LICENSE)。