Ydisks Xianyu Helper

An Xianyu multi-account management, messaging, and automated-delivery system built with Go and React.

English documentation · Online Manual · 中文 README · English Wiki · 中文 Wiki · Contributing · Security policy · Code of Conduct · License

The English Wiki is the default operational guide. The Chinese Wiki is available for the primary Chinese-speaking Xianyu community.

[!IMPORTANT] This project is for personal technical learning and research only. It has no official authorization from Xianyu or Alibaba.

This is an unofficial community tool and has no affiliation, partnership, or authorization relationship with Xianyu, Alibaba Group, or their affiliates.

Use it only in compliance with applicable law, platform rules, and the scope of your account authorization. Users are solely responsible for all consequences of using this code; the author assumes no responsibility.

If the platform requests that this project be taken down, it may be deleted or archived at any time.

Do not restart the program frequently while accounts are logged in. Every restart requests login credentials from Xianyu, and repeated requests may trigger risk controls.

Overview

Ydisks Xianyu Helper is a self-hosted management system for Xianyu sellers. It combines account runtimes, instant messaging, orders, products, card inventory, automation rules, AI replies, and exception notifications in one web console. It is intended for individuals and small teams managing multiple Xianyu accounts or delivering virtual goods.

The Go client implements Xianyu login, Cookie renewal, MTOP requests, and the WebSocket message path. QR login, face-verification flows, message connections, credential renewal, and most business logic are handled by the Go client. Chromium is used for features that require a browser environment.

Use with Ydisks Referral Assistant

If you promote Xianyu products through cloud-drive resources, tutorials, or digital packages, you can use Ydisks Referral Assistant alongside this project. Create separate short links for products, channels, or promotion accounts, then inspect PV, UV, trends, rankings, and channel/account reports in the Ydisks console.

Ydisks identifies where visits and conversion leads come from, while this project handles account messages, orders, and automated delivery. See the Ydisks Referral Assistant guide to create links and view data.

Use cases

• Unified online status and message management for multiple Xianyu accounts
• Automated delivery of digital goods, redemption codes, links, or images
• Paid delivery, staged bargain free shipping, review gifts, overdue review reminders, and unpaid-order price changes
• Product and order synchronization, list-based single- or multi-variant detection and publishing, and CSV/XLSX/TSV bulk listing with optional ZIP images
• Controlled AI customer service through OpenAI-compatible endpoints, with an end-to-end connection test

Community

Features

Module	Capabilities
Account management	Multi-account start/stop, QR login, profile refresh, online status, login audit, and notes.
Credential renewal	Scheduled Cookie/token renewal, WebSocket credential updates, recovery, cooldowns, and failure disabling.
Instant messaging	Account-isolated chat, history, Xianyu emoji, text/images, official system-message recognition, keyword replies (multiple expressions, contains or regular-expression matching, multi-product scope), default replies, and one-reply limits.
Automation center	Unpaid-order price changes, paid delivery, staged bargain free shipping, review gifts, review reminders, failure recovery, manual-intervention notifications, and idempotency checkpoints.
Account tasks	Event-driven automatic reviews based on locally recorded buyer-confirmed-receipt events, daily product refresh, manual execution, execution records, and idempotency protection.
Card inventory	Text, batch cards, images, and API delivery, with batch import, quantity, and delay settings.
Product management	Synchronization, manual association, list-card isSKU-based single- or multi-variant detection (missing or false means single-variant), publishing, image ordering, category lookup, and bulk listing.
Delivery templates	Ordered multi-message delivery and order, buyer, card, and custom variables.
Orders	Synchronization, editing, platform delivery, card resending, and exception handling.
AI replies	OpenAI-compatible APIs, model discovery, end-to-end connection testing, Bargaining Only or Full Service modes, per-product enable/disable and product-specific reference material, custom prompts, bargaining rounds, and discount limits.
Notifications	Bark, DingTalk, Feishu, WeCom, Telegram, email, and custom Webhooks.
Storage and security	SQLite/MySQL/PostgreSQL, embedded Goose migrations, AES-256-GCM sensitive-field encryption, log redaction, and outbound-address validation.
Container deployment	PostgreSQL 17, health checks, persistent volumes, and multi-architecture GHCR images.

This is the beginning of the README. Read the rest at the original. Read the full README ↗