# 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 和预览服务器（占用文件会导致发布失败）