闲鱼自动回复系统：智能化管理你的闲鱼店铺

闲鱼作为国内领先的二手交易平台，为卖家提供了便捷的交易环境。然而，繁忙的卖家往往面临消息回复不及时、订单管理复杂等问题。xianyu-auto-reply 是一个基于 Python 和 FastAPI 开发的开源自动化客服系统，专为闲鱼平台设计，能够通过 WebSocket 实时连接闲鱼服务器，实现消息自动回复、自动发货和商品管理等功能。本文将详细介绍该项目的功能、架构、部署方式以及适用场景，帮助你快速上手并高效管理闲鱼店铺。

项目概述

xianyu-auto-reply 是一个专为闲鱼卖家打造的自动化管理工具，托管于 GitHub（项目地址）。它通过 WebSocket 技术实时接收和处理买家消息，支持多用户和多账号管理，提供关键词匹配、AI 智能回复、自动发货等功能。项目完全开源，仅限学习和研究，严禁用于商业用途。

核心功能

1. 实时消息处理：通过 WebSocket 连接闲鱼服务器，实时接收买家消息并自动回复。
2. 多用户与多账号支持：
   • 支持用户注册登录，数据隔离，权限管理（基于 JWT 认证）。
   • 管理多个闲鱼账号，独立监控消息和商品，简化多账号运营。
3. 智能回复：
   • 支持关键词匹配回复，例如“价格”触发“商品价格为 XX 元”。
   • 集成 AI 智能回复引擎，支持 OpenAI、通义千问等多种模型，提供上下文感知和个性化回复。
   • 优先级：特定商品关键词 > 通用关键词 > AI 回复。
4. 自动发货：
   • 根据商品信息匹配规则，自动发送卡券或文本。
   • 支持延迟发货（0-3600 秒），自动检测支付消息并匹配发货规则。
5. 商品管理：
   • 自动收集商品信息，支持多规格管理和批量编辑。
   • 通过 Playwright 实现商品搜索，基于“人气”排序获取实时数据。
6. 系统监控与数据管理：
   • 提供实时日志收集、性能监控和服务健康检查。
   • 支持 Excel 格式关键词导入导出，自动备份数据。

项目架构

项目采用模块化设计，核心文件和工具模块清晰分离，确保代码可维护性和扩展性。以下是主要文件和功能模块的概览：

• 核心文件：

  • Start.py：项目启动入口，初始化所有服务。
  • XianyuAutoAsync.py：WebSocket 连接核心，处理消息收发和自动回复。
  • reply_server.py：FastAPI Web 服务器，提供管理界面和 RESTful API。
  • db_manager.py：SQLite 数据库管理，支持多用户数据隔离和 CRUD 操作。
  • cookie_manager.py：多账号 Cookie 管理，负责任务调度和状态管理。
  • ai_reply_engine.py：AI 智能回复引擎，支持多种 AI 模型。
  • config.py：全局配置文件管理器，加载 YAML 配置和环境变量。
  • secure_confirm_ultra.py：自动确认发货模块，采用多层加密保护。
  • secure_freeshipping_ultra.py：自动免拼发货模块，同样采用多层加密。

• 工具模块（位于 utils/ 目录）：

  • xianyu_utils.py：闲鱼 API 工具函数（加密、签名、解析）。
  • message_utils.py：消息格式化和处理工具。
  • ws_utils.py：WebSocket 客户端封装。
  • qr_login.py：二维码登录功能。
  • item_search.py：商品搜索功能（基于 Playwright）。
  • image_utils.py：图片处理工具（压缩、格式转换）。
  • image_uploader.py：图片上传到 CDN 工具。

• 前端界面（位于 static/ 目录）：

  • index.html：主管理界面，用于账号管理和系统监控。
  • login.html：用户登录页面。
  • register.html：用户注册页面，支持邮箱验证。
  • user_management.html：用户管理页面，供管理员使用。
  • data_management.html：数据管理页面，支持导入导出。

部署方式

xianyu-auto-reply 提供了三种部署方式：Docker 一键部署、Docker Compose 部署和本地部署。以下是详细步骤：

1. Docker 一键部署

# 创建数据目录
mkdir xianyu-auto-reply

# 启动容器
docker run -d -p 8080:8080 -v $PWD/xianyu-auto-reply/:/app/data/ --name xianyu-auto-reply --privileged=true registry.cn-shanghai.aliyuncs.com/zhinian-software/xianyu-auto-reply:1.0

# 访问系统
# 打开浏览器，访问 http://localhost:8080

故障排除：

• 若遇到端口冲突，修改 8080 为其他端口。
• 确保 Docker Desktop 已运行，Linux 系统可能需要 sudo。

2. Docker Compose 部署

# 克隆项目
git clone https://github.com/zhinianboke/xianyu-auto-reply.git
cd xianyu-auto-reply

# 运行部署脚本
./docker-deploy.sh

# 或者使用 Docker Compose
docker-compose up -d --build

# 访问系统
# 打开浏览器，访问 http://localhost:8080

故障排除：参考 DOCKER_FIX.md，检查 docker-compose.yml 端口配置。

3. 本地部署

# 克隆项目
git clone https://github.com/zhinianboke/xianyu-auto-reply.git
cd xianyu-auto-reply

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Linux/macOS
# 或 venv\Scripts\activate  # Windows

# 安装依赖
pip install -r requirements.txt

# 启动项目
python Start.py

# 访问系统
# 打开浏览器，访问 http://localhost:8080

使用场景

xianyu-auto-reply 适用于以下场景：

• 个人闲鱼卖家：通过自动回复和发货功能，快速响应买家咨询，提升成交率。
• 多账号运营者：统一管理多个闲鱼账号，简化操作流程。
• 夜间客服需求：支持 24 小时自动回复，适合无法手动回复的卖家。
• 批量商品管理：高效处理多规格商品的订单和信息管理。
• 数据分析需求：通过商品搜索和日志统计功能，分析市场需求和销售情况。

配置与使用

1. 关键词回复：

   • 下载系统提供的 Excel 模板，填写关键词和回复内容，上传至“数据管理”页面。
   • 示例：关键词“价格”，回复“商品价格为 XX 元”。

2. AI 智能回复：

   • 在“设置”页面输入 OpenAI API 密钥，选择模型（如 GPT-3.5）。
   • 配置提示词，支持动态变量（如用户名）生成个性化回复。

3. 自动发货：

   • 在“发货管理”页面添加发货规则，设置商品关键词和发货内容（文本或卡券）。
   • 配置延迟发货时间（0-3600 秒），系统会自动匹配规则并发货。

注意事项

• 开源协议：项目仅限学习和研究，严禁商业用途。
• 安全保护：系统采用多层加密保护自动确认发货和免拼发货模块，确保数据安全。
• 依赖环境：确保安装了 Docker 或 Python 3.8+ 环境，依赖项在 requirements.txt 中列出。
• 故障排查：参考 DOCKER_FIX.md 或 GitHub Issues 页面获取帮助。