wechat_crawler/GUI版本使用说明.md

# 微信群岗位信息提取工具 - GUI版本使用说明

## 功能特点

- 图形化界面，操作简单直观
- 实时监听微信群消息
- 自动提取岗位结构化信息
- 岗位列表实时显示
- 支持查看岗位详情
- 数据自动保存和导出

## 打包成EXE

### 方法一：使用批处理脚本（推荐）

1. 确保已安装Python和依赖：
```bash
pip install -e .
pip install requests pyinstaller
```

2. 双击运行 `build.bat` 文件

3. 等待打包完成，生成的exe文件在 `dist` 目录

### 方法二：使用Python脚本

```bash
python build_exe.py
```

### 方法三：手动打包

```bash
pyinstaller build_exe.spec
```

## 使用步骤

### 1. 启动程序

- 双击 `微信岗位提取工具.exe` 启动程序
- 或者直接运行 `python job_extractor_gui.py`

### 2. 配置参数

在程序界面顶部配置区域：

- **目标群组**：输入要监听的微信群名称（必须完全匹配）
- **API密钥**：输入阿里云百炼API密钥
- 点击"保存配置"按钮保存设置

### 3. 开始任务

1. 确保微信已登录并打开主窗口
2. 点击"开始任务"按钮
3. 程序会自动连接微信并开始监听指定群组
4. 状态栏显示"运行中"表示监听成功

### 4. 查看岗位信息

- 提取到的岗位会实时显示在列表中
- 双击任意岗位可查看详细信息
- 包括：岗位名称、公司、地点、薪资、联系方式、原始消息等

### 5. 数据管理

- **停止任务**：停止监听微信群
- **清空列表**：清空所有岗位数据（会删除数据文件）
- **导出数据**：导出当前所有岗位数据为JSON文件

### 6. 运行日志

程序底部的日志区域会显示：
- 连接状态
- 消息接收情况
- 岗位提取结果
- 错误信息等

## 界面说明

```
┌─────────────────────────────────────────────┐
│ 配置区域                                     │
│ - 目标群组: [输入框]                         │
│ - API密钥:  [输入框]  [保存配置]            │
├─────────────────────────────────────────────┤
│ 控制按钮                                     │
│ [开始任务] [停止任务] [清空列表] [导出数据] │
├─────────────────────────────────────────────┤
│ 状态栏                                       │
│ 状态: 运行中  已提取岗位: 5                 │
├─────────────────────────────────────────────┤
│ 岗位列表（双击查看详情）                     │
│ ┌───────────────────────────────────────┐  │
│ │序号│岗位│公司│地点│薪资│联系│时间    │  │
│ │ 1  │...│...│...│...│...│...         │  │
│ │ 2  │...│...│...│...│...│...         │  │
│ └───────────────────────────────────────┘  │
├─────────────────────────────────────────────┤
│ 运行日志                                     │
│ [10:30:00] 正在连接微信...                  │
│ [10:30:01] ✓ 已连接微信                     │
│ [10:30:05] 收到消息 - 发送者: 张三          │
│ [10:30:06] ✓ 提取到岗位信息                 │
└─────────────────────────────────────────────┘
```

## 提取的信息字段

- 工作名称
- 工作描述
- 工作地点
- 月薪最低/最高
- 公司名称
- 联系人
- 联系方式

## 数据存储

- 配置文件：`config.json`
- 岗位数据：`jobs_data.json`
- 导出文件：`jobs_export_YYYYMMDD_HHMMSS.json`

## 注意事项

1. **微信版本**：必须使用微信 3.9.x 版本
2. **微信状态**：微信必须保持登录状态，主窗口可以最小化
3. **群名称**：目标群组名称必须完全匹配（区分大小写）
4. **API密钥**：请妥善保管，不要泄露
5. **网络连接**：需要网络连接以调用百炼API
6. **程序关闭**：关闭程序前建议先停止任务

## 常见问题

### Q: 提示"连接微信失败"
A: 请检查：
- 微信是否已登录
- 微信版本是否为 3.9.x
- 是否已安装wxauto依赖

### Q: 提示"添加监听失败"
A: 请检查：
- 群名称是否完全正确（区分大小写）
- 该群是否在微信的会话列表中
- 尝试先在微信中打开该群聊

### Q: API调用失败
A: 请检查：
- API密钥是否正确
- 网络连接是否正常
- API额度是否充足

### Q: 没有提取到岗位信息
A: 可能原因：
- 消息内容不包含招聘信息
- 消息格式不规范
- API识别失败（查看日志了解详情）

### Q: 打包后的exe无法运行
A: 请检查：
- 是否缺少依赖（尝试在有Python环境的电脑上运行）
- 杀毒软件是否拦截
- 尝试以管理员身份运行

## 技术支持

如遇到问题，请查看运行日志中的错误信息，或提供日志内容以便排查。

## 更新日志

### v1.0 (2026-02-11)
- 初始版本
- 支持微信群消息监听
- 支持岗位信息自动提取
- 图形化界面
- 数据导出功能