README

Ydisks闲鱼助手（中文）

基于 Go 与 React 构建的闲鱼多账号管理、消息回复与自动发货系统






English README · 中文文档 · 中文 Wiki · English Wiki

功能特性 · 快速开始 · 配置说明 ·
Docker 部署 · 开发指南 · 贡献指南 ·
安全策略 · 行为准则 · 开源协议

操作手册见 在线使用手册（源文件为仓库内的 Wiki 文档）：包含数据库选择、账号接入、
在线聊天、账号自动任务、批量铺货、自动化发货、AI、通知和运维流程。

 [!IMPORTANT]
 本项目仅用于个人技术学习研究，未获得闲鱼/阿里巴巴任何官方授权。

 本项目调用闲鱼网页端非公开接口，使用本软件将违反闲鱼用户协议，可能造成闲鱼账号封禁。

 本项目是社区维护的非官方工具，与闲鱼、阿里巴巴集团及其关联公司无隶属、合作或授权关系。

 请仅在遵守当地法律法规的前提下使用，所有使用该代码造成的一切后果，全部由使用者自行承担，项目作者不承担任何责任。

 收到平台下架通知时，本项目会随时删除归档。

 有账号登录时，不要频繁重启本程序!

 每次重启都会向闲鱼申请登录凭证，达到某个频率，即会触发风控。

 项目简介

Ydisks闲鱼助手是一个面向闲鱼卖家的自托管管理系统。它将账号运行、即时消息、订单、
商品、卡密库存、自动化规则、AI 回复和异常通知整合到同一个 Web 管理后台，适合需要
同时维护多个闲鱼账号或交付虚拟商品的个人与小型团队。

项目采用 Go 语言实现闲鱼登录、Cookie 续期、MTOP 请求和 WebSocket 消息链路。
扫码登录、人脸验证流程、消息连接、凭证更新和绝大部分业务逻辑均由 Go 客户端完成。
使用 Chromium 处理必须依赖浏览器环境的相关功能。

 与 Ydisks 网盘拉新助手协同使用

如果你通过网盘资料、教程包或数字资源做闲鱼推广，推荐搭配
Ydisks 网盘拉新助手 使用：先为不同商品、渠道或推广账号
创建独立短链，再在 Ydisks 控制台查看短链与目标页面的 PV、UV、趋势、排行及渠道/账号报表。
这样，Ydisks 负责识别“链接从哪里带来访问与转化线索”，Ydisks闲鱼助手负责承接账号消息、
订单和自动发货，帮助你把投放复盘与日常交付放进一套更清晰的运营流程。

Ydisks 支持管理渠道、推广账号、原始链接、推广短链与域名，适用于网盘拉新和推广投放场景；
可从 Ydisks 网盘拉新助手使用文档 开始创建推广链接并查看数据。


 适用场景

- 多个闲鱼账号的统一在线状态与消息管理
- 数字商品、兑换码、链接或图片内容的自动交付
- 付款后发货、分阶段砍价免拼、评价赠品、超时求评价等自动化流程
- 商品与订单同步、单商品单规格/多规格发布、规格图片与主图排序，以及支持逐行/默认类目、自动识别和最终兜底的表格批量铺货
- 接入 OpenAI 兼容接口实现可控的 AI 客服回复，并可在后台测试完整连接链路

 交流群

!Ydisks闲鱼助TG

 功能特性

