81115dc23d
微信自动回复机器人，基于截图+OCR识别消息，支持关键词规则和 AI（OpenAI/DeepSeek/Dify）自动回复。 技术栈：PySide6 + Flask + Vue3 + RapidOCR + SQLite 注：OCR大模型文件（.onnx / .pdiparams）不纳入版本控制，需单独下载。 🤖 Generated with [Qoder][https://qoder.com]
144 lines
3.5 KiB
Markdown
144 lines
3.5 KiB
Markdown
# 微信 AI 自动回复机器人 - 安装使用指南
|
||
|
||
## 📦 安装依赖
|
||
|
||
```bash
|
||
pip install wcferry requests
|
||
```
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 1. 启动 PHP 后端服务
|
||
确保 phpstudy 已启动，访问 http://127.0.0.1/shiliu_ai/admin.html 确认后端正常
|
||
|
||
### 2. 登录微信
|
||
在电脑上打开微信并登录（必须是 Windows 微信客户端）
|
||
|
||
### 3. 运行机器人
|
||
```bash
|
||
python wechat_bot.py
|
||
```
|
||
|
||
## ✨ 功能特性
|
||
|
||
### 新版本 (wechat_bot.py) - 推荐使用 ✅
|
||
- ✅ 基于 WeChatFerry 框架
|
||
- ✅ 无需 OCR，100% 准确识别消息
|
||
- ✅ 不需要固定窗口位置
|
||
- ✅ 自动回复私聊消息
|
||
- ✅ 可选开启群聊回复
|
||
- ✅ 支持 DeepSeek AI 智能回复
|
||
- ✅ 支持关键词规则匹配
|
||
- ✅ 所有消息记录到数据库
|
||
|
||
### 旧版本 (wechat_auto.py) - 已保留
|
||
- 基于 OCR 识别
|
||
- 需要固定窗口位置
|
||
- 识别准确率较低
|
||
- 仅供参考学习
|
||
|
||
### 手动测试版 (wechat_manual.py)
|
||
- 手动输入消息测试 AI 回复
|
||
- 用于调试和测试
|
||
|
||
## ⚙️ 配置说明
|
||
|
||
### 修改 wechat_bot.py 中的配置：
|
||
|
||
```python
|
||
# PHP 后端接口地址
|
||
BACKEND_URL = "http://127.0.0.1/shiliu_ai/api_receive_message.php"
|
||
|
||
# 是否自动回复群聊（默认只回复私聊）
|
||
ENABLE_GROUP_REPLY = False # 改为 True 可开启群聊回复
|
||
```
|
||
|
||
### 修改 config.php 配置 AI：
|
||
|
||
```php
|
||
// 选择 AI 提供商：mock / openai / deepseek
|
||
define('AI_PROVIDER', 'deepseek');
|
||
|
||
// DeepSeek API 配置
|
||
define('DEEPSEEK_API_KEY', '你的API密钥');
|
||
define('DEEPSEEK_API_BASE', 'https://api.deepseek.com');
|
||
define('DEEPSEEK_MODEL', 'deepseek-chat');
|
||
```
|
||
|
||
## 📝 使用流程
|
||
|
||
1. **接收消息** → 机器人自动监听微信消息
|
||
2. **规则匹配** → 先检查是否有关键词规则
|
||
3. **AI 回复** → 没有规则则调用 DeepSeek 生成回复
|
||
4. **自动发送** → 将回复发送给用户
|
||
5. **记录保存** → 所有消息保存到数据库
|
||
|
||
## 🎯 管理后台
|
||
|
||
访问 http://127.0.0.1/shiliu_ai/admin.html 可以：
|
||
- 查看消息记录
|
||
- 管理自动回复规则
|
||
- 配置系统设置
|
||
|
||
## 🔧 常见问题
|
||
|
||
### Q: 提示 "WeChatFerry 初始化失败"
|
||
**A:** 确保：
|
||
1. 微信已经登录
|
||
2. 已安装 wcferry: `pip install wcferry`
|
||
3. 使用的是 Windows 微信客户端
|
||
|
||
### Q: 机器人没有回复
|
||
**A:** 检查：
|
||
1. PHP 后端是否正常运行
|
||
2. 查看日志文件 `wechat_bot.log`
|
||
3. 确认 DeepSeek API Key 是否正确
|
||
|
||
### Q: 想要回复群聊消息
|
||
**A:** 修改 `wechat_bot.py` 中的配置：
|
||
```python
|
||
ENABLE_GROUP_REPLY = True
|
||
```
|
||
|
||
### Q: 如何添加关键词规则
|
||
**A:** 访问管理后台 admin.html，在"自动回复规则"中添加
|
||
|
||
## 📂 文件说明
|
||
|
||
```
|
||
shiliu_ai/
|
||
├── wechat_bot.py # 新版机器人（推荐使用）⭐
|
||
├── wechat_auto.py # 旧版 OCR 机器人（已保留）
|
||
├── wechat_manual.py # 手动测试工具
|
||
├── config.php # 配置文件
|
||
├── ai_helper.php # AI 调用逻辑
|
||
├── api_receive_message.php # 消息接收接口
|
||
├── admin.html # 管理后台
|
||
├── database.sql # 数据库结构
|
||
└── wechat_bot.log # 运行日志
|
||
```
|
||
|
||
## 🎉 开始使用
|
||
|
||
```bash
|
||
# 1. 安装依赖
|
||
pip install wcferry requests
|
||
|
||
# 2. 确保微信已登录
|
||
|
||
# 3. 启动机器人
|
||
python wechat_bot.py
|
||
|
||
# 4. 发送消息测试
|
||
```
|
||
|
||
## 📞 技术支持
|
||
|
||
如有问题，请查看日志文件：
|
||
- `wechat_bot.log` - 机器人运行日志
|
||
- `wechat_auto.log` - 旧版机器人日志（如果使用）
|
||
|
||
---
|
||
|
||
**祝使用愉快！🎊**
|