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

# MMAS 包

**元宇宙规范**

**文档编号：** MU-V2-ARCH-007  
**标题：** 元模型架构标准 - 仓库与包结构  
**文档类别：** 规范性  
**版本：** 2.0（草案）  
**状态：** 工作草案  
**规范性引用：** 元宇宙宪章（MUC）、MMAS-Core、Versioning  
**说明性引用：** Extension-Model、MMAS-Conformance、元宇宙联邦协议（MUFP）、Model-Traversal-and-Layout、Data-Mastership  
**版权：** © Orkestron.AI  
**许可：** Apache-2.0

---

# 1. 目的

本文档为符合元模型架构标准（MMAS）的元模型定义正典的仓库与包结构。

目标是让每个元模型都具备可预期的组织方式，既能被人理解，也能被人工智能代理理解。

---

# 2. 适用范围

本规范适用于：

- 元模型仓库；
- 可分发的元模型包；
- 仓库清单；
- bundle；
- 层；
- 配套资源；
- 示例与文档。

实现可以使用额外的文件，前提是不违反本规范。

---

# 3. 设计原则

合规的包必须是：

- 模块化的；
- 自描述的；
- 版本化的；
- 可追溯的；
- 机器可读的；
- 人可读的；
- 适于联邦的。

仓库结构必须反映语义架构，而不是实现技术。

---

# 4. 正典仓库结构

每个元模型都应当遵循下述正典结构。

```text
meta-model/
│
├── README.md
├── BOOTSTRAP.md            # operating instructions: how to read this model (read first)
├── LICENSE
├── CHANGELOG.md
├── manifest.yaml
├── sources.yaml            # Data Mastership Register: System of Record per dataset
│
├── bundles/
│   ├── <bundle-name>/
│   │   ├── bundle.yaml
│   │   ├── README.md
│   │   ├── <layer-name>/
│   │   │   ├── layer.yaml
│   │   │   ├── objects/
│   │   │   ├── relationships/
│   │   │   ├── events/
│   │   │   ├── contracts/
│   │   │   └── projections/
│   │   └── ...
│   └── ...
│
├── canon/                  # canonical source texts the model treats as ground truth
├── raw/                    # unprocessed harvested captures from external systems (never hand-edited)
├── artifacts/              # generated, regenerable outputs (never authored)
├── imports/
├── mappings/
├── schemas/
├── examples/
├── diagrams/
├── docs/
└── tools/
```

只要语义组织得以保留，也可以采用等价的布局。

该结构之上的遍历契约（确定性的 bundle 与层遍历顺序、文件的完全分类、完整性检查），以及 `BOOTSTRAP.md`、`canon/`、`raw/` 与 `artifacts/` 的保留含义，由 [Model-Traversal-and-Layout](Model-Traversal-and-Layout.md) 规范性地定义。`sources.yaml` 登记表，以及判定某数据集的主控方是模型还是外部系统（wiki、工单系统、数据库）的规则，由 [Data-Mastership](Data-Mastership.md) 定义。

---

# 5. 仓库清单

每个仓库都必须包含一份清单。

清单应当声明：

- 标识符；
- 名称；
- 版本；
- 所有者；
- 命名空间；
- 所支持的 MMAS 版本；
- 所支持的 MUC 版本；
- 所支持的 MUFP 版本；
- 导入的标准；
- 兼容性声明。

清单是自动发现的首要入口。

---

# 6. bundle 结构

每个 bundle 都应当包含：

- bundle 清单；
- 文档；
- 层；
- 可选的示例。

bundle 必须只承担单一的语义职责。

---

# 7. 层结构

每个层都应当包含：

- 层清单；
- 对象定义；
- 关系；
- 事件（如适用）；
- 契约（如适用）；
- 投影档案（如适用）。

层应当单独看仍然可理解。

---

# 8. 文档

每个公开仓库都应当包含：

- README；
- 架构总览；
- 变更历史；
- 许可信息；
- 贡献指南（可选）。

文档必须与已发布版本保持同步。

---

# 9. 示例

参考示例应当与规范性文本分开存放。

示例不得重新定义规范性语义。

示例制品应当标明其所针对的规范版本。

---

# 10. 导入的标准

导入的语义模型应当隔离在 imports/ 目录之下。

