字节笔记本
2026年10月24日 · 约 9 分钟读完
闲鱼自动化管家：怎么用 AI 做 7×24 客服
428 赞的开源项目，让闲鱼卖家自动回复买家消息、自动发货、AI 智能议价。428 赞说明闲鱼卖家这个群体的自动化需求很大。
但这篇文章不是"教你用闲鱼自动化赚钱"。我们从技术架构视角拆，它怎么用 WebSocket 监听消息、怎么用 LLM 做智能议价、怎么自动发货。同时诚实标注合规风险。
一、它是什么
闲鱼超级管家（23Star/xianyu-super-butler）是基于 xianyu-auto-reply 的二次开发版。核心能力，让闲鱼店铺 7×24 自动运营：
- 自动回复，关键词匹配 + AI 智能议价
- 自动发货，卡券/虚拟商品自动发，支持多规格+延时
- 订单管理，批量刷新、状态更新、收货人管理
- 多账号，扫码/Cookie 登录多个闲鱼账号
- 滑块验证，声称 99% 成功率绕过闲鱼的滑块验证
技术栈：Python 3.11 + FastAPI + React 18 + SQLite + WebSocket + Docker
二、技术架构拆解
整体架构
闲鱼 App/网页
↕ (WebSocket 连接)
闲鱼超级管家
├── WebSocket 监听层（cookie_manager.py）
│ 监听闲鱼消息，用 Cookie 维持登录态
│
├── AI 回复引擎（ai_reply_engine.py）
│ 关键词匹配 + LLM 智能议价
│
├── 自动发货（order_status_handler.py）
│ 识别"已付款"→ 发卡券/链接 → 标记"已发货"
│
├── 订单查询（order_status_query_playwright.py）
│ Playwright 模拟浏览器查订单状态
│
├── 滑块验证（api_captcha_remote.py）
│ 远程验证码识别服务
│
├── FastAPI 后端（reply_server.py）
│ 管理 API + WebSocket 推送
│
└── React 前端
Dashboard / 订单管理 / 配置核心技术点
1. WebSocket 监听闲鱼消息
闲鱼的消息系统是基于 WebSocket 的。这个项目通过维护用户的 Cookie（登录态），建立 WebSocket 连接，实时监听新消息。技术上和前面讲的 mini Claude Code 的流式 WebSocket 是同一个东西，只不过方向反了，它是"当服务端"。
2. AI 智能议价（LLM 应用）
ai_reply_engine.py 的核心，买家说"便宜点"，AI 根据预设的折扣规则 + 商品信息生成回复。这是 LLM 在电商场景的实际应用，把"人工讨价还价"变成"AI 自动议价"。
3. Playwright 模拟浏览器
order_status_query_playwright.py 用 Playwright（无头浏览器）模拟登录闲鱼网页版，查询订单状态。这是因为闲鱼没有开放的订单 API，只能靠模拟浏览器操作。
4. 滑块验证码识别
闲鱼有滑块验证（防机器人）。这个项目集成了远程验证码识别服务（api_captcha_remote.py），声称 99% 成功率。这是自动化工具和反自动化的对抗，平台加验证码，工具绕验证码。
三、从 Agent 架构视角看
用前面《从 0 写 Agent》系列的视角拆，这其实是一个电商客服 Agent：
| Agent 组件 | 在闲鱼超级管家里 | 对应章节 |
|---|---|---|
| Agent 循环 | 监听消息→判断→回复/发货→循环 | 第 1 章 |
| Model（LLM） | AI 议价引擎 | 第 2 章 |
| Tool（工具） | 发卡券、查订单、更新状态 | 第 3 章 |
| Session（记忆） | 对话历史（每个买家的上下文） | 第 8 章 |
| Guardrails（护栏） | 关键词匹配（触发条件） | 第 14 章 |
| 错误回喂 | 发货失败→重试/通知 | 第 4 章 |
它是一个真实场景的 Agent，只不过不是写代码的 Agent，是做电商客服的 Agent。 架构理念完全一样，循环 + 工具 + 记忆 + 护栏。
四、和前面拆过的项目对照
| 维度 | 闲鱼超级管家 | 前面拆的 Agent |
|---|---|---|
| 领域 | 电商自动化 | 编程/分析/通用 |
| Agent 类型 | 客服+交易 Agent | 编码+数据分析 Agent |
| LLM 用途 | 智能议价+自动回复 | 写代码+分析+生成 |
| 工具 | 发货/查单/卡券 | read_file/edit_file/run_command |
| 风险 | 平台合规+交易纠纷 | 代码 bug（可控） |
| 开放性 | 闭源闲鱼平台 | 开放生态 |
架构相似，但风险不同，编程 Agent 出错改一下就行，电商 Agent 出错可能导致真实交易纠纷。
五、⚠️ 合规风险（诚实标注）
这类工具存在真实的合规和法律风险：
| 风险 | 说明 |
|---|---|
| 平台 ToS 违规 | 闲鱼用户协议通常禁止自动化操作，可能导致账号被封 |
| 滑块验证绕过 | 绕过平台的反机器人措施，法律上可能构成"未授权访问" |
| 交易纠纷 | AI 自动回复可能说错话（承诺不该承诺的），自动发货可能发错 |
| 买家权益 | 买家可能不知道自己在和 AI 聊天，知情权问题 |
| Cookie 安全 | 工具要存闲鱼 Cookie（等于你的登录态），泄露 = 账号被盗 |
技术上很有意思，但实际使用要自担风险。 这篇文章的技术分析不构成使用建议。
六、从技术学习角度的价值
抛开合规问题，这个项目的技术架构值得学习的几点：
1. WebSocket 消息监听，怎么用 Cookie 维持长连接，实时收消息。这个技术可以用在合法场景（自己的客服系统、自己的即时通讯）。
2. LLM 议价，把"人工讨价还价"编码成 LLM prompt + 规则。这个思路可以用在合法的电商客服（你自己的店铺、开放 API 的平台）。
3. Playwright 自动化，模拟浏览器查订单。同样可以用在合法场景（自动化测试、数据采集）。
4. Docker 一键部署，docker-compose + Nginx 反代，生产级部署。这个模式通用。
学架构不等于学用法，你可以从中学到"WebSocket+LLM+Playwright 的组合"，用在合规的场景。
七、小结
闲鱼超级管家是一个技术架构完整的电商客服 Agent，WebSocket 监听 + LLM 议价 + 自动发货 + 多账号管理。从 Agent 架构视角看，它和编程 Agent 是同一套理念（循环+工具+记忆+护栏），只是领域不同。
但从合规角度，它踩了闲鱼平台的红线，自动化操作 + 滑块绕过 + Cookie 存储，都有真实风险。技术学习可以，实际使用要自担风险。
本文基于 GOLD（@Honcia13）的 X 推文及 23Star/xianyu-super-butler 仓库源码技术分析。原文 https://x.com/Honcia13/status/2070874653367603600 ，仓库 https://github.com/23Star/xianyu-super-butler 。MIT 协议。
⚠️ 本文仅做技术架构分析，不构成使用建议。闲鱼自动化操作可能违反平台协议，使用前请了解风险。
推荐配合阅读：《从 0 写 Agent》系列，闲鱼超级管家的架构（循环+工具+记忆+护栏）和编程 Agent 完全一致，只是领域不同。
