# catia_caa_v5_interface_viewer

**Repository Path**: xuscode1/catia_caa_v5_interface_viewer

## Basic Information

- **Project Name**: catia_caa_v5_interface_viewer
- **Description**: catia V5接口查询工具
- **Primary Language**: HTML
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-05
- **Last Updated**: 2026-06-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 3DS Help Viewer

一个用于浏览CATIA V5接口文档的工具。

自从有了Vibe Coding AI之后，Visual Studio像这种重型的软件，基本上也没有打开的必要了，但是呢，接口还是要自己去查询的，这样可以节约一些token，搞了这么个小玩意儿,AI 5分钟自动写的

## 功能特性

- 🔍 通配符搜索 - 支持 * 和 ? 通配符，按回车键搜索
- 🏷️ 类型筛选 - 可按Enum、Define、Method、Typedef等类型筛选
- 📂 数据加载 - 自动加载htm索引文件
- 📄 文档浏览 - 双击打开对应的htm文档
- 🎨 简洁界面 - Fusion风格，清晰的布局

## 文件结构

```
├── 3DSHelpViewer.exe      # Windows 可执行文件
├── visidx.txt.htm         # 索引文件
└── generated/
    └── refman/            # htm文档目录
        ├── MecModInterfaces/
        ├── VPMInterfaces/
        └── ...
```

## 使用方法

### Windows

1. 将 `3DSHelpViewer.exe`、`visidx.txt.htm` 和 `generated/refman` 文件夹放在同一目录
2. 双击运行 `3DSHelpViewer.exe`
3. 在搜索框中输入关键词，按回车键进行搜索
4. 使用左侧的类型筛选复选框过滤结果
5. 双击表格中的项目可打开对应的htm文档

### Linux

#### 方法一：直接运行源码（推荐）

```bash
# 安装依赖
pip install PyQt5

# 运行程序
python3 help_viewer.py
```

#### 方法二：编译为可执行文件

```bash
# 安装依赖
pip install PyQt5 pyinstaller

# 使用构建脚本
python3 build_for_windows.py

# 或手动编译
pyinstaller --onefile --name 3DSHelpViewer help_viewer.py

# 运行
./dist/3DSHelpViewer
```

#### 方法三：编译为 DEB 包 (Ubuntu/Debian)

```bash
# 1. 安装依赖
sudo apt update
sudo apt install python3 python3-pip dpkg-dev
pip install PyQt5 pyinstaller

# 2. 使用 DEB 打包脚本
chmod +x build_for_ubuntu.sh
./build_for_ubuntu.sh

# 3. 安装 DEB 包
sudo dpkg -i dist/3dshelptool_1.0_amd64.deb

# 4. 卸载
sudo dpkg -r 3dshelptool
```

## 界面说明

- **搜索框** - 输入关键词，按回车键搜索，支持通配符 `*` 和 `?`
- **左侧面板** - 包含类型筛选选项
  - `Data` - 数据加载控制
  - `Types` - 类型筛选复选框（Enum/Define/Method/Typedef/Data/Global/Class/Struct/Interface）
  - `All/None` - 全选/全不选按钮
- **右侧表格** - 显示搜索结果
  - Name - 接口/方法名称
  - Type - 类型
  - Framework - 所属框架
  - Description - 描述信息
- **状态栏** - 显示搜索结果数量和索引文件路径

![](./Snipaste_2026-06-05_14-20-40.png)

## 搜索语法

### 普通搜索
直接输入关键词搜索：
```
GSM          # 搜索包含 "GSM" 的内容
Add          # 搜索包含 "Add" 的内容
```

### 通配符搜索
使用 `*` 和 `?` 进行模糊匹配：
```
*GSM*        # 匹配包含 GSM 的内容
GSM*         # 匹配以 GSM 开头的内容
*GSM         # 匹配以 GSM 结尾的内容
*GSM*abc*    # 支持多个通配符组合
?ethod       # ? 匹配任意单个字符
```

## 系统要求

### Windows
- Windows 操作系统
- 无需额外安装Python或依赖库（已打包为独立exe）

### Linux
- Python 3.6+
- PyQt5

## 构建说明

### Windows

使用构建脚本：
```bash
python build_for_windows.py
```

或手动编译：
```bash
pip install pyqt5 pyinstaller
pyinstaller --onefile --windowed --name 3DSHelpViewer help_viewer.py
```

### Linux

#### 编译为可执行文件

```bash
pip install pyqt5 pyinstaller
python3 build_for_windows.py
```

#### 编译为 DEB 包 (Ubuntu/Debian)

```bash
# 1. 安装依赖
sudo apt update
sudo apt install python3 python3-pip dpkg-dev
pip install PyQt5 pyinstaller

# 2. 使用 DEB 打包脚本
chmod +x build_for_ubuntu.sh
./build_for_ubuntu.sh

# 3. 安装 DEB 包
sudo dpkg -i dist/3dshelptool_1.0_amd64.deb

# 4. 卸载
sudo dpkg -r 3dshelptool
```

## 技术栈

- Python 3.10
- PyQt5 - GUI框架
- PyInstaller - 打包工具

## 许可证

MIT License