# 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/）

```bash
cd control
go build -o safesightd.exe ./cmd/safesightd
./safesightd
# 访问 http://localhost:18080/ui
```

### 设备端（edge/）

```bash
# 编译 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`