Files
ai-shiliu/legacy/README_BOT.md
figmar 81115dc23d 初始提交:识流 AI 助手项目
微信自动回复机器人,基于截图+OCR识别消息,支持关键词规则和 AI(OpenAI/DeepSeek/Dify)自动回复。
技术栈:PySide6 + Flask + Vue3 + RapidOCR + SQLite

注:OCR大模型文件(.onnx / .pdiparams)不纳入版本控制,需单独下载。

🤖 Generated with [Qoder][https://qoder.com]
2026-05-30 15:09:40 +08:00

3.5 KiB
Raw Permalink Blame History

微信 AI 自动回复机器人 - 安装使用指南

📦 安装依赖

pip install wcferry requests

🚀 快速开始

1. 启动 PHP 后端服务

确保 phpstudy 已启动,访问 http://127.0.0.1/shiliu_ai/admin.html 确认后端正常

2. 登录微信

在电脑上打开微信并登录(必须是 Windows 微信客户端)

3. 运行机器人

python wechat_bot.py

功能特性

新版本 (wechat_bot.py) - 推荐使用

  • 基于 WeChatFerry 框架
  • 无需 OCR100% 准确识别消息
  • 不需要固定窗口位置
  • 自动回复私聊消息
  • 可选开启群聊回复
  • 支持 DeepSeek AI 智能回复
  • 支持关键词规则匹配
  • 所有消息记录到数据库

旧版本 (wechat_auto.py) - 已保留

  • 基于 OCR 识别
  • 需要固定窗口位置
  • 识别准确率较低
  • 仅供参考学习

手动测试版 (wechat_manual.py)

  • 手动输入消息测试 AI 回复
  • 用于调试和测试

⚙️ 配置说明

修改 wechat_bot.py 中的配置:

# PHP 后端接口地址
BACKEND_URL = "http://127.0.0.1/shiliu_ai/api_receive_message.php"

# 是否自动回复群聊(默认只回复私聊)
ENABLE_GROUP_REPLY = False  # 改为 True 可开启群聊回复

修改 config.php 配置 AI

// 选择 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 中的配置:

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         # 运行日志

🎉 开始使用

# 1. 安装依赖
pip install wcferry requests

# 2. 确保微信已登录

# 3. 启动机器人
python wechat_bot.py

# 4. 发送消息测试

📞 技术支持

如有问题,请查看日志文件:

  • wechat_bot.log - 机器人运行日志
  • wechat_auto.log - 旧版机器人日志(如果使用)

祝使用愉快!🎊