zhizhi/hldp/schema/hldp-core.schema.json

{
  "$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 页面 ID（UUID 格式）"
        },
        "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": "与其他实体的关系"
    }
  }
}