【程序源代码】闲鱼自动发货系统完整源码,拿来即用

1.1 项目概述

闲鱼超级管家（Xianyu Super Butler） 是一款现代化的闲鱼自动回复与管理平台，采用商务专业风格的 UI 设计，致力于让闲鱼店铺管理更加高效便捷。

该项目基于开源项目 xianyu-auto-reply 进行二次开发，在保留核心功能的基础上，对用户界面、性能优化、功能扩展等方面进行了全面升级。

1.2 项目特点

• ‎全自动化运营：支持自动回复、自动发货、自动议价等全流程自动化
• ‎多账号管理：支持多个闲鱼账号同时管理，统一后台操作
• ‎高成功率验证：滑块验证成功率达 99%，基本解决验证失败问题
• ‎性能优化：浏览器实例池、并发处理、智能缓存等多重优化
• ‎Docker 部署：支持 Docker 一键部署，环境隔离，便于运维

1.3 适用场景

• 闲鱼电商卖家自动化运营
• 虚拟商品自动发货（卡券、兑换码等）
• 多店铺统一管理
• 客服消息自动回复与智能议价

二、项目结构目录

JP6-闲鱼自动发货系统/├── frontend/                    # 前端项目（当前使用版本）│   ├── components/              # React 组件│   │   ├── AccountList.tsx      # 账号列表组件│   │   ├── CardList.tsx         # 卡券列表组件│   │   ├── Dashboard.tsx        # 仪表盘组件│   │   ├── ItemList.tsx         # 商品列表组件│   │   ├── Keywords.tsx         # 关键词管理组件│   │   ├── OrderList.tsx        # 订单列表组件│   │   ├── Rules.tsx            # 规则配置组件│   │   ├── Settings.tsx         # 设置组件│   │   ├── Sidebar.tsx          # 侧边栏组件│   │   └── TestPage.tsx         # 测试页面│   ├── services/                # API 服务层│   │   └── api.ts               # API 接口封装│   ├── public/                  # 静态资源│   ├── App.tsx                  # 根组件│   ├── index.tsx                # 入口文件│   ├── types.ts                 # TypeScript 类型定义│   ├── package.json             # 前端依赖配置│   ├── vite.config.ts           # Vite 构建配置│   ├── tailwind.config.js       # Tailwind CSS 配置│   └── tsconfig.json            # TypeScript 配置│├── frontend_backup/             # 前端备份版本（更完整的旧版本）│   ├── src/│   │   ├── api/                 # API 模块（分模块管理）│   │   ├── components/          # 组件库│   │   │   ├── common/          # 通用组件│   │   │   ├── layout/          # 布局组件│   │   │   └── ui/              # UI 基础组件│   │   ├── pages/               # 页面组件│   │   │   ├── dashboard/       # 仪表盘│   │   │   ├── orders/          # 订单管理│   │   │   ├── accounts/        # 账号管理│   │   │   ├── items/           # 商品管理│   │   │   ├── keywords/        # 关键词管理│   │   │   ├── cards/           # 卡券管理│   │   │   ├── delivery/        # 发货管理│   │   │   ├── admin/           # 管理后台│   │   │   └── auth/            # 认证页面│   │   ├── store/               # 状态管理（Zustand）│   │   ├── styles/              # 全局样式│   │   ├── types/               # 类型定义│   │   └── utils/               # 工具函数│   └── package.json│├── utils/                       # 工具模块│   ├── geetest/                 # 极验验证模块│   │   ├── geetest_config.py    # 验证配置│   │   └── geetest_lib.py       # 验证库│   ├── browser_pool.py          # 浏览器实例池│   ├── captcha_remote_control.py # 验证码远程控制│   ├── image_uploader.py        # 图片上传工具│   ├── image_utils.py           # 图片处理工具│   ├── item_search.py           # 商品搜索│   ├── message_utils.py         # 消息处理工具│   ├── order_detail_fetcher.py  # 订单详情获取│   ├── order_fetcher_optimized.py # 优化版订单获取│   ├── qr_login.py              # 扫码登录│   ├── refresh_util.py          # 刷新工具│   ├── slider_patch.py          # 滑块验证补丁│   ├── ws_utils.py              # WebSocket 工具│   ├── xianyu_slider_stealth.py # 闲鱼滑块隐身│   └── xianyu_utils.py          # 闲鱼通用工具│├── static/                      # 前端构建输出目录│   ├── assets/                  # 构建后的静态资源│   ├── uploads/                 # 用户上传文件│   ├── index.html               # 入口 HTML│   └── xianyu_js_version_2.js   # 闲鱼 JS 版本文件│├── nginx/                       # Nginx 配置│   └── nginx.conf               # Nginx 配置文件│├── Start.py                     # 项目启动入口├── XianyuAutoAsync.py           # 闲鱼异步自动化核心├── reply_server.py              # FastAPI 后端服务├── config.py                    # 配置管理类├── db_manager.py                # 数据库管理├── cookie_manager.py            # Cookie 管理├── ai_reply_engine.py           # AI 回复引擎├── order_status_handler.py      # 订单状态处理器├── order_status_query_playwright.py # 订单状态查询（Playwright版）├── api_captcha_remote.py        # 验证码远程控制 API├── file_log_collector.py        # 文件日志收集器├── secure_confirm_decrypted.py  # 安全确认解密├── secure_confirm_ultra.py      # 安全确认增强版├── secure_freeshipping_decrypted.py # 包邮解密├── secure_freeshipping_ultra.py # 包邮增强版├── captcha_control.html         # 验证码控制页面│├── global_config.yml            # 全局配置文件├── requirements.txt             # Python 依赖列表│├── Dockerfile                   # Docker 构建文件├── Dockerfile-cn                # 国内版 Docker 构建文件├── docker-compose.yml           # Docker Compose 配置├── docker-compose-cn.yml        # 国内版 Docker Compose 配置├── .dockerignore                # Docker 忽略文件│├── .gitignore                   # Git 忽略配置├── .gitattributes               # Git 属性配置│├── README.md                    # 项目说明文档├── 说明.txt                     # 补充说明└── 404.html                     # 404 页面

