<!-- gitea-wiki-mirror:start -->
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
<!-- gitea-wiki-mirror:end -->

# 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)