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

sample-data/onb-sc/coding-rules.md

@@ -0,0 +1,48 @@
+# 欧霓博 SC 系列标准气缸 —— 型号编码规则（示例数据）
+
+> 本文件为**自编示例数据**（虚构系列），用于目录软件开发测试，非真实产品数据。
+
+## 1. 型号编码格式
+
+```
+SC{Bore}x{Stroke}{Magnet}-{Mount}
+```
+
+| 段 | 含义 | 取值 | 示例 |
+|---|---|---|---|
+| `SC` | 系列代码（标准气缸） | 固定 | SC |
+| `{Bore}` | 缸径 (mm) | 16 / 25 / 32 / 40 | 32 |
+| `x` | 分隔符 | 固定 | x |
+| `{Stroke}` | 行程 (mm) | 25 / 50 / 75 / 100 | 50 |
+| `{Magnet}` | 磁石 | 空 = 无磁石；`S` = 带磁石 | S |
+| `-` | 分隔符 | 固定 | - |
+| `{Mount}` | 安装方式 | `FA` = 前法兰 / `LB` = 脚座 / `CB` = 中摆 | LB |
+
+**完整示例：`SC32x50S-LB`** = SC 系列，缸径 Ø32，行程 50mm，带磁石，脚座安装。
+
+## 2. 选型约束规则
+
+| # | 规则 | 说明 |
+|---|---|---|
+| R1 | 缸径 16 → 行程仅 25 / 50 | 小缸径不支持长行程 |
+| R2 | 磁石 `S` 要求缸径 ≥ 25 | 缸径 16 无磁石选项 |
+| R3 | 中摆 `CB` 要求行程 ≤ 75 | 长行程不提供中摆安装 |
+
+对应 [../params.csv](../params.csv) 中 72 个合法型号组合。
+
+## 3. STEP 文件命名
+
+STEP 文件名 = 型号 + `.step`，如 `SC32x50S-LB.step`，与 `params.csv` 的 `step_file` 列一一对应。
+
+## 4. 简化几何约定（示例用）
+
+模型为 4 个圆柱体组合（后盖 + 缸体 + 前盖 + 活塞杆），单位 mm，沿 Z 轴：
+
+| 零件 | 外径 | 长度/位置 |
+|---|---|---|
+| 缸体 | bore + 4 | 长 = stroke + 60，z: 0 ~ stroke+60 |
+| 后盖 | bore + 10 | 厚 8，z: -8 ~ 0 |
+| 前盖 | bore + 10 | 厚 10，z: stroke+60 ~ stroke+70 |
+| 活塞杆 | max(bore/5, 3) × 2 | 自 z = stroke+46 伸出至前盖上方 stroke+10 |
+
+> 真实产品数据接入时，用 Builder 导入真实 STEP 模型替换即可，编码规则与参数表格式不变。

sample-data/onb-sc/params.csv

