managed-portal/managed/people_flow_project/README_zh.md

人流检测项目中文说明

这个项目用于基于 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

安装

在项目根目录执行：

sudo bash scripts/install.sh

安装脚本会自动：

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

服务管理

服务名：

people-flow.service

常用命令：

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