wechat_crawler/快速开始.md

# 快速开始指南

## 5分钟上手微信群岗位提取工具

### 第一步：安装依赖（首次使用）

```bash
# 双击运行
启动工具.bat

# 选择 [6] 安装/更新依赖
```

或手动安装：
```bash
pip install -e .
pip install requests pywin32
```

### 第二步：配置API密钥

```bash
# 双击运行
配置API密钥.bat

# 输入你的百炼API密钥
```

### 第三步：配置监听群组

编辑 `config.json`：
```json
{
  "target_groups": [
    "你的招聘群1",
    "你的招聘群2"
  ],
  "api_key": "已配置的密钥"
}
```

### 第四步：运行程序

#### 方式A：直接运行（开发测试）

```bash
# 双击运行
启动工具.bat

# 选择 [1] 启动 GUI 版本
```

#### 方式B：打包成EXE（分发部署）

```bash
# 双击运行
修复并重新打包.bat

# 等待打包完成
# 运行 dist\微信岗位提取工具.exe
```

### 第五步：开始提取

1. 确保微信已登录
2. 在程序界面点击"开始任务"
3. 等待连接微信
4. 查看提取的岗位信息

## 界面操作

### 配置区域
- **目标群组**：输入要监听的群组，多个用逗号分隔
- **保存群组配置**：保存修改的群组列表

### 控制按钮
- **开始任务**：开始监听微信群
- **停止任务**：停止监听
- **清空列表**：清空所有岗位数据
- **导出数据**：导出为JSON文件

### 岗位列表
- 显示所有提取的岗位
- 双击查看详细信息
- 包含来源群组、岗位、公司、薪资等

### 运行日志
- 显示程序运行状态
- 消息接收情况
- 提取结果

## 常见场景

### 场景1：个人使用（测试）

```bash
1. 安装依赖
2. 配置API密钥
3. 编辑config.json添加群组
4. 运行：python job_extractor_gui.py
5. 点击"开始任务"
```

### 场景2：团队部署（打包）

```bash
1. 配置好config.json（包含API密钥和默认群组）
2. 运行：修复并重新打包.bat
3. 分发：dist\微信岗位提取工具.exe
4. 用户可在界面修改群组列表
```

### 场景3：多群组监听

```json
// config.json
{
  "target_groups": [
    "北京招聘群",
    "上海招聘群",
    "深圳招聘群",
    "Python开发群",
    "前端求职群"
  ]
}
```

## 验证清单

使用前请确认：

- [ ] Python 3.9+ 已安装
- [ ] 微信 3.9.x 已登录
- [ ] 依赖包已安装
- [ ] API密钥已配置
- [ ] 群组名称正确（完全匹配）
- [ ] 群组在微信会话列表中

## 故障排查

### 问题：连接微信失败
```
解决：
1. 确认微信已登录
2. 确认微信版本为3.9.x
3. 重启微信后再试
```

### 问题：添加监听失败
```
解决：
1. 检查群组名称是否正确
2. 确认群组在会话列表中
3. 尝试先在微信中打开该群
```

### 问题：API调用失败
```
解决：
1. 检查API密钥是否正确
2. 确认网络连接正常
3. 检查API额度是否充足
```

### 问题：打包后报COM错误
```
解决：
1. 运行：修复并重新打包.bat
2. 确保已安装pywin32
3. 查看：打包问题修复说明.md
```

## 下一步

- 查看 [多群组版本使用说明.md](多群组版本使用说明.md) 了解详细功能
- 查看 [打包问题修复说明.md](打包问题修复说明.md) 解决打包问题
- 查看 [项目说明.md](项目说明.md) 了解项目结构

## 获取帮助

遇到问题？查看这些文档：

1. **快速修复指南.txt** - 常见问题快速解决
2. **多群组版本使用说明.md** - 完整功能说明
3. **打包问题修复说明.md** - 打包相关问题
4. **GUI版本使用说明.md** - 界面操作说明

## 提示

- 💡 首次使用建议先测试单个群组
- 💡 群组名称必须完全匹配（区分大小写）
- 💡 API密钥打包后无法修改，需重新打包
- 💡 建议定期导出数据备份
- 💡 监听的群组不要太多（建议≤10个）

---

开始使用吧！祝你提取顺利！🎉