返回目录

dsh-sw-cad

精选清单收录维护状态: 活跃

27painter/dsh-sw-cad

让 DSH/Codex 通过 MCP 调用 SolidWorks 和 AutoCAD 的 CAD 自动化技能,适用于 Windows COM 环境。

前往 GitHub
$ dsh plugin --profile web add dsh-sw-cad

15

星标

1

Fork

Python

语言

MIT

许可证

2026-10-23

创建于

2026-11-17

最近推送

MIT 的 dsh/Codex 插件:把两个固定上游版本的 CAD MCP server(AutoCAD 242 个工具、SolidWorks 66 个工具,都藏在检索入口后)连同自研的 AutoCAD skill 和 `deliver` 交付闸门打包在一起——交出的不是 agent 的口头「做完了」,而是别人能复核的结论。

DSH 适配

原生运行时

作者声明

安全审计

未审计

最后核验

2026-11-20

许可证

MIT

01它能帮你完成什么?

  • 用一句自然语言描述,在真正运行的 AutoCAD / SolidWorks 里画图或建模

    磁盘上的真实文件——带标题栏和标注的 DXF/DWG 图纸、SLDPRT/SLDASM 零件和 STEP 导出——外加预览(AutoCAD 是八步校验器加截图,SolidWorks 是四视图)

    在 Windows 工作站上装着 AutoCAD 和/或 SolidWorks、用 dsh(或 Codex)的机械设计工程师

  • 把「agent 说它做完了」换成别人能复核的结论

    `delivery.json`:每项检查一行 PASS / warn / FAIL,每个文件一个 SHA-256,退出码 0 或 1

    要把图纸交给审核人或车间、需要机器可验证产出的团队

  • 在图纸离开工位之前,把图上的数值摁到标准表上

    `half` 档:配合、材料牌号、热处理与表面处理、Ra 系列只要不在 `lib/standards.json` 里就判失败;既没材料也没 Ra 的图纸同样判失败

    需要对自己的图纸做一轮预审的制图负责人

02如何接入 DeepSeek Harness?

前置条件

  • Windows 10/11,装好 AutoCAD 和/或 SolidWorks——集成方式就是 COM 自动化
  • Python ≥ 3.11
  • 走插件与 npm 路线时需要 Node ≥ 20
  • dsh(DeepSeek Harness)或 Codex;Git 可选,被墙时安装器会退回复用 codeload zip

安装步骤

  1. 01

    按 dsh 插件装:`dsh plugin --profile web add dsh-sw-cad`——package.json 声明了 `dsh.bundle.patch`,dsh 会加载 `cordis.patch.yml` 并插入一行

    $ dsh plugin --profile web add dsh-sw-cad

  2. 02

    或者走全局 npm:`npm install -g dsh-sw-cad`,再 `dsh-sw-cad install`(结果一样,还多了 PATH 上的 CLI)

    $ npm install -g dsh-sw-cad

  3. 03

    只走一条路线——插件已装的情况下,`~/.dsh/cordis.patch.yml` 要留成 `[]`

  4. 04

    先启动 AutoCAD / SolidWorks,并且用和 agent 相同的用户启动

验证接入成功

  • `dsh-sw-cad doctor`——只读,缺东西时退出 1
  • `dsh --profile headless --dump-config`——确认 dsh 能看到两行 server 配置
  • `node bin\dsh-sw-cad.mjs serve solidworks`——JSON-RPC 握手,应返回 3 个入口工具
  • `python patches\apply_patches.py --check`——只读,上游补丁漂移时退出 1

03DSH 适配与能力边界

DSH 适配原生运行时

原生 dsh 插件包:`dsh plugin --profile web add dsh-sw-cad` 会加载它的 `cordis.patch.yml` 行,解析路径、按需装上固定版本的上游 server,再用绝对路径把两个 CAD MCP client 注册给 agent

  • AutoCAD MCP server:242 个工具藏在一个检索入口后

    先用 `search_tools` 按关键词搜,再用 `call_tool` 传平铺参数→通过 COM 操作正在运行的 AutoCAD;不需要 AutoCAD 时走 headless ezdxf

    会驱动真实的 AutoCAD 进程;AutoCAD 里开着模态对话框时调用会卡住
  • SolidWorks MCP server + 自动化 skill:66 个工具、66 个 Python 模块

    `sw_search_tools`、`sw_describe_tool`、`sw_call_tool`,参数要套在 `params` 里→草图、拉伸、零件、装配等操作,STEP 导出,四视图预览

    会驱动正在运行的 SolidWorks 实例
  • `deliver` 交付闸门

    一个装产出的文件夹:`.dxf`、`.dwg`、`.pdf`、`.step`、`.sldprt`/`.sldasm`、`*_review_report.json`→每项检查一行 PASS / warn / FAIL、带 SHA-256 的 `delivery.json`、退出码 0 或 1

    不启动任何 CAD 程序,只读磁盘上已有的文件
  • 上下文瘦身

    真正需要时发出的关键词检索→AutoCAD 2 个入口工具、SolidWorks 3 个入口工具,替代整整 308 个工具的 schema

    每次调用工具前多一次检索往返
  • `doctor` / `where` 自检

    只读的健康报告(缺东西时退出 1),以及两个 server 接下来会用到的每一个路径

