面向闲鱼卖家的账号、商品、订单、消息、自动回复与自动发货一体化管理系统。
一个人，把几十个闲鱼账号做成一门自动运转的生意。**
多账号统一托管，买家下单自动发卡密、自动确认收货、自动评价、自动求小红花、收货后自动致谢。
关键词和 AI 双层自动回复接住每一句咨询，商品与订单自动同步，滑块与人机验证自动处理。
从「盯着手机一个个回」变成「打开网页看数据」。
- 🏪 **多账号管理** — 扫码即接入，一个后台管完所有小号，逐账号独立配置策略
- 📦 **自动发货** — 卡密自动发出，支持多规格、多数量，发货前风险拦截
- 💬 **自动回复** — 关键词精确命中 + AI 议价，可设最低价与议价轮数，绝不越线让价
- ⭐ **买家互动** — 确认收货后自动评价、自动求小红花、自动发送致谢文本
- 🤖 **商品自动化** — 商品同步、素材库、定时擦亮、自动上下架
- 📊 **经营看板** — 成交额、到账、退款、订单和库存一屏掌握，**历史订单可一次性拉回**
## 核心功能| -------------------------------------------------------------------------------------
| 总览 | 汇总营收、账号、订单、卡密库存和运行状态
| 账号 | 扫码、密码或 Cookie 登录，资料同步，监听任务状态，暂停和自动回复配置
| 商品 | 从闲鱼同步商品，维护本地详情、图片、规格、数量和商品回复
| 商品自动化 | 商品筛选、素材库、发布记录、定时删除、短链修复和补偿任务
| 订单 | 一键拉取闲鱼历史卖出订单，状态判定、详情补全、批量刷新、手动发货和异常保护
| 卡密 | 卡券分组、库存导入、状态管理、多规格和多数量发货
| 自动回复 | 账号关键词回复、默认回复和回复一次控制
| 人工智能回复 | 兼容 OpenAI 协议的大模型配置、上下文对话和测试
| 自动发货 | 全局、指定账号、指定商品三级发货规则及发货前风险拦截
| 消息管理 | 闲鱼会话列表、消息收发、搜索筛选、回复决策日志和过滤规则
| 通知与日志 | 通知渠道、账号绑定、风险日志和系统日志
| 设置 | 管理员账号与改密、注册与邮箱验证开关、服务、备份及系统配置
| 公告与更新 | 从自建地址拉取公告与版本信息，首页横幅提示，「关于」页手动检查更新
## 界面预览
### 账号管理：一个后台管完所有小号
扫码添加账号，实时显示监听状态。每个账号可独立设置自动确认、人工接入暂停时长、
是否启用 AI 回复，互不干扰。
### 商品与发货：卡密自动发到买家手上
同步在售商品，逐个商品绑定发货内容，支持多规格和多数量。已下架的商品会被标记出来
并默认隐藏，不和在售的混在一起。
### 订单管理：接入前的历史订单也能一次拉回来
「拉取卖出订单」会把闲鱼上的历史订单整批同步进来，不只是接入之后的新单，
所以刚部署就能看到完整的经营数据。状态、买家、实付金额和发货情况一目了然，
支持按账号和状态筛选，也能手动发货或补发。
### 买家互动：确认收货后的动作全部自动完成
评价买家、索要小红花、发送收货致谢，三项都能逐账号开关。买家一确认收货，
致谢立即发出，评价和求花在订单状态就绪后自动执行。
### 消息中心：所有账号的会话在一个页面里
跨账号会话列表，支持搜索和筛选，可以直接接管对话。自动回复的每一次决策都有日志，
能查到为什么回了、为什么没回。
## 如何部署
> **⚠️ 请勿部署到 Hugging Face Spaces 等共享托管平台**
>
> 本项目内置反检测浏览器（Patchright）、验证码处理（CAPTCHA/Geetest）与 Telegram 通知等组件，
> 这类组合极易被共享平台判定为滥用（platform abuse），已有多起导致账号被封、其他 Space 受牵连的先例。
> 此外，海外出口 IP 也会显著增加闲鱼自有风控的触发概率。
> **推荐部署到本地设备、自有 VPS 或国内服务器。**
### 一条命令直接启动（最快，不用克隆仓库）
有 Docker 就能跑，不需要下载源码：
```bash
docker run -d --name xianyu-butler \
-p 8080:8080 \
-v $(pwd)/data:/app/data \
-v $(pwd)/logs:/app/logs \
-v $(pwd)/backups:/app/backups \
-e ADMIN_USERNAME=admin \
-e ADMIN_PASSWORD=改成你自己的密码 \
--restart unless-stopped \
ghcr.io/23star/xianyu-super-butler:latest
```
浏览器打开 `http://服务器IP:8080` 即可。数据都在当前目录的 `data` / `logs` / `backups` 里，
升级只需 `docker pull` 后重建容器，数据不丢。
Windows PowerShell 把 `$(pwd)` 换成 `${PWD}`，续行的 `\` 换成反引号 `` ` ``。
### Docker Compose（推荐长期使用）
```bash
git clone https://github.com/23Star/xianyu-super-butler.git
cd xianyu-super-butler
docker compose -f docker-compose.nas.yml up -d
```
同样是预构建镜像，不在本机编译任何东西，支持 amd64 / arm64。相比上面一条命令，
Compose 的好处是配置写在文件里、改起来清楚，升级也只有一行命令。
该配置不依赖 `.env`，管理员账号密码在 `docker-compose.nas.yml` 里的 `CHANGE_ME` 处直接改。
### NAS 与低配设备（飞牛 fnOS、群晖、威联通、软路由、低配 VPS）
**用上面那条命令，不要本地构建。**
`npm ci`、前端打包、Python 依赖编译和 Chromium 下载会同时抢占 CPU 和内存，
轻则卡十几分钟，重则内存不足被杀，反复重启表现为「装不上、机器卡死」。
预构建镜像已同时提供 amd64 和 arm64，绕开全部编译步骤。
```bash
docker compose -f docker-compose.nas.yml up -d
```
飞牛 fnOS、群晖等图形界面的 Docker 通常没地方放 `.env`，所以这份配置把变量直接写在
compose 文件里，改完 `CHANGE_ME` 就能用。
### Docker 本地构建（需要改代码时）
```bash
cp .env.example .env # 不改也能启动，此时使用默认密码
docker compose up -d --build
```
国内网络用 CN 配置（apt、pip、npm、Chromium 全部走国内镜像）：
```bash
docker compose -f docker-compose-cn.yml up -d --build
```
可选 Nginx：`docker compose --profile with-nginx up -d --build`
### 源码运行（开发调试）
需要 Python 3.11+、Node.js 20+、npm。
```bash
git clone https://github.com/23Star/xianyu-super-butler.git
cd xianyu-super-butler
py -3.11 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install -r requirements.txt
playwright install chromium
cd frontend && npm ci && npm run build && cd ..
python Start.py
```
### 访问
- 管理页面：`http://localhost:8080/`
- API 文档：`http://localhost:8080/docs`
- 健康检查：`http://localhost:8080/health`
默认管理员 **admin / admin123**，登录后请在「设置 → 账号与同步 → 修改登录密码」立即改掉。
数据持久化到 `./data`（数据库）、`./logs`（日志）、`./backups`（备份）。
### 更新
```bash
# 预构建镜像（推荐方式对应的更新命令）
docker compose -f docker-compose.nas.yml pull && docker compose -f docker-compose.nas.yml up -d
# 本地构建
git pull && docker compose up -d --build
```
> **滑块与人机验证、部署失败排查、使用流程** 见 [docs/deployment.md](docs/deployment.md)。
> 自动过滑块受平台风控限制不保证成功，自动失败时可在账号页转人工验证。
