ACR 项目运行手册

1. 环境

cd acr-engine
python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

2. 生成数据

python run_demo.py generate-data --output data/synthetic --num-songs 24

3. 校验训练链路

python train.py --data data/synthetic --dry-run --device cpu

4. 最小训练

python train.py --data data/synthetic --output data/models --device cpu --epochs 1 --batch-size 8

5. 建索引

python run_demo.py build-index --data data/synthetic --model data/models/best_model.pt --output data/index --device cpu

6. 跑识别

python run_demo.py recognize \
  --query data/synthetic/segments/song_0020_seg_00.wav \
  --data data/synthetic \
  --model data/models/best_model.pt \
  --index-prefix data/index/reference \
  --device cpu

7. 成功判定

至少满足：

• 能输出 JSON 结果
• 返回 candidates
• 结果中包含 song_id 和 confidence