NX 建模工作台 aaz111/dsh-nx

dsh-nx

Siemens NX 插件 · DeepSeek Harness 侧栏工作台

在后台 NX 会话中完成三维建模、工程图纸、格式导出、装配管理与有限元分析，全部通过工具调用或侧栏面板驱动，无需手动操作 NX 图形界面。
甚至可以用许愿式的要求建模，但是 ai 生成不保证完全准确，生成结果需人工复核。

一、能力边界

✅ 能做什么

| 类别 | 工具 | 说明 |
| 会话管理 | nx_status nx_session nx_open nx_new nx_info nx_save | 查看/启动/重启 NX 会话，打开 .prt/.step/.iges，新建零件，查看信息，保存 |
| 测量 | nx_measure nx_faces | 体积、面积、质量、包围盒、质心；面列表（面积 + 中心点） |
| 实体建模 | nx_primitive nx_extrude nx_revolve nx_polygon | 长方体/圆柱/圆锥/球体，拉伸轮廓，旋转轮廓 |
| 曲线曲面 | nx_curve nx_surface | 直线/圆弧/圆/样条曲线；通过截面放样、网格曲面、拉伸曲面 |
| 基准与草图 | nx_datum nx_sketch | 基准平面/轴/点；矩形/圆/直线/多段线草图（自动约束），可直接拉伸/切除 |
| 布尔与细化 | nx_boolean nx_fillet nx_chamfer nx_hole nx_thread nx_shell | 合并/切除/相交，圆角，倒角，真实 NX 孔特征，内螺纹（符号+详细），抽壳 |
| 变换与阵列 | nx_transform nx_pattern nx_expression | 移动/旋转/镜像，线性/环形阵列，读写参数表达式 |
| 工程图纸 | nx_drawing nx_pdf nx_annotate | （能用，但不建议用，只能帮你出三视图但是作为人类不一定能看懂）自动投影视图 + 图纸，导出 PDF，自动标注（已有 PMI） |
| 制图补充 | nx_section_view nx_detail_view nx_note | 剖视图（指定剖切线），局部放大图（圆形区域 + 比例），文字注释（自动选中文字体） |
| BOM 与批量出图 | nx_bom_table nx_batch_drawings | 在图纸上画明细表（自绘表格线 + 每格注释），逐件 A3 图纸 + PDF |
| 格式导出 | nx_export | STEP / IGES / STL（等待 NX 异步翻译器完成） |
| 装配 | nx_assembly_add/move/fix/mate/list/gap | 插入组件、定位、约束、最小间隙检查 |
| 组件操作 | nx_component_pattern nx_component_op nx_explode | 组件阵列、替换/抑制/删除、爆炸图（真实位移，可还原） |
| 装配清单 | nx_assembly_bom nx_assembly_clearance | 按零件号汇总 BOM（数量/体积/质量，可导 CSV），逐对间隙矩阵（标记干涉） |
| 图层与引用集 | nx_layers nx_refset | 图层状态管理，移动实体到图层；引用集列表/创建/删除 |
| 有限元 | nx_fea_spec nx_fea_solve nx_fea_solid | NX Nastran 悬臂梁快速校核（SOL 101）；真实几何 FE（体素/铺面网格，力/压力/力矩/重力/离心，静力/模态，挠度 + Von Mises 云图） |
| 曲面闭环 | nx_surface_sew nx_thicken nx_surface_trim_extend nx_surface_nside | 曲面缝合、加厚成实体、修剪延伸、N 边补面 |
| 同步建模 | nx_sync_face nx_sync_region | 无草图改面：平移 / 偏置 / 拉出 / 改圆柱直径；删面并自动愈合 |
| 制图标注 | nx_gdt nx_balloon nx_surface_finish nx_centerline | 形位公差框、序号气球、表面粗糙度、中心标记 |
| 图框与标题栏 | nx_drawing_frame | 在图纸上画真实 GB 图框 + 标题栏（含中文），会随 PDF 打印 |
| 孔型与管路 | nx_hole（type）、nx_tube | 沉头孔 / 锥沉头孔；沿路径生成实心或空心管道 |
| 筋 / 特征阵列 / 坐标系 | nx_rib nx_pattern_feature nx_csys | 轮廓筋、线性特征阵列、基准坐标系 |
| 底层逃生舱 | nx_python | 在 NX 会话内执行任意 NXOpen Python 代码 |

