# rv1125b_project

**Repository Path**: pojcode/rv1125b_project

## Basic Information

- **Project Name**: rv1125b_project
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-29
- **Last Updated**: 2026-03-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 打架行为检测系统

基于 YOLOv8n + MediaPipe Pose 的 PC 端多路视频打架行为检测系统。

## 功能特性

- **多路视频并发处理**：支持 4-8 路本地视频文件同时输入，线程池调度
- **人员检测**：YOLOv8n 轻量化模型，仅检测 person 类别
- **人体关键点提取**：MediaPipe Pose 提取 33 个关键点，绘制火柴人骨架
- **打架行为分析**：基于多人姿态特征综合判断（距离、手臂姿态、运动幅度）
- **告警标红**：检测到打架时红色边框 + 顶部告警横幅
- **毛玻璃遮罩**：全帧高斯模糊 + 随机像素扰动（隐私保护）
- **轻量实时预览**：OpenCV imshow 多窗口实时预览
- **硬件适配预留**：检测器/关键点提取器抽象接口，便于替换 RKNN 模型

## 安装

```bash
pip install -r requirements.txt
```

## 使用

```bash
python -m src.main --config config/config.yaml --videos video1.mp4 video2.mp4
```

## 项目结构

```
src/
├── main.py              # 程序入口
├── config.py            # 配置加载
├── core/                # 核心调度与流水线
├── detectors/           # 人员检测（YOLOv8n）
├── pose/                # 人体关键点（MediaPipe Pose）
├── analyzer/            # 打架行为分析
├── visualizer/          # 可视化标注
├── io/                  # 视频读取
└── utils/               # 工具模块
```

## 配置说明

所有参数通过 `config/config.yaml` 管理，包括模型路径、并发数、打架判定阈值等。