工作交接：NX 按需生成服务（二期 A 版）

给接手的同事/新会话。读完这份 + 项目总览.md + 开发记录-NX2506批处理攻坚.md 即可快速跑起来。更新：2026-08-27

一、一句话现状

软件侧全部打通，两天卡点（NX 批处理导出 0 solid）已解决，全链路实测通过。现在只等真实母模（母版）就位。

二、系统由 3 个进程组成

进程	端口	作用	怎么启动
网页端 serve-web.ps1	8080	选型界面（客户看到的就是这个）	`_start_all.bat` 不含它，需单独起，或见 §五
GenServer.exe	8899	生成服务后端（队列/校验/下载/预览）	`_start_all.bat` 第 3 步
NX worker run_journal	—	常驻轮询任务，调 NX 生成数模	`_start_all.bat` 第 4 步

三、一键启动（最关键的一条命令）

d:\开发\OnebotCatalog\_start_all.bat

它会：停旧进程 → 编译 GenServer → 启动 GenServer → 启动 NX worker → health 自检。浏览器开 http://localhost:8080，底部信息栏右侧有状态圆球：绿=就绪，橙=等 worker，红=故障。

四、UG（NX）配置后台怎么进

浏览器开：http://localhost:8899/admin

密码登录：默认密码 onebot888。打开 /admin 先弹登录页 → 输密码 → 进后台。

后台是顶部三个 tab（点击切换）：

UG 配置：NX 版本目录（自动探测 2506/2512，可手动选）、数据源/母模/输出/任务/工作各目录、端口、API Key、管理页密码、队列上限、批量上限、限流
参数配置：直接编辑 masters.json（expressionMap / switchRules / exports），保存后即时热重载，无需重启
模型管理：手动清理（一键清空 output 目录）+ 定时清理（设置留存时长 outputTtlHours，0=永不清空）

密码改法：genserver-local\genserver-config.json 里 adminKey 字段（默认 onebot888）

五、网页端单独启动

_start_all.bat 没包含网页端（它是独立的 serve-web）。单独起：

d:\开发\OnebotCatalog\_start_web.bat

（站点在 release\web_2026.08\，config.js 里 api 已指向 http://localhost:8899）

六、母模 ↔ 参数的对应关系（建模工程师必读）

对应靠 onebot-data\masters.json 这张翻译字典：

"KC": {
  "masterPart": "KC_master.prt",
  "expressionMap": { "bore": "bore", "stroke": "stroke" },   // 尺寸参数 → NX表达式名
  "switchRules": [
    ["magnet", "", "magOn", "0"], ["magnet", "M", "magOn", "1"],
    ["mount", "", "mountIdx", "0"], ["mount", "FA", "mountIdx", "1"], ... 
  ],                                                          // 枚举开关 → NX表达式
  "exports": { "step": "214", "iges": true, "prt": true }
}

铁律：母模里的表达式名必须和 masters.json 写的一字不差（bore/stroke/magOn/mountIdx）；bore/stroke 带 mm 单位，magOn/mountIdx 是纯数字开关；磁石/固定形式用「按表达式抑制」切换。

待确认：type（00/02/03）是否影响几何？影响则补映射，不影响则忽略。

七、真实母模就位后做什么

把交互式建模的真实气缸母模命名 KC_master.prt，放到 catalog-masters\KC\ 覆盖占位母模
重跑 _start_all.bat
网页选 KC + stroke=87（非标）→ 在线生成 → 预览 → 下载
NX 打开生成的 .stp 核对缸径/行程与请求一致

八、关键踩坑（接手前必看）

.bat 必须纯 ASCII 无中文——cmd 按 GBK 读，中文会拆坏命令报"XX不是内部或外部命令"（见记忆 bat-ascii-no-chinese）
编译前先停 GenServer——exe 被运行中进程锁住会 error CS2012
批处理里别用 DexManager 导出——NX 2506 的 ST-DEVELOPER 翻译器在 run_journal 里判 0 solid，正解是独立命令行翻译器 step214ug.exe(.prt→.step)/iges.exe(.prt→.igs)
配置以 D 盘为准——W 盘是旧 TeamCenter 映射已废弃
前端 dev 源 web/ 与发布产物 release\web_2026.08\ 要同时改——serve-web 服务的是 release 目录

九、待办（剩余）

⭐ 真母模：建模工程师做真实气缸母模（等用户）—— 唯一真正卡进度的
NX 2512 实测：换机后先验证 journal API + step214ug.exe 在 2512 下可用
生产部署：netsh urlacl 授权、网页 config.js 填生产地址、桌面端 genApi 字段
待确认：type（00/02/03）是否影响几何，影响则补 masters.json 映射（后台「参数配置」tab 可直接改）

注：参数映射网页后台编辑、密码登录、模型管理（手动/定时清理）均已在 /admin 后台实现。

4.7 KiB Raw Blame History Unescape Escape