
Ydisks 闲鱼助手 Ydisks-Xianyu-Helper 是一款面向闲鱼卖家的自托管管理系统,适合需要同时维护多个闲鱼账号、或交付虚拟商品的个人与小型团队。

场景痛点:做闲鱼的人多了,账号也就不止一个。卖数字商品的,还要盯着付款、发卡密、回消息、求评价——来回切网页和 App,人就成了客服机器人。
技术上,登录、Cookie 续期、MTOP 请求和 WebSocket 消息链路全部由 Go 实现;只有必须依赖浏览器环境的滑块风控,才交给内置的 Chromium(Playwright)处理。
需要先说明的边界:这是社区维护的非官方工具,与闲鱼、阿里巴巴集团无隶属关系。自动化能力可能触发平台风控,README 特别警告——有账号登录时不要频繁重启程序,每次重启都会向闲鱼申请登录凭证,达到频率就会触发风控。

功能特点
账号与凭证:多账号放心挂
- 账号管理:多账号启停、扫码/密码登录、资料刷新、在线状态、登录审计与备注管理
- 凭证续期:Cookie/token 定时续期、WebSocket 凭证更新、失效自动恢复、冷却与失败停用
- 扫码登录是推荐方式;密码登录更容易触发平台安全校验
消息与客服:一个人顶一个客服组
- 在线聊天:按账号隔离的会话列表与历史消息,支持闲鱼表情、文本/图片收发;官方交易卡片和闲小蜜消息以系统消息显示,不会混进普通用户回复链
- 关键词回复 + 默认回复,可设置「仅回复一次」
- AI 回复:接入 OpenAI 兼容接口(OpenAI、通义千问、Ollama、vLLM、LocalAI 等),自定义提示词,还能控制议价轮次和让价范围——AI 帮你谈判,把底线焊死

自动化中心:付款即发货,好评自己来
- 付款后自动发货、评价后赠品、超时未评价提醒,失败任务自动恢复并带幂等检查点
- 最新版本还新增拍下未付款自动改价
- 账号自动任务:按账号持续扫描待评价订单并统一好评、按北京时间每日擦亮,可手动立即执行,全部带执行记录与幂等保护
商品与订单:从铺货到交付一条龙
- 卡密库存:文本、批量卡密、图片三种交付类型,支持库存追加、批量导入、规格与延迟发送
- 商品管理:商品同步、单商品发布、CSV + ZIP 批量铺货;类目优先级为「表格当前行指定类目 > 上传页关键词获取的默认类目 > 闲鱼自动识别 > “电子资料”最终兜底」,模板类目字段可全部留空
- 订单管理:订单同步/插入/编辑、平台发货、补发卡密、仅确认发货及异常状态处理

数据与通知
- 数据看板:活跃账号、订单、营收、库存、商品销量与金额统计
- 通知告警:Bark、钉钉、飞书、企业微信、Telegram、邮件和自定义 Webhook——账号掉线、风控、续期、发货结果都能第一时间知道
安全与部署
- 安全能力:管理端会话、敏感字段 AES-256-GCM 加密(Cookie、密码、令牌、AI/SMTP 密钥等)、日志脱敏、出站地址校验
- 数据存储:SQLite / MySQL / PostgreSQL 三选一,内置按方言执行的 Goose 数据库迁移
- 三种部署方式:Docker Compose(推荐,PostgreSQL 17 + 多架构镜像一键起)、源码运行(Go 1.26 + Node 24)、桌面端安装包(Windows Service + 托盘 / macOS LaunchAgent + 菜单栏 / Linux systemd,Chromium 随包内置免下载)

另外,如果你用网盘资料、教程包做闲鱼推广,官方还推荐搭配 Ydisks网盘拉新助手 使用:前者负责短链投放与 PV/UV 复盘,它负责承接消息、订单和自动发货,形成一套完整的运营闭环。


上手教程
推荐路线:Docker Compose 部署
编辑 .env,至少设置四个关键项:POSTGRES_PASSWORD(可用 openssl rand -hex 24 生成)、DATABASE_URL(含 URL 编码后的密码)、XIANYU_DATA_KEY(敏感字段加密主密钥,openssl rand -base64 48 生成,必须长期固定并备份)、XIANYU_ADMIN_PASSWORD。
浏览器访问 http://localhost:59188,用用户名 admin 和 .env 中的管理员密码登录。
首次使用九步走
1. 登录后台 → 2. 进入「账号管理」,用闲鱼 App 扫码授权 → 3. 如触发风控,按提示在手机端完成人脸/安全验证 → 4. 等账号状态变「在线」,同步商品和订单 → 5. 在「卡密库存」创建交付内容 → 6. 在「自动化规则」把商品与卡密、规格、触发条件关联 → 7. 在「在线聊天」按账号收发消息 → 8. 配置自动评价文案与每日擦亮时间(先小号验证再启用)→ 9. 按需配置关键词回复、AI 回复和通知渠道。
桌面端首次启动会自动注册后台服务(Windows 装完托盘控制不再弹 UAC),打开 http://127.0.0.1:59188 设置管理员密码即可。无浏览器环境可用 -no-browser 启动,但滑块风控处理不可用,不建议用于生产。

我的使用感受
最直观的感受是「闲鱼生意第一次有了后台」:多账号在线状态、付款自动发卡密、AI 先接第一轮议价,人只需要在关键节点点头——「自动化中心带幂等检查点」和「批量铺货四级类目兜底」这两个设计看得出作者是真的做过数字商品生意,不是为炫技写的 demo。
但也要说实话:第一,它是自动化工具,触发平台风控的风险由使用者承担,README 里那句「不要频繁重启」的警告请务必当真;第二,部署门槛不低,Docker 或源码二选一,桌面端安装包依赖签名证书,仓库当前未配置正式签名时 Windows/macOS 正式发布会停在签名步骤;第三,凭证加密主密钥一旦丢失,历史加密数据就无法解密,运维上需要把它和数据库备份放在一起管理。整体适合有自托管能力的卖家,纯小白建议从 Docker 路线开始。
官方网站
https://github.com/Christ9038/Ydisks-Xianyu-Helper
下载地址
https://pan.quark.cn/s/48362761d571







