# 欧霓博目录软件 —— 示例数据包（自编，非真实产品数据）

> 用途：供目录软件（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` 即可整体重新生成
