• Ricerca: RJID singolo/multiplo, sintassi di ricerca avanzata, esportazione dei risultati in CSV/JSON
• Download: Download singolo/multiplo/popolari, limitazione automatica, retry, backoff esponenziale
• Sincronizzazione: Sincronizzazione metadata, controllo download multipli, tracciamento stato, retry su fallimento
• Interfaccia Web: Navigazione visuale, riproduzione nel browser, design responsivo
• Configurazione: Inizializzazione interattiva, supporto proxy, limitazione, jitter e altre configurazioni avanzate

Percorso del file di configurazione: ~/.asmroner/config.toml (formato 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

| Comando | Opzione | Descrizione | |---------|---------|-------------| | search | -c | Numero dei risultati della ricerca (predefinito 10) | | search download | -d, -s | Directory di download, numero di download | | search export | -f, -n | Nome file di esportazione (.csv/.json), numero di esportazione | | download | -d, -n | Directory di download, quantità hot100 | | sync download | -d | Directory di download | | sync retry | -d | Directory dei file falliti | | sync export | -s, -f | Stato (failed/success), file di esportazione | | listen | -p | Porta (predefinito 9999) | | export | -o, -n | Directory di esportazione, quantità hot100 |

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

| Componente | Utilizzo | |------|------| | Cobra + Viper | Framework CLI + Gestione configurazioni | | GORM + SQLite | Persistenza dei dati | | Resty | Client HTTP (supporta proxy HTTP/SOCKS5) | | Pond | Pool di lavoro concorrente | | x/time/rate | Rate limiting a secchiello di token | | Gin | Servizio Web | | Tailwind + Plyr | Interfaccia frontend + Riproduzione audio |

File di configurazione non trovato → Eseguire ./asmroner config per inizializzare

Download fallito (stream error) → Il programma riprova automaticamente; se continua a fallire, riprovare con sync retry o consultare .asmroner-data/download_errors.log

Interfaccia web non accessibile → Verificare che la porta non sia occupata, provare a specificare un'altra porta con -p

Nessun risultato di ricerca → Controllare la sintassi della query, provare a semplificare le condizioni

Metodo di download per il comando export → Fare riferimento alla guida