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
安裝步驟
- 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
- 02
或走全域 npm:`npm install -g dsh-sw-cad`,再執行 `dsh-sw-cad install`(結果相同,還多了 PATH 上的 CLI)
$ npm install -g dsh-sw-cad
- 03
只走一條路線——外掛已安裝時,`~/.dsh/cordis.patch.yml` 要留成 `[]`
- 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 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 通過不等於完全合規。
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 通過不等於完全合規,報告裡會這樣寫。
07相關的 DSH 工作流程
dsh-baton
作者 jialaoliu
通過 MCP 在 Claude Code 或 Codex 與本地 DeepSeek Harness 之間移交任務,並將結果帶回原會話。
dsh-crew
作者 zseven-w
從 Claude Code / Codex 向 DSH 智慧體派發任務的外掛,支援原生子智慧體進度、分層工作會話與多模態橋接。
dsh-mcp-apps-host
作者 oriliz
DeepSeek Harness 的 MCP Apps 託管外掛:在沙箱 iframe 中渲染 MCP _meta.ui 互動式 HTML 卡片,並通過 postMessage 橋接 MCP 工具呼叫與資源讀取。
eac-design-world
作者 ebony-vinyl
DeepSeek Harness 本地影片製作與設計外掛:多軌剪輯、模板與設計體系、原生預覽畫布和真實檔案匯出
08資料與來源
**1. As a dsh plugin** — the whole install is one line; `package.json` declares `dsh.bundle.patch`, so dsh
loads `cordis.patch.yml`, which inserts one row: this package. On first load the plugin resolves its paths,
`dsh --dump-config` loads both rows from this package.
此頁面根據專案公開文件、儲存庫中繼資料與 DSH Plugins 的結構化解析所產生;最後核實於 2026-11-20。發現錯誤?提交更正。
最佳 DeepSeek Harness 外掛
從全目錄挑出的 12 個值得優先安裝的外掛,涵蓋各個分類。
