前言¶
在 DeepSeek Harness（DSH）里做 CAD 相关智能体时，常见做法是让用户切到 NX 图形界面手工操作，或自己写 NXOpen 脚本再在 harness 外调度。前者占用前台、难以串进对话式工作流；后者维护成本高，且和侧栏、工具调用体系脱节。dsh-nx 把 Siemens NX 接到 DSH 的工具层与侧栏：在后台 NX 会话里完成建模、装配、有限元与批量出图，产物可在侧栏预览，全程不占用 NX 前台窗口。
这是什么¶
dsh-nx 是社区维护者 aaz111 发布的 DSH 插件（分类：工作流），仓库 aaz111/dsh-nx，目录页 skillhub.cn/plugins/aaz111/dsh-nx。它通过本机 NX 的 run_journal.exe 与 worker 通信，把数十个 nx_* 工具注册给 harness；同时提供侧栏 NX 工作台，用于会话状态、打开零件、分组操作与 STL 三维预览。单位统一为 mm / 度 / kg。README 明确说明：可用自然语言描述建模需求，但 AI 生成结果不保证完全准确，须人工复核。
核心功能¶
下面按 README 中的能力边界归纳；不能做的限制在下一节单独说明。
会话与文件¶
工具包括 nx_status、nx_session、nx_open、nx_new、nx_info、nx_save 等：查看或启动后台 NX 会话，打开 .prt / .step / .iges，新建零件，查看信息并保存。
建模与测量¶
实体与特征：nx_primitive、nx_extrude、nx_revolve、草图 nx_sketch、布尔 nx_boolean、圆角倒角、孔与内螺纹、抽壳、变换与阵列、表达式 nx_expression 等。测量：nx_measure（体积、面积、质量、包围盒、质心）、nx_faces（面列表）。同步建模：nx_sync_face、nx_sync_region。另有曲线曲面、基准、管道 nx_tube、筋、特征阵列等工具表中所列项。
工程图与批量出图¶
nx_drawing 可自动投影视图并建图纸（README 注明能用但不建议依赖其可读性）；nx_pdf 导出 PDF；剖视、局部放大、文字注释、GB 图框标题栏 nx_drawing_frame、形位公差与标注类工具。装配体侧：nx_bom_table、nx_batch_drawings 支持逐件 A3 图纸与 PDF；nx_assembly_bom 可汇总 BOM 并导 CSV。
装配与导出¶
nx_assembly_add / move / fix / mate / list / gap 等管理组件与约束；爆炸图、间隙矩阵、组件阵列与替换抑制删除。格式导出 nx_export：STEP / IGES / STL（等待 NX 异步翻译器完成）。
有限元¶
nx_fea_spec、nx_fea_solve、nx_fea_solid：含 NX Nastran 悬臂梁 SOL 101 校核，以及真实几何 FE（体素/铺面网格，多种载荷与静力/模态，挠度与 Von Mises 云图）。需本机 simulation / nastran 许可证；README 声明 FE 结果仅供参考，不得直接用于工程设计决策或安全认证。
侧栏与预览¶
侧栏面板提供会话卡、打开零件（支持中文路径）、分组操作（零件 / 出图 / 文件 / 装配）、上一步结果与最近产物列表；3D 预览 对 STL 网格渲染，支持剖切滑杆。输出的 prt 等模型可在 NX 控制台相关预览能力中查看（与插件简介一致）。
逃生舱¶
nx_python 可在 NX 会话内执行调用方提供的 NXOpen Python；可通过环境变量关闭（见安全说明）。
已知限制（节选）¶
README 用表格列出了批处理与 NXOpen 层面的限制，使用时需心里有数，例如：不支持 DXF/DWG 导出（可用 STEP/IGES/STL）；原生 PMI 尺寸标注不可用（可用 nx_note）；装配批处理约束注册后需 nx_assembly_move 手动定位；外螺纹不支持；nx_drawing 的 template 图框不随 PDF 输出（可用 nx_drawing_frame）。完整列表见仓库 README「不能做什么」一节。
安装与启用¶
前提：本机已安装 Siemens NX。安装路径由配置项 nxHome 或环境变量 UGII_BASE_DIR 指定；未配置时会按 README 描述的顺序自动探测（含 NXBIN\run_journal.exe）。FE 相关功能额外需要 simulation / nastran 许可证。
插件对运行环境的要求（来自 package.json）：Node >=22，DSH >=0.1.0-rc.7。
官方 README 给出的安装方式如下：
# 方式一：从 Release 下载 zip 解压
# 方式二：从源码安装
pnpm add file:<解压目录>/dsh-nx
配置项（默认值见 README）：
| 配置键 | 默认值 | 说明 |
|---|---|---|
panel |
true |
设为 false 跳过侧栏面板路由 |
outputDir |
~/.dsh-nx/out |
产物目录（也可用 DSH_NX_OUT） |
nxHome |
自动探测 | NX 安装路径（也可用 UGII_BASE_DIR） |
插件仅在 NX 2512 上测试通过，其他 NX 版本未经验证。许可证：MIT（package.json 与 README 一致）。
典型用法¶
对 AI 用自然语言描述需求即可，插件会自动选工具；也可显式调用工具名。README 中的快速上手链如下：
# 1. 新建零件并建模
nx_new → 创建 120×80×20 长方体 → 打孔 → 圆角 → 测量
# 2. 出图纸
nx_drawing（A3）→ nx_section_view → nx_note → nx_pdf
# 3. 装配
nx_assembly_add → nx_assembly_move → nx_assembly_bom → nx_batch_drawings
# 4. 有限元
nx_fea_solid（mesh=draped, loads=pressure+force）→ 查看云图
常用命令行工具名（节选，完整列表见 README 2.2 节）：
nx_status # 查看 NX 会话状态
nx_open # 打开零件文件
nx_new # 新建 mm 零件
nx_measure # 测量体积/面积/质量/包围盒
nx_primitive # 创建基本体
nx_extrude # 拉伸轮廓
nx_boolean # 布尔运算
nx_export # 导出 STEP/IGES/STL
nx_batch_drawings # 批量出图（逐件 A3 + PDF）
nx_fea_solid # 真实几何有限元分析
nx_python # 执行 NXOpen Python 代码
适用场景与注意¶
适合已在本地部署 DSH、且安装 Siemens NX（及可选 Nastran 许可）的开发者或工程师：希望把「打开零件 → 改模型 → 出图/导出 → 简单 FE 校核」放进 harness 对话或工具链，并希望在侧栏查看状态与 STL 预览，而不占用 NX 前台。
使用前请注意：
- 插件以当前 DSH 进程权限在本机启动 NX worker、读写 bridge 目录与产物目录；安装前应阅读源码与 MIT 许可证，自行评估是否满足安全策略。
- README 安全说明：插件不访问外网、不收集数据；动态代码入口仅为
nx_python，设DSH_NX_ALLOW_PYTHON=0可拒绝；仅需只读能力时可设panel: false关闭侧栏。 - 操作前备份原始 prt；除非显式
nx_save，异常中断可能导致未保存更改丢失。 - DSH 生态是「一切皆插件」；SkillHub 目录 为社区站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-nx 把 NX 的建模、装配、有限元与批量出图封装成 harness 可调用的工具，并在侧栏提供会话管理与 STL 预览，适合把 CAD 步骤嵌入智能体工作流。细节与限制以仓库文档为准。
- 目录页：https://www.skillhub.cn/plugins/aaz111/dsh-nx
- GitHub：https://github.com/aaz111/dsh-nx
