基于 FastAPI + React + MySQL + Redis + Playwright 的闲鱼多账号自动化系统。
主系统负责账号管理、消息收发、自动回复、自动发货、商品发布与后台管理；promotion 子项目负责返佣账号、选品规则、素材库、发布规则、删除规则和相关修复任务。
| 模块 |
说明 |
| 多账号管理 |
支持多个闲鱼账号登录、状态切换、Cookie 维护与登录续期 |
| 自动回复 |
支持文本关键词、图片关键词、默认回复、商品专属回复 |
| AI 回复 |
支持大模型上下文对话与智能回复 |
| 自动发货 |
支持卡券、虚拟商品、自动补发、发送结果记录 |
| 在线聊天 |
支持会话列表、消息收发、聊天联动 |
| 商品发布 |
支持素材库、地址库、单品发布、批量发布、发布日志 |
| 订单与评价 |
订单拉取、自动评价、求小红花、状态跟踪 |
| 商品采集与分销 |
Goofish 采集、货源管理、对接记录、结算链路 |
| 通知与风控 |
支持消息通知、风控日志、系统反馈与公告管理 |
| 模块 |
说明 |
| 返佣账号 |
返佣账号登录、状态管理、Cookie 维护 |
| 选品规则 |
按规则抓取候选商品并自动写入素材库 |
| 素材库 |
管理标题、图片、详情、淘口令、短链、库存、发布状态 |
| 发布规则 |
定时发布返佣商品，复用公共发布能力 |
| 删除规则 |
定时删除已发布商品 |
| 补偿任务 |
已发布商品 ID 回写、短链修复、卡券补偿等 |
| 技术 |
说明 |
| FastAPI |
主系统与返佣后端 API 服务 |
| SQLAlchemy 2.0 |
ORM 与数据库访问 |
| MySQL 8.0 |
主数据存储 |
| Redis 7 |
缓存、会话与任务辅助 |
| Playwright |
登录、Cookie 刷新、发布等浏览器自动化 |
| APScheduler |
定时任务调度 |
| Loguru |
日志管理 |
| 技术 |
说明 |
| React 18 + TypeScript |
主系统与返佣前端 |
| Vite |
开发与构建 |
| TailwindCSS |
主系统 UI 样式 |
| Zustand |
状态管理 |
| Lucide React |
图标体系 |
| 技术 |
说明 |
| Docker / Docker Compose |
容器化部署 |
| Nginx |
前端静态资源与反向代理 |
- Python 3.11+
- Node.js 18+
- MySQL 8.0+
- Redis 6+
- Chromium / Chrome（Playwright 相关功能）
- Docker 20.10+
- Docker Compose 2.0+
- 最低 2 核 CPU / 4GB 内存
- 推荐 4 核 CPU / 8GB 内存
| 服务 |
默认端口 |
说明 |
frontend |
9000 |
主系统前端 |
backend-web |
8089 |
主系统 API 网关、业务接口 |
websocket |
8090 |
闲鱼 WebSocket、消息收发、登录与订单联动 |
scheduler |
8091 |
定时任务执行器 |
promotion/backend |
8092 |
返佣后端 API |
promotion/frontend |
9001 |
返佣前端 |
- 主系统采用多服务拆分：
frontend 负责界面与交互backend-web 负责大部分业务 APIwebsocket 负责闲鱼实时连接、扫码登录、消息处理scheduler 负责自动发货、评价、订单拉取、Cookie 刷新等定时任务common 提供模型、数据库、自检、公共服务与工具
- 返佣子系统位于
promotion/ 目录，前后端独立，当前不在根目录 Docker Compose 编排内
- 主系统三个后端服务都提供
/health 健康检查接口
- Docker 依赖链：mysql/redis → backend-web → websocket → scheduler；frontend → backend-web
❮
❯
