feat(v1): add replayable video source

progress.md

@@ -98,3 +98,12 @@
 - 阻塞：无。
 - 决策：视频源只返回帧、单调时间戳和来源状态；读取失败、EOF 和重连绝不生成虚构人员或摔倒事件。
 - 下一步：写入时间戳单调、错误来源和有界重连的失败测试。
+
+## 【2026-07-21】T-102 实现可重连的视频源与录像回放适配器（完成）
+
+- 状态：DONE
+- 变更：新增 `v1/video_source.py`，定义 `FramePacket` 与 `connected`、`retrying`、`error`、`eof`、`closed` 来源状态。录像优先读取容器时间戳，负首帧或倒退值回退到帧序号/FPS；可重连来源采用有界指数退避，所有非连接状态返回空帧且不携带事件信息。
+- 验证：先运行 `python -m pytest v1/tests/test_video_source.py -v`，确认因缺少 `v1.video_source` 导入失败；实现后视频源测试 4 passed，完整 V1 测试在本轮最后一次运行时为 6 passed。`demo/1.mp4` 只读 smoke 成功读取首两帧，时间戳为 0.000000 与 0.033333 秒；`python -m compileall -q v1 demo` 通过。
+- 阻塞：无。
+- 决策：来源失败只表达来源状态，绝不以空帧、EOF 或重连触发人员更新或摔倒事件；本地录像测试使用临时生成的 AVI，避免将客户视频或样例录像作为 pytest 夹具。
+- 下一步：T-103，先写模型来源和 17 点 Pose 输出的失败测试。