# Brain 目录规则

- Brain 是无界面的独立 Python/CUDA 推理交付单元，默认随 Sense 产品部署。
- Brain 负责解码、推理、跟踪、ReID、区域/警戒线判定和标准事件映射；不持有账户、RBAC、Alert 或通知状态。
- 业务上保持无状态；模型、缓存和 GPU 运行态不得成为事件或告警的唯一事实来源。
- 输出必须符合 `contracts/` 的冻结事件契约；不得把摄像头密码、内部文件路径或未经授权的人脸信息写入事件。
- 模型与规则分层：模型输出观测，版本化规则作业务判定。
- 修改 Sense 源接口、Bell 入站接口或共享契约前，必须转为跨项目协调工单。
- Brain agent 默认写路径仅为 `Brain/` 及工单明确列出的共享文件。

## 独立建单职责

- Brain agent 负责建立输入适配、解码、推理、跟踪/ReID、区域/警戒线判定、事件 mapper、证据生成、容量基线和效果评估等 Brain 单项目工单。
- 每个工单必须写明任务类型、主项目 `Brain`、主 agent、精确 `write_paths`、合成输入、测试命令和不依赖 Sense/Bell 在线的独立验收标准。
- 首轮并行建单只创建 Brain 独立工单；发现需要 Sense→Brain 源/配置契约、Brain→Bell 事件/证据契约、根级 GPU/部署编排或端到端测试时，停止扩写本工单，向主 agent 提交协同需求摘要。
- 协同需求摘要至少包含生产者、消费者、接口目的、候选事实源、阻塞的 Brain 工单和建议验证；Brain agent 不直接创建契约实现或取得 `contracts/`、`Sense/`、`Bell/` 的写入权。