项目概述
一个功能完整的闲鱼自动回复和管理系统,采用现代化的技术架构,支持多用户、多账号管理,具备智能回复、自动发货、自动确认发货、商品管理等企业级功能。系统基于Python异步编程,使用FastAPI提供RESTful API,SQLite数据库存储,支持Docker一键部署。
项目地址:https://github.com/zhinianboke/xianyu-auto-reply
⚠️ 重要提示:本项目仅供学习研究使用,严禁商业用途!使用前请仔细阅读版权声明。
✨核心特性:
🔐 多用户系统
用户注册登录 - 支持邮箱验证码注册,图形验证码保护
数据完全隔离 - 每个用户的数据独立存储,互不干扰
权限管理 - 严格的用户权限控制和JWT认证
安全保护 - 防暴力破解、会话管理、安全日志
授权期限管理 - 核心滑块验证模块包含授权期限验证,确保合规使用
📱 多账号管理
无限账号支持 - 每个用户可管理多个闲鱼账号
独立运行 - 每个账号独立监控,互不影响
实时状态 - 账号连接状态实时监控
批量操作 - 支持批量启动、停止账号任务
🤖 智能回复系统
关键词匹配 - 支持精确关键词匹配回复
指定商品回复 - 支持为特定商品设置专门的回复内容,优先级最高
商品专用关键词 - 支持为特定商品设置专用关键词回复
通用关键词 - 支持全局通用关键词,适用于所有商品
批量导入导出 - 支持Excel格式的关键词批量导入导出
AI智能回复 - 集成OpenAI API,支持上下文理解
变量替换 - 回复内容支持动态变量(用户名、商品信息、商品ID等)
优先级策略 - 指定商品回复 > 商品专用关键词 > 通用关键词 > 默认回复 > AI回复
🚚 自动发货功能
智能匹配 - 基于商品信息自动匹配发货规则
多规格支持 - 支持同一商品的不同规格自动匹配对应卡券
精确匹配+兜底机制 - 优先精确匹配规格,失败时自动降级到普通卡券
延时发货 - 支持设置发货延时时间(0-3600秒)
多种触发 - 支持付款消息、小刀消息等多种触发条件
防重复发货 - 智能防重复机制,避免重复发货
多种发货方式 - 支持固定文字、批量数据、API调用、图片发货等方式
图片发货 - 支持上传图片并自动发送给买家,图片自动上传到CDN
自动确认发货 - 检测到付款后自动调用闲鱼API确认发货,支持锁机制防并发
防重复确认 - 智能防重复确认机制,避免重复API调用
订单详情缓存 - 订单详情获取支持数据库缓存,大幅提升性能
发货统计 - 完整的发货记录和统计功能
🛍️ 商品管理
自动收集 - 消息触发时自动收集商品信息
API获取 - 通过闲鱼API获取完整商品详情
多规格支持 - 支持多规格商品的规格信息管理
批量管理 - 支持批量查看、编辑、切换多规格状态
智能去重 - 自动去重,避免重复存储
🔍 商品搜索功能
真实数据获取 - 基于Playwright技术获取真实闲鱼商品数据
智能排序 - 按"人想要"数量自动倒序排列
多页搜索 - 支持一次性获取多页商品数据
前端分页 - 灵活的前端分页显示
商品详情 - 支持查看完整商品详情信息
📊 系统监控
实时日志 - 完整的操作日志记录和查看
性能监控 - 系统资源使用情况监控
健康检查 - 服务状态健康检查
📁 数据管理
Excel导入导出 - 支持关键词数据的Excel格式导入导出
模板生成 - 自动生成包含示例数据的导入模板
批量操作 - 支持批量添加、更新关键词数据
数据验证 - 导入时自动验证数据格式和重复性
多规格卡券管理 - 支持创建和管理多规格卡券
发货规则管理 - 支持多规格发货规则的创建和管理
数据备份 - 自动数据备份和恢复
一键部署 - 提供预构建Docker镜像,无需编译即可快速部署
部署
Docker Compose
services:
xianyu-auto-reply:
image: registry.cn-shanghai.aliyuncs.com/zhinian-software/xianyu-auto-reply:1.0
container_name: xianyu-auto-reply
privileged: true
ports:
- 8080:8080
volumes:
- /vol1/1000/docker/xianyu-auto-reply:/app/data
restart: always🌐 访问系统
浏览器中输入 http://NAS的IP:8080
默认管理员账号:
用户名:
admin密码:
admin123
📋 系统使用
1. 用户注册
访问
http://localhost:8080/register.html填写用户信息,完成邮箱验证
输入图形验证码完成注册
2. 添加闲鱼账号
登录系统后进入主界面
点击"添加新账号"
输入账号ID和完整的Cookie值
系统自动启动账号监控任务
3. 配置自动回复
关键词回复:设置关键词和对应回复内容
AI回复:配置OpenAI API密钥启用智能回复
默认回复:设置未匹配时的默认回复
4. 设置自动发货
添加发货规则,设置商品关键词和发货内容
支持文本内容和卡密文件两种发货方式
系统检测到付款消息时自动确认发货并自动发货
5. 使用商品搜索功能
访问商品搜索页面(需要登录)
输入搜索关键词和查询页数
系统自动获取真实闲鱼商品数据
商品按"人想要"数量自动排序
支持查看商品详情和跳转到闲鱼页面