• 検索：単体/バッチ 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） | | 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 | Webサービス | | Tailwind + Plyr | フロントエンドUI + オーディオ再生 |

設定ファイルが見つかりません → ./asmroner config を実行して初期化

ダウンロード失敗（stream error） → 自動で再試行します；失敗する場合は sync retry で再試行、または .asmroner-data/download_errors.log を確認

Web画面がアクセスできません → ポートが占有されていないか確認し、-p で別のポートを指定してみてください

検索結果が空です → クエリ構文を確認し、条件を簡素化して試してください

exportコマンドに対応したダウンロード方法 → guide を参照してください