在浏览器里打开一个对话窗口,用一句话描述零件,右侧立刻长出三维模型,还能接着改参数、加装配、出工程图——这不是演示视频,而是开源项目 dsh-cad 的日常用法。它把一套完整的参数化 CAD 能力接进了 DeepSeek Harness(dsh),让 AI Agent 能够「边聊边建模」。
一、项目速览
- 仓库:github.com/LAU-MARS/dsh-cad
- 定位:DeepSeek Harness 的 2D/3D CAD 插件
- 开发语言:TypeScript
- 几何内核:OCCT 7.9.3(经 cadorange → occt.ts 的 WASM 封装)
- 开源许可:MIT
- 社区热度:42 star、10 fork(截至 2026 年 11 月 17 日)
- 运行环境:Node.js ≥ 22
- 安装方式:已发布到 npm,一行命令接入
二、它想解决什么问题
目前绝大多数「AI + CAD」的尝试停在两个位置:要么让模型生成一段建模脚本,要么让它输出一个网格文件。模型看不见自己造出来的东西,也无法在下一步接着修改,所谓「设计」其实是一次性的文本生成。
dsh-cad 换了个思路:把 CAD 拆成一组语义化的工具调用,再配一个常驻视口。每一步操作都有对应的工具函数,结果实时渲染在对话右侧的面板里;模型还能读回几何数据(精确体积、包围盒、三角面数)来验证自己刚才做了什么。人看见的是模型在长,模型看见的是数值在变。
三、核心能力拆解
3.1 看:多格式查看与常驻面板
3D 支持 STL、OBJ、STEP、IGES、BREP、DCPRT,2D 支持 DXF、SVG。视口提供 Onshape 风格的 ViewCube(26 个区域点击定向)、面与边的悬停拾取和实时测量(面积 mm²、长度 mm),可在「面 + 边」「仅面」「线框」三种渲染模式间切换。面板本身是标签式结构:Part(建模)、Assembly(装配)、Drawing(工程图),每个标签保留自己的状态。
3.2 建:参数化建模工具族
覆盖了实体建模的主要路径:基元、轮廓拉伸、放样(loft)、扫掠(sweep)、旋转(revolve)、布尔运算(融合 / 切除 / 相交)、全边等半径圆角与倒角、抽壳(shell)、拔模(draft)、线性与圆周阵列、平移旋转镜像。轮廓支持圆弧与圆的精确 BRep 表达,B 样条则走采样近似;放样还提供 smooth 选项,用周期 B 样条拟合点环,得到一张连续侧面而不是多段平面片,避免了 G0 折痕。
3.3 改:命名草图与操作日志回放
这是判断一个「AI 建模工具」是不是真参数化的分水岭。dsh-cad 支持独立命名的草图(Sketch1、Sketch2…),拉伸、旋转、扫掠按名字引用草图;修改草图时不是重新生成一遍,而是原地改写定义并重放整条操作日志,所有下游特征自动重建。草图在视口中以蓝色曲线加基准面框显示,同时列在左侧特征树里,可以切换可见性、点击高亮对应实体。
3.4 装:关节驱动的装配体
装配侧引入了 build123d 的关节族(rigid、revolute、linear、cylindrical、ball、planar、polar):定义关节、成对连接求解(父件固定、子件重定位到关节坐标系)、驱动运动值并级联重解,可以当作运动学研究使用;还有爆炸视图。STEP 装配导入时会保留产品名称、层级和实例位置,相同几何体自动去重为一个 body 加 N 个实例——一排螺栓在文件里只是一个 body。
3.5 出:工程图与导出
工程图按 GB 第一角法排布主视、俯视、左视加等轴测,消隐线由 OCCT 真实计算(虚线显示),带图框、标题栏、总体尺寸和标准比例系列,可导出 SVG 或 DXF。实体支持导出 STEP(参数化)与 STL(网格),且只在用户明确要求时才写文件。
3.6 解:几何约束求解
约束求解用的是 Ansatz,以 ansatz-wasm 的形式发布(单个包约 538KB、零依赖),安装 dsh-cad 时会自动拉取。这一点很关键:不需要 Rust 工具链,不需要原生二进制,跨平台开箱即用。求解器返回自由度、残差、冗余约束和建议等诊断信息,格式是面向大模型消费设计的。
四、技术架构:真正值得读的部分
- 内核链路:建模走 cadorange(面向 Agent 的 CAD 运行时,提供 build123d 风格 API)→ occt.ts(OCCT 7.9.3 的 WASM 封装),直接调用 occt.ts 的适配层作为回退。v0.15.1 移除了 opencascade.js 这一层,安装体积减少 64MB。
- 双 Worker 分离:导入(occt-import-js,只读 STEP/IGES/BREP)与建模(cadorange over occt.ts)是两个独立 worker,都懒启动。
- 零拷贝渲染:worker 生成的网格以二进制 f32/u32 直接映射给 three.js 类型数组,没有 base64、没有中间文件、没有每步落盘。
- 文档即日志:工作区的
.dsh-cad/model.json保存操作日志,配防抖磁盘镜像;进程重启后靠重放恢复全部实体。 - 执行器契约:FreeCAD(本地 Python API)、Fusion 360(GUI 桥接)、Onshape(签名 REST API)都实现同一个 GeometryExecutor 接口,显示层完全不变,换后端只影响生成几何的质量。
其中 Onshape 这条路径值得一提:每个建模操作都会被编译成一个标准的 Onshape feature,直接推进目标 Part Studio,不需要预先搭 Feature Studio。回读分了三个档位——默认按零件取 STL(最省配额),需要精确 BRep 时走 readback: "step",只建模不取回时用 readback: "none"。
五、安装与上手
插件已发布至 npm,装好 dsh CLI 后一行接入,安装器会自动应用包内的 cordis.patch.yml,无需手工配置:
dsh plugin --profile web add dsh-cad
设置 DEEPSEEK_API_KEY 之后就可以直接下指令。例如这句:
「model a 100×60×5 plate, punch a ⌀20 hole in the middle, R2 fillets on the four corners, add a ⌀16 boss 20 tall, export plate.step」
会被依次翻译成 cad_create_prim → cad_boolean → cad_fillet → cad_export 四次工具调用,右侧 3D 标签页在每一步都同步更新。从源码安装的流程也在 README 里写得很清楚:克隆、npm install && npm run build && npm test,再把本地目录 add 进 dsh 的 web profile。
六、已知局限(作者自己列的)
- DWG 格式不支持(闭源);DXF 的 bulge 圆弧以弦线近似
- 圆角目前只能是全边等半径,逐边选择在 embind 下不稳定;倒角尚未实现
- 草图拉伸仅支持多边形轮廓,圆弧轮廓需要用圆柱/圆环的布尔组合构造
- glTF / 3MF 只预留了结构,尚未实现
- 受 dsh 宿主限制,已挂载的单槽位不响应后来注册的组件,所以常驻视图以「3D」视图标签页的形式提供
- 约束求解器能力仍在分阶段扩展(目前以点到原点距离为主),但通信契约已完成,后续扩展无需改动接口
七、为什么值得关注
对 CAD 内核开发者,它是一份 OCCT 上 WASM 的工程实践样本:内核链路分层、STEP 字节作为跨内核交换格式、消隐线由真实几何计算而不是屏幕空间近似。
对 AI Agent 开发者,它示范了如何把一个专业领域软件抽象成工具集——不是给命令行套一层壳,而是把「建模意图」拆成有语义、可验证、可回放的原子操作。
对普通使用者,最直接的价值是:一条 npm 命令,浏览器里就有了一套不需要本地安装的参数化 CAD 环境。
如果你关心 AI 原生工业软件的整体路线,本站此前发布的 《LuBan 架构》系列从数据层、工具层到智能体层做过系统性讨论,可以和这个项目对照着看。








