73 lines
1.4 KiB
Markdown
73 lines
1.4 KiB
Markdown
# 人流检测项目中文说明
|
|
|
|
这个项目用于基于 `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`
|