• Tìm kiếm: Tìm theo RJID đơn/lô, cú pháp tìm kiếm nâng cao, xuất kết quả ra CSV/JSON
• Tải xuống: Tải đơn/lô/tác phẩm hot, tự động giới hạn tốc độ, thử lại, thoái lui theo hàm mũ
• Đồng bộ: Đồng bộ metadata, kiểm soát tải lô, theo dõi trạng thái, thử lại khi thất bại
• Giao diện Web: Duyệt trực quan, nghe trực tiếp trên trình duyệt, thiết kế phản hồi
• Cấu hình: Khởi tạo tương tác, hỗ trợ proxy, giới hạn tốc độ, jitter và các cấu hình nâng cao

Đường dẫn file cấu hình: ~/.asmroner/config.toml (định dạng 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

| Lệnh | Tùy chọn | Mô tả | |------|------|------| | search | -c | Số lượng kết quả tìm kiếm (mặc định 10) | | search download | -d, -s | Thư mục tải về, số lượng tải về | | search export | -f, -n | Tên file xuất (.csv/.json), số lượng xuất | | download | -d, -n | Thư mục tải về, số lượng hot100 | | sync download | -d | Thư mục tải về | | sync retry | -d | Thư mục chứa file thất bại | | sync export | -s, -f | Trạng thái (failed/success), file xuất | | listen | -p | Cổng (mặc định 9999) | | export | -o, -n | Thư mục xuất, số lượng hot100 |

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

| Thành phần | Mục đích | |------|------| | Cobra + Viper | Khung CLI + Quản lý cấu hình | | GORM + SQLite | Lưu trữ dữ liệu | | Resty | HTTP client (hỗ trợ HTTP/SOCKS5 proxy) | | Pond | Pool xử lý song song | | x/time/rate | Giới hạn tốc độ bằng token bucket | | Gin | Dịch vụ Web | | Tailwind + Plyr | Giao diện frontend + Phát âm thanh |

Không tìm thấy file cấu hình → Chạy ./asmroner config để khởi tạo

Tải xuống thất bại (stream error) → Chương trình sẽ tự động thử lại; nếu vẫn thất bại, dùng sync retry để thử lại, hoặc xem .asmroner-data/download_errors.log

Không truy cập được giao diện Web → Đảm bảo cổng không bị chiếm, thử dùng -p chỉ định cổng khác

Kết quả tìm kiếm rỗng → Kiểm tra cú pháp truy vấn, thử đơn giản hóa điều kiện

Cách tải xuống đi kèm với lệnh export → Tham khảo guide