@@ -0,0 +1,73 @@
+model_code,bore,stroke,magnet,mount,step_file
+SC16x25-FA,16,25,,FA,SC16x25-FA.step
+SC16x25-LB,16,25,,LB,SC16x25-LB.step
+SC16x25-CB,16,25,,CB,SC16x25-CB.step
+SC16x50-FA,16,50,,FA,SC16x50-FA.step
+SC16x50-LB,16,50,,LB,SC16x50-LB.step
+SC16x50-CB,16,50,,CB,SC16x50-CB.step
+SC25x25-FA,25,25,,FA,SC25x25-FA.step
+SC25x25-LB,25,25,,LB,SC25x25-LB.step
+SC25x25-CB,25,25,,CB,SC25x25-CB.step
+SC25x25S-FA,25,25,S,FA,SC25x25S-FA.step
+SC25x25S-LB,25,25,S,LB,SC25x25S-LB.step
+SC25x25S-CB,25,25,S,CB,SC25x25S-CB.step
+SC25x50-FA,25,50,,FA,SC25x50-FA.step
+SC25x50-LB,25,50,,LB,SC25x50-LB.step
+SC25x50-CB,25,50,,CB,SC25x50-CB.step
+SC25x50S-FA,25,50,S,FA,SC25x50S-FA.step
+SC25x50S-LB,25,50,S,LB,SC25x50S-LB.step
+SC25x50S-CB,25,50,S,CB,SC25x50S-CB.step
+SC25x75-FA,25,75,,FA,SC25x75-FA.step
+SC25x75-LB,25,75,,LB,SC25x75-LB.step
+SC25x75-CB,25,75,,CB,SC25x75-CB.step
+SC25x75S-FA,25,75,S,FA,SC25x75S-FA.step
+SC25x75S-LB,25,75,S,LB,SC25x75S-LB.step
+SC25x75S-CB,25,75,S,CB,SC25x75S-CB.step
+SC25x100-FA,25,100,,FA,SC25x100-FA.step
+SC25x100-LB,25,100,,LB,SC25x100-LB.step
+SC25x100S-FA,25,100,S,FA,SC25x100S-FA.step
+SC25x100S-LB,25,100,S,LB,SC25x100S-LB.step
+SC32x25-FA,32,25,,FA,SC32x25-FA.step
+SC32x25-LB,32,25,,LB,SC32x25-LB.step
+SC32x25-CB,32,25,,CB,SC32x25-CB.step
+SC32x25S-FA,32,25,S,FA,SC32x25S-FA.step
+SC32x25S-LB,32,25,S,LB,SC32x25S-LB.step
+SC32x25S-CB,32,25,S,CB,SC32x25S-CB.step
+SC32x50-FA,32,50,,FA,SC32x50-FA.step
+SC32x50-LB,32,50,,LB,SC32x50-LB.step
+SC32x50-CB,32,50,,CB,SC32x50-CB.step
+SC32x50S-FA,32,50,S,FA,SC32x50S-FA.step
+SC32x50S-LB,32,50,S,LB,SC32x50S-LB.step
+SC32x50S-CB,32,50,S,CB,SC32x50S-CB.step
+SC32x75-FA,32,75,,FA,SC32x75-FA.step
+SC32x75-LB,32,75,,LB,SC32x75-LB.step
+SC32x75-CB,32,75,,CB,SC32x75-CB.step
+SC32x75S-FA,32,75,S,FA,SC32x75S-FA.step
+SC32x75S-LB,32,75,S,LB,SC32x75S-LB.step
+SC32x75S-CB,32,75,S,CB,SC32x75S-CB.step
+SC32x100-FA,32,100,,FA,SC32x100-FA.step
+SC32x100-LB,32,100,,LB,SC32x100-LB.step
+SC32x100S-FA,32,100,S,FA,SC32x100S-FA.step
+SC32x100S-LB,32,100,S,LB,SC32x100S-LB.step
+SC40x25-FA,40,25,,FA,SC40x25-FA.step
+SC40x25-LB,40,25,,LB,SC40x25-LB.step
+SC40x25-CB,40,25,,CB,SC40x25-CB.step
+SC40x25S-FA,40,25,S,FA,SC40x25S-FA.step
+SC40x25S-LB,40,25,S,LB,SC40x25S-LB.step
+SC40x25S-CB,40,25,S,CB,SC40x25S-CB.step
+SC40x50-FA,40,50,,FA,SC40x50-FA.step
+SC40x50-LB,40,50,,LB,SC40x50-LB.step
+SC40x50-CB,40,50,,CB,SC40x50-CB.step
+SC40x50S-FA,40,50,S,FA,SC40x50S-FA.step
+SC40x50S-LB,40,50,S,LB,SC40x50S-LB.step
+SC40x50S-CB,40,50,S,CB,SC40x50S-CB.step
+SC40x75-FA,40,75,,FA,SC40x75-FA.step
+SC40x75-LB,40,75,,LB,SC40x75-LB.step
+SC40x75-CB,40,75,,CB,SC40x75-CB.step
+SC40x75S-FA,40,75,S,FA,SC40x75S-FA.step
+SC40x75S-LB,40,75,S,LB,SC40x75S-LB.step
+SC40x75S-CB,40,75,S,CB,SC40x75S-CB.step
+SC40x100-FA,40,100,,FA,SC40x100-FA.step
+SC40x100-LB,40,100,,LB,SC40x100-LB.step
+SC40x100S-FA,40,100,S,FA,SC40x100S-FA.step
+SC40x100S-LB,40,100,S,LB,SC40x100S-LB.step

