71 lines
2.3 KiB
Markdown
71 lines
2.3 KiB
Markdown
# 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
|
||
```
|