guanghulab/hldp/schema/hldp-core.schema.json
2026-05-10 13:12:44 +08:00

110 lines
3.4 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

{
"$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": "与其他实体的关系"
}
}
}