这次我们来看一个基于YOLOv8的超市空货架识别检测系统，这是一个完整的零售场景AI解决方案。项目由斌擎人工智能团队开源，提供了从数据集、模型权重到完整UI界面的全套资源，特别适合想要快速部署货架状态监测系统的开发者。

系统最核心的价值在于解决了传统人工巡检效率低、实时性差的问题。通过摄像头实时监测货架状态，当检测到空货架时能够及时告警，帮助超市管理人员快速补货。从技术指标看，模型在验证集上达到了0.937的mAP50和0.79的mAP50-95，最高精确率可达1.00，召回率最高为0.96，性能相当出色。

本文将带大家完成从环境配置到功能测试的全流程，重点演示如何在不同检测模式下运行系统，以及如何根据实际场景调整参数。如果你正在寻找一个成熟的零售AI检测项目，或者想要学习YOLOv8在实际业务中的落地应用，这个项目值得深入尝试。

1. 核心能力速览

2. 适用场景与使用边界

这个系统主要面向零售行业的智能化管理需求。超市运营中最头疼的问题之一就是货架缺货，研究表明约15%的畅销商品在高峰时段会出现货架空置，而30%的顾客在面对空货架时会放弃购买或转向竞争对手。传统的人工巡检方式根本无法做到实时监测，而这个系统可以7x24小时不间断工作。

适合的使用场景包括：

• 大中型超市的货架状态监控
• 便利店的商品缺货检测
• 仓库货架库存盘点
• 零售门店的智能巡检系统

需要注意的使用边界：

• 系统仅检测空货架状态，不涉及具体商品识别
• 需要保证摄像头视角覆盖货架区域
• 光照条件变化可能影响检测效果
• 严重遮挡情况下的检测准确率会下降

在隐私合规方面，系统部署时需要确保监控区域有明确的告知标识，避免侵犯顾客隐私。商业使用时还需要考虑数据安全和存储合规性要求。

3. 环境准备与前置条件

在开始部署之前，需要确保开发环境满足以下要求：

操作系统要求：

• Windows 10/11（推荐）
• Ubuntu 18.04+ 或 CentOS 7+
• macOS（需要额外配置）

Python环境：

• Python 3.8-3.10（3.11可能存在兼容性问题）
• 建议使用conda或venv创建虚拟环境

硬件要求：

• CPU: 4核以上处理器
• 内存: 8GB以上
• GPU: 可选，但推荐NVIDIA GPU（GTX 1060 6G或以上）
• 存储空间: 至少2GB可用空间

必要依赖检查：在开始安装前，运行以下命令检查基础环境：

# 检查Python版本 python --version # 检查pip版本 pip --version # 检查CUDA（如果使用GPU） nvidia-smi

如果计划使用GPU加速，需要提前安装CUDA 11.7或11.8以及对应的cuDNN。对于大多数用户，使用CPU推理也能满足基本需求，只是处理速度会稍慢一些。

4. 安装部署与启动方式

4.1 依赖安装

首先创建并激活Python虚拟环境：

# 创建虚拟环境 python -m venv yolov8_env # 激活环境（Windows） yolov8_env\Scripts\activate # 激活环境（Linux/Mac） source yolov8_env/bin/activate

安装核心依赖包：

# 安装PyTorch（CPU版本） pip install torch torchvision torchaudio # 安装PyTorch（GPU版本，CUDA 11.7） pip install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cu117 # 安装YOLOv8和UI依赖 pip install ultralytics pip install PyQt5 pip install opencv-python pip install pillow pip install numpy

4.2 项目文件准备

下载项目源码后，解压到本地目录，结构应该如下：

yolov8-shelf-detection/ ├── main.py # 主程序入口 ├── best.pt # 训练好的模型权重 ├── dataset/ # 数据集目录 │ ├── images/ # 图像文件 │ └── labels/ # 标注文件 ├── ui/ # 界面相关文件 │ ├── main_window.py # 主窗口类 │ └── resources/ # 资源文件 └── requirements.txt # 依赖列表

4.3 启动系统

直接运行主程序：

python main.py

首次启动时会进行环境检测和模型加载，如果一切正常，会出现登录界面。系统默认提供测试账号，也可以注册新用户。

5. 功能测试与效果验证

5.1 用户登录与界面熟悉

启动后首先看到的是用户登录界面，支持新用户注册和密码登录。密码采用SHA256加密存储，确保安全性。登录成功后进入主界面，整体布局分为三栏：

• 左侧控制区：检测模式选择、参数调节
• 中央显示区：实时检测画面显示
• 右侧信息区：检测结果列表和统计信息

界面采用毛玻璃效果，支持无边框窗口拖动，视觉效果现代且实用。

5.2 图片检测测试

首先测试单张图片检测功能：

1. 点击工具栏的图片按钮或选择"图片检测"模式
2. 选择测试图片（支持JPG/JPEG/PNG/BMP格式）
3. 调整置信度阈值（默认0.25）和IoU阈值（默认0.45）
4. 点击开始检测

预期效果：

• 图片中央显示带检测框的结果
• 右侧列表显示检测到的空货架数量及置信度
• 状态栏显示处理时间和FPS

测试技巧：使用不同角度、不同光照条件的货架图片进行测试，观察模型在不同场景下的稳定性。

5.3 视频检测测试

对于视频文件检测：

1. 切换到"视频检测"模式
2. 选择MP4/AVI/MOV/MKV格式视频文件
3. 设置是否保存结果视频
4. 点击开始检测

