ethanrise/dsh-nx

dsh-nx

dsh-nx是一个面向DeepSeek Harness的实验性Siemens NX本地自动化Bundle，通过MCP暴露类型明确、受策略限制的建模工具。

本项目与Siemens、DeepSeek均无隶属或官方背书关系。

当前状态

0.1.0已包含：当前DSH Bundle格式、MCP服务、NX建模Skill、工作区安全策略、Mock Bridge、doctor、stdio端到端测试、Windows安装/构建脚本和NX 2512验收清单。

目前尚未在真实Windows + NX 2512环境完成Bridge验收。默认状态下所有写操作都会关闭失败；DSH_NX_MODE=mock只用于协议和Agent流程测试，返回结果始终带mock: true，不会生成.prt。

安装

最新版DeepSeek Harness已经移除旧.dsh-plugin仓库格式，本项目使用package.json.dsh.bundle和cordis.patch.yml：

dsh plugin --profile web add github:ethanrise/dsh-nx

每个正式Tag还会自动发布固定文件名的预编译包，目标电脑无需编译TypeScript：

https://github.com/ethanrise/dsh-nx/releases/latest/download/dsh-nx.tgz

将Skill复制到当前项目可发现目录：

New-Item -ItemType Directory -Force .dsh\skills\nx-modeling | Out-Null
Copy-Item node_modules\dsh-nx\skills\nx-modeling\SKILL.md .dsh\skills\nx-modeling\SKILL.md

开发和Mock测试：

npm install
npm run check
DSH_NX_MODE=mock npm run dev

安全边界

- 仅允许访问DSH_NX_WORKSPACE；
- Bridge仅允许本机回环地址并要求随机令牌；
- 默认不覆盖、不删除文件；
- 不提供任意Journal、Python、C#或Shell执行；
- Mock结果绝不能作为真实NX执行证据；
- 超时写操作不得自动重试，必须先检查NX状态。

第一版工具

环境检查、能力查询、会话状态、操作预检、结果验证、新建零件、Expression、矩形/圆草图、拉伸、简单孔、矩形阵列、受限圆角/倒角、特征树查询、实体测量、安全另存、STEP AP242导出和Undo。

装配、钣金、工程图、PMI、CAM、CAE、Teamcenter、复杂曲面、NX 1946及远程工作站不属于0.1.0。

Ubuntu说明

Ubuntu可以开发和测试MCP、Skill、Mock Bridge与安全策略，但不能验证NXOpen或原生.prt。真实支持声明必须在原生Windows + 合法NX 2512许可证环境完成验收。

插件市场

DSH Desktop通过dsh-market和awesome-dsh-plugin目录获得社区插件列表。发布检查、市场条目模板和提交步骤见docs/marketplace.md。真实NX验收通过前，市场描述必须明确本项目仍为实验性实现。