• Búsqueda: RJID individual/lote, sintaxis avanzada de búsqueda, exportación de resultados a CSV/JSON
• Descarga: descarga individual/lote/popular, limitación automática, reintentos, retroceso exponencial
• Sincronización: sincronización de metadatos, control de descargas en lote, seguimiento de estado, reintentos en fallos
• Interfaz Web: navegación visual, reproducción en navegador, diseño responsivo
• Configuración: inicialización interactiva, soporte para proxy, limitación, jitter y otras configuraciones avanzadas

Ruta del archivo de configuración: ~/.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 | Opción | Descripción | |------|------|------| | search | -c | Número de resultados de búsqueda (por defecto 10) | | search download | -d, -s | Directorio de descarga, cantidad de descargas | | search export | -f, -n | Nombre del archivo exportado (.csv/.json), cantidad exportada | | download | -d, -n | Directorio de descarga, cantidad hot100 | | sync download | -d | Directorio de descarga | | sync retry | -d | Directorio donde se encuentran archivos fallidos | | sync export | -s, -f | Estado (failed/success), archivo exportado | | listen | -p | Puerto (por defecto 9999) |

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

| Componente | Uso | |------|------| | Cobra + Viper | Marco CLI + Gestión de configuración | | GORM + SQLite | Persistencia de datos | | Resty | Cliente HTTP (soporta proxy HTTP/SOCKS5) | | Pond | Pool de trabajo concurrente | | x/time/rate | Limitación de tasa con token bucket | | Gin | Servicio web | | Tailwind + Plyr | Interfaz frontend + Reproducción de audio |

Archivo de configuración no encontrado → Ejecutar ./asmroner config para inicializar

Descarga fallida (stream error) → El programa reintentará automáticamente; si sigue fallando, usar sync retry para reintentar, o revisar .asmroner-data/download_errors.log

Interfaz web inaccesible → Confirmar que el puerto no esté ocupado, intentar con -p para especificar otro puerto

Resultados de búsqueda vacíos → Verificar sintaxis de consulta, intentar simplificar condiciones