前言¶
在 DeepSeek Harness (DSH) 生態中，智能體通常擅長處理文本或通用代碼，但在機械設計領域，處理幾何形狀和工程文件需要特定的能力。dsh-cad-design 插件通過集成 CadQuery 和 ezdxf，爲智能體提供了參數化 CAD 設計能力，使其能夠編寫建模代碼、校驗幾何、渲染預覽並導出製造文件。
這是什麼¶
dsh-cad-design 是一個參數化 CAD 工具集，專爲 DeepSeek Harness 設計。它允許智能體編寫 CadQuery 代碼來構建 3D 零件，或編寫 ezdxf 代碼來生成 2D 工程圖。該工具鏈覆蓋了從代碼編寫、幾何校驗、預覽渲染到文件導出的完整工作流。
核心功能¶
該插件包含以下主要功能：
- 3D 建模：基於 CadQuery 和 OpenCASCADE 內核，支持原生 STEP 導出。
- 2D 繪圖：基於 ezdxf，支持生成和導出 DXF 工程圖。
- 幾何校驗：使用
cad_validate工具檢查代碼生成的幾何體的有效性。 - 預覽渲染：使用
cad_render生成 PNG 或 SVG 預覽圖，並提供體積或邊界框等事實數據。 - 文件導出：支持導出 STEP、IGES、STL、3MF (CadQuery) 和 DXF (ezdxf) 格式。
- 文件轉換：使用
cad_convert在不同製造格式間轉換。 - 參數化技能：內置
cadquery-design技能（用於 3D 零件設計）和ezdxf-drafting技能（用於 2D 草圖繪製）。
安裝與配置¶
使用該插件前，需要安裝相應的 Python 依賴：
pip install cadquery # 3D 建模依賴
pip install ezdxf matplotlib # 2D 繪圖及預覽依賴
安裝插件時，必須顯式指定 --profile 參數。通常使用包含 Web 界面的 web profile：
dsh plugin --profile web add dsh-cad-design
安裝完成後，可通過 cad_doctor 工具檢查環境配置和依賴情況。
配置示例¶
插件的配置位於目標 profile 的 cordis.patch.yml 中。以下是配置片段：
- insert:
- id: cad-tools
name: dsh-cad-design
config:
workDir: '' # 默認爲 <session cwd>/.dsh/cad
timeoutSeconds: 120
enableSkill: true
backendPriority: # 後端路由優先級
- cadquery
- ezdxf
cadquery:
enabled: true
pythonPath: '' # 留空則自動檢測
ezdxf:
enabled: true
pythonPath: ''
環境變量 DSH_CAD_PYTHON 也可用於覆蓋默認的 Python 解釋器路徑。
典型用法¶
當用戶下達設計指令時，智能體通常按以下流程操作：
- 加載技能：智能體加載
cadquery-design或ezdxf-drafting技能。 - 校驗：執行
cad_validate對代碼和幾何結果進行校驗。 - 預覽：執行
cad_render生成預覽圖（PNG/SVG）。 - 迭代：根據預覽結果調整代碼，直到設計符合要求。
- 導出：執行
cad_export將文件導出爲 STEP 或 DXF 等格式。
例如，用戶指令爲 “Design an M8 hex-nut retainer, 3 mm wall, and export STEP”，智能體將按上述步驟完成設計並輸出 retainer.step 文件。
注意事項¶
- 執行權限：
cad_*工具會在本地執行 Python 代碼。插件本身不實現策略限制，在共享或不可信環境中部署時，需配合 DSH 的tools/pre-execute鉤子進行權限控制。 - Profile 限制：安裝插件必須顯式指定
--profile，且該 profile 必須包含界面 bundle（如webprofile）。 - 生態區分：npm 上存在另一個同名插件
dsh-cad（由 LAU-MARS 維護），這是一個 CAD 查看器插件，與本插件互補，本插件負責建模出圖，它負責在 Web 界面中查看模型。 - 環境要求：需要 Python 3.10+ 及對應的 pip 包（cadquery/ezdxf/matplotlib）。
結語¶
dsh-cad-design 將參數化 CAD 能力引入了 DSH 智能體工作流，使智能體能夠從代碼生成直接跨越到製造文件輸出。對於需要自動化機械設計流程的開發者，該插件提供了從設計到驗證的完整工具鏈。
