silver_pose/docs/v2-demo-runbook.md

# 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>
```

若操作者使用 `cmd.exe`，可使用同一目录的批处理入口；它只转发相同的五个参数给上述 PowerShell 脚本，并返回相同的成功或失败退出码：

```bat
scripts\build-v2-release.bat ^
  -OnnxPath <locked-best.onnx> ^
  -OrtDllPath <release-onnxruntime.dll> ^
  -FfmpegPath <ffmpeg.exe> ^
  -FfprobePath <ffprobe.exe> ^
  -OutputDirectory <empty-release-folder>
```

不要双击 `.bat` 文件；必须从已打开的 `cmd.exe` 或 PowerShell 调用，以便核对参数错误和生成结果。

发布目录包含 `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、账号、密码、序列号或客户个人信息。