yovision/docs/tasks/T-007.md

id, title, phase, deps, status, created, issue, context_ref, claim_branch, work_branch, write_paths

id	title	phase	deps	status	created	issue	context_ref	claim_branch	work_branch	write_paths
T-007	完成客户试点真实多路摄像头现场验收	3	T-001 T-006	TODO	2026-08-04	22	null	null	null	docs/tasks/T-007.md docs/research/pilot-real-camera-integration.md Sense/ docs/current-state.md

问题 / 背景

受硬件预算限制，T-006 只用 1 台真实海康摄像头和至少 4 条合成 RTSP 源完成实验室软件闭环，不能证明多台真实设备的并发接入、网络故障隔离、批次一致性或现场恢复。项目无需为日常开发提前采购设备，但在客户试点、借用或租赁条件具备后，生产上线和真实多路 SLA 声明仍需要现场证据。

关联需求与交互（如适用）

• 用户故事：US-001、US-002、US-007。
• 交互清单：无正式 UI；使用 Sense API、日志、指标和版本化现场记录验收。
• 前置产物：T-001 指定准入基线、T-006 五路混合源实验室证据。

方案

1. 使用客户授权、借用或租赁设备，在隔离的试点测试窗口建立至少 5 条来自不同真实编码上游的视频通道；优先使用 T-001 准入型号。若型号/硬件/固件不在准入基线，先按 T-001 全矩阵完成独立准入变更，不能在本任务中默许。
2. 通过 Sense 自动完成设备发现/台账期望态、MediaMTX path、探活和对账；不得人工修改 MediaMTX 配置或复制同一 RTSP URI 凑数。
3. 对至少一条上游执行摄像头/网络断开恢复，并验证 Sense 与 MediaMTX 分别重启后的全量自动收敛；记录配置期限、实际恢复时间和 unconverged。
4. 全部真实上游同时在线连续观察至少 2 小时；记录码率、分辨率、FPS、连接/重连、path/reader/upstream 一致性和失败时间线。
5. 将步骤、授权来源、设备身份/固件的脱敏摘要、网络拓扑、命令、结果、限制和签字结论写入 docs/research/pilot-real-camera-integration.md，不提交视频样本或秘密。

不可变约束

• 阈值 / 数值边界：至少 5 条独立真实编码上游，同时在线至少 2 小时；同一摄像头/编码会话/RTSP URI 的重复连接和 MediaMTX fan-out 只算 1 路。本任务不替代 16/64/128 路容量验收。
• 判定式 / 状态转换：数据库仍是期望态真相源；摄像头/网络、Sense、MediaMTX 三类恢复后必须自动达到 unconverged = 0，不得人工改配置或重建数据库通过。
• 安全边界：设备必须自购、借用、租赁或由客户书面授权；在测试窗口使用无敏感人物画面或遮挡画面，证据不含密码、完整 URI、token、客户地址或媒体样本。
• 上线边界：本任务不阻塞本地开发和 M1 实验室出口，但阻塞客户生产试点启用、真实多路稳定性结论和相关 SLA。

验收要点

• 任务相关验证：执行全部 Sense 单测、vet、migration/契约检查；完成至少 5 路真实上游、2 小时观察和三类恢复；运行三条 harness 治理命令。
• 完整门禁：若修改 ONVIF、MediaMTX、store、reconcile、probe 或公共 API，重跑全部 Sense 测试和全部现场矩阵。
• 人工 / 设备验收：必需。客户/实施/硬件负责人核对设备来源、身份、固件、网络、原始时间线、脱敏证据与限制，并签署结论。
• 构建产物：记录 Sense/MediaMTX 版本与哈希、配置模板、启动/恢复命令和证据文档；不提交摄像头秘密或媒体。

边界（不改什么）

不开发 Brain/Bell 功能，不评估 AI 检出率，不宣称多品牌兼容，不做 16/64/128 路容量验收，不要求项目在客户/借用/租赁条件出现前自行购买额外摄像头。

协作约束

• 责任 Agent：由 dispatcher 分配。
• 唯一写入者：同责任 Agent。
• 委派：默认不启用；现场人员可执行设备操作，但任务所有者必须核验并版本化脱敏证据。
• Gitea：主 Issue 为 #22；T-001、T-006 均为 DONE 且外部设备条件具备前保持 status/waiting。

任何新增写路径先由 dispatcher 与活跃任务做前缀冲突检查。

执行记录

2026-08-04 任务定义

• 项目负责人批准后续本地开发只使用现有一台海康摄像头，多路由合成 RTSP 补足；真实五路现场证据从 T-006 移入本任务。
• 设备不要求项目当前采购，可使用客户授权、借用或租赁设备；本任务只阻塞生产试点，不阻塞软件开发。