OnebotCatalog/sample-data/README.md

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

用途：供目录软件（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 语法错误定位

快速复现

# 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 即可整体重新生成