前言¶
在 DeepSeek Harness(DSH)的插件生態中,處理工程圖紙文件(DWG/DXF)需要兼顧功能實現與安全性。直接操作 CAD 文件存在修改源文件的風險,且缺乏對解析過程的精細控制。dsh-cad-plugin 提供了一套原生工具,用於在不修改源文件的前提下,對 CAD 圖紙進行檢查、提取和導出。
插件簡介¶
dsh-cad-plugin 是一套專爲 DeepSeek Harness 設計的只讀 DWG/DXF 處理工具集。它由開發者 roymina 維護,採用 MIT 許可證。插件通過三個原生工具 (cad_inspect, cad_extract, cad_export) 封裝了 CAD 文件處理能力,核心價值在於資源隔離與數據安全。
安裝¶
插件通過 DSH 命令行安裝。請將 <your-profile> 替換爲你當前使用的配置文件名稱。
dsh plugin --profile <your-profile> add dsh-cad-plugin
安裝完成後,三個 CAD 工具將自動加載到 DSH 的可用工具列表中。
工具概覽¶
插件提供三個核心工具,均返回 JSON 格式的結果或錯誤信息:
| 工具名稱 | 功能描述 |
|---|---|
cad_inspect |
檢查圖紙元數據、單位、邊界、圖層、塊和實體統計。 |
cad_extract |
提取文本、圖層、塊或實體,支持 JSON/CSV 報告輸出。 |
cad_export |
導出 SVG/PNG 預覽或進行 DWG 轉 DXF 轉換。 |
使用方法¶
使用前,需將 .dwg 或 .dxf 文件放入 DSH 會話的工作目錄(Workspace)中。然後,通過自然語言提示讓模型解析文件路徑並調用相應工具。
典型提示詞示例:
- 檢查圖層與塊:
> “Inspectplan.dwgand summarize its layers and blocks.” - 提取文本到 CSV:
> “Extract all texts from./drawings/floorplan.dxfto CSV.” - 生成預覽:
> “Render an SVG preview ofplan.dwg(Model layout, white background).”
路徑說明:
路徑可以是絕對路徑(如 C:\drawings\plan.dwg),也可以是相對於工作目錄的相對路徑(如 plan.dwg 或 ./plan.dwg)。
注意: DeepSeek Harness Web composer 的附件按鈕目前僅支持圖片。若需處理 CAD 文件,請通過上述路徑引用文件,而非直接上傳。
資源限制與配置¶
插件採用資源保護機制,防止大文件或惡意文件導致系統崩潰。所有配置項均爲可選,以下爲默認值:
| 配置項 | 默認值 | 說明 |
|---|---|---|
outputDir |
./cad-output |
導出文件與報告的存放目錄。 |
maxFileSizeMB |
50 |
輸入文件最大允許大小。 |
maxEntities |
200000 |
最大解析實體數量。 |
maxExtractItems |
500 |
默認提取記錄數量限制。 |
maxImageDimension |
8192 |
PNG 導出的最大像素寬/高。 |
maxImagePixels |
64000000 |
PNG 導出的最大像素總數。 |
maxSvgBytes |
20000000 |
SVG 輸出最大字節數。 |
maxConcurrent |
2 |
最大併發 CAD 任務數。 |
maxWorkerTimeMs |
30000 |
單個任務硬超時時間(毫秒)。 |
數據隔離與驗證¶
- 輸出隔離: 所有輸出文件位於獨立目錄,且不會覆蓋已存在的同名文件。
- DXF 驗證: 導出 DXF 後,插件會重新打開文件,對比文本內容、實體類型和圖層,若發現嚴重不匹配,將返回
CONVERSION_VALIDATION_FAILED錯誤。