docs: 记录 Brain 内部输入边界 (#11)

2026-08-28 22:21:17 +08:00
parent b21bbc64f3
commit be75a3671d
1 changed files with 10 additions and 0 deletions
@@ -246,3 +246,13 @@ GoAdmin 路由位于 `Sense/server/app/admin/router/sense_ops_alert.go`，API

 本模块只写 Sense 运维告警和 GoAdmin 操作审计，不导入或写入本地安全事件、Brain、Bell、Outbox 或共享契约模型。viewer 只读；implementation_operator 与 site_admin 可刷新健康事实、确认和恢复。
 <!-- sense-ops-alerts:end -->
+
+<!-- brain-input-v1:start -->
+## Brain 内部输入与配置边界
+
+Brain 的首个独立输入边界位于 `Brain/src/yovision_brain/input/`，项目内配置模型位于 `Brain/src/yovision_brain/config/`。配置显式标记为 `brain.internal.input/v1`，只用于 Brain 独立开发与测试，不是 Sense→Brain 共享契约。
+
+输入端口当前提供确定性 RGB 合成源和显式本地文件源。两者携带逻辑设备、Profile 与分辨率元数据；合成源提供固定种子、帧序列和确定性时间基准，本地文件源提供可替换解码器消费的容器字节、EOF 和协作取消边界。错误只暴露安全文件标签，不把机器绝对路径、凭据或客户数据写入日志/事件。
+
+正式 RTSP、Sense 源配置、共享区域契约和跨项目投递仍由协调工单建立版本化 `contracts/` 适配器，不得把本内部模型直接发布给 Sense 或 Bell。
+<!-- brain-input-v1:end -->