23Star/xianyu-super-butler

闲鱼超级管家是一款全面升级的xy自动发货平台,自动滑块、发货、评价、要花、擦亮通通稳定支持,时刻维护!时刻更新!坚决保证使用世界上最强 AI模型(6 Astra\6 Sol 、ops 5)vibecoding! 群在最后面,不想部署用在线的xy.corleom.com(免费、最新、安全,托管账号AI自动过滑块)

Python

1,275

355 commits

updated Oct 17, 2026

See the code

README

闲鱼智控(闲鱼超级管家)

面向闲鱼卖家的账号、商品、订单、消息、自动回复与自动发货一体化管理系统。 一款能让你的想法'变现'的强大作品

推荐使用云端版(GPT6自动过滑块+人工巡检)

云端saas版本:https://xy.corleom.com/ 本项目征集PR、功能更新,任何一个提交PR的作者会在未来获得顶配模型token奖励

GitHub Stars Version Python React License

一个人把多个闲鱼账号做成一门自动运转的生意,让你的创意自动'变现'

多账号统一托管,买家下单自动发卡密、自动确认收货、自动评价、自动求小红花、收货后自动致谢。 关键词和 AI 双层自动回复接住每一句咨询,商品与订单自动同步,滑块与人机验证自动处理。 从「盯着手机一个个回」变成「打开网页看数据」。

  • 🏪 多账号管理 — 扫码即接入,一个后台管完所有小号,逐账号独立配置策略
  • 📦 自动发货 — 卡密自动发出,支持多规格、多数量,发货前风险拦截
  • 💬 自动回复 — 关键词精确命中 + AI 议价,可设最低价与议价轮数,绝不越线让价
  • ⭐ 买家互动 — 确认收货后自动评价、自动求小红花、自动发送致谢文本
  • 🤖 商品自动化 — 商品同步、素材库、定时擦亮、自动上下架
  • 📊 经营看板 — 成交额、到账、退款、订单和库存一屏掌握,历史订单可一次性拉回

闲鱼超级管家运营概览

核心功能

模块能力
总览汇总营收、账号、订单、卡密库存和运行状态
账号扫码、密码或 Cookie 登录,资料同步,监听任务状态,暂停和自动回复配置
商品从闲鱼同步商品,维护本地详情、图片、规格、数量和商品回复
商品自动化商品筛选、素材库、发布记录、定时删除、短链修复和补偿任务
订单一键拉取闲鱼历史卖出订单,状态判定、详情补全、批量刷新、手动发货和异常保护
卡密卡券分组、库存导入、状态管理、多规格和多数量发货
自动回复账号关键词回复、默认回复和回复一次控制
人工智能回复兼容 OpenAI 协议的大模型配置、上下文对话和测试
自动发货全局、指定账号、指定商品三级发货规则及发货前风险拦截
消息管理闲鱼会话列表、消息收发、搜索筛选、回复决策日志和过滤规则
通知与日志通知渠道、账号绑定、风险日志和系统日志
设置管理员账号与改密、注册与邮箱验证开关、服务、备份及系统配置
公告与更新从自建地址拉取公告与版本信息,首页横幅提示,「关于」页手动检查更新

界面预览

账号管理:一个后台管完所有小号

扫码添加账号,实时显示监听状态。每个账号可独立设置自动确认、人工接入暂停时长、 是否启用 AI 回复,互不干扰。

账号管理

商品与发货:卡密自动发到买家手上

同步在售商品,逐个商品绑定发货内容,支持多规格和多数量。已下架的商品会被标记出来 并默认隐藏,不和在售的混在一起。

商品与发货

订单管理:接入前的历史订单也能一次拉回来

「拉取卖出订单」会把闲鱼上的历史订单整批同步进来,不只是接入之后的新单, 所以刚部署就能看到完整的经营数据。状态、买家、实付金额和发货情况一目了然, 支持按账号和状态筛选,也能手动发货或补发。

订单管理

买家互动:确认收货后的动作全部自动完成

评价买家、索要小红花、发送收货致谢,三项都能逐账号开关。买家一确认收货, 致谢立即发出,评价和求花在订单状态就绪后自动执行。

买家互动

消息中心:所有账号的会话在一个页面里

跨账号会话列表,支持搜索和筛选,可以直接接管对话。自动回复的每一次决策都有日志, 能查到为什么回了、为什么没回。

消息中心

如何部署

⚠️ 请勿部署到 Hugging Face Spaces 等共享托管平台

