• Zoeken: Enkelvoudig/bulk RJID, geavanceerde zoekopdrachten, resultaten exporteren naar CSV/JSON
• Downloaden: Enkelvoudig/bulk/download van populaire werken, automatische snelheidsbeperking, herhalingen, exponentiële back-off
• Synchroniseren: Metagegevens-synchronisatie, bulk downloadbeheer, status tracking, herhaalde pogingen bij fouten
• Web-interface: Visueel bladeren, afspelen in browser, responsief ontwerp
• Configuratie: Interactieve setup, ondersteuning voor proxy, snelheidsbeperking, jitter en andere geavanceerde opties

Pad naar configuratiebestand: ~/.asmroner/config.toml (TOML-formaat)

[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

| Commando | Optie | Beschrijving | |----------|-------|--------------| | search | -c | Aantal zoekresultaten (standaard 10) | | search download | -d, -s | Downloadmap, aantal downloads | | search export | -f, -n | Bestandsnaam voor export (.csv/.json), aantal exporten | | download | -d, -n | Downloadmap, hot100 aantal | | sync download | -d | Downloadmap | | sync retry | -d | Map met mislukte bestanden | | sync export | -s, -f | Status (failed/success), exportbestand | | listen | -p | Poort (standaard 9999) | | export | -o, -n | Exportmap, hot100 aantal |

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

| Component | Doel | |-----------|------| | Cobra + Viper | CLI-framework + configuratiebeheer | | GORM + SQLite | Gegevenspersistentie | | Resty | HTTP-client (ondersteunt HTTP/SOCKS5 proxy) | | Pond | Concurrentie werkpool | | x/time/rate | Token bucket rate limiting | | Gin | Webdienst | | Tailwind + Plyr | Frontend-interface + audioweergave |

Configuratiebestand niet gevonden → Voer ./asmroner config uit om te initialiseren

Download mislukt (stream error) → Het programma probeert automatisch opnieuw; als het nog mislukt, gebruik sync retry of bekijk .asmroner-data/download_errors.log

Webinterface niet bereikbaar → Controleer of de poort vrij is, probeer eventueel een andere poort met -p

Geen zoekresultaten → Controleer de query-syntax, probeer de voorwaarden te vereenvoudigen

Downloadmethode voor het export-commando → Zie gids