摘要

扑克牌识别是计算机视觉在智能娱乐、棋牌辅助分析、自动化发牌系统等应用中的关键任务。本文基于YOLO26目标检测算法，构建了一个面向52类扑克牌（含点数与花色组合）的端到端识别检测系统。实验采用自建扑克牌图像数据集，其中训练集21,203张、验证集2,020张、测试集1,010张。模型在验证集上的实验结果表明：平均精度mAP50达到0.995，精确度与召回率分别高达0.998和0.997，且所有类别表现高度均衡，混淆矩阵显示无任何类别间误判。模型在NVIDIA RTX 4090 D GPU上的推理时间仅为1.8ms/张，满足实时检测需求。整体而言，所提系统在扑克牌识别任务中达到了接近完美的检测性能，具备良好的工程实用价值。

目录

  摘要

详细功能展示视频

功能模块

1、用户管理模块

2、界面与交互模块

3、检测源管理模块

4、检测参数配置模块

5、YOLO检测核心模块

6、结果显示模块

7、结果保存模块

8、工具栏功能

9、辅助功能

10、数据校验模块

引言

背景

数据集介绍

训练结果

1. 核心性能指标 (总体评价：优秀)​编辑

2. 各类别性能分析 (极其均衡)

3. 损失函数与收敛情况 (训练过程健康)

4. 混淆矩阵分析 (几乎零错误)​编辑

5. 置信度曲线分析

Ultralytics YOLO26

概述

主要功能

常用标注工具

详细功能展示视频

---

功能模块

✅ 用户登录注册：支持密码检测，密码加密。

注册

登录

✅ 图片检测：可对图片进行检测，返回检测框及类别信息。

✅ 参数实时调节（置信度和IoU阈值）

✅ 支持选择检测目标：可以选择一个或者多个类目的目标进行检测

✅ 视频检测：支持视频文件输入，检测视频中每一帧的情况。

✅ 摄像头实时检测：连接USB 摄像头，实现实时监测。

✅日志记录：日志标签页记录操作和错误信息，带时间戳

✅结果保存模块：支持图片/视频/摄像头检测结果保存

1、用户管理模块

功能	描述
用户注册	用户名、密码、确认密码、邮箱（选填）注册，密码SHA256加密存储
用户登录	用户名密码验证，自动跳转主界面
用户数据存储	JSON文件存储用户信息（密码加密、注册时间、邮箱）
登录状态	主界面显示当前登录用户名

2、界面与交互模块

功能	描述
玻璃效果界面	半透明毛玻璃背景，圆角边框，现代化视觉风格
无边框窗口	自定义标题栏，支持窗口拖动、最小化、最大化、关闭
响应式布局	主窗口三栏布局（左侧控制区、中央显示区、右侧信息区）
状态栏	显示设备信息、模型状态、当前用户、实时时间

3、检测源管理模块

功能	描述
图片检测	支持JPG/JPEG/PNG/BMP格式图片载入
视频检测	支持MP4/AVI/MOV/MKV格式视频载入
摄像头检测	实时调用摄像头（默认ID 0）进行检测
检测源切换	下拉菜单切换三种检测模式，自动更新界面状态

4、检测参数配置模块

功能	描述
置信度阈值	滑动条调节（0-100%，步长1%），实时显示当前值
IoU阈值	滑动条调节（0-100%，步长1%），实时显示当前值
类别选择	动态生成检测类别复选框，支持全选/取消全选
参数同步	参数实时同步到检测器核心

5、YOLO检测核心模块

功能	描述
模型加载	加载best.pt模型文件，自动检测GPU可用性，支持CPU/GPU切换
多模式检测	图片检测、视频检测、摄像头实时检测
检测线程	基于QThread的多线程处理，避免界面卡顿
检测结果	返回目标类别、置信度、边界框坐标
FPS计算	实时计算处理帧率
进度反馈	视频处理进度条实时更新

6、结果显示模块

