• Wyszukiwanie: pojedyncze/zbiorcze RJID, zaawansowana składnia wyszukiwania, eksport wyników do CSV/JSON
• Pobieranie: pojedyncze/zbiorcze/pobieranie popularnych prac, automatyczne ograniczanie przepustowości, ponawianie, wykładnicze opóźnienie
• Synchronizacja: synchronizacja metadanych, kontrola zbiorczego pobierania, śledzenie statusu, ponawianie w przypadku błędów
• Interfejs Web: wizualne przeglądanie, odtwarzanie w przeglądarce, responsywny design
• Konfiguracja: interaktywna inicjalizacja, obsługa proxy, ograniczanie przepustowości, jitter i inne zaawansowane ustawienia

Ścieżka pliku konfiguracyjnego: ~/.asmroner/config.toml (format 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

| Polecenie | Opcja | Opis | |------|------|------| | search | -c | Liczba wyników wyszukiwania (domyślnie 10) | | search download | -d, -s | Katalog pobierania, liczba pobrań | | search export | -f, -n | Nazwa pliku eksportu (.csv/.json), liczba eksportowanych pozycji | | download | -d, -n | Katalog pobierania, liczba hot100 | | sync download | -d | Katalog pobierania | | sync retry | -d | Katalog z nieudanymi plikami | | sync export | -s, -f | Status (failed/success), plik eksportu | | listen | -p | Port (domyślnie 9999) | | export | -o, -n | Katalog eksportu, liczba hot100 |

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

| Komponent | Zastosowanie | |-----------|--------------| | Cobra + Viper | Framework CLI + zarządzanie konfiguracją | | GORM + SQLite | Trwałość danych | | Resty | Klient HTTP (obsługuje HTTP/SOCKS5 proxy) | | Pond | Pool współbieżnych zadań | | x/time/rate | Ograniczanie przepustowości token bucket | | Gin | Serwis webowy | | Tailwind + Plyr | Interfejs frontend + odtwarzanie audio |

Plik konfiguracyjny nie znaleziony → Uruchom ./asmroner config aby zainicjować

Błąd pobierania (stream error) → Program automatycznie ponowi próbę; jeśli nadal nie działa, użyj sync retry, lub sprawdź .asmroner-data/download_errors.log

Brak dostępu do interfejsu web → Upewnij się, że port nie jest zajęty, spróbuj użyć -p, aby wybrać inny port

Brak wyników wyszukiwania → Sprawdź składnię zapytania, spróbuj uprościć warunki

Sposób pobierania dla polecenia export → Zobacz guide