yovision/docs/README.md

generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) wiki_page: Home wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Home wiki_revision: 1a2dadc746ce76e182150ca93fc4a1ec192c6b6a synchronized_at: 2026-08-11T10:30:24Z

YoVision 文档中心

YoVision 是单仓三项目的智能视频事件平台。Sense 负责设备与媒体，Brain 负责推理与事件生成，Bell 负责事件预警和处置。Sense 与 Bell 是可独立销售、部署和验收的产品；Brain 是独立构建的推理交付单元。

第一次阅读

1. 项目档案：目标、子项目、技术栈和边界。
2. 产品需求：功能、质量、安全和非目标。
3. 架构与代码地图：职责、数据流和代码入口。
4. 业务规则与术语：不可破坏的领域规则。
5. 需求迁移矩阵：旧项目需求怎样进入新仓库。
6. 多 Agent 协作：三名主 agent 和协调任务的写路径规则。
7. 本地开发与验证：当前可执行命令和待补门禁。
8. 开发工作流：建单、确认、实施、验收和归档。

五分钟开始

git status --short --branch
python dev_scripts/check_harness.py --strict
python -m unittest discover -s tests -v
python dev_scripts/sync_wiki_docs.py --check

预期：工作区变更归属清楚，Harness 与测试通过，Wiki 镜像一致。业务代码尚未初始化时，不应臆造 Sense、Brain 或 Bell 的构建命令。

简单修改从哪里开始

修改类型	先读	主要验证
Sense 单项目	Project-Profile、Sense/AGENTS.md	Sense 自身测试
Brain 单项目	Product-Requirements、Brain/AGENTS.md	Brain 自身测试与事件契约测试
Bell 单项目	Business-Rules、Bell/AGENTS.md	Bell 自身测试
共享契约	Multi-Agent-Collaboration、contracts/AGENTS.md	三端消费者/生产者契约测试
长期文档	对应 Wiki 页面	Wiki 同步检查

事实来源

信息	事实来源
实时任务状态、方案确认和验收过程	Gitea 工单
长期需求、架构、规则、操作与归档	Gitea Wiki
API/Schema/迁移及代码版本事实	Git 仓库
离线文档	docs/ Wiki 只读镜像
历史需求和旧证据	D:\OPC\yovision_old，只读参考，不是当前状态

项目入口

• 代码仓库
• Gitea 工单
• 产品路线图
• 故障排查