闲鱼自动回复系统：让二手交易商家真正「躺赚」的自动化引擎

深夜11点，你躺在床上准备睡觉，手机却不断震动——闲鱼上有买家在问价、有订单等待发货、有人下了单还没付款。这些琐碎的客服工作，是每一个闲鱼卖家共同的痛。而现在，有人为你把这一切自动化了。

闲鱼自动回复系统（GitHub: zhinianboke/xianyu-auto-reply）是目前 GitHub 上最受欢迎的闲鱼自动化开源项目，斩获超过 5700 颗 star、1500+ fork，被大量二手商家和自由职业者用于提升运营效率。系统通过 WebSocket 直连闲鱼服务器，实现多账号自动回复、AI 智能客服、自动发货、订单评价等全链路自动化。

背景：二手经济崛起，运营效率成为核心瓶颈

近年来，以闲鱼为代表的二手交易平台快速增长，大量个人商家涌入。但与专业电商不同，闲鱼卖家大多是兼职经营，没有专职客服团队。一位典型的闲鱼卖家，可能同时在卖虚拟商品、管理多个账号、还要处理买家的各种咨询——手动操作效率极低，消息回复延迟还会直接影响成交率。

在这样的背景下，社区开发者「zhi哥」（zhinianboke）动手写了这个系统。项目最早发布于 2024 年，随后快速迭代，截至目前已演进为一套包含 6 个微服务模块、功能覆盖客服全流程的完整系统。该项目在 Twitter/X 上获得了数万次浏览，腾讯云开发者社区也有专门部署教程，被广泛认为是闲鱼自动化领域的标杆开源项目。

图1：项目配套的微信交流群

核心功能：从「被动响应」到「主动出击」

1. 多账号统一管理

系统支持同时登录管理多个闲鱼账号，每个账号独立维护 Cookie、会话状态和登录续期。商家可以在一个后台界面上切换账号、查看各账号状态、批量操作——这对于同时经营多个垂直品类（如同时卖游戏账号和数码配件）的卖家尤为重要。账号管理与 Windows 桌面启动器（通过 Nuitka 打包为 EXE）集成，Windows 用户无需安装 Python 环境即可使用。

2. 自动回复：规则引擎 + AI 双轨制

系统的自动回复模块支持四种策略：

• 关键词匹配：买家的消息命中关键词后，自动发送预设回复内容。关键词可以是纯文本，也可以包含图片链接。
• 默认回复：没有命中任何关键词时，触发兜底回复，避免冷场。
• 商品专属回复：针对特定商品设置专属回复话术，适合高客单价商品精细化运营。
• AI 智能回复：接入大模型 API（如 Claude、OpenAI 等），根据对话上下文生成拟人化回复，支持多轮对话。

这四种策略可以叠加使用——AI 回复作为兜底，关键词匹配处理高频问题，商品专属回复覆盖重点商品。整个规则配置通过 Web UI 完成，无需编写代码。

3. 自动发货：虚拟商品的「无人值守」交付

对于虚拟商品卖家，自动发货是核心刚需。系统支持卡券类虚拟商品自动发货：当买家付款后，系统自动将卡密/券码发送给买家，无需人工介入。系统还支持自动补发（发货失败后自动重试）、发货结果记录和日志追踪，确保每一笔订单都有据可查。

4. 闲鱼商品采集与分销

系统内置商品采集模块，可以从闲鱼平台抓取商品信息，建立自己的货源库。通过对接记录和结算链路，卖家可以将他人商品加价后上架自己的店铺，实现「无货源」分销模式——这一功能在夸克网盘、教程类虚拟商品等垂直领域尤为流行。

5. WebSocket 实时消息通道

整个系统的实时性依赖于独立的 WebSocket 服务（端口 8090）。该服务维持与闲鱼服务器的持久连接，实时接收买家消息、订单通知、风控预警，并通过 WebSocket 推送给前端 UI。消息收发、会话列表、聊天联动都在这一层处理，是系统最核心的实时引擎。

技术架构：微服务拆分的企业级架构

项目采用前后端分离 + 后端多服务微服务架构，后端由 4 个独立进程组成，通过内部 HTTP 调用协作：

