一文读懂Ydisks闲鱼助手:Go+React闲鱼多账号自动发货与消息回复系统全解析

原创2026-10-10 14:26:381,852 阅读
文章标签:电商后端前端AI 应用即时通讯工作流自动化

一文读懂Ydisks闲鱼助手:Go+React闲鱼多账号自动发货与消息回复系统全解析

Ydisks闲鱼助手是一个基于 Go + React 构建的闲鱼多账号自动发货与消息回复系统,它将多账号管理、在线聊天、订单管理、卡密库存、自动化规则、AI 客服回复和异常通知整合到同一个 Web 管理后台,适合需要同时维护多个闲鱼账号、交付虚拟商品的个人卖家和小型团队。

⚠️ 先说风险:本项目是社区维护的非官方自托管工具,未获得闲鱼/阿里巴巴官方授权,调用的是闲鱼网页端非公开接口,使用可能违反平台用户协议并触发账号风控。请仅在合规前提下用于个人技术学习与自有账号的自托管管理,后果由使用者自行承担。

一、它能帮你做什么?:闲鱼多账号运营核心能力

Ydisks闲鱼助手多账号管理界面

从账号管理界面可以看到,每个闲鱼账号都有自己的在线状态和自动化标签(如"自动评价""每日擦亮""自动确认发货"),右侧提供刷新资料、重新扫码、编辑、启停等操作。系统覆盖的日常能力包括:

模块 核心能力
📱 账号管理 多账号启停、扫码登录、在线状态、登录审计、凭证自动续期
💬 即时消息 按账号隔离的在线聊天、历史消息、文本/图片/表情收发、关键词回复
🚀 自动化中心 拍下未付款自动改价、付款后自动发货、砍价免拼、评价后送赠品、超时求评价
📦 卡密库存 文本/批量卡密/图片/API 四种交付类型,库存追加、批量导入、延迟发送
🏷️ 商品与订单 商品同步与发布、CSV/XLSX 表格批量铺货、订单同步与补发卡密
🤖 AI 回复 接入 OpenAI 兼容 API,可控提示词、议价轮次与让价范围
🔔 通知告警 Bark、钉钉、飞书、企业微信、Telegram、邮件和自定义 Webhook
🗄️ 数据存储 SQLite、MySQL、PostgreSQL 三选一,启动时自动执行数据库迁移

对虚拟商品卖家来说,最有价值的一条链路是:买家付款 → 系统自动匹配商品与卡密组 → 自动发送卡密 → 自动确认发货,全程无需人工盯盘。

二、系统架构速览:Go 后端 + React 管理后台

整体架构很清晰:React 管理后台通过 HTTP API 与 Go 后端通信,Go 后端同时承担闲鱼 WebSocket 消息长连接、MTOP 请求、自动化调度和数据持久化。

  • internal/xianyu/:闲鱼登录协议、Cookie、MTOP 与 WebSocket 消息协议
  • internal/engine/:单账号生命周期、消息处理与回复交付行为
  • internal/automation/:发货、评价赠品、求评价与任务调度中心
  • internal/browser/:Chromium 自动化(Playwright),处理浏览器指纹与 token 滑块
  • internal/db/:多数据库访问、敏感字段加密与嵌入式迁移
  • frontend/:React + TypeScript + Vite 管理后台,构建后通过 //go:embed 嵌入 Go 服务

完整架构说明见 README.zh-CN.md 中的系统架构章节。

这种"Go 负责协议与业务、React 负责可视化操作"的分工,让系统既有服务端级的稳定性(长连接、调度、幂等检查点),又有现代 Web 界面的易用性。

三、快速上手:三种部署方式任选

方式一:Docker Compose(推荐)

一键拉起 PostgreSQL 17 + 应用 + Chromium,支持 amd64/arm64 多架构镜像:

git clone https://gitcode.com/gh_mirrors/yd/Ydisks-Xianyu-Helper
cd Ydisks-Xianyu-Helper
cp .env.example .env
# 编辑 .env:设置 POSTGRES_*、XIANYU_DATA_KEY、XIANYU_ADMIN_PASSWORD
docker compose up -d

配置样例见 compose.yml,部署细节见 部署与数据库手册。

方式二:源码运行(最快体验)

环境要求 Go 1.26+ 与 Node.js 24。默认使用 SQLite,无需额外数据库服务:

npm --prefix frontend ci && npm --prefix frontend run build
go run ./cmd/server -db data/xianyu_data.db -addr :59188

方式三:桌面端安装包

Windows / macOS / Linux 均有独立安装包,内置匹配架构的 Playwright Chromium,安装后无需再下载浏览器。Windows 注册系统服务 + 托盘控制器,macOS 注册 LaunchAgent + 菜单栏程序,Linux 通过 install.sh 安装 systemd 服务。

