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

文件夹说明.md

@@ -0,0 +1,47 @@
+# OnebotCatalog 文件夹说明
+
+> 欧霓博气动元件电子目录软件 —— 项目主目录（2026-08-22 更新为**自包含布局**：软件+数据+工具都在这个文件夹里，整体拷贝/备份不断链）。
+
+## 根目录文件
+
+| 文件 | 说明 |
+|---|---|
+| README.md | 开发说明（开发人员必读） |
+| 文件夹说明.md | 本文件 |
+| ONEBOT - 直线气缸 - 中文.pdf | 产品手册原件（71MB，数据提取的源头，勿删） |
+| OneBot-logo.png | 品牌 logo 原件 |
+| ⚠️ 报价单-柳州五菱工业2026.8.15.xlsx | **误放的业务文件**（复制残留，`~$` 锁文件说明 Excel 还开着它）——保存关闭 Excel 后请移出本目录 |
+
+## 子文件夹
+
+| 文件夹 | 是什么 | 谁在用 |
+|---|---|---|
+| **src/** | 软件源代码（C# / WPF，无 XAML） | 开发 |
+| **bin/** | 编译产物：`OnebotCatalog.exe`（开发版）、`OnebotCatalog-Customer.exe`（客户版）、`维护入口.bat`（双击进维护界面，密码 onebot888） | 维护/开发 |
+| **sample/** | 数据包 `.opc`（当前：`OnebotCatalog_2026.08.opc` 11 系列 52,154 型号）+ 自测日志 | 发布 |
+| **release/** | **交付产物**：`OnebotCatalog_2026.08\`（客户版，压缩即交付）、`update_2026.08\`（增量包）、`web_2026.08\`（网页站） | 客户 |
+| **web/** | 网页版前端源码（index.html / app.js / style.css，纯静态零依赖） | 开发 |
+| **viewer/** | 新迪 3D 查看器**本地副本**（桌面"浏览器预览"与本地网页预览共用；原项目在 Z 盘只读，生产部署补丁见 viewer\菜单精简-生产部署补丁.txt） | 3D 预览 |
+| **tools/** | 构建发布脚本：build.ps1（编译）、publish.ps1（一键发布三份产物）、serve-web.ps1（本地网页预览服务器）等 | 维护/开发 |
+| **lib/** | 开源渲染库 HelixToolkit.Wpf.dll（MIT，窗口内 3D 渲染 STL 网格用，编译自动附带进 exe 目录） | 开发/构建 |
+| **assets/** | 图标资源（OneBot-logo.png/ico，编译进 exe） | 构建 |
+| **docs/** | 用户手册.md / 维护手册.md | 客户/维护 |
+| **onebot-data/** | ★**产品数据管线**★：`catalog\` = 唯一数据源（系列定义+参数表+STEP+手册页+**平替对照表 crossref.csv**），`tools\` 源生成/手册拆页/佳尔灵对照提取工具，`数据维护说明书.md` = 团队操作指南（**改数据看这个**） | 维护 |
+| **sample-data/** | 样例数据（虚构 SC/MAQ 系列）+ **NX 工具**：`nx-batch-export.vb`（母模批量导出）、`nx-batch-export-glb.vb`（GLB 轻量化）、`NX母模建模操作说明书.md`（母模建模教程） | NX 建模 |
+
+## 日常三种角色看哪
+
+- **客户**：只拿到 `release\OnebotCatalog_2026.08\` 文件夹（或 zip），双击 exe 即可
+- **维护数据**：`onebot-data\`（改完按数据维护说明书"重建→发布"）＋ 双击 `bin\维护入口.bat`
+- **NX 建模**：`sample-data\tools\NX母模建模操作说明书.md` + 两个 journal
+
+## 更新数据三步（详见 onebot-data\数据维护说明书.md）
+
+1. 改 `onebot-data\catalog\`（换 STEP / 改 CSV / 编辑系列定义）
+2. 双击 `bin\维护入口.bat` → 目录制作器 → 【重建全量目录】
+3. 关预览服务器 → 跑 `tools\publish.ps1` → 三份产物自动更新
+
+## ⚠️ 两个规矩
+
+1. **业务文件（报价单/合同）不要放进本目录**——之前因此锁过文件夹、误删过发布目录
+2. 发布前先关闭正在运行的程序 exe 和预览服务器（占用文件会导致发布失败）