返回目錄

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 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 外掛,絕不濫發。