mirror of
https://github.com/zhinianboke/xianyu-auto-reply.git
synced 2025-08-02 12:37:35 +08:00
4.7 KiB
4.7 KiB
闲鱼自动回复管理系统 - 使用说明
🎉 系统功能概述
本系统已完全实现您要求的所有功能：
✅ 已实现功能
- 多Cookies支持 - 支持同时管理多个闲鱼账号
- 美观前端界面 - 响应式设计，支持Cookies和关键词的CRUD操作
- SQLite数据库存储 - 持久化存储Cookies和关键词数据
- 关键词管理 - 每个账号独立的关键词回复设置
- API接口 - 完整实现
/xianyu/reply接口 - 智能回复 - 根据Cookie ID匹配对应关键词进行回复
- 用户认证 - 安全的登录认证系统
🚀 快速开始
1. 安装依赖
pip install -r requirements.txt
2. 启动系统
python Start.py
3. 访问系统
- 打开浏览器访问：
http://localhost:8080 - 默认登录账号：
- 用户名：
admin - 密码：
admin123
- 用户名：
📋 系统使用流程
步骤1：登录系统
- 访问
http://localhost:8080 - 输入用户名和密码登录
- 成功登录后进入管理界面
步骤2：添加闲鱼账号
- 在"添加新账号"区域填写：
- 账号ID：唯一标识（如：account1, 主账号等）
- Cookie值：完整的闲鱼Cookie字符串
- 点击"添加账号"按钮
步骤3：设置关键词回复
- 在账号列表中点击"关键词"按钮
- 添加关键词和对应的回复内容
- 支持变量替换：
{send_user_name}- 发送者昵称{send_user_id}- 发送者ID{send_message}- 发送的消息内容
- 点击"保存更改"
步骤4：系统自动运行
- 系统会自动监控闲鱼消息
- 根据关键词匹配自动回复
- 所有操作都有详细日志记录
🔧 功能详解
多账号管理
- 添加账号：支持添加无限数量的闲鱼账号
- 修改Cookie：可以随时更新账号的Cookie值
- 删除账号：删除不需要的账号及其关键词
- 独立运行：每个账号独立运行，互不干扰
关键词回复系统
- 精确匹配：支持关键词精确匹配
- 变量替换：回复内容支持动态变量
- 优先级：账号级关键词优先于全局关键词
- 默认回复：未匹配关键词时使用默认回复
API接口
- 接口地址：
POST http://localhost:8080/xianyu/reply - 功能：根据cookie_id和消息内容返回回复内容
- 自动调用：系统收到消息时自动调用此接口
📊 系统架构
用户界面 (Web) ←→ FastAPI服务器 ←→ SQLite数据库
↓
CookieManager
↓
XianyuLive (多实例)
↓
闲鱼WebSocket连接
🔐 安全说明
登录认证
- 所有管理功能都需要登录认证
- Session token有效期24小时
- 自动登录状态检查
数据安全
- Cookie数据加密存储在SQLite数据库
- 界面上不显示完整Cookie值
- 支持安全的Cookie更新机制
📝 日志系统
日志文件位置
- 日志目录：
logs/ - 文件格式：
xianyu_YYYY-MM-DD.log - 自动轮转：每天一个文件，保留7天
日志内容
- 系统启动和关闭
- 账号添加、修改、删除
- 消息接收和发送
- 错误和异常信息
🛠️ 故障排除
常见问题
1. Cookie过期
现象：日志显示"Session过期" 解决：在Web界面更新对应账号的Cookie值
2. 无法连接闲鱼
现象：WebSocket连接失败 解决：检查网络连接和Cookie是否有效
3. 关键词不匹配
现象：收到消息但没有自动回复 解决：检查关键词设置，确保关键词包含在消息中
4. 登录失败
现象：无法登录管理界面 解决：确认用户名密码正确（admin/admin123）
系统要求
- Python 3.7+
- Windows/Linux/macOS
- 网络连接
- 有效的闲鱼账号Cookie
🔄 更新和维护
配置文件
- 主配置：
global_config.yml - 数据库：
xianyu_data.db - 静态文件：
static/目录
备份建议
- 定期备份
xianyu_data.db文件 - 备份
global_config.yml配置文件 - 备份自定义的关键词文件
📞 技术支持
测试系统
运行测试脚本检查系统状态：
python test_system.py
重新创建配置
如果配置文件损坏，运行：
python create_config.py
🎯 使用建议
- Cookie获取：使用浏览器开发者工具获取完整Cookie
- 关键词设置：设置常用的咨询关键词和回复
- 定期检查：定期查看日志确保系统正常运行
- 备份数据：重要数据请及时备份
注意：本系统仅供学习交流使用，请遵守相关法律法规和平台规则。