一款基于FastAPI与React的闲鱼自动化工具，支持WebSocket实时监听、AI智能回复、虚拟商品自动发货、多账号并发管理，实现7×24小时无人值守运营，大幅提升卖家效率。
闲鱼超级管家自动发货与AI回复系统
📖 项目简介
闲鱼超级管家是一款基于 Python FastAPI 和 React 技术栈构建的企业级电商自动化管理工具。它专为闲鱼卖家设计，通过 WebSocket 实时通信与 Playwright 浏览器自动化技术，实现消息智能监听、AI 自动回复、虚拟商品自动发货及多账号批量管理。系统旨在解决卖家在响应速度、人力成本及夜间运营上的痛点，提供 7x24 小时的智能化服务。
⚠️ 安全提示：首次登录后请立即修改默认密码！本项目仅供学习研究使用，严禁用于非法商业用途。
🚀 核心功能亮点
🤖 智能客服系统
- 关键词匹配回复：支持精确关键词、正则表达式及语义相似度匹配。
- 🧠 AI 智能议价：集成大语言模型（如 OpenAI），支持上下文理解，可根据自定义折扣规则自动进行价格谈判。
- 📝 默认/专属回复：支持配置全局默认回复及特定商品专属回复话术，支持变量动态替换（如
{用户名}、{商品标题}）。 - 多级回复策略：优先级机制为：指定商品回复 > 商品专用关键词 > 通用关键词 > 默认回复 > AI 回复。
🚚 自动化发货系统
- 多规格支持：针对不同面值或规格的虚拟商品（如充值卡、网盘资料）独立配置发货规则。
- ⏰ 延时发货：支持设置 0-3600 秒的延时发货，有效规避平台风控检测。
- 🎫 卡券管理：支持 API 对接、固定文字发送及批量卡券数据导入，自动匹配并发送卡密或下载链接。
- 防重复机制：通过订单缓存和 API 锁机制，确保发货操作不重复执行。
📦 订单与账号管理
- 多账号并发：支持多闲鱼账号同时在线，采用异步 IO 和连接池技术，独立管理每个账号任务，互不干扰。
- 灵活登录：支持扫码登录、密码登录及手动输入 Cookie 多种方式。
- 订单全生命周期管理：
- 🔄 批量刷新：高并发处理订单状态更新。
- 🔍 详情查看：实时查看收货人信息及物流轨迹。
- ✅ 状态同步：单条订单同步与删除功能，带确认对话框，布局优化。
- 滑块验证优化：内置优化算法，基本解决滑块验证失败问题，登录成功率高达 99%。
📊 数据与运维
- 数据统计：提供可视化仪表盘，展示销售趋势、消息响应率等关键指标。
- Excel 导入导出：支持关键词规则、商品数据的批量导入与导出。
- 商品搜索：基于 Playwright 爬取闲鱼真实数据，支持按“人想要”数量智能排序。
- 多用户权限：支持多用户隔离架构，不同管理员拥有独立的数据视图和操作权限。
🛠️ 技术栈
表格
| 模块 | 技术选型 |
|---|---|
| 后端 | Python 3.11+, FastAPI, SQLite, Playwright, WebSocket, Asyncio |
| 前端 | React 18, TypeScript, Vite, Tailwind CSS, Framer Motion, Zustand |
| 性能优化 | 浏览器实例池, 并发控制, 智能缓存, JWT 认证 |
📦 安装与启动指南
1. 环境准备
确保已安装 Python 3.11+ 和 Node.js (推荐 LTS 版本)，并安装 pnpm。
2. 安装依赖
在项目根目录执行以下命令安装后端依赖：
bash
pip install -r requirements.txt
进入前端目录安装前端依赖并构建：
bash
cd frontend
pnpm install
pnpm run build
说明：
pnpm run build会将前端资源打包至static/目录，供后端直接提供服务。
3. 启动服务
返回项目根目录，启动后端服务：
bash
cd ..
python Start.py
服务启动后，浏览器访问：http://localhost:8080
4. 前端开发模式（可选）
如需修改前端代码并享受热更新体验，请开启两个终端：
终端 1：启动后端
bash
python Start.py
终端 2：启动前端开发服务器
bash
cd frontend
npm run dev
此时访问：http://localhost:3000
📝 首次使用流程
- 注册管理员：访问
http://localhost:8080/register创建首个管理员账号。 - 添加闲鱼账号：在系统中添加闲鱼账号，支持扫码、密码或 Cookie 登录。
- 配置自动化规则：
- 设置自动回复关键词及 AI 议价参数。
- 上传虚拟商品卡券或配置发货链接。
- 开始运营：系统将自动监听消息，实现秒级回复与自动发货。
🔄 更新日志
- 2026-02-20 ✨ 新增订单列表单条操作
- 支持单条订单状态同步刷新。
- 支持单条订单删除（带二次确认）。
- 优化表格布局，固定列宽，提升阅读体验。
