Ydisks-Xianyu-Helper
Christ9038/Ydisks-Xianyu-Helper加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
加载项目详情…
本应用为开源项目,仅供学习研究,请遵守其开源协议。
对于在闲鱼上同时运营多个账号的卖家而言,"消息回不过来"、"手动发货太累"、"商品太多根本管不住"——这三个痛点几乎伴随着每一次业务扩张而来。尤其当你每天要处理几十笔订单、同时在十几个账号间切换回复时,人工操作已经触及效率天花板。
Ydisks 闲鱼助手(Christ9038/Ydisks-Xianyu-Helper)正是在这一背景下诞生的自托管管理系统。它将多账号运营、即时消息、AI 回复、自动发货、商品管理、数据统计和告警通知全部整合进一个 Web 管理后台,用技术手段把闲鱼卖家的日常重复劳动降到最低。GitHub 星标 1600+,Fork 数超过 500,是目前闲鱼辅助工具中社区活跃度最高的开源项目之一。
图 1:账号管理界面,支持多账号启停、扫码登录与在线状态监控
闲鱼是阿里巴巴旗下的二手交易平台,聚集了超过 5 亿注册用户,其中相当比例是专职卖家或副业创业者。与淘宝、拼多多等平台不同,闲鱼的账号体系相对宽松,一个人可以注册多个账号,这让"多账号矩阵运营"成为许多卖家的标准打法——用不同账号覆盖不同品类、针对不同受众、或实现渠道隔离。
然而,多账号运营带来的管理复杂度呈指数级增长。每个账号的登录状态需要单独维护,消息需要在不同界面间来回切换,订单发货更是需要逐个操作。当账号数量从 3 个扩展到 10 个甚至更多时,"在正确的时间把正确的东西发给正确的买家"这件看似简单的事,开始变得几乎不可能靠人工完成。
项目作者 Christ9038 显然是这个场景的深度参与者。从项目的命名"Ydisks"和配套产品"网盘拉新助手"可以看出,这个工具链最初是为数字资源类卖家(销售网盘资料、兑换码、虚拟商品等)量身打造的。这类产品天然适合自动化:付款后立即交付,无需物流,发货延迟一分钟就会收到买家的催促消息。压力催生了解决方案,Ydisks 闲鱼助手由此而来。
这是整个系统的地基。用户可以在一个界面内管理所有闲鱼账号的登录状态,扫码登录后,系统自动维护 Cookie 和 Token 续期,无需手动刷新。一旦某个账号凭证失效,系统会触发告警并按预设策略处理(冷却等待或停止账号),保证整体稳定性不受单点故障拖累。
闲鱼买卖双方通过平台内置 IM 沟通,Ydisks 将分散在各个账号的消息统一接入管理后台。用户可以在一个页面内按账号隔离查看会话列表、读取历史消息、发送文字和图片,并支持闲鱼原生表情。这对于需要快速响应买家咨询的卖家而言,省去了频繁切换 App 的操作成本。
系统还内置了关键词回复和默认回复功能:当消息匹配预设关键词时,自动触发对应回复内容;无匹配时使用默认回复;"仅回复一次"模式确保同一个买家不会收到重复消息。这些规则组合起来,足以应对大部分常规咨询场景。
图 2:即时消息界面,支持会话隔离、表情和图片收发
自动化发货是这个工具最核心的价值所在。对于销售虚拟商品(兑换码、下载链接、图片等)的卖家,每次"买家付款→复制卡密→粘贴发送"的三步操作看似简单,但日积月累就是巨大的时间消耗。Ydisks 的自动化中心将这套流程彻底自动化:
图 3:自动化中心,配置发货规则、议价策略和评价赠品逻辑
这是近年来新增的进阶功能。系统支持接入任意 OpenAI 兼容 API(官方支持的 SDK 是 go-openai),配置模型、自定义提示词,并控制议价轮次和让价范围。买家发送消息后,AI 根据提示词生成回复草稿,再由卖家确认或直接自动发送。这套流程在兼顾拟人化沟通的同时,大幅减少了卖家的文字回复工作量。
特别值得注意的是,项目的 AI 回复功能做了"议价轮次控制"——在闲鱼这个以砍价文化著称的平台上,AI 需要知道"让到第几轮就该收手了",否则无限让步会导致卖家利益受损。这种细节设计体现了项目对真实业务场景的理解。
商品同步支持单商品单规格和多规格发布,还可以通过 CSV/XLSX/TSX 文件进行批量铺货。系统内置了逐行类目识别逻辑,会根据商品标题关键词自动匹配闲鱼分类,同时保留"电子资料"等默认兜底类目。规格图片可以单独上传并控制排序,覆盖了闲鱼卖家在商品侧的核心需求。
管理后台提供活跃账号数、订单量、营收、库存余量、商品销量等关键指标的可视化看板。告警渠道支持 Bark、钉钉、飞书、企业微信、Telegram、邮件和自定义 Webhook,覆盖了国内主流通知生态,基本不需要额外配置就能接入现有的运营流程。
项目采用 Go 后端 + React 前端 的经典分离架构,技术选型务实,没有过度设计。
后端(Go) 核心依赖:
chi/v5:轻量级 HTTP 路由框架,性能好且零外部依赖jackc/pgx:PostgreSQL 驱动,支持 SQLite/MySQL/PostgreSQL 三种数据库方言mxschmitt/playwright-go:通过 Playwright 控制 Chromium 浏览器,完成闲鱼登录和部分需要浏览器环境的操作go-openai:接入 OpenAI 兼容 API 实现 AI 回复coder/websocket:建立与闲鱼服务器的 WebSocket 连接,实时接收消息推送pressly/goose:数据库迁移管理前端(React) 技术栈:
.test.ts/.test.tsx 文件,说明测试覆盖率意识很强)//go:embed 直接嵌入二进制,部署极为简单架构亮点:
Engine)设计,每个账号独立运行、互不干扰Automation 模块与 Engine 解耦,自动化逻辑以事件驱动方式与核心引擎协作代码质量方面,项目包含 .golangci.yml 配置了多种 linter 规则,前端每个功能模块都有对应的 .test.ts 文件,在同类项目中属于相当规范的开发实践。
项目提供了 docker-compose.yml,一条命令启动 PostgreSQL + 应用容器。配置项精简到 5 个(数据库连接、管理员密码、数据加密密钥等),使用 openssl rand 生成高强度随机值即可。容器镜像托管在 GHCR,支持 amd64 和 arm64 两种架构,覆盖了大多数服务器和开发机环境。
git clone https://github.com/Christ9038/Ydisks-Xianyu-Helper.git
cd Ydisks-Xianyu-Helper
cp .env.example .env
# 编辑 .env 填入必要配置
docker compose up -d
# 访问 http://localhost:59188
需要 Go 1.26+、Node.js 24,手动构建前端并嵌入 Go 二进制。相比 Docker 方式,这条路径适合需要二次开发或深度定制的用户。项目有 Makefile,包含了常用构建命令。
Windows 和 macOS 提供独立安装包,内置 Playwright driver 与 Chromium runtime,安装后以系统服务(Windows)或菜单栏应用(macOS)方式运行。Linux 用户主要通过 Docker 或源码部署。
这是最重要的部分,也是所有介绍这个项目的文章都应该明确指出的:
闲鱼官方从未授权任何第三方工具。 这个项目通过非公开的闲鱼接口(MTOP 协议、WebSocket 消息链路)与平台通信。项目的 README 用了整整一段加粗字体警告用户:
本项目调用闲鱼网页端非公开接口,使用本软件将违反闲鱼用户协议,可能造成闲鱼账号封禁。
这不是走过场的免责声明。从技术原理上讲,所有基于 Cookie/Token 的自动化操作都存在被平台风控系统检测的风险。闲鱼的安全团队在持续升级检测手段,而项目作者也在不断更新绕过逻辑(如浏览器指纹读取、滑块验证处理等)。但这是一场持续的猫鼠游戏,没有绝对安全的方案。
实际影响层面:风险程度与使用频率成正相关。偶尔用于辅助管理的账号,与每天自动处理数百条消息的账号,被封禁的概率差距悬殊。此外,账号被封禁后,闲鱼一般不会给出具体原因,也难以申诉。
除此之外的项目局限:
从 Star 增长曲线看,这个项目在 2026 年初进入快速增长期,恰好对应了"闲鱼无货源玩法"在各大内容平台被广泛讨论的时间窗口。数字资源类卖家(销售课程、资料、模板、兑换码)是这个工具的核心用户群,他们对"虚拟商品自动发货"的需求最为强烈。
值得关注的是,作者并没有止步于"自动发货"这个单一功能,而是逐步将工具扩展为一个完整的卖家运营平台——整合了 Ydisks 网盘拉新助手的数据追踪能力,试图打通"推广投放→引流转化→消息承接→订单发货→数据复盘"的完整链路。这条路如果能走通,意味着项目从"效率工具"升级为"运营平台",想象空间会大得多。
Ydisks 闲鱼助手是目前 GitHub 上功能最完整的闲鱼多账号管理开源工具。它用 Go 解决了闲鱼接口对接中最难啃的部分(MTOP 协议、登录验证、消息链路),用 React 提供了足够易用的 Web 管理界面,Docker 部署让技术门槛降到最低。对于在闲鱼从事数字商品销售的卖家,这个项目确实能带来显著的时间节省和效率提升。
但所有潜在的收益都需要与封号风险放在一起掂量。如果你决定使用,强烈建议先在备用账号上测试流程,确认稳定后再逐步迁移主力账号,并始终保持手动操作的备选能力。工具是手段,不是依赖——这个原则在任何依赖平台接口的自动化项目中都适用。