3.5 KiB
3.5 KiB
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）
- 改
onebot-data\catalog\（换 STEP / 改 CSV / 编辑系列定义） - 双击
bin\维护入口.bat→ 目录制作器 → 【重建全量目录】 - 关预览服务器 → 跑
tools\publish.ps1→ 三份产物自动更新
⚠️ 两个规矩
- 业务文件（报价单/合同）不要放进本目录——之前因此锁过文件夹、误删过发布目录
- 发布前先关闭正在运行的程序 exe 和预览服务器（占用文件会导致发布失败）