dsh-cae-plugin

DeepSeek Harness 的自然语言驱动 CAE 流水线：agent 接收一句自然语言的仿真请求，驱动完整的 CAD → 网格 → 求解 → 后处理链路，底层依托 build123d、Gmsh、CalculiX、OpenFOAM 与 PyVista。 五个工具覆盖全链路 —— 几何（脚本建模，或外部 STEP 导入加校验/愈合）、一个模式开关背后的固体与流体网格划分、另一个开关背后的线性静力与稳态/瞬态不可压缩 CFD 求解、结果提取与绘图，以及自动化的网格无关性验证 —— 每个阶段结束后将回执（路径、体积、网格质量、场极值）反馈给模型。

安装

推荐（Docker）：装好 Docker、添加插件、把 python 指向预构建镜像——不需要 conda、apt 装 CalculiX、也不需要装 OpenFOAM。镜像在首次使用时自动拉取（约 3–4 GB）：

python: docker://ghcr.io/daiyuhangsustc/dsh-cae:latest

本地解释器（无 Docker）：见下方路线。

先装 Python 栈：pip install build123d gmsh pyvista ccx2paraview，再装 CalculiX 求解器 —— Debian/Ubuntu 上 sudo apt install calculix-ccx，其他平台 conda install -c conda-forge calculix（ccx 必须在 PATH 上）。 CFD 模式需要安装 OpenFOAM（Foundation v11–13 或 ESI）；其 etc/bashrc 会被自动探测（$FOAM_BASHRC、/opt/openfoam*、/usr/lib/openfoam*），也可通过 openfoamBashrc 指定。 然后把插件装入 profile —— 在 DeepSeek Harness 检出里运行 dsh：

• 本地检出（插件开发）：dsh plugin --profile web add /path/to/dsh-cae —— 以 link: 依赖安装；改动插件后 pnpm build 并重启界面即可生效。
• 直接 git 检出：dsh plugin --profile web add https://github.com/DaiYuhangSustc/dsh-cae-plugin.git（git 安装会运行 prepare 构建脚本；pnpm 用户可能需要通过 allowBuilds 允许该构建步骤）。
• npm 源安装（发布后）：dsh plugin --profile web add dsh-cae。

每个 profile 各自维护插件列表 —— 换用其他 profile（如 headless）时对该 profile 重复 add。

启动使用

• 浏览器：dsh web 启动 Web 界面，地址 http://127.0.0.1:3080（`--port` 可改端口；默认自动打开浏览器）—— 打开后粘贴自然语言请求，即可看到工具调用与回执的流动。
• 终端：dsh --profile headless "20×20 mm 方管、长 1 m、水、入口 0.02 m/s —— 稳态层流求解并出压力云图" 无界面跑单个任务并输出完整记录。 插件装入前已启动的界面看不到它 —— add 之后（link: 安装则是重新 build 之后）需重启界面。

试一试

见 examples/cantilever.md：一句中文即可让 cae_geometry → cae_mesh → cae_solve → cae_post 生成一端固定、端部受载的悬臂梁，输出 von Mises 云图，并由 cae_verify 做网格无关性验证。 另见 examples/duct-flow.md：一句中文即可生成层流管流解（cae_mesh fluid 模式 → cae_solve steady 模式 → cae_post），并与 Shah–London 摩擦常数做验证。

五个工具

cae_solve 的 mode='steady' 与 mode='transient' 取舍：内流请求默认推荐稳态；瞬态分支（Euler/PIMPLE，Courant 受限自适应步长）面向真正依赖时间的物理 —— 稳态 vs 瞬态的权衡写在工具描述里，由 agent 推荐、用户决定。

从 v0.4 迁移

v0.5.0 是破坏性发布：v0.4 的九个工具名均已移除，v0.4 验证工具的扁平边界条件形态（受约束组名的列表；按组键入的力向量）同样移除。边界条件处处为规范形态 —— constraints: [{groupName, kind: 'fixed'}] 与 loads: [{groupName, vectorN: [fx, fy, fz]}] —— 由 cae_solve（mode='static'）与 cae_verify（chain='structural'）使用。