三、项目主要技术框架

3.1 后端技术栈

3.2 前端技术栈

3.3 前端备份版附加技术

3.4 部署与运维

四、项目主要功能

4.1 智能回复系统

4.1.1 关键词匹配回复

• 支持自定义关键词与回复内容映射
• 支持多种分隔符格式（空格、制表符、冒号）
• 支持注释行与空行忽略
• 可按账号独立配置关键词规则

4.1.2 AI 智能议价

• 支持自定义折扣规则
• 集成 AI 大模型（兼容 OpenAI 协议）
• 智能理解买家议价意图
• 可配置 AI 模型、API 地址、超时时间等参数

4.1.3 默认回复配置

• 全局默认回复消息
• 支持变量替换（如买家昵称）
• 商品专属回复配置

4.2 自动发货系统

4.2.1 卡券管理

• 卡券批量导入（Excel 格式）
• 卡券库存管理
• 多规格商品支持
• 已使用/未使用状态追踪

4.2.2 发货规则配置

• 按商品配置发货规则
• 延时发货设置
• 发货消息模板自定义
• 支持多种发货方式

4.2.3 补发功能

• ‎仅修改发货状态：只调用闲鱼 API 标记已发货，不发卡券
• ‎完整发货：匹配发货规则 → 获取卡券 → 发送给买家 → 标记已发货
• 订单补发历史记录

4.3 订单管理

4.3.1 订单列表

• 订单列表查看与分页
• 多维度筛选（状态、时间、账号等）
• 订单搜索功能
• 批量刷新订单状态

4.3.2 订单详情

• 完整订单信息展示
• 收货人信息管理
• 订单状态实时更新
• 单条订单同步/删除操作

4.3.3 订单状态同步

• Playwright 实时获取订单状态
• 并发批量处理（支持 5 个订单并发）
• 智能刷新策略（稳定状态订单不重复刷新）
• 状态码完整映射（待发货、已发货、已完成、已取消等）

4.4 账号管理

4.4.1 多账号支持

• 多个闲鱼账号统一管理
• 账号启用/禁用开关
• 账号分组管理
• 独立配置各账号参数

4.4.2 登录方式

• ‎扫码登录：生成二维码，手机扫码登录
• ‎密码登录：账号密码登录（支持滑块验证）
• ‎Cookie 手动输入：直接粘贴 Cookie 登录

4.4.3 Cookie 管理

• Cookie 自动刷新
• Cookie 有效期检测
• Cookie 加密存储
• 多账号 Cookie 隔离

4.5 商品管理

• 商品列表同步
• 商品搜索功能
• 商品详情自动获取
• 商品专属回复配置

4.6 数据统计与分析

• 工作台数据概览
• 订单趋势图表
• 消息回复统计
• 发货成功率统计
• 多维度数据报表

4.7 系统管理

4.7.1 多用户权限

• 用户注册与登录
• 角色权限管理
• 邮箱验证
• 图形验证码

4.7.2 系统设置

