• Поиск: одиночный/массовый RJID, расширенный поисковый синтаксис, экспорт результатов в CSV/JSON
• Загрузка: одиночная/массовая/популярные загрузки, автоматическое ограничение скорости, повторные попытки, экспоненциальное отступление
• Синхронизация: синхронизация метаданных, массовый контроль загрузки, отслеживание состояния, повторные попытки при ошибках
• Web интерфейс: визуальный просмотр, воспроизведение в браузере, адаптивный дизайн
• Конфигурация: интерактивная инициализация, поддержка прокси, ограничения скорости, jitter и другие расширенные настройки

Путь к конфигурационному файлу: ~/.asmroner/config.toml (формат 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

| Команда | Опция | Описание | |---------|-------|----------| | search | -c | Количество результатов поиска (по умолчанию 10) | | search download | -d, -s | Каталог загрузки, количество загрузок | | search export | -f, -n | Имя экспортируемого файла (.csv/.json), количество экспорта | | download | -d, -n | Каталог загрузки, количество hot100 | | sync download | -d | Каталог загрузки | | sync retry | -d | Каталог с неудавшимися файлами | | sync export | -s, -f | Статус (failed/success), экспортируемый файл | | listen | -p | Порт (по умолчанию 9999) | | export | -o, -n | Каталог экспорта, количество hot100 |

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

| Компонент | Назначение | |-----------|-----------| | Cobra + Viper | CLI-фреймворк + управление конфигурацией | | GORM + SQLite | Хранение данных | | Resty | HTTP-клиент (поддержка HTTP/SOCKS5 прокси) | | Pond | Пул параллельных задач | | x/time/rate | Ограничение скорости по токен-бакету | | Gin | Веб-сервис | | Tailwind + Plyr | Фронтенд-интерфейс + воспроизведение аудио |

Файл конфигурации не найден → Запустите ./asmroner config для инициализации

Сбой загрузки (stream error) → Программа автоматически повторяет попытку; если ошибка сохраняется, используйте sync retry для повторной попытки или проверьте .asmroner-data/download_errors.log

Веб-интерфейс недоступен → Убедитесь, что порт не занят, попробуйте задать другой порт через -p

Результаты поиска пусты → Проверьте синтаксис запроса, попробуйте упростить условия

Сопутствующий способ загрузки для export-команды → См. guide