48 lines
2.9 KiB
Markdown
48 lines
2.9 KiB
Markdown
# Silver Pose V2 现场演示与发布手册
|
||
|
||
## 适用范围
|
||
|
||
本手册只适用于单路、固定机位、向下俯视且人员全身大部分可见的大厅或走廊。系统用 Pose 关键点和持续倒地事件规则触发报警，不是医疗诊断，也不承诺室外斜视、强遮挡、字幕视频或任意公共场景的效果。
|
||
|
||
## 发布前构建
|
||
|
||
在 `v2/` 目录执行下列命令，所有路径均为本机可信发布输入。脚本要求目标目录不存在或为空，并生成 `runtime-manifest.json` 记录实际 SHA-256 和工具版本：
|
||
|
||
```powershell
|
||
./scripts/build-v2-release.ps1 `
|
||
-OnnxPath <locked-best.onnx> `
|
||
-OrtDllPath <release-onnxruntime.dll> `
|
||
-FfmpegPath <ffmpeg.exe> `
|
||
-FfprobePath <ffprobe.exe> `
|
||
-OutputDirectory <empty-release-folder>
|
||
```
|
||
|
||
发布目录包含 `silver-pose.exe`、`runtime/`、公开 `config.example.json`、本手册和运行时哈希清单。不要把真实摄像头地址、密码、客户录像、事件截图或本机 `config.local.json` 放进发布目录。
|
||
|
||
## 本机安全配置
|
||
|
||
1. 从 `config.example.json` 复制为未提交的 `config.local.json`。
|
||
2. 使用发布目录中的 `runtime-manifest.json` 把 `model.sha256` 填为 `runtime/best.onnx` 的实际 SHA-256。
|
||
3. 在当前 PowerShell 会话设置 RTSP 环境变量；不要把命令、地址或密码复制进仓库、截图或 JSONL。
|
||
|
||
```powershell
|
||
$env:SILVER_POSE_RTSP_URL = '<本机安全 RTSP 地址>'
|
||
.\silver-pose.exe --config .\config.local.json
|
||
```
|
||
|
||
设置页只显示环境变量名称和是否就绪，不显示解析后的地址或密码。开始监控后，配置快照固定；若要修改事件参数，请停止监控、修改本地文件，再重新开始。
|
||
|
||
## 客户演示顺序
|
||
|
||
1. 启动后确认“视频流：在线”，实时画面出现人员骨架和 ID；正常状态不是红色。
|
||
2. 演示走动、坐下、弯腰、捡物和短暂停留，确认没有 `CONFIRMED`、声音、弹窗或新证据。
|
||
3. 在现场负责人同意与安全防护下，安排成年人在画面中从站立/行走转为持续倒地。目标确认延迟是 1–3 秒；确认后应出现红色姿态和边框、一次 Windows 声音、一次确认弹窗，以及一张 PNG 和一条 JSONL。
|
||
4. 保持倒地画面，确认同一 `event_id` 不重复声音、弹窗、截图或 JSONL。恢复稳定站立后才允许新的事件。
|
||
5. 暂停流或断开网络，确认界面显示正在重连且没有红色摔倒告警；恢复流后回到在线。
|
||
|
||
事件证据位于本机 `artifacts/events/YYYYMMDD/`：PNG 文件名仅含事件 ID，`events.jsonl` 可核查来源 ID、配置版本、确认时间和延迟。它们是本地工件，不提交。
|
||
|
||
## 交付验收记录
|
||
|
||
记录发布目录的 `runtime-manifest.json`、Windows/Go 版本、摄像头安装高度与角度、正反例动作结果、确认延迟、断流恢复结果和操作者。不要记录 RTSP URL、账号、密码、序列号或客户个人信息。
|