# 人流检测项目中文说明

这个项目用于基于 `YOLO + DeepFace` 的视频/RTSP 人流检测与属性统计。

## 当前交付方式

这个版本已经改成：

- 使用 `config/local.yaml` 作为本地运行配置
- 使用 `scripts/run.sh` 生成本地配置并前台运行
- 使用 `systemd` 托管长期运行
- 安装完成后自动启动
- 开机自动启动

## 目标机器

- `Ubuntu 24.04`
- `Python 3.12`
- NVIDIA 显卡可用
- `nvidia-smi` 可正常执行

## 安装前需要修改

先编辑 `scripts/run.sh`，至少改：

- `RTSP_URL`
- `OUTPUT_DIR`

## 安装

在项目根目录执行：

```bash
sudo bash scripts/install.sh
```

安装脚本会自动：

- 检查并安装 `ffmpeg`
- 检查并安装 `python3.12-venv`
- 创建 `.venv`
- 安装 Python 依赖
- 复制 DeepFace 权重到 `~/.deepface/weights`
- 生成 `config/local.yaml`
- 安装 `systemd` 服务
- 自动启动服务
- 设置开机自启

## 服务管理

服务名：

```bash
people-flow.service
```

常用命令：

```bash
sudo systemctl status people-flow.service
sudo systemctl restart people-flow.service
sudo systemctl stop people-flow.service
sudo systemctl start people-flow.service
sudo systemctl disable people-flow.service
```

## 输出位置

- 运行日志：`outputs/rtsp_run.log`
- 最新半小时汇总：`OUTPUT_DIR/rtsp_stream/latest.json`
- 历史窗口汇总：`OUTPUT_DIR/rtsp_stream/windows/`
- 本地配置：`config/local.yaml`