sample-data/onb-sc/params_maq.csv

@@ -0,0 +1,37 @@
+model_code,bore,stroke,magnet,mount,step_file
+MAQ6x10-FA,6,10,,FA,MAQ6x10-FA.step
+MAQ6x10-LB,6,10,,LB,MAQ6x10-LB.step
+MAQ6x20-FA,6,20,,FA,MAQ6x20-FA.step
+MAQ6x20-LB,6,20,,LB,MAQ6x20-LB.step
+MAQ10x10-FA,10,10,,FA,MAQ10x10-FA.step
+MAQ10x10-LB,10,10,,LB,MAQ10x10-LB.step
+MAQ10x10S-FA,10,10,S,FA,MAQ10x10S-FA.step
+MAQ10x10S-LB,10,10,S,LB,MAQ10x10S-LB.step
+MAQ10x20-FA,10,20,,FA,MAQ10x20-FA.step
+MAQ10x20-LB,10,20,,LB,MAQ10x20-LB.step
+MAQ10x20S-FA,10,20,S,FA,MAQ10x20S-FA.step
+MAQ10x20S-LB,10,20,S,LB,MAQ10x20S-LB.step
+MAQ10x30-FA,10,30,,FA,MAQ10x30-FA.step
+MAQ10x30-LB,10,30,,LB,MAQ10x30-LB.step
+MAQ10x30S-FA,10,30,S,FA,MAQ10x30S-FA.step
+MAQ10x30S-LB,10,30,S,LB,MAQ10x30S-LB.step
+MAQ10x40-FA,10,40,,FA,MAQ10x40-FA.step
+MAQ10x40-LB,10,40,,LB,MAQ10x40-LB.step
+MAQ10x40S-FA,10,40,S,FA,MAQ10x40S-FA.step
+MAQ10x40S-LB,10,40,S,LB,MAQ10x40S-LB.step
+MAQ16x10-FA,16,10,,FA,MAQ16x10-FA.step
+MAQ16x10-LB,16,10,,LB,MAQ16x10-LB.step
+MAQ16x10S-FA,16,10,S,FA,MAQ16x10S-FA.step
+MAQ16x10S-LB,16,10,S,LB,MAQ16x10S-LB.step
+MAQ16x20-FA,16,20,,FA,MAQ16x20-FA.step
+MAQ16x20-LB,16,20,,LB,MAQ16x20-LB.step
+MAQ16x20S-FA,16,20,S,FA,MAQ16x20S-FA.step
+MAQ16x20S-LB,16,20,S,LB,MAQ16x20S-LB.step
+MAQ16x30-FA,16,30,,FA,MAQ16x30-FA.step
+MAQ16x30-LB,16,30,,LB,MAQ16x30-LB.step
+MAQ16x30S-FA,16,30,S,FA,MAQ16x30S-FA.step
+MAQ16x30S-LB,16,30,S,LB,MAQ16x30S-LB.step
+MAQ16x40-FA,16,40,,FA,MAQ16x40-FA.step
+MAQ16x40-LB,16,40,,LB,MAQ16x40-LB.step
+MAQ16x40S-FA,16,40,S,FA,MAQ16x40S-FA.step
+MAQ16x40S-LB,16,40,S,LB,MAQ16x40S-LB.step