cmvr_edge_ai/models/detection/yolov8n-mobile-phone/README.md

72 lines
2.4 KiB
Markdown
Raw Permalink Normal View History

2026-07-21 16:23:33 +08:00
# YOLOv8n Mobile Phone v1
这是单类手机目标检测模型的 v1 PT 导出源与回滚版本。当前 Debug OpenCV Viewer 使用
[`yolov8n-mobile-phone@2`](v2/README.md) ONNX 制品。v1 来自
2026-07-21 16:23:33 +08:00
[`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` | 画面中可见的手机物体 |
## v1 回滚配置
2026-07-21 16:23:33 +08:00
```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 server/detect/show_detections.py \
--config configs/detection_viewer.yaml \
2026-07-21 16:23:33 +08:00
--validate-only
```