05R闲鱼自动回复与管理系统

项目概述

05R闲鱼自动回复与管理系统是一个功能完备的本地化解决方案，专为多用户、多账号场景设计，支持智能回复、自动发货、商品管理和实时监控等企业级功能。系统采用现代化技术架构，结合异步编程、容器化部署和数据隔离，确保高性能、安全性和易用性。

⚠️ 重要提示：本项目仅限学习研究，严禁用于商业用途，请仔细阅读版权声明。

核心特性

🔐 多用户系统

• 用户注册与登录：支持邮箱验证码注册，图形验证码防止暴力破解。
• 数据隔离：每个用户数据完全独立，互不干扰。
• 权限管理：基于JWT的严格权限控制，区分管理员与普通用户。
• 安全保护：防暴力破解、会话管理、操作日志记录。

📱 多账号管理

• 无限账号支持：用户可管理多个闲鱼账号，独立运行互不影响。
• 实时状态监控：账号连接状态实时更新，支持批量操作。
• 任务管理：支持批量启动、停止账号任务，提升管理效率。

🤖 智能回复系统

• 关键词匹配：支持精确和模糊匹配，灵活配置回复规则。
• 优先级策略：指定商品回复 > 商品专用关键词 > 通用关键词 > 默认回复 > AI回复。
• AI智能回复：集成OpenAI、通义千问等模型，支持上下文理解。
• 动态变量：回复支持用户名、商品ID等动态变量替换。
• 批量管理：支持Excel格式关键词导入导出。

🚚 自动发货功能

• 智能匹配：根据商品信息和规格自动匹配发货规则。
• 多规格支持：支持不同规格卡券自动匹配，带兜底机制。
• 延时发货：可设置0-3600秒延时，灵活控制。
• 多种触发：支持付款消息、小刀消息等多种触发条件。
• 防重复机制：避免重复发货和确认，提升可靠性。
• 图片发货：支持图片自动上传CDN并发送给买家。
• 自动确认发货：检测付款后自动调用闲鱼API确认，支持锁机制防并发。

🛍️ 商品管理

• 自动收集：消息触发时自动获取商品信息。
• API获取：通过闲鱼API获取完整商品详情。
• 多规格管理：支持多规格商品的编辑和切换。
• 智能去重：自动去除重复商品数据。

🔍 商品搜索

• 真实数据：基于Playwright获取真实闲鱼商品数据。
• 智能排序：按“人想要”数量倒序排列，优先展示热门商品。
• 多页支持：支持多页搜索和前端分页显示。

📊 系统监控

• 实时日志：支持Web界面查看、搜索和下载日志。
• 性能监控：监控系统资源使用情况。
• 健康检查：实时检查服务状态，确保稳定运行。

📁 数据管理

• Excel导入导出：支持关键词和卡券数据批量操作。
• 模板生成：自动生成带示例数据的导入模板。
• 数据验证：导入时自动检查数据格式和重复性。
• 自动备份：定期备份数据，防止丢失。

技术架构

• 后端框架：FastAPI + Python 3.11+ 异步编程，性能卓越。
• 数据库：SQLite 3，支持多用户数据隔离和自动迁移。
• 前端：Bootstrap 5 + Vanilla JavaScript，响应式设计。
• 通信协议：WebSocket + RESTful API，实时高效。
• 部署方式：Docker + Docker Compose，支持一键部署。
• 日志系统：Loguru，支持文件轮转和实时收集。
• 安全认证：JWT、图形验证码、邮箱验证、权限控制。

系统架构特点

• 微服务设计：模块化架构，易于维护和扩展。
• 异步处理：基于asyncio的高性能消息处理。
• 数据隔离：确保用户数据安全独立。
• 容器化部署：Docker一键部署，简化运维。
• 实时监控：WebSocket实时通信，动态更新状态。

快速开始

方式一：Docker一键部署（推荐）

1. 创建数据目录：

   mkdir -p xianyu-auto-reply
   

2. 启动容器：

   docker run -d -p 8080:8080 -v $PWD/xianyu-auto-reply/:/app/data/ --name xianyu-auto-reply registry.cn-shanghai.aliyuncs.com/zhinian-software/xianyu-auto-reply:1.0.2
   

3. 访问系统：http://localhost:8080

方式二：源码构建部署

1. 克隆项目：

   git clone https://github.com/zhinianboke/xianyu-auto-reply.git
   cd xianyu-auto-reply
   

2. 执行部署脚本：

   chmod +x docker-deploy.sh
   ./docker-deploy.sh
   

3. 访问系统：http://localhost:8080

方式三：本地开发部署

1. 克隆项目并创建虚拟环境：

   git clone https://github.com/zhinianboke/xianyu-auto-reply.git
   cd xianyu-auto-reply
   python -m venv venv
   source venv/bin/activate
   

2. 安装依赖：

   pip install -r requirements.txt
   playwright install chromium
   

3. 启动系统：

   python Start.py
   

4. 访问系统：http://localhost:8080

默认管理员账号

• 用户名：admin
• 密码：admin123
  ⚠️ 安全提示：首次登录后请立即修改默认密码！

系统使用

1. 用户注册：访问http://localhost:8080/register.html，完成邮箱和图形验证码验证。
2. 添加闲鱼账号：登录后点击“添加新账号”，输入账号ID和Cookie，系统自动启动监控。
3. 配置自动回复：设置关键词、AI回复或默认回复，支持动态变量和优先级策略。
4. 设置自动发货：添加发货规则，上传卡密或文本，支持多规格和延时发货。
5. 商品搜索：输入关键词，获取真实闲鱼商品数据，支持分页和排序。

环境要求

• Python：3.11+
• Node.js：16+（用于JavaScript执行）
• 系统：Windows/Linux/macOS
• 内存：建议2GB+
• 存储：建议10GB+
• Docker：20.10+（Docker部署）
• Docker Compose：2.0+

安全特性

• 加密存储：Cookie和敏感数据多层加密。
• Token刷新：自动检测和刷新过期Token。
• 操作日志：记录所有用户操作，支持审计。
• 防重复机制：避免重复发货和确认。
• 会话管理：安全的超时和登出机制。

项目结构

• Start.py：项目启动入口，初始化服务。
• XianyuAutoAsync.py：核心WebSocket消息处理。
• reply_server.py：FastAPI服务器，提供API和界面。
• cookie_manager.py：多账号任务管理。
• db_manager.py：SQLite数据库管理。
• ai_reply_engine.py：AI智能回复引擎。
• static/：前端界面，包含HTML、CSS、JavaScript。
• Dockerfile：Docker镜像构建文件。
• global_config.yml：全局配置文件。

贡献指南

欢迎为05R项目贡献代码或建议：

• 提交问题：在GitHub Issues报告Bug或提出新功能。
• 代码贡献：Fork项目，创建分支，提交Pull Request。

常见问题

1. 端口占用：修改global_config.yml中的AUTO_REPLY.api.port或通过环境变量WEB_PORT指定。
2. 数据库连接失败：检查数据库文件权限。
3. WebSocket连接失败：确保防火墙允许WebSocket端口。
4. Docker启动失败：使用docker-compose build --no-cache重新构建。