| 模块 | 能力 |
| --- | --- |
| 账号管理 | 多账号启停、扫码登录、资料刷新、在线状态、登录审计与备注管理 |
| 凭证续期 | Cookie/token 定时续期、WebSocket 凭证更新、失效恢复、冷却与失败停用 |
| 即时消息 | 按账号隔离的在线聊天、会话列表与历史消息、闲鱼表情、文本/图片收发、官方系统消息识别、关键词回复（多表达式、包含/正则匹配、多商品范围）、默认回复及仅回复一次 |
| 自动化中心 | 拍下未付款自动改价、付款后自动发货、分阶段砍价免拼、评价后赠品、超时未评价提醒、失败任务恢复、人工处理通知与幂等检查点 |
| 账号自动任务 | 基于本地记录的买家确认收货事实执行自动评价、按北京时间每日擦亮、手动立即执行、执行记录与幂等保护 |
| 卡密库存 | 文本、批量卡密、图片和 API 四种交付类型，库存追加、批量导入、规格与延迟发送 |
| 商品管理 | 商品同步、手工关联、单商品单规格/多规格发布、规格图片与商品图片排序、CSV/XLSX/TSV 与可选 ZIP 批量铺货、关键词获取默认类目、逐行类目优先、自动识别与“电子资料”最终兜底、任务恢复与结果导出；列表同步依据 detailParams.isSKU 判断多规格，字段缺失或为 false 均按非多规格处理，不再访问详情页 |
| 发货模板 | 多条顺序消息、订单/买家/卡密/自定义变量和可复用的自动化发货内容 |
| 订单管理 | 订单同步、编辑、平台发货、补发卡密、仅确认发货及异常状态处理 |
| AI 回复 | OpenAI 兼容 API、模型发现、完整连接链路测试、“仅砍价”与“全场景客服”模式、商品级启停与专属资料、自定义提示词、议价轮次和让价范围控制 |
| 数据看板 | 活跃账号、订单、营收、库存、商品销量与金额统计 |
| 通知告警 | Bark、钉钉、飞书、企业微信、Telegram、邮件和自定义 Webhook |
| 数据存储 | SQLite、MySQL、PostgreSQL，内置按方言执行的 Goose 数据库迁移 |
| 安全能力 | 管理端会话、敏感字段 AES-256-GCM 加密、日志脱敏和出站地址校验 |
| 容器部署 | PostgreSQL 17、健康检查、持久化卷、GHCR amd64/arm64 多架构镜像 |

 系统架构

mermaid
flowchart LR
    UI["React 管理后台"] -- API["Go / chi HTTP API"]
    API -- Store["SQLite / MySQL / PostgreSQL"]
    API -- Manager["账号管理器"]
    Manager -- Engine["单账号运行时"]
    Engine -- WS["闲鱼 WebSocket"]
    Engine -- MTOP["闲鱼 MTOP"]
    Engine -- Automation["自动化中心"]
    Automation -- Notify["通知渠道"]
    Engine -. "浏览器能力" .- Chromium["Playwright / Chromium"]


核心职责划分：

- internal/composition：唯一生产组合根，装配应用服务与生命周期组件
- internal/application：用例编排、所有权校验、事务边界与补偿
- internal/xianyu：登录协议、Cookie、MTOP、WebSocket 和消息协议
- internal/engine：单账号生命周期、消息处理、回复与交付行为
- internal/automation：发货、评价赠品、求评价和任务调度
- internal/browser：Chromium 自动化、浏览器指纹读取与 token 滑块等浏览器相关能力
- internal/db：多数据库访问、敏感字段加密和嵌入式

Top issues

Latest release

提交：070705d

 Ydisks 闲鱼助手 v1.0.15 Release Note

 新增

- 新增销售统计页面，管理员可按自定义日期范围查看销售数据。
- 新增运行日志页面，管理员可查询运行日志。
- 新增自动化规则日志，记录自动化行为，可在前端“规则日志”页签审计。
- 新增本地资源库，包含图片库和商品模板。模板支持多规格和发货模板，可做模板×账号预检，并复用批量铺货发布。
- 资源库支持搜索、筛选、排序、全选和批量操作，图片库支持大图预览和文件名搜索。
- 商品模板与批量铺货补充“按距离计费”和“无需邮寄”两种邮费模式，与单品发布保持一致。
- 新增商品首次回复：买家首次咨询指定商品时，自动发送一次预设内容 (97)。
- 新增卡密售出台账，可区分已售和未售，导出售出记录，并在订单中查看已发卡密 (99)。
- 求评价规则新增发货时间回溯窗口，避免重新启用时补发历史订单。
- 商品页新增列表视图和规则筛选，规则卡密选择支持搜索。
- 浏览器通知新增默认提示音，开关在系统设置的基础设置中 (95)。
- 日志系统增强：记录调用位置、关联字段和接口摘要，并减少无用日志。
- 风控状态提示改为引导粘贴无风控 Cookie，并提供 issue 92 教程入口。
- 统一内页标题区与页边距，新增 PageHeader 共享组件。
- 补全 Wiki 与官网文档，新增配置参考