mirror of
https://git.openapi.site/https://github.com/desirecore/registry.git
synced 2026-09-05 15:23:39 +08:00
Yige
223be1f04b
* feat: 建立 Registry 目录元数据验证基础 * feat: 迁移 Registry 应用目录元数据 * test: 解耦目录迁移进度断言 * feat: 迁移 Registry 服务目录元数据 * fix(catalog): 强制 Registry 目录元数据 * fix(catalog): 兼容 Registry v4 外部集成
47 lines
2.8 KiB
JSON
47 lines
2.8 KiB
JSON
{
|
||
"$schema": "http://json-schema.org/draft-07/schema#",
|
||
"$id": "https://github.com/desirecore/registry/schemas/registry-manifest.v3.schema.json",
|
||
"title": "DesireCore Registry manifest v3",
|
||
"description": "Registry 仓库级元数据。catalogMetadata 只广告可选 sidecar 能力，不改变 legacy 条目的读取方式。",
|
||
"type": "object",
|
||
"required": ["id", "version", "name", "description", "maintainer", "repository", "lastUpdated", "stats", "dataVersion"],
|
||
"properties": {
|
||
"$schema": { "type": "string", "description": "JSON Schema 标识或路径。" },
|
||
"id": { "const": "desirecore-registry-manifest", "description": "Registry 仓库固定标识。" },
|
||
"version": { "type": "string", "minLength": 1, "description": "Registry 数据格式版本。" },
|
||
"name": { "type": "string", "minLength": 1, "description": "Registry 显示名称。" },
|
||
"description": { "type": "string", "minLength": 1, "description": "Registry 用途说明。" },
|
||
"maintainer": { "type": "string", "minLength": 1, "description": "Registry 目录维护者。" },
|
||
"repository": { "type": "string", "format": "uri", "description": "Registry 仓库地址。" },
|
||
"lastUpdated": { "type": "string", "pattern": "^\\d{4}-\\d{2}-\\d{2}$", "description": "仓库目录元数据最后修改日期，不表示条目内容发布时间。" },
|
||
"stats": {
|
||
"type": "object",
|
||
"description": "必须与 entries/ 实际内容完全一致的统计。",
|
||
"required": ["totalEntries", "dockerApps", "mcpServices", "httpApis"],
|
||
"properties": {
|
||
"totalEntries": { "type": "integer", "minimum": 0 },
|
||
"dockerApps": { "type": "integer", "minimum": 0 },
|
||
"mcpServices": { "type": "integer", "minimum": 0 },
|
||
"httpApis": { "type": "integer", "minimum": 0 },
|
||
"externalIntegrations": { "type": "integer", "minimum": 0 }
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"dataVersion": { "type": "string", "minLength": 1, "description": "仓库数据版本；旧客户端继续按原字段读取。" },
|
||
"catalogMetadata": {
|
||
"type": "object",
|
||
"description": "Catalog metadata v1 的兼容广告。sidecar 在迁移窗口内可选，legacy manifest 始终保留。",
|
||
"required": ["version", "schema", "sidecarPath", "required", "legacyFallback"],
|
||
"properties": {
|
||
"version": { "const": "1.0.0" },
|
||
"schema": { "const": "schemas/catalog-metadata.v1.schema.json" },
|
||
"sidecarPath": { "const": "entries/<id>/catalog-metadata.v1.json" },
|
||
"required": { "type": "boolean", "description": "是否要求每个 entry 都具备 sidecar。迁移完成前为 false。" },
|
||
"legacyFallback": { "const": true, "description": "旧客户端和缺 sidecar 条目继续读取 manifest.json。" }
|
||
},
|
||
"additionalProperties": false
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
}
|