> 译文仅供阅读便利。具有规范效力的是英文原文。

# 仓库结构

**元宇宙规范**

**文档编号：** MU-V2-GUIDE-002  
**标题：** 语义仓库架构  
**文档类别：** 说明性  
**版本：** 2.0（草案）  
**状态：** 工作草案  
**规范性引用：** MMAS  
**说明性引用：** Getting-Started、Create-a-New-Meta-Model  
**版权：** © Orkestron.AI  
**许可：** Apache-2.0  

---

# 1. 目的

这份指南讲的是元宇宙所建议的仓库结构，以及每一个主要目录各司何职。

仓库的这套布局，是要让人与 AI 智能体都读得懂，同时托住长远的演进、可追溯性与语义联邦。

这份指南在规范一侧的对应物是 [MMAS-Package](../02-architecture/MMAS-Package.md)（正典布局）、[Model-Traversal-and-Layout](../02-architecture/Model-Traversal-and-Layout.md)（无损巡查的契约，以及为引导文件、正典、原始数据与产物保留的位置）与 [Data-Mastership](../02-architecture/Data-Mastership.md)（每份数据集以哪套系统为主）。

---

# 2. 设计目标

对元宇宙仓库的期望是：

- 原生于 Git；
- 模块化；
- 按语义来组织；
- 有版本；
- 可追溯；
- 好走。

仓库的组织，映的是语义上的架构，而不是实现所用的技术。

---

# 2a. 语义仓库架构

元宇宙仓库最要紧的一个想法是：它**按语义来组织，而不按文件类型或技术**。寻常的软件仓库，是按文件*是什么*来归堆的 - `src/`、`docs/`、`tests/`、`lib/`、`config/`。元宇宙的仓库则按文档*回答哪个问题*来归堆。每一个顶层目录都是一个问题；其中的内容便是答案。

- `00-foundation` - 这套标准**为何**存在；
- `01-constitution` - 它服从**哪些法**；
- `02-architecture` - 它**怎样**建起来；
- `03-federation` - 它**怎样**与别的打交道；
- `04-core-concepts` - 它用**哪些根本概念**；
- `05-reference-architecture` - **怎样**施用它；
- `06-ecosystem` - 它在更广的生态里**怎样**活着；
- `07-guides` - **怎样**上手；
- `examples` - 它在实处**是什么样子**。

正因为每个目录对应的是一个问题而不是一门技术，仓库便成了一片**语义空间**，而不是一棵文件树。新来的人可以循着意图去走（我要知道这份模型怎样联邦 → `03-federation`），AI 智能体也一样：它把目录对到问题上，不必去解析文件扩展名就能找到要紧的知识。若按技术重排，一个问题的答案就会散落在许多目录里；按语义来排，每一个答案都留得完整。这与标准施于元模型的原则是同一条 - 先为意义建模 - 只不过施到了仓库自身上。

---

# 3. 建议的结构

```
Repository/
├── README.md
├── LICENSE
├── CHANGELOG.md
├── archive/
├── 00-foundation/
├── 01-constitution/
├── 02-architecture/
├── 03-federation/
├── 04-core-concepts/
├── 05-reference-architecture/
├── 06-ecosystem/
├── 07-guides/
├── examples/
└── schemas/ (optional)
```

---

# 4. 根目录下的文件

**README.md**

进入这份仓库的入口。

**LICENSE**

发布与复用的条款。

**CHANGELOG.md**

已发布各版本的沿革。

---

# 5. archive/

存放先前的各次发布，它们仍可作历史参考之用。

归档之后，其内容不再改动。

---

# 6. 00-foundation/

装的是概念上的地基：

- 愿景
- 原则
- 术语
- 词汇表

这几份文档先读。

---

# 7. 01-constitution/

定下这片生态的宪章规则：

- 宪章
- 治理
- 变更流程
- 合规

这些文档回答的是*什么必须始终为真*。

---

# 8. 02-architecture/

装的是描述元模型如何建造的 MMAS 各规范。

典型的主题有：

- 版本；
- 命名；
- 可追溯性；
- 校验；
- 包的结构。

---

# 9. 03-federation/

装的是描述独立宇宙之间语义协作的 MUFP 各规范。

典型的主题有：

- 信任；
- 身份绑定；
- 同步；
- 语义映射；
- 联邦的生命周期。

---

# 10. 04-core-concepts/

定下所有元模型共用的那套语义词汇。

其中包括这类概念：

- 宇宙；
- 对象；
- 关系；
- 投影；
- 语境；
- 事件；
- 生命周期。

---

# 11. 05-reference-architecture/

给出可复用的架构指点。

典型的文档有：

- 架构；
- 栈；
- 交互模式；
- 联邦模式；
- 生命周期模式；
- 参考图示。

---

# 12. 06-ecosystem/

讲的是生态层面的各项能力。

典型的主题有：

- 登记册；
- 兼容性；
- 认证；
- 各种实现；
- 路线图。

---

# 13. 07-guides/

装的是实用的指点。

例如：

- 上手；
- 仓库结构；
- 迁移指南；
- 发布指南。

这些指南是对规范性文本的补充。

---

# 14. examples/

装的是示意性的例子，示范这些标准的正确施用。

这些例子与当前的各规范保持同步。

---

# 15. schemas/（可选）

可以装机器可读的资产：

- JSON Schema；
- YAML；
- OpenAPI；
- OData；
- 校验用的产物。

这些架构文件指回规范性文档。

---

# 16. 走法上的策略

建议的阅读次序：

1. README
2. 基础
3. 宪章
4. 架构
5. 联邦
6. 核心概念
7. 参考架构
8. 生态
9. 指南
10. 示例

---

# 17. 好的做法

鼓励仓库的维护者：

- 让每份文档各守其题；
- 把规范性内容与说明性内容分开；
- 保留历史版本；
- 让文件名保持稳定；
- 公布版本元数据；
- 凡切实可行处，把校验交给自动化。

---

# 18. 结语

一个结构良好的仓库，对可被寻见、可互操作与长久可维护而言，都是不可或缺的。

依循元宇宙所建议的仓库组织方式，发布者造出的仓库便易懂、易校验、易扩展、易联邦，从而让人与 AI 智能体都能在整片生态之中前后一致地穿行于语义知识之间。