OnebotCatalog/docs/用户手册.md

# 欧霓博气动元件电子目录 —— 用户手册 / User Manual

## 1. 安装与运行 / Install & Run

- 本软件为绿色程序，**无需安装**，双击 `OnebotCatalog.exe` 即可运行（Windows 10/11，不需要额外安装 .NET 运行时）。
- 光盘/U 盘自动播放默认被系统禁用，请直接双击 exe。
- 首次运行若杀毒软件提示拦截（程序未做代码签名），请选择"允许"或加入白名单。

## 2. 选型 / Configure a Part

1. 左侧目录树选择产品系列（如：汽车行业气缸 → KC 系列标准气缸）。
2. 中间面板依次选择参数：型号 → 缸径 → 行程 → 磁石 → 固定形式。灰色下拉即已按选型规则过滤，不可能的组合不会出现。
3. 选满后上方显示型号（如 `KC0032-100MLB`），3D 预览自动显示该型号外形。
4. 3D 预览操作：鼠标左键拖拽旋转、滚轮缩放；真实数模会提示【在浏览器中打开 3D 预览】按钮（本机运行，不联网）。
5. 三个区域（目录树/参数面板/3D 视图）之间的分隔条可拖拽调宽。

## 3. 下载 STEP 文件 / Download STEP

- 完成选型后点击顶部 **「下载 STEP」**，选择保存位置，文件按 `型号.step` 命名（如 `KC0032-100MLB.step`）。
- STEP 为通用交换格式，SolidWorks / NX / CATIA / Creo / Inventor 等主流 CAD 均可直接打开（打开时选择"零件/实体"模板）。
- **批量下载**：切换到「参数表」标签页，Ctrl/Shift 多选型号行，点击上方「批量导出所选」，得到 zip（内含各型号 STEP + BOM.csv 清单）。

## 4. 搜索与筛选 / Search & Filter

- 顶部搜索框支持：型号编码（如 `KC0032`、`32x50`）、中文名（缸径）、英文名（Bore）、拼音关键词（gangjing）。
- 多个词用空格分隔；双击搜索结果直接定位到该型号。
- 「参数表」标签页上方可对数值参数做范围筛选（如缸径 32 ~ 63），点「应用」生效、「重置」清除。

## 5. 尺寸图与数据表 / Drawings & Datasheet

- 「尺寸图」标签页：2D 尺寸图 + **产品手册对照页**（选中系列即显示，滚动翻看规格参数/外形尺寸）
- 「数据表」标签页：打开 PDF 数据表
- 顶栏按钮可在 中文 / EN 之间切换界面语言

## 6. 常见问题 / FAQ

| 问题 | 处理 |
|---|---|
| 双击无反应 / 被杀软拦截 | 加入杀软白名单；确认系统为 Win10/11 |
| 提示"数据包格式版本高于软件支持" | 目录数据比软件新，请联系欧霓博获取新版软件 |
| 提示"数据包格式版本不兼容" | 数据包损坏或过旧，请重新获取 catalog.opc |
| 下载的 STEP 打开报错 | 换一种"打开"方式（文件→打开，模板选零件）；或反馈该型号给欧霓博 |
| 3D 标签页显示提示按钮而非模型 | 该型号是真实 CAD 数模，点按钮在浏览器中查看 3D（本机运行） |
| 目录内容更新 | 用新 catalog.opc 替换程序旁的旧文件（目录版）；单文件版需更换整个 exe |

## 7. English Quick Guide

1. Double-click `OnebotCatalog.exe` (no installation, Windows 10/11).
2. Pick a series in the left tree, then set parameters (type / bore / stroke / magnet / mounting) — invalid combinations are filtered automatically.
3. Click **Download STEP** to save the 3D model (e.g. `KC0032-100MLB.step`), or export many in the **Parameters** tab (Ctrl/Shift multi-select → Export selected).
4. Search by model code, Chinese/English names or pinyin keywords in the top search box.
5. Use **EN/中** button to switch language.