OnebotCatalog 开发计划书

定位：在现有 OnebotCatalog 基础上继续优化，不推翻重做。更新时间：2026-08-31 配套文档：项目总览.md（全貌）、docs\工作交接.md（快速上手）、docs\部署清单.md（迁移部署）、OnebotCatalog升级改制开发说明书.md（升级方向）

一、当前状态总览

软件侧主线已全部打通：

唯一真正卡进度的外部依赖：真实母模（建模工程师）。

决策	结论	日期
去 NX 化（升级 2）	❌ 不做。OCCT 程序化建模出不了真实母模精确几何，且与已打通的 NX 主线冲突	2026-08-31
TC 集成（M4 / 升级3 / 升级4）	⏳ 暂缓。代码对 TC 零感知，按优先级排在真母模+轻量化+部署之后	2026-08-31
Parasolid / STL 格式	❌ 已砍，非标生成只留 STEP / IGES / PRT	2026-08-27
OCCT 转换服务	✅ 做，但只当 STEP→glTF 转换器，不碰参数化建模	2026-08-31

#	任务	说明	状态
1	OCCT 转换服务搭建	把 `d:\source_code\occt_demo\occt_demo.py` 固化成常驻 8090 服务 + `/convert`（STEP→glTF）+ `/health`	待开工
2	生产部署收尾	netsh urlacl 授权、网页 config.js 填生产地址、桌面 catalog.json genApi + 重建发布	待开工

#	任务	说明	状态
3	升级 1：网页 3D 轻量化	构建期批量预生成 glTF（标准档位 2772 个）+ 前端 Three.js 加载 glTF 降级新迪查看器	待开工（依赖 1）

#	任务	说明	状态
4	升级 3：TC 母模数据源	母模入 TC + 发布工作流	暂缓
5	升级 4：客户 TC 检入	有 TC 大客户才做	暂缓

#	任务	说明	状态
6	升级 5：增强功能	3D 标注 / 2D 尺寸 SVG / 工程图导出	暂缓

#	任务	阻塞点	谁
7	真实母模	建模工程师做真实气缸母模（表达式名 bore/stroke/magOn/mountIdx 一字不差）	用户侧，唯一卡交付
8	NX 2512 换机实测	换机 + 验证 journal API / step214ug.exe	用户侧

现在就能做（并行）：
  1 OCCT 转换服务  ─┐
  2 生产部署收尾    ─┴→ 3 网页3D轻量化 → 4 TC母模 → 5 客户TC检入 → 6 增强

外部等待（并行推进）：
  7 真母模、8 NX 2512 实测

OCCT 转换服务不依赖 NX，服务器没装 NX 也能跑。分工：

服务器（无 NX）：GenServer + OCCT转换 + serve-web
局域网 NX 机器：NX worker（非标参数化生成 STEP）
对接方式：jobs/output/masters 目录用网络共享（UNC 路径）