每个 v0.4 工具都映射到五个 v0.5 工具之一加一个 mode/chain 开关：两个几何工具合并为 cae_geometry（mode='build' 脚本建模、mode='import' 外部 STEP 导入）；固体网格器与管道网格器合并为 cae_mesh（mode='solid' / mode='fluid'）；结构求解器与两个 CFD 求解器合并为 cae_solve（mode='static' / 'steady' / 'transient'）；后处理器变为 cae_post；网格无关性研究变为 cae_verify（chain='structural' / 'cfd'）。v0.4 的名称与 schema 保留在 git 历史中（重构前的提交 01fad90，即 origin/master 所在处）供查阅。

六阶段工作流映射

本插件覆盖经典的 CAE/CFD 六阶段工作流；阶段 1–5 自动化，阶段 6 刻意留给人工。

架构

五个工具一一对应五个 Python 包：src/tools/{geometry,mesh,solve,post,verify}.ts ↔ python/dsh_cae/{geometry,mesh,solve,post,verify}（另有 python/dsh_cae/shared 负责回执发射、依赖自检与 OpenFOAM 案例组装）。TS 层只做编排；每次工具调用是一个一次性的 python -m dsh_cae.<stage> 子进程，仅通过 argv 加上 <<<DSH_CAE_JSON>>> 标记之后的 stdout 回执行耦合 —— 边界上没有别的通道。两份契约刻意双侧镜像：override 白名单既是 src/tools/solve.ts 中 overrides 的 file 枚举（OVERRIDES_PARAM），也是 python/dsh_cae/shared/cfd_case.py 中的 CASE_DICT_FILES —— 必须在同一个提交里一起改；cae_verify 的逐级循环（每个尺寸网格 + 求解 + 后处理）在单个 python -m dsh_cae.verify 进程内完成，这也是其阶段超时按 3×级数放大的原因。

信任边界

script 参数是模型生成的 Python（及批处理文本），在本地执行，信任级别与 harness 自带的 bash 工具相同；请据此对待，并通过 profile 权限层（tools/pre-execute）进行治理。

单位

全程毫米、牛顿、兆帕：几何用 mm，力用 N，应力用 MPa，因此挠度输出为 mm，弹性模量按 MPa 输入（钢 ≈ 210000）。 CFD 分支在 cae_mesh（mode='fluid'）处按 mm 接收几何（一次性换算为 m），之后全程 SI：m、m/s、Pa、Pa·s；cae_post 在给定 densityKgM3 时把运动压力换算为 Pa。

配置

故障排查

若 import build123d 报 pyexpat ... undefined symbol: XML_SetAllocTrackerActivationThreshold，是被继承的 LD_LIBRARY_PATH（如 OpenFOAM 的 bashrc 把 /usr/lib 目录排在了前面）遮蔽了解释器自带的更新版 libexpat。对 conda 风格解释器（python: auto 或显式 env 路径），runner 在 spawn 时已自动把该环境的 lib 前置到 LD_LIBRARY_PATH、bin 前置到 PATH；其他布局请自行 LD_PRELOAD=$CONDA_PREFIX/lib/libexpat.so.1 强制优先加载新版。 无显示器的 Linux 服务器需要 EGL 或 OSMesa 才能进行 PyVista 渲染 —— conda-forge 的 vtk 只带 X 窗口类（没有 EGL/OSMesa 构建），请改用 pip 轮子（pip install 'vtk==9.6.2'，自带 vtkEGLRenderWindow；需安装 libegl1 提供 EGL 运行时），并设置 PYVISTA_OFF_SCREEN=true 与 VTK_DEFAULT_OPENGL_WINDOW=vtkEGLRenderWindow；Docker 镜像内正是这么做的。 OpenFOAM 11+（Foundation）移除了独立求解器可执行文件：本插件运行 foamRun（solver incompressibleFluid），即 simpleFoam 的后继者；ESI 版本仍保留 simpleFoam，但此处调用的名称是 Foundation 的。foamToVTK 输出传统 .vtk，cae_post 直接读取。 Docker 路线的报错都是显式的："Docker is not installed" → 安装 Docker；"daemon is not running" → sudo systemctl start docker（若你通过 DOCKER_HOST/DOCKER_CONTEXT 使用 rootless/远程守护进程，请在启动 harness 的 shell 里导出这两个变量——runner 传给 docker CLI 的是最小化环境）；"failed to pull" → 按提示手动执行 docker pull。镜像过期表现得像依赖过期——docker pull ghcr.io/daiyuhangsustc/dsh-cae:latest 刷新即可。SELinux 强制模式的主机（Fedora/RHEL）可能拒绝阶段的 bind 挂载——阶段日志出现权限错误时检查 container-selinux。使用 python: docker://… 时请勿设置 openfoamBashrc：宿主机路径在容器内不存在，镜像自带的 OpenFOAM 会被自动使用。