本项目内置反检测浏览器(Patchright)、验证码处理(CAPTCHA/Geetest)与 Telegram 通知等组件, 这类组合极易被共享平台判定为滥用(platform abuse),已有多起导致账号被封、其他 Space 受牵连的先例。 此外,海外出口 IP 也会显著增加闲鱼自有风控的触发概率。 推荐部署到本地设备、自有 VPS 或国内服务器。

一条命令直接启动(最快,不用克隆仓库)

有 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},续行的 \ 换成反引号 `。

Docker Compose(推荐长期使用)

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,绕开全部编译步骤。

docker compose -f docker-compose.nas.yml up -d

飞牛 fnOS、群晖等图形界面的 Docker 通常没地方放 .env,所以这份配置把变量直接写在 compose 文件里,改完 CHANGE_ME 就能用。

Docker 本地构建(需要改代码时)

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群
闲鱼超级管家微信群二维码闲鱼超级管家QQ群二维码
二维码失效后会在仓库更新群号:704866149

缺陷和功能建议请提交到 GitHub Issues。

许可与声明

本项目基于 zhinianboke/xianyu-auto-reply 二次开发并持续维护,保留原项目核心能力,同时重构管理端、账号监听、商品同步、订单处理和发货规则。感谢原作者的开源工作。

项目使用 GNU Affero General Public License v3.0。修改、部署或通过网络提供服务时,请遵守 AGPL-3.0 的源代码公开义务。

本项目仅供学习、研究和合法自动化使用。使用者应遵守法律法规及平台规则,并自行承担使用风险。

Star History

Star History Chart

Star 历史曲线实时读取 GitHub 数据,不需要人工更新。

Fork 网络总 Star

Fork Network Stars

该统计在主仓库 Star 之外累加全部公开 Fork 获得的 Star,每 6 小时自动刷新。由于同一用户可能同时 Star 多个仓库,此处是各仓库 Star 数之和,并非去重后的独立用户数。

xianyu
xianyuapp
xianyu-assistant
xianyu-auto-delivery
xianyu-auto-reply
xianyubb-bot
xianyu-bot
xianyu-monitor
xianyu-super-butler
xianyu-tool

Significant stargazers

Talljack

180 followers · starred Mar 2026

linjun

49 followers · starred Mar 2026

23Star/xianyu-super-butler

闲鱼超级管家是一款全面升级的xy自动发货平台,自动滑块、发货、评价、要花、擦亮通通稳定支持,时刻维护!时刻更新!坚决保证使用世界上最强 AI模型(6 Astra\6 Sol 、ops 5)vibecoding! 群在最后面,不想部署用在线的xy.corleom.com(免费、最新、安全,托管账号AI自动过滑块)

Python

1,275

355 commits

updated Oct 17, 2026

See the code

README

闲鱼智控(闲鱼超级管家)

面向闲鱼卖家的账号、商品、订单、消息、自动回复与自动发货一体化管理系统。 一款能让你的想法'变现'的强大作品

推荐使用云端版(GPT6自动过滑块+人工巡检)

云端saas版本:https://xy.corleom.com/ 本项目征集PR、功能更新,任何一个提交PR的作者会在未来获得顶配模型token奖励

GitHub Stars Version Python React License

一个人把多个闲鱼账号做成一门自动运转的生意,让你的创意自动'变现'

多账号统一托管,买家下单自动发卡密、自动确认收货、自动评价、自动求小红花、收货后自动致谢。 关键词和 AI 双层自动回复接住每一句咨询,商品与订单自动同步,滑块与人机验证自动处理。 从「盯着手机一个个回」变成「打开网页看数据」。

  • 🏪 多账号管理 — 扫码即接入,一个后台管完所有小号,逐账号独立配置策略
  • 📦 自动发货 — 卡密自动发出,支持多规格、多数量,发货前风险拦截
  • 💬 自动回复 — 关键词精确命中 + AI 议价,可设最低价与议价轮数,绝不越线让价
  • ⭐ 买家互动 — 确认收货后自动评价、自动求小红花、自动发送致谢文本
  • 🤖 商品自动化 — 商品同步、素材库、定时擦亮、自动上下架
  • 📊 经营看板 — 成交额、到账、退款、订单和库存一屏掌握,历史订单可一次性拉回

闲鱼超级管家运营概览

核心功能

模块能力
总览汇总营收、账号、订单、卡密库存和运行状态
账号扫码、密码或 Cookie 登录,资料同步,监听任务状态,暂停和自动回复配置
商品从闲鱼同步商品,维护本地详情、图片、规格、数量和商品回复
商品自动化商品筛选、素材库、发布记录、定时删除、短链修复和补偿任务
订单一键拉取闲鱼历史卖出订单,状态判定、详情补全、批量刷新、手动发货和异常保护
卡密卡券分组、库存导入、状态管理、多规格和多数量发货
自动回复账号关键词回复、默认回复和回复一次控制
人工智能回复兼容 OpenAI 协议的大模型配置、上下文对话和测试
自动发货全局、指定账号、指定商品三级发货规则及发货前风险拦截
消息管理闲鱼会话列表、消息收发、搜索筛选、回复决策日志和过滤规则
通知与日志通知渠道、账号绑定、风险日志和系统日志
设置管理员账号与改密、注册与邮箱验证开关、服务、备份及系统配置
公告与更新从自建地址拉取公告与版本信息,首页横幅提示,「关于」页手动检查更新

界面预览

账号管理:一个后台管完所有小号

扫码添加账号,实时显示监听状态。每个账号可独立设置自动确认、人工接入暂停时长、 是否启用 AI 回复,互不干扰。

账号管理

商品与发货:卡密自动发到买家手上

同步在售商品,逐个商品绑定发货内容,支持多规格和多数量。已下架的商品会被标记出来 并默认隐藏,不和在售的混在一起。

商品与发货

订单管理:接入前的历史订单也能一次拉回来

「拉取卖出订单」会把闲鱼上的历史订单整批同步进来,不只是接入之后的新单, 所以刚部署就能看到完整的经营数据。状态、买家、实付金额和发货情况一目了然, 支持按账号和状态筛选,也能手动发货或补发。

订单管理

买家互动:确认收货后的动作全部自动完成

评价买家、索要小红花、发送收货致谢,三项都能逐账号开关。买家一确认收货, 致谢立即发出,评价和求花在订单状态就绪后自动执行。

买家互动

消息中心:所有账号的会话在一个页面里

跨账号会话列表,支持搜索和筛选,可以直接接管对话。自动回复的每一次决策都有日志, 能查到为什么回了、为什么没回。

消息中心

如何部署

⚠️ 请勿部署到 Hugging Face Spaces 等共享托管平台

本项目内置反检测浏览器(Patchright)、验证码处理(CAPTCHA/Geetest)与 Telegram 通知等组件, 这类组合极易被共享平台判定为滥用(platform abuse),已有多起导致账号被封、其他 Space 受牵连的先例。 此外,海外出口 IP 也会显著增加闲鱼自有风控的触发概率。 推荐部署到本地设备、自有 VPS 或国内服务器。

一条命令直接启动(最快,不用克隆仓库)

有 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},续行的 \ 换成反引号 `。

