mirror of
https://git.openapi.site/https://github.com/desirecore/registry.git
synced 2026-10-21 03:13:23 +08:00
Yige
3828aa6800
* feat(registry): 增加插件贡献与应用依赖的4.2契约 * fix(registry): preserve legacy App manifests for published clients --------- Co-authored-by: yi-ge <6657330+yi-ge@users.noreply.github.com>
49 lines
3.0 KiB
JSON
49 lines
3.0 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 },
|
||
"nativeApps": { "type": "integer", "minimum": 0 },
|
||
"artifactApps": { "type": "integer", "minimum": 0, "description": "纯声明制品的 App 条目数，包括插件；不是安装数。" },
|
||
"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
|
||
}
|