managed-portal/managed/store_dwell_alert/README_zh.md

店内停留报警项目中文说明

这个项目用于单路店内 RTSP 摄像头的人体检测、停留计时和本地 JSON 事件输出。

功能

• 基于 YOLO11n 的店内人员检测与跟踪
• 停留时长统计
• 短暂离开后重关联
• 店员白名单排除
• 半小时统计
• 本地 JSONL 事件输出
• 安装完成后自动启动
• 开机自动启动

目标机器

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

安装前需要修改

先编辑 scripts/run.sh，至少改这几个变量：

• RTSP_URL
• CAMERA_ID
• EVENT_SINK_PATH

安装

在项目根目录执行：

sudo bash scripts/install.sh

安装脚本会自动：

• 检查并安装 ffmpeg
• 检查并安装 python3.12-venv
• 创建 .venv
• 离线安装 wheelhouse/ 中的依赖
• 生成 config/local.yaml
• 安装 systemd 服务
• 自动启动服务
• 设置开机自启

服务管理

服务名：

store-dwell-alert.service

常用命令：

sudo systemctl status store-dwell-alert.service
sudo systemctl restart store-dwell-alert.service
sudo systemctl stop store-dwell-alert.service
sudo systemctl start store-dwell-alert.service
sudo systemctl disable store-dwell-alert.service

输出位置

• 运行日志：logs/runtime.log
• 事件结果：logs/events.jsonl
• 本地配置：config/local.yaml
• 店员图库：data/staff_gallery/