Docker Compose(推荐长期使用)

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,绕开全部编译步骤。

docker compose -f docker-compose.nas.yml up -d

飞牛 fnOS、群晖等图形界面的 Docker 通常没地方放 .env,所以这份配置把变量直接写在 compose 文件里,改完 CHANGE_ME 就能用。

Docker 本地构建(需要改代码时)

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群
闲鱼超级管家微信群二维码闲鱼超级管家QQ群二维码
二维码失效后会在仓库更新群号:704866149

缺陷和功能建议请提交到 GitHub Issues。

许可与声明

本项目基于 zhinianboke/xianyu-auto-reply 二次开发并持续维护,保留原项目核心能力,同时重构管理端、账号监听、商品同步、订单处理和发货规则。感谢原作者的开源工作。

项目使用 GNU Affero General Public License v3.0。修改、部署或通过网络提供服务时,请遵守 AGPL-3.0 的源代码公开义务。

本项目仅供学习、研究和合法自动化使用。使用者应遵守法律法规及平台规则,并自行承担使用风险。

Star History

Star History Chart

Star 历史曲线实时读取 GitHub 数据,不需要人工更新。

Fork 网络总 Star

Fork Network Stars

该统计在主仓库 Star 之外累加全部公开 Fork 获得的 Star,每 6 小时自动刷新。由于同一用户可能同时 Star 多个仓库,此处是各仓库 Star 数之和,并非去重后的独立用户数。

xianyu
xianyuapp
xianyu-assistant
xianyu-auto-delivery
xianyu-auto-reply
xianyubb-bot
xianyu-bot
xianyu-monitor
xianyu-super-butler
xianyu-tool

Significant stargazers

Talljack

180 followers · starred Mar 2026

linjun

49 followers · starred Mar 2026