🎁 福利专区全网大模型免费应用 + 新用户福利 + 注册活动入口,低成本玩转 AI

参数化机械设计 Mrdifferent2022/dsh-cad-design

DeepSeek Harnessv0.2.0
Mrdifferent202225 天前有提交已提供中文文档扫描:含敏感能力

为 DeepSeek Harnessdsh打造的参数化 CAD 工具——让你的智能体做机械设计:写 CadQuery…

30.6/100
综合分
1
GitHub 星标
383
npm 周下载
—/5
用户评分

数据截至 2026/10/12 · 周下载取自 npm 全网(含 CI / 镜像),非本站安装数;综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎
dsh plugin --profile web add dsh-cad-design
npm 源 · dsh-cad-design 的发布者账号已校验与本仓库一致

状态速览

判定依据:实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态
信任档位:已验证
是什么
dsh 原生插件 · tool
装得上吗
本站已在 dsh 0.2.1-rc.2 下真实安装成功
非静态推断
L4 · 真实安装等级说明 →
安全吗
本站尚未对该插件做风险分级
暂未覆盖,不等同于无风险
还在维护吗
活跃:最近一次提交在 25 天前
档位由哪些信号合成

本站实装验证(真实安装 L4 覆盖全站;L5 为运行时冒烟或实机截图,覆盖范围小于 L4) · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。 下方各区块是它的证据明细。

验证判据与等级说明 →
社区实装还没有人打卡 · 装过的第一个就是你
安装兼容性检查✓ 自动检查通过
展开查看检查明细 ↓

以下结论由程序自动检查 npm 包、engines 声明与入口文件得出,未做人工实机验证——能装不等于用着没问题。

✓npm 包dsh-cad-design @ 0.2.0
✓Node 引擎要求 ^22.19.0 || >=24.0.0 · 基线 Node 22.19 满足
✓dsh CLI 依赖未声明 dsh 版本约束
✓入口文件main/exports/bin 已声明

验证方式:npm registry 存在性 + package.json 静态校验 · 最后检查 2026/10/10 21:29:13