功能	描述
实时画面	中央区域显示检测结果图像（带标注框）
统计信息	检测状态、目标数量、FPS、处理帧数实时更新
检测列表	右侧列表显示当前帧所有检测到的目标（类别+置信度）
日志记录	日志标签页记录操作和错误信息，带时间戳
占位显示	未选择检测源时显示系统LOGO和提示文字

7、结果保存模块

功能	描述
保存开关	复选框控制是否保存检测结果
路径选择	自定义保存路径，支持图片/视频格式自动识别
自动命名	保存文件自动添加时间戳（detection_result_20240101_120000.jpg）
视频保存	支持检测结果视频录制（MP4格式）
手动保存	工具栏保存按钮可随时保存当前画面
保存反馈	保存成功弹窗提示，日志记录保存路径

8、工具栏功能

功能	描述
图片按钮	快速切换到图片检测模式并打开文件选择器
视频按钮	快速切换到视频检测模式并打开文件选择器
摄像头按钮	快速切换到摄像头检测模式
保存按钮	手动保存当前显示画面

9、辅助功能

功能	描述
错误处理	统一错误弹窗提示，日志记录错误详情
资源清理	检测停止时自动释放摄像头、视频文件、视频写入器资源
时间显示	状态栏实时显示系统时间
模型状态	状态栏显示模型加载状态和当前设备（CPU/GPU）

10、数据校验模块

功能	描述
注册验证	用户名长度≥3，密码长度≥6，密码一致性检查，邮箱格式验证
协议确认	注册前需勾选同意用户协议
文件校验	模型文件存在性检查，文件大小验证（≥6MB）
输入非空	登录/注册时必填项非空检查

引言

近年来，随着计算机视觉与深度学习技术的快速发展，目标检测算法在工业质检、自动驾驶、智能监控等领域取得了广泛应用。与此同时，棋牌娱乐场景中的自动化识别需求也日益增加，例如智能牌桌、在线棋牌教学、比赛辅助判罚等。扑克牌作为全球通用的娱乐工具，其识别系统不仅要应对复杂的背景、光照变化、视角差异，还需精确区分点数与花色的52种组合。

传统的扑克牌识别方法往往依赖颜色分割、模板匹配或SIFT特征等传统图像处理技术，在复杂场景下鲁棒性不足，且难以扩展至多种牌面风格。而基于深度学习的目标检测方法，尤其是YOLO系列算法，凭借其端到端的回归思想与优异的实时性能，成为解决该类细粒度多类别识别任务的理想选择。

本文以YOLO26为骨干网络，构建了一套完整的扑克牌识别检测系统。通过大规模自建数据集、精细化标注与系统训练，模型在验证集上表现出极高的准确率与召回率。本文后续将系统介绍任务背景、数据集构建方法、实验结果分析等内容，旨在为智能扑克牌识别系统的工程落地提供参考。

背景

扑克牌识别作为细粒度目标检测的一个典型子任务，在计算机视觉领域具有独特的研究价值与广泛的应用前景。从应用层面来看，扑克牌识别系统可以被集成到多种实际场景中。首先，在智能棋牌设备领域，自动发牌机、智能牌桌以及棋牌辅助机器人等设备需要对牌面进行实时感知，以实现自动化洗牌、发牌、计分等功能。这些设备要求视觉系统具备高精度、低延迟以及在不同光线、角度和遮挡条件下的鲁棒性。其次，在线上娱乐与教学平台中，通过摄像头实时识别玩家手中的牌面，可以实现自动记录出牌、违规检测以及AI陪玩等功能，提升用户体验和平台自动化水平。此外，在竞技比赛辅助判罚场景中，扑克牌识别系统可用于回放分析、异常行为监测及比赛数据统计，减轻人工裁判负担，提升判罚公正性。

