tian
cefc155614
- 根目录新增 CHANGELOG.md（Keep a Changelog 风格）: v1.0.0 里程碑（单仓库合并/断电保护/产品镜像/版本机制）+ 早期历史迁移 - 删除 edge/CHANGELOG.md（内容并入根） - VERSION 保持 edge/ + control/ 两端独立（构建机制依赖，发布节奏不同） - control/AGENTS.md: managerd→safesightd、旧路径→新单仓库路径、文档引用更新 |
||
|---|---|---|
| control | ||
| docs | ||
| edge | ||
| .gitignore | ||
| CHANGELOG.md | ||
| README.md | ||
SafeSight — AI 视觉安全监测平台
Safe Sight, Safe Production. 以 AI 视觉算法驱动的工业安全生产监测平台。
仓库结构
safesight/
├── README.md ← 本导航
├── docs/ ← 文档（索引见 docs/README.md）
├── edge/ ← 设备端（RK3588 边缘计算）
│ ├── VERSION ← 设备端主版本号
│ ├── agent/ → 边缘代理（Go）：UDP 发现、模型管理、agent API
│ ├── include/ src/ → 媒体引擎（C++）：视频 DAG、NPU 推理、推流报警
│ ├── scripts/ → 部署/运维脚本（deploy.sh、setup-overlayroot.sh 等）
│ ├── configs/ models/ web/ third_party/
│ └── tools/ train/ tests/ test_assets/
└── control/ ← 管理端（safesightd，Go）
├── VERSION ← 管理端主版本号
├── cmd/ internal/ → Web UI / HTTP API / 设备管理
├── scripts/ tools/ → 构建打包、人脸库工具
├── models/ → 标准模型库（下发用）
└── deps/ → 离线依赖（onnxruntime 等）
快速导航
| 想做什么 | 看这里 |
|---|---|
| 产品镜像制作 / 批量部署 / 断电保护 | docs/deployment/deployment.md（主手册） |
| 文档索引 | docs/README.md |
| 管理端安装打包 | docs/deployment/control-deployment.md |
| 设备端部署 | edge/scripts/deploy.sh |
| 管理端构建 | control/scripts/package.sh |
快速开始
管理端（control/）
cd control
go build -o safesightd.exe ./cmd/safesightd
./safesightd
# 访问 http://localhost:18080/ui
设备端（edge/）
# 编译 Agent
cd edge/agent
go build -o safesight-edge-agent ./cmd/safesight-agent
# 编译 Media Engine（RK3588 板载编译）
cd edge
bash scripts/build.sh -m -j4
./build/safesight-edge-server --config configs/sample_cam1.json
版本机制（双层）
- 主版本号：各端
VERSION文件（如1.0.0），发版改文件即可，不依赖 git tag - 构建号：构建时自动注入
YYYYMMDD.HHMMSS，区分大量小版本迭代 - git sha：自动注入，精确定位代码
设备端列表页显示 V1.0.0，详情页显示 V1.0.0 (build 20260801.171659 · 923ab10)。
历史说明
本仓库由原 safesight-edge（设备端）与 safesight-control（管理端）合并而来：
edge/= 原 safesight-edge（git 历史、tag v1.0.0 保留）control/= 原 safesight-control（git 历史、tag v1.0.0 保留）- 合并提交：
98e375d