silver_pose/docs/v2-demo-runbook.md

Silver Pose V2 现场演示与发布手册

适用范围

本手册只适用于单路、固定机位、向下俯视且人员全身大部分可见的大厅或走廊。系统用 Pose 关键点和持续倒地事件规则触发报警，不是医疗诊断，也不承诺室外斜视、强遮挡、字幕视频或任意公共场景的效果。

发布前构建

在 v2/ 目录执行下列命令，所有路径均为本机可信发布输入。脚本要求目标目录不存在或为空，并生成 runtime-manifest.json 记录实际 SHA-256 和工具版本：

./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。

$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、账号、密码、序列号或客户个人信息。