1. 项目概述：当YOLO遇上危险物品检测

去年在机场安检口排队时，看到安检员盯着X光机屏幕连续工作数小时后明显疲惫的状态，让我萌生了开发智能危险物品检测系统的想法。这套系统基于YOLO系列目标检测算法，结合PySide6开发的图形界面，能够自动识别刀具、枪支、易燃液体等常见违禁品。不同于学术论文中的理想化方案，我们这次要打造的是真正可落地的工业级解决方案——包含完整的模型选型对比、数据集构建方法、训练技巧和可视化界面开发全流程。

2. 技术选型：YOLO家族进化论

2.1 YOLO版本横向对比

在项目启动阶段，我们测试了从v5到v8四个主流版本的表现（测试环境：RTX 3090，COCO数据集）：

实际选择建议：追求部署效率选v5，要最高精度选v8，边缘设备考虑v5s/v8n等轻量变体

2.2 PySide6的GUI优势

相比PyQt5，PySide6具有：

• 更宽松的LGPL协议
• 原生支持Python类型提示
• 更现代的QML集成
• 线程管理更友好

# 典型界面框架代码 from PySide6.QtWidgets import QApplication, QMainWindow from PySide6.QtCore import QTimer class DetectionApp(QMainWindow): def __init__(self): super().__init__() self.model = YOLO('yolov8n.pt') # 加载预训练模型 self.init_ui() self.cap = cv2.VideoCapture(0) # 摄像头 def init_ui(self): self.setWindowTitle("危险物品检测系统") self.video_label = QLabel(self) # 视频显示区域 self.result_table = QTableWidget(10, 3) # 检测结果表格 # ...其他界面元素

3. 数据集构建实战

3.1 数据采集的坑与经验

我们采用"三源合一"的数据策略：

1. 公开数据集：X光安检公开数据集（约5,000张）
2. 网络爬取：使用selenium+BeautifulSoup爬取特定论坛图片（注意法律风险）
3. 自建采集：用工业相机模拟不同角度/光照条件拍摄

特别注意：刀具类物品需包含直刀、折刀、陶瓷刀等变种；液体容器要区分金属/玻璃/塑料材质

3.2 数据标注规范

使用LabelImg标注时遵循：

• 最小外接矩形原则
• 遮挡超过50%的物体不标注
• 同类物品不同形态单独分类（如折叠/展开的刀具）
• 标注文件采用YOLO格式：

  <class_id> <x_center> <y_center> <width> <height>

3.3 数据增强策略

在albumentations中配置的增强管道：

transform = A.Compose([ A.HorizontalFlip(p=0.5), A.RandomBrightnessContrast(p=0.2), A.MotionBlur(blur_limit=3, p=0.1), A.RandomSizedBBoxSafeCrop(512, 512, p=0.5), A.HueSaturationValue(hue_shift_limit=20, sat_shift_limit=30, val_shift_limit=20, p=0.5) ], bbox_params=A.BboxParams(format='yolo'))

4. 模型训练核心技巧

4.1 超参数调优公式

学习率计算采用线性缩放规则：

base_lr = 0.01 effective_lr = base_lr * (batch_size / 64)

训练中发现的关键参数组合：

lr0: 0.01 # 初始学习率 lrf: 0.2 # 最终学习率 = lr0 * lrf momentum: 0.937 weight_decay: 0.0005 warmup_epochs: 3.0 warmup_momentum: 0.8

4.2 改进检测头的trick

针对小物体检测的优化：

1. 在Neck部分添加SPPF模块
2. 使用BiFPN代替原FPN
3. 输出层增加小尺度检测头

# YOLOv8自定义头示例 class CustomHead(nn.Module): def __init__(self, ch_in, ch_out): super().__init__() self.conv1 = Conv(ch_in, ch_in//2, 3) self.upsample = nn.Upsample(scale_factor=2) self.conv2 = Conv(ch_in//2, ch_out, 1) def forward(self, x): return self.conv2(self.upsample(self.conv1(x)))

5. PySide6界面开发详解

5.1 多线程处理架构

为避免界面卡顿，采用生产者-消费者模式：

Camera Thread → 帧缓冲区 ← Detection Thread → 结果队列 → UI Thread

关键实现代码：

class DetectionThread(QThread): result_signal = Signal(list) def __init__(self, model): super().__init__() self.model = model def run(self): while True: frame = buffer.get_frame() results = self.model(frame) self.result_signal.emit(results) class MainWindow(QMainWindow): def __init__(self): # ...初始化代码 self.det_thread = DetectionThread(model) self.det_thread.result_signal.connect(self.update_ui)

5.2 性能优化技巧

1. 使用QPixmap的fromImage替代直接绘制
2. 对检测结果做时间域滤波（α-β滤波）
3. 启用OpenGL加速：

   QApplication.setAttribute(Qt.AA_UseOpenGLES)

6. 部署实战与性能调优

6.1 ONNX转换关键参数

torch.onnx.export( model, dummy_input, "model.onnx", opset_version=12, do_constant_folding=True, input_names=['images'], output_names=['output'], dynamic_axes={ 'images': {0: 'batch'}, 'output': {0: 'batch'} } )

6.2 TensorRT加速配置

trtexec --onnx=model.onnx \ --saveEngine=model.engine \ --fp16 \ --workspace=4096 \ --minShapes=images:1x3x640x640 \ --optShapes=images:8x3x640x640 \ --maxShapes=images:32x3x640x640

7. 避坑指南：血泪教训总结

1. 标注质量问题：早期版本误检率高，发现是标注时未区分刀具正反面
2. 光照影响：添加HSV色彩扰动后，金属物品检测准确率提升27%
3. 内存泄漏：PySide6的QImage需要手动清理
4. 模型量化陷阱：int8量化会导致小物体检测性能骤降，建议关键层保持fp16

8. 效果展示与改进方向

当前系统在自建测试集上的表现：

• 刀具类：mAP@0.5=0.89
• 枪支类：mAP@0.5=0.92
• 液体类：mAP@0.5=0.76

下一步优化计划：

1. 引入注意力机制提升小物体检测
2. 开发基于3D点云的体积检测模块
3. 实现多摄像头协同检测