项目概述
一个基于 FastAPI + SQLite + Playwright 的闲鱼管理系统,支持多用户、多账号管理、关键词回复、AI 自动回复、自动发货、商品管理、日志监控和 Docker 一键部署。
⚠️ 重要提示:本项目采用 AGPL-3.0 开源协议,仅供学习研究使用,请勿用于违法违规场景。使用前请仔细阅读版权声明。
核心特性
- 多用户系统 :支持注册登录、邮箱验证、图形验证码、权限控制和用户数据隔离。
- 多账号管理 :每个用户可管理多个闲鱼账号,支持独立启停、状态查看和 Cookie 维护。
- 智能回复 :支持关键词回复、默认回复、指定商品回复、图片关键词和 AI 自动回复。
- 自动发货 :支持文本、批量数据、API、图片等发货方式,并提供防重复处理能力。
- 商品管理 :自动收集商品信息,支持商品详情、规格配置和数据去重。
- 运营协同 :提供订单管理、通知渠道、消息通知、在线客服等后台运营能力。
- 监控维护 :支持实时日志、健康检查、安全统计、系统统计和日志文件轮转。
- 容器化部署 :支持本地运行、Docker Compose 和多架构构建。
快速开始
Docker Compose(推荐)
git clone https://github.com/GuDong2003/xianyu-auto-reply-fix.gitcd xianyu-auto-reply-fixdocker compose up -d
默认访问:
- Web 管理界面:
http://localhost:9000 - API 文档:
http://localhost:9000/docs - 健康检查:
http://localhost:9000/health
本地运行
git clone https://github.com/GuDong2003/xianyu-auto-reply-fix.gitcd xianyu-auto-reply-fixpython -m venv venvsource venv/bin/activate # Windows 使用 venv\Scripts\activatepip install --upgrade pippip install -r requirements.txtplaywright install chromiumpython Start.py
默认访问: http://localhost:8090
更多部署方式、Windows 脚本、国内 Docker Compose 配置、多架构构建和访问地址见 部署与运行指南。
AI 回复配置
AI 回复使用统一的 model_name / api_key / base_url / api_type 配置模式,支持 OpenAI-compatible、OpenAI Responses、DashScope、Gemini、Anthropic、Azure OpenAI 等接口。
第三方 OpenAI-compatible 服务可通过自定义 base_url 接入;详细配置和新增 Provider 说明见 配置说明。
技术架构
核心技术栈
- 后端框架 :FastAPI + Uvicorn + Python 3.11+ 异步编程
- 数据库 :SQLite 3 + 多用户数据隔离 + 自动迁移
- 前端 :Bootstrap 5 + Vanilla JavaScript + Chart.js
- 通信协议 :REST API + WebSocket + SSE
- 自动化能力 :Playwright + DrissionPage
- 部署方式 :Docker + Docker Compose + Nginx(可选)
- 日志系统 :Loguru + 文件轮转 + 实时收集
┌─────────────────────────────────────────┐│ Web 界面 (FastAPI + Static) ││ 用户管理 + 功能界面 │└───────────────────┬─────────────────────┘ │┌───────────────────▼─────────────────────┐│ CookieManager ││ 多账号任务与状态管理 │└───────────────────┬─────────────────────┘ │┌───────────────────▼─────────────────────┐│ XianyuLive (多实例) ││ WebSocket 连接 + 消息处理 │└──────────────┬──────────────┬───────────┘ │ │┌──────────────▼───────┐ ┌────▼──────────────┐│ AIReplyEngine │ │ FileLogCollector ││ AI 回复与上下文 │ │ 实时日志与统计 │└──────────────┬───────┘ └────┬──────────────┘ │ │┌──────────────▼──────────────▼───────────┐│ SQLite 数据库 ││ 用户数据 + 商品信息 + 配置数据 │└─────────────────────────────────────────┘
监控和维护
- 实时日志 :Web 界面查看实时系统日志。
- 日志文件 :
logs/目录下按日期分割。 - 日志级别 :支持 DEBUG、INFO、WARNING、ERROR。
- 健康检查 :访问
/health检查服务状态。
项目地址
https://github.com/GuDong2003/xianyu-auto-reply-fix
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END






暂无评论内容