YoVision 文档导航
YoVision 当前目标是完成默认 16 路的智能视频事件闭环，同时从数据模型、分片、接口和 UI 操作上兼容单站点 128 路横向扩展。
Agent 入口
../AGENTS.md：仓库级规则与唯一工作入口。- AI 开发入口：固定开工、领取、验证与收尾流程。
- Agent 上下文清单 /
agent-context.json/Schema：按任务类型读取最小上下文。 - 当前实现状态：代码现实、可运行命令、blocker。
- 编码规则：写代码前必须遵守的硬约束。
产品与架构
- 项目愿景：为什么做、为谁做、产品原则与非目标。
- 需求：MVP、P0、容量和验收。
- 技术栈：既定组件、待定项、运行与验证矩阵。
- 架构设计：Sense/Brain/Bell 边界、数据流与扩展约束。
- 任务路线图：M0–M6 阶段和建议任务；不维护实时状态。
- 用户故事：业务目标、价值、验收场景。
- 交互清单：Web/App/值班台的状态、反馈和无障碍门禁。
- API 合约：已冻结事件契约和待冻结内部/外部接口。
- 路由与页面：页面职责和导航边界。
- 设计原型约定：P0 UI 开工前的 HTML 原型输入。
任务与协作
- 任务文件：
docs/tasks/T-<编号>.md保存规格与长期证据；实时状态在 Gitea Issue。 - Gitea MCP：本机私有配置、工具审批和断连降级。
- Gitea 协作协议：Issue、claim、工作分支、PR 和写路径防撞。
- 收尾清单：保证下一轮可恢复。
- 方法对照表：失败模式到首要治理工件。
- 评审评分表：单次交付质量评审。
- 质量文档：长期健康度追踪。
原始与追溯资料
raw/01-需求收集.md：完整需求条目与待确认问题。raw/02-需求分析.md：分层、领域模型、状态机、容量与风险推导。raw/03-通用场景应用方案.md：组件选型、NVR 决策、部署与演进方案。raw/08-三系统职责划分.md：Sense/Brain/Bell 的详细目录和七条边界。raw/contracts/README.md：事件契约 v0.1 的冻结说明与代码级断言。
raw/04 至 raw/06 是目标客户方案，raw/07 是 silver_pose 契约比对。其他项目的文档/ 只作历史参考，不是当前实现依据。
权威性
- 实现入口：本文列出的 harness 文档。
- 决策追溯：
docs/raw/。 - 事件字段与语义：
docs/raw/contracts/。 - 实时任务状态：Gitea Issue。
- 任务规格与证据：
docs/tasks/T-<编号>.md。
发现冲突时先修正文档和任务，不得靠聊天记忆继续实现。