从技术难度来看，扑克牌识别并非一个简单的图像分类问题，而是一个典型的细粒度多类别目标检测问题。一副标准扑克牌包含52张不同点数与花色的组合，分别对应四种花色（梅花、方块、红桃、黑桃）与13种点数（A, 2-10, J, Q, K）。不同牌面之间的视觉差异可能非常微小，例如“10C”与“10D”仅在花色图样上有局部不同，而整体结构高度相似。这对检测算法提出了极高的判别能力要求。同时，在实际应用环境中，牌面可能发生倾斜、部分遮挡、反光、阴影或存在多张牌堆叠的情况，进一步加剧了识别难度。因此，传统的基于颜色直方图、边缘检测或模板匹配的方法难以满足鲁棒性要求。

近年来，基于深度学习的目标检测技术取得了显著突破。其中，YOLO系列算法以“You Only Look Once”的回归思想，将目标定位与分类统一为一个回归问题，实现了极高的检测速度与良好的精度平衡。

数据集介绍

本实验所使用的扑克牌图像数据集为自建数据集，覆盖标准扑克牌的全部52种牌面类型。数据集的构建过程包括图像采集、数据增强、人工标注与数据集划分四个主要环节。

• 类别定义：数据集共包含52个类别，每个类别由点数与花色组合而成。点数包括A、2–10、J、Q、K，花色包括C（梅花）、D（方块）、H（红桃）、S（黑桃）。类别标签示例为：10C、10D、10H、10S、2C、2D、2H、2S、……、KC、KD、KH、KS、QC、QD、QH、QS。所有类别严格对应标准扑克牌牌面。

训练结果

1. 核心性能指标 (总体评价：优秀)

• mAP50 (0.995)：这意味着当IoU阈值设为0.5时，模型的平均精度达到了99.5%。这是一个极高的数值，表明模型能够非常准确地定位和识别扑克牌。

• mAP50-95 (0.851)：这是更严格的指标，计算了从IoU 0.5到0.95的平均值。0.851是一个很强的结果，说明模型预测的边界框与真实框的重合度非常高。

• 精确度 (0.998) & 召回率 (0.997)：这两个指标都非常接近1.0。说明模型几乎不错检，也几乎没有漏检。

2. 各类别性能分析 (极其均衡)

• 所有类别表现一致：从表格中可以看到，10C, 2S, 4H 等所有52个类别的 mAP50 都稳定在 0.991 - 0.996 之间，精确度和召回率绝大多数为1.0或接近1.0。

• 无弱势类别：在目标检测中，通常会有一些“难学”的类别（比如容易混淆的牌面），但这里所有类别表现几乎一样好，说明数据集质量高，且模型区分能力很强。

3. 损失函数与收敛情况 (训练过程健康)

查看 results.png 中的曲线：

• 训练/验证损失：train/box_loss, train/cls_loss, val/box_loss, val/cls_loss 四条曲线均呈现平滑下降并最终趋于平稳。没有出现震荡或上升，说明模型训练稳定，没有过拟合。

• 性能指标曲线：metrics/precision, metrics/recall, metrics/mAP50, metrics/mAP50-95 四条曲线均快速上升并稳定在高位。

4. 混淆矩阵分析 (几乎零错误)

• confusion_matrix_normalized.png：这是一个完美的矩阵。对角线上的颜色均为最深的1.0，而非对角线区域完全是白色（0.0）。

• 结论：模型在测试集上没有将任意一张牌错误地识别成另一张牌。所有预测的类别都是正确的。

5. 置信度曲线分析

• F1-Confidence曲线：最佳F1分数为1.00，对应的置信度阈值为0.621。这意味着在很宽的置信度范围内模型表现都很好。

• Precision-Confidence曲线：精确度在置信度高于0.9时才出现轻微下降，但在0.941时仍保持1.00。说明模型对自己的正确预测非常有信心。

• Recall-Confidence曲线：召回率在置信度达到0.5之前一直保持1.00。说明模型即使在不那么自信（0.5置信度）的情况下，也能找出所有真实目标。

Ultralytics YOLO26

概述

