根因两个: 1. _record_password_login_failure 全项目零调用,且 password_login_failures 从未在 __init__ 初始化——计数一触发就 AttributeError 被外层吞掉, 3 次熔断阈值是彻头彻尾的死代码; 2. refresh_token / main 重连循环都不检查 needs_relogin 终态,且每次 实例重启都会把终态洗成 False。 结果:Session 过期后每 60 秒一次 Playwright 密码登录+滑块尝试, 7 天 514 次全部失败,把账号推进风控黑名单,扫码恢复的 session 也活不长久。 修复(7 处): - __init__ 初始化 password_login_failures/relogin_terminal_until/ _relogin_notification_sent;record 用 getattr 兜底 - Session 过期失败分支接 record + _mark_relogin_required(30 分钟冷却) - refresh_token 入口:终态冷却内短路不发请求,冷却满放行一次探测 (放行即续期),探测成功走 _clear_relogin_required 完整复位 - _try_password_login_refresh 入口:终态冷却内跳过密码登录 - main 连败 5 次分支:终态时跳过密码登录与实例重启(重启会洗终态) - Cookie 验证失败、main 密码登录失败两个分支接 record 计数 实测:修复前每 70 秒一次密码登录尝试(514 次/7 天);修复后 3 次 尝试建立终态即停止,后续仅剩「跳过密码登录与实例重启」等待日志。
躺赚鱼 · 闲鱼自动回复与客服运营工作台
基于 xianyu-auto-reply(闲鱼超级管家) 二次开发 本仓库是深度定制版:新增选品情报、价格监控、一键转卖等经营功能,详见下方「我改了什么」。
🎮 在线体验(免部署,打开即用):https://tzy.88531.cn
一个人把多个闲鱼账号做成一门自动运转的生意:买家下单自动发卡密、咨询自动回复、收货自动评价, 再加上本版本新增的热卖榜选品、低价监控、一键转卖——从「盯着手机一个个回」变成「打开网页看数据、做决策」。
🎮 先去体验(推荐第一步)
不想部署?直接打开在线体验站,30 秒看到全部功能:
- 打开 https://tzy.88531.cn → 注册 / 登录进入工作台
- 看 总览:成交额、订单、商品销量排行一屏掌握
- 点 实时热卖榜:看当前什么最好卖(11 个分类、按想要人数排序)
- 点 价格监控:给想卖的品设关键词与目标价,低于目标价自动盯
- 点 一键转卖:把收藏 / 搜到的商品改个价直接铺到自己店铺
- 点 同行热卖店铺:一键聚合同类型最能卖的 50 家同行,看相似度、参考价值,AI 告诉你抄谁的作业
- 点 AI 回复:配置模型,买家闲聊也有人接
觉得好用再往下看「怎么部署到自己的服务器」。
✨ 我新增了什么(相对原版)
| 功能 | 说明 |
|---|---|
| 🏆 实时热卖榜 | 11 个分类(含虚拟商品、软件资源、AI 资源、学习资料)实时抓取闲鱼在售商品,按想要人数取前 30 名;商品名点击直达闲鱼详情页;附热门搜索词 + 真实热度(命中商品想要人数合计),点击直接跳闲鱼搜索 |
| 🏪 同行热卖店铺 | 按您店铺的类型关键词实时聚合同类型销量最好的 50 家店铺,显示销量 / 信用 / 评论数、与您店铺的相似度与参考价值,支持按销量(默认)/ 相似度 / 信用 / 评论数自定义排序,一键直达闲鱼店铺主页;配置模型 KEY 后可 AI 一键分析「最适合您店铺的同行 + 可借鉴打法」 |
| 💰 价格监控 | 关键词规则定时搜索闲鱼,抓全网最低价,低于目标价立即通知;支持卖家信用度筛选(不限 / 卖信用 / 新卖家 / 优质卖家)、销量下限、AI 精准监控(模型判断商品是否匹配需求,避免低价干扰) |
| 🔄 一键转卖 | 收藏的商品自动加载(支持分页)→ 改标题 / 改价 → 一键发布到自己的账号;商品卡片点击直达闲鱼详情核对货源;类目识别不准时可点「修改类目」从闲鱼发布页分类列表里搜索手选(识别 > 详情 > 手选三级优先) |
| 🤖 AI 回复增强 | 兼容 OpenAI 协议任意模型;支持议价边界(最低价 + 议价轮数,绝不越线让价);免费 token 领取入口(https://ai.88531.cn),开箱即用 |
| 🔐 API 密钥安全 | 密钥掩码显示(sk-4****27QK)、密码框 + 显隐切换,保存时不覆盖原值 |
| 🧠 推理模型兼容 | 修复 reasoning 模型(deepseek-v4-flash 等)思考阶段吃光 max_tokens 导致回复为空的问题 |
| 🏷️ 商品本地编辑 | 商品标题 / 价格 / 描述可本地编辑,供 AI 关键词匹配与回复参考 |
| 📢 公告与版本推送 | 接入授权系统:在线人数统计、新版本横幅提示、公告统一推送 |
| ✨ 品牌与体验 | 全站更名为「躺赚鱼」,中文界面,登录页 / 侧边栏 / 页脚统一 |
完整改动记录见 CHANGELOG.md(v1.1.0 → v3.6.17,逐版本带验证记录)。
💡 为什么要用这个版本
- 原版有的,它都有:多账号托管、卡密自动发货、关键词 + AI 双层自动回复、自动确认收货、自动评价 / 求小红花 / 致谢、商品定时擦亮、历史订单一键拉回。
- 原版没有的经营能力,这里补齐了:热卖榜告诉你「卖什么」,价格监控告诉你「卖多少钱」,一键转卖让你「10 秒铺一个品」——从被动接单变成主动经营。
- 开箱即用的 AI:不用自己找模型,领免费 token 就能跑;议价有底线,不会被买家砍穿。
- 数据在自己手里:自部署、开源(AGPL-3.0)、SQLite 单文件备份,不依赖第三方 SaaS。
- 国内友好:中文界面、国内构建镜像源(
docker-compose-cn.yml)、Asia/Shanghai时区默认。
🖼️ 界面预览(真实截图)
运营总览:成交额、订单、销量排行一屏掌握
价格监控:关键词规则 + 目标价 + 卖家信用筛选
一键转卖:收藏自动加载,改价即发到自己店铺
AI 回复:模型配置、免费 token 领取
实时热卖榜:11 分类按想要人数排序,直达闲鱼详情
同行热卖店铺:同类型最能卖的 50 家同行,相似度 / 参考价值 / AI 分析
📦 核心功能(原版能力全部保留)
| 模块 | 能力 |
|---|---|
| 总览 | 汇总营收、账号、订单、卡密库存和运行状态 |
| 账号 | 扫码、密码或 Cookie 登录,资料同步,监听任务状态,暂停和自动回复配置 |
| 商品 | 从闲鱼同步商品,维护本地详情、图片、规格、数量和商品回复(本版可编辑标题/价格/描述) |
| 商品自动化 | 商品筛选、素材库、发布记录、定时删除、短链修复和补偿任务 |
| 订单 | 一键拉取闲鱼历史卖出订单,状态判定、详情补全、批量刷新、手动发货和异常保护 |
| 卡密 | 卡券分组、库存导入、状态管理、多规格和多数量发货 |
| 自动回复 | 账号关键词回复、默认回复和回复一次控制 |
| 人工智能回复 | OpenAI 协议大模型配置、上下文对话、议价边界、测试与免费 token |
| 自动发货 | 全局、指定账号、指定商品三级发货规则及发货前风险拦截 |
| 消息管理 | 闲鱼会话列表、消息收发、搜索筛选、回复决策日志和过滤规则 |
| 买家互动 | 确认收货后自动评价、自动求小红花、自动发送致谢文本 |
| 通知与日志 | 通知渠道、账号绑定、通知规则门禁(通知间隔防轰炸——间隔期内重复通知静默,最长 24 小时;连续失败 N 次才推送;按事件类型订阅),风险日志和系统日志 |
⚙️ 安装方式
⚠️ 不要部署到 Hugging Face Spaces 等共享托管平台:内置反检测浏览器与验证码处理组件易被判滥用,且海外出口 IP 显著增加闲鱼风控概率。 推荐本地设备、自有 VPS 或国内服务器。
方式一:docker run(拉取腾讯云镜像,复制即用)
镜像已发布到腾讯云容器镜像服务(国内拉取快,含全部新功能,无需 clone / 构建):
# 拉取镜像(公网仓库,匿名可拉)
docker pull jpccr.ccs.tencentyun.com/jinghui/tangzhuan-yu:latest
# 启动(参数齐全,复制即用)
docker run -d --name xianyu-butler \
-p 8080:8080 \
-v $(pwd)/data:/app/data \
-v $(pwd)/logs:/app/logs \
-v $(pwd)/backups:/app/backups \
-v $(pwd)/global_config.yml:/app/global_config.yml:ro \
-e ADMIN_USERNAME=admin \
-e ADMIN_PASSWORD=改成你自己的强密码 \
-e TZ=Asia/Shanghai \
-e PYTHONUNBUFFERED=1 \
--restart unless-stopped \
jpccr.ccs.tencentyun.com/jinghui/tangzhuan-yu:latest
浏览器打开 http://服务器IP:8080 即可。
参数说明
| 参数 | 作用 | 注意 |
|---|---|---|
-p 8080:8080 |
面板端口 | 改左侧即可换端口,如 -p 9000:8080 |
-v .../data:/app/data |
数据库 xianyu_data.db、卡密、缓存 |
必须挂载,否则重建容器数据全丢 |
-v .../logs:/app/logs |
运行日志 | 排障用 |
-v .../backups:/app/backups |
备份文件 | 建议定期打包 |
-v .../global_config.yml |
全局配置(只读) | 不改配置可去掉这行 |
ADMIN_USERNAME/PASSWORD |
初始管理员 | 首次登录后立即在「系统设置 → 修改登录密码」改掉 |
--restart unless-stopped |
宿主重启后自动拉起 | 建议保留 |
Windows PowerShell:把 $(pwd) 换成 ${PWD},续行 \ 换成反引号 `。
方式二:docker-compose.yml(推荐长期使用)
仓库自带 docker-compose.yml(另有国内源 docker-compose-cn.yml、NAS 专用 docker-compose.nas.yml):
mkdir tangzhuan-yu && cd tangzhuan-yu # 任意空目录,数据放这里
curl -O https://gitea.88531.cn/jinghui/tangzhuan-yu/raw/branch/main/docker-compose.yml
cp .env.example .env # 没有 .env 就直接 docker compose up -d(默认 admin/admin123),生产环境务必改掉
docker compose up -d # 直接拉取腾讯云镜像,无需构建
也可以
git clone https://gitea.88531.cn/jinghui/tangzhuan-yu.git(或 Gitee 镜像https://gitee.com/jinghui111/tangzhuan-yu.git)拿到完整仓库后再docker compose up -d,compose 里已配置直接拉镜像。
仓库内 docker-compose.yml 已带齐全部参数,等价于:
services:
xianyu-app:
image: jpccr.ccs.tencentyun.com/jinghui/tangzhuan-yu:latest # 腾讯云镜像(含全部新功能),如需本地构建把这行换成 build 段
container_name: xianyu-butler
restart: unless-stopped # 宿主重启自动拉起
user: "0:0" # 容器内需要写 /app/data 等挂载目录
ports:
- "${WEB_PORT:-8080}:8080" # 换端口改 WEB_PORT
volumes:
- ./data:/app/data:rw # ★数据库与卡密,必须挂载
- ./logs:/app/logs:rw
- ./backups:/app/backups:rw
- ./global_config.yml:/app/global_config.yml:ro
environment:
TZ: "Asia/Shanghai" # 默认东八区
ADMIN_USERNAME: "${ADMIN_USERNAME:-admin}"
ADMIN_PASSWORD: "${ADMIN_PASSWORD:-admin123}" # ★改成自己的
SESSION_TIMEOUT: "3600"
MULTIUSER_ENABLED: "true" # 允许注册多用户
USER_REGISTRATION_ENABLED: "true"
EMAIL_VERIFICATION_ENABLED: "true" # 注册需邮箱验证码
CAPTCHA_ENABLED: "true" # 登录/注册图形验证码
AUTO_REPLY_ENABLED: "true"
AUTO_DELIVERY_ENABLED: "true"
AI_REPLY_ENABLED: "false" # 默认关,页面里配置模型后打开
DEFAULT_AI_MODEL: "qwen-plus"
LOG_LEVEL: "INFO"
DEBUG: "false"
SQL_LOG_ENABLED: "true"
注意事项
- 数据不丢:
./data、./logs、./backups三个目录必须挂载,升级只docker compose pull && up -d,数据原地保留。 - 改端口:
.env里设WEB_PORT=9000。 - 无需本地构建:镜像已发布在腾讯云仓库
jpccr.ccs.tencentyun.com/jinghui/tangzhuan-yu(国内拉取快),docker pull即用——NAS / 低配设备(飞牛 fnOS、群晖、威联通)也不用跑npm ci,不会打满 CPU。 - 不要用上游预构建镜像(
ghcr.io/23star/xianyu-super-butler):那是原版,不含本仓库的热卖榜 / 价格监控 / 一键转卖 / 同行热卖店铺等新功能,请用上面的腾讯云镜像。 - 健康检查:容器内置
HEALTHCHECK,探测http://localhost:8080/health;API 文档/docs。
方式三:源码运行(开发调试)
需要 Python 3.11+、Node.js 20+(Gitea 主仓:https://gitea.88531.cn/jinghui/tangzhuan-yu,Gitee 镜像:https://gitee.com/jinghui111/tangzhuan-yu,两处同步):
git clone https://gitea.88531.cn/jinghui/tangzhuan-yu.git # 或从 Gitee 克隆
cd tangzhuan-yu
python -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
playwright install chromium
cd frontend && npm ci && npm run build && cd .. # 前端产物输出到 ../static
python Start.py
🚀 首次使用引导(部署后照着走)
- 登录:打开
http://服务器IP:8080,默认admin / admin123→ 进「系统设置 → 修改登录密码」立即改掉。 - 接入闲鱼账号:「账号管理 → 添加账号」扫码登录(或 Cookie 方式);逐账号开启监听、自动确认收货。
- 同步商品:「商品与发货」拉取在售商品,逐个绑定卡密 / 发货内容(支持多规格、多数量),发货前有风险拦截。
- 配置自动回复:「自动回复」设关键词命中 + 默认回复;再开「AI 回复」,选 OpenAI 协议模型(没 token 就点页面里的「免费领取」去 https://ai.88531.cn 领),设好最低价与议价轮数。
- 让 AI 接住闲聊:买家问「在吗 / 能便宜吗 / 怎么用」由模型应答,价格永远不越你设的底线。
- 开始经营:
- 「实时热卖榜」看什么最好卖 → 「一键转卖」把品铺到自己店铺;
- 「同行热卖店铺」看同类型销量最好的 50 家同行(相似度 / 参考价值 / AI 一键分析先学谁);
- 「价格监控」给目标品设关键词与目标价,低于目标价自动通知你补货 / 调价;
- 「订单管理」拉取历史订单看营收,「买家互动」确认收货后自动评价致谢。
- 看数据:回「总览」,成交额、订单、商品销量排行一屏掌握。
🔁 更新
docker compose pull && docker compose up -d # 拉最新腾讯云镜像,数据在 ./data 升级不丢
# docker run 方式: docker pull jpccr.ccs.tencentyun.com/jinghui/tangzhuan-yu:latest && docker rm -f xianyu-butler && 重跑上面的 docker run 命令
逐版本改动见 CHANGELOG.md。
🙏 致谢与协议
- 原项目:23Star/xianyu-super-butler(原名闲鱼智控 / 闲鱼超级管家),本仓库在其基础上二次开发并重构管理端、账号监听、商品同步、订单处理和发货规则;更早的上游是 zhinianboke/xianyu-auto-reply。感谢原作者的开源工作。
- 原版 README 完整保留于 README.upstream.md(含原作者的部署说明、SaaS 版本、交流群与 PR 征集信息)。
- 协议:GNU AGPL-3.0。修改、部署或通过网络提供服务时,请遵守 AGPL-3.0 的源代码公开义务;本项目仅供学习、研究和合法自动化使用,使用者应遵守法律法规及平台规则并自行承担使用风险。
本版本维护:jinghui · 体验站 https://tzy.88531.cn · 问题反馈请提 Issue。





