> 译文仅供阅读便利。具有规范效力的是英文原文。 # 活的登记册 本目录就是 [Registered-Meta-Models](../Registered-Meta-Models.md) 所述的**活的、机器可读的元模型登记册**。登记是一种可发现性的行为,而非存放:每一条记录都是指向权威来源的引用,绝非它的副本。 | 文件 | 含义 | |---|---| | [`registered-models.csv`](registered-models.csv) | 扁平、可检索的索引:每份已登记模型一行 | | [`entries/`](entries/) | 每份模型一个 YAML 文件:完整记录(架构见下) | | [`entry.schema.json`](entry.schema.json) | 每条记录都必须据以校验的 JSON Schema | 若要查阅一份元模型可以导入的那约 1180 项**外部**标准(Schema.org、FHIR、ISO 20022……),见 [External-Models-Registry](../External-Models-Registry.md) 与 [`external-models.csv`](../external-models.csv);本登记册所罗列的,是**建在 Vercy 标准之上的元模型**。 ## 怎样找到一份模型 在 [`registered-models.csv`](registered-models.csv) 里按类别、领域或关键词检索(它小到可以整篇读完),随后打开 [`entries/`](entries/) 下该模型的文件,查看合规、依赖与权威来源。 ## 怎样在自己的维度中使用一份已登记的模型 1. 打开记录;查看 `license`、`conformance` 与 `status`。 2. 在钉住的 `source.ref` 上克隆或内置 `source.repository`(按 MMAS-Package 内置到自己模型的 `imports/`)。 3. 读该模型自己的 `BOOTSTRAP.md`,并按它所声明的顺序走一遍(ARCH-017)。 4. 把它绑定进来:从自己的模型引用它的各个命名空间,或者改造它、把你的改动作为增量记在自己的维度里;保留原有标识符,以保联邦兼容。 5. 尊重主权归属(ARCH-018):已登记的来源仍是该模型的主;你的副本是镜像或分叉,绝不是第二个主。 ## 怎样登记一份模型 1. 拿 `entries/` 里已有的文件作模板复制一份;把 [`entry.schema.json`](entry.schema.json) 的每个必填字段填好。 2. 往 [`registered-models.csv`](registered-models.csv) 添上相应的一行。 3. 开一个 pull request。评审所查:记录能依架构校验通过、来源可达(或已声明 `access: restricted`)、所称合规站得住脚,且 `id` 尚未被占用。 4. 登记并不转移所有权,所有者可随时撤回(状态 `retired`;记录从不删除,标识符因而始终可解析)。 ## 记录的各种状态 `draft`(已登记,仍在演进)·`stable`(有版本的发布,变更受控)·`deprecated`(已被取代,附指向后继者的指针)·`retired`(由所有者撤回;墓碑记录留存)。