feat(v1): settings camera connection test and preview

Settings tab gains a camera group (host/port/channel/user/masked password),
a background connection-test worker that probes one frame off the GUI
thread and shows it in a preview, and a save button that writes the
structured source to the untracked config.local.json. 60 tests pass;
Qt shell compiles and needs a Windows smoke.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

progress.md

@@ -253,3 +253,12 @@
 - 阻塞：设置页掩码输入、测试连接按钮与预览显示需 Windows + PyQt5 冒烟；配置解析、RTSP URL 构建（凭证百分号编码）与连接测试逻辑在本环境可真实验证。
 - 决策：配置支持「结构化 host/port/channel/username/password」或原有 `rtsp_url_env` 二选一；密码按 RFC 3986 百分号编码后拼 URL（顺带解决 `@` 问题）。护栏：公开示例 `config.example.json` 继续禁止任何 host/账号/密码/URL 并加测试守卫；`runtime_config_version` 继续排除凭证；凭证绝不进 JSONL、日志、截图名、错误信息。
 - 下一步：先写 URL 构建与结构化配置解析的失败测试，再实现；随后加 Qt 外壳（设置页字段、测试按钮、预览）。
+
+## 【2026-07-21】T-206 结构化摄像头配置、连接测试与设置页预览（完成）
+
+- 状态：DONE
+- 变更：`config.py` 新增 `build_rtsp_url`（凭证 RFC 3986 百分号编码）与结构化来源解析（`host/port/channel/username/password` 或原 `rtsp_url_env` 二选一），并新增 `write_local_camera_source` 把结构化来源写回未跟踪的 `config.local.json`。新增 `v1/camera.py`：`probe_stream` 用 `VideoSource(STREAM)` 做一次有界连接测试并回传抓拍帧（失败不抛异常、消息不含凭证）。`v1/gui.py` 设置页新增「摄像头连接」分组：host/端口/通道(101/102 下拉)/账号/密码(掩码)、`ConnectionTestWorker(QThread)` 后台测试连接、成功后在独立预览区显示抓拍帧、`保存连接到本地配置`按钮写回本地文件；`app.py` 从本地配置预填这些字段并传入配置路径。
+- 验证：新增测试——camera 四项（密码 `@`/`:`/`/` 百分号编码、默认主码流、probe 成功回帧、probe 失败不抛）、config 五项（结构化来源拼 URL、缺密码被拒、凭证不进 config_version、公开示例无凭证守卫、`write_local_camera_source` 经 `load_config` 往返）；`python3 -m pytest v1/tests -q` 为 60 passed；`python3 -m compileall -q v1 demo` 退出码 0（含 gui/app 新 Qt 代码语法）。真实相机连接此前已在 T-203 冒烟验证（1920×1080 取帧）。
+- 阻塞：设置页掩码输入、测试按钮点击与预览显示需 Windows + PyQt5 冒烟；本环境已真实验证 URL 构建、结构化解析、凭证护栏与连接测试逻辑。
+- 决策：按用户选择「全存本地配置文件」，凭证明文写入未跟踪 `config.local.json`（`git check-ignore` 保护）；护栏落测试：公开示例禁含凭证、`config_version` 排除凭证、消息/日志不含密码；密码百分号编码顺带修掉 `@` 解析问题。
+- 下一步：在 Windows 用设置页填写并测试连接、确认预览，再保存到本地配置；随后继续 T-203 的现场 GUI 预览与断流重连人工验收。