141 lines
5.5 KiB
Markdown
141 lines
5.5 KiB
Markdown
Windows EXE 安装、离线授权与可重复构建见 [部署说明](deploy/windows/README.md)。
|
||
|
||
|
||
|
||
多路视频接入与智能布控分析平台。支持 GB28181 / RTSP、YOLO 小模型检测、OpenAI 兼容大模型复核、多边形布控与结构化报警。
|
||
|
||
---
|
||
|
||
## 功能
|
||
|
||
- 视频接入：RTSP / GB28181 拉流，ZLMediaKit 转发，ONVIF 发现
|
||
- 智能分析：YOLO-PyTorch / ONNX / OpenVINO 小模型 + 可选大模型复核
|
||
- 布控报警：多边形区域、5 种后处理规则（入侵/越线/方向/密度/滞留）
|
||
- 运维：控制面板监控、流媒体启停、录像、多语言（7 种）
|
||
|
||
---
|
||
|
||
## 环境要求
|
||
|
||
- Python 3.10+
|
||
- FFmpeg（PATH 或 `config.json` 配置）
|
||
- ZLMediaKit（流媒体，端口与 `config.json` 一致）
|
||
- GPU 可选
|
||
|
||
|
||
```bash
|
||
如果是Linux系统，需要手动进入到zlm/bin.x86.gcc9.4 或 zlm/bin.arm.gcc9.4 ，确保可以正确执行 ./monitor_zlm
|
||
|
||
|
||
如果执行./monitor_zlm失败了，可以参考下面的两种方式解决安装环境问题
|
||
|
||
（1）解决方式一
|
||
sudo chmod -R a+x *
|
||
echo "export LD_LIBRARY_PATH=\"$(pwd):\$LD_LIBRARY_PATH\"" >> ~/.bashrc && source ~/.bashrc
|
||
|
||
（2）解决方式二
|
||
|
||
sudo apt update
|
||
sudo apt install -y libsrtp2-1
|
||
|
||
//下载ubuntu20的libssl1.1包
|
||
wget http://security.ubuntu.com/ubuntu/pool/main/o/openssl/libssl1.1_1.1.1f-1ubuntu2.24_amd64.deb
|
||
sudo dpkg -i libssl1.1_1.1.1f-1ubuntu2.24_amd64.deb
|
||
|
||
//修复依赖
|
||
sudo apt -f install
|
||
|
||
```
|
||
|
||
**安装依赖：**
|
||
|
||
```bash
|
||
# Windows
|
||
pip install -r requirements-windows.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
|
||
或
|
||
pip install -r requirements-windows.txt
|
||
|
||
# Linux
|
||
pip install -r requirements-linux.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
|
||
或
|
||
pip install -r requirements-linux.txt
|
||
```
|
||
|
||
NVIDIA RTX 显卡可在基础依赖安装完成后启用本地 CUDA 推理：
|
||
|
||
```powershell
|
||
powershell -ExecutionPolicy Bypass -File scripts/enable-gpu.ps1
|
||
```
|
||
|
||
启用后在“小模型管理”中将 YOLO PyTorch 模型的推理设备设为 `CUDA`。共享推理 worker 默认设为 1，避免同一模型重复占用显存。
|
||
|
||
---
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
# 仅限本机开发环境；PowerShell 还需设置：
|
||
# $env:MONITOR_DEBUG="true"; $env:MONITOR_SERVICE_MODE="embedded"
|
||
export MONITOR_DEBUG=true
|
||
export MONITOR_SERVICE_MODE=embedded
|
||
python manage.py runserver 127.0.0.1:10001
|
||
```
|
||
|
||
浏览器访问 `http://127.0.0.1:10001/`。首次使用前先停止服务并执行
|
||
`python scripts/secure_initialize.py --admin-username admin`，交互式创建唯一管理员并轮换运行密钥。
|
||
管理端不得直接暴露到不可信网络；远程访问请使用 HTTPS 反向代理、IP 白名单和主机防火墙。
|
||
生产环境变量、RBAC、模型白名单和反向代理示例见
|
||
`docs/PHASE2_DATA_AND_CONTROL_PLANE_REMEDIATION.md` 和
|
||
`docs/PHASE3_LIFECYCLE_AND_TELEMETRY_REMEDIATION.md`。
|
||
|
||
首次部署请编辑 `config.json`（端口、ZLM、FFmpeg 等）和 `settings.json`（界面品牌）。启动配置页保存后多数项热更新生效；改管理端口或调试日志需重启服务。
|
||
|
||
---
|
||
|
||
## 使用顺序
|
||
|
||
```
|
||
视频管理 → 小模型 → 大模型 → 业务算法 → 布控管理 → 启动分析 → 报警管理
|
||
```
|
||
|
||
1. 添加摄像头并确认拉流正常
|
||
2. 上传/配置小模型（流程 1/3）和大模型（流程 2/3）
|
||
3. 创建业务算法，在布控页画区域并绑定算法
|
||
4. 点击「启动分析」（**重启服务后需手动再点**）
|
||
5. 在报警管理查看结果
|
||
|
||
> 只有业务算法规则命中才会报警；单纯检测到目标或画面运动不会产生报警记录。
|
||
|
||
---
|
||
|
||
## 常见问题
|
||
|
||
| 问题 | 处理 |
|
||
|------|------|
|
||
| 没有报警 | 确认拉流正常、布控已绑算法、已启动分析、检测类别匹配 |
|
||
| 改配置不生效 | 布控/算法可热更新；换小模型需重启分析；改端口需重启服务 |
|
||
| 端口占用 | 结束残留 `python.exe` 后重新启动 |
|
||
|
||
日志目录：`log/`。版本号见 `framework/settings.py`。
|
||
|
||
---
|
||
|
||
## 更新日志
|
||
|
||
### v1.003
|
||
- **业务算法选择大模型相关修复（重要）**
|
||
- 大模型配置新增「名称」字段，可留空；新增 / 编辑时若名称为空，自动以「模型名称」兜底（`name = model_name`），避免大模型配置出现空名称。
|
||
- 业务算法列表 / 编辑中，绑定大模型的显示名现在会回退到「模型名称」（`llm_name` 兜底 `name or model_name`），不再显示空白。
|
||
- **修复业务算法编辑时，绑定的大模型若已被禁用，下拉框无法回显、看似「配置丢失 / 选不中」的问题**：现在自动补一个带「[禁用]」标记的回显项，且每次打开编辑会清理上一次的回显项。
|
||
- 业务算法「大模型」下拉选项 label 改为 `name || model_name || #id`，确保只填了模型名称时也能正确显示。
|
||
- **新增「统计看板」（报警态势总览）**
|
||
- 报警管理新增「统计看板」页面（`/alarm/dashboard`），一站式掌握报警态势。
|
||
- 4 张核心统计卡：今日报警、近 7 天报警、累计报警、涉及摄像头数（均可点击下钻到对应列表）。
|
||
- 报警趋势图：支持近 7 天 / 近 30 天切换。
|
||
- 报警类型分布、报警 TOP 摄像头排行。
|
||
- 新增接口 `alarm/openStats`，左侧导航新增「统计看板」入口。
|
||
- **国际化补全**
|
||
- 补齐统计看板相关 16 个翻译键至全部 7 种语言（es / ko / ru / vi / zh-hk / zh / en），修复此前仅 zh / en 有译、其余语言界面显示原始 key 的问题。
|
||
|
||
> 版本号见 `framework/settings.py` 的 `PROJECT_VERSION`。
|