dsh-ug-viewer
在 DSH (DeepSeek Harness) 里预览 UG/NX 模型、点选几何、看特征树，还能就着选中的面、边、特征直接问 AI。
Preview UG/NX models inside DSH — orbit, pick faces and features, and ask an AI about what you selected.
不是把模型截图贴进来——是真的能转、能点、能问。
功能
模型预览
- STL / OBJ：直接拖进来就能转（中键旋转、滚轮缩放、左键平移）
- PRT 直接预览：不导出 STL，后台调 NX 把实体三角化后直接渲染
- 只有草图的 PRT：画出草图线框（圆弧离散成折线）
几何选择
| 能选什么 | 怎么选 | 反馈 |
|---|
| 面 | 点面中间 | 整面蓝 |
| 边 | 点面边界 6px 内 | 整条边红 |
| 特征 | 左栏特征树点一行 | 该特征关联的体蓝 |
| 草图曲线 | 线框模式下点线 | 整条曲线红 |
| 草图点 | 点小十字 | 浮层「点 #N」 |
| 曲线交点 | 点交叉处 | 浮层「交点 #N」 |
| 草图约束 | 特征树展开草图 | 浮层「约束 · 重合」 |
全部支持多选：点一下加、再点取消、点空白清空。
特征分析
- 左侧常驻特征树（可折叠），打开 PRT 自动加载
- 显示特征类型、参数表达式、父子依赖
- 草图可展开看 22~44 个约束（重合、相切、半径、角度…）
就地问答
视口下方有一条「问七音」对话栏，直接调 Host 的 llm 服务：
- 选中几何 → 输入问题 → 回车
- 自动把选中的面/边/特征/约束/曲线/点/交点拼进上下文
- 流式返回，一条消息都不用切走
界面
- 三栏布局：目录 | 特征树 | 视口
- 目录和特征树都能折叠（工具栏左侧
☰ / ▤）
- 视图预设（等轴/前/上/右）、线框、自动旋转、截图、重置
安装
前置
- DSH（Web GUI）
- NX 12+（只有 PRT 预览和特征分析需要；STL/OBJ 不需要）
NX 12 内嵌 Python 3.6，插件通过 run_journal.exe 调 NX Open。
步骤
# 1. 克隆到任意目录
git clone https://github.com/QIKO0721/dsh-ug-viewer.git
cd dsh-ug-viewer
# 2. 装进 DSH（任选一种）
dsh plugin --profile web add link:$(pwd)
# 或
plugin_manager { action: install_bundle, target: "<绝对路径>" }
装完刷新页面，侧边栏会出现「UG 模型预览」。
配置
编辑 cordis.patch.yml，把路径改成你自己的：
config:
roots:
- 'D:\models' # 模型目录（可写多个）
maxFileBytes: 100663296 # 单文件上限（96 MB）
maxDepth: 3 # 递归深度
maxModels: 400 # 列表上限
runJournalExe: 'D:\UG\NXBIN\run_journal.exe' # NX journal 运行器
analyzeTimeoutMs: 180000 # 分析超时
也可以在面板里点「选目录」运行时切换（会记到 ~/.dsh/dsh-ug-viewer.json）。
技术原理
PRT 三角化（按面）
NX Open 没有直接导 STL 的 Part 方法，得用：
creator = session.DexManager.CreateStlCreator()
creator.ExportSelectionBlock.SetArray([face]) # 单个面
creator.Commit()
每个面单独导出一次（~0.008 s/面），Host 合并时记下 faceID + 类型 + 面积 + 法线 + 包围盒。
点选
- 面：屏幕空间三角形内测试，取最近的
- 边：点到边界线段的屏幕距离（6px 内优先）
- 曲线/点/交点：线框模式下的线段/点距离检测
特征
feature.GetExpressions() # 参数表达式（直径、长度…）
feature.GetBodies() # 关联的体（实体特征才有）
feature.GetChildren() # 父子依赖
sketch.Sketch.GetAllConstraintsOfType(ConstraintClass.Any, type) # 约束
问答
ctx.llm.stream({ provider, model, messages }) // 不经过 session
已知限制
| 限制 | 原因 |
|---|
| 特征不能精确高亮到面 | NX 外部 API 不暴露 feature→face 映射（GetEntities() 只返回曲线/基准） |
| 特征高亮会"过量" | 一个体可能由多个特征生成，只能整体高亮 |
| 无实体零件不能点面 | 只有曲线，没有 B-rep 面 |
| 面板对话不持久 | 不进 session 日志，刷新即失忆 |
NXOpen.UF 不可用 | 这个 NX 12 没带 UF 模块，只能走 NXOpen |
目录结构
dsh-ug-viewer/
├── index.js # Host：路由、journal 调度、缓存
├── client.js # Client：WebGL 视口、点选、特征树、对话
├── cordis.patch.yml # 插件配置
├── locale/ # 中英文案
├── icon.svg
├── screenshots/
└── test/ # 独立测试脚本
测试
cd dsh-ug-viewer
node test/geometry-once.mjs # 测 PRT 几何导出
node test/chat-once.mjs # 测面板对话接口
（需要 DSH 正在运行，插件已安装。）
License
MIT
