dsh-cad-design
用于 DeepSeek Harness 的参数化 CAD 工具：CadQuery 建模、STEP 导出和设计预览
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Mrdifferent2022/dsh-cad#e01df8e62e5eb145b9fd23daa82d5762a282b286Cad Design 以 dsh-cad-design 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
点击下方 Badge 复制 Markdown，粘贴到 README 即可。
验证 package.json 声明的 GitHub 仓库，即可管理这个公开页面。认领后，Hub 会优先安排当前版本的安全扫描，并在通过后公开展示结果。
认领这个 Plugin →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 | 中文
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.
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.
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-designcreates and exports the models,dsh-cadcan display them. This package was renamed todsh-cad-designto keep both installable side by side.
| 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).
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.
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.
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
cad_convert (file→file)dsh-cad-autocad (accoreconsole/LISP), dsh-cad-zwcad / dsh-cad-gstarcad (COM-compatible), dsh-cad-solidworks, dsh-cad-nxMIT
让 dsh 智能体做机械设计：编写 CadQuery 参数化建模代码 → 校验几何 → 渲染预览 → 导出制造格式（STEP/IGES/STL/3MF）。
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 界面里看图）backendPriority 控制多个后端同时可用时的优先级；cadquery.enabled 可整体关闭某个后端；pythonPath / DSH_CAD_PYTHON 指定解释器tools/pre-execute 权限门禁