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` - 旧版机器人日志（如果使用）
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
**祝使用愉快！🎊**
|