littlebalalafairy/xianyu-auto-reply
1
0
Fork 0
mirror of https://github.com/zhinianboke/xianyu-auto-reply.git synced 2025-08-02 12:37:35 +08:00
Code Issues Packages Projects Releases Wiki Activity
xianyu-auto-reply/使用说明.md
zhinianboke 9ec01047aa 完善项目结构
2025-07-24 14:16:18 +08:00

7.0 KiB
Raw Blame History

闲鱼自动回复管理系统 - 使用说明

🎉 系统功能概述

本系统已完全实现您要求的所有功能：

✅ 已实现功能

  1. 多Cookies支持 - 支持同时管理多个闲鱼账号
  2. 美观前端界面 - 响应式设计，支持Cookies和关键词的CRUD操作
  3. SQLite数据库存储 - 持久化存储Cookies和关键词数据
  4. 关键词管理 - 每个账号独立的关键词回复设置
  5. API接口 - 完整实现 /xianyu/reply 接口
  6. 智能回复 - 根据Cookie ID匹配对应关键词进行回复
  7. 用户认证 - 安全的登录认证系统

🚀 快速开始

1. 安装依赖

pip install -r requirements.txt

2. 启动系统

python Start.py

3. 访问系统

  • 打开浏览器访问：http://localhost:8080
  • 默认登录账号：
    • 用户名：admin
    • 密码：admin123

📋 系统使用流程

步骤1：登录系统

  1. 访问 http://localhost:8080
  2. 输入用户名和密码登录
  3. 成功登录后进入管理界面

步骤2：添加闲鱼账号

  1. 在"添加新账号"区域填写：
    • 账号ID：唯一标识（如：account1, 主账号等）
    • Cookie值：完整的闲鱼Cookie字符串
  2. 点击"添加账号"按钮

步骤3：设置关键词回复

  1. 在账号列表中点击"关键词"按钮
  2. 添加关键词和对应的回复内容
  3. 支持变量替换：
    • {send_user_name} - 发送者昵称
    • {send_user_id} - 发送者ID
    • {send_message} - 发送的消息内容
  4. 点击"保存更改"

步骤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 配置文件
  • 备份自定义的关键词文件

🔧 高级功能

AI回复配置

  1. 在账号列表中点击"🤖 配置AI回复"
  2. 开启AI回复功能
  3. 配置API密钥和模型参数
  4. 设置议价策略和优惠限制
  5. 自定义提示词（可选）

自动发货设置

  1. 进入"自动发货"页面
  2. 添加发货规则和关键词匹配
  3. 上传卡券文件或手动添加卡券
  4. 配置发货模板和通知方式

商品管理

  1. 进入"商品管理"页面
  2. 查看自动收集的商品信息
  3. 编辑商品详情和分类
  4. 批量获取账号下所有商品

日志监控

  1. 进入"日志管理"页面
  2. 实时查看系统运行日志
  3. 按级别和来源筛选日志
  4. 查看系统统计信息

📊 数据管理

数据备份

  1. 进入"系统设置"页面
  2. 点击"导出备份"按钮
  3. 下载备份文件到本地
  4. 定期备份重要数据

数据恢复

  1. 进入"系统设置"页面
  2. 点击"导入备份"按钮
  3. 选择备份文件上传
  4. 确认恢复操作

数据清理

  • 定期清理过期日志文件
  • 删除无效的商品信息
  • 清理过期的对话记录

📞 技术支持

系统健康检查

访问健康检查端点：

http://localhost:8080/health

查看系统状态

# 查看容器状态
docker-compose ps

# 查看系统资源使用
docker stats

# 查看实时日志
docker-compose logs -f

常见问题解决

问题1：Cookie失效

  • 重新获取Cookie并更新
  • 检查账号是否被限制
  • 确认Cookie格式正确

问题2：消息接收异常

  • 检查网络连接
  • 重启WebSocket连接
  • 查看错误日志

问题3：AI回复失败

  • 检查API密钥是否正确
  • 确认API服务可用
  • 检查账户余额

🎯 最佳实践

安全建议

  1. 定期更换密码：修改默认管理员密码
  2. 限制访问：仅允许信任的IP访问
  3. 备份数据：定期备份重要配置和数据
  4. 监控日志：定期查看系统日志

性能优化

  1. 合理设置：根据实际需求配置参数
  2. 定期清理：清理过期数据和日志
  3. 监控资源：关注系统资源使用情况
  4. 优化配置：根据使用情况调整配置

使用技巧

  1. Cookie获取：使用浏览器开发者工具获取完整Cookie
  2. 关键词设置：设置常用的咨询关键词和回复
  3. AI配置：根据商品类型调整AI提示词
  4. 发货规则：设置精确的商品匹配规则

🔄 系统更新

更新步骤

  1. 备份当前数据
  2. 停止系统服务
  3. 拉取最新代码
  4. 重新构建镜像
  5. 启动更新后的服务

Docker更新

# 停止服务
docker-compose down

# 拉取最新代码
git pull

# 重新构建
./deploy.sh --update

# 检查状态
docker-compose ps

注意：本系统仅供学习交流使用，请遵守相关法律法规和平台规则。使用前请仔细阅读相关文档，确保正确配置和使用。