61 lines
2.8 KiB
Markdown
61 lines
2.8 KiB
Markdown
<!-- 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)
|