单位统一：mm / 度 / kg。

❌ 不能做什么（已知限制）

| 限制 | 原因 | 替代方案 |
| DXF / DWG 导出 | NX 批处理翻译器挂起 | 用 STEP / IGES / STL |
| 原生标注尺寸 | 批处理无法创建 PMI 标注 | 用 nx_note 手写文字注释 |
| 草图约束尺寸 | NXOpen CreateDimension 未打通 | 用 nx_expression 驱动参数 |
| 隐藏线 | 批处理无隐藏线消除 | 用 nx_section_view 剖视展示内部 |
| 局部放大图内容为空 | 批处理无缩放渲染 | 用剖视图替代 |
| 模板图框（nx_drawing 的 template） | 模板图框不随 PDF 输出 | 用 nx_drawing_frame 画真实 GB 图框 + 标题栏 |
| 外螺纹 | NX 本机外螺纹数据缺失 | 仅支持内螺纹 |
| 直纹面 / 扫掠 / 投影 / 相交 / 回转曲面 | NXOpen 提交即报错 | 用 through_curves / mesh / extrude 替代 |
| 装配体直接导 STL | 装配体无自身 Body | 用面板预览或导出单个零件 |
| nx_fillet 重叠圆角 | NX 拒绝重叠倒角 | 分批选边圆角 |
| 拔模（Draft） | CreateDraftBuilder 提交报内存访问违规 | 用 nx_extrude 的 draft 参数 |
| 面替换（Replace Face） | 会让 NX 批处理会话挂死 | 用 nx_sync_region 删面愈合 |
| 特征阵列残留 | 阵列后留下 0 体积 sheet body | 导出时用 bodies 指定实体索引 |
| 装配求解器自动移动组件 | NX 批处理仅注册约束不求解 | 用 nx_assembly_move 手动定位 |
| 真正共形网格 | 需 Simcenter 网格器 | 用 draped 网格（体积误差 −0.9%，孔壁仍为体素形状） |
| Nastran 默认内存 14 GB | 桌面机不足 | 已改用 mem=2000mb |

截图展示：

二、使用说明

2.1 安装

方式一：从 Release 下载 zip 解压方式二：从源码安装
pnpm add file:<解压目录>/dsh-nx

前提：本地已安装 Siemens NX。安装路径由 nxHome 配置项或 UGII_BASE_DIR 环境变量指定；两者都不给时自动探测：先校验 UGII_BASE_DIR 确实是 NX 根，再扫常见 Siemens 目录及其两层子目录，最后扫所有存在盘符根（A:–Z:）的一层子目录，取第一个带 NXBIN\run_journal.exe 的目录。FE 工具额外需要 simulation / nastran 许可证。

2.2 命令行工具

直接对 AI 说出需求即可，插件会自动选择工具。也可以显式调用：

nx_status # 查看 NX 会话状态 nx_open # 打开零件文件 nx_new # 新建 mm 零件 nx_measure # 测量体积/面积/质量/包围盒 nx_primitive # 创建基本体 nx_extrude # 拉伸轮廓 nx_boolean # 布尔运算 nx_export # 导出 STEP/IGES/STL nx_drawing # 创建图纸（自动投影视图） nx_pdf # 导出 PDF nx_section_view # 创建剖视图 nx_detail_view # 创建局部放大图 nx_note # 添加文字注释 nx_bom_table # 在图纸上画明细表 nx_batch_drawings # 批量出图（逐件 A3 + PDF） nx_fea_solid # 真实几何有限元分析 nx_drawing_frame # 画 GB 图框 + 标题栏 nx_gdt # 形位公差框 nx_balloon # 序号气球 nx_surface_finish # 表面粗糙度 nx_centerline # 中心标记 nx_sync_face # 同步建模改面（move/offset/pull/resize） nx_sync_region # 同步建模删面愈合 nx_surface_sew # 曲面缝合 nx_thicken # 曲面加厚 nx_tube # 管道 nx_rib # 轮廓筋 nx_pattern_feature # 特征阵列 nx_csys # 基准坐标系 nx_python # 执行 NXOpen Python 代码

2.3 侧栏面板

在 DeepSeek Harness 侧栏点击 NX 图标即可打开工作台面板：

