docs: 记录 Brain 规则语义 (#15)

2026-08-28 23:08:26 +08:00
parent 95a2fa05f3
commit 7377a72f8b
1 changed files with 8 additions and 0 deletions
@@ -272,3 +272,11 @@ Brain 解码层位于 `Brain/src/yovision_brain/decode/`，只依赖 #11 的内

 当前基线是版本 `1.0.0` 的 YoVision first-party 亮度连通区域算法，并提供 PyTorch 2.12.1 张量实现；不分发外部模型权重，PyTorch 许可已在 Brain 第三方清单记录。它用于验证匿名检测/跟踪链路，不代表人员检测效果，不承诺召回率或误报率。人脸、生物特征和跨摄像头 ReID 均未启用。
 <!-- brain-vision-v1:end -->
+
+<!-- brain-rules-v1:start -->
+## Brain 区域与方向越线规则边界
+
+`Brain/src/yovision_brain/rules/` 只消费匿名轨迹。轨迹框底边中心是归一化规则锚点；多边形边界视为区域内，状态区分 outside、entered、inside。有向警戒线按起点→终点的左右侧定义 `left_to_right` / `right_to_left`，deadband 内不触发且保留上一次显著侧。
+
+每个结果绑定规则配置版本、Profile、分辨率、锚点和可解释原因。结果是 Brain 内部候选，不是标准事件或 Bell Alert；时段、持续时间、冷却、聚集和正式 Sense 配置契约不在本阶段。
+<!-- brain-rules-v1:end -->