📋 项目概述

 

一个功能完整的闲鱼自动回复和管理系统，采用现代化的技术架构，支持多用户、多账号管理，具备智能回复、自动发货、自动确认发货、商品管理等企业级功能。系统基于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镜像，无需编译即可快速部署

📁 项目结构

 

点击展开查看详细项目结构 
xianyu-auto-reply/
├── 📄 核心文件
│   ├── Start.py                    # 项目启动入口，初始化所有服务
│   ├── XianyuAutoAsync.py         # 闲鱼WebSocket连接和消息处理核心
│   ├── reply_server.py            # FastAPI Web服务器和完整API接口
│   ├── db_manager.py              # SQLite数据库管理，支持多用户数据隔离
│   ├── cookie_manager.py          # 多账号Cookie管理和任务调度
│   ├── ai_reply_engine.py         # AI智能回复引擎，支持多种AI模型
│   ├── order_status_handler.py    # 订单状态处理和更新模块
│   ├── file_log_collector.py      # 实时日志收集和管理系统
│   ├── config.py                  # 全局配置文件管理器
│   ├── usage_statistics.py        # 用户统计和数据分析模块
│   ├── simple_stats_server.py     # 简单统计服务器（可选）
│   ├── secure_confirm_ultra.py    # 自动确认发货模块（多层加密保护）
│   ├── secure_confirm_decrypted.py # 自动确认发货模块（解密版本）
│   ├── secure_freeshipping_ultra.py # 自动免拼发货模块（多层加密保护）
│   └── secure_freeshipping_decrypted.py # 自动免拼发货模块（解密版本）
├── 🛠️ 工具模块
│   └── utils/
│       ├── xianyu_utils.py        # 闲鱼API工具函数（加密、签名、解析）
│       ├── message_utils.py       # 消息格式化和处理工具
│       ├── ws_utils.py            # WebSocket客户端封装
│       ├── image_utils.py         # 图片处理和管理工具
│       ├── image_uploader.py      # 图片上传到闲鱼CDN
│       ├── image_utils.py         # 图片处理工具（压缩、格式转换）
│       ├── item_search.py         # 商品搜索功能（基于Playwright，无头模式）
│       ├── order_detail_fetcher.py # 订单详情获取工具
│       └── qr_login.py            # 二维码登录功能
├── 🌐 前端界面
│   └── static/
│       ├── index.html             # 主管理界面（集成所有功能模块）
│       ├── login.html             # 用户登录页面
│       ├── register.html          # 用户注册页面（邮箱验证）
│       ├── js/
│       │   └── app.js             # 主要JavaScript逻辑和所有功能模块
│       ├── css/
│       │   ├── variables.css      # CSS变量定义
│       │   ├── layout.css         # 布局样式
│       │   ├── components.css     # 组件样式
│       │   ├── accounts.css       # 账号管理样式
│       │   ├── keywords.css       # 关键词管理样式
│       │   ├── items.css          # 商品管理样式
│       │   ├── logs.css           # 日志管理样式
│       │   ├── notifications.css  # 通知样式
│       │   ├── dashboard.css      # 仪表板样式
│       │   ├── admin.css          # 管理员样式
│       │   └── app.css            # 主应用样式
│       ├── lib/
│       │   ├── bootstrap/         # Bootstrap框架
│       │   └── bootstrap-icons/   # Bootstrap图标
│       ├── uploads/
│       │   └── images/            # 上传的图片文件
│       ├── xianyu_js_version_2.js # 闲鱼JavaScript工具库
│       ├── wechat-group.png       # 微信群二维码
│       └── qq-group.png           # QQ群二维码
├── 🐳 Docker部署
│   ├── Dockerfile                 # Docker镜像构建文件（优化版）
│   ├── Dockerfile-cn             # 国内优化版Docker镜像构建文件
│   ├── docker-compose.yml        # Docker Compose一键部署配置
│   ├── docker-compose-cn.yml     # 国内优化版Docker Compose配置
│   ├── docker-deploy.sh          # Docker部署管理脚本（Linux/macOS）
│   ├── docker-deploy.bat         # Docker部署管理脚本（Windows）
│   ├── entrypoint.sh              # Docker容器启动脚本
│   └── .dockerignore             # Docker构建忽略文件
├── 🌐 Nginx配置
│   └── nginx/
│       ├── nginx.conf            # Nginx反向代理配置
│       └── ssl/                  # SSL证书目录
├── 📋 配置文件
│   ├── global_config.yml         # 全局配置文件（WebSocket、API等）
│   ├── requirements.txt          # Python依赖包列表（精简版，无内置模块）
│   ├── .gitignore                # Git忽略文件配置（完整版）
│   └── README.md                 # 项目说明文档（本文件）
└── 📊 数据目录（运行时创建）
    ├── data/                     # 数据目录（Docker挂载，自动创建）
    │   ├── xianyu_data.db        # SQLite主数据库文件
    │   ├── user_stats.db         # 用户统计数据库
    │   └── xianyu_data_backup_*.db # 数据库备份文件
    ├── logs/                     # 按日期分割的日志文件
    └── backups/                  # 其他备份文件

📋程序截图

 

声明：本站所有文章，如无特殊说明或标注，均为本站原创发布。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。