• 全局参数配置
• 日志配置
• 通知设置
• 数据备份与恢复

4.8 验证码处理

• 滑块验证自动化（成功率 99%）
• 极验验证集成
• 验证码远程控制
• 浏览器隐身技术

五、项目安装和部署

5.1 环境要求

5.2 本地安装部署

步骤一：克隆项目

git clone https://github.com/23Star/xianyu-super-butler.gitcd xianyu-super-butler

步骤二：安装 Python 依赖

# 升级 pippip install --upgrade pip# 安装项目依赖pip install -r requirements.txt# 安装 Playwright 浏览器playwright install chromium# Linux 系统还需安装浏览器依赖# playwright install-deps chromium

步骤三：构建前端

# 进入前端目录cd frontend# 安装前端依赖npm install# 构建生产版本npm run build# 返回项目根目录cd ..

说明：npm run build 会将前端打包到 static/ 目录，后端启动后直接提供静态文件服务。

步骤四：启动服务

python Start.py

启动完成后，浏览器访问：http://localhost:8080

步骤五：默认登录信息

用户名: admin密码: admin123

⚠️ 安全提示：首次登录后请立即修改默认密码！

步骤六：首次使用配置

1. 登录系统后台
2. 添加闲鱼账号（扫码登录 / 密码登录 / Cookie 输入）
3. 配置自动回复关键词
4. 配置发货规则与卡券
5. 启用自动回复与自动发货功能

5.3 前端开发模式

如需修改前端代码（支持热更新）：

# 终端 1：启动后端服务python Start.py# 终端 2：启动前端开发服务器cd frontendnpm run dev# 访问 http://localhost:3000

5.4 Docker 部署

方式一：使用 Docker Compose（推荐）

# 克隆项目git clone https://github.com/23Star/xianyu-super-butler.gitcd xianyu-super-butler# 复制环境变量配置（可选）# cp .env.example .env# 编辑 .env 文件修改配置# 启动服务docker-compose up -d# 查看日志docker-compose logs -f

方式二：国内加速版 Docker Compose

# 使用国内镜像源配置docker-compose -f docker-compose-cn.yml up -d

方式三：手动构建 Docker 镜像

# 构建镜像docker build -t xianyu-auto-reply:latest .# 运行容器docker run -d \  --name xianyu-auto-reply \  -p 8080:8080 \  -v ./data:/app/data \  -v ./logs:/app/logs \  -v ./global_config.yml:/app/global_config.yml:ro \  -e TZ=Asia/Shanghai \  --restart unless-stopped \  xianyu-auto-reply:latest

Docker 环境变量配置

5.5 Nginx 反向代理（可选）

如需配置域名访问或 HTTPS，可使用项目提供的 Nginx 配置：

# 启动带 Nginx 的完整服务docker-compose --profile with-nginx up -d

配置文件位置：nginx/nginx.conf

5.6 配置文件说明

主要配置文件：global_config.yml

核心配置项

# 自动回复配置AUTO_REPLY:  enabled: true                    # 是否启用自动回复  default_message: "..."           # 默认回复消息  api:    enabled: false                 # 是否启用 API 回复    host: 0.0.0.0                  # 服务绑定地址    port: 8080                     # 服务端口# WebSocket 配置WEBSOCKET_URL: wss://wss-goofish.dingtalk.com/HEARTBEAT_INTERVAL: 15             # 心跳间隔（秒）HEARTBEAT_TIMEOUT: 30              # 心跳超时（秒）TOKEN_REFRESH_INTERVAL: 3600       # Token 刷新间隔（秒）# 滑块验证配置SLIDER_VERIFICATION:  max_concurrent: 3                # 最大并发数  wait_timeout: 60                 # 等待超时（秒）# 日志配置LOG_CONFIG:  level: INFO                      # 日志级别  rotation: 1 day                  # 日志轮转周期  retention: 7 days                # 日志保留时间

5.7 常见问题排查

1. Playwright 浏览器安装失败

# 手动安装浏览器playwright install chromium# Linux 安装依赖playwright install-deps chromium

2. 前端页面白屏

• 检查 ‎static/index.html 是否存在
• 重新执行 ‎npm run build
• 检查浏览器控制台是否有资源加载错误

3. 滑块验证失败

• 确保系统已安装 Chrome/Chromium 浏览器
• 检查网络连接是否正常
• 查看日志中的详细错误信息

4. Docker 启动后无法访问

• 检查端口映射是否正确
• 查看容器日志：‎docker logs xianyu-auto-reply
• 确认防火墙已开放相应端口