初始提交：识流 AI 助手项目

微信自动回复机器人，基于截图+OCR识别消息，支持关键词规则和 AI（OpenAI/DeepSeek/Dify）自动回复。
技术栈：PySide6 + Flask + Vue3 + RapidOCR + SQLite

注：OCR大模型文件（.onnx / .pdiparams）不纳入版本控制，需单独下载。

🤖 Generated with [Qoder][https://qoder.com]

legacy/README_BOT.md

@@ -0,0 +1,143 @@
+# 微信 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` - 旧版机器人日志（如果使用）
+
+---
+
+**祝使用愉快！🎊**