mirror of
https://git.openapi.site/https://github.com/desirecore/registry.git
synced 2026-10-21 05:13:20 +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>
3466 lines
114 KiB
JSON
3466 lines
114 KiB
JSON
{
|
||
"$schema": "http://json-schema.org/draft-07/schema#",
|
||
"$id": "https://github.com/desirecore/registry/schemas/registry-entry.schema.json",
|
||
"title": "DesireCore Registry Entry 4.2",
|
||
"description": "严格区分应用/插件与服务/外部集成的 Registry 4.2 authored 契约。产品归属、部署方式、宿主贡献分别声明；声明不产生授权。此候选须在 Registry 外仓 review 后发布。",
|
||
"oneOf": [
|
||
{
|
||
"$ref": "#/definitions/dockerApp"
|
||
},
|
||
{
|
||
"$ref": "#/definitions/nativeApp"
|
||
},
|
||
{
|
||
"$ref": "#/definitions/artifact"
|
||
},
|
||
{
|
||
"$ref": "#/definitions/mcp"
|
||
},
|
||
{
|
||
"$ref": "#/definitions/httpApi"
|
||
},
|
||
{
|
||
"$ref": "#/definitions/externalIntegration"
|
||
}
|
||
],
|
||
"definitions": {
|
||
"nativeApp": {
|
||
"type": "object",
|
||
"description": "宿主机原生应用：独立安装和运行，不通过 MCP 服务注册或 Docker 容器部署。",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"type",
|
||
"version",
|
||
"author",
|
||
"description",
|
||
"tags",
|
||
"icon",
|
||
"iconLetter",
|
||
"platformSupport",
|
||
"category",
|
||
"fullDesc",
|
||
"shortDesc",
|
||
"install",
|
||
"source",
|
||
"requiredClientVersion",
|
||
"placementPolicy",
|
||
"stewardship",
|
||
"availability",
|
||
"license",
|
||
"redistribution",
|
||
"listingMaintainer",
|
||
"upstreamMaintainer",
|
||
"branding",
|
||
"compliance",
|
||
"entrypoints"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"id": {
|
||
"$ref": "#/definitions/id"
|
||
},
|
||
"name": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"type": {
|
||
"const": "native-app"
|
||
},
|
||
"version": {
|
||
"$ref": "#/definitions/version"
|
||
},
|
||
"author": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"description": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"tags": {
|
||
"$ref": "#/definitions/tags"
|
||
},
|
||
"icon": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"iconLetter": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 2
|
||
},
|
||
"platformSupport": {
|
||
"$ref": "#/definitions/platformSupport"
|
||
},
|
||
"category": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"pattern": "^[a-z0-9-]+$",
|
||
"description": "应用分类（slug 格式），可扩展任意分类"
|
||
},
|
||
"fullDesc": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"shortDesc": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"githubUrl": {
|
||
"$ref": "#/definitions/httpsUrl"
|
||
},
|
||
"requiredClientVersion": {
|
||
"$ref": "#/definitions/version"
|
||
},
|
||
"install": {
|
||
"type": "object",
|
||
"required": [
|
||
"method",
|
||
"requirements",
|
||
"configNeeded"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"method": {
|
||
"const": "native-node",
|
||
"description": "按审核后的 install.md 在宿主机安装固定 Node 制品；不自动启动应用或隧道。"
|
||
},
|
||
"requirements": {
|
||
"type": "object",
|
||
"required": [
|
||
"docker",
|
||
"node",
|
||
"minMemory",
|
||
"minDisk",
|
||
"ports"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"docker": {
|
||
"const": false
|
||
},
|
||
"node": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 80
|
||
},
|
||
"minMemory": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"minDisk": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"ports": {
|
||
"type": "array",
|
||
"minItems": 1,
|
||
"maxItems": 1,
|
||
"uniqueItems": true,
|
||
"items": {
|
||
"type": "integer",
|
||
"minimum": 1,
|
||
"maximum": 65535
|
||
},
|
||
"description": "安装默认使用的本机管理页面端口，不是对外公网端口或内部服务。"
|
||
}
|
||
}
|
||
},
|
||
"configNeeded": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"placementPolicy": {
|
||
"type": "object",
|
||
"description": "目录维护者声明的可放置范围；只限制能力，不能替用户自动固定或绑定",
|
||
"required": [
|
||
"showInMyApps",
|
||
"allowNavPin",
|
||
"allowAgentBinding"
|
||
],
|
||
"properties": {
|
||
"showInMyApps": {
|
||
"type": "boolean",
|
||
"description": "安装后是否允许出现在“我的应用”"
|
||
},
|
||
"allowNavPin": {
|
||
"type": "boolean",
|
||
"description": "用户是否可将应用固定到主导航"
|
||
},
|
||
"allowAgentBinding": {
|
||
"type": "boolean",
|
||
"description": "用户是否可将应用关联到 Agent 会话侧栏"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"source": {
|
||
"type": "object",
|
||
"description": "经过审核的上游来源指针；安装时必须进一步证明 ref 或制品摘要不可变。",
|
||
"required": [
|
||
"kind",
|
||
"url",
|
||
"ref"
|
||
],
|
||
"properties": {
|
||
"kind": {
|
||
"type": "string",
|
||
"enum": [
|
||
"git",
|
||
"release",
|
||
"package",
|
||
"container"
|
||
],
|
||
"description": "上游来源类型：Git 仓库、Release 制品、包管理器制品或容器镜像。"
|
||
},
|
||
"url": {
|
||
"type": "string",
|
||
"format": "uri",
|
||
"description": "权威上游地址；不得由客户端在安装请求中替换。"
|
||
},
|
||
"ref": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "审核版本引用；安装候选必须是完整 commit、制品版本或容器 digest。"
|
||
},
|
||
"sha256": {
|
||
"type": "string",
|
||
"pattern": "^[a-fA-F0-9]{64}$",
|
||
"description": "Release、package 或其他下载响应体的 SHA-256 摘要。"
|
||
},
|
||
"path": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "单仓库目录中的相对路径；不得作为运行时任意本地路径使用。"
|
||
},
|
||
"upstreamRepo": {
|
||
"type": "string",
|
||
"format": "uri",
|
||
"description": "制品与源码不在同一地址时对应的上游源码仓库。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"stewardship": {
|
||
"type": "string",
|
||
"enum": [
|
||
"official",
|
||
"partner",
|
||
"community",
|
||
"pointer"
|
||
],
|
||
"description": "条目治理身份：official 仅能由受信 official catalog provider 注入；partner/community/pointer 分别表示合作方、社区维护或纯上游指针。"
|
||
},
|
||
"availability": {
|
||
"type": "string",
|
||
"enum": [
|
||
"listing-only",
|
||
"installable"
|
||
],
|
||
"description": "目录可用性：listing-only 仅允许浏览上游；installable 才允许进入既有受治理获取流程，不表示已经安装或正在运行。"
|
||
},
|
||
"license": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "覆盖实际制品的许可证标识。"
|
||
},
|
||
"redistribution": {
|
||
"type": "string",
|
||
"enum": [
|
||
"allowed",
|
||
"source-pointer-only",
|
||
"verify-package-terms"
|
||
],
|
||
"description": "内容转交策略：allowed 可按许可证分发；source-pointer-only 只能从权威上游取得；verify-package-terms 表示条款尚未完成复核。"
|
||
},
|
||
"listingMaintainer": {
|
||
"type": "object",
|
||
"description": "目录策展者或上游维护者身份；两种角色必须分别存放，不能把 author 当成已验证维护者。",
|
||
"required": [
|
||
"name"
|
||
],
|
||
"properties": {
|
||
"name": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "维护者的公开名称或组织名称。"
|
||
},
|
||
"url": {
|
||
"type": "string",
|
||
"format": "uri",
|
||
"description": "维护者的公开主页、项目主页或可验证身份页面。"
|
||
},
|
||
"verified": {
|
||
"type": "boolean",
|
||
"description": "平台是否已验证该身份；不等同于许可证授权、内容审核或上游背书。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"upstreamMaintainer": {
|
||
"type": "object",
|
||
"description": "目录策展者或上游维护者身份；两种角色必须分别存放，不能把 author 当成已验证维护者。",
|
||
"required": [
|
||
"name"
|
||
],
|
||
"properties": {
|
||
"name": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "维护者的公开名称或组织名称。"
|
||
},
|
||
"url": {
|
||
"type": "string",
|
||
"format": "uri",
|
||
"description": "维护者的公开主页、项目主页或可验证身份页面。"
|
||
},
|
||
"verified": {
|
||
"type": "boolean",
|
||
"description": "平台是否已验证该身份；不等同于许可证授权、内容审核或上游背书。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"branding": {
|
||
"type": "object",
|
||
"description": "名称、Logo 和官方关系的展示依据；代码许可证不能自动授予商标或宣传素材权利。",
|
||
"required": [
|
||
"relationship",
|
||
"nameUsage",
|
||
"logoStatus"
|
||
],
|
||
"properties": {
|
||
"relationship": {
|
||
"type": "string",
|
||
"enum": [
|
||
"official",
|
||
"partner",
|
||
"independent-listing"
|
||
],
|
||
"description": "与上游的公开关系：官方、已确认合作，或独立事实索引。"
|
||
},
|
||
"nameUsage": {
|
||
"type": "string",
|
||
"enum": [
|
||
"owned",
|
||
"licensed",
|
||
"nominative"
|
||
],
|
||
"description": "项目名称的使用依据：自有、已获许可，或识别上游所需的指称性使用。"
|
||
},
|
||
"logoStatus": {
|
||
"type": "string",
|
||
"enum": [
|
||
"not-used",
|
||
"license-covered",
|
||
"trademark-policy-allowed",
|
||
"permission-obtained"
|
||
],
|
||
"description": "Logo 使用依据；未确认权利时必须为 not-used，并由客户端使用中性图标。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"compliance": {
|
||
"type": "object",
|
||
"description": "绑定到本次不可变来源的合规审核记录；新版本必须重新审核，不能继承旧版本结论。",
|
||
"required": [
|
||
"licenseEvidencePath",
|
||
"reviewedRef",
|
||
"reviewedAt",
|
||
"reviewedBy",
|
||
"upstreamEndorsed"
|
||
],
|
||
"properties": {
|
||
"licenseEvidencePath": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "在已审核源码或制品中定位许可证文本的相对路径。"
|
||
},
|
||
"noticePath": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "需要履行 NOTICE 或署名义务时，对应材料的相对路径。"
|
||
},
|
||
"reviewedRef": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "实际完成许可证、品牌和供应链复核的不可变 ref，必须与获取来源一致。"
|
||
},
|
||
"reviewedAt": {
|
||
"type": "string",
|
||
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T.*)?$",
|
||
"description": "审核日期或 ISO 8601 时间戳。"
|
||
},
|
||
"reviewedBy": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "可追溯的审核者或审核流程标识。"
|
||
},
|
||
"upstreamEndorsed": {
|
||
"type": "boolean",
|
||
"description": "上游是否明确认可该条目；false 时必须显示非官方、未经背书声明。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"productKind": {
|
||
"type": "string",
|
||
"enum": [
|
||
"application",
|
||
"plugin"
|
||
],
|
||
"description": "主要产品归属；应用提供独立业务，插件增加宿主能力。旧定义缺失时由受信适配层归一为 application。"
|
||
},
|
||
"extension": {
|
||
"type": "object",
|
||
"required": [
|
||
"apiVersion",
|
||
"hosts",
|
||
"runtime",
|
||
"contributes"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"apiVersion": {
|
||
"const": "1.0.0",
|
||
"description": "宿主扩展协议版本；当前支持 1.0.0。"
|
||
},
|
||
"hosts": {
|
||
"type": "array",
|
||
"minItems": 1,
|
||
"maxItems": 2,
|
||
"uniqueItems": true,
|
||
"items": {
|
||
"type": "string",
|
||
"enum": [
|
||
"agent-service",
|
||
"desktop-host"
|
||
]
|
||
},
|
||
"description": "执行宿主；未实现的宿主只作声明并显示不兼容，客户端展示面在 UI 定义中另行声明。"
|
||
},
|
||
"runtime": {
|
||
"oneOf": [
|
||
{
|
||
"type": "object",
|
||
"required": [
|
||
"kind"
|
||
],
|
||
"properties": {
|
||
"kind": {
|
||
"const": "declarative",
|
||
"description": "仅由宿主读取声明，不创建执行进程。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
{
|
||
"type": "object",
|
||
"required": [
|
||
"kind",
|
||
"protocol",
|
||
"descriptorRef"
|
||
],
|
||
"properties": {
|
||
"kind": {
|
||
"const": "service",
|
||
"description": "既有服务 owner 管理的协议连接；贡献调用继续走原授权和审批。"
|
||
},
|
||
"protocol": {
|
||
"type": "string",
|
||
"enum": [
|
||
"mcp",
|
||
"http"
|
||
],
|
||
"description": "服务通信协议，不代表连接已经建立。"
|
||
},
|
||
"descriptorRef": {
|
||
"type": "object",
|
||
"required": [
|
||
"path",
|
||
"sha256"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"path": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 512,
|
||
"pattern": "^(?!/)(?!.*\\\\)(?!.*:)(?!.*\\u0000)(?!.*(?:^|/)(?:\\.|\\.\\.)(?:/|$))(?!.*//)[^/]+(?:/[^/]+)*$",
|
||
"description": "固定在核验制品根下的规范 POSIX 相对文件路径；拒绝绝对路径、反斜杠、盘符、空段、点段及 NUL。解析时仍须核验 realpath containment。"
|
||
},
|
||
"sha256": {
|
||
"type": "string",
|
||
"pattern": "^[a-f0-9]{64}$",
|
||
"description": "固定文件字节的 SHA-256；消费前核验，编辑须提交新安装修订。"
|
||
}
|
||
},
|
||
"description": "安装制品根下内容固定的材料引用；相对路径和摘要必须共同匹配。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
}
|
||
],
|
||
"description": "贡献执行承载；descriptor 只定位受核验材料，不能直接把任意 endpoint 当运行事实。"
|
||
},
|
||
"contributes": {
|
||
"type": "array",
|
||
"maxItems": 64,
|
||
"items": {
|
||
"type": "object",
|
||
"required": [
|
||
"id",
|
||
"point",
|
||
"contractVersion",
|
||
"definitionRef"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"id": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 200,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "产品内稳定贡献 ID；与来源、产品及精确安装实例共同定位运行绑定。"
|
||
},
|
||
"point": {
|
||
"type": "string",
|
||
"enum": [
|
||
"document.parsers",
|
||
"session.panels",
|
||
"session.widgets",
|
||
"session.actions",
|
||
"tools",
|
||
"skills"
|
||
],
|
||
"description": "具有实际宿主消费者的贡献点；未知贡献点不得接入。"
|
||
},
|
||
"contractVersion": {
|
||
"const": 1,
|
||
"description": "该贡献点的消费契约版本；不兼容版本不激活。"
|
||
},
|
||
"definitionRef": {
|
||
"type": "object",
|
||
"required": [
|
||
"path",
|
||
"sha256"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"path": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 512,
|
||
"pattern": "^(?!/)(?!.*\\\\)(?!.*:)(?!.*\\u0000)(?!.*(?:^|/)(?:\\.|\\.\\.)(?:/|$))(?!.*//)[^/]+(?:/[^/]+)*$",
|
||
"description": "固定在核验制品根下的规范 POSIX 相对文件路径；拒绝绝对路径、反斜杠、盘符、空段、点段及 NUL。解析时仍须核验 realpath containment。"
|
||
},
|
||
"sha256": {
|
||
"type": "string",
|
||
"pattern": "^[a-f0-9]{64}$",
|
||
"description": "固定文件字节的 SHA-256；消费前核验，编辑须提交新安装修订。"
|
||
}
|
||
},
|
||
"description": "安装制品根下内容固定的材料引用；相对路径和摘要必须共同匹配。"
|
||
}
|
||
},
|
||
"description": "包内贡献定义引用；业务层补充贡献 ID 唯一性及内容摘要核验。"
|
||
},
|
||
"description": "本产品提供的宿主贡献；仅消费能力的普通应用允许空数组，独立插件必须至少一项。每项定义从安装材料读取并核验。"
|
||
},
|
||
"configurationSchemaRef": {
|
||
"type": "object",
|
||
"required": [
|
||
"path",
|
||
"sha256"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"path": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 512,
|
||
"pattern": "^(?!/)(?!.*\\\\)(?!.*:)(?!.*\\u0000)(?!.*(?:^|/)(?:\\.|\\.\\.)(?:/|$))(?!.*//)[^/]+(?:/[^/]+)*$",
|
||
"description": "固定在核验制品根下的规范 POSIX 相对文件路径；拒绝绝对路径、反斜杠、盘符、空段、点段及 NUL。解析时仍须核验 realpath containment。"
|
||
},
|
||
"sha256": {
|
||
"type": "string",
|
||
"pattern": "^[a-f0-9]{64}$",
|
||
"description": "固定文件字节的 SHA-256；消费前核验，编辑须提交新安装修订。"
|
||
}
|
||
},
|
||
"description": "安装制品根下内容固定的材料引用；相对路径和摘要必须共同匹配。"
|
||
},
|
||
"requires": {
|
||
"type": "array",
|
||
"maxItems": 64,
|
||
"items": {
|
||
"type": "object",
|
||
"required": [
|
||
"sourceId",
|
||
"appId",
|
||
"contributionId",
|
||
"contractVersion",
|
||
"optional"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"sourceId": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 200,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "直接依赖的受信产品来源，禁止按同名产品猜测。"
|
||
},
|
||
"appId": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 200,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "所依赖的应用或插件产品 ID；静态定义不携带安装实例 ID。"
|
||
},
|
||
"contributionId": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 200,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "消费方需要的具体贡献 ID。"
|
||
},
|
||
"contractVersion": {
|
||
"const": 1,
|
||
"description": "消费方支持的贡献契约版本。"
|
||
},
|
||
"optional": {
|
||
"type": "boolean",
|
||
"description": "true 为可选增强；false 缺失时阻断受影响功能，不自动安装或卸载。"
|
||
},
|
||
"versionRange": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 120,
|
||
"description": "可选发布版本 semver 范围，由满足性检查器校验。"
|
||
}
|
||
},
|
||
"description": "直接能力依赖；运行时须显式解析兼容的精确安装实例，不建设递归依赖求解器。"
|
||
},
|
||
"description": "本产品消费的必需或可选直接能力依赖；不产生使用授权。"
|
||
}
|
||
},
|
||
"not": {
|
||
"properties": {
|
||
"contributes": {
|
||
"maxItems": 0
|
||
},
|
||
"requires": {
|
||
"maxItems": 0
|
||
}
|
||
}
|
||
},
|
||
"description": "产品提供或消费宿主能力的关系契约；至少声明一项贡献或依赖。普通应用可仅消费，独立插件仍须提供实际贡献。"
|
||
},
|
||
"entrypoints": {
|
||
"type": "array",
|
||
"maxItems": 32,
|
||
"items": {
|
||
"oneOf": [
|
||
{
|
||
"type": "object",
|
||
"description": "DesireCore 自带并随客户端发布的页面入口；第三方目录不得伪造此入口类型",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"kind",
|
||
"route"
|
||
],
|
||
"properties": {
|
||
"id": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 160,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "应用内稳定入口 ID"
|
||
},
|
||
"name": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 120,
|
||
"description": "入口显示名称"
|
||
},
|
||
"kind": {
|
||
"const": "builtin",
|
||
"description": "内置页面入口判别字段"
|
||
},
|
||
"route": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 512,
|
||
"pattern": "^/(?!/)",
|
||
"description": "客户端内置路由；必须是单斜杠开头的相对应用路由，不能是 URL"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
{
|
||
"type": "object",
|
||
"description": "由隔离 App Host 承载的 Web 应用入口，运行时 URL 只可由服务端从 serviceRef 解析",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"kind",
|
||
"serviceRef"
|
||
],
|
||
"properties": {
|
||
"id": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 160,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "应用内稳定入口 ID"
|
||
},
|
||
"name": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 120,
|
||
"description": "入口显示名称"
|
||
},
|
||
"kind": {
|
||
"const": "embedded-web",
|
||
"description": "隔离 Web 入口判别字段"
|
||
},
|
||
"serviceRef": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 240,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "Registry 服务 ID 或服务端生成的本机端口引用；不是 URL"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
{
|
||
"type": "object",
|
||
"description": "由系统浏览器打开的目录声明入口；运行时 URL 只可由服务端从 serviceRef 解析",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"kind",
|
||
"serviceRef"
|
||
],
|
||
"properties": {
|
||
"id": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 160,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "应用内稳定入口 ID"
|
||
},
|
||
"name": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 120,
|
||
"description": "入口显示名称"
|
||
},
|
||
"kind": {
|
||
"const": "external",
|
||
"description": "外部浏览器入口判别字段"
|
||
},
|
||
"serviceRef": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 240,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "Registry 服务 ID；不是 URL，解析结果还需 HTTPS 或本机 loopback 校验"
|
||
},
|
||
"path": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 512,
|
||
"pattern": "^/(?!/)",
|
||
"description": "可选服务内路径；解析层禁止凭据、反斜杠和目录穿越"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
{
|
||
"type": "object",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"kind"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"id": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 160,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "应用内稳定入口 ID。"
|
||
},
|
||
"name": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 120,
|
||
"description": "交给 Agent 打开的入口显示名。"
|
||
},
|
||
"kind": {
|
||
"const": "agent",
|
||
"description": "读取实例维护资料后委派 Agent；无需服务端口或标准启动接口。"
|
||
}
|
||
}
|
||
}
|
||
],
|
||
"description": "应用的一个用户可见启动入口，按 kind 严格判别"
|
||
},
|
||
"description": "明确用户入口；plugin 允许空数组，普通应用至少一个入口。"
|
||
}
|
||
},
|
||
"allOf": [
|
||
{
|
||
"if": {
|
||
"properties": {
|
||
"productKind": {
|
||
"const": "plugin"
|
||
}
|
||
},
|
||
"required": [
|
||
"productKind"
|
||
]
|
||
},
|
||
"then": {
|
||
"required": [
|
||
"extension"
|
||
],
|
||
"properties": {
|
||
"extension": {
|
||
"properties": {
|
||
"contributes": {
|
||
"minItems": 1
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"else": {
|
||
"properties": {
|
||
"entrypoints": {
|
||
"minItems": 1
|
||
}
|
||
}
|
||
}
|
||
}
|
||
]
|
||
},
|
||
"nativeMaintainer": {
|
||
"type": "object",
|
||
"required": [
|
||
"name",
|
||
"url"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"name": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"url": {
|
||
"$ref": "#/definitions/httpsUrl"
|
||
},
|
||
"verified": {
|
||
"type": "boolean"
|
||
}
|
||
}
|
||
},
|
||
"id": {
|
||
"type": "string",
|
||
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*$",
|
||
"description": "Stable entry identifier; must equal the containing directory name."
|
||
},
|
||
"nonEmptyString": {
|
||
"type": "string",
|
||
"minLength": 1
|
||
},
|
||
"version": {
|
||
"type": "string",
|
||
"pattern": "^[0-9]+(?:\\.[0-9]+){1,3}(?:[-+][0-9A-Za-z.-]+)?$",
|
||
"description": "Entry or client version in dotted numeric form."
|
||
},
|
||
"httpsUrl": {
|
||
"type": "string",
|
||
"pattern": "^https://[^\\s]+$",
|
||
"description": "An HTTPS URL without embedded whitespace."
|
||
},
|
||
"platformSupport": {
|
||
"type": "array",
|
||
"minItems": 1,
|
||
"uniqueItems": true,
|
||
"items": {
|
||
"type": "string",
|
||
"enum": [
|
||
"macos",
|
||
"windows",
|
||
"linux"
|
||
]
|
||
},
|
||
"description": "Desktop platforms on which the entry is relevant."
|
||
},
|
||
"tags": {
|
||
"type": "array",
|
||
"minItems": 1,
|
||
"uniqueItems": true,
|
||
"items": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"description": "Human-readable discovery and search tags."
|
||
},
|
||
"capabilities": {
|
||
"type": "array",
|
||
"minItems": 1,
|
||
"uniqueItems": true,
|
||
"items": {
|
||
"type": "string",
|
||
"pattern": "^[a-z0-9]+(?:_[a-z0-9]+)*$"
|
||
}
|
||
},
|
||
"environment": {
|
||
"type": "object",
|
||
"additionalProperties": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"mcpInstall": {
|
||
"type": "object",
|
||
"required": [
|
||
"method",
|
||
"command",
|
||
"args"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"method": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"packageName": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"command": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"args": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"postInstall": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
}
|
||
},
|
||
"env": {
|
||
"$ref": "#/definitions/environment"
|
||
}
|
||
}
|
||
},
|
||
"connection": {
|
||
"type": "object",
|
||
"required": [
|
||
"transport"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"transport": {
|
||
"type": "string",
|
||
"enum": [
|
||
"stdio",
|
||
"streamable-http",
|
||
"sse"
|
||
]
|
||
},
|
||
"command": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"args": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string"
|
||
}
|
||
},
|
||
"url": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"env": {
|
||
"$ref": "#/definitions/environment"
|
||
}
|
||
}
|
||
},
|
||
"dockerApp": {
|
||
"type": "object",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"type",
|
||
"version",
|
||
"author",
|
||
"description",
|
||
"tags",
|
||
"icon",
|
||
"iconLetter",
|
||
"platformSupport",
|
||
"category",
|
||
"fullDesc",
|
||
"shortDesc",
|
||
"install",
|
||
"entrypoints"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"id": {
|
||
"$ref": "#/definitions/id"
|
||
},
|
||
"name": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"type": {
|
||
"const": "docker-app"
|
||
},
|
||
"version": {
|
||
"$ref": "#/definitions/version"
|
||
},
|
||
"author": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"description": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"tags": {
|
||
"$ref": "#/definitions/tags"
|
||
},
|
||
"icon": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"iconLetter": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 2
|
||
},
|
||
"platformSupport": {
|
||
"$ref": "#/definitions/platformSupport"
|
||
},
|
||
"category": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"pattern": "^[a-z0-9-]+$",
|
||
"description": "应用分类（slug 格式），可扩展任意分类"
|
||
},
|
||
"fullDesc": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"shortDesc": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"stars": {
|
||
"type": "integer",
|
||
"minimum": 0
|
||
},
|
||
"githubUrl": {
|
||
"$ref": "#/definitions/httpsUrl"
|
||
},
|
||
"install": {
|
||
"type": "object",
|
||
"required": [
|
||
"method",
|
||
"requirements",
|
||
"configNeeded"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"method": {
|
||
"type": "string",
|
||
"enum": [
|
||
"docker",
|
||
"docker-compose"
|
||
]
|
||
},
|
||
"requirements": {
|
||
"type": "object",
|
||
"required": [
|
||
"docker",
|
||
"minMemory",
|
||
"minDisk",
|
||
"ports"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"docker": {
|
||
"const": true
|
||
},
|
||
"minMemory": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"minDisk": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"ports": {
|
||
"type": "array",
|
||
"minItems": 1,
|
||
"uniqueItems": true,
|
||
"items": {
|
||
"type": "integer",
|
||
"minimum": 1,
|
||
"maximum": 65535
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"configNeeded": {
|
||
"type": "array",
|
||
"items": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"exposes": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "object",
|
||
"required": [
|
||
"type",
|
||
"port",
|
||
"path",
|
||
"name"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"type": {
|
||
"const": "http-api"
|
||
},
|
||
"port": {
|
||
"type": "integer",
|
||
"minimum": 1,
|
||
"maximum": 65535
|
||
},
|
||
"path": {
|
||
"type": "string",
|
||
"pattern": "^/"
|
||
},
|
||
"name": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"productKind": {
|
||
"type": "string",
|
||
"enum": [
|
||
"application",
|
||
"plugin"
|
||
],
|
||
"description": "主要产品归属；应用提供独立业务，插件增加宿主能力。旧定义缺失时由受信适配层归一为 application。"
|
||
},
|
||
"extension": {
|
||
"type": "object",
|
||
"required": [
|
||
"apiVersion",
|
||
"hosts",
|
||
"runtime",
|
||
"contributes"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"apiVersion": {
|
||
"const": "1.0.0",
|
||
"description": "宿主扩展协议版本；当前支持 1.0.0。"
|
||
},
|
||
"hosts": {
|
||
"type": "array",
|
||
"minItems": 1,
|
||
"maxItems": 2,
|
||
"uniqueItems": true,
|
||
"items": {
|
||
"type": "string",
|
||
"enum": [
|
||
"agent-service",
|
||
"desktop-host"
|
||
]
|
||
},
|
||
"description": "执行宿主；未实现的宿主只作声明并显示不兼容，客户端展示面在 UI 定义中另行声明。"
|
||
},
|
||
"runtime": {
|
||
"oneOf": [
|
||
{
|
||
"type": "object",
|
||
"required": [
|
||
"kind"
|
||
],
|
||
"properties": {
|
||
"kind": {
|
||
"const": "declarative",
|
||
"description": "仅由宿主读取声明，不创建执行进程。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
{
|
||
"type": "object",
|
||
"required": [
|
||
"kind",
|
||
"protocol",
|
||
"descriptorRef"
|
||
],
|
||
"properties": {
|
||
"kind": {
|
||
"const": "service",
|
||
"description": "既有服务 owner 管理的协议连接；贡献调用继续走原授权和审批。"
|
||
},
|
||
"protocol": {
|
||
"type": "string",
|
||
"enum": [
|
||
"mcp",
|
||
"http"
|
||
],
|
||
"description": "服务通信协议，不代表连接已经建立。"
|
||
},
|
||
"descriptorRef": {
|
||
"type": "object",
|
||
"required": [
|
||
"path",
|
||
"sha256"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"path": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 512,
|
||
"pattern": "^(?!/)(?!.*\\\\)(?!.*:)(?!.*\\u0000)(?!.*(?:^|/)(?:\\.|\\.\\.)(?:/|$))(?!.*//)[^/]+(?:/[^/]+)*$",
|
||
"description": "固定在核验制品根下的规范 POSIX 相对文件路径；拒绝绝对路径、反斜杠、盘符、空段、点段及 NUL。解析时仍须核验 realpath containment。"
|
||
},
|
||
"sha256": {
|
||
"type": "string",
|
||
"pattern": "^[a-f0-9]{64}$",
|
||
"description": "固定文件字节的 SHA-256；消费前核验，编辑须提交新安装修订。"
|
||
}
|
||
},
|
||
"description": "安装制品根下内容固定的材料引用；相对路径和摘要必须共同匹配。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
}
|
||
],
|
||
"description": "贡献执行承载；descriptor 只定位受核验材料，不能直接把任意 endpoint 当运行事实。"
|
||
},
|
||
"contributes": {
|
||
"type": "array",
|
||
"maxItems": 64,
|
||
"items": {
|
||
"type": "object",
|
||
"required": [
|
||
"id",
|
||
"point",
|
||
"contractVersion",
|
||
"definitionRef"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"id": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 200,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "产品内稳定贡献 ID；与来源、产品及精确安装实例共同定位运行绑定。"
|
||
},
|
||
"point": {
|
||
"type": "string",
|
||
"enum": [
|
||
"document.parsers",
|
||
"session.panels",
|
||
"session.widgets",
|
||
"session.actions",
|
||
"tools",
|
||
"skills"
|
||
],
|
||
"description": "具有实际宿主消费者的贡献点；未知贡献点不得接入。"
|
||
},
|
||
"contractVersion": {
|
||
"const": 1,
|
||
"description": "该贡献点的消费契约版本；不兼容版本不激活。"
|
||
},
|
||
"definitionRef": {
|
||
"type": "object",
|
||
"required": [
|
||
"path",
|
||
"sha256"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"path": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 512,
|
||
"pattern": "^(?!/)(?!.*\\\\)(?!.*:)(?!.*\\u0000)(?!.*(?:^|/)(?:\\.|\\.\\.)(?:/|$))(?!.*//)[^/]+(?:/[^/]+)*$",
|
||
"description": "固定在核验制品根下的规范 POSIX 相对文件路径；拒绝绝对路径、反斜杠、盘符、空段、点段及 NUL。解析时仍须核验 realpath containment。"
|
||
},
|
||
"sha256": {
|
||
"type": "string",
|
||
"pattern": "^[a-f0-9]{64}$",
|
||
"description": "固定文件字节的 SHA-256；消费前核验，编辑须提交新安装修订。"
|
||
}
|
||
},
|
||
"description": "安装制品根下内容固定的材料引用；相对路径和摘要必须共同匹配。"
|
||
}
|
||
},
|
||
"description": "包内贡献定义引用；业务层补充贡献 ID 唯一性及内容摘要核验。"
|
||
},
|
||
"description": "本产品提供的宿主贡献；仅消费能力的普通应用允许空数组，独立插件必须至少一项。每项定义从安装材料读取并核验。"
|
||
},
|
||
"configurationSchemaRef": {
|
||
"type": "object",
|
||
"required": [
|
||
"path",
|
||
"sha256"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"path": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 512,
|
||
"pattern": "^(?!/)(?!.*\\\\)(?!.*:)(?!.*\\u0000)(?!.*(?:^|/)(?:\\.|\\.\\.)(?:/|$))(?!.*//)[^/]+(?:/[^/]+)*$",
|
||
"description": "固定在核验制品根下的规范 POSIX 相对文件路径；拒绝绝对路径、反斜杠、盘符、空段、点段及 NUL。解析时仍须核验 realpath containment。"
|
||
},
|
||
"sha256": {
|
||
"type": "string",
|
||
"pattern": "^[a-f0-9]{64}$",
|
||
"description": "固定文件字节的 SHA-256；消费前核验，编辑须提交新安装修订。"
|
||
}
|
||
},
|
||
"description": "安装制品根下内容固定的材料引用；相对路径和摘要必须共同匹配。"
|
||
},
|
||
"requires": {
|
||
"type": "array",
|
||
"maxItems": 64,
|
||
"items": {
|
||
"type": "object",
|
||
"required": [
|
||
"sourceId",
|
||
"appId",
|
||
"contributionId",
|
||
"contractVersion",
|
||
"optional"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"sourceId": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 200,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "直接依赖的受信产品来源，禁止按同名产品猜测。"
|
||
},
|
||
"appId": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 200,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "所依赖的应用或插件产品 ID；静态定义不携带安装实例 ID。"
|
||
},
|
||
"contributionId": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 200,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "消费方需要的具体贡献 ID。"
|
||
},
|
||
"contractVersion": {
|
||
"const": 1,
|
||
"description": "消费方支持的贡献契约版本。"
|
||
},
|
||
"optional": {
|
||
"type": "boolean",
|
||
"description": "true 为可选增强；false 缺失时阻断受影响功能，不自动安装或卸载。"
|
||
},
|
||
"versionRange": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 120,
|
||
"description": "可选发布版本 semver 范围，由满足性检查器校验。"
|
||
}
|
||
},
|
||
"description": "直接能力依赖；运行时须显式解析兼容的精确安装实例，不建设递归依赖求解器。"
|
||
},
|
||
"description": "本产品消费的必需或可选直接能力依赖；不产生使用授权。"
|
||
}
|
||
},
|
||
"not": {
|
||
"properties": {
|
||
"contributes": {
|
||
"maxItems": 0
|
||
},
|
||
"requires": {
|
||
"maxItems": 0
|
||
}
|
||
}
|
||
},
|
||
"description": "产品提供或消费宿主能力的关系契约；至少声明一项贡献或依赖。普通应用可仅消费，独立插件仍须提供实际贡献。"
|
||
},
|
||
"entrypoints": {
|
||
"type": "array",
|
||
"maxItems": 32,
|
||
"items": {
|
||
"oneOf": [
|
||
{
|
||
"type": "object",
|
||
"description": "DesireCore 自带并随客户端发布的页面入口；第三方目录不得伪造此入口类型",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"kind",
|
||
"route"
|
||
],
|
||
"properties": {
|
||
"id": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 160,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "应用内稳定入口 ID"
|
||
},
|
||
"name": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 120,
|
||
"description": "入口显示名称"
|
||
},
|
||
"kind": {
|
||
"const": "builtin",
|
||
"description": "内置页面入口判别字段"
|
||
},
|
||
"route": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 512,
|
||
"pattern": "^/(?!/)",
|
||
"description": "客户端内置路由；必须是单斜杠开头的相对应用路由，不能是 URL"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
{
|
||
"type": "object",
|
||
"description": "由隔离 App Host 承载的 Web 应用入口，运行时 URL 只可由服务端从 serviceRef 解析",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"kind",
|
||
"serviceRef"
|
||
],
|
||
"properties": {
|
||
"id": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 160,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "应用内稳定入口 ID"
|
||
},
|
||
"name": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 120,
|
||
"description": "入口显示名称"
|
||
},
|
||
"kind": {
|
||
"const": "embedded-web",
|
||
"description": "隔离 Web 入口判别字段"
|
||
},
|
||
"serviceRef": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 240,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "Registry 服务 ID 或服务端生成的本机端口引用；不是 URL"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
{
|
||
"type": "object",
|
||
"description": "由系统浏览器打开的目录声明入口；运行时 URL 只可由服务端从 serviceRef 解析",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"kind",
|
||
"serviceRef"
|
||
],
|
||
"properties": {
|
||
"id": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 160,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "应用内稳定入口 ID"
|
||
},
|
||
"name": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 120,
|
||
"description": "入口显示名称"
|
||
},
|
||
"kind": {
|
||
"const": "external",
|
||
"description": "外部浏览器入口判别字段"
|
||
},
|
||
"serviceRef": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 240,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "Registry 服务 ID；不是 URL，解析结果还需 HTTPS 或本机 loopback 校验"
|
||
},
|
||
"path": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 512,
|
||
"pattern": "^/(?!/)",
|
||
"description": "可选服务内路径；解析层禁止凭据、反斜杠和目录穿越"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
{
|
||
"type": "object",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"kind"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"id": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 160,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "应用内稳定入口 ID。"
|
||
},
|
||
"name": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 120,
|
||
"description": "交给 Agent 打开的入口显示名。"
|
||
},
|
||
"kind": {
|
||
"const": "agent",
|
||
"description": "读取实例维护资料后委派 Agent；无需服务端口或标准启动接口。"
|
||
}
|
||
}
|
||
}
|
||
],
|
||
"description": "应用的一个用户可见启动入口，按 kind 严格判别"
|
||
},
|
||
"description": "明确用户入口；plugin 允许空数组，普通应用至少一个入口。"
|
||
},
|
||
"placementPolicy": {
|
||
"type": "object",
|
||
"description": "目录维护者声明的可放置范围；只限制能力，不能替用户自动固定或绑定",
|
||
"required": [
|
||
"showInMyApps",
|
||
"allowNavPin",
|
||
"allowAgentBinding"
|
||
],
|
||
"properties": {
|
||
"showInMyApps": {
|
||
"type": "boolean",
|
||
"description": "安装后是否允许出现在“我的应用”"
|
||
},
|
||
"allowNavPin": {
|
||
"type": "boolean",
|
||
"description": "用户是否可将应用固定到主导航"
|
||
},
|
||
"allowAgentBinding": {
|
||
"type": "boolean",
|
||
"description": "用户是否可将应用关联到 Agent 会话侧栏"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"stewardship": {
|
||
"type": "string",
|
||
"enum": [
|
||
"official",
|
||
"partner",
|
||
"community",
|
||
"pointer"
|
||
],
|
||
"description": "条目治理身份：official 仅能由受信 official catalog provider 注入；partner/community/pointer 分别表示合作方、社区维护或纯上游指针。"
|
||
},
|
||
"availability": {
|
||
"type": "string",
|
||
"enum": [
|
||
"listing-only",
|
||
"installable"
|
||
],
|
||
"description": "目录可用性：listing-only 仅允许浏览上游；installable 才允许进入既有受治理获取流程，不表示已经安装或正在运行。"
|
||
},
|
||
"license": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "覆盖实际制品的许可证标识。"
|
||
},
|
||
"redistribution": {
|
||
"type": "string",
|
||
"enum": [
|
||
"allowed",
|
||
"source-pointer-only",
|
||
"verify-package-terms"
|
||
],
|
||
"description": "内容转交策略：allowed 可按许可证分发；source-pointer-only 只能从权威上游取得；verify-package-terms 表示条款尚未完成复核。"
|
||
},
|
||
"source": {
|
||
"type": "object",
|
||
"description": "经过审核的上游来源指针；安装时必须进一步证明 ref 或制品摘要不可变。",
|
||
"required": [
|
||
"kind",
|
||
"url",
|
||
"ref"
|
||
],
|
||
"properties": {
|
||
"kind": {
|
||
"type": "string",
|
||
"enum": [
|
||
"git",
|
||
"release",
|
||
"package",
|
||
"container"
|
||
],
|
||
"description": "上游来源类型：Git 仓库、Release 制品、包管理器制品或容器镜像。"
|
||
},
|
||
"url": {
|
||
"type": "string",
|
||
"format": "uri",
|
||
"description": "权威上游地址；不得由客户端在安装请求中替换。"
|
||
},
|
||
"ref": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "审核版本引用；安装候选必须是完整 commit、制品版本或容器 digest。"
|
||
},
|
||
"sha256": {
|
||
"type": "string",
|
||
"pattern": "^[a-fA-F0-9]{64}$",
|
||
"description": "Release、package 或其他下载响应体的 SHA-256 摘要。"
|
||
},
|
||
"path": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "单仓库目录中的相对路径；不得作为运行时任意本地路径使用。"
|
||
},
|
||
"upstreamRepo": {
|
||
"type": "string",
|
||
"format": "uri",
|
||
"description": "制品与源码不在同一地址时对应的上游源码仓库。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"listingMaintainer": {
|
||
"type": "object",
|
||
"description": "目录策展者或上游维护者身份；两种角色必须分别存放，不能把 author 当成已验证维护者。",
|
||
"required": [
|
||
"name"
|
||
],
|
||
"properties": {
|
||
"name": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "维护者的公开名称或组织名称。"
|
||
},
|
||
"url": {
|
||
"type": "string",
|
||
"format": "uri",
|
||
"description": "维护者的公开主页、项目主页或可验证身份页面。"
|
||
},
|
||
"verified": {
|
||
"type": "boolean",
|
||
"description": "平台是否已验证该身份；不等同于许可证授权、内容审核或上游背书。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"upstreamMaintainer": {
|
||
"type": "object",
|
||
"description": "目录策展者或上游维护者身份；两种角色必须分别存放，不能把 author 当成已验证维护者。",
|
||
"required": [
|
||
"name"
|
||
],
|
||
"properties": {
|
||
"name": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "维护者的公开名称或组织名称。"
|
||
},
|
||
"url": {
|
||
"type": "string",
|
||
"format": "uri",
|
||
"description": "维护者的公开主页、项目主页或可验证身份页面。"
|
||
},
|
||
"verified": {
|
||
"type": "boolean",
|
||
"description": "平台是否已验证该身份；不等同于许可证授权、内容审核或上游背书。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"branding": {
|
||
"type": "object",
|
||
"description": "名称、Logo 和官方关系的展示依据；代码许可证不能自动授予商标或宣传素材权利。",
|
||
"required": [
|
||
"relationship",
|
||
"nameUsage",
|
||
"logoStatus"
|
||
],
|
||
"properties": {
|
||
"relationship": {
|
||
"type": "string",
|
||
"enum": [
|
||
"official",
|
||
"partner",
|
||
"independent-listing"
|
||
],
|
||
"description": "与上游的公开关系：官方、已确认合作，或独立事实索引。"
|
||
},
|
||
"nameUsage": {
|
||
"type": "string",
|
||
"enum": [
|
||
"owned",
|
||
"licensed",
|
||
"nominative"
|
||
],
|
||
"description": "项目名称的使用依据：自有、已获许可，或识别上游所需的指称性使用。"
|
||
},
|
||
"logoStatus": {
|
||
"type": "string",
|
||
"enum": [
|
||
"not-used",
|
||
"license-covered",
|
||
"trademark-policy-allowed",
|
||
"permission-obtained"
|
||
],
|
||
"description": "Logo 使用依据；未确认权利时必须为 not-used，并由客户端使用中性图标。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"compliance": {
|
||
"type": "object",
|
||
"description": "绑定到本次不可变来源的合规审核记录；新版本必须重新审核，不能继承旧版本结论。",
|
||
"required": [
|
||
"licenseEvidencePath",
|
||
"reviewedRef",
|
||
"reviewedAt",
|
||
"reviewedBy",
|
||
"upstreamEndorsed"
|
||
],
|
||
"properties": {
|
||
"licenseEvidencePath": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "在已审核源码或制品中定位许可证文本的相对路径。"
|
||
},
|
||
"noticePath": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "需要履行 NOTICE 或署名义务时，对应材料的相对路径。"
|
||
},
|
||
"reviewedRef": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "实际完成许可证、品牌和供应链复核的不可变 ref，必须与获取来源一致。"
|
||
},
|
||
"reviewedAt": {
|
||
"type": "string",
|
||
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T.*)?$",
|
||
"description": "审核日期或 ISO 8601 时间戳。"
|
||
},
|
||
"reviewedBy": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "可追溯的审核者或审核流程标识。"
|
||
},
|
||
"upstreamEndorsed": {
|
||
"type": "boolean",
|
||
"description": "上游是否明确认可该条目；false 时必须显示非官方、未经背书声明。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
}
|
||
},
|
||
"allOf": [
|
||
{
|
||
"if": {
|
||
"properties": {
|
||
"productKind": {
|
||
"const": "plugin"
|
||
}
|
||
},
|
||
"required": [
|
||
"productKind"
|
||
]
|
||
},
|
||
"then": {
|
||
"required": [
|
||
"extension"
|
||
],
|
||
"properties": {
|
||
"extension": {
|
||
"properties": {
|
||
"contributes": {
|
||
"minItems": 1
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"else": {
|
||
"properties": {
|
||
"entrypoints": {
|
||
"minItems": 1
|
||
}
|
||
}
|
||
}
|
||
}
|
||
]
|
||
},
|
||
"mcp": {
|
||
"type": "object",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"type",
|
||
"version",
|
||
"author",
|
||
"description",
|
||
"tags",
|
||
"icon",
|
||
"platformSupport",
|
||
"capabilities",
|
||
"connection"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"id": {
|
||
"$ref": "#/definitions/id"
|
||
},
|
||
"name": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"type": {
|
||
"const": "mcp"
|
||
},
|
||
"version": {
|
||
"$ref": "#/definitions/version"
|
||
},
|
||
"author": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"description": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"tags": {
|
||
"$ref": "#/definitions/tags"
|
||
},
|
||
"icon": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"platformSupport": {
|
||
"$ref": "#/definitions/platformSupport"
|
||
},
|
||
"capabilities": {
|
||
"$ref": "#/definitions/capabilities"
|
||
},
|
||
"toolCount": {
|
||
"type": "integer",
|
||
"minimum": 0
|
||
},
|
||
"install": {
|
||
"$ref": "#/definitions/mcpInstall"
|
||
},
|
||
"connection": {
|
||
"$ref": "#/definitions/connection"
|
||
},
|
||
"sourceAppId": {
|
||
"$ref": "#/definitions/id"
|
||
},
|
||
"sourceAppName": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
}
|
||
}
|
||
},
|
||
"httpApi": {
|
||
"type": "object",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"type",
|
||
"version",
|
||
"author",
|
||
"description",
|
||
"tags",
|
||
"icon",
|
||
"platformSupport",
|
||
"endpoint",
|
||
"capabilities"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"id": {
|
||
"$ref": "#/definitions/id"
|
||
},
|
||
"name": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"type": {
|
||
"const": "http-api"
|
||
},
|
||
"version": {
|
||
"$ref": "#/definitions/version"
|
||
},
|
||
"author": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"description": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"tags": {
|
||
"$ref": "#/definitions/tags"
|
||
},
|
||
"icon": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"platformSupport": {
|
||
"$ref": "#/definitions/platformSupport"
|
||
},
|
||
"endpoint": {
|
||
"type": "string",
|
||
"pattern": "^https?://[^\\s]+$"
|
||
},
|
||
"capabilities": {
|
||
"$ref": "#/definitions/capabilities"
|
||
},
|
||
"sourceAppId": {
|
||
"$ref": "#/definitions/id"
|
||
},
|
||
"sourceAppName": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
}
|
||
}
|
||
},
|
||
"maintainer": {
|
||
"type": "object",
|
||
"required": [
|
||
"name",
|
||
"url",
|
||
"verified"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"name": {
|
||
"allOf": [
|
||
{
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
}
|
||
],
|
||
"description": "Human-readable maintainer identity."
|
||
},
|
||
"url": {
|
||
"allOf": [
|
||
{
|
||
"$ref": "#/definitions/httpsUrl"
|
||
}
|
||
],
|
||
"description": "Public source used to verify the maintainer identity."
|
||
},
|
||
"verified": {
|
||
"const": true,
|
||
"description": "The Registry maintainer verified this identity against the public source."
|
||
}
|
||
}
|
||
},
|
||
"officialLink": {
|
||
"description": "A Kimi WebBridge upstream URL pinned by kind, hostname, path, and extension ID where applicable.",
|
||
"oneOf": [
|
||
{
|
||
"type": "object",
|
||
"required": [
|
||
"kind",
|
||
"label",
|
||
"url"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"kind": {
|
||
"const": "product"
|
||
},
|
||
"label": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"url": {
|
||
"const": "https://www.kimi.ai/products/kimi-webbridge"
|
||
}
|
||
}
|
||
},
|
||
{
|
||
"type": "object",
|
||
"required": [
|
||
"kind",
|
||
"label",
|
||
"url"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"kind": {
|
||
"const": "documentation"
|
||
},
|
||
"label": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"url": {
|
||
"const": "https://www.kimi.ai/help/kimi-webbridge/kimi-webbridge-introduction"
|
||
}
|
||
}
|
||
},
|
||
{
|
||
"type": "object",
|
||
"required": [
|
||
"kind",
|
||
"label",
|
||
"extensionId",
|
||
"url"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"kind": {
|
||
"const": "chrome-web-store"
|
||
},
|
||
"label": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"extensionId": {
|
||
"const": "fldmhceldgbpfpkbgopacenieobmligc",
|
||
"description": "The audited Chrome Web Store extension identifier."
|
||
},
|
||
"url": {
|
||
"const": "https://chromewebstore.google.com/detail/kimi-webbridge/fldmhceldgbpfpkbgopacenieobmligc"
|
||
}
|
||
}
|
||
},
|
||
{
|
||
"type": "object",
|
||
"required": [
|
||
"kind",
|
||
"label",
|
||
"extensionId",
|
||
"url"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"kind": {
|
||
"const": "edge-add-ons"
|
||
},
|
||
"label": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"extensionId": {
|
||
"const": "bnlffdbcfnanfbknnlaflhlhkocccckg",
|
||
"description": "The audited Microsoft Edge Add-ons extension identifier."
|
||
},
|
||
"url": {
|
||
"const": "https://microsoftedge.microsoft.com/addons/detail/kimi-webbridge/bnlffdbcfnanfbknnlaflhlhkocccckg"
|
||
}
|
||
}
|
||
},
|
||
{
|
||
"type": "object",
|
||
"required": [
|
||
"kind",
|
||
"label",
|
||
"url"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"kind": {
|
||
"const": "privacy"
|
||
},
|
||
"label": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"url": {
|
||
"const": "https://www.kimi.ai/user/agreement/userPrivacy?version=v2"
|
||
}
|
||
}
|
||
},
|
||
{
|
||
"type": "object",
|
||
"required": [
|
||
"kind",
|
||
"label",
|
||
"url"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"kind": {
|
||
"const": "terms"
|
||
},
|
||
"label": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"url": {
|
||
"const": "https://www.kimi.ai/user/agreement/modelUse?version=v2"
|
||
}
|
||
}
|
||
}
|
||
]
|
||
},
|
||
"browserExtensionComponent": {
|
||
"type": "object",
|
||
"required": [
|
||
"kind",
|
||
"name",
|
||
"description",
|
||
"distribution",
|
||
"browsers"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"kind": {
|
||
"const": "browser-extension"
|
||
},
|
||
"name": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"description": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"distribution": {
|
||
"const": "official-upstream-only",
|
||
"description": "DesireCore does not mirror or repackage this third-party component."
|
||
},
|
||
"browsers": {
|
||
"type": "array",
|
||
"minItems": 2,
|
||
"maxItems": 2,
|
||
"uniqueItems": true,
|
||
"items": {
|
||
"type": "string",
|
||
"enum": [
|
||
"chrome",
|
||
"edge"
|
||
]
|
||
},
|
||
"allOf": [
|
||
{
|
||
"contains": {
|
||
"const": "chrome"
|
||
}
|
||
},
|
||
{
|
||
"contains": {
|
||
"const": "edge"
|
||
}
|
||
}
|
||
]
|
||
}
|
||
}
|
||
},
|
||
"localDaemonComponent": {
|
||
"type": "object",
|
||
"required": [
|
||
"kind",
|
||
"name",
|
||
"description",
|
||
"distribution",
|
||
"platforms"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"kind": {
|
||
"const": "local-daemon"
|
||
},
|
||
"name": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"description": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"distribution": {
|
||
"const": "official-upstream-only",
|
||
"description": "DesireCore does not mirror or repackage this third-party component."
|
||
},
|
||
"platforms": {
|
||
"type": "array",
|
||
"minItems": 2,
|
||
"maxItems": 3,
|
||
"uniqueItems": true,
|
||
"items": {
|
||
"type": "string",
|
||
"enum": [
|
||
"macos",
|
||
"windows",
|
||
"linux"
|
||
]
|
||
},
|
||
"allOf": [
|
||
{
|
||
"contains": {
|
||
"const": "macos"
|
||
}
|
||
},
|
||
{
|
||
"contains": {
|
||
"const": "windows"
|
||
}
|
||
}
|
||
]
|
||
}
|
||
}
|
||
},
|
||
"externalComponent": {
|
||
"description": "One strictly discriminated Kimi WebBridge physical component.",
|
||
"oneOf": [
|
||
{
|
||
"$ref": "#/definitions/browserExtensionComponent"
|
||
},
|
||
{
|
||
"$ref": "#/definitions/localDaemonComponent"
|
||
}
|
||
]
|
||
},
|
||
"artifactReview": {
|
||
"type": "object",
|
||
"required": [
|
||
"component",
|
||
"platform",
|
||
"architecture",
|
||
"version",
|
||
"url",
|
||
"sha256",
|
||
"reviewedAt",
|
||
"reviewedBy"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"component": {
|
||
"const": "local-daemon"
|
||
},
|
||
"platform": {
|
||
"type": "string",
|
||
"enum": [
|
||
"macos",
|
||
"windows",
|
||
"linux"
|
||
]
|
||
},
|
||
"architecture": {
|
||
"type": "string",
|
||
"enum": [
|
||
"x64",
|
||
"arm64"
|
||
]
|
||
},
|
||
"version": {
|
||
"$ref": "#/definitions/version"
|
||
},
|
||
"url": {
|
||
"$ref": "#/definitions/httpsUrl"
|
||
},
|
||
"sha256": {
|
||
"type": "string",
|
||
"pattern": "^[a-f0-9]{64}$"
|
||
},
|
||
"reviewedAt": {
|
||
"type": "string",
|
||
"format": "date"
|
||
},
|
||
"reviewedBy": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
}
|
||
}
|
||
},
|
||
"externalIntegration": {
|
||
"type": "object",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"type",
|
||
"version",
|
||
"author",
|
||
"description",
|
||
"category",
|
||
"shortDesc",
|
||
"fullDesc",
|
||
"tags",
|
||
"icon",
|
||
"platformSupport",
|
||
"requiredClientVersion",
|
||
"stewardship",
|
||
"availability",
|
||
"redistribution",
|
||
"branding",
|
||
"listingMaintainer",
|
||
"upstreamMaintainer",
|
||
"integration",
|
||
"officialLinks",
|
||
"components",
|
||
"permissions",
|
||
"profileRecommendation",
|
||
"dataBoundaries",
|
||
"admission",
|
||
"compliance"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"id": {
|
||
"const": "kimi-webbridge",
|
||
"description": "The only external-integration ID admitted by Registry Schema v4."
|
||
},
|
||
"name": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"type": {
|
||
"const": "external-integration"
|
||
},
|
||
"version": {
|
||
"$ref": "#/definitions/version"
|
||
},
|
||
"author": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"description": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"category": {
|
||
"const": "tools"
|
||
},
|
||
"shortDesc": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"fullDesc": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"tags": {
|
||
"$ref": "#/definitions/tags"
|
||
},
|
||
"icon": {
|
||
"type": "string",
|
||
"enum": [
|
||
"monitor",
|
||
"puzzle",
|
||
"globe"
|
||
],
|
||
"description": "A neutral DesireCore icon name; upstream logos are not permitted in this listing type."
|
||
},
|
||
"platformSupport": {
|
||
"type": "array",
|
||
"minItems": 2,
|
||
"maxItems": 2,
|
||
"uniqueItems": true,
|
||
"items": {
|
||
"type": "string",
|
||
"enum": [
|
||
"macos",
|
||
"windows"
|
||
]
|
||
},
|
||
"allOf": [
|
||
{
|
||
"contains": {
|
||
"const": "macos"
|
||
}
|
||
},
|
||
{
|
||
"contains": {
|
||
"const": "windows"
|
||
}
|
||
}
|
||
],
|
||
"description": "The reviewed listing must support both macOS and Windows."
|
||
},
|
||
"requiredClientVersion": {
|
||
"allOf": [
|
||
{
|
||
"$ref": "#/definitions/version"
|
||
}
|
||
],
|
||
"description": "Minimum DesireCore version that understands this strict listing-only entry."
|
||
},
|
||
"stewardship": {
|
||
"const": "pointer"
|
||
},
|
||
"availability": {
|
||
"const": "listing-only"
|
||
},
|
||
"redistribution": {
|
||
"const": "source-pointer-only"
|
||
},
|
||
"branding": {
|
||
"type": "object",
|
||
"required": [
|
||
"relationship",
|
||
"nameUsage",
|
||
"logoStatus"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"relationship": {
|
||
"const": "independent-listing"
|
||
},
|
||
"nameUsage": {
|
||
"const": "nominative"
|
||
},
|
||
"logoStatus": {
|
||
"const": "not-used"
|
||
}
|
||
}
|
||
},
|
||
"listingMaintainer": {
|
||
"$ref": "#/definitions/maintainer"
|
||
},
|
||
"upstreamMaintainer": {
|
||
"$ref": "#/definitions/maintainer"
|
||
},
|
||
"integration": {
|
||
"type": "object",
|
||
"required": [
|
||
"kind",
|
||
"adapterId",
|
||
"executionAvailability",
|
||
"installMode"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"kind": {
|
||
"const": "local-extension-bridge"
|
||
},
|
||
"adapterId": {
|
||
"$ref": "#/definitions/id"
|
||
},
|
||
"executionAvailability": {
|
||
"const": "blocked"
|
||
},
|
||
"installMode": {
|
||
"const": "upstream-guided"
|
||
}
|
||
}
|
||
},
|
||
"officialLinks": {
|
||
"type": "array",
|
||
"minItems": 6,
|
||
"maxItems": 6,
|
||
"uniqueItems": true,
|
||
"items": {
|
||
"$ref": "#/definitions/officialLink"
|
||
},
|
||
"description": "One reviewed official source for each required link kind."
|
||
},
|
||
"components": {
|
||
"type": "array",
|
||
"minItems": 2,
|
||
"maxItems": 2,
|
||
"uniqueItems": true,
|
||
"items": {
|
||
"$ref": "#/definitions/externalComponent"
|
||
},
|
||
"description": "The upstream browser extension and local daemon, neither redistributed by DesireCore."
|
||
},
|
||
"permissions": {
|
||
"type": "object",
|
||
"required": [
|
||
"browserExtension"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"browserExtension": {
|
||
"type": "object",
|
||
"required": [
|
||
"apiPermissions",
|
||
"hostPermissions",
|
||
"riskLevel"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"apiPermissions": {
|
||
"type": "array",
|
||
"minItems": 7,
|
||
"maxItems": 7,
|
||
"uniqueItems": true,
|
||
"items": {
|
||
"type": "string",
|
||
"enum": [
|
||
"tabs",
|
||
"activeTab",
|
||
"debugger",
|
||
"storage",
|
||
"alarms",
|
||
"tabGroups",
|
||
"windows"
|
||
]
|
||
}
|
||
},
|
||
"hostPermissions": {
|
||
"type": "array",
|
||
"minItems": 1,
|
||
"maxItems": 1,
|
||
"items": {
|
||
"const": "<all_urls>"
|
||
}
|
||
},
|
||
"riskLevel": {
|
||
"const": "high"
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"profileRecommendation": {
|
||
"const": "dedicated-browser-profile"
|
||
},
|
||
"dataBoundaries": {
|
||
"type": "object",
|
||
"required": [
|
||
"webBridgeLocalExecution",
|
||
"desireCoreModelContext",
|
||
"modelProviderDisclosureRequired"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"webBridgeLocalExecution": {
|
||
"allOf": [
|
||
{
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
}
|
||
],
|
||
"description": "A scoped statement of the upstream claim about the local WebBridge execution path."
|
||
},
|
||
"desireCoreModelContext": {
|
||
"allOf": [
|
||
{
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
}
|
||
],
|
||
"description": "A separate disclosure that content entering DesireCore context may be sent to the selected model provider."
|
||
},
|
||
"modelProviderDisclosureRequired": {
|
||
"const": true
|
||
}
|
||
}
|
||
},
|
||
"admission": {
|
||
"type": "object",
|
||
"required": [
|
||
"status",
|
||
"code",
|
||
"reason",
|
||
"missingPrerequisites"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"status": {
|
||
"const": "blocked"
|
||
},
|
||
"code": {
|
||
"const": "native-integration-not-admitted"
|
||
},
|
||
"reason": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"missingPrerequisites": {
|
||
"type": "array",
|
||
"minItems": 4,
|
||
"maxItems": 4,
|
||
"uniqueItems": true,
|
||
"items": {
|
||
"type": "string",
|
||
"enum": [
|
||
"stable-auditable-protocol",
|
||
"integration-authorization",
|
||
"deterministic-command-receipts",
|
||
"user-interaction-pause-signal"
|
||
]
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"compliance": {
|
||
"type": "object",
|
||
"required": [
|
||
"reviewedAt",
|
||
"reviewedBy",
|
||
"upstreamEndorsed",
|
||
"relationshipDisclosure",
|
||
"artifactReviews"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"reviewedAt": {
|
||
"type": "string",
|
||
"format": "date"
|
||
},
|
||
"reviewedBy": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"upstreamEndorsed": {
|
||
"const": false
|
||
},
|
||
"relationshipDisclosure": {
|
||
"const": "independent-listing-not-endorsed"
|
||
},
|
||
"artifactReviews": {
|
||
"type": "array",
|
||
"minItems": 1,
|
||
"items": {
|
||
"$ref": "#/definitions/artifactReview"
|
||
},
|
||
"description": "Immutable upstream artifact audit facts; these records do not admit installation or redistribution."
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"artifact": {
|
||
"type": "object",
|
||
"description": "纯声明制品：由宿主读取受核验文件，不需要 Node、Docker、端口或虚假运行进程。安装仍走 Agent 材料/核验/唯一账本。",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"type",
|
||
"version",
|
||
"author",
|
||
"description",
|
||
"tags",
|
||
"icon",
|
||
"iconLetter",
|
||
"platformSupport",
|
||
"category",
|
||
"fullDesc",
|
||
"shortDesc",
|
||
"install",
|
||
"source",
|
||
"requiredClientVersion",
|
||
"placementPolicy",
|
||
"stewardship",
|
||
"availability",
|
||
"license",
|
||
"redistribution",
|
||
"listingMaintainer",
|
||
"upstreamMaintainer",
|
||
"branding",
|
||
"compliance",
|
||
"productKind",
|
||
"entrypoints",
|
||
"extension"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"id": {
|
||
"$ref": "#/definitions/id"
|
||
},
|
||
"name": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"type": {
|
||
"const": "artifact",
|
||
"description": "声明制品交付类别，与 productKind 正交。"
|
||
},
|
||
"version": {
|
||
"$ref": "#/definitions/version"
|
||
},
|
||
"author": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"description": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"tags": {
|
||
"$ref": "#/definitions/tags"
|
||
},
|
||
"icon": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"iconLetter": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 2
|
||
},
|
||
"platformSupport": {
|
||
"$ref": "#/definitions/platformSupport"
|
||
},
|
||
"category": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"pattern": "^[a-z0-9-]+$",
|
||
"description": "应用分类（slug 格式），可扩展任意分类"
|
||
},
|
||
"fullDesc": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"shortDesc": {
|
||
"$ref": "#/definitions/nonEmptyString"
|
||
},
|
||
"githubUrl": {
|
||
"$ref": "#/definitions/httpsUrl"
|
||
},
|
||
"requiredClientVersion": {
|
||
"$ref": "#/definitions/version"
|
||
},
|
||
"install": {
|
||
"type": "object",
|
||
"description": "应用安装配置：描述如何安装和部署此应用",
|
||
"required": [
|
||
"method",
|
||
"requirements"
|
||
],
|
||
"allOf": [
|
||
{
|
||
"if": {
|
||
"properties": {
|
||
"method": {
|
||
"const": "native-node"
|
||
}
|
||
},
|
||
"required": [
|
||
"method"
|
||
]
|
||
},
|
||
"then": {
|
||
"properties": {
|
||
"requirements": {
|
||
"required": [
|
||
"node"
|
||
],
|
||
"properties": {
|
||
"docker": {
|
||
"const": false
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
{
|
||
"if": {
|
||
"properties": {
|
||
"method": {
|
||
"const": "artifact"
|
||
}
|
||
},
|
||
"required": [
|
||
"method"
|
||
]
|
||
},
|
||
"then": {
|
||
"properties": {
|
||
"requirements": {
|
||
"properties": {
|
||
"docker": {
|
||
"const": false
|
||
},
|
||
"ports": {
|
||
"maxItems": 0
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
}
|
||
],
|
||
"properties": {
|
||
"method": {
|
||
"const": "artifact",
|
||
"description": "按安装材料获取、核验和维护纯声明文件。"
|
||
},
|
||
"requirements": {
|
||
"type": "object",
|
||
"description": "系统要求：安装前需满足的硬件和环境条件",
|
||
"required": [
|
||
"docker",
|
||
"ports"
|
||
],
|
||
"properties": {
|
||
"docker": {
|
||
"type": "boolean",
|
||
"description": "是否需要 Docker 环境"
|
||
},
|
||
"minMemory": {
|
||
"type": "string",
|
||
"description": "发布者声明的内存要求或建议；未知时省略，不用通用默认值或当前运行用量填充。"
|
||
},
|
||
"minDisk": {
|
||
"type": "string",
|
||
"description": "发布者声明的磁盘空间要求或建议；未知时省略，不代表实测占用。"
|
||
},
|
||
"ports": {
|
||
"type": "array",
|
||
"description": "需要开放的端口号列表",
|
||
"items": {
|
||
"type": "integer",
|
||
"minimum": 1,
|
||
"maximum": 65535
|
||
}
|
||
},
|
||
"node": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 80,
|
||
"description": "宿主机 Node.js 版本要求；native-node 安装必填。"
|
||
},
|
||
"envVars": {
|
||
"type": "array",
|
||
"description": "需要配置的环境变量名列表（如 API_KEY、DATABASE_URL）",
|
||
"items": {
|
||
"type": "string"
|
||
}
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"configNeeded": {
|
||
"type": "array",
|
||
"items": {
|
||
"type": "string"
|
||
},
|
||
"description": "安装前需准备的配置项（人类可读清单）"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"placementPolicy": {
|
||
"type": "object",
|
||
"description": "目录维护者声明的可放置范围；只限制能力，不能替用户自动固定或绑定",
|
||
"required": [
|
||
"showInMyApps",
|
||
"allowNavPin",
|
||
"allowAgentBinding"
|
||
],
|
||
"properties": {
|
||
"showInMyApps": {
|
||
"type": "boolean",
|
||
"description": "安装后是否允许出现在“我的应用”"
|
||
},
|
||
"allowNavPin": {
|
||
"type": "boolean",
|
||
"description": "用户是否可将应用固定到主导航"
|
||
},
|
||
"allowAgentBinding": {
|
||
"type": "boolean",
|
||
"description": "用户是否可将应用关联到 Agent 会话侧栏"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"source": {
|
||
"type": "object",
|
||
"description": "经过审核的上游来源指针；安装时必须进一步证明 ref 或制品摘要不可变。",
|
||
"required": [
|
||
"kind",
|
||
"url",
|
||
"ref"
|
||
],
|
||
"properties": {
|
||
"kind": {
|
||
"type": "string",
|
||
"enum": [
|
||
"git",
|
||
"release",
|
||
"package",
|
||
"container"
|
||
],
|
||
"description": "上游来源类型：Git 仓库、Release 制品、包管理器制品或容器镜像。"
|
||
},
|
||
"url": {
|
||
"type": "string",
|
||
"format": "uri",
|
||
"description": "权威上游地址；不得由客户端在安装请求中替换。"
|
||
},
|
||
"ref": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "审核版本引用；安装候选必须是完整 commit、制品版本或容器 digest。"
|
||
},
|
||
"sha256": {
|
||
"type": "string",
|
||
"pattern": "^[a-fA-F0-9]{64}$",
|
||
"description": "Release、package 或其他下载响应体的 SHA-256 摘要。"
|
||
},
|
||
"path": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "单仓库目录中的相对路径；不得作为运行时任意本地路径使用。"
|
||
},
|
||
"upstreamRepo": {
|
||
"type": "string",
|
||
"format": "uri",
|
||
"description": "制品与源码不在同一地址时对应的上游源码仓库。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"stewardship": {
|
||
"type": "string",
|
||
"enum": [
|
||
"official",
|
||
"partner",
|
||
"community",
|
||
"pointer"
|
||
],
|
||
"description": "条目治理身份：official 仅能由受信 official catalog provider 注入；partner/community/pointer 分别表示合作方、社区维护或纯上游指针。"
|
||
},
|
||
"availability": {
|
||
"type": "string",
|
||
"enum": [
|
||
"listing-only",
|
||
"installable"
|
||
],
|
||
"description": "目录可用性：listing-only 仅允许浏览上游；installable 才允许进入既有受治理获取流程，不表示已经安装或正在运行。"
|
||
},
|
||
"license": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "覆盖实际制品的许可证标识。"
|
||
},
|
||
"redistribution": {
|
||
"type": "string",
|
||
"enum": [
|
||
"allowed",
|
||
"source-pointer-only",
|
||
"verify-package-terms"
|
||
],
|
||
"description": "内容转交策略：allowed 可按许可证分发；source-pointer-only 只能从权威上游取得；verify-package-terms 表示条款尚未完成复核。"
|
||
},
|
||
"listingMaintainer": {
|
||
"type": "object",
|
||
"description": "目录策展者或上游维护者身份；两种角色必须分别存放，不能把 author 当成已验证维护者。",
|
||
"required": [
|
||
"name"
|
||
],
|
||
"properties": {
|
||
"name": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "维护者的公开名称或组织名称。"
|
||
},
|
||
"url": {
|
||
"type": "string",
|
||
"format": "uri",
|
||
"description": "维护者的公开主页、项目主页或可验证身份页面。"
|
||
},
|
||
"verified": {
|
||
"type": "boolean",
|
||
"description": "平台是否已验证该身份；不等同于许可证授权、内容审核或上游背书。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"upstreamMaintainer": {
|
||
"type": "object",
|
||
"description": "目录策展者或上游维护者身份；两种角色必须分别存放，不能把 author 当成已验证维护者。",
|
||
"required": [
|
||
"name"
|
||
],
|
||
"properties": {
|
||
"name": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "维护者的公开名称或组织名称。"
|
||
},
|
||
"url": {
|
||
"type": "string",
|
||
"format": "uri",
|
||
"description": "维护者的公开主页、项目主页或可验证身份页面。"
|
||
},
|
||
"verified": {
|
||
"type": "boolean",
|
||
"description": "平台是否已验证该身份；不等同于许可证授权、内容审核或上游背书。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"branding": {
|
||
"type": "object",
|
||
"description": "名称、Logo 和官方关系的展示依据；代码许可证不能自动授予商标或宣传素材权利。",
|
||
"required": [
|
||
"relationship",
|
||
"nameUsage",
|
||
"logoStatus"
|
||
],
|
||
"properties": {
|
||
"relationship": {
|
||
"type": "string",
|
||
"enum": [
|
||
"official",
|
||
"partner",
|
||
"independent-listing"
|
||
],
|
||
"description": "与上游的公开关系：官方、已确认合作，或独立事实索引。"
|
||
},
|
||
"nameUsage": {
|
||
"type": "string",
|
||
"enum": [
|
||
"owned",
|
||
"licensed",
|
||
"nominative"
|
||
],
|
||
"description": "项目名称的使用依据：自有、已获许可，或识别上游所需的指称性使用。"
|
||
},
|
||
"logoStatus": {
|
||
"type": "string",
|
||
"enum": [
|
||
"not-used",
|
||
"license-covered",
|
||
"trademark-policy-allowed",
|
||
"permission-obtained"
|
||
],
|
||
"description": "Logo 使用依据；未确认权利时必须为 not-used，并由客户端使用中性图标。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"compliance": {
|
||
"type": "object",
|
||
"description": "绑定到本次不可变来源的合规审核记录；新版本必须重新审核，不能继承旧版本结论。",
|
||
"required": [
|
||
"licenseEvidencePath",
|
||
"reviewedRef",
|
||
"reviewedAt",
|
||
"reviewedBy",
|
||
"upstreamEndorsed"
|
||
],
|
||
"properties": {
|
||
"licenseEvidencePath": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "在已审核源码或制品中定位许可证文本的相对路径。"
|
||
},
|
||
"noticePath": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "需要履行 NOTICE 或署名义务时，对应材料的相对路径。"
|
||
},
|
||
"reviewedRef": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "实际完成许可证、品牌和供应链复核的不可变 ref，必须与获取来源一致。"
|
||
},
|
||
"reviewedAt": {
|
||
"type": "string",
|
||
"pattern": "^\\d{4}-\\d{2}-\\d{2}(?:T.*)?$",
|
||
"description": "审核日期或 ISO 8601 时间戳。"
|
||
},
|
||
"reviewedBy": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"description": "可追溯的审核者或审核流程标识。"
|
||
},
|
||
"upstreamEndorsed": {
|
||
"type": "boolean",
|
||
"description": "上游是否明确认可该条目；false 时必须显示非官方、未经背书声明。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"productKind": {
|
||
"type": "string",
|
||
"enum": [
|
||
"application",
|
||
"plugin"
|
||
],
|
||
"description": "主要产品归属；应用提供独立业务，插件增加宿主能力。旧定义缺失时由受信适配层归一为 application。"
|
||
},
|
||
"extension": {
|
||
"type": "object",
|
||
"required": [
|
||
"apiVersion",
|
||
"hosts",
|
||
"runtime",
|
||
"contributes"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"apiVersion": {
|
||
"const": "1.0.0",
|
||
"description": "宿主扩展协议版本；当前支持 1.0.0。"
|
||
},
|
||
"hosts": {
|
||
"type": "array",
|
||
"minItems": 1,
|
||
"maxItems": 2,
|
||
"uniqueItems": true,
|
||
"items": {
|
||
"type": "string",
|
||
"enum": [
|
||
"agent-service",
|
||
"desktop-host"
|
||
]
|
||
},
|
||
"description": "执行宿主；未实现的宿主只作声明并显示不兼容，客户端展示面在 UI 定义中另行声明。"
|
||
},
|
||
"runtime": {
|
||
"type": "object",
|
||
"required": [
|
||
"kind"
|
||
],
|
||
"properties": {
|
||
"kind": {
|
||
"const": "declarative",
|
||
"description": "只由宿主读取声明，不创建执行进程。"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
"contributes": {
|
||
"type": "array",
|
||
"maxItems": 64,
|
||
"items": {
|
||
"type": "object",
|
||
"required": [
|
||
"id",
|
||
"point",
|
||
"contractVersion",
|
||
"definitionRef"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"id": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 200,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "产品内稳定贡献 ID；与来源、产品及精确安装实例共同定位运行绑定。"
|
||
},
|
||
"point": {
|
||
"type": "string",
|
||
"enum": [
|
||
"document.parsers",
|
||
"session.panels",
|
||
"session.widgets",
|
||
"session.actions",
|
||
"tools",
|
||
"skills"
|
||
],
|
||
"description": "具有实际宿主消费者的贡献点；未知贡献点不得接入。"
|
||
},
|
||
"contractVersion": {
|
||
"const": 1,
|
||
"description": "该贡献点的消费契约版本；不兼容版本不激活。"
|
||
},
|
||
"definitionRef": {
|
||
"type": "object",
|
||
"required": [
|
||
"path",
|
||
"sha256"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"path": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 512,
|
||
"pattern": "^(?!/)(?!.*\\\\)(?!.*:)(?!.*\\u0000)(?!.*(?:^|/)(?:\\.|\\.\\.)(?:/|$))(?!.*//)[^/]+(?:/[^/]+)*$",
|
||
"description": "固定在核验制品根下的规范 POSIX 相对文件路径；拒绝绝对路径、反斜杠、盘符、空段、点段及 NUL。解析时仍须核验 realpath containment。"
|
||
},
|
||
"sha256": {
|
||
"type": "string",
|
||
"pattern": "^[a-f0-9]{64}$",
|
||
"description": "固定文件字节的 SHA-256；消费前核验，编辑须提交新安装修订。"
|
||
}
|
||
},
|
||
"description": "安装制品根下内容固定的材料引用；相对路径和摘要必须共同匹配。"
|
||
}
|
||
},
|
||
"description": "包内贡献定义引用；业务层补充贡献 ID 唯一性及内容摘要核验。"
|
||
},
|
||
"description": "本产品提供的宿主贡献；仅消费能力的普通应用允许空数组，独立插件必须至少一项。每项定义从安装材料读取并核验。"
|
||
},
|
||
"configurationSchemaRef": {
|
||
"type": "object",
|
||
"required": [
|
||
"path",
|
||
"sha256"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"path": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 512,
|
||
"pattern": "^(?!/)(?!.*\\\\)(?!.*:)(?!.*\\u0000)(?!.*(?:^|/)(?:\\.|\\.\\.)(?:/|$))(?!.*//)[^/]+(?:/[^/]+)*$",
|
||
"description": "固定在核验制品根下的规范 POSIX 相对文件路径；拒绝绝对路径、反斜杠、盘符、空段、点段及 NUL。解析时仍须核验 realpath containment。"
|
||
},
|
||
"sha256": {
|
||
"type": "string",
|
||
"pattern": "^[a-f0-9]{64}$",
|
||
"description": "固定文件字节的 SHA-256；消费前核验，编辑须提交新安装修订。"
|
||
}
|
||
},
|
||
"description": "安装制品根下内容固定的材料引用；相对路径和摘要必须共同匹配。"
|
||
},
|
||
"requires": {
|
||
"type": "array",
|
||
"maxItems": 64,
|
||
"items": {
|
||
"type": "object",
|
||
"required": [
|
||
"sourceId",
|
||
"appId",
|
||
"contributionId",
|
||
"contractVersion",
|
||
"optional"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"sourceId": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 200,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "直接依赖的受信产品来源，禁止按同名产品猜测。"
|
||
},
|
||
"appId": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 200,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "所依赖的应用或插件产品 ID；静态定义不携带安装实例 ID。"
|
||
},
|
||
"contributionId": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 200,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "消费方需要的具体贡献 ID。"
|
||
},
|
||
"contractVersion": {
|
||
"const": 1,
|
||
"description": "消费方支持的贡献契约版本。"
|
||
},
|
||
"optional": {
|
||
"type": "boolean",
|
||
"description": "true 为可选增强；false 缺失时阻断受影响功能，不自动安装或卸载。"
|
||
},
|
||
"versionRange": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 120,
|
||
"description": "可选发布版本 semver 范围，由满足性检查器校验。"
|
||
}
|
||
},
|
||
"description": "直接能力依赖；运行时须显式解析兼容的精确安装实例，不建设递归依赖求解器。"
|
||
},
|
||
"description": "本产品消费的必需或可选直接能力依赖；不产生使用授权。"
|
||
}
|
||
},
|
||
"not": {
|
||
"properties": {
|
||
"contributes": {
|
||
"maxItems": 0
|
||
},
|
||
"requires": {
|
||
"maxItems": 0
|
||
}
|
||
}
|
||
},
|
||
"description": "产品提供或消费宿主能力的关系契约；至少声明一项贡献或依赖。普通应用可仅消费，独立插件仍须提供实际贡献。"
|
||
},
|
||
"entrypoints": {
|
||
"type": "array",
|
||
"maxItems": 32,
|
||
"items": {
|
||
"oneOf": [
|
||
{
|
||
"type": "object",
|
||
"description": "DesireCore 自带并随客户端发布的页面入口；第三方目录不得伪造此入口类型",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"kind",
|
||
"route"
|
||
],
|
||
"properties": {
|
||
"id": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 160,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "应用内稳定入口 ID"
|
||
},
|
||
"name": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 120,
|
||
"description": "入口显示名称"
|
||
},
|
||
"kind": {
|
||
"const": "builtin",
|
||
"description": "内置页面入口判别字段"
|
||
},
|
||
"route": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 512,
|
||
"pattern": "^/(?!/)",
|
||
"description": "客户端内置路由；必须是单斜杠开头的相对应用路由，不能是 URL"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
{
|
||
"type": "object",
|
||
"description": "由隔离 App Host 承载的 Web 应用入口，运行时 URL 只可由服务端从 serviceRef 解析",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"kind",
|
||
"serviceRef"
|
||
],
|
||
"properties": {
|
||
"id": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 160,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "应用内稳定入口 ID"
|
||
},
|
||
"name": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 120,
|
||
"description": "入口显示名称"
|
||
},
|
||
"kind": {
|
||
"const": "embedded-web",
|
||
"description": "隔离 Web 入口判别字段"
|
||
},
|
||
"serviceRef": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 240,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "Registry 服务 ID 或服务端生成的本机端口引用；不是 URL"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
{
|
||
"type": "object",
|
||
"description": "由系统浏览器打开的目录声明入口；运行时 URL 只可由服务端从 serviceRef 解析",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"kind",
|
||
"serviceRef"
|
||
],
|
||
"properties": {
|
||
"id": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 160,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "应用内稳定入口 ID"
|
||
},
|
||
"name": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 120,
|
||
"description": "入口显示名称"
|
||
},
|
||
"kind": {
|
||
"const": "external",
|
||
"description": "外部浏览器入口判别字段"
|
||
},
|
||
"serviceRef": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 240,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "Registry 服务 ID；不是 URL，解析结果还需 HTTPS 或本机 loopback 校验"
|
||
},
|
||
"path": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 512,
|
||
"pattern": "^/(?!/)",
|
||
"description": "可选服务内路径；解析层禁止凭据、反斜杠和目录穿越"
|
||
}
|
||
},
|
||
"additionalProperties": false
|
||
},
|
||
{
|
||
"type": "object",
|
||
"required": [
|
||
"id",
|
||
"name",
|
||
"kind"
|
||
],
|
||
"additionalProperties": false,
|
||
"properties": {
|
||
"id": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 160,
|
||
"pattern": "^[a-zA-Z0-9][a-zA-Z0-9._:-]*$",
|
||
"description": "应用内稳定入口 ID。"
|
||
},
|
||
"name": {
|
||
"type": "string",
|
||
"minLength": 1,
|
||
"maxLength": 120,
|
||
"description": "交给 Agent 打开的入口显示名。"
|
||
},
|
||
"kind": {
|
||
"const": "agent",
|
||
"description": "读取实例维护资料后委派 Agent；无需服务端口或标准启动接口。"
|
||
}
|
||
}
|
||
}
|
||
],
|
||
"description": "应用的一个用户可见启动入口，按 kind 严格判别"
|
||
},
|
||
"description": "明确用户入口；plugin 允许空数组，普通应用至少一个入口。"
|
||
}
|
||
},
|
||
"allOf": [
|
||
{
|
||
"if": {
|
||
"properties": {
|
||
"productKind": {
|
||
"const": "plugin"
|
||
}
|
||
},
|
||
"required": [
|
||
"productKind"
|
||
]
|
||
},
|
||
"then": {
|
||
"required": [
|
||
"extension"
|
||
],
|
||
"properties": {
|
||
"extension": {
|
||
"properties": {
|
||
"contributes": {
|
||
"minItems": 1
|
||
}
|
||
}
|
||
}
|
||
}
|
||
},
|
||
"else": {
|
||
"properties": {
|
||
"entrypoints": {
|
||
"minItems": 1
|
||
}
|
||
}
|
||
}
|
||
}
|
||
]
|
||
}
|
||
}
|
||
}
|