三种方式启动后,浏览器访问 http://localhost:59188,首次打开页面按提示设置管理员密码(用户名 admin)即可进入后台。

四、接入第一个闲鱼账号:扫码三步走

  1. 登录后台,进入"账号管理",点击"扫码添加新账号"
  2. 用闲鱼 App 扫描二维码,如触发风控则按提示完成人脸/安全验证
  3. 等待账号状态变为"在线",填写备注并同步商品与订单

详细操作步骤见 账号管理手册。两个实用建议:

  • ✅ 多账号务必填写备注,方便区分与通知归属
  • ⚠️ 有账号登录时不要频繁重启程序——每次重启都会向闲鱼申请登录凭证,频率过高会触发风控

五、自动发货自动化中心:四类触发规则全覆盖

Ydisks闲鱼助手自动发货规则配置界面

"自动化规则"页面提供四类开箱即用的交易自动化模板,选模板 → 选账号和商品 → 配置动作即可:

触发器 触发时机 标准动作
💰 拍下未付款自动改价 买家拍下未付款 匹配商品/规格 → 改为目标价格 → 可选发送提醒
📦 付款后自动发货 收到付款系统卡片 发送卡密 → 按开关自动确认发货
🎁 评价后发送赠品 收到评价系统卡片 发送赠品卡密(建议独立卡密组)
⏰ 超时未评价求评价 定时扫描已发货订单 到达等待时间 → 发送求评价文案

这套调度链路的可靠性设计值得一提:任务有幂等检查点、失败可恢复、付款消息丢失时有每分钟一次的兜底扫描补触发,且补发类动作只放行平台侧幂等的收尾操作,避免重复发卡。相关实现位于 internal/automation/,异常与补发说明见 自动化发货与回复手册。

六、在线聊天 + AI 客服:消息回复的三级链路

Ydisks闲鱼助手在线聊天消息回复界面

在线聊天页面复用闲鱼官方账号连接,消息按账号完全隔离,支持会话列表、历史消息、文本/表情/图片收发,官方交易卡片和"闲小蜜"消息会以系统消息形式展示,不干扰普通聊天流。

买家普通消息按以下链路处理,逐级兜底:

  1. 关键词回复:精确关键词命中,回复文本或图片
  2. AI 回复:接入 OpenAI 兼容 API(OpenAI、通义千问、Ollama、vLLM 均可),专门处理砍价场景,可设置最大折扣比例、最大让价金额和最多议价轮次
  3. 默认回复:最后一级兜底,可设置"同一会话仅回复一次"

AI 设置入口在"系统与AI",系统级 API 配置完成后,再到每个账号单独开启。完整流程见 AI、通知与运维手册。

七、通知告警与日常巡检

自动化任务进入"完成 / 失败 / 需人工核对"状态时,会推送到绑定的通知渠道:Bark、钉钉、飞书、企业微信、Telegram、邮件和自定义 Webhook。掉线、安全验证、续期失败等账号事件同样可以通知。

日常巡检只看"仪表盘"就够了:累计营收、活跃账号、订单数、库存余量、营收趋势与商品销量排行,支持按今天/7天/自定义时间范围统计,方便每天巡店和大促前检查。

八、安全建议:上线前必读

  • 🔑 XIANYU_DATA_KEY 用于 AES-256-GCM 加密 Cookie、密码、API Key 等敏感字段,务必固定并离线备份——更换密钥后旧数据将无法解密
  • 🔒 公网部署用反向代理终止 TLS 并限制管理端口访问,启用 -secure 保护会话 Cookie
  • 💾 升级或换机前先备份数据库和 .env,恢复时密钥必须一致
  • 🚫 不要把 Cookie、二维码、验证链接分享给任何第三方

更多安全与运维细节见 README.zh-CN.md 的"安全建议"章节。

九、写在最后:项目文档与源码入口

资料 路径
中文 Wiki 总目录 docs/wiki/Home.zh-CN.md
批量铺货使用文档 docs/批量铺货使用文档.md
API 契约定义 api/openapi.yaml
主服务入口 cmd/server/main.go
前端源码 frontend/
数据库迁移脚本 internal/db/migrations/

一句话总结:Ydisks闲鱼助手用 Go 承担了闲鱼协议层最"脏"的部分(登录、续期、消息长连接、自动化调度),用 React 提供了直观的管理界面,把多账号闲鱼运营中的消息回复、自动发货、库存交付变成了一条可配置、可恢复、可通知的自动化流水线。如果你正在管理多个闲鱼账号或交付虚拟商品,值得部署一个测试账号实际体验。

登录后查看全文
Ydisks-Xianyu-Helper