首次提交: OnebotCatalog 项目代码与文档（含 NX 按需生成服务二期、后台、一键启动）

README.md

@@ -0,0 +1,79 @@
+# 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
+# 编译开发版
+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 集成（可选）