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

# MUIF 架构文件

**元宇宙交换格式（MUIF）v1.0** 的机器可读 **JSON Schema（Draft 2020-12）**定义。
它们是[../02-architecture/MMAS-Interchange.md](../02-architecture/MMAS-Interchange.md)
所定抽象模型的那副具体、可校验的面孔。

| 架构文件 | 所定之物 |
|--------|---------|
| `common.schema.json` | 共用的 `$defs`：CSN、identifier、canonicalIdentity、semver、fingerprint、provenance、lifecycleState、cardinality、conformance |
| `object.schema.json` | 一个元对象（语义真相点） |
| `relationship.schema.json` | 一条一等的关系 |
| `event.schema.json` | 一个不可变的事件 |
| `contract.schema.json` | 一份语义合约 |
| `projection.schema.json` | 一份因语境而异的投影 |
| `manifest.schema.json` | 元模型包的入口（组合层级） |

## 校验一份模型

用任何一款标准的 JSON Schema 2020-12 校验器即可。例如：

```bash
# Node (ajv-cli)
npx ajv-cli validate -s schemas/manifest.schema.json \
  -r "schemas/*.schema.json" \
  -d examples/minimal-person/person.muif.json --spec=draft2020

# Python (check-jsonschema)
check-jsonschema --schemafile schemas/manifest.schema.json \
  examples/minimal-person/person.muif.json
```

## 非语义字段

凡在架构描述中标为 **NON-SEMANTIC** 的属性（`displayName`、`description`、
`assertedAt`、`metaModel.fingerprint` 等），都不计入**语义指纹**的计算。规范化算法
见 [MMAS-Interchange](../02-architecture/MMAS-Interchange.md)，参考工具
`mu-fingerprint` 见 [../tools/](../tools/)。