面向闲鱼卖家的账号、商品、订单、消息、自动回复与自动发货一体化管理系统。
一个人，把几十个闲鱼账号做成一门自动运转的生意。
多账号统一托管，买家下单自动发卡密、自动确认收货、自动评价、自动求小红花、收货后自动致谢。 关键词和 AI 双层自动回复接住每一句咨询，商品与订单自动同步，滑块与人机验证自动处理。 从「盯着手机一个个回」变成「打开网页看数据」。
- 🏪 多账号管理 — 扫码即接入，一个后台管完所有小号，逐账号独立配置策略
- 📦 自动发货 — 卡密自动发出，支持多规格、多数量，发货前风险拦截
- 💬 自动回复 — 关键词精确命中 + AI 议价，可设最低价与议价轮数，绝不越线让价
- ⭐ 买家互动 — 确认收货后自动评价、自动求小红花、自动发送致谢文本
- 🤖 商品自动化 — 商品同步、素材库、定时擦亮、自动上下架
- 📊 经营看板 — 成交额、到账、退款、订单和库存一屏掌握，历史订单可一次性拉回
| 模块 | 能力 |
|---|---|
| 总览 | 汇总营收、账号、订单、卡密库存和运行状态 |
| 账号 | 扫码、密码或 Cookie 登录，资料同步，监听任务状态，暂停和自动回复配置 |
| 商品 | 从闲鱼同步商品，维护本地详情、图片、规格、数量和商品回复 |
| 商品自动化 | 商品筛选、素材库、发布记录、定时删除、短链修复和补偿任务 |
| 订单 | 一键拉取闲鱼历史卖出订单，状态判定、详情补全、批量刷新、手动发货和异常保护 |
| 卡密 | 卡券分组、库存导入、状态管理、多规格和多数量发货 |
| 自动回复 | 账号关键词回复、默认回复和回复一次控制 |
| 人工智能回复 | 兼容 OpenAI 协议的大模型配置、上下文对话和测试 |
| 自动发货 | 全局、指定账号、指定商品三级发货规则及发货前风险拦截 |
| 消息管理 | 闲鱼会话列表、消息收发、搜索筛选、回复决策日志和过滤规则 |
| 通知与日志 | 通知渠道、账号绑定、风险日志和系统日志 |
| 设置 | 管理员账号与改密、注册与邮箱验证开关、服务、备份及系统配置 |
| 公告与更新 | 从自建地址拉取公告与版本信息，首页横幅提示，「关于」页手动检查更新 |
扫码添加账号，实时显示监听状态。每个账号可独立设置自动确认、人工接入暂停时长、 是否启用 AI 回复，互不干扰。
同步在售商品，逐个商品绑定发货内容，支持多规格和多数量。已下架的商品会被标记出来 并默认隐藏，不和在售的混在一起。
「拉取卖出订单」会把闲鱼上的历史订单整批同步进来，不只是接入之后的新单， 所以刚部署就能看到完整的经营数据。状态、买家、实付金额和发货情况一目了然， 支持按账号和状态筛选，也能手动发货或补发。
评价买家、索要小红花、发送收货致谢，三项都能逐账号开关。买家一确认收货， 致谢立即发出，评价和求花在订单状态就绪后自动执行。
跨账号会话列表，支持搜索和筛选，可以直接接管对话。自动回复的每一次决策都有日志， 能查到为什么回了、为什么没回。
有 Docker 就能跑，不需要下载源码：
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}，续行的 \ 换成反引号 `。
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 处直接改。
用上面那条命令，不要本地构建。
npm ci、前端打包、Python 依赖编译和 Chromium 下载会同时抢占 CPU 和内存，
轻则卡十几分钟，重则内存不足被杀，反复重启表现为「装不上、机器卡死」。
预构建镜像已同时提供 amd64 和 arm64，绕开全部编译步骤。
docker compose -f docker-compose.nas.yml up -d飞牛 fnOS、群晖等图形界面的 Docker 通常没地方放 .env，所以这份配置把变量直接写在
compose 文件里，改完 CHANGE_ME 就能用。
cp .env.example .env # 不改也能启动，此时使用默认密码
docker compose up -d --build国内网络用 CN 配置（apt、pip、npm、Chromium 全部走国内镜像）：
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。
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（备份）。
# 预构建镜像（推荐方式对应的更新命令）
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。 自动过滑块受平台风控限制不保证成功，自动失败时可在账号页转人工验证。
| 微信群 | QQ群 |
|---|---|
 |
 |
| 二维码失效后会在仓库更新 | 群号：704866149 |
缺陷和功能建议请提交到 GitHub Issues。
本项目基于 zhinianboke/xianyu-auto-reply 二次开发并持续维护，保留原项目核心能力，同时重构管理端、账号监听、商品同步、订单处理和发货规则。感谢原作者的开源工作。
项目使用 GNU Affero General Public License v3.0。修改、部署或通过网络提供服务时，请遵守 AGPL-3.0 的源代码公开义务。
本项目仅供学习、研究和合法自动化使用。使用者应遵守法律法规及平台规则，并自行承担使用风险。
Star 历史曲线实时读取 GitHub 数据，不需要人工更新。
该统计在主仓库 Star 之外累加全部公开 Fork 获得的 Star，每 6 小时自动刷新。由于同一用户可能同时 Star 多个仓库，此处是各仓库 Star 数之和，并非去重后的独立用户数。