参数化建模台 jianboer/SimpleCADforDSH

SimpleCADforDSH

SimpleCADforDSH 是 DeepSeek Harness（dsh）的树外插件，能把文字提示词变成真正的参数化 CAD。它走 dsh 官方插件契约（宿主工具 + 客户端插槽 + 技能），不 fork、也不改 dsh 源码。

用大白话描述一个零件 → 智能体写出 build123d Python，导出 STEP + GLB，跑几何 QA，并在同一窗口打开 CAD 面板，你可以在里面改尺寸、重新生成。

SimpleCADforDSH 工作台

功能

- 文字 → 参数化 CAD。 text-to-cad 技能串起需求 → 建模 → QA → 导出，并从提示词里锁定 overall_size_mm 和 special_features。
- CAD 即代码。 每个零件都是一段 gen_step() build123d 脚本（from build123d import *），不是网格；整体尺寸放在 PARAMS 字典里，随时可改。
- 内置几何 QA。 检查 single_body、watertight、overall_dimension（0.2 mm 容差），给出通过/不通过结论。
- 同窗口 CAD 面板。 工作台在 dsh 界面右侧打开——模型树、着色 3D 视图、参数侧栏、面检查器。
- 参数化编辑。 点一个面，或用 simplecadfordsh_apply，就能改 length / width / height / hole_d；STEP + GLB 自动重新生成。
- 导出。 STEP、STL、GLB（3MF 计划中）。
- 相似度参考。 CAD 与参考图的轮廓 IoU，加上基于规则的 AI 建议，来源是 QA + 相似度 + 需求意图。

工具

| 工具 | 作用 |
| simplecadfordsh_brief | 写工程 IR + 需求（包络、特征、single_body/watertight） |
| simplecadfordsh_gen | 写 gen_step()，导出 STEP+GLB，返回 facts + qa，打开面板 |
| simplecadfordsh_inspect | 重新测量几何 |
| simplecadfordsh_qa | 只做通过/不通过检查 |
| simplecadfordsh_measure | 检查指定的 X/Y/Z 整体尺寸 |
| simplecadfordsh_export | 从已有零件导出 STL / GLB |
| simplecadfordsh_preview | 在 CAD 面板里显示零件 |
| simplecadfordsh_params | 读取可编辑字段（length、width、height、hole_d） |
| simplecadfordsh_apply | 应用参数修改并重新生成 STEP+GLB |
| simplecadfordsh_snapshot | 渲染正交视图 PNG（iso/front/right/top） |
| simplecadfordsh_similarity | CAD 与参考图的轮廓 IoU（仅供参考） |
| simplecadfordsh_advice | 基于规则的建议，来源是 QA + 相似度 + IR |

保留（只有 schema，未实现）：simplecadfordsh_part · simplecadfordsh_assemble · simplecadfordsh_dfam。

工作原理

prompt ─▶ text-to-cad skill
├─ simplecadfordsh_brief (lock overall_size_mm / special_features)
├─ simplecadfordsh_gen (build123d → STEP + GLB, facts + qa)
├─ [pane opens] (QA issues, params, face inspector)
└─ simplecadfordsh_export (STL / GLB)
每个生成的 gen_step() 都在顶层 PARAMS 字典里声明整体尺寸，并在函数体内引用 PARAMS[...]——这样才能在面板里编辑零件，也能通过 simplecadfordsh_apply 编辑。

环境要求

- Node.js 22
- Python 解释器，需装 build123d（以及 numpy；用到图像功能时还需 PIL/trimesh）
- dsh Web 环境，并配好你的 DeepSeek API key

安装（原生 dsh）

dsh 包名是 simplecadfordsh；让它可被解析，再打一行补丁。

1. Make the package resolvable
$DSH_HOME/profiles/node_modules/simplecadfordsh -> <this-repo>/SimpleCADforDSH/dsh-plugin

2. Point the CAD interpreter at the active Conda environment
conda activate <conda-env-with-build123d>
scripts/start-dsh-web.ps1 detects CONDA_PREFIX automatically.
For native dsh without the script, set SIMPLECADFORDSH_PYTHON explicitly:
export SIMPLECADFORDSH_PYTHON=$(command -v python)
PowerShell: $env:SIMPLECADFORDSH_PYTHON = (Get-Command python).Source

3. Patch one row in your dsh patch file
- insert: { id: simplecadfordsh, name: simplecadfordsh }

如果是从源码检出，先在 deepseek-harness 根目录运行 pnpm install 和 pnpm run build，然后用 scripts/start-dsh-web.ps1 创建本地链接、生成绝对路径补丁，并运行 pnpm dsh web。

许可证

MIT——见 LICENSE。