安全扫描自动 · 静态分析源码
v2.7.0
🔵 扫描:含敏感能力尚无人工评估
展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力:执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量(至少其一)。这是能力清单,不是危险判定——具体能力项与证据见下方,安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件
查看扫描证据(共 8 处,展示前 8 条)
  • 执行外部命令来自配置/变量
    lib/index.js:97
    const proc = spawn(command, [...args], {
  • 执行外部命令固定命令
    lib/index.js:120
    spawn("taskkill", [
  • 写入本地文件
    lib/index.js:330
    await writeFile(jobJsonPath, JSON.stringify(jobPayload, null, 2), "utf-8");
  • 写入本地文件
    lib/index.js:581
    await mkdir(dir, { recursive: true });
  • 写入本地文件
    lib/index.js:589
    await writeFile(work.scriptPath, code, "utf-8");
  • 读取本地文件
    lib/index.js:888
    const data = await readFile(result.pngPath);
  • 读取本地文件
    lib/index.js:961
    await stat(path);
  • 读取本地文件
    lib/index.js:1080
    await stat(path);
扫描于 2026/11/4(0 天前) · 范围 入口闭包 + 全包扫描 · 来源 npm 发布包

静态扫描只反映源码中出现的调用,不构成安全背书;人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块
@deepseek-ai/schemastery@deepseek-ai/cordis@deepseek-ai/dsh-attachment@deepseek-ai/dsh-llm@deepseek-ai/dsh-skill@deepseek-ai/dsh-tools@deepseek-ai/dsh-agent@deepseek-ai/dsh-brand@deepseek-ai/dsh-code-runtime@deepseek-ai/dsh-invariants@deepseek-ai/dsh-scope@deepseek-ai/dsh-session
给这个插件打分还没有人投票↓
用户评分
还没有人投票,来当第一个

功能亮点

  • 几何校验
  • 预览渲染

给 DeepSeek Harness(dsh)用的参数化 CAD 工具——智能体驱动的机械设计:CadQuery 建模、几何校验、预览渲染、STEP/IGES/STL/3MF 导出

README

由 DeepSeek 最新模型翻译生成
dsh-cad-design 为 DeepSeek Harness(dsh)打造的参数化 CAD 工具——让你的智能体做机械设计:写 CadQuery 代码生成 3D 零件,或写 ezdxf 代码生成 2D 工程图,校验几何,渲染预览,再导出制造文件(STEP / IGES / STL / 3MF / DXF)。 它能做什么 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 后端是可插拔的适配器,挂在按能力路由的注册表后面:CadQuery 适配器(OpenCASCADE 内核,原生 STEP)负责 3D 实体,ezdxf 适配器负责 2D DXF 图纸(内置多种修复,专治大模型画图常见毛病:TEXT 缺对齐点、CJK 字体回退、预览颜色白底白线)。
展开完整文档(README 剩余 1 节)
dsh-cad-design

为 DeepSeek Harness(dsh)打造的参数化 CAD 工具——让你的智能体做机械设计:写 CadQuery 代码生成 3D 零件,或写 ezdxf 代码生成 2D 工程图,校验几何,渲染预览,再导出制造文件(STEP / IGES / STL / 3MF / DXF)。

它能做什么

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

后端是可插拔的适配器,挂在按能力路由的注册表后面:CadQuery 适配器(OpenCASCADE 内核,原生 STEP)负责 3D 实体,ezdxf 适配器负责 2D DXF 图纸(内置多种修复,专治大模型画图常见毛病:TEXT 缺对齐点、CJK 字体回退、预览颜色白底白线)。工具会根据脚本里的 import 自动识别后端,也可以用 backend 参数或 backendPriority 配置指定。OpenSCAD 和 FreeCAD 适配器已在路线图上;商业 CAD 桥接(SolidWorks/NX/CATIA 走 COM,AutoCAD/ZWCAD/GstarCAD 走 console/LISP)规划为独立的后续包——所谓「兼容 CATIA/SolidWorks/NX」,实际含义就是和它们交换 STEP/IGES/DXF 文件,适配器层已经朝这个目标设计。

前置条件

- dsh 0.x
- Python 3.10+,装好 CadQuery 和/或 ezdxf(按需安装对应后端):

pip install cadquery # 3D solids → STEP/IGES/STL/3MF
pip install ezdxf matplotlib # 2D drawings → DXF + previews
optional, for raster PNG previews of 3D models (self-contained wheels, no native DLLs):
pip install matplotlib

装完插件后跑一次 cad_doctor——它会探测本机环境,打印能力矩阵并给出安装提示。

安装

dsh plugin --profile web add dsh-cad-design
dsh web

dsh plugin 必须显式指定 --profile;请选一个带 surface bundle 的配置档。自带的 web 配置档(base + web-app)是常用选择——用 dsh plugin --profile <custom> add 新建的自定义配置档只含 @deepseek-ai/dsh-base(无界面)。启动任意配置档都用 dsh --profile <name>,不要带 surface 参数;surface 由配置档的 bundle 列表决定。

或者从 tarball 安装:dsh plugin --profile web add ./dsh-cad-design-0.1.0.tgz

名称说明: npm 上还有一个 dsh-cad,是 LAU-MARS 做的 CAD 查看器插件(在 Web UI 里预览 STL/OBJ/STEP/DXF)。两者互补而非竞争——dsh-cad-design 负责建模和导出,dsh-cad 负责显示。本包改名为 dsh-cad-design,就是为了让两者能并存安装。

工具

| 工具 | 用途 |
| cad_doctor | 探测所有后端;报告能力矩阵 + 安装提示。 |
| cad_validate | 执行 CadQuery(3D)或 ezdxf(2D)代码并检查有效性(valid: false 是领域结果,不是崩溃)。后端从 import 自动识别,也可以用 backend 固定。 |
| cad_render | 生成预览(能出 PNG 就出 PNG,SVG 始终输出)+ 事实数据(3D 给体积/bbox;2D 给实体/图层/修复项)。当前模型支持图像输入时附上图片;否则退化为文本 + 事实数据。 |
| cad_export | 导出 STEP / IGES / STL / 3MF(CadQuery)或 DXF(ezdxf)。绝不静默覆盖(要强制覆盖就传 overwrite: true)。 |
| cad_convert | 文件→文件转换:STEP/BREP → STEP/IGES/STL/3MF(CadQuery),DXF → DXF 修复并规范化(ezdxf 容错读取 + 审计 + TEXT 修复 + 重写)。 |

另外还有两个自动注册的技能:cadquery-design(result 契约、mm 单位、Workplane 选择规则、机械模式库:沉头孔、螺母槽、螺栓圆法兰、轴承座、加强筋、D 形轴孔)和 ezdxf-drafting(2D 契约、图层/线型约定、CJK 安全文字样式、标注模式,以及 runner 会自动修复的那些坑)。

配置

配置放在你配置档的 cordis.patch.yml 里(整行替换语义——要提供完整的 config 块):

- 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
- ezdxf
cadquery:
enabled: true # master switch for this backend
pythonPath: '' # absolute python.exe; empty = auto-detect
ezdxf:
enabled: true # 2D DXF drafting backend
pythonPath: ''

环境变量 DSH_CAD_PYTHON 也能覆盖解释器。

安全提示

cad_* 工具会在你机器上执行 Python 代码(参数化 CAD 就是这么工作的)。插件本身不实现任何策略——在共享或不可信环境里,用 dsh 的 tools/pre-execute 钩子做允许/拒绝/询问规则。

开发

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

对着 dsh 检出做实时开发:

cd /path/to/deepseek-harness
pnpm dsh web --patch /absolute/path/to/dsh-cad/cordis.dev.yml

路线图

- v0.2 — ✅ ezdxf 适配器(2D DXF 制图,带 CJK 字体处理和 TEXT 修复);✅ cad_convert(文件→文件);待办:OpenSCAD 适配器
- v0.3 — FreeCAD 适配器(GB 标准工程图),通过 ODA File Converter 支持 DWG
- v1.0 — 更丰富的事实数据(质量、惯量),更大的模式库,图纸模板
- 后续(独立包) — dsh-cad-autocad(accoreconsole/LISP)、dsh-cad-zwcad / dsh-cad-gstarcad(兼容 COM)、dsh-cad-solidworks、dsh-cad-nx

License

MIT

中文说明

让 dsh 智能体做机械设计:编写 CadQuery 参数化建模代码(3D 零件)或 ezdxf 代码(2D 工程图)→ 校验几何 → 渲染预览 → 导出制造格式(STEP/IGES/STL/3MF/DXF)。

- 安装前置:Python 3.10+;三维装 pip install cadquery,二维制图装 pip install ezdxf matplotlib(按需二选一或都装),PNG 预览用 pip install matplotlib
- 安装插件: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 注册表 + 能力路由。自带 CadQuery(OpenCASCADE 内核,原生 STEP)和 ezdxf(2D DXF,内置生产验证的修复器:TEXT 对齐点补齐、CJK 字体预览重映射、白底 ACI7 处理);OpenSCAD、FreeCAD 在路线图上;商业 CAD(SolidWorks/NX/CATIA/AutoCAD/中望/浩辰)通过中性格式(STEP/IGES/DXF)互操作,进程内桥接预留为独立插件包
- 路由与开关:工具按代码 import 自动识别后端(import ezdxf → 二维),也可用 backend 参数强制;backendPriority 控制多后端优先级;cadquery.enabled / ezdxf.enabled 可分别关闭;pythonPath / DSH_CAD_PYTHON 指定解释器
- 注意:工具会在本机执行 Python 代码(参数化 CAD 的工作方式),共享部署请配合 dsh 的 tools/pre-execute 权限门禁
预览分享卡片长什么样 ↓Mrdifferent2022/dsh-cad-design
分享 · DeepSeek Harness Hub
Mrdifferent2022/dsh-cad-design

为 DeepSeek Harnessdsh打造的参数化 CAD 工具——让你的智能体做机械设计:写 CadQuery…

这是你的仓库?认领条目

回到顶部