Ultralytics  YOLO26 是 YOLO 系列实时对象检测器的最新演进，从头开始专为边缘和低功耗设备而设计。它引入了简化的设计，消除了不必要的复杂性，同时集成了有针对性的创新，以实现更快、更轻、更易于访问的部署。

YOLO26 的架构遵循三个核心原则：

• 简洁性: YOLO26是一个原生的端到端模型，直接生成预测结果，无需非极大值抑制（NMS）。通过消除这一后处理步骤，推理变得更快、更轻量，并且更容易部署到实际系统中。这种突破性方法最初由清华大学的王傲在YOLOv10中开创，并在YOLO26中得到了进一步发展。
• 部署效率： 端到端设计消除了管道的整个阶段，从而大大简化了集成，减少了延迟，并使部署在各种环境中更加稳健。
• 训练创新：YOLO26 引入了MuSGD 优化器，它是SGD 和MUON的混合体——灵感来源于 Moonshot AI 在 LLM 训练中Kimi K2的突破。该优化器带来了增强的稳定性和更快的收敛，将语言模型中的优化进展转移到计算机视觉领域。
• 任务特定优化：YOLO26 针对专业任务引入了有针对性的改进，包括用于 Segmentation 的语义分割损失和多尺度原型模块，用于高精度 姿势估计 的残差对数似然估计 (RLE)，以及通过角度损失优化解码以解决 旋转框检测 中的边界问题。

这些创新共同提供了一个模型系列，该模型系列在小对象上实现了更高的精度，提供了无缝部署，并且在 CPU 上的运行速度提高了 43% — 使 YOLO26 成为迄今为止资源受限环境中最实用和可部署的 YOLO 模型之一。

主要功能

• DFL 移除
  分布式焦点损失（DFL）模块虽然有效，但常常使导出复杂化并限制了硬件兼容性。YOLO26 完全移除了 DFL，简化了推理过程，并拓宽了对边缘和低功耗设备的支持。

• 端到端无NMS推理
  与依赖NMS作为独立后处理步骤的传统检测器不同，YOLO26是原生端到端的。预测结果直接生成，减少了延迟，并使集成到生产系统更快、更轻量、更可靠。

• ProgLoss + STAL
  改进的损失函数提高了检测精度，在小目标识别方面有显著改进，这是物联网、机器人、航空影像和其他边缘应用的关键要求。

• MuSGD Optimizer
  一种新型混合优化器，结合了SGD和Muon。灵感来自 Moonshot AI 的Kimi K2，MuSGD 将 LLM 训练中的先进优化方法引入计算机视觉，从而实现更稳定的训练和更快的收敛。

• CPU推理速度提升高达43%
  YOLO26专为边缘计算优化，提供显著更快的CPU推理，确保在没有GPU的设备上实现实时性能。

• 实例分割增强
  引入语义分割损失以改善模型收敛，以及升级的原型模块，该模块利用多尺度信息以获得卓越的掩膜质量。

• 精确姿势估计
  集​成残差对数似然估计​(RLE)，以实现更精确的关键点定位，并优化解码过程以提高推理速度。

• 优化旋转框检测解码
  引入专门的角度损失以提高方形物体的检测精度，并优化旋转框检测解码以解决边界不连续性问题。

常用标注工具

假设您现在准备好进行标注。有几种开源工具可以帮助简化数据标注流程。以下是一些有用的开放标注工具：

Label Studio：一个灵活的工具，支持各种标注任务，并包含用于管理项目和质量控制的功能。 CVAT：一个强大的工具，支持各种标注格式和可定制的工作流程，使其适用于复杂的项目。 Labelme：一个简单易用的工具，可以快速标注带有多边形的图像，非常适合简单的任务。 LabelImg: 一款易于使用的图形图像标注工具，特别适合以 YOLO 格式创建边界框标注。

这些开源工具经济实惠，并提供一系列功能来满足不同的标注需求。

界面核心代码：

详细功能展示视频