• البحث: بحث فردي/مجمع برقم RJID، صيغ بحث متقدمة، تصدير النتائج إلى CSV/JSON
• التنزيل: تنزيل فردي/مجمع/الأعمال الشائعة، تحديد تلقائي للسرعة، إعادة المحاولة، تراجع أسي
• المزامنة: مزامنة البيانات الوصفية، التحكم في التنزيل المجمع، تتبع الحالة، إعادة محاولة الفشل
• واجهة الويب: تصفح مرئي، تشغيل داخل المتصفح، تصميم متجاوب
• الإعدادات: تهيئة تفاعلية، دعم البروكسي، تحديد السرعة، التذبذب والإعدادات المتقدمة

مسار ملف الإعدادات: ~/.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 | عدد نتائج البحث (الافتراضي 10) | | 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 | المنفذ (الافتراضي 9999) | | 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 → راجع guide