___ _ __ dsh-solidworks
/ __| \ / /
\__ \\ \/\/ / DeepSeek Harness 的 SOLIDWORKS 连接器：
|___/ \_/\_/ 在你桌面上的 SOLIDWORKS 里建模、装配、检查、出图、导出
让 dsh 直接操作你已经打开的 SOLIDWORKS：2016 及以后版本，同一台 PC 或 Mac 上的 Windows 虚拟机都行。
21 个工具 · 已在 SOLIDWORKS 2016 SP1 和 2019 SP0 上实测 · 一个 bridge exe，无需安装运行时、无需管理员权限 · 你的文件默认只读 · MIT
看它工作 ·
开始使用 ·
工具 ·
它不会做什么 ·
工作原理 ·
证据 ·
English
一段话进去，一个法兰出来。 你描述零件，dsh 就在你桌面上的 SOLIDWORKS 里把它建出来，用它自己的算术核对体积
（两边都是 158,983.493 mm³），再从四个方向看一遍。它还能把零件装起来、检查干涉、汇总物料清单、出工程图，
也能处理你已有的文件：除非你同意，一律只读。
看它工作
每个片段都是一次真实会话：dsh 0.2.0-rc.2 加 deepseek-flash，SOLIDWORKS 2019 SP0 跑在 Parallels 虚拟机里，
画面录自 SOLIDWORKS 窗口。字幕是这次会话自己的工具调用和结果，以及模型自己的结束语。模型思考的时间被快进，
没有剪掉或调换任何内容。片段是怎么做的。
指给它看
你在 SOLIDWORKS 里选中一个面，告诉它要做什么。dsh 读取你的选择（法兰的上表面，8 条边），把这些边全部倒 2 mm
圆角，并解释为什么体积减少了 360.218 mm³，尽管其中一个圆角是在加材料。
装起来，检查是否合得上
建一根轴，两个零件都保存，再装配：轴穿过中心孔，法兰离轴端 40 mm。干涉：0 对。dsh 还把只是贴合的面也算了一遍，
指出 30 mm 的轴配 30 mm 的孔是零间隙配合。最后给出物料清单。
出图
工程图按投影关系布置视图，取能放进图纸的最大标准比例，导入模型尺寸，并以 PDF 的形式回到你的工作区。
左：导出的 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 虚拟机里
- 在 Mac 上执行
dsh plugin --profile web add @dshworks/dsh-solidworks，然后启动一次 dsh。
它会开始监听 bridge，并写出一个配对包。 - 在虚拟机里，以使用 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 用的地址不在配对包列出的地址里，手动指定：
# ~/.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
也附带它和 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里。 - 把配对令牌放进模型上下文。 “未连接”的回答只说明配对包在哪里，从不包含令牌，所以对话记录里不会有它。
dsh 和另一台机器上的 bridge 之间的连接是双向认证的（双方在任何调用之前，用各自的新随机数做
HMAC-SHA256 证明自己持有令牌），但没有加密。它面向仅主机的虚拟机网络或本地网络；跨越其他网络时，
请通过 SSH 或 VPN 传输。详见 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 进程 |
在 dsh 0.2.1-rc.2（2026-10-19 起是 npm 的 latest）上执行 dsh plugin add |
发布的包能装进一个全新的 profile，且不带任何 dsh 自己提供的包的副本；dsh-release-watch 每天重跑一次，dsh 新版本拒绝它时会开 issue。只验证了安装：上面的会话跑在 0.2.0-rc.2 上 |
发布的 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，
并贴上 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 有其余说明，包括如何对你自己的 SOLIDWORKS 跑实测。node scripts/format-contract.mjs
让 protocol/tools.json 保持既定排版。MIT 许可，见 LICENSE。
