feat: Initialize wxauto WeChat automation project with job extraction tools
- Add wxauto package with WeChat UI automation and message handling capabilities - Implement job_extractor.py for automated job posting extraction from WeChat groups - Add job_extractor_gui.py providing graphical interface for job extraction tool - Create comprehensive documentation in Chinese covering GUI usage, multi-group support, and quick start guides - Add build configuration files (build_exe.py, build_exe.spec) for packaging as standalone executable - Include utility scripts for WeChat interaction (auto_send_msg.py, get_history.py, receive_file_transfer.py) - Add project configuration files (pyproject.toml, setup.cfg, requirements.txt) - Include test files (test_api.py, test_com_fix.py) for API and compatibility validation - Add Apache 2.0 LICENSE and comprehensive README documentation - Configure .gitignore to exclude build artifacts, logs, and temporary files
This commit is contained in:
198
快速开始.md
Normal file
198
快速开始.md
Normal file
@@ -0,0 +1,198 @@
|
||||
# 快速开始指南
|
||||
|
||||
## 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个）
|
||||
|
||||
---
|
||||
|
||||
开始使用吧！祝你提取顺利！🎉
|
||||
Reference in New Issue
Block a user