部署与评估检查清单
上线前
- [ ] 执行
business.delivery_media_snapshot_feedback.sql
- [ ] 训练并部署
models/storefront_int8.onnx、models/handover_int8.onnx、version.json
- [ ] 推理机安装 ffmpeg，且能访问 Java 构造的
video_url（FTP HTTP 前缀）
- [ ]
application-pro.yml 中 snapshot.infer.fail-open-mock: false
- [ ]
GET /health 返回 status=ok 且两个 ONNX loaded=true
性能目标（10 分钟视频，CPU）
| 指标 |
POC 目标 |
| 单条 analyze 耗时 |
< 10 分钟 |
| 门头 MAE |
< 8s |
| 交付 MAE |
< 8s |
| 顺序正确率 |
> 95% |
压测命令：
cd server/snapshot_infer
py tools/benchmark_cpu.py "http://your-ftp-host/collection_media/xxx.mp4" --sample-fps 0.5
故障排查
| 现象 |
处理 |
| health degraded |
检查 ONNX 文件是否在 SNAPSHOT_MODEL_DIR |
| analyze 超时 |
增大 Java read-timeout-ms；降低 sample-fps |
| ASR 慢 |
确认 WHISPER_MODEL=tiny；或 enable-asr: false 纯视觉 |
| Java snapshot_status=3 |
查看 snapshot_message 与推理服务日志 |
