前言¶
在 CAD 自动化里，常见做法是自己写 NXOpen 脚本、在 NX 里手动跑 Journal，或在单独进程里起一套桥接服务。DeepSeek Harness（DSH）把 MCP 工具接进对话后，模型可以直接调用外部能力；若你希望「聊天里发指令、当前打开的 NX 窗口里立刻建模」，就需要一条从 Harness 到 NX 会话的桥。下面介绍社区插件 dsh-nx（维护者 Touhouywn，分类：客户端）：它面向 Siemens NX / Designcenter 2512，在 DSH 里提供 MCP 工具与左侧 NX 面板，在已打开的 NX 窗口中执行 NXOpen 相关操作。
这是什么¶
dsh-nx 的定位是：Siemens NX 2512 for DeepSeek Harness —— 在已打开的 NX 窗口里运行 NXOpen journal，并在 DSH 左侧边栏提供 NX 面板。运行时（MCP 服务、NDJSON + Content-Length 帧、.NET live-bridge 客户端与 NX 菜单）打包在插件 vendor/ 目录，README 说明除 NX 与 DSH 外无需再单独安装桥接组件。
插件以 MIT 许可证发布，当前 package 版本为 0.1.0，仅支持 Windows x64 与 Node.js >= 20。
核心功能¶
MCP 工具¶
对话中可用工具命名空间为 mcp__nx__*，README 列出共 15 个，其中包括：
- 连通与状态：
nx_live_ping、nx_live_status - 执行：
nx_live_run_python、nx_run_journal - 模块与零件：
nx_live_module_list、nx_create_part、nx_open_part - 建模规划：
nx_modeling_plan_template等
NX 必须先启动；live bridge 监听 127.0.0.1:25121。若 NX 已在跑但 bridge 未起来，可在 NX 菜单 NX2512 Control > Start Codex Live Bridge 启动。
左侧 NX 面板¶
面板用于展示 bridge 端点、工具列表，以及可复制到对话里的 gear 命令；README 注明面板以信息展示与复制为主，实际执行通过聊天里的 MCP 工具完成。
自包含运行时¶
MCP 服务器、.NET live-bridge 与 NX 菜单脚本随插件分发在 vendor/；vendor/ 部分源自 codex-NX 插件包（MIT），说明见 NOTICE 与 vendor/LICENSE。本包为独立集成，与 Siemens 无隶属或背书关系。
环境与要求¶
| 项目 | 要求 |
|---|---|
| 操作系统 | Windows x64 |
| NX | Siemens NX / Designcenter 2512，已安装且能正常启动 |
| NX 会话 | 使用工具前 NX 须已打开；bridge 地址 127.0.0.1:25121 |
| Python | DSH 自带运行时（自动检测）、环境变量 CODEX_PYTHON，或 PATH 上的 python 任一即可 |
安装与启用¶
官方 README 要求：不要把 .tgz 直接当作只读 store 里的插件路径安装，应先解压到可写目录，再 add 本地路径。步骤如下。
- 解压并加入 DSH desktop profile：
# 1) extract into a writable folder (do NOT install the .tgz directly:
# pnpm hard-links tarballs into a read-only store, and setup must write a file)
tar -xzf dsh-nx-0.1.0.tgz
dsh plugin --profile desktop add D:\tools\dsh-nx
- 解析本机绝对路径（移动目录后需重跑；可选指定工程目录）：
node D:\tools\dsh-nx\bin\setup.mjs
# optional: --project "D:\my\prj"
- 重启 DeepSeek Harness。
卸载：
dsh plugin --profile desktop remove dsh-nx
安装前建议阅读仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行，涉及本机 NX 与本地端口，请自行评估环境与数据安全。
典型用法¶
在对话中可直接按 README 示例提问。
检查 bridge：
Use
nx_live_pingto check the bridge.
在项目 nx\ 目录下运行齿轮建模脚本（参数示例）：
Use
nx_live_run_pythonto runnx\gear_build.pywith{"m":20,"z":20,"b":200}.
gear_build.py 常用参数（置于 <project>\nx\）：
| 键 | 含义 |
|---|---|
m / z / b |
模数 / 齿数 / 齿宽 |
alpha ha c rho x |
压力角与齿形系数（默认 20 / 1 / 0.25 / 0.38 / 0） |
bore key_w key_t |
中心孔、键宽、轮毂键槽深（GB/T 1096） |
out_dir name |
输出目录与零件名 |
README 说明每次构建会做数值校验：体积相对解析值偏差 ≤3%、顶圆半径、齿宽、根圆柱面数量等。m=20, z=20, b=200 时示例输出包括 d、db、da、df 与体积、面类型统计（依据 GB/T 1356-2001 / GB/T 1357-2008 语境下的示例）。
适用场景与注意¶
- 适合：已在 Windows 上使用 NX 2512，希望在 DSH 对话里调用 NXOpen、检查 live bridge、跑项目内 Python journal（如齿轮示例）的开发者或 CAD 自动化使用者。
- 不适合：非 Windows、非 2512 版本 NX，或无法保持 NX 会话与 bridge 在线的环境。
- 权限与安全：MCP 工具可驱动本机 NX；安装前请核对 GitHub 源码与第三方 NOTICE。社区目录站点与 DeepSeek / 幻方无官方从属关系，DSH 生态以「一切皆插件」为理念，本插件为社区维护的客户端集成。
链接¶
- 社区目录页：https://www.skillhub.cn/plugins/Touhouywn/dsh-nx
- 源码与文档：https://github.com/Touhouywn/dsh-nx
