• 搜尋：單個／批次 RJID、高級搜尋語法、結果匯出 CSV/JSON
• 下載：單個／批次／熱門作品下載，自動限速、重試、指數退避
• 同步：中繼資料同步、批次下載控制、狀態追蹤、失敗重試
• Web 介面：視覺化瀏覽、瀏覽器內播放、響應式設計
• 設定：互動式初始化，支援代理、限速、抖動等進階設定

設定檔路徑：~/.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） |

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 | Web 服務 | | Tailwind + Plyr | 前端介面 + 音訊播放 |

找不到配置文件 → 執行 ./asmroner config 初始化

下載失敗（stream error） → 程式會自動重試；若仍失敗，請用 sync retry 重試，或查看 .asmroner-data/download_errors.log

Web 介面無法訪問 → 確認埠未被占用，嘗試用 -p 指定其他埠

搜尋結果為空 → 檢查查詢語法，嘗試簡化條件