{"_id":"@dshworks/dsh-solidworks","_rev":"4-991bd7ddc3306886bb831dd4c0c04962","name":"@dshworks/dsh-solidworks","dist-tags":{"latest":"0.2.1"},"versions":{"0.0.0-stage":{"name":"@dshworks/dsh-solidworks","version":"0.0.0-stage","_id":"@dshworks/dsh-solidworks@0.0.0-stage","stub":true,"maintainers":[{"name":"lroolle","email":"reason-source6s@icloud.com"}],"dist":{"shasum":"791f3bd9508ce4040619a24f60eb9d4f707921c4","tarball":"https://registry.npmjs.org/@dshworks/dsh-solidworks/-/dsh-solidworks-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-TglbLjj7wxfnV5yHXAkC6y7WFrf6asJOoJ7dOgWt1KmRZWA4KCEvzEsElQkLSxoUKYxvH8SvyTaSe9oxGuaseA==","signatures":[{"sig":"MEQCID8DCGYXKG6JWa406t55/V0SZ0iFSraNq1QNzImHatXUAiAXXT61J//qGojNR77aZSTNF00lJtR78skCGy9IryBe3Q==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":346},"_npmUser":{"name":"lroolle","email":"reason-source6s@icloud.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.1.0":{"name":"@dshworks/dsh-solidworks","version":"0.1.0","keywords":["deepseek","deepseek-harness","dsh","dsh-plugin","solidworks","cad","mcp","mcp-server","solidworks-api","parallels"],"license":"MIT","_id":"@dshworks/dsh-solidworks@0.1.0","maintainers":[{"name":"lroolle","email":"reason-source6s@icloud.com"}],"homepage":"https://github.com/dshworks/dsh-solidworks#readme","bugs":{"url":"https://github.com/dshworks/dsh-solidworks/issues"},"dsh":{"bundle":{"patch":"./cordis.patch.yml"}},"dist":{"shasum":"7421e051bb1fea2163100deebc9ebd93963e6a36","tarball":"https://registry.npmjs.org/@dshworks/dsh-solidworks/-/dsh-solidworks-0.1.0.tgz","fileCount":14,"integrity":"sha512-h/TfnUsWWz2pBNc4iuznVOrC8woogXveMBvRkLe+ZLwdrj9jBnr4ytpizeqic2VPTEHqh61QQB6rU+yDBcB7lA==","signatures":[{"sig":"MEYCIQCvumMu/87/FBu3434sncQuw+YnDzXu8Kflc3r21O3lSAIhAONEex3iOUatD2w4OyKbQKJnhSwUEtRH2Z6xG1Yrg5x7","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDnn7EgF58kGnYz9JU8wjKys3qIXThHdT+LKfvDUAuq+wIgQzko7CZfFPrYGFpOBybAsWR/eVeyXMcvXQeUOJN8AA4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":213914},"main":"lib/index.js","type":"module","engines":{"dsh":"^0.2.0-rc.1","node":">=22"},"exports":{".":"./lib/index.js","./package.json":"./package.json"},"gitHead":"f3c5cc07148251c39d4ff704ff7750e4d24f0ec0","scripts":{"test":"vitest run","prepack":"node scripts/check-pack.mjs","build:bridge":"dotnet build bridge -c Release -nologo -o bin && rm -f bin/swbridge.exe.config && node scripts/check-pack.mjs"},"_npmUser":{"name":"lroolle","email":"reason-source6s@icloud.com"},"repository":{"url":"git+https://github.com/dshworks/dsh-solidworks.git","type":"git"},"_npmVersion":"10.9.9","description":"SOLIDWORKS for DeepSeek Harness: dsh reads, edits, rebuilds, renders and exports the models in a SOLIDWORKS 2016 or later, on the same Windows PC or in a Windows VM on your Mac. Read-only by default; the Windows side decides what may be written.","directories":{},"_nodeVersion":"22.23.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"semver":"^7.8.5","vitest":"^3.2.4","@deepseek-ai/cordis":"~4.0.4","@deepseek-ai/dsh-tools":"0.2.0-rc.2","@deepseek-ai/schemastery":"~3.18.4","@deepseek-ai/dsh-mcp-client":"0.2.0-rc.2"},"peerDependencies":{"@deepseek-ai/cordis":"^4.0.1","@deepseek-ai/schemastery":"^3.18.1","@deepseek-ai/dsh-mcp-client":"^0.2.0-rc.1"},"_npmOperationalInternal":{"tmp":"tmp/dsh-solidworks_0.1.0_1792298944984_0.6075815059238592","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@dshworks/dsh-solidworks","version":"0.2.0","keywords":["deepseek","deepseek-harness","dsh","dsh-plugin","solidworks","cad","mcp","mcp-server","solidworks-api","parallels"],"license":"MIT","_id":"@dshworks/dsh-solidworks@0.2.0","maintainers":[{"name":"lroolle","email":"reason-source6s@icloud.com"}],"homepage":"https://github.com/dshworks/dsh-solidworks#readme","bugs":{"url":"https://github.com/dshworks/dsh-solidworks/issues"},"dsh":{"bundle":{"patch":"./cordis.patch.yml"}},"dist":{"shasum":"6bb496f308169d59cf40b58f26b8c72badcfb7c7","tarball":"https://registry.npmjs.org/@dshworks/dsh-solidworks/-/dsh-solidworks-0.2.0.tgz","fileCount":14,"integrity":"sha512-to9h/2i04SWCqusSPMg59LFnRMN2Tzrr/hA1eplCyYcmsWZK7WPEmwJYZLfCukkk+QZddjrvAAKwOoJN4WsTlw==","signatures":[{"sig":"MEQCIEoFbsfz/MpBsBEXYjQxCUUWNTgNg7YrfXwrYyypBAPBAiAs+zw9l/+U2R3xMM4qhFtBL39rwWmJH1gcw8vO780I4w==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEYCIQDfNzAn834mnPfwO48TA3jIXnR+tVGZiaZ0to9IbjjQfAIhANRh86QjnjXqUvrYOdv/0JYjB6NWJ8qkrcV3bOfPmdWi","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":353633},"main":"lib/index.js","type":"module","engines":{"dsh":"^0.2.0-rc.1","node":">=22"},"exports":{".":"./lib/index.js","./package.json":"./package.json"},"gitHead":"6b82f49086b0cf50d000194982c094e6a2f482da","scripts":{"test":"vitest run","prepack":"node scripts/check-pack.mjs","build:bridge":"dotnet build bridge -c Release -nologo -o bin && rm -f bin/swbridge.exe.config && node scripts/check-pack.mjs"},"_npmUser":{"name":"lroolle","email":"reason-source6s@icloud.com"},"repository":{"url":"git+https://github.com/dshworks/dsh-solidworks.git","type":"git"},"_npmVersion":"10.9.9","description":"SOLIDWORKS for DeepSeek Harness: dsh reads, edits, rebuilds, renders and exports the models in a SOLIDWORKS 2016 or later, on the same Windows PC or in a Windows VM on your Mac. Read-only by default; the Windows side decides what may be written.","directories":{},"_nodeVersion":"22.23.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"semver":"^7.8.5","vitest":"^3.2.4","@deepseek-ai/cordis":"~4.0.4","@deepseek-ai/dsh-tools":"0.2.0-rc.2","@deepseek-ai/schemastery":"~3.18.4","@deepseek-ai/dsh-mcp-client":"0.2.0-rc.2"},"peerDependencies":{"@deepseek-ai/cordis":"^4.0.1","@deepseek-ai/schemastery":"^3.18.1","@deepseek-ai/dsh-mcp-client":"^0.2.0-rc.1"},"_npmOperationalInternal":{"tmp":"tmp/dsh-solidworks_0.2.0_1792342262786_0.8138341869351027","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"_id":"@dshworks/dsh-solidworks@0.2.1","dsh":{"bundle":{"patch":"./cordis.patch.yml"}},"bugs":{"url":"https://github.com/dshworks/dsh-solidworks/issues"},"dist":{"shasum":"c20289adb746512cd7affcf04d9b72cbcf56e269","tarball":"https://registry.npmjs.org/@dshworks/dsh-solidworks/-/dsh-solidworks-0.2.1.tgz","fileCount":14,"integrity":"sha512-YDPEJeBH0ti1lXDJduJAWZkeadyM2P7SmeMJlcRb1lYddnf5npMtPx/sabR6kxC0L/BgXcsmIrG44i2QoB0H5A==","signatures":[{"sig":"MEYCIQDcbdl94tgOgdwuaGz/lqiPaQF8t10818UCX6un72w2WwIhAIo/FzWKOwpYSmVwS7c574D6Q/IetgHei1IAq9GExzn0","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIBHlEBfk8iyNdw2hLGrjaEzYka4extoloEEw/M3CNbWcAiEA/u+7TcFsob3W5mmRffTCTH644EwIkTPJ3hd9K9/3WbI="}],"unpackedSize":359007},"main":"lib/index.js","name":"@dshworks/dsh-solidworks","type":"module","engines":{"dsh":"^0.2.0-rc.1","node":">=22"},"exports":{".":"./lib/index.js","./package.json":"./package.json"},"gitHead":"6641856114ccb657730b143059c3c56060620bf1","license":"MIT","scripts":{"test":"vitest run","prepack":"node scripts/check-pack.mjs","build:bridge":"dotnet build bridge -c Release -nologo -o bin && rm -f bin/swbridge.exe.config && node scripts/check-pack.mjs"},"version":"0.2.1","_npmUser":{"name":"lroolle","email":"reason-source6s@icloud.com"},"homepage":"https://github.com/dshworks/dsh-solidworks#readme","keywords":["deepseek","deepseek-harness","dsh","dsh-plugin","solidworks","cad","mcp","mcp-server","solidworks-api","parallels"],"repository":{"url":"git+https://github.com/dshworks/dsh-solidworks.git","type":"git"},"_npmVersion":"10.9.9","description":"SOLIDWORKS for DeepSeek Harness: dsh reads, edits, rebuilds, renders and exports the models in a SOLIDWORKS 2016 or later, on the same Windows PC or in a Windows VM on your Mac. Read-only by default; the Windows side decides what may be written.","directories":{},"maintainers":[{"name":"lroolle","email":"reason-source6s@icloud.com"}],"_nodeVersion":"22.23.3","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"semver":"^7.8.5","vitest":"^3.2.4","@deepseek-ai/cordis":"~4.0.4","@deepseek-ai/dsh-tools":"0.2.0-rc.2","@deepseek-ai/schemastery":"~3.18.4","@deepseek-ai/dsh-mcp-client":"0.2.0-rc.2"},"peerDependencies":{"@deepseek-ai/cordis":"^4.0.1","@deepseek-ai/schemastery":"^3.18.1","@deepseek-ai/dsh-mcp-client":"^0.2.0-rc.1"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/dsh-solidworks_0.2.1_1792344852176_0.9880834109863343"}}},"time":{"created":"2026-10-18T04:48:09.087Z","modified":"2026-10-18T17:34:12.426Z","0.0.0-stage":"2026-10-18T04:48:09.087Z","0.1.0":"2026-10-18T04:49:05.082Z","0.2.0":"2026-10-18T16:51:02.906Z","0.2.1":"2026-10-18T17:34:12.251Z"},"bugs":{"url":"https://github.com/dshworks/dsh-solidworks/issues"},"license":"MIT","homepage":"https://github.com/dshworks/dsh-solidworks#readme","keywords":["deepseek","deepseek-harness","dsh","dsh-plugin","solidworks","cad","mcp","mcp-server","solidworks-api","parallels"],"repository":{"url":"git+https://github.com/dshworks/dsh-solidworks.git","type":"git"},"description":"SOLIDWORKS for DeepSeek Harness: dsh reads, edits, rebuilds, renders and exports the models in a SOLIDWORKS 2016 or later, on the same Windows PC or in a Windows VM on your Mac. Read-only by default; the Windows side decides what may be written.","maintainers":[{"name":"lroolle","email":"reason-source6s@icloud.com"}],"readme":"<div align=\"center\">\n\n```\n   ___ _      __     dsh-solidworks\n  / __| \\    / /\n  \\__ \\\\ \\/\\/ /      DeepSeek Harness 的 SOLIDWORKS 连接器：\n  |___/ \\_/\\_/       在你桌面上的 SOLIDWORKS 里建模、装配、检查、出图、导出\n```\n\n**让 dsh 直接操作你已经打开的 SOLIDWORKS：2016 及以后版本，同一台 PC 或 Mac 上的 Windows 虚拟机都行。**\n\n</div>\n\n<p align=\"center\"><strong>\n21 个工具 · 已在 SOLIDWORKS 2016 SP1 和 2019 SP0 上实测 · 一个 bridge exe，无需安装运行时、无需管理员权限 · 你的文件默认只读 · MIT\n</strong></p>\n\n<p align=\"center\">\n<a href=\"https://github.com/dshworks/dsh-solidworks/actions/workflows/ci.yml\"><img src=\"https://github.com/dshworks/dsh-solidworks/actions/workflows/ci.yml/badge.svg\" alt=\"CI\"></a>\n<a href=\"https://www.npmjs.com/package/@dshworks/dsh-solidworks\"><img src=\"https://img.shields.io/npm/v/@dshworks/dsh-solidworks?color=CB3837&logo=npm&logoColor=white\" alt=\"npm\"></a>\n<a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-3DA639\" alt=\"MIT\"></a>\n<img src=\"https://img.shields.io/badge/SOLIDWORKS-2016%2B-DA291C\" alt=\"SOLIDWORKS 2016 及以后\">\n<img src=\"https://img.shields.io/badge/dsh-0.2.0--rc.2%20verified-1E90FF\" alt=\"已在 dsh 0.2.0-rc.2 上验证\">\n</p>\n\n<p align=\"center\">\n<a href=\"#看它工作\">看它工作</a> ·\n<a href=\"#开始使用\">开始使用</a> ·\n<a href=\"#工具\">工具</a> ·\n<a href=\"#它不会做什么\">它不会做什么</a> ·\n<a href=\"#工作原理\">工作原理</a> ·\n<a href=\"#证据\">证据</a> ·\n<a href=\"README.md\">English</a>\n</p>\n\n---\n\n<p align=\"center\">\n<img src=\"docs/media/flange.gif\" width=\"100%\" alt=\"dsh 根据一段话在 SOLIDWORKS 2019 里建出管法兰：圆盘、轮毂、中心孔、六个螺栓孔、圆角，再核对体积并从四个方向查看\">\n</p>\n\n**一段话进去，一个法兰出来。** 你描述零件，dsh 就在你桌面上的 SOLIDWORKS 里把它建出来，用它自己的算术核对体积\n（两边都是 158,983.493 mm³），再从四个方向看一遍。它还能把零件装起来、检查干涉、汇总物料清单、出工程图，\n也能处理你已有的文件：除非你同意，一律只读。\n\n## 看它工作\n\n每个片段都是一次真实会话：dsh 0.2.0-rc.2 加 `deepseek-flash`，SOLIDWORKS 2019 SP0 跑在 Parallels 虚拟机里，\n画面录自 SOLIDWORKS 窗口。字幕是这次会话自己的工具调用和结果，以及模型自己的结束语。模型思考的时间被快进，\n没有剪掉或调换任何内容。[片段是怎么做的](scripts/clips/README.md)。\n\n### 指给它看\n\n你在 SOLIDWORKS 里选中一个面，告诉它要做什么。dsh 读取你的选择（法兰的上表面，8 条边），把这些边全部倒 2 mm\n圆角，并解释为什么体积减少了 360.218 mm³，尽管其中一个圆角是在加材料。\n\n<p align=\"center\"><img src=\"docs/media/select.gif\" width=\"100%\" alt=\"在 SOLIDWORKS 里选中的面变成蓝色；dsh 读取选择并把它的八条边倒圆角\"></p>\n\n### 装起来，检查是否合得上\n\n建一根轴，两个零件都保存，再装配：轴穿过中心孔，法兰离轴端 40 mm。干涉：0 对。dsh 还把只是贴合的面也算了一遍，\n指出 30 mm 的轴配 30 mm 的孔是零间隙配合。最后给出物料清单。\n\n<p align=\"center\"><img src=\"docs/media/assemble.gif\" width=\"100%\" alt=\"dsh 建出轴、保存两个零件、装配轴和法兰、检查干涉并列出 BOM\"></p>\n\n### 出图\n\n工程图按投影关系布置视图，取能放进图纸的最大标准比例，导入模型尺寸，并以 PDF 的形式回到你的工作区。\n\n<p align=\"center\"><img src=\"docs/media/drawing.gif\" width=\"100%\" alt=\"dsh 以 1:2 第三角投影为法兰出图并导出 PDF\"></p>\n\n<p align=\"center\">\n<img src=\"docs/images/flange-drawing.png\" width=\"49%\" alt=\"导出的 PDF：法兰的前视、上视、右视和等轴测视图，1:2，带尺寸\">\n<img src=\"docs/images/flange-views.png\" width=\"49%\" alt=\"sw_view：法兰的前视、上视、右视和等轴测拼在一张图上\">\n</p>\n<p align=\"center\"><sub>左：导出的 PDF。右：<code>sw_view</code> 把四个视图拼在一张图上，dsh 就是这样看它做出来的东西。</sub></p>\n\n## 开始使用\n\n需要 dsh 0.2.0-rc.2 或更高版本（它的 `dsh plugin add` 依赖 pnpm，PATH 里要有 pnpm），以及一个正在\n运行的 SOLIDWORKS 2016 或更高版本。\n\n### dsh 和 SOLIDWORKS 在同一台 Windows PC 上\n\n```\ndsh plugin --profile web add @dshworks/dsh-solidworks\n```\n\n启动 SOLIDWORKS、启动 dsh、直接提问。插件会在第一次涉及 SOLIDWORKS 的提问时运行自带的\n`swbridge.exe`，不需要配对，也不需要安装任何东西。\n\n### dsh 在 Mac 上，SOLIDWORKS 在 Windows 虚拟机里\n\n1. 在 Mac 上执行 `dsh plugin --profile web add @dshworks/dsh-solidworks`，然后启动一次 dsh。\n   它会开始监听 bridge，并写出一个配对包。\n2. 在虚拟机里，以使用 SOLIDWORKS 的那个用户登录，打开 `\\\\Mac\\Home\\.dsh\\dsh-solidworks\\windows\\`\n   （Parallels 把你的 Mac 主目录共享在这里），双击 `pair.cmd`。\n\n这一步会为该 Windows 用户安装 bridge、连上 dsh，并设置为每次登录自动启动。不需要管理员，不需要\n防火墙规则：bridge 主动连向 dsh，Windows 一侧不开任何端口。配对前就向 dsh 提问的话，回答会告诉你\n配对包在哪里。\n\n在 VMware、另一台 PC，或没有开启 Parallels 共享的 Mac 上，把 `~/.dsh/dsh-solidworks/windows/` 文件夹\n复制到 Windows 上再运行 `pair.cmd`。如果虚拟机访问 Mac 用的地址不在配对包列出的地址里，手动指定：\n\n```yaml\n# ~/.dsh/profiles/web/cordis.patch.yml\n- id: dsh-solidworks\n  config:\n    advertise: ['10.211.55.2']   # Parallels 常见的宿主机地址\n```\n\n在虚拟机里撤销：`%LOCALAPPDATA%\\dsh-solidworks\\swbridge.exe uninstall`。\n\n### 在 Windows PC 上配合其他 MCP 客户端\n\n`swbridge.exe mcp` 是一个普通的 stdio MCP server，提供同样的 21 个工具：\n\n```\nclaude mcp add solidworks -- C:\\tools\\swbridge.exe mcp\n```\n\nexe 在本包的 `bin/swbridge.exe`，每个 [GitHub release](https://github.com/dshworks/dsh-solidworks/releases)\n也附带它和 SHA-256。\n\n## 工具\n\n长度一律用毫米，角度用度，质量用千克，与文档自身单位无关；字段名里写明单位（`value_mm`、`mass_kg`）。\n几何在所有工具里都用同一个坐标空间：模型空间的点 `[x, y, z]`，单位 mm，Y 轴朝上，前视基准面是 z = 0，\n上视是 y = 0，右视是 x = 0。面和边用其上的一个点来选取。`doc` 是已打开文档的路径、文件名或标题，\n默认是当前活动文档。\n\n<details>\n<summary><b>全部 21 个工具</b></summary>\n\n| 工具 | 作用 |\n| --- | --- |\n| `sw_status` | 版本（2016 SP1、2019 SP0 ……）、所有 SOLIDWORKS 实例、已打开文档，以及 SOLIDWORKS 正在等待的对话框。首先调用。 |\n| `sw_open` | 打开 `.sldprt`、`.sldasm` 或 `.slddrw`，默认只读，并设为活动文档。 |\n| `sw_new` | 用 SOLIDWORKS 的默认模板新建一个空的零件或装配体。 |\n| `sw_inspect` | 类型、单位、配置、材料、自定义属性、包围盒、实体数和零部件数。 |\n| `sw_features` | 特征树，含压缩状态和重建错误。 |\n| `sw_parameters` | 所有尺寸（`D1@Sketch1`、数值、单位、是否从动）和方程式，标出全局变量。 |\n| `sw_components` | 装配体的零部件树：文件、配置、状态、是否固定、位置。 |\n| `sw_mass_properties` | 质量、体积、表面积、密度、质心。 |\n| `sw_probe` | 某个点上是什么：那里的面、边或顶点，及其曲面或曲线类型、面积或长度、法向或轴线、直径和生成它的特征。不给点时，读取用户此刻在 SOLIDWORKS 里选中的东西。两个对象还会给出它们之间的距离和夹角。 |\n| `sw_edit` | 在内存中修改后统一重建一次：配置、压缩/解除压缩、全局变量、尺寸、自定义属性。每项修改都返回修改前后的值和各自的结果。 |\n| `sw_build` | 分步建模一个零件：在基准面或面上画草图（直线、多段线、矩形、圆、圆弧、中心线），拉伸或切除（给定深度、完全贯穿、两侧对称、拔模），旋转，圆角，倒角，抽壳，偏移基准面，删除。某一步失败时撤销本次调用。返回每个特征及其尺寸，以及零件的体积和包围盒。 |\n| `sw_study` | 一次调用里试最多 50 组尺寸和变量取值，每组都重建并测量（质量、体积、面积、质心、尺寸）；结束后把每个值恢复原样并核对。 |\n| `sw_rebuild` | 重建并列出每个失败的特征及原因。 |\n| `sw_assemble` | 把已保存的零件插入到指定原点位置，配合基准面、面、边或顶点（重合、同心、平行、垂直、相切、距离、角度），固定或浮动。 |\n| `sw_interference` | 所有相互重叠的零部件对及重叠体积，按体积从大到小。 |\n| `sw_bom` | 物料清单：每个文件和配置的数量及自定义属性，可展开到零件或只看顶层；可选输出 CSV。 |\n| `sw_drawing` | 为已保存的模型出图：按第一角或第三角投影布置视图，取能放进图纸的最大标准比例，并导入模型尺寸。 |\n| `sw_export` | 导出副本：STEP、IGES、Parasolid、ACIS、STL、PDF、DXF/DWG、eDrawings、JPG/PNG/TIF 或原生格式。返回路径、大小和 SHA-256；bridge 在另一台机器上时会自动取回到 dsh 工作区。 |\n| `sw_save` | 另存为允许的文件夹里的新文件（新文档就是这样得到文件的），或在 bridge 以 `--allow-save` 启动时覆盖源文件。 |\n| `sw_close` | 关闭文档；只有这个 bridge 自己做的未保存修改才会被丢弃。 |\n| `sw_view` | 渲染一张 PNG：一个标准视图，或最多六个视图拼在一张带标注的图上，着色、线框或消隐。之后恢复用户原来的视图。 |\n\n</details>\n\n## 它不会做什么\n\n这些规则在 Windows 一侧、文件所在的地方执行。dsh 可以提出任何请求，最终由 bridge 决定。\n\n- **不经允许修改你的文件。** 文档默认只读打开；`sw_edit`、`sw_build`、`sw_study` 和 `sw_assemble`\n  只改内存；`sw_save` 把新文件写到允许的文件夹里，只有 bridge 以 `--allow-save` 启动时才覆盖源文件。\n- **删掉你的工作。** `sw_build` 只删除它在本次 bridge 会话里建的特征，被这些特征吸收的你自己的草图会保留；\n  你的特征只能压缩，不能删除。退回控制棒不在特征树末尾时它拒绝建模，因为新特征会落在你的特征中间。\n  `sw_study` 会把每个值恢复原样并核对。\n- **写到允许的文件夹之外。** 导出、另存的副本和 BOM 文件只能写到 `Documents\\dsh-solidworks`，\n  或你用 `--allow-write` 允许的文件夹。已存在的文件只有在明确要求时才会被替换。\n- **丢掉别人的工作。** 只有当文档是这个 bridge 打开或新建的、且调用带了 `discard`，才会关闭有未保存修改的文档。\n- **启动、关闭或点击 SOLIDWORKS。** 它连接你面前的那个 SOLIDWORKS，从不启动或退出它，也从不替你\n  回答对话框，而是把对话框的文字告诉你，因为回答是你的决定。\n- **执行代码。** 没有宏、脚本或“调用任意 API”的工具。它能做的每一次 SOLIDWORKS 调用都列在\n  [`bridge/compat/members.tsv`](bridge/compat/members.tsv) 里。\n- **把配对令牌放进模型上下文。** “未连接”的回答只说明配对包在哪里，从不包含令牌，所以对话记录里不会有它。\n\ndsh 和另一台机器上的 bridge 之间的连接是双向认证的（双方在任何调用之前，用各自的新随机数做\nHMAC-SHA256 证明自己持有令牌），但没有加密。它面向仅主机的虚拟机网络或本地网络；跨越其他网络时，\n请通过 SSH 或 VPN 传输。详见 [SECURITY.md](SECURITY.md)。\n\n## 工作原理\n\n<details>\n<summary><b>逐条设计说明</b></summary>\n\n- **几何只有一个坐标空间。** 草图点、选取点、探测点、零部件原点和包围盒都是模型空间的毫米值。bridge 用草图\n  自身的变换把每个草图点映射进去，所以面上的圆会出现在模型说的位置，不管 SOLIDWORKS 给那个面的草图取了什么轴。\n  选取时会让每个面或边给出离目标最近的点，所以结果不依赖视角、缩放或前面挡着什么，也从不改动你的选择。\n- **对照意图检查。** `sw_build` 返回零件的体积和包围盒，`sw_probe` 返回面积和距离，`sw_interference`\n  返回重叠体积：都是模型可以拿来和它想做的东西对照的数字。做到一半失败的建模会删掉它做过的部分，所以零件要么建好，\n  要么保持原样。\n- **一个 exe 支持所有版本。** bridge 不引用任何 SOLIDWORKS interop 程序集，每次调用都按名字走\n  `IDispatch`，所以驱动 2016 的同一个构建也能驱动 2019 及以后的版本，并且可以在 Linux CI 上构建。\n  `dynamic` 和 PowerShell 的 COM 适配器在跨进程访问 SOLIDWORKS 对象时都会失败\n  （`TYPE_E_ELEMENTNOTFOUND`，实测），`Type.InvokeMember` 不会。\n- **2016 兼容性是检查出来的，不是假设的。** `bridge/compat/members.tsv` 列出 bridge 调用的\n  200 个成员及其接口。如果 bridge 调用了未列出的成员、没有用字面量写成员名，或列出的成员在 SOLIDWORKS 2016 SP1\n  interop 中不存在，测试就会失败。`SaveAs2`（2019 SP1+）、`Get6`（2018+）、`IEquationMgr.GlobalVariable`\n  （2016 SP4+）就是这样被挡在外面的。\n- **连接你正在看的那个实例。** 每个 SOLIDWORKS 都会在桌面会话的运行对象表里注册\n  `SolidWorks_PID_<pid>`。bridge 选择可见、且窗口层级最靠前的那个，而不是 `GetActiveObject` 随便返回的\n  一个。我们见过一台机器上同时有四个实例，其中三个不可见、卡在启动对话框上。\n- **忙，而不是卡死。** 所有调用都在一个带 OLE 消息过滤器的 STA 线程上执行，SOLIDWORKS 忙时会重试。\n  超出预算的调用返回 `TIMEOUT`，并说明它是否还可能完成；之后的调用会立即返回 `SW_BUSY`，不会排在后面等，\n  `sw_status` 依然能回答，并说出 SOLIDWORKS 正在等待的对话框。\n- **主动连出，而不是监听。** 在另一台机器上时，由 bridge 连向 dsh。Windows 防火墙默认阻止入站，开端口\n  需要管理员；出站连接两者都不需要，而且能穿过虚拟机的 NAT。先连上的 bridge 保持连接；它离开后，心跳会在\n  几秒内释放这个位置。\n- **一份契约。** `protocol/tools.json` 定义名称、参数结构、时间预算和错误码。bridge 内嵌它；插件用 dsh 自己的\n  `createMcpToolDefinition` 从它构建 dsh 工具，所以参数校验、错误结果和图片准入与任何 MCP server 的行为一致。\n\n</details>\n\n## 证据\n\n本页的每一条说法都在 2026-10-18 对真实 SOLIDWORKS 跑过。\n\n| 内容 | 结果 |\n| --- | --- |\n| 端到端实测，SOLIDWORKS 2016 SP1（24.1.0） | 66 项检查全部通过，经由真实的主动连出链路，用的就是发布的 exe |\n| 端到端实测，SOLIDWORKS 2019 SP0（27.0.0） | 66 项检查全部通过，同一个 exe |\n| 真实 dsh 0.2.0-rc.2 + `deepseek-flash`，dsh 在 Linux、SOLIDWORKS 2019 在虚拟机（listen） | 即上面四个片段：分别 12、17、23 和 13 次工具调用；其中一次被拒绝（对零件要 BOM：`WRONG_DOC_TYPE`，模型随即改正），其余全部完成 |\n| 真实 dsh 0.2.0-rc.2 + `deepseek-flash`，dsh 就在那台 Windows PC 上（spawn） | 在 0.1.0 上跑过，此后未改动：插件通过 dsh 的子进程服务启动自带 bridge；5 次工具调用全部完成；dsh 退出后没有残留 bridge 进程 |\n| 发布的 `swbridge.exe` | CI 从源码重新构建，得到同一个 SHA-256（`bridge/swbridge.exe.sha256`） |\n| 用生成的 `pair.cmd` 配对、登录自启、`uninstall` | 在 0.1.0 上跑过，此后未改动：无需管理员即装好；互斥锁下只有一个实例；卸载后不留痕迹 |\n| 单元测试（Linux，无需 SOLIDWORKS） | 48，包括 2016 成员检查和双方契约检查 |\n| `swbridge selftest`（Windows，无需 SOLIDWORKS） | 路径、单位、JSON、工程图布局和比例、图片留边、CSV，以及与插件共用的 HMAC 测试向量 |\n\n<details>\n<summary><b>实测检查的对照标准，以及各操作耗时</b></summary>\n\n端到端检查用工具没有自己声明过的东西来检验每个回答。建模类检查的标准答案都由所要求的几何算出：上面那块板必须是\n6000·20 − π·10²·20 − 4·25·(1 − π/4)·20 mm³，顶面面积是它除以 20；50 mm 立方体抽壳 2 mm、一面开口必须是\n50³ − 46²·48 = 23,432 mm³；内外径 10/20 mm、长 30 mm 的旋转管加 1 mm 倒角必须是 π(20² − 10²)·30 − π·(20 − 1/3)；\n设计研究取 10 mm 和 40 mm 时必须是顶面面积乘以 10 和 40，结束后板厚回到 20；两块面对面配合的板不能干涉，第三块压进\n两者各 10 mm 时，与每块的重叠必须正好是顶面面积乘以 10；BOM 必须数出 3 件；工程图必须有四个与图纸比例一致的视图，\n并能导出为 `%PDF-`。归属类检查基于一个不是 bridge 建的草图（保存、关闭再打开，bridge 已不记得它）：在它上面建模失败、\n以及删除在它上面建的特征，都必须让这个草图保留；第二个图元就失败的草图必须让特征树保持原样。画在实体下方基准面上的给定深度切除必须自动反向，并正好去掉 π·5²·4 mm³；\n和零件同名保存的工程图，用它的 `.slddrw` 名字导出的必须是工程图本身。0.1.0 的读取类检查也照常运行：样例 `box.sldprt` 在 `sw_edit` 把深度改成 150 mm 后必须是\n325,500 mm³，取回的 STEP 必须与 bridge 的 SHA-256 一致，各种拒绝必须返回对应的错误码。2016 上的那次运行用的是一个\n别人开着 58 个文档的装配体的 SOLIDWORKS；有一项检查确认他们的文档、修改标记、活动文档，以及他们装配体加载的 57 个零件都原样恢复。\n\n经由链路在 0.2.1 的实测中测得，SOLIDWORKS 在 Windows 11 ARM64 上以 x64 仿真运行（较慢的一端是同时开着那个 58 个文档\n装配体的 2016）：五步建板 3.2-4.3 s，一次探测 0.3-0.9 s，四视图拼图 2.5-3.4 s，出一张工程图 1.9-3.9 s，三零件装配体\n干涉检查 1.1-3.2 s，打开零件 1.3-1.5 s，导出 STEP 0.4-0.5 s。\n\n</details>\n\n尚未验证：SOLIDWORKS 2020 及以后、Windows 10、x64 实机。欢迎反馈：[提一个 issue](https://github.com/dshworks/dsh-solidworks/issues/new/choose)，\n并贴上 `swbridge status` 的输出。\n\n## 何时不适合用\n\n- **需要放样、扫描、阵列、异型孔向导或钣金。** `sw_build` 只覆盖草图、拉伸、切除、旋转、圆角、倒角、抽壳和\n  基准面。草图几何是精确的，但不带草图尺寸和几何关系；特征自身的尺寸（深度、半径、角度）有名字，可以驱动。\n- **文件是 STEP 或 IGES。** `sw_open` 只打开 SOLIDWORKS 文档，请先在 SOLIDWORKS 里导入。\n- **想在 SOLIDWORKS 窗口里对话。** 没有任务窗格，对话在 dsh 里。\n- **要遍历五万个面。** 跨进程 COM 每次调用都有往返开销，一次探测要问遍点附近的每个面。工具返回摘要；\n  重几何的工作适合插件（add-in）或导出的 STEP。\n- **多台 SOLIDWORKS 机器同时接入一个 dsh。** 同一时间只有一个 bridge 持有连接。\n\n## 开发\n\n```\nnpm install && npm test              # 插件、契约和 2016 成员检查，无需 Windows\nnpm run build:bridge                 # 需要 .NET 8 SDK；为 net48 构建 bin/swbridge.exe\nSW_LINK_TOKEN=... node tests/live/e2e.mjs   # 对一个连向本机的 bridge 做实测\n```\n\n[CONTRIBUTING.md](CONTRIBUTING.md) 有其余说明，包括如何对你自己的 SOLIDWORKS 跑实测。`node scripts/format-contract.mjs`\n让 `protocol/tools.json` 保持既定排版。MIT 许可，见 [LICENSE](LICENSE)。\n","readmeFilename":"README.zh.md"}