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