04适合谁?何时不该用?

适合

  • 在 Windows 工作站上装着 AutoCAD 和/或 SolidWorks、用 dsh(或 Codex)的机械设计工程师
  • 要把图纸交给审核人或车间、需要机器可验证产出的团队
  • 需要对自己的图纸做一轮预审的制图负责人

不适合

  • 只能在 Windows 上用:核心就是 AutoCAD 与 SolidWorks 的 COM 自动化,需要 Windows 10/11、装好其中一个或两个 CAD,外加 Python ≥ 3.11。
  • CAD 必须先用和 agent 相同的用户(相同完整性级别)启动。提权跑的 agent 连正常启动的 CAD 都连不上,现象就是「工具什么也没做」。
  • 只能走一条安装路线。从 checkout 装的那条还会写 `~/.dsh/cordis.patch.yml`;插件已装时,同一个 `serverName` 会重复注册,dsh 拒绝,会话直接起不来。
  • `deliver` 通过只说明这些文件作为文件站得住:它不查公差配合值(`H7/g6`)、材料、热处理、表面粗糙度、尺寸链是否闭合,也不判断零件能不能加工。`half` 档只是把数值和 `lib/standards.json` 比对,half 通过不等于完全合规。

05兼容性、维护与安全提示

  • 只能在 Windows 上用:核心就是 AutoCAD 与 SolidWorks 的 COM 自动化,需要 Windows 10/11、装好其中一个或两个 CAD,外加 Python ≥ 3.11。
  • CAD 必须先用和 agent 相同的用户(相同完整性级别)启动。提权跑的 agent 连正常启动的 CAD 都连不上,现象就是「工具什么也没做」。
  • 只能走一条安装路线。从 checkout 装的那条还会写 `~/.dsh/cordis.patch.yml`;插件已装时,同一个 `serverName` 会重复注册,dsh 拒绝,会话直接起不来。
  • `deliver` 通过只说明这些文件作为文件站得住:它不查公差配合值(`H7/g6`)、材料、热处理、表面粗糙度、尺寸链是否闭合,也不判断零件能不能加工。`half` 档只是把数值和 `lib/standards.json` 比对,half 通过不等于完全合规。
2026-10-232026-11-17作者未说明

MIT · 活跃维护(最后推送 2026-11-17;仓库暂无 release,CLI 就是交付面)

06常见问题

AutoCAD 和 SolidWorks 都要装吗?

不用。插件在注册之前会先探 COM 注册表,只注册它找到的那个 server——只装一个 CAD 的机器就注册一个;`SW_CAD_DISABLE=autocad` 可以把这个判断变成设置项;两个都没装就什么都不注册,并直接说出来,而不是给一堆只会失败的工具。

在 DeepSeek Harness 里怎么装?

一行:`dsh plugin --profile web add dsh-sw-cad`。package.json 声明了 `dsh.bundle.patch`,所以 dsh 会加载 `cordis.patch.yml`、插入一行、解析路径,首次加载时把固定版本的上游 server 装上;装不上就带着失败的那个路径抛错,而不是注册一堆会静默失败的行。也可以用 `npm install -g dsh-sw-cad` 加 `dsh-sw-cad install`,或者从 checkout 跑 `bootstrap.ps1 -Check`(只检查不改动)。三条路线只用一条。

交付检查到底读什么?

DXF 走 ezdxf:DIMENSION 实体、图层表、`$INSUNITS`、图纸空间布局里有没有东西、图幅是否合 ISO 216、有没有写比例、线宽层级、中文文字用的字体、叠在一起的尺寸文字、标题栏线索。PDF 走 PyMuPDF:页面尺寸和文字层是否真实。STEP:schema 解析成 AP203/214/242、实体与 CARTESIAN_POINT 数量、包围盒。评审报告:`evaluation.status == pass`。空文件夹直接判失败。

工具什么都没做,也不报错,是怎么回事?

基本是 COM:CAD 没开,或者它跑在和 agent 不同的用户 / 完整性级别下,也可能是 AutoCAD 里开着模态对话框。先启动 AutoCAD / SolidWorks,并用同一个用户;如果 AutoCAD 工具先卡住再提到某个对话框,去关掉授权、保存或恢复面板。

`half` 档是什么?

`normal`(默认)只检查文件;`half` 还要求图上的配合(`H7/g6`)、材料牌号(`45`、`40Cr`、`6061`)和粗糙度都来自 `lib/standards.json`,没有材料也没有 Ra 的图纸判失败。用 `dsh-sw-cad mode half` 按任务设一次,或用 `--profile half` 单次覆盖。half 通过不等于完全合规,报告里会这么写。

08数据与来源

  • 作者声明github.com9bb37f5e958e…

    **1. As a dsh plugin** — the whole install is one line; `package.json` declares `dsh.bundle.patch`, so dsh

  • 作者声明github.com9bb37f5e958e…

    loads `cordis.patch.yml`, which inserts one row: this package. On first load the plugin resolves its paths,

  • 作者声明github.com9bb37f5e958e…

    `dsh --dump-config` loads both rows from this package.

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-20。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。