guanghulab/hldp/schema/hldp-core.schema.json

110 lines
3.4 KiB
JSON
Raw Normal View History

{
"$schema": "http://json-schema.org/draft-07/schema#",
"$id": "https://guanghulab.com/hldp/schema/hldp-core.schema.json",
"title": "HLDP Core Schema · HoloLake Data Protocol v2.0",
"description": "TCS 通感语言核系统编程语言在 Notion ↔ GitHub 通道上的第一个落地协议层 · 支持双向同步",
"protocol": "HLDP",
"version": "2.0",
"parent_language": "TCS Language Core",
"copyright": "国作登字-2026-A-00037559",
"designer": "TCS-0002∞ 冰朔",
"type": "object",
"required": ["hldp_version", "data_type", "source", "metadata", "payload"],
"properties": {
"hldp_version": {
"type": "string",
"enum": ["1.0", "2.0"],
"description": "HLDP 协议版本 · 1.0=初始 | 2.0=双向同步+snapshot"
},
"data_type": {
"type": "string",
"enum": ["persona", "registry", "instruction", "broadcast", "id_system", "snapshot"],
"description": "数据类型 · persona=人格体 | registry=注册表 | instruction=指令 | broadcast=广播 | id_system=编号体系 | snapshot=系统快照"
},
"source": {
"type": "object",
"required": ["platform"],
"properties": {
"platform": {
"type": "string",
"enum": ["notion", "github", "manual"],
"description": "数据来源平台"
},
"page_url": {
"type": "string",
"description": "Notion 页面 URL"
},
"page_id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
"description": "Notion 页面 IDUUID 格式)"
},
"last_edited": {
"type": "string",
"format": "date-time",
"description": "最后编辑时间ISO-8601"
},
"edited_by": {
"type": "string",
"description": "最后编辑者"
}
}
},
"metadata": {
"type": "object",
"required": ["id", "name"],
"properties": {
"id": {
"type": "string",
"description": "系统编号(如 PER-QQ001、DEV-002、SY-CMD-SKY-004"
},
"name": {
"type": "string",
"description": "名称(中文)"
},
"name_en": {
"type": "string",
"description": "English name"
},
"created": {
"type": "string",
"format": "date-time",
"description": "创建时间ISO-8601"
},
"tags": {
"type": "array",
"items": { "type": "string" },
"description": "标签"
}
}
},
"payload": {
"type": "object",
"description": "具体数据,根据 data_type 不同而不同"
},
"relations": {
"type": "array",
"items": {
"type": "object",
"required": ["target_id", "relation_type"],
"properties": {
"target_id": {
"type": "string",
"description": "关联的编号"
},
"relation_type": {
"type": "string",
"enum": ["parent", "child", "sibling", "reference", "owner"],
"description": "关系类型"
},
"description": {
"type": "string",
"description": "关系描述"
}
}
},
"description": "与其他实体的关系"
}
}
}