• ค้นหา: ค้นหา 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 proxy) | | Pond | พูลงานแบบขนาน | | x/time/rate | การจำกัดอัตราแบบ token bucket | | Gin | บริการเว็บ | | Tailwind + Plyr | ส่วนติดต่อผู้ใช้ฝั่งหน้าเว็บ + การเล่นไฟล์เสียง |

ไม่พบไฟล์คอนฟิก → รัน ./asmroner config เพื่อเริ่มต้น

ดาวน์โหลดล้มเหลว (stream error) → โปรแกรมจะลองใหม่อัตโนมัติ; หากยังล้มเหลว ให้ใช้ sync retry เพื่อพยายามอีกครั้ง หรือดูที่ .asmroner-data/download_errors.log

ไม่สามารถเข้าถึงเว็บอินเทอร์เฟซ → ตรวจสอบว่าไม่มีการใช้พอร์ตดังกล่าว และลองใช้ -p เพื่อระบุพอร์ตอื่น

ผลการค้นหาว่างเปล่า → ตรวจสอบไวยากรณ์การค้นหา และลองลดเงื่อนไขให้ง่ายขึ้น

วิธีดาวน์โหลดที่ใช้ร่วมกับคำสั่ง export → ดู guide