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 权限门禁