前言¶
在 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
