From 1a2dadc746ce76e182150ca93fc4a1ec192c6b6a Mon Sep 17 00:00:00 2001
From: ila <2+ila@noreply.git.ilapage.cn>
Date: Tue, 11 Aug 2026 18:28:50 +0800
Subject: [PATCH] docs: initialize YoVision project documentation

---
 Home.md | 52 ++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 52 insertions(+)
 create mode 100644 Home.md

diff --git a/Home.md b/Home.md
new file mode 100644
index 0000000..54e519a
--- /dev/null
+++ b/Home.md
@@ -0,0 +1,52 @@
+# YoVision 文档中心
+
+YoVision 是单仓三项目的智能视频事件平台。Sense 负责设备与媒体，Brain 负责推理与事件生成，Bell 负责事件预警和处置。Sense 与 Bell 是可独立销售、部署和验收的产品；Brain 是独立构建的推理交付单元。
+
+## 第一次阅读
+
+1. [项目档案](Project-Profile.-)：目标、子项目、技术栈和边界。
+2. [产品需求](Product-Requirements.-)：功能、质量、安全和非目标。
+3. [架构与代码地图](Architecture-and-Code-Map.-)：职责、数据流和代码入口。
+4. [业务规则与术语](Business-Rules-and-Glossary.-)：不可破坏的领域规则。
+5. [需求迁移矩阵](Requirements-Migration-Matrix.-)：旧项目需求怎样进入新仓库。
+6. [多 Agent 协作](Multi-Agent-Collaboration.-)：三名主 agent 和协调任务的写路径规则。
+7. [本地开发与验证](Local-Development-and-Verification.-)：当前可执行命令和待补门禁。
+8. [开发工作流](Development-Workflow.-)：建单、确认、实施、验收和归档。
+
+## 五分钟开始
+
+```powershell
+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`，只读参考，不是当前状态 |
+
+## 项目入口
+
+- [代码仓库](https://git.ilapage.cn/ila/yovision)
+- [Gitea 工单](https://git.ilapage.cn/ila/yovision/issues)
+- [产品路线图](Product-Roadmap.-)
+- [故障排查](Troubleshooting)