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

sample-data/README.md

@@ -0,0 +1,51 @@
+# 欧霓博目录软件 —— 示例数据包（自编，非真实产品数据）
+
+> 用途：供目录软件（OnebotCatalog）开发与测试。SC 系列为**虚构系列**，几何为简化模型。
+
+## 目录结构
+
+```
+sample-data/
+├── onb-sc/                    # 示例系列主体
+│   ├── step/                  # 72 个 STEP 变体文件（AP203 B-rep，4 圆柱组合）
+│   ├── params.csv             # 参数表（Excel 可直接打开；model_code/bore/stroke/magnet/mount/step_file）
+│   ├── coding-rules.md        # 型号编码规则 + 选型约束 R1~R3 + 几何约定
+│   └── docs/
+│       ├── dim-drawing/       # 2D 尺寸图 PNG（中英双语标注）×2
+│       └── datasheet/         # 数据表 PDF（中文/英文）×2 + 源 JPEG
+└── tools/                     # 生成脚本（全流程可复现）
+    ├── gen-step.ps1           # 生成 STEP 变体 + params.csv
+    ├── verify-step.ps1        # STEP 结构自检（引用/括号/ASCII/实体数）
+    ├── gen-images.ps1         # 生成尺寸图 PNG + 数据表 JPEG
+    ├── gen-pdf.ps1            # JPEG → 极简 PDF（含 xref 自检）
+    ├── fix-bom.ps1            # .ps1 加 UTF-8 BOM（PS 5.1 中文编码必需）
+    └── parse-check.ps1        # PowerShell 语法错误定位
+```
+
+## 快速复现
+
+```powershell
+# 1. 生成 72 个 STEP + params.csv
+powershell -NoProfile -ExecutionPolicy Bypass -File tools\gen-step.ps1
+powershell -NoProfile -ExecutionPolicy Bypass -File tools\verify-step.ps1
+
+# 2. 生成尺寸图与数据表
+powershell -NoProfile -ExecutionPolicy Bypass -File tools\gen-images.ps1
+```
+
+## 数据规模
+
+| 项 | 值 |
+|---|---|
+| 系列 | SC 标准气缸（1 个系列） |
+| 缸径 | 16 / 25 / 32 / 40 mm |
+| 行程 | 25 / 50 / 75 / 100 mm（缸径 16 仅 25/50） |
+| 磁石 / 安装 | 无,S × FA,LB,CB（受规则约束） |
+| 合法变体 | 72 个 |
+| STEP 格式 | ISO 10303-21 AP203 (CONFIG_CONTROL_DESIGN)，毫米单位 |
+
+## 注意事项
+
+- STEP 为手写极简 B-rep（每文件 126 实体），已通过结构自检；**几何有效性需在真实 CAD 中抽查**（SolidWorks/NX 打开 `step\SC32x50S-LB.step` 确认 4 个圆柱实体与尺寸）
+- `params.csv` 为 UTF-8 带 BOM，Excel 直接打开不乱码
+- 修改型号/规则后重跑 `gen-step.ps1` 即可整体重新生成