docs: 记录 Brain 解码边界 (#13)

2026-08-28 22:28:00 +08:00
parent 7140adacf6
commit d7b59da63c
1 changed files with 8 additions and 0 deletions
@@ -256,3 +256,11 @@ Brain 的首个独立输入边界位于 `Brain/src/yovision_brain/input/`，项

 正式 RTSP、Sense 源配置、共享区域契约和跨项目投递仍由协调工单建立版本化 `contracts/` 适配器，不得把本内部模型直接发布给 Sense 或 Bell。
 <!-- brain-input-v1:end -->
+
+<!-- brain-decode-v1:start -->
+## Brain 可替换解码边界
+
+Brain 解码层位于 `Brain/src/yovision_brain/decode/`，只依赖 #11 的内部 `InputPacket` 端口，向后续视觉模块输出顺序、纳秒时间戳、逻辑设备、Profile、分辨率、像素格式和尺寸变化标记明确的 `DecodedFrame`。具体后端通过 `DecoderBackend` 注册，不要求检测、跟踪或规则层依赖某个编解码 SDK。
+
+当前独立纵切支持确定性 RGB24 合成帧，以及标准库实现的最小 YUV4MPEG2 C444 本地视频流。Y4M 只用于匿名本地/合成验证；生产 RTSP、FFmpeg/PyAV、NVIDIA 硬件解码、重连和多路调度仍是后续范围。损坏输入、不支持格式、Profile 尺寸不匹配和安全大小上限均产生明确错误；正常 EOF 与主动取消不伪装成失败。
+<!-- brain-decode-v1:end -->