• جستجو: RJID تکی/گروهی، دستور جستجوی پیشرفته، خروجی نتایج به CSV/JSON
• دانلود: دانلود تکی/گروهی/آثار محبوب، محدودیت خودکار سرعت، تلاش مجدد، عقب‌نشینی نمایی
• همگام‌سازی: همگام‌سازی متادیتا، کنترل دانلود گروهی، پیگیری وضعیت، تلاش مجدد در خطا
• رابط وب: مرور بصری، پخش در مرورگر، طراحی واکنش‌گرا
• تنظیمات: راه‌اندازی تعاملی، پشتیبانی از پراکسی، محدودیت سرعت، اعمال jitter و تنظیمات پیشرفته دیگر

مسیر فایل تنظیمات: ~/.asmroner/config.toml (فرمت TOML)

[user]
account = "guest"
password = "guest"
[downloader]
api_url = ""                # 留空自动获取最快站点
proxy_url = ""              # 支持 http / socks5
max_workers = 5
max_retries = 3
sync_data_folder = "./syncdata"
sync_wanted_size = "200MB"  # 同步容量限制
prefer_media = "all"        # all | mp3>wav>flac
[limit]
sync_qps = 2
sync_jitter_min = 100       # ms
sync_jitter_max = 500
download_qps = 0.2
download_jitter_min = 2000
download_jitter_max = 5000

| دستور | گزینه | توضیحات | |-------|-------|---------| | search | -c | تعداد نتایج جستجو (پیش‌فرض ۱۰) | | search download | -d, -s | مسیر دانلود، تعداد دانلود | | search export | -f, -n | نام فایل خروجی (.csv/.json)، تعداد خروجی | | download | -d, -n | مسیر دانلود، تعداد hot100 | | sync download | -d | مسیر دانلود | | sync retry | -d | مسیر فایل‌های ناموفق | | sync export | -s, -f | وضعیت (failed/success)، فایل خروجی | | listen | -p | پورت (پیش‌فرض ۹۹۹۹) | | export | -o, -n | مسیر خروجی، تعداد hot100 |

asmroner/
├── cmd/                # 命令行接口（config/download/search/sync/listen）
├── internal/
│   ├── engine/        # 核心下载引擎（限流、重试、并发控制）
│   ├── logger/        # 结构化日志系统
│   ├── model/         # 数据模型与查询参数解析
│   ├── database/      # SQLite 数据库
│   ├── consts/        # 常量定义
│   └── utils/         # 工具函数
├── webui/             # 内嵌 Web 界面（Tailwind + Plyr）
├── main.go
└── go.mod

| مؤلفه | کاربرد | |------|------| | Cobra + Viper | چارچوب CLI + مدیریت پیکربندی | | GORM + SQLite | پایداری داده‌ها | | Resty | کلاینت HTTP (پشتیبانی از پراکسی HTTP/SOCKS5) | | Pond | استخر کار همزمان | | x/time/rate | محدودسازی سرعت به روش سطل توکن | | Gin | سرویس وب | | Tailwind + Plyr | رابط کاربری فرانت‌اند + پخش صوتی |

فایل پیکربندی پیدا نشد → اجرای ./asmroner config برای مقداردهی اولیه

دانلود ناموفق (stream error) → برنامه به طور خودکار تلاش مجدد می‌کند؛ اگر هنوز شکست خورد، با sync retry دوباره تلاش کنید یا فایل .asmroner-data/download_errors.log را بررسی نمایید

عدم دسترسی به رابط وب → مطمئن شوید پورت اشغال نشده و با گزینه -p پورت دیگری را امتحان کنید

نتیجه جستجو خالی است → نحو جستجو را بررسی کرده و شرایط را ساده‌تر کنید

روش دانلود متناسب با دستور export → به راهنما مراجعه کنید