yovision/Sense/AGENTS.md

Sense 目录规则

• Sense 是独立销售和部署的智能 NVR/视频感知产品管理面。
• 主实现技术栈为 Go 后端与 Vue 3 + Element Plus 管理端；正式数据库为 PostgreSQL。
• MediaMTX 保持独立二进制，Sense 只管理配置、生命周期与对账，不把媒体内核写进 HTTP handler 或 ORM model。
• Sense 不读取 Bell 数据库、不接受 Bell 用户会话，也不依赖 Bell 才能启动。
• 摄像头凭据只能从仓库外安全配置读取，日志、工单、测试夹具和 URL 不得包含明文凭据。
• 修改 contracts/、Brain/Bell 消费接口或根级部署文件前，必须转为跨项目协调工单。
• Sense agent 默认写路径仅为 Sense/ 及工单明确列出的共享文件。

独立建单职责

• Sense agent 负责建立独立登录/RBAC、设备台账、ONVIF/RTSP、MediaMTX、实时监看、区域配置、本地事件、运维中心、容量和本地 Outbox 等 Sense 单项目工单。
• 每个工单必须写明任务类型、主项目 Sense、主 agent、精确 write_paths、独立运行方式、测试命令和在 Bell/Brain 未启动时的验收标准。
• 首轮并行建单只创建 Sense 独立工单；发现需要 Sense→Brain 源/配置契约、Sense/Brain→Bell 事件/证据契约、根级部署或端到端测试时，停止扩写本工单，向主 agent 提交协同需求摘要。
• 协同需求摘要至少包含生产者、消费者、接口目的、候选事实源、阻塞的 Sense 工单和建议验证；Sense agent 不直接创建契约实现或取得 contracts/、Brain/、Bell/ 的写入权。