限制

结构：仅线性静力分析、仅四面体网格；CFD：仅不可压缩层流内流（稳态或瞬态）、仅六面体块网格；仅 POSIX；单机。

路线图

面向提示引导的 CAE skill、经 ctx.jobs 的后台任务、模态/热分析、湍流（kOmegaSST + y+ 处理）、snappyHexMesh/STL 几何、可插拔求解器提供方。

贡献指南

欢迎 PR 和 issue —— 自然语言 CAE 栈覆盖面很广，需要大家一起合作：更多物理场、更多求解器、更好的示例与文档。

开发环境（TS 侧）：pnpm install。 注意：@deepseek-ai/dsh-tools 处于 rc.1，其运行时导入链会拉入 dsh-llm/dsh-scope/dsh-session/dsh-timeout；以 out-of-tree 方式装进 profile 时，解析通常来自 profile 内的 dsh-base。 独立开发检出场景下，pnpm install 需要 autoInstallPeers: false（已写入 pnpm-workspace.yaml）加上已声明的额外 devDeps —— 若 peer 仍无法解析，请改为在 dsh profile 内安装，而非独立安装。

内核环境，无需 sudo（本仓库本地做 CI 等效验证所用的路线）：

conda create -n dsh-cae -c conda-forge python=3.11 calculix -y
conda run -n dsh-cae python -m ensurepip --upgrade
conda run -n dsh-cae pip install build123d gmsh pyvista ccx2paraview pytest

环境名就是关键：默认的 python: auto 探测的正是名为 dsh-cae 的 conda 环境，因此建好后无需任何额外配置。

按改动所属的层选跑对应测试：

所有改动必须守住的契约：

• TS 层只做编排（工具 schema、子进程、超时、回执）；全部领域知识在 python/dsh_cae/。两层只通过 argv 和 stdout 回执行 <<<DSH_CAE_JSON>>> 耦合 —— 不许有别的通道。
• 求解结果是数据：ccx 非零退出是携带 exitCode 与 logTail 的正常回执，供模型诊断；只有基础设施失败（缺二进制、超时、输出不可解析）才抛错。
• 全程单位 mm/N/MPa，任何地方不做换算。
• 若干求解器特性是刻意编码并加了注释的：Gmsh tet10 的第 9/10 中间节点在 solve.py 里对 Abaqus C3D10 做了交换；ccx 对奇异（无约束）系统也退出 0，因此域失败测试用指向不存在节点的 *CLOAD 驱动 ccx。

对 PR 的期望：覆盖你改动层面的测试保持绿色；内核测试在无内核环境自动跳过 —— 在 PR 里说明这一点，让 CI 真跑；README.md 与 README.zh.md 同步更新（两份文件互为镜像）；提交说明遵循约定式前缀（feat:、fix:、docs:、test:）。

适合上手的目标即上面的路线图：新增分析类型（*FREQUENCY、*HEAT TRANSFER）、在 CFD 分支上扩展湍流与 snappyHexMesh、教模型 build123d/INP 习惯用法的 cae skill、以及更多 examples/cantilever.md 风格的可运行示例。

许可证

MIT