# YOLOv8n Mobile Phone v1

这是 Debug OpenCV Viewer 使用的单类手机目标检测模型。它来自
[`IndUSV/yolov8n-mobile-phone`](https://huggingface.co/IndUSV/yolov8n-mobile-phone)，
用于检测画面中可见的手机物体。

| 字段 | 值 |
|---|---|
| Model ID | `yolov8n-mobile-phone@1` |
| 注册名称 | `YOLOv8n Mobile Phone` |
| Backend | `ultralytics-yolo` |
| 基础模型 | YOLOv8n |
| 输入尺寸 | 640 × 640 |
| 权重 | `models/detection/yolov8n-mobile-phone/yolov8n-mobile-phone.pt` |
| 文件大小 | 6,234,666 bytes |
| SHA256 | `9230e4bfa7cba7134215c4c7f228b5e58760b02138788ccaff0149258c2d2e19` |
| Checkpoint Ultralytics 版本 | 8.4.12 |
| 上游模型卡许可 | MIT |

## 标签

checkpoint 只有一个类别，注册顺序必须与 class ID 完全一致：

| Class ID | 标签 | 语义 |
|---:|---|---|
| 0 | `mobile_phone` | 画面中可见的手机物体 |

## Viewer 配置

```yaml
phone_detector:
  uses: detection.model@1
  with:
    model: yolov8n-mobile-phone@1
    detect_labels: [mobile_phone]
    confidence: 0.50
    attach_frame: true
    model_options:
      weights: models/detection/yolov8n-mobile-phone/yolov8n-mobile-phone.pt
      device: cpu
      imgsz: 640
      iou: 0.70
      half: false
      max_det: 100
```

## 限制

- 这是手机物体检测器，不是接打电话行为识别器。检测到手机不能证明人员正在通话，
  也不能区分接听、拨出或电话是否接通。
- 本地 smoke test 中，640 × 640 全黑合成图在 `confidence: 0.50` 下仍出现过误报；
  该结果不代表真实画面精度，但说明上线前必须用目标相机数据校准阈值。
- 遮挡、小目标、反光、屏幕和外形相近物体都可能造成漏检或误检。
- 上游模型卡未给出可直接用于本项目验收的量化指标；部署效果应以现场数据回放为准。

## 来源与校验

上游模型卡说明该模型基于 YOLOv8n，在 Datacluster Labs Mobile Phone Image Dataset
上训练，单类标签为 `mobile_phone`，输入尺寸为 640 × 640，并标注 MIT 许可。运行时及
其依赖仍需分别遵守各自许可。

```bash
sha256sum models/detection/yolov8n-mobile-phone/yolov8n-mobile-phone.pt

uv run --no-sync cmvr-edge-ai models

uv run --no-sync python detect_server/show_detections.py \
  --config configs/debug/detection_viewer.yaml \
  --validate-only
```