dsh-cad-design
Parametric CAD tools for the DeepSeek Harness (dsh) — let your agent design mechanical parts: write CadQuery code, validate the geometry, render a preview, and export manufacturing files (STEP / IGES / STL / 3MF).
English | 中文
What it does
You: "Design an M8 hex-nut retainer, 3 mm wall, and export STEP"
Agent: loads the cadquery-design skill
→ cad_validate (code + geometry check)
→ cad_render (preview image + volume/bbox facts)
→ iterate until the design is right
→ cad_export → retainer.step, ready for your CAM pipeline
Backends are pluggable adapters behind a capability-routing registry. v0.1 ships the CadQuery adapter (OpenCASCADE kernel, native STEP). OpenSCAD, ezdxf (2D DXF), and FreeCAD adapters are on the roadmap; commercial CAD bridges (SolidWorks/NX/CATIA via COM, AutoCAD/ZWCAD/GstarCAD via console/LISP) are designed-for as separate future packages — the pragmatic meaning of "compatible with CATIA/SolidWorks/NX" is exchanging STEP/IGES/DXF files with them, which the adapter layer already targets.
Prerequisites
-
dsh 0.x
-
Python 3.10+ with CadQuery:
pip install cadquery
# optional, for raster PNG previews (self-contained wheels, no native DLLs):
pip install matplotlib
Run cad_doctor after installing the plugin — it probes the machine and prints a capability matrix with install hints.
Install
dsh plugin --profile web add dsh-cad-design
dsh web
dsh plugin requires an explicit --profile; target a profile that carries a surface bundle. The shipped web profile (base + web-app) is the usual choice — a fresh custom profile created by dsh plugin --profile <custom> add contains only @deepseek-ai/dsh-base (headless, no UI). Boot any profile as dsh --profile <name> with no surface argument; the surface comes from the profile's bundle list.
Or from a tarball: dsh plugin --profile web add ./dsh-cad-design-0.1.0.tgz
Name note: npm also hosts dsh-cad, a CAD viewer plugin by LAU-MARS (STL/OBJ/STEP/DXF preview cards in the Web UI). The two are complementary, not competing — dsh-cad-design creates and exports the models, dsh-cad can display them. This package was renamed to dsh-cad-design to keep both installable side by side.
Tools
| Tool | Purpose |
|---|
cad_doctor | Probe all backends; report capability matrix + install hints. |
cad_validate | Execute CadQuery code and check geometry validity (valid: false is a domain result, not a crash). |
cad_render | Produce a preview (PNG when possible, SVG always) + geometry facts (volume, bbox, validity). Attaches the image when the current model supports image input; otherwise degrades to text + facts. |
cad_export | Export STEP / IGES / STL / 3MF. Never silently overwrites (overwrite: true to force). |
Plus the cadquery-design skill (auto-registered): the result-variable contract, mm units, Workplane selection rules, and a mechanical pattern library (cbore holes, nut traps, bolt-circle flanges, bearing seats, ribs, D-shaft bores).
Configuration
Config lives in your profile's cordis.patch.yml (whole-line replace semantics — provide the full config block):
- insert:
- id: cad-tools
name: dsh-cad-design
config:
workDir: '' # default: <session cwd>/.dsh/cad
timeoutSeconds: 120
enableSkill: true
backendPriority: # routing order when several backends qualify
- cadquery
cadquery:
enabled: true # master switch for this backend
pythonPath: '' # absolute python.exe; empty = auto-detect
Environment variable DSH_CAD_PYTHON also overrides the interpreter.
Security note
cad_* tools execute Python code on your machine (that is how parametric CAD works). The plugin implements no policy itself — use dsh's tools/pre-execute hooks for allow/deny/ask rules in shared or untrusted deployments.
Development
pnpm install
pnpm test # unit tests (no CadQuery needed)
DSH_CAD_PYTHON=/path/to/python pnpm run test:e2e # real-backend tests (auto-skip otherwise)
pnpm build && pnpm pack
Live development against a dsh checkout:
cd /path/to/deepseek-harness
pnpm dsh web --patch /absolute/path/to/dsh-cad/cordis.dev.yml
Roadmap
- v0.2 — ezdxf adapter (2D DXF drafting with CJK font handling), OpenSCAD adapter,
cad_convert (file→file)
- v0.3 — FreeCAD adapter (GB-standard engineering drawings), DWG via ODA File Converter
- v1.0 — configurable routing priorities, richer facts (mass, inertia), larger pattern library
- later (separate packages) —
dsh-cad-autocad (accoreconsole/LISP), dsh-cad-zwcad / dsh-cad-gstarcad (COM-compatible), dsh-cad-solidworks, dsh-cad-nx
License
MIT
中文说明
让 dsh 智能体做机械设计：编写 CadQuery 参数化建模代码 → 校验几何 → 渲染预览 → 导出制造格式（STEP/IGES/STL/3MF）。
- 安装前置：Python 3.10+，
pip install cadquery（可选 pip install cairosvg 用于 PNG 预览）
- 安装插件：
dsh plugin --profile web add dsh-cad-design，然后 dsh web 启动。注意必须显式指定 --profile，且目标 profile 要带有界面 bundle——新自定义 profile 默认只含 dsh-base（无界面、静默运行）；启动用 dsh --profile <名字>，不要带 web 参数。装完先用 cad_doctor 做环境自检。（注意区分：npm 上另有 LAU-MARS 的 dsh-cad——CAD 查看器插件，与本包互补：本包负责建模出图，它负责在 Web 界面里看图）
- 后端架构：adapter 注册表 + 能力路由。v0.1 自带 CadQuery（OpenCASCADE 内核，原生 STEP）；OpenSCAD、ezdxf、FreeCAD 在路线图上；商业 CAD（SolidWorks/NX/CATIA/AutoCAD/中望/浩辰）通过中性格式（STEP/IGES/DXF）互操作，进程内桥接预留为独立插件包
- 路由与开关：
backendPriority 控制多个后端同时可用时的优先级；cadquery.enabled 可整体关闭某个后端；pythonPath / DSH_CAD_PYTHON 指定解释器
- 注意：工具会在本机执行 Python 代码（参数化 CAD 的工作方式），共享部署请配合 dsh 的
tools/pre-execute 权限门禁