导入概念与本地概念之间的映射应当存放在 mappings/ 之下。

导入的制品必须保留指向其原始来源与版本的引用。

---

# 11. 仓库元数据

仓库应当公开足以支持发现的机器可读元数据。

推荐的元数据包括：

- 语义指纹；
- 所支持的档案；
- 包校验和；
- 发布日期；
- 仓库 URL；
- 数字签名（可选）。

---

# 12. 打包

可分发的 MMAS 包必须保留：

- 目录结构；
- 清单；
- 标识符；
- 语义引用；
- 版本元数据。

打包格式由实现自行决定。

例子包括 Git 仓库、归档文件或注册表。

---

# 13. 语义分发包（SDP）

第 4 节定义的是正典的*仓库*布局，而联邦需要一种可移植、可发布的*分发*单位。**语义分发包（SDP）**正是这个单位：一份单一、已签名、自足的制品，携带某个元模型（或其中一段有界的部分），连同在另一个宇宙中验证、安放并使用它所需的一切，相当于 Maven、npm 或 OCI 制品，只不过承载的是语义模型而非代码或镜像。

合规的 SDP 必须包含：

- 一份**清单**（`manifest.yaml`）- 身份、版本、所有者、命名空间与所支持的标准版本，如第 5 节所述；
- 构成被打包元模型的**各 bundle 与层**；
- 在规范化语义结构之上计算得出的包**[语义指纹](Versioning.md)**；
- 把内容与发布者绑定的**数字签名**；
- 说明 MUC、MMAS 与 MUFP 合规情况的**合规声明**（见 [MMAS-Conformance](MMAS-Conformance.md)）；
- **导入标准**清单及相应的[语义包](Extension-Model.md)；
- 导入概念与本地概念之间的**语义映射**；
- 可选的**投影**与**示例**，用以帮助理解而不重新定义语义。

一份有代表性的 SDP 展开后形如：

```text
employee-mm-2.3.1.sdp
│
├── manifest.yaml          # identity, version, conformance declaration
├── bundles/               # bundles & layers (objects, relationships, events, contracts, projections)
├── mappings/              # semantic mappings to imported standards
├── imports/               # imported Semantic Packages (Schema.org, O*NET, FHIR, …)
├── examples/              # optional reference examples
├── fingerprint.sha256     # Semantic Fingerprint of the normalized structure
└── signature.sig          # digital signature of the package
```

SDP 必须可自我验证：消费方必须能够从所含结构重新计算语义指纹，与 `fingerprint.sha256` 比对，并在信任该包之前验证签名。SDP 是仓库所持同一组合在传输与存放时的形态；它不得重新定义语义，只负责打包。

---

# 14. 仓库的演进

仓库结构应当以兼容的方式演进。

影响发现或互操作的结构性变更必须被版本化并记录。

结构性变更应当附带迁移指引。

---

# 15. 人工智能原生要求

合规的仓库应当让人工智能代理能够：

- 发现清单；
- 枚举 bundle 与层；
- 解析导入；
- 识别依赖；
- 定位示例；
- 判定合规情况；
- 在不依赖实现专属知识的情况下浏览该模型。

仓库布局应当尽量减少自动推理面临的歧义。

---

# 16. 架构不变量

仓库组织必须保留：

- 语义身份；
- 可追溯性；
- 所有权；
- 版本完整性；
- 宪法合规。

仓库结构绝不得重新定义语义含义。

---

# 17. 未来方向

语义分发包让元模型变得可移植；自然的下一步是让它们**在规模上可被发现、可被解析**。一个未来方向是让生态层（`06-ecosystem`）充当**语义包注册表**：一个具备联邦意识的服务，按身份、[语义指纹](Versioning.md)、合规级别与兼容版本范围为已发布的 SDP 与[语义包](Extension-Model.md)建立索引，并按需解析依赖与迁移，相当于语义知识领域的 Maven Central、npm 或 OCI 注册表。这样的注册表会把发布、签名信任、检索与获取标准化，使任何宇宙都能在没有带外协调的情况下定位、验证并采用某个元模型。

---

# 结语

MMAS 包结构是元模型正典的物理组织方式。

它的目的是让语义模型在仓库、组织与人工智能代理之间可被发现、可复用、可扩展、可互操作，同时保持与实现技术无关。