系统会逐帧处理视频，并显示实时进度条。处理完成后可以回放带检测结果的视频。

5.4 摄像头实时检测

这是最核心的应用场景：

1. 连接USB摄像头到电脑
2. 选择"摄像头检测"模式（默认摄像头ID为0）
3. 调整检测参数到合适值
4. 点击开始检测

实时检测效果验证：

• 观察FPS值，正常应该在15-30FPS之间（取决于硬件）
• 测试不同距离和角度的货架
• 验证遮挡情况下的检测鲁棒性

5.5 参数调优实践

系统提供两个关键参数的实时调节：

置信度阈值（Confidence Threshold）

• 范围：0-100%
• 值越高，检测要求越严格，漏检可能增加
• 推荐设置：25-40%

IoU阈值（Intersection over Union）

• 范围：0-100%
• 控制重叠检测框的合并程度
• 推荐设置：45-60%

通过滑动条实时调整参数，可以立即看到检测结果的变化，这对于优化实际部署效果非常重要。

6. 结果保存与日志管理

6.1 检测结果保存

系统支持多种结果保存方式：

自动保存：

• 开启"保存结果"开关
• 设置保存路径
• 系统自动添加时间戳命名

手动保存：

• 使用工具栏保存按钮
• 随时保存当前画面

保存格式支持图片（JPG/PNG）和视频（MP4），方便后续分析和报告生成。

6.2 日志系统

系统内置完整的日志记录功能：

• 操作日志：记录用户登录、模式切换等操作
• 错误日志：记录检测过程中的异常信息
• 性能日志：记录处理时间和资源使用情况

日志带时间戳，可以通过界面直接查看，对于问题排查和系统优化很有帮助。

7. 资源占用与性能观察

7.1 CPU与内存占用

在典型工作状态下：

• CPU占用：15-30%（取决于检测模式）
• 内存占用：1.5-2.5GB
• 视频处理时会有短暂峰值

7.2 GPU显存占用（如果使用GPU）

• 模型加载：约1.2GB显存
• 图片检测：1.3-1.5GB
• 视频检测：1.5-2.0GB
• 摄像头实时检测：1.4-1.8GB

7.3 处理速度指标

图片检测：

• 1080p图片：0.1-0.3秒/张
• 4K图片：0.3-0.6秒/张

视频检测：

• 1080p视频：15-25 FPS（GPU）
• 1080p视频：5-8 FPS（CPU）

摄像头实时检测：

• 720p分辨率：20-30 FPS（GPU）
• 1080p分辨率：15-25 FPS（GPU）

这些性能数据可以帮助你评估系统在目标硬件上的表现，并据此调整检测参数。

8. 自定义训练与模型优化

8.1 数据集准备

如果你需要针对特定场景重新训练模型：

数据采集要求：

• 图像分辨率建议1920x1080以上
• 包含不同角度、光照条件的货架图片
• 适当包含遮挡、反射等挑战性场景

标注规范：

• 使用LabelImg等工具标注空货架区域
• 类别名称统一为"100-O-O-S"
• YOLO格式标注文件

8.2 训练配置

使用提供的训练脚本：

from ultralytics import YOLO # 加载预训练模型 model = YOLO('yolov8n.pt') # 训练配置 model.train( data='dataset.yaml', epochs=100, imgsz=640, batch=16, device=0, # 使用GPU workers=4, patience=10 )

8.3 模型评估与优化

训练完成后评估模型性能：

# 验证模型 metrics = model.val() print(f"mAP50-95: {metrics.box.map}") # mAP50-95 print(f"mAP50: {metrics.box.map50}") # mAP50 # 导出为不同格式 model.export(format='onnx') # ONNX格式 model.export(format='engine') # TensorRT格式

9. 常见问题与排查方法

9.1 性能优化技巧

针对低配置硬件：

• 使用YOLOv8n等轻量模型
• 降低检测分辨率（640x480）
• 关闭界面特效
• 使用CPU推理模式

针对高精度需求：

• 使用YOLOv8x等大型模型
• 提高输入分辨率（1280x720以上）
• 调整参数获得最佳召回率

10. 部署建议与最佳实践

10.1 生产环境部署

硬件选型建议：

• 边缘设备：NVIDIA Jetson系列
• 服务器：RTX 3060 12G或以上
• 摄像头：1080p以上分辨率，支持RTSP协议

网络架构：

摄像头 → 边缘计算设备 → 检测结果 → 云平台 → 管理终端

10.2 系统集成方案

系统可以与其他零售管理系统集成：

数据流集成：

• 检测结果通过MQTT发送到消息队列
• 与库存管理系统API对接
• 生成补货工单自动派发

告警机制：

• 设置空货架持续时间阈值
• 多摄像头协同检测
• 分级告警（紧急/重要/一般）

10.3 维护与监控

日常维护：

• 定期更新模型适应场景变化
• 监控系统性能和日志
• 备份配置和检测数据

性能监控指标：

• 检测准确率变化趋势
• 系统响应时间
• 硬件资源使用率

这个YOLOv8超市空货架识别系统提供了一个完整的零售AI检测解决方案，从技术验证到生产部署都有很好的参考价值。项目代码结构清晰，文档完整，特别适合作为计算机视觉项目的学习案例和商业应用的起点。

在实际使用中，建议先在小范围测试各种场景的检测效果，根据具体需求调整参数和优化模型。系统的模块化设计也便于二次开发，可以在此基础上扩展更多零售相关的AI检测功能。