• Arama: Tekli/Toplu RJID, gelişmiş arama sözdizimi, sonuçları CSV/JSON olarak dışa aktarma
• İndirme: Tekli/Toplu/Popüler eserleri indirme, otomatik hız sınırlama, tekrar deneme, üstel geri çekilme
• Senkronizasyon: Meta veri senkronizasyonu, toplu indirme kontrolü, durum takibi, başarısızlıkta tekrar deneme
• Web Arayüzü: Görsel tarama, tarayıcıda oynatma, duyarlı tasarım
• Ayarlar: Etkileşimli başlatma, proxy desteği, hız sınırlama, jitter gibi gelişmiş ayarlar

Konfigürasyon dosyası yolu: ~/.asmroner/config.toml (TOML formatında)

[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

| Komut | Seçenek | Açıklama | |-------|---------|----------| | search | -c | Arama sonucu sayısı (varsayılan 10) | | search download | -d, -s | İndirme dizini, indirme sayısı | | search export | -f, -n | Dışa aktarılan dosya adı (.csv/.json), dışa aktarılan sayısı | | download | -d, -n | İndirme dizini, hot100 sayısı | | sync download | -d | İndirme dizini | | sync retry | -d | Hatalı dosyaların dizini | | sync export | -s, -f | Durum (failed/success), dışa aktarılan dosya | | listen | -p | Port (varsayılan 9999) | | export | -o, -n | Dışa aktarma dizini, hot100 sayısı |

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

| Bileşen | Amaç | |------|------| | Cobra + Viper | CLI çerçevesi + yapılandırma yönetimi | | GORM + SQLite | Veri kalıcılığı | | Resty | HTTP istemcisi (HTTP/SOCKS5 proxy desteği) | | Pond | Eşzamanlı iş havuzu | | x/time/rate | Jeton kovası hız sınırlaması | | Gin | Web servisi | | Tailwind + Plyr | Ön uç arayüzü + ses oynatma |

Yapılandırma dosyası bulunamadı → ./asmroner config komutunu çalıştırarak başlatın

İndirme başarısız (stream error) → Program otomatik olarak tekrar deneyecektir; yine başarısız olursa, sync retry ile tekrar deneyin veya .asmroner-data/download_errors.log dosyasını kontrol edin

Web arayüzüne erişilemiyor → Portun kullanımda olmadığından emin olun, başka bir port belirtmek için -p kullanın

Arama sonucu boş → Sorgu sözdizimini kontrol edin, şartları basitleştirmeyi deneyin

export komutuna uygun indirme yöntemi → guide belgesine bakın