• Suche: Einzelne/mehrere RJIDs, erweiterte Suchsyntax, Export von Ergebnissen als CSV/JSON
• Download: Einzel-/Massen-/Trend-Download, automatische Drosselung, Wiederholung, exponentielles Backoff
• Synchronisation: Metadaten-Synchronisation, Steuerung des Massen-Downloads, Statusverfolgung, Wiederholung bei Fehlern
• Web-Oberfläche: Visuelle Ansicht, Wiedergabe im Browser, responsives Design
• Konfiguration: Interaktive Initialisierung, Unterstützung für Proxy, Drosselung, Jitter und weitere erweiterte Einstellungen

Pfad zur Konfigurationsdatei: ~/.asmroner/config.toml (TOML-Format)

[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

| Befehl | Option | Beschreibung | |--------|--------|--------------| | search | -c | Anzahl der Suchergebnisse (Standard 10) | | search download | -d, -s | Download-Verzeichnis, Download-Anzahl | | search export | -f, -n | Exportdateiname (.csv/.json), Exportanzahl | | download | -d, -n | Download-Verzeichnis, hot100-Anzahl | | sync download | -d | Download-Verzeichnis | | sync retry | -d | Verzeichnis der fehlgeschlagenen Dateien | | sync export | -s, -f | Status (failed/success), Exportdatei | | listen | -p | Port (Standard 9999) | | export | -o, -n | Exportverzeichnis, hot100-Anzahl |

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

| Komponente | Zweck | |------|------| | Cobra + Viper | CLI-Framework + Konfigurationsmanagement | | GORM + SQLite | Datenpersistenz | | Resty | HTTP-Client (unterstützt HTTP/SOCKS5-Proxy) | | Pond | Nebenläufiger Arbeits-Pool | | x/time/rate | Token-Bucket-Rate-Limiting | | Gin | Web-Service | | Tailwind + Plyr | Frontend-Oberfläche + Audiowiedergabe |

Konfigurationsdatei nicht gefunden → Führe ./asmroner config zur Initialisierung aus

Download fehlgeschlagen (stream error) → Das Programm versucht es automatisch erneut; falls weiterhin fehlgeschlagen, verwende sync retry oder prüfe .asmroner-data/download_errors.log

Web-Oberfläche nicht erreichbar → Stelle sicher, dass der Port frei ist, versuche anderen Port mit -p anzugeben

Leere Suchergebnisse → Überprüfe die Suchsyntax, vereinfache ggf. die Bedingungen

Export-Befehl und zugehörige Downloadmethoden → Siehe guide