Ji-Baoning/dsh-cad2cae

README 摘要

dsh-cad2cae 运行于 DeepSeek Harness (DSH) 的 AI CAD 生成插件：把自然语言需求经「意图层校验 → build123d 源码生成 → OCCT 编译」的门禁化流水线，产出可编辑、可验证的 STEP 模型。 阶段 ：MVP（功能完整、两套测试全绿；个人规模，暂无 CI、无版本发布） · 运行时 ：Python ≥ 3.10 · Node ≥ 18 · build123d 0.11.1 · OCCT 项目简介 CAD 工程师和设计团队希望直接从自然语言需求得到可编辑的 CAD 模型，而不必手写几何脚本，同时保证设计意图、可追溯性与门禁化验证。dsh-cad2cae 正是为此构建的 DSH 插件：先对意图层做严格校验（图可达性 / 无环性 / 静态完备 / 运动学一致性、强制米制、标识符白名单），再确定性生成可编辑的 build123d 源码，并通过 OCCT 子进程编译为可编辑 STEP（零件 + 装配）。生成结果在交付前按契约实测闭环（测量 / 验证），任一环节失败都响亮报错而不静默降级。系统分三层实现：Plan A 纯标准库意图校验器、Plan B 代码生成与编译流水线、Plan C DSH 插件层（24 工具 + 纯函数状态机 + JSON 子进程后端），当前功能完整且两套测试全绿。 安装 环境依赖 ：Python ≥ 3.10（build123d 0.11.1、cadquery-ocp-novtk 7.9.3.1.1、OCCT）；Node ≥ 18（ESM）。 安装与测试 ： 作为 DSH preset 使用 ：运行安装脚本，把预设装入 DSH 本地预设根，并自动改写副本的 backendDir 指向本仓库 src/ 、在副本内建立 node modules/@deepseek-ai/{dsh-tools,schemastery} 符号链接（指向 harness 安装内的同名包——插件入口的 import '@deepseek-ai/dsh-tools' 依赖它解析）： 脚本遵守 DSH 的 home 解析（ $DSH HOME 优先，默认 /.dsh ），支持 --id 自定义预设 id；仓库源文件保持原样，复制时排除测试与缓存文件。找不到 dsh harness 时会警告并给出手动建链接的命令。安装后 DSH 会话选择 AI-CAD 即可（24 个工具：23 个 cad + show image ）； 若 dsh web 进程曾加载过失败版本的预设，需重启 dsh web 后再选择 （Node 的 ESM 失败导入会按路径缓存，改名入口也只能绕开一次）。 harness text-only 补丁 ：安装脚本会自动把 text-only 序列化补丁（ patch-harness.mjs ）应用到 harness …

分类