闲鱼自动回复管理系统是一个基于 Python + FastAPI 开发的自动化客服系统,专为闲鱼平台设计系统通过 WebSocket 连接闲鱼服务器,实时接收和处理消息,提供智能化的自动回复服务。
一个功能完整的闲鱼自动回复和管理系统,采用现代化的技术架构,支持多用户、多账号管理,具备智能回复、自动发货、自动确认发货、商品管理等企业级功能。系统基于Python异步编程,使用FastAPI提供RESTful API,SQLite数据库存储,支持Docker一键部署。
技术架构
核心技术栈
- 后端框架: FastAPI + Python 3.11+ 异步编程
- 数据库: SQLite 3 + 多用户数据隔离 + 自动迁移
- 前端: Bootstrap 5 + Vanilla JavaScript + 响应式设计
- 通信协议: WebSocket + RESTful API + 实时通信
- 部署方式: Docker + Docker Compose + 一键部署
- 日志系统: Loguru + 文件轮转 + 实时收集
- 安全认证: JWT + 图形验证码 + 邮箱验证 + 权限控制
系统架构特点
- 微服务设计: 模块化架构,易于维护和扩展
- 异步处理: 基于asyncio的高性能异步处理
- 多用户隔离: 完全的数据隔离和权限控制
- 容器化部署: Docker容器化,支持一键部署
- 实时监控: WebSocket实时通信和状态监控
- 自动化运维: 自动重连、异常恢复、日志轮转
核心特性
多用户系统
- 用户注册登录 - 支持邮箱验证码注册,图形验证码保护
- 数据完全隔离 - 每个用户的数据独立存储,互不干扰
- 权限管理 - 严格的用户权限控制和JWT认证
- 安全保护 - 防暴力破解、会话管理、安全日志
- 授权期限管理 - 核心滑块验证模块包含授权期限验证,确保合规使用
多账号管理
- 无限账号支持 - 每个用户可管理多个闲鱼账号
- 独立运行 - 每个账号独立监控,互不影响
- 实时状态 - 账号连接状态实时监控
- 批量操作 - 支持批量启动、停止账号任务
智能回复系统
- 关键词匹配 - 支持精确关键词匹配回复
- 指定商品回复 - 支持为特定商品设置专门的回复内容,优先级最高
- 商品专用关键词 - 支持为特定商品设置专用关键词回复
- 通用关键词 - 支持全局通用关键词,适用于所有商品
- 批量导入导出 - 支持Excel格式的关键词批量导入导出
- AI智能回复 - 集成OpenAI API,支持上下文理解
- 变量替换 - 回复内容支持动态变量(用户名、商品信息、商品ID等)
- 优先级策略 - 指定商品回复 > 商品专用关键词 > 通用关键词 > 默认回复 > AI回复
自动发货功能
- 智能匹配 - 基于商品信息自动匹配发货规则
- 多规格支持 - 支持同一商品的不同规格自动匹配对应卡券
- 精确匹配+兜底机制 - 优先精确匹配规格,失败时自动降级到普通卡券
- 延时发货 - 支持设置发货延时时间(0-3600秒)
- 多种触发 - 支持付款消息、小刀消息等多种触发条件
- 防重复发货 - 智能防重复机制,避免重复发货
- 多种发货方式 - 支持固定文字、批量数据、API调用、图片发货等方式
- 图片发货 - 支持上传图片并自动发送给买家,图片自动上传到CDN
- 自动确认发货 - 检测到付款后自动调用闲鱼API确认发货,支持锁机制防并发
- 防重复确认 - 智能防重复确认机制,避免重复API调用
- 订单详情缓存 - 订单详情获取支持数据库缓存,大幅提升性能
- 发货统计 - 完整的发货记录和统计功能
商品管理
- 自动收集 - 消息触发时自动收集商品信息
- API获取 - 通过闲鱼API获取完整商品详情
- 多规格支持 - 支持多规格商品的规格信息管理
- 批量管理 - 支持批量查看、编辑、切换多规格状态
- 智能去重 - 自动去重,避免重复存储
商品搜索功能
- 真实数据获取 - 基于Playwright技术获取真实闲鱼商品数据
- 智能排序 - 按"人想要"数量自动倒序排列
- 多页搜索 - 支持一次性获取多页商品数据
- 前端分页 - 灵活的前端分页显示
- 商品详情 - 支持查看完整商品详情信息
系统监控
- 实时日志 - 完整的操作日志记录和查看
- 性能监控 - 系统资源使用情况监控
- 健康检查 - 服务状态健康检查
数据管理
- Excel导入导出 - 支持关键词数据的Excel格式导入导出
- 模板生成 - 自动生成包含示例数据的导入模板
- 批量操作 - 支持批量添加、更新关键词数据
- 数据验证 - 导入时自动验证数据格式和重复性
- 多规格卡券管理 - 支持创建和管理多规格卡券
- 发货规则管理 - 支持多规格发货规则的创建和管理
- 数据备份 - 自动数据备份和恢复
- 一键部署 - 提供预构建Docker镜像,无需编译即可快速部署
最新更新
2025年1月更新
性能与安全增强 - ✅ 新增 Nuitka 二进制编译支持,核心模块可编译为 .pyd/.so 提升性能和安全性
- ✅ 滑块验证模块增加授权期限验证机制,确保合规使用
- ✅ Docker 构建优化,自动编译二进制模块,提升容器启动效率
- ✅ 完善的错误处理和重试机制,提升系统稳定性
- ✅ 修复滑块验证模块内存泄漏问题,浏览器资源正确释放
数据管理优化 - ✅ 数据库文件统一迁移到 data/ 目录,更好的组织和管理
- ✅ 启动时自动检测并迁移旧数据库文件,无需手动操作
- ✅ 备份文件自动整理到数据目录,便于集中管理
- ✅ Docker挂载更简洁,一个data目录包含所有数据
配置文件优化 - ✅ 完善 .gitignore,新增编译产物、浏览器缓存等规则
- ✅ 完善 .dockerignore,优化Docker构建速度和镜像体积
- ✅ 增强 entrypoint.sh,添加环境验证和详细启动日志
- ✅ 清理测试文件和临时文件,保持代码库整洁
依赖管理 - ✅ requirements.txt 优化,移除Python内置模块,按功能分类
- ✅ 添加 Nuitka 编译工具链(可选)
- ✅ 详细的依赖说明和安装指南
Bug修复 - ✅ 修复浏览器资源泄漏问题,Docker容器RAM使用稳定
- ✅ 优化历史记录存储,减少90%磁盘和内存占用
- ✅ 添加析构函数确保资源释放
多架构支持 - ✅ Docker镜像支持AMD64和ARM64双架构
- ✅ GitHub Actions自动构建并推送到双镜像仓库
- ✅ 支持Oracle Cloud、AWS Graviton等ARM服务器
- ✅ Docker自动选择匹配的架构,无需手动指定
- ✅ 国内外双镜像源,确保下载速度
环境要求
- Python: 3.11+
- Node.js: 16+ (用于JavaScript执行)
- 系统: Windows/Linux/macOS
- 架构: x86_64 (amd64) / ARM64 (aarch64)
- 内存: 建议2GB+
- 存储: 建议10GB+
- Docker: 20.10+ (Docker部署)
- Docker Compose: 2.0+ (Docker部署)
多架构支持
支持的架构: - ✅ linux/amd64 - Intel/AMD处理器(传统服务器、PC、虚拟机)
- ✅ linux/arm64 - ARM64处理器(ARM服务器、树莓派4+、Apple M系列)
自动构建: 自动构建并推送多架构镜像到两个镜像仓库,Docker会自动选择匹配的架构 适用的ARM云服务器: - Oracle Cloud - Ampere A1 (永久免费4核24GB)
- AWS - Graviton2/3实例
- 阿里云 - 倚天710实例
- 腾讯云 - 星星海ARM实例
- 华为云 - 鲲鹏ARM实例

链接: https://pan.baidu.com/s/1diLmOrB4aktrUJ2xr9hQHg
提取码下载:
|