yovision/Brain/AGENTS.md

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/ 的写入权。