# 微信 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` - 旧版机器人日志（如果使用）

---

**祝使用愉快！🎊**