Doni/safesight
6
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
06eab42403
safesight/docs
History
tian 06eab42403 docs: 清理过时文档，简化目录结构 
删除（过时/重复/未采用）:
- archive/ 源码片段 dump(2)
- workshop_ai/ 合成数据标注临时工作(6, 2026-04 阶段已过)
- design/theme-preview-*.html UI主题预览(3)
- design/PRD_02 React前端PRD(实际UI用Go模板, 未采用)
- requirements/guide.md 过时命令笔记(与guides/命令.md重复)

合并: architecture/ 2个文档并入 design/
目录由 10 个子目录简化为 7 个:
deployment requirements design implementation bugfix testing guides
2026-08-02 11:32:22 +08:00
..
bugfix docs: 规范化文档目录结构 2026-08-02 11:28:51 +08:00
deployment docs: 部署文档归入 docs/deployment/ 子目录 2026-08-02 11:30:03 +08:00
design docs: 清理过时文档，简化目录结构 2026-08-02 11:32:22 +08:00
guides docs: 规范化文档目录结构 2026-08-02 11:28:51 +08:00
implementation docs: 规范化文档目录结构 2026-08-02 11:28:51 +08:00
requirements docs: 清理过时文档，简化目录结构 2026-08-02 11:32:22 +08:00
testing docs: 规范化文档目录结构 2026-08-02 11:28:51 +08:00
README.md docs: 清理过时文档，简化目录结构 2026-08-02 11:32:22 +08:00

README.md

SafeSight — AI 视觉安全监测平台

Safe Sight, Safe Production. 以 AI 视觉算法驱动的工业安全生产监测平台。

仓库结构（单仓库）

safesight/                      ← 唯一代码仓库（历史来自 safesight-edge + safesight-control）
├── VERSION                     ← 设备端主版本号（发版修改）
├── agent/                      → 边缘代理（Go）：UDP 发现、模型管理、agent API
├── include/ src/               → 媒体引擎（C++）：视频 DAG 流水线、NPU 推理、推流报警
├── scripts/                    → 设备端部署/运维脚本（deploy.sh、setup-overlayroot.sh 等）
├── control/                    → 管理端（原 safesight-control 仓库，完整保留）
│   ├── VERSION                 ← 管理端主版本号
│   ├── cmd/ internal/          → safesightd：Web UI / HTTP API / 设备管理
│   └── scripts/                → 管理端构建/打包脚本
├── docs/                       → 文档（导航 + 按内容分类）
│   ├── README.md               ← 本导航
│   ├── deployment/             → 部署（主手册/管理端部署/现场检查表/离线部署）
│   ├── requirements/           → 需求（集成方案、功能差距、规划）
│   ├── design/                 → 设计（PRD、架构、接口、方案）
│   ├── implementation/         → 实施（计划、跟踪）
│   ├── bugfix/                 → 缺陷修复记录
│   ├── testing/                → 测试（压测报告、测试设备）
│   └── guides/                 → 操作指南（配置、模型、命令、依赖、调试）
└── third_party/ models/ web/   → 设备端依赖与资源

快速导航

想做什么 看这里
产品镜像制作 / 批量部署 / 断电保护 docs/deployment/deployment.md（主手册）
现场施工清单 docs/deployment/客户现场部署检查表.md
管理端安装打包 docs/deployment/control-deployment.md
模型命名与资产说明 docs/guides/models.md
依赖安装 docs/guides/dependencies.md
配置指南 docs/guides/config_guide.md
缺陷修复记录 docs/bugfix/
设备端部署脚本 scripts/deploy.sh（部署到设备后位于 /opt/safesight-edge-server/scripts/）
管理端构建 control/scripts/package.sh

版本机制（双层）

  • 主版本号：各端根目录 VERSION 文件（如 1.0.0），发版改文件即可，不依赖 git tag
  • 构建号：构建时自动注入 YYYYMMDD.HHMMSS，区分大量小版本迭代
  • git sha：自动注入，精确定位代码

设备端列表页显示 V1.0.0，详情页显示 V1.0.0 (build 20260801.171659 · 923ab10)。

合并历史说明

本仓库由 safesight-edge（设备端）与 safesight-control（管理端）通过 git subtree 合并：

  • 仓库根 = 原 safesight-edge（其 git 历史、tag v1.0.0 保留）
  • control/ = 原 safesight-control（其 git 历史、tag v1.0.0 保留）
  • 合并提交：98e375d

快速开始

管理端（control/）

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

设备端

# 编译 Agent
cd agent
go build -o safesight-edge-agent ./cmd/safesight-agent

# 编译 Media Engine（RK3588 板载编译）
cd ..
bash scripts/build.sh -m -j4
./build/safesight-edge-server --config configs/sample_cam1.json