- 会话卡：NX 进程 ID、版本、已打开零件、运行时长
- 打开零件：输入路径打开文件，支持中文路径（自动解码 URL 编码）
- 分组操作：
- 零件：信息 / 测量 / 面列表 / 图层 / 引用集
- 出图：建图纸（可选 A4/A3/A2/A1）/ 打印 PDF / 剖视图 / 技术要求
- 文件：STEP / IGES / STL / 保存
- 装配：装配清单 / BOM 表（可选中英文 + 七列）/ BOM CSV / 间隙检查 / 爆炸图 / 批量出图
- 上一步结果：显示最近操作的输出摘要 + 文件链接（点击可预览/打开文件夹）
- 最近产物：输出目录下的最新文件列表，新文件标绿点
- 3D 预览：点击预览按钮查看 STL 网格渲染（支持剖切滑杆）

2.4 配置项

| 配置键 | 默认值 | 说明 |
| panel | true | 设为 false 跳过侧栏面板路由 |
| outputDir | ~/.dsh-nx/out | 产物收集目录（也可用 DSH_NX_OUT 环境变量指定）|
| nxHome | 自动探测 | NX 安装路径（也可用 UGII_BASE_DIR 环境变量指定）|

2.5 快速上手示例

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）→ 查看云图

三、安全说明

通用安全扫描器会把本插件标出若干项。它们全部是本机行为：插件不访问外网、不收集数据、不上传任何文件。逐条对应如下：

| 扫描项 | 实际行为 | 能否关闭 |
| 执行动态代码（exec） | nx_python 工具在 NX 进程内执行调用方给的 NXOpen Python，是插件唯一执行外部代码的入口 | 设 DSH_NX_ALLOW_PYTHON=0 后该工具直接拒绝 |
| child_process 调 taskkill | 只用于结束本插件自己启动的 NX worker 进程树 | 不可关 |
| child_process 启动 run_journal.exe | 启动 NX 自带的 NXBIN 目录下的 run_journal.exe 运行 nxworker.py，这是与 NX 通信的唯一方式 | 不可关 |
| 文件系统写入 | 向 .dsh-nx/bridge 下的 req 与 resp 目录写 JSON 请求、响应（文件队列协议） | 不可关 |
| fetch | 侧栏面板在浏览器与 DSH 本机服务之间请求 state 与 action 两个端点，不指向外网 | 不可关 |
| process.env 读取 | 读 UGII_BASE_DIR、DSH_NX_OUT、NXBRIDGE_* 等路径，并传给 worker | 不可关 |

收紧方式：

1. 不需要跑任意 Python 时，在启动 DSH 前设环境变量 DSH_NX_ALLOW_PYTHON=0；
2. 只需要只读能力时，用 panel: false 关掉侧栏面板。

四、免责声明

AI生成警告！！！！！不能保证完全准确，任何功能都是，所有输出均要人工复核才能下一步。

1. 本插件是第三方工具，非 Siemens 官方产品。NXOpen API 的行为可能随 NX 版本更新而变化，本插件仅在 NX 2512 上测试通过，其他版本未经验证。

2. 模型数据安全：本插件通过后台 NX 会话操作零件文件。请在使用前备份原始文件。插件不会主动保存文件（除非显式调用 nx_save），但异常中断可能导致未保存的更改丢失。

3. 有限元结果仅供参考：nx_fea_solid 使用体素/铺面网格近似几何，结果精度受网格密度和边界条件简化影响。不得直接用于工程设计决策或安全认证，重要结构请使用 Simcenter / ANSYS 等专业 FE 软件复核。

4. 导出文件格式兼容性：STEP / IGES 导出遵循 ISO 标准，但不同 CAD 软件对格式的解释可能存在差异。请在目标软件中验证导入结果。

5. 第三方依赖：FE 工具依赖 NX Nastran 求解器（需 simulation / nastran 许可证）。无许可证时 FE 相关工具将报错，但不影响其他功能。

6. 使用风险：本插件按 MIT 许可证提供，不附带任何明示或暗示的担保。使用本插件产生的任何直接或间接损失（包括但不限于数据丢失、模型损坏、生产延误），作者不承担任何责任。

7. 开源组件：本插件使用了 LibreOffice Kit（文档渲染）、numpy、Pillow（云图绘制）等开源组件，各自遵循其原始许可证。

License: MIT