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.