docs: add settings tab to UI prototype

2026-07-20 22:50:57 +08:00
parent 718ed6e2ed
commit 46d021eba3
9 changed files with 756 additions and 20 deletions
@@ -39,6 +39,14 @@ V1 的同一数据流既可接 RTSP，也可回放本地录像。V2 复用同一
 | PyQt UI | `v1/gui.py` | 渲染帧、骨架、状态、设置和弹窗 | 直接读 RTSP 或写判定规则 |
 | 回归工具 | `v1/tests/` 与 `v1/scripts/` | 回放录像、断言事件和延迟 | 生产 UI |

+## UI 导航与配置生效生命周期
+
+PyQt 主窗口只包含实时监控和设置两个顶部 Tab。实时监控 Tab 保持视频画面优先；设置 Tab 不能直接调用视频源、Pose 或状态机。
+
+设置页面产生的是已校验的草稿配置。用户点击开始监控时，应用创建不可变的运行配置快照与配置版本，并将该快照传给视频源、Pose、证据和状态机。运行期间编辑设置不会修改该快照；保存后的草稿在下一次开始监控时才会成为新的运行配置。FallEvent 继续记录 config_version，使截图和 JSONL 可以追溯到实际阈值。
+
+真实 RTSP 凭证仍只由环境变量或未跟踪本地配置提供。UI 只显示环境变量是否就绪，不能回显或记录具体值。
+
 ## 状态模型

 每个 `track_id` 独立维护状态：