wechat_crawler/快速开始.md

快速开始指南

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

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

# 双击运行
启动工具.bat

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

或手动安装：

pip install -e .
pip install requests pywin32

第二步：配置API密钥

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

# 输入你的百炼API密钥

第三步：配置监听群组

编辑 config.json：

{
  "target_groups": [
    "你的招聘群1",
    "你的招聘群2"
  ],
  "api_key": "已配置的密钥"
}

第四步：运行程序

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

# 双击运行
启动工具.bat

# 选择 [1] 启动 GUI 版本

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

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

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

第五步：开始提取

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

界面操作

配置区域

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

控制按钮

• 开始任务：开始监听微信群
• 停止任务：停止监听
• 清空列表：清空所有岗位数据
• 导出数据：导出为JSON文件

岗位列表

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

运行日志

• 显示程序运行状态
• 消息接收情况
• 提取结果

常见场景

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

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

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

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

场景3：多群组监听

// 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 了解项目结构

获取帮助

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

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

提示

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

---

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