服务	端口	技术栈	职责
frontend	9000	React 18 + TS + TailwindCSS + Zustand	管理界面、状态管理
backend-web	8089	FastAPI + SQLAlchemy 2.0 + MySQL	业务 API 网关
websocket	8090	Python asyncio	闲鱼实时连接、消息收发
scheduler	8091	APScheduler	定时任务（发货/评价/Cookie刷新）
promotion/backend	8092	FastAPI	返佣子系统 API
promotion/frontend	9001	React + TS	返佣子系统 UI

图2：项目配套的 QQ 技术交流群

数据层采用 MySQL 8.0 存储业务数据（账号、订单、商品、规则配置），Redis 7 提供缓存、会话管理和任务队列。数据库连接池最大 300 连接，字符集 utf8mb4，完整支持表情符号和 emoji。

Playwright 在系统中扮演关键角色——不仅用于浏览器自动化登录、Cookie 刷新，还用于闲鱼商品发布（通过浏览器操作模拟人工发布），这使得系统可以在不依赖闲鱼官方 API 的情况下完成大部分操作。系统还集成了 QR Code 生成（qrcode.react）、数据可视化（Recharts）、动画效果（Framer Motion）等现代化前端组件，提供流畅的用户体验。

common/ 模块被主系统和返佣子系统共同依赖，提供了数据库模型（SQLAlchemy models）、API schemas（Pydantic）、公共服务和工具函数，是整个项目的共享基础设施。

部署体验：两条腿走路

项目在部署设计上非常贴心，为不同用户准备了多种方案：

方案一（推荐）：服务器一键部署

只需一行命令，服务器自动完成镜像拉取、容器启动、配置生成：

curl -fsSL https://xy-update.zhinianboke.com/deploy.sh | sed 's/\r$//' | bash

该脚本会自动从阿里云镜像仓库拉取预构建镜像，首次运行生成 .env 配置文件和 docker-compose.deploy.yml，无需手动配置 MySQL/Redis——它们作为 Docker 容器一同启动。部署完成后访问 http://服务器IP:9000，默认账号 admin / admin123。

方案二：源码克隆 + Docker Compose 本地构建

git clone https://github.com/zhinianboke/xianyu-auto-reply.git
cd xianyu-auto-reply
docker-compose up -d --build

源码构建模式下，所有服务均从 Dockerfile 重新构建，适合需要深度定制或研究源码的开发者。backend-web 服务使用 Python 3.11-slim 镜像，安装 Playwright + Chromium 浏览器环境，并配置了清华 pip 镜像源和阿里云 apt 镜像源——在中国大陆网络环境下构建速度更有保障。

方案三：Windows 桌面 EXE

项目提供 Nuitka 打包的 Windows EXE 启动器，适合不懂 Docker 的小白用户。EXE 内置所有运行环境，双击即用。

硬件需求方面，系统不需要 GPU，普通 2 核 4GB 的 VPS 即可流畅运行，10GB 磁盘空间足够。

图3：项目配套的 Telegram 交流群

争议与局限：自动化背后的平台规则风险

任何自动化工具都需要直面平台规则这个核心问题。闲鱼官方对自动化行为有明确的限制政策，大量高频操作或异常行为模式可能触发风控，轻则账号警告，重则封禁。项目 README 中也提到系统提供了「风控日志」和「系统反馈」模块，帮助用户监控异常。

从技术角度看，项目通过 Playwright 模拟真人操作（而非直接调用 API）来降低被识别风险，这是一种「以慢搏稳」的策略——牺牲部分效率换取更高的存活率。但对于日处理订单量大的商家，这种方式的瓶颈也比较明显。

此外，系统依赖 Cookie 有效期维护登录状态，Cookie 过期后需要重新扫码授权。目前这个操作需要用户手动在浏览器中完成，虽然有 Web UI 支持，但自动化程度仍有提升空间。

行业意义：开源工具填补垂直平台自动化空白

闲鱼自动回复系统的出现，填补了中文二手交易平台自动化工具的开源空白。与淘宝、京东等电商平台拥有成熟官方开放平台不同，闲鱼长期缺乏稳定的第三方自动化支持。该项目通过模拟浏览器操作的方式，绕过官方 API 缺失的限制，实现了从消息处理到商品发布的完整覆盖。

项目的高 star 数（5700+）和活跃社区（微信群、QQ群、Telegram群、公众号均有大量活跃用户）说明市场需求真实存在。对于有技术能力的商家，这是一套值得深入研究的自动化基础设施；对于普通用户，Docker 一键部署降低了使用门槛，让更多非技术卖家也能享受自动化红利。