{"_id":"dsh-sw-cad","_rev":"6-7b0eafd9825fa0ed45a1dad49c22ce8a","name":"dsh-sw-cad","dist-tags":{"latest":"1.2.2"},"versions":{"0.0.0-stage":{"name":"dsh-sw-cad","version":"0.0.0-stage","_id":"dsh-sw-cad@0.0.0-stage","stub":true,"maintainers":[{"name":"27painter","email":"649181698@qq.com"}],"dist":{"shasum":"649c4f8dd07a64ee9bde469a8e20c26c21b4978b","tarball":"https://registry.npmjs.org/dsh-sw-cad/-/dsh-sw-cad-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-P0CoLhWLlKcX6GScYatmRxaQ8VFkRa08Vj+nVxazE6y5iQJ/NbrMWd3+oxzupcVp0Jpbb3LH2ptEbE4KtrOThg==","signatures":[{"sig":"MEUCIGawA/yRereOhnZLkXS4BczQgQS5l1PVAngzp6zoUhaSAiEA441t0QaDs2R//yX3dRV06N7Hvbf0oNWdVHkmLVYGhpE=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":332},"_npmUser":{"name":"27painter","email":"649181698@qq.com"},"description":"Temporary package placeholder for staged publishing","directories":{}},"0.1.0":{"name":"dsh-sw-cad","version":"0.1.0","keywords":["deepseek-harness","dsh","dsh-plugin","mcp","autocad","solidworks","cad","com","windows","ai-agent"],"author":{"name":"27painter"},"license":"MIT","_id":"dsh-sw-cad@0.1.0","maintainers":[{"name":"27painter","email":"649181698@qq.com"}],"homepage":"https://github.com/27painter/dsh-sw-cad","bugs":{"url":"https://github.com/27painter/dsh-sw-cad/issues"},"os":["win32"],"bin":{"dsh-sw-cad":"bin/dsh-sw-cad.mjs"},"dsh":{"bundle":{"patch":"./cordis.patch.yml"}},"dist":{"shasum":"e971e25e78a00678abb99c47281d4b6b098b55a9","tarball":"https://registry.npmjs.org/dsh-sw-cad/-/dsh-sw-cad-0.1.0.tgz","fileCount":19,"integrity":"sha512-WQ7t0yypfkZM5tGPveh9IJw8w/X4e0VVD4pb4mibOOWQiXiPQlVrkyr/xKLVFeXtQMJ/u7PUmsYUKQsL/pia6A==","signatures":[{"sig":"MEUCIQCWfkSg9au3HjvLkxYWkQXjCvOKTUjMMsLrZlrqkQfZEAIgVXWl7XtfUi80eHCFThSvw8kp6Jw6DiojxwOtQ2EEhXc=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIACwH9a6x7GkdfcjcW8BN5zzzRu5UJGo9Slcw2OiG7YBAiEAjrCgsKA7edtHW1AyWg8mF91BxdERMH/FUxGjS8GFDuY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":155564},"type":"module","engines":{"node":">=20"},"gitHead":"92d7a3abfe33e75017964c37bbb459449dd29297","scripts":{"check":"node bin/dsh-sw-cad.mjs doctor"},"_npmUser":{"name":"27painter","email":"649181698@qq.com"},"repository":{"url":"git+https://github.com/27painter/dsh-sw-cad.git","type":"git"},"_npmVersion":"11.17.0","description":"Drives the installed AutoCAD and SolidWorks desktop apps from dsh or Codex: two on-demand skills plus two MCP servers, with a discovery shim that keeps the SolidWorks tool catalog at 256 tokens instead of 23,404.","directories":{},"_nodeVersion":"24.19.0","_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/dsh-sw-cad_0.1.0_1792830233712_0.6995831247314841","host":"s3://npm-registry-packages-npm-production"}},"0.1.2":{"name":"dsh-sw-cad","version":"0.1.2","keywords":["deepseek-harness","dsh","dsh-plugin","mcp","autocad","solidworks","cad","com","windows","ai-agent"],"author":{"name":"27painter"},"license":"MIT","_id":"dsh-sw-cad@0.1.2","maintainers":[{"name":"27painter","email":"649181698@qq.com"}],"homepage":"https://github.com/27painter/dsh-sw-cad","bugs":{"url":"https://github.com/27painter/dsh-sw-cad/issues"},"os":["win32"],"bin":{"dsh-sw-cad":"bin/dsh-sw-cad.mjs"},"dsh":{"bundle":{"patch":"./cordis.patch.yml"}},"dist":{"shasum":"0492c606bb25381ac6fec1cd991b78e1ed4f0ab4","tarball":"https://registry.npmjs.org/dsh-sw-cad/-/dsh-sw-cad-0.1.2.tgz","fileCount":22,"integrity":"sha512-NVj3q/Q6oYFUpyJwGf4pKHhjujRas9UmAt8xWJ5uxqCtMbEr/c6saUgw0KhY0ES1FIRqehQQj/r2f/slEXE+rw==","signatures":[{"sig":"MEUCIQChMehWbtoyV+mVThLC2xYUnHXcWF0pZpMcxT7tu7SiRQIgL93iVxADR6p6f3dKps7biGyD4JLvi6Abm12t0obQubw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIERJkTsKtva3TLSlSg24QMz4YODm1CeMmW8H0I69Oo9eAiEA0GqFf2fXtXAtoleWgsYPtPUOZY55NmNk5TpLkB3R1rw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":169453},"main":"lib/index.js","type":"module","engines":{"node":">=20"},"exports":{".":"./lib/index.js","./lib/*":"./lib/*","./package.json":"./package.json"},"gitHead":"92d7a3abfe33e75017964c37bbb459449dd29297","scripts":{"check":"node bin/dsh-sw-cad.mjs doctor"},"_npmUser":{"name":"27painter","email":"649181698@qq.com"},"repository":{"url":"git+https://github.com/27painter/dsh-sw-cad.git","type":"git"},"_npmVersion":"11.17.0","description":"Drives the installed AutoCAD and SolidWorks desktop apps from dsh or Codex: two on-demand skills plus two MCP servers, with a discovery shim that keeps the SolidWorks tool catalog at 256 tokens instead of 23,404.","directories":{},"_nodeVersion":"24.19.0","_hasShrinkwrap":false,"peerDependencies":{"@deepseek-ai/dsh-mcp-client":">=0.2.0-rc.1 <0.3.0-0"},"_npmOperationalInternal":{"tmp":"tmp/dsh-sw-cad_0.1.2_1792894859448_0.9744755520474357","host":"s3://npm-registry-packages-npm-production"}},"0.1.3":{"name":"dsh-sw-cad","version":"0.1.3","keywords":["deepseek-harness","dsh","dsh-plugin","mcp","autocad","solidworks","cad","com","windows","ai-agent"],"author":{"name":"27painter"},"license":"MIT","_id":"dsh-sw-cad@0.1.3","maintainers":[{"name":"27painter","email":"649181698@qq.com"}],"homepage":"https://github.com/27painter/dsh-sw-cad","bugs":{"url":"https://github.com/27painter/dsh-sw-cad/issues"},"os":["win32"],"bin":{"dsh-sw-cad":"bin/dsh-sw-cad.mjs"},"dsh":{"bundle":{"patch":"./cordis.patch.yml"}},"dist":{"shasum":"8a4f6eb2e69caa5b3e8c31897322036ca2e64e98","tarball":"https://registry.npmjs.org/dsh-sw-cad/-/dsh-sw-cad-0.1.3.tgz","fileCount":22,"integrity":"sha512-jb8J4YGiqJVjQBgZUZqksTmj/OATkJ3RtMLimhMluNjj5tO0AENThkz3/PhWsPKC+Ex11rUP6QrNYEvnyRSf2w==","signatures":[{"sig":"MEUCIQC36PHAQbi1FMB/uBuBwwaNTqEyVzMs0s18hJuDfXFg+QIgUSxY4Z1Xi7ZqKaR14cEqd4/Ddz0woUujHC9Y4YhMfW4=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDdw0CYT/rS5ysnlMhWe/ybHTG1HaYEVKUpsBHh6pUyRAIgE8gWAXkodYLn10GAa0lpfwCdzJujCxsL8WeSITAHDbw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":172396},"main":"lib/index.js","type":"module","engines":{"node":">=20"},"exports":{".":"./lib/index.js","./lib/*":"./lib/*","./package.json":"./package.json"},"gitHead":"92d7a3abfe33e75017964c37bbb459449dd29297","scripts":{"test":"node test/plugin.test.mjs","check":"node bin/dsh-sw-cad.mjs doctor"},"_npmUser":{"name":"27painter","email":"649181698@qq.com"},"repository":{"url":"git+https://github.com/27painter/dsh-sw-cad.git","type":"git"},"_npmVersion":"11.17.0","description":"Drives the installed AutoCAD and SolidWorks desktop apps from dsh or Codex: two on-demand skills plus two MCP servers, with a discovery shim that keeps the SolidWorks tool catalog at 256 tokens instead of 23,404.","directories":{},"_nodeVersion":"24.19.0","_hasShrinkwrap":false,"devDependencies":{"@deepseek-ai/dsh-mcp-client":"0.2.0-rc.2"},"peerDependencies":{"@deepseek-ai/dsh-mcp-client":">=0.2.0-rc.1 <0.3.0-0"},"_npmOperationalInternal":{"tmp":"tmp/dsh-sw-cad_0.1.3_1792898225642_0.4558163420629051","host":"s3://npm-registry-packages-npm-production"}},"1.2.1":{"name":"dsh-sw-cad","version":"1.2.1","keywords":["deepseek-harness","dsh","dsh-plugin","mcp","autocad","solidworks","cad","com","windows","ai-agent"],"author":{"name":"27painter"},"license":"MIT","_id":"dsh-sw-cad@1.2.1","maintainers":[{"name":"27painter","email":"649181698@qq.com"}],"homepage":"https://github.com/27painter/dsh-sw-cad","bugs":{"url":"https://github.com/27painter/dsh-sw-cad/issues"},"os":["win32"],"bin":{"dsh-sw-cad":"bin/dsh-sw-cad.mjs"},"dsh":{"bundle":{"patch":"./cordis.patch.yml"}},"dist":{"shasum":"02b0c8a5e99f4aaab69572d86938ee52ed419346","tarball":"https://registry.npmjs.org/dsh-sw-cad/-/dsh-sw-cad-1.2.1.tgz","fileCount":20,"integrity":"sha512-vKpXV4dvTHtsrqTCEzrMDuE1QEjVUWuCPFR8JLtHbISDIS0NctSYNmSvKxI+aQ/SpghBv1x2fVHAOFCI1+4YYA==","signatures":[{"sig":"MEYCIQCNesIaqhzPWxXE+nOx7SwKUwtrN2VaFb5+63hyBAJ4iwIhANOKUZ/mmKoC1v6VYnrcMh1ybO7O2WTYWEuZcrjjeW7N","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQClcTjvFbo9CRbwTiDOR/HEvRixSzQBRad/J9KNmc2mzgIgeefO4CQGDNcsFnEJTuYV3Wpk6g8V2cHrMnsueqBkUdk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":148168},"main":"lib/index.js","type":"module","engines":{"node":">=20"},"exports":{".":"./lib/index.js","./lib/*":"./lib/*","./package.json":"./package.json"},"gitHead":"7cb4dd6db5298bf9f876051b896690ee56930728","scripts":{"test":"node test/plugin.test.mjs","check":"node bin/dsh-sw-cad.mjs doctor"},"_npmUser":{"name":"27painter","email":"649181698@qq.com"},"repository":{"url":"git+https://github.com/27painter/dsh-sw-cad.git","type":"git"},"_npmVersion":"11.17.0","description":"Drives the installed AutoCAD and SolidWorks desktop apps from dsh or Codex: two on-demand skills plus two MCP servers, both using their upstream's own tool discovery (2 and 3 entry tools instead of 242 and 66).","directories":{},"_nodeVersion":"24.19.0","_hasShrinkwrap":false,"readmeFilename":"README.zh.md","devDependencies":{"@deepseek-ai/dsh-mcp-client":"0.2.0-rc.2"},"peerDependencies":{"@deepseek-ai/dsh-mcp-client":">=0.2.0-rc.1 <0.3.0-0"},"_npmOperationalInternal":{"tmp":"tmp/dsh-sw-cad_1.2.1_1794824255540_0.6525323715112816","host":"s3://npm-registry-packages-npm-production"}},"1.2.2":{"os":["win32"],"_id":"dsh-sw-cad@1.2.2","bin":{"dsh-sw-cad":"bin/dsh-sw-cad.mjs"},"dsh":{"bundle":{"patch":"./cordis.patch.yml"}},"bugs":{"url":"https://github.com/27painter/dsh-sw-cad/issues"},"dist":{"shasum":"b746568a2a7a302023e34fe7095ae9cd174c924e","tarball":"https://registry.npmjs.org/dsh-sw-cad/-/dsh-sw-cad-1.2.2.tgz","fileCount":20,"integrity":"sha512-vcy+x4sOy0B9+AW/qFkqMKAnrcmKex+P3bUd7fDabvaUFECTnzntSbLza2ako50P9wCPWM6ySmpF46Lwm4fS9A==","signatures":[{"sig":"MEQCIEu2LkIlqj4jaIKiw2ywrOMl9avdWta1Qn+3qa1fbRVaAiBW96AGQ92mBiFUJ1Ttd0hFE5pTSs8KDATP+Gsg3vlkkg==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQDdadCBR5F23JvItVkcnZ7655pIdjhNs5+A0+CU/MQb1QIhAOm41WXB/dKwr+DhNpFIlPLCCJlyO+Kp1CP8xbHftEBX"}],"unpackedSize":148168},"main":"lib/index.js","name":"dsh-sw-cad","type":"module","author":{"name":"27painter"},"engines":{"node":">=20"},"exports":{".":"./lib/index.js","./lib/*":"./lib/*","./package.json":"./package.json"},"gitHead":"7cb4dd6db5298bf9f876051b896690ee56930728","license":"MIT","scripts":{"test":"node test/plugin.test.mjs","check":"node bin/dsh-sw-cad.mjs doctor"},"version":"1.2.2","_npmUser":{"name":"27painter","email":"649181698@qq.com"},"homepage":"https://github.com/27painter/dsh-sw-cad","keywords":["deepseek-harness","dsh","dsh-plugin","mcp","autocad","solidworks","cad","com","windows","ai-agent"],"repository":{"url":"git+https://github.com/27painter/dsh-sw-cad.git","type":"git"},"_npmVersion":"10.9.7","description":"Drives the installed AutoCAD and SolidWorks desktop apps from dsh or Codex: two on-demand skills plus two MCP servers, both using their upstream's own tool discovery (2 and 3 entry tools instead of 242 and 66).","directories":{},"maintainers":[{"name":"27painter","email":"649181698@qq.com"}],"_nodeVersion":"22.22.2","_hasShrinkwrap":false,"devDependencies":{"@deepseek-ai/dsh-mcp-client":"0.2.0-rc.2"},"peerDependencies":{"@deepseek-ai/dsh-mcp-client":">=0.2.0-rc.1 <0.3.0-0"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/dsh-sw-cad_1.2.2_1794824286890_0.04066637284039676"}}},"time":{"created":"2026-10-24T08:21:44.789Z","modified":"2026-11-16T10:18:07.211Z","0.0.0-stage":"2026-10-24T08:21:44.789Z","0.1.0":"2026-10-24T08:23:53.788Z","0.1.2":"2026-10-25T02:20:59.551Z","0.1.3":"2026-10-25T03:17:05.728Z","1.2.1":"2026-11-16T10:17:35.640Z","1.2.2":"2026-11-16T10:18:06.988Z"},"bugs":{"url":"https://github.com/27painter/dsh-sw-cad/issues"},"author":{"name":"27painter"},"license":"MIT","homepage":"https://github.com/27painter/dsh-sw-cad","keywords":["deepseek-harness","dsh","dsh-plugin","mcp","autocad","solidworks","cad","com","windows","ai-agent"],"repository":{"url":"git+https://github.com/27painter/dsh-sw-cad.git","type":"git"},"description":"Drives the installed AutoCAD and SolidWorks desktop apps from dsh or Codex: two on-demand skills plus two MCP servers, both using their upstream's own tool discovery (2 and 3 entry tools instead of 242 and 66).","maintainers":[{"name":"27painter","email":"649181698@qq.com"}],"readme":"# dsh-sw-cad\n\n[![license](https://img.shields.io/badge/license-MIT-blue)](LICENSE)\n[![npm](https://img.shields.io/npm/v/dsh-sw-cad?logo=npm)](https://www.npmjs.com/package/dsh-sw-cad)\n[![awesome-dsh-plugin](https://img.shields.io/static/v1?label=awesome-dsh-plugin&message=listed&color=blue)](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin)\n\n**两个 MCP 服务器 + 两个 Skill，让 DeepSeek Harness 或 Codex 的 agent 真正操控 CAD 软件。**\n它们封装了两个现成的开源项目——[U-C4N/Autocad-MCP](https://github.com/U-C4N/Autocad-MCP) 和\n[wzyn20051216/solidworks-automation-skill](https://github.com/wzyn20051216/solidworks-automation-skill)——\n让 agent 能在 AutoCAD 里画图、在 SolidWorks 里建模，并把结果导出。本仓库是**配置层**：隔离环境、启动参数、\n按需加载、客户端注册。它不 fork、不魔改、不重新分发这两个服务器。上游缺什么能力，本仓库就在它前面补一层\n——现在两台服务器都自带 discovery 模式，所以本仓库不再提供垫片，只负责把它们配置起来。\n\n[English](README.md) | 中文\n\n## 它做什么，什么时候需要它\n\n一个能\"看懂\"图纸的 CLI agent 有用，一个能\"产出\"图纸的 agent 是另一回事。装上本配置包后，dsh 或 Codex\n能接住这样一句话——\"按 ISO A3 图框画一个 M6 螺纹孔支座，标注后导出 PDF\"——并且真的做出来：建图层、画几何、\n标尺寸、盖标题栏、跑验证器，最后把文件交给你。\n\n代价和所有 COM 自动化一样：**CAD 软件必须开着，agent 必须和 CAD 同 Windows 用户、同完整性级别运行。**\n这不是云服务，原生 `.dwg` / `.sldprt` 输出也没有无头替代方案。\n\n两个 Skill 是入口。它们按需加载——只有当请求命中 SKILL.md 的 description 时才被读取，所以空闲会话不为此\n付出任何上下文成本：\n\n| Skill | 工作方式 |\n|---|---|\n| `solidworks-automation` | 脚本驱动：66 个 Python 模块（30 个 `sw_*.py` COM 封装 + OCCT/FEA/DFM 工具），自带预检、能力门禁与证据链 |\n| `autocad-mcp-pro` | 本仓库原创（上游没有 AutoCAD skill），通过两个元工具驱动 AutoCAD MCP |\n\n两个 MCP 服务器是肌肉，注册在客户端配置里：\n\n| 服务器 | 广告工具数 | 空闲成本 | 模式 |\n|---|---:|---:|---|\n| `autocad` | 2 | 365 token | 上游自带 `DISCOVERY_MODE=search`：只广告 `search_tools` + `call_tool`，242 个工具的目录按关键词检索 |\n| `solidworks` | 3 | 474 token | 上游 `SW_MCP_DISCOVERY=search`：`sw_search_tools` / `sw_describe_tool` / `sw_call_tool`；66 个工具的目录（50 个 `solidworks_*` + 14 个 `cadstudio_*` + 2 个 `design_*`）按需检索，全量广告要 23,411 token |\n\n<picture>\n  <source media=\"(prefers-color-scheme: dark)\" srcset=\"docs/token-cost-dark.svg\">\n  <img alt=\"常驻上下文成本柱状图：AutoCAD 直连 83,732 token，SolidWorks 直连 23,411，两个都直连 107,143，本仓库配置 839\" src=\"docs/token-cost-light.svg\">\n</picture>\n\n*工具定义是在你提出第一个请求之前就要付掉的。两台服务器直连要 107,143 token，走本仓库这套配置是 839，\n省 99.2%。两边用的是同一种测法：线上 `tools/list` 的字节数，用 `cl100k_base` 计数。*\n\n```\n你说人话\n   │\n   ├─ dsh / Codex 按 SKILL.md 的 description 按需加载 Skill\n   │      ├─ solidworks-automation  → sw_*.py 脚本 → COM → SolidWorks\n   │      └─ autocad-mcp-pro        → search_tools / call_tool → MCP → AutoCAD\n   │\n   └─ MCP 服务器（cordis.patch.yml / codex config.toml）\n          ├─ autocad    上游 discovery 模式，242 工具按需检索\n          └─ solidworks 上游 discovery，3 个入口工具，66 工具按需检索\n                          └─ 首次调用时才拉起上游 server.py\n```\n\n## 哪些是上游的，哪些是本仓库的\n\n这一点在这里比通常更重要——两个服务器都是别人的成果。分工如下：\n\n| 部分 | 来源 | 许可证 |\n|---|---|---|\n| AutoCAD MCP 服务器（`autocad-mcp-pro`） | [U-C4N/Autocad-MCP](https://github.com/U-C4N/Autocad-MCP)，从 PyPI 安装 | MIT |\n| SolidWorks Skill + MCP 服务器 | [wzyn20051216/solidworks-automation-skill](https://github.com/wzyn20051216/solidworks-automation-skill)，安装时克隆 | MIT |\n| `skills/autocad-mcp-pro/SKILL.md` | 本仓库原创——上游没有 AutoCAD skill | MIT |\n| `bin/`、`lib/`（含探测 CAD COM 服务器的 `probe.py`）、`package.json`、`cordis.patch.yml`、`install.ps1`、`bootstrap.ps1`、`codex-config.snippet.toml`、`assets/`、两份 README | 本仓库原创 | MIT |\n\n**上游代码一行都没有进仓库。** 安装脚本在运行时才去 PyPI 取包、克隆（或 zip 下载）SolidWorks 仓库，所以\n你拿到的永远是上游当前版本，著作权也始终归上游。本仓库补的是它们缺失的那一层：经过验证的启动参数、\n两台服务器的 discovery 模式配置、按需 Skill 接线、把几个 G 的依赖挡在 C 盘之外的\njunction 技巧，以及一个在 git 协议被拦时还能装完的安装器。\n\n**有一个例外，而且是故意的：** `patches/` 装着两个上游缺陷的修复——竖向线性标注量出来是 0.0，\n以及每条边的直径和长度都返回 null，两者都不报错。两个都已在向上游提 PR；在合并之前，\n`install.ps1` 会把补丁打到已安装的副本上，`bootstrap.ps1` 会报告补丁是否在位。\n详见 [`patches/README.md`](patches/README.md)。\n\n## 安装\n\n三条路，挑一条。装之前先看本节末尾的前置条件。\n\n### 1. 作为 dsh 插件安装（推荐）\n\n```bash\ndsh plugin --profile web add dsh-sw-cad\n```\n\n这就是全部。`package.json` 里声明了 `dsh.bundle.patch`，dsh 会读到本仓库的 `cordis.patch.yml`，\n它只插入一行：这个包本身。包是一个真正的 cordis 插件（`lib/index.js`），不是包着一个可执行文件的壳，\n所以 dsh 直接从 profile 里 import 它，不需要任何东西在 PATH 上。\n\n首次加载时插件会自己解析路径，缺上游就把**钉死版本**的上游装好（几分钟，只一次），然后注册两个 MCP\n客户端（绝对路径）。装不上就直接抛错，带上缺失的路径和重跑的命令——而不是注册两行起不来的配置，\n让人以为装好了却没有工具。设 `SW_CAD_NO_AUTO_INSTALL=1` 可以关掉自动安装，把缺失项变成一条明确的报错。\n\n### 2. npm 全局安装（附带 CLI）\n\n```bash\nnpm install -g dsh-sw-cad\ndsh-sw-cad install\n```\n\n结果一样，额外把 `dsh-sw-cad` 放进 PATH，可以用 `doctor`、`where`、`serve`——不想启动 dsh 就想先查一下\n装没装好时有用。\n\n### 3. 不用 npm：`bootstrap.ps1`\n\n```powershell\ngit clone https://github.com/27painter/dsh-sw-cad.git\ncd dsh-sw-cad\n.\\bootstrap.ps1 -Check     # 只检测，不改动；缺东西时退出码为 1\n.\\bootstrap.ps1            # 缺什么装什么\n```\n\n它检查十项，只修缺失或过期的部分：\n\n| 检查项 | 由谁修复 |\n|---|---|\n| Python ≥ 3.11 | 不修——报出问题就停 |\n| `venv-autocad` + `autocad-mcp-pro` | `install.ps1` |\n| `venv-solidworks` + `mcp` / `pymupdf` / `ezdxf` / `pywin32` | `install.ps1` |\n| SolidWorks skill 克隆 | `install.ps1` |\n| `~/.dsh/skills` junction | 创建 |\n| `~/.dsh/cordis.patch.yml` 条目 | `install.ps1`（先备份） |\n| `~/.codex/skills` junction | 创建 |\n| `~/.codex/config.toml` 条目 | 追加（先备份） |\n\n跑第二次是空操作。全部就绪时退出码 `0`，否则 `1`，所以可以放心塞进脚本或交给 agent。\n除非核心组件真的缺失，否则不会下载任何东西。\n\n> [!WARNING]\n> 第 3 条路还会写 `~/.dsh/cordis.patch.yml`。如果你同时又装了插件，那就是用同一个 `serverName` 把同样\n> 两个服务器注册了第二遍，dsh 会拒绝重复注册，会话直接起不来。两条路只能走一条：装了插件就把\n> `~/.dsh/cordis.patch.yml` 留成 `[]`。\n\n### 命令一览\n\n| 命令 | 作用 |\n|---|---|\n| `dsh-sw-cad install` | 装钉死版本的上游服务器，并写 `~/.dsh/sw-cad.json` |\n| `dsh-sw-cad doctor` | 报告哪些有、哪些缺，并打印钉死的版本；不改动，缺东西时退出码 1 |\n| `dsh-sw-cad where` | 打印服务器会用到的每一条路径 |\n| `dsh-sw-cad serve autocad\\|solidworks` | 以 stdio 跑一个 MCP 服务器，用于手动测试 |\n\n`install` 是幂等的，而且插件首次加载时会自动跑一遍。版本钉在 `lib/upstream.json`——`autocad-mcp-pro` 1.6.0\n加一个固定的 SolidWorks skill 提交——所以今天装和一个月后装，拿到的是同一套服务器。\n\n> [!TIP]\n> **不想自己敲这些命令？** 把下面这段发给你的 agent（dsh、Codex，或任何能在这台机器上跑命令的 agent），\n> 它会替你装完——后面几节只在出问题时才需要看。\n\n```text\n在这台 Windows 机器上安装 https://github.com/27painter/dsh-sw-cad。\n\n运行：npm install -g dsh-sw-cad && dsh-sw-cad install\n第一条装包，第二条装两个上游服务器（AutoCAD MCP 与 SolidWorks skill）并写好客户端条目。\ndsh-sw-cad install 是幂等的，只补缺失的部分。\n\n不要提权运行：它必须和 AutoCAD、SolidWorks 是同一个 Windows 用户。\n除 ~/.dsh 与 ~/.codex 之外不要往 C 盘写东西，也不要动 CAD 安装目录和注册表。\n装完用 dsh-sw-cad doctor、dsh --profile headless --dump-config、codex mcp list 验证。\n哪一步失败就如实报告，不要自己绕过。\n```\n\n### 前置条件\n\n- Windows 10/11，已安装 AutoCAD 和/或 SolidWorks\n- PATH 里有 Python ≥ 3.11（`python --version`）\n- dsh（DeepSeek Harness）或 Codex CLI；第 1、2 条路还需要 Node ≥ 20\n- Git —— 可选；git 被拦时安装器会自动降级为 codeload zip 下载\n\n先把仓库拿到本地：\n\n```powershell\ngit clone https://github.com/27painter/dsh-sw-cad.git\ncd dsh-sw-cad\n```\n\n### 机器上没装 CAD 应用会怎样\n\n注册之前插件会先查两个 COM 服务器（`lib/probe.py`，查注册表 ProgID，不会启动任何一个应用）。\n只装了 AutoCAD 就只注册 AutoCAD 那一行，只装了 SolidWorks 就只注册那一行；两个都没装就一行都\n不注册，并在日志里说明——而不是放两个只能失败的工具在那里。\n\n```\n[dsh-sw-cad] solidworks: no COM server registered on this machine, not registering it\n[dsh-sw-cad] registered autocad (base D://cad-agents, upstream pinned in lib/upstream.json)\n```\n\n`SW_CAD_DISABLE=autocad,solidworks` 可以把这个判断改成显式设置，`dsh-sw-cad doctor` 会在不启动\ndsh 的情况下打印探测结果。\n\n另外，**装过**不等于**开着**。AutoCAD 注册过但没启动，工具会一直等应用响应，最后报一条“可能有模态\n对话框”的错；SolidWorks 的 health_check 报的是装没装，不是开没开。所以把 CAD 应用以与 agent 同一个\nWindows 用户启动，是安装之后最后要做的一步。\n\n\n### 版本支持\n\n上游都是\"按一个版本验收、按一个区间写代码\"，实际情况是：\n\n| CAD | 已验证 | 预期可用 | 依据 |\n|---|---|---|---|\n| AutoCAD | 2026（所有 COM 路径真机跑过）、2027（API 兼容） | 2025 / 2024 / 2023 | COM 走的是长期稳定的 ActiveX 接口。想确认你的版本，跑上游的 `scripts\\smoke_*_com.py`。另外某个功能在你这版 COM 上做不了时，ezdxf 后端照样能做——它根本不需要 AutoCAD。 |\n| SolidWorks | 2026 SP4.1（上游验收目标）、**2025 SP05**（真机跑过：零件 → 草图 → 矩形 → 拉伸 → 保存 → STEP） | 2024 / 2023 | 代码里带明确的 SW2024 修复（中文版按名称选草图、`AddComponent4` 返回 `None`），上游贡献指南要求 2020–2025 兼容。2025 那次跑出来的草图名是中文 `草图1`，所以那段兼容路径也被实际走到了。2023 没有实际跑过。 |\n\n老版本不会被拒绝——代码里没有任何版本号检查。它们只是不在上游的验证范围内，所以**先拿一个小任务试，看过结果再信任整张图**。\n\n**这个包自己实际跑过什么。** 下面的真机验证是 2026 年 10 月在 AutoCAD 2026 和 SolidWorks 2026 SP4.1 上做的。\n之后又单独跑过 **SolidWorks 2025 SP05**（零件 → 草图 → 矩形 → 拉伸 → 一个实体 → 保存 → STEP，草图名是中文），\n所以 2025 现在也算验证过了；AutoCAD 这边只跑过 2026 一个版本。\n\n### 附录 —— 上游自己的安装步骤\n\n下面就是两个上游项目自己的安装说明。`install.ps1` 自动化的也是这些步骤，所以想理解或排查安装过程时看这一节。\n\n**AutoCAD MCP 服务器** —— [上游安装说明](https://github.com/U-C4N/Autocad-MCP#install)。装进数据盘上的 venv\n（本仓库推荐做法）：\n\n```powershell\npython -m venv D:\\cad-agents\\venv-autocad\nD:\\cad-agents\\venv-autocad\\Scripts\\python.exe -m pip install \"autocad-mcp-pro[full]\"\nD:\\cad-agents\\venv-autocad\\Scripts\\autocad-mcp.exe --help    # stdio 服务器入口\n```\n\n不建 venv 的话，上游自己的一行式安装：\n\n```bash\npip install autocad-mcp-pro              # 或：uvx autocad-mcp-pro\nautocad-mcp                              # 后端自动选择\nAUTOCAD_MCP_BACKEND=ezdxf autocad-mcp    # 无头 DXF，不需要 AutoCAD\nAUTOCAD_MCP_BACKEND=com   autocad-mcp    # 实控 AutoCAD（需要 [com] extra）\n```\n\nextras 含义：`[com]` = 实控 AutoCAD（pywin32 + Pillow），`[pdf]` = matplotlib（PDF/PNG 输出），\n`[office]` = openpyxl（XLSX 算量），`[full]` = 以上全部。上游还文档化了 HTTP 传输\n（`autocad-mcp --transport http --port 8000`）以及 Claude Desktop / Cursor 的 JSON 配置写法。\n\n**SolidWorks Skill + MCP** —— [上游快速开始](https://github.com/wzyn20051216/solidworks-automation-skill#quick-start)。\n上游提供三种入口，任选其一：\n\n```bash\n# 方式 1 —— 只装 Skill（最简单）\nnpx github:wzyn20051216/solidworks-automation-skill\n\n# 方式 2 —— 通过 Smithery 装 MCP\nnpm install -g @smithery/cli\nsmithery mcp add wzyn20051216/solidworks-automation-skill --client codex --config '{}'\n\n# 方式 3 —— CAD Studio 桌面版，去上游 Releases 下载\n```\n\n手动克隆（本仓库的做法；想把 skill 放数据盘就用这个）：\n\n```powershell\ngit clone --depth 1 https://github.com/wzyn20051216/solidworks-automation-skill.git D:\\cad-agents\\dsh-skills\\solidworks-automation\nD:\\cad-agents\\venv-solidworks\\Scripts\\python.exe -m pip install -r D:\\cad-agents\\dsh-skills\\solidworks-automation\\requirements.txt\nD:\\cad-agents\\venv-solidworks\\Scripts\\python.exe -m pip install -r D:\\cad-agents\\dsh-skills\\solidworks-automation\\mcp-server\\requirements.txt\nD:\\cad-agents\\venv-solidworks\\Scripts\\python.exe D:\\cad-agents\\dsh-skills\\solidworks-automation\\scripts\\cad_doctor.py\n```\n\n**给 SolidWorks 服务器设 `SW_MCP_DISCOVERY=search`**（上面三条路都会自动做，这里是手动步骤）。上游从\n2026-10-29 起默认就是这个值，所以没配过的客户端本来就会拿到三个入口工具；显式设一下，是为了万一上游\n把默认改回去时仍然成立。不设的话，客户端每次请求都要背着 66 个工具定义——23,411 token。\n\n**把两个服务器注册到客户端。** dsh 读 `~/.dsh/cordis.patch.yml`——把本仓库的 `cordis.patch.yml` 拷过去即可。\n它只插入一行——这个包本身——由插件自己去注册服务器，所以不需要任何东西在 PATH 上\n（`npm install -g dsh-sw-cad`）。Codex 读 `~/.codex/config.toml`——追加 `codex-config.snippet.toml`，或者用\n上游自带的注册脚本（`mcp-server\\register_codex_mcp.ps1 -Python <venv 的 python> -InstallDependencies`）。\nCodex 那份里是绝对路径，要按你的 `-BaseDir` 改。\n\n**让 Skill 可见。** 两个客户端都只扫自己的技能目录：\n\n```powershell\n# dsh：整个 skills 目录做一个 junction（与 install.ps1 行为一致）\nNew-Item -ItemType Directory -Force -Path \"$env:USERPROFILE\\.dsh\" | Out-Null\nNew-Item -ItemType Junction -Path \"$env:USERPROFILE\\.dsh\\skills\" -Target \"D:\\cad-agents\\dsh-skills\"\n\n# Codex：每个 skill 单独 junction（它的 skills 目录里可能还有别的技能）\nNew-Item -ItemType Directory -Force -Path \"$env:USERPROFILE\\.codex\\skills\" | Out-Null\nNew-Item -ItemType Junction -Path \"$env:USERPROFILE\\.codex\\skills\\solidworks-automation\" -Target \"D:\\cad-agents\\dsh-skills\\solidworks-automation\"\nNew-Item -ItemType Junction -Path \"$env:USERPROFILE\\.codex\\skills\\autocad-mcp-pro\"       -Target \"D:\\cad-agents\\dsh-skills\\autocad-mcp-pro\"\n```\n\n### 附录 —— `install.ps1` 干了什么\n\n`install.ps1` 会把上面附录里的事全跑一遍，外加那些容易做错的部分：两个 venv 落在数据盘、junction 接线、\ndiscovery 模式参数、以及 `~/.dsh/cordis.patch.yml` 的带时间戳备份。\n\n```powershell\npowershell -ExecutionPolicy Bypass -File .\\install.ps1\n\n# 自定义位置 / 强制重建\n.\\install.ps1 -BaseDir \"E:\\cad\" -WorkDir \"E:\\AutoCad\" -Force\n```\n\n它依次检查 Python、建目录、建两个 venv、装 `autocad-mcp-pro[full]` 和 SolidWorks 依赖、克隆 skill\n（直接下固定提交的 zip，不需要 git）、把 `patches/` 打到已安装的副本上、junction 进 `~/.dsh/skills`、\n写 dsh 配置、落下 AutoCAD skill。\n\n不确定机器上已经装了什么的话，用 `bootstrap.ps1`：它自己会判断需不需要跑 `install.ps1`。\n\n**Codex 用户仍需一步**——把 `codex-config.snippet.toml` 追加到 `~/.codex/config.toml`，并把两个 skill\njunction 进 `~/.codex/skills/`（即附录里的最后四条命令）。\n\n> [!IMPORTANT]\n> **先开 CAD，并且同用户启动。** COM 自动化要跨一个被 Windows 按用户和完整性级别守护的进程边界。\n> 如果 agent 以管理员身份启动、CAD 以普通身份运行（或反过来），它什么也连不上，而失败现象看起来只是\n> \"工具什么都没干\"。\n>\n> 这条只适用于 COM。[`dsh-nx`](https://github.com/27painter/dsh-nx) 走的是 NXOpen，跑在 NX 进程\n> 内部——那边的窗口挂不上去，所以那个插件自己起批处理会话，**不要**预先打开 NX。这个习惯不要照搬。\n\n## 使用\n\n直接描述要画的东西，Skill 会自己加载。\n\n```text\n用 AutoCAD 画一个轴承座：底座 120×80×10，立板高 60 厚 12，顶部 φ40 通孔。\nISO A3 图框带标题栏和尺寸标注，存到 D:\\AutoCad 并导出 PDF。\n```\n\n```text\n在 SolidWorks 里建一个法兰：外径 100，厚 20，中心孔 30，均布 4 个 M10 螺栓孔。\n存 SLDPRT 并导出 STEP。\n```\n\n几条踩过坑的经验：\n\n- **SolidWorks 的工具参数要多套一层。** 上游工具把参数放在 `params` 键下面，所以调用长这样：\n  `call_tool(name=\"solidworks_sketch_and_extrude\", arguments={\"params\": {\"shape\": \"rectangle\",\n  \"width_mm\": 60, \"height_mm\": 40, \"depth_mm\": 10}})`。AutoCAD 的工具是平铺的。写错了会报\n  pydantic 的 `params Field required`，看到那个就知道是这回事。\n- **一次只说一个 CAD。** 同时提两个会加载两个 Skill，任务也容易混。\n- **复杂任务先要计划。** 两个 Skill 都有规划环节；在画几何之前先审计划，比画错了再撤销便宜。\n- **主动要预览。** AutoCAD 路线最后有 8 步验证器加截图；SolidWorks 路线会导出四张正交预览图。\n  说一句\"把预览图给我看\"是合理要求，Skill 会照做。\n  一个实测过的注意事项：AutoCAD 的截图需要窗口可见——隐藏或最小化时拿回来是空白图。几何本身始终可以\n  通过 API 验证（handle、包围盒、质量属性），所以别把空白截图当成画错了。\n\n## 验证\n\n```powershell\n# 该装的都装了吗？只读检测，缺东西时退出码 1\ndsh-sw-cad doctor\n\n# 服务器会用到的每一条路径\ndsh-sw-cad where\n\n# 上游补丁还在不在位？只读检测，有一条漂了就退出码 1\npython patches\\apply_patches.py --check\n\n# dsh 是否看见两个服务器、两个技能\npnpm dsh --profile headless --dump-config\npnpm dsh --profile headless \"列出当前可用的 skill\"\n\n# SolidWorks 技能自检（Python 依赖 + COM）\n& \"D:\\cad-agents\\venv-solidworks\\Scripts\\python.exe\" \"D:\\cad-agents\\dsh-skills\\solidworks-automation\\scripts\\sw_preflight.py\"\n\n# 用 dsh 实际调用的同一个入口，验证两个服务器都能握手\nnode bin\\dsh-sw-cad.mjs serve solidworks     # 应为 solidworks_mcp，3 个入口工具\nnode bin\\dsh-sw-cad.mjs serve autocad        # 应为 AutoCAD MCP Pro，2 个入口工具\n\n# Codex\ncodex mcp list\n```\n\n发布前实际验证过的（AutoCAD 2026 与 SolidWorks 2026 都在运行）：`system_status` 返回\n`connected: true`、`backend: com`、运行中的版本号和当前活动文档名；`drawing_info` 返回打开文档的实体数、\n范围与单位；`layer_list` 返回实时的图层表；SolidWorks 侧返回 `status: ok` 并识别到正在运行的实例。\n两个 `serve` 目标也都能通过包自带的入口完成 JSON-RPC 握手——AutoCAD 服务器自报\n`AutoCAD MCP Pro 3.4.11`（pip 包是 1.6.0，版本号在服务器侧是另一套），SolidWorks 侧自报\n`solidworks_mcp` 1.30.0——两边分别广告 2 个和 3 个入口工具。discovery 能按关键词检索到\n`gear_draw_spur_front_view` / `keyway_draw_keyed_bore`；`dsh --dump-config` 两条记录都能加载且命令为\n`dsh-sw-cad`；SolidWorks 自检通过。SolidWorks 侧做了端到端实测：\n`sw_search_tools` 用中文「健康检查」能命中 `solidworks_health_check`，`sw_call_tool` 把它送到运行中的\n`solidworks_health_check` 转发给了真实运行的 SolidWorks 2026。\n\n## 设计说明\n\n**1. discovery 模式是这套配置的核心。** 242 个工具定义全量广告是 83,732 token。discovery 模式下客户端只看到\n两个工具（365 token），检索目录里带 206 个 AutoCAD 命令名 + 1439 个同义词——说\"倒角\"能找到 `FILLET`。\n\n**2. SolidWorks 那侧以前需要垫片，后来上游自己做了。** 2026-10-29 之前，那台服务器无条件注册全部 66 个\n工具，线上实测就是 23,411 token，还没问任何问题就先付掉了，所以本仓库当时带了一个只广告两个元工具的垫片。\n后来上游自己实现了同一件事，做得更完整，本仓库就切了过去：`SW_MCP_DISCOVERY=search` 暴露\n`sw_search_tools` / `sw_describe_tool` / `sw_call_tool`（474 token），中英同义词按概念计分，而且\n`sw_describe_tool` 能按需返回单个 schema——这是垫片做不到的。垫片被删掉了，没有留成第二份实现：\n一个功能一旦由它的上游自己维护，再并行维护一份只会慢慢漂走。\n\n**3. `TOOL_PROFILE` 保持 `full`、`TOOL_PACKS` 保持 `all`。** 它们只收缩\"可检索目录\"，不改变空闲成本。\n实测 `lean + core,mech` 会把目录砍到 58 个工具，参数化齿轮和键槽工具直接搜不到——收缩 packs 只丢能力，\n一个 token 也省不下。\n\n**4. 用 junction，不复制。** dsh 只扫 `~/.dsh/skills`，Codex 只扫 `~/.codex/skills`。目录联接把两边都指到\n数据盘，两个工具都无感知。删联接不删数据。\n\n**5. 把文件访问圈起来。** AutoCAD 服务器的 `ALLOWED_PATHS` 默认是空的，它自己的 README 也要求你设置。\n本配置包把它设为一个工作目录。\n\n**6. 分清什么验证过。** 安装章节的版本表写得很直白：上游验证过 AutoCAD 2026 和 SolidWorks 2026 SP4.1，\n其余都是\"预期\"而非\"已证明\"——先拿小任务试。\n\n**7. discovery 不是免费，只是延后。** 每次调用多一个来回：先搜再调。只画一个方块时它比直连慢，而且上游\nskill 更新后没重建目录，检索结果会过期。但 CAD 任务通常一次会话里要调好几个工具，这笔账是划算的。\n\n**8. 它是插件，不是 patch 调一个可执行文件。** 第一版注册的两行 MCP 客户端，`command` 写的是\n`dsh-sw-cad`——只有全局安装过才解析得到，于是单独跑 `dsh plugin add` 会留下两行起不来的配置。评审指出\n了这一点，指得对。现在 `lib/index.js` 本身就是一个 cordis 插件，由它自己用绝对路径注册两个客户端，\nPATH 依赖没了，也才有可能在注册之前先检查上游。\n\n**9. 钉死版本，因为\"最新\"不是一个版本号。** `lib/upstream.json` 记录了这套配置验证时的确切\n`autocad-mcp-pro` 版本和确切的 SolidWorks skill 提交；`install.ps1` 的 pip 安装和压缩包下载都用它。\n改它就是一次刻意的提交：发布前要确认 `SW_MCP_DISCOVERY=search` 仍然只暴露那三个入口工具。\n\n## 排障\n\n| 现象 | 原因 / 处理 |\n|---|---|\n| dsh 列不出 skill | `~/.dsh/skills` 必须是 junction 且目标存在；目录名必须等于 frontmatter 的 `name` |\n| Codex 列不出 skill | `~/.codex/skills\\` 下两个 junction 是否都在；Codex 版本需支持 skills |\n| AutoCAD 工具调了没反应 | CAD 没开，或用户/完整性级别不一致；设 `AUTOCAD_MCP_BACKEND=com` 排除 ezdxf 降级 |\n| SolidWorks 自检不过 | 缺依赖（装 skill 的 `requirements.txt`）或 SW 没开 |\n| `sw_search_tools` 搜不出有用的东西 | 服务器跑在 `full` 模式，没有检索入口——检查 `SW_MCP_DISCOVERY` |\n| `call_tool` 报\"Could not start the SolidWorks MCP server\" | 客户端配置里的 `--python` / `--server` 路径不对，或 skill 被移动了 |\n| `codex mcp list` 为空 | 追加段必须在 `config.toml` 末尾；路径要双反斜杠 |\n| 安装时 `git clone` 失败 | 安装器会自动降级到 codeload zip 下载 |\n\n## 许可证\n\nMIT（见 [LICENSE](LICENSE)）。上游组件保持各自 MIT 许可证，本仓库不重新分发它们。\n\n## 收录\n\n[![M8ven Score](https://m8ven.ai/badge/mcp/27painter-dsh-sw-cad-72nbze?v=cf1d61753707805eaa75dbd27f05c229)](https://m8ven.ai/mcp/27painter-dsh-sw-cad-72nbze?s=readme)\n","readmeFilename":"README.zh.md"}