OnebotCatalog —— 欧霓博气动元件电子目录软件（自研）

对标 CADENAS PARTdataManager 目录光盘，但不依赖任何 CADENAS 组件。目标：普通客户通过软件选型并下载 STEP 文件，导入自己的 CAD 使用。

📌 项目全景/架构/踩坑/待办见同目录 项目总览.md（继续开发的入口）；本文件夹各目录用途见 文件夹说明.md；改数据看 onebot-data\数据维护说明书.md；NX 母模建模看 sample-data\tools\NX母模建模操作说明书.md。

现状（2026-08-22）

• M1/M2/M3 全部完成：桌面版（含维护入口）+ 网页版（纯静态）+ 一键发布三份产物 + 真实数据入库（17 系列 52,193 型号；含 2026-08-23 新增的 6 个 UNIVER 系分类样板系列 UCBM/ULP/USP/UGP/UAGP/LAE）
• 数据源：onebot-data\catalog\（catalog.json + series*.meta.json + csv\ + step\ + manual\ + crossref.csv 平替对照）
• 特色功能：平替对照（竞品型号↔我方型号，搜索/标签页双入口）、手册页对照、新迪 3D（menu=min 精简）、.stp/.step 后缀兼容
• 自测：ONEBOT 包 25 项 / 样例包 40 项（--selftest，结果 sample\selftest.log）
• 品牌：ONEBOT；维护密码：onebot888

目录结构（自包含布局，整体拷贝不断链）

OnebotCatalog/
├── 项目总览.md / 文件夹说明.md / 设计文档 / 开发提示词   ← 文档都在根
├── src/            # 源代码: App(WPF界面) + CatalogCore(数据包/规则引擎/构建器) + Viewer3D(自绘3D)
├── bin/            # 编译产物: OnebotCatalog.exe(开发版) + OnebotCatalog-Customer.exe(客户版) + 维护入口.bat
├── sample/         # 数据包 .opc + selftest.log + SC-meta.json(单系列配置样例)
├── release/        # 交付产物: OnebotCatalog_2026.08\(客户版目录) + update_2026.08\(增量包) + web_2026.08\(网页站)
├── web/            # 网页版前端源码 (纯静态: index.html/app.js/style.css)
├── viewer/         # 新迪 3D 查看器本地副本 (桌面浏览器预览/网页 3D; 原项目 Z 盘只读)
├── tools/          # build.ps1 编译 / publish.ps1 一键发布 / serve-web.ps1 本地预览(16并发) / fix-bom.ps1 等
├── assets/         # OneBot 图标 (编译进 exe)
├── docs/           # 用户手册 / 维护手册
├── onebot-data/    # ★唯一数据源★ catalog\ + 生成工具 + 数据维护说明书.md
└── sample-data/    # 样例数据 + NX 工具 (nx-batch-export.vb 批量导出 / nx-batch-export-glb.vb / 母模说明书)

常用命令

# 编译开发版
powershell -NoProfile -ExecutionPolicy Bypass -File tools\build.ps1

# 自测 (结果看 sample\selftest.log)
bin\OnebotCatalog.exe --selftest sample\OnebotCatalog_2026.08.opc

# 全量构建 (统一路线: 源目录 → .opc; 维护窗口【重建全量目录】同内核)
bin\OnebotCatalog.exe --buildfull onebot-data\catalog sample\OnebotCatalog_2026.08.opc

# 一键发布 (自测门禁 → 客户版 exe(数据内置) → 光盘目录+增量包+网页站; ★先停 serve-web 和运行中的 exe★)
powershell -NoProfile -ExecutionPolicy Bypass -File tools\publish.ps1

# 本地网页预览 (localhost:8080, 关掉即停)
powershell -NoProfile -ExecutionPolicy Bypass -File tools\serve-web.ps1

# 运行 (客户模式 / 维护模式)
bin\OnebotCatalog.exe sample\OnebotCatalog_2026.08.opc
bin\OnebotCatalog.exe sample\OnebotCatalog_2026.08.opc --admin    # 或双击 维护入口.bat (密码 onebot888)

注意: 编辑任何含中文的 .ps1/.cs/.vb 后必须运行 sample-data\tools\fix-bom.ps1 再编译/运行（PowerShell 5.1/csc 对无 BOM 文件按 GBK 读取）。

与设计文档的偏差（环境适配）

设计文档 (M1)	实际实现	原因
C# / .NET 8 (WPF+MVVM)	C# / .NET Framework 4.8 (代码式 WPF)	本机无 .NET SDK；net48 内置于 Win10/11，客户机免装运行时
SQLite + FTS5	catalog.json (zip 内) + 内存查询	避免外部依赖；10 万级变体内存 LINQ 足够
Helix Toolkit 渲染	WPF 内置 Viewport3D + 自绘解析器	零依赖；真实 B-rep 走浏览器+新迪查看器（内嵌本机服务器）
预生成预览网格	占位几何直接解析；真实数模浏览器预览	真实 CAD 通用 STEP 由 NX 母模批量导出（预生成变体）
MVVM	代码式事件驱动	保持模块分层（Core 不依赖 UI）

已知简化（诚实清单）

• 维护密码硬编码 onebot888（在 App.cs，未移配置）
• 桌面 3D：真实 B-rep 窗口内直渲、不弹浏览器——有 STL 网格走开源 Helix Toolkit（MIT），无网格走 WebView2 内嵌新迪查看器（真实 STEP 直接渲染，Win11 自带运行时）；两者都不可用才回退外部浏览器；网页轻量化（glTF）待办 9
• 行程为离散标准档位（10/20/30/50/75/100）；"任意行程"待参数化二期（NX 运行时生成，待办 7）
• 网页 3D 对占位 STEP 走 Canvas 回退；真实 NX STEP 走新迪渲染（已验证）
• 发布站 app.js 的 VIEWER_BASE 需按生产部署改前缀（见项目总览 §12）

待办（见项目总览 §9 完整清单）

• NX 母模批量导出真实 STEP（KC-00-32x10 已试点；母模说明书见 sample-data\tools\）
• 代码签名证书 / 虚拟机验收 / 检查更新 / 参数化二期 / TC 集成（可选）