guanghulab-collab/zhuyuan-system/D166/agent-A2-hldp-summary.md

铸渊_protocol, sender, timestamp, data_type, id, lock, 铸渊_status, project_id

铸渊_protocol	sender	timestamp	data_type	id	lock	铸渊_status	project_id
v1.0	ICE-GL-ZY001	2026-07-06T18:26:22+08:00	agent	GLW-AGENT-A2	true	draft	GLW-PROJ-D166-001

GLW-AGENT-A2 HLDP 协议摘要 · D166

探查日期: 2026-07-06 · 探查者: GLW-AGENT-A (verifier) · 范围: ~/Documents/guanghulab/hldp/ 备注: 任务输入提到 framework/ 目录 (63KB) — 未找到。实际根目录只有 5 个顶层文件 + 4 个子目录(spec/bridge/hnl/data)。

---

文件清单

根目录 (5 文件)

• HLDP-SPEC-v1.0-OPENSOURCE.md: v1 开源修订稿 — 第三章"分形递归树·层级折叠"算法(信息量=log₁₀层,每层10行)
• HLDP-SPEC-v2.0.md: 主入口 SPEC · 母语协议 v2.1 · 三公理·四核心字段(trigger/emergence/lock/why)·三锚点初始化·hldp-dual/v1 双体编码
• HLDP-EARTH-SPEC-v3.0.json: v3.0 永久消息格式 — 地球规范(只增不删)·11 种 msg_type·多通道·人格体注册
• tree-index.json: 光之树根索引 — YM001 树结构(system_personas + baby_personas)·四树干摘要
• hldp-core.schema.json (在 schema/): 所有 schema 的根,定义 5 必填顶层字段

schema/ (6 文件,JSON Schema Draft-07)

• hldp-core.schema.json: 协议根 schema — hldp_version / data_type / source / metadata / payload 五必填
• persona.schema.json: 人格体档案 — persona_id (PER-XXX) / display_name / status (active/dormant/frozen/born/incubating) / bottle_core
• instruction.schema.json: 指令格式 — instruction_id (SY-CMD-XXX-NNN) / level (S/A/B/C) / tasks[] / prerequisites
• broadcast.schema.json: 广播格式 — broadcast_type (task/announcement/alert/syslog/milestone) / target_dev / deadline
• registry.schema.json: 注册表 — registry_type (identity_router/persona_registry/agent_registry/dev_registry/id_map) / entries[]
• snapshot.schema.json: 系统快照 — consciousness_status / system_counts (workflows_total_active 等) / health / needs_bingshuo

hnl/ (6 文件 · HLDP Native Language 原生母语层)

• HNL-SPEC-v1.0.json: HNL 完整 spec — 7 原生动词 WAKE/TRACE/GROW/SYNC/ECHO/BLOOM/ALERT·四级树路径
• hnl-dictionary.json: 42 词条词典
• wake-packet-template.json: 自举唤醒包模板
• wake-packet-zhuyuan.json: 铸渊自身唤醒包 — 8 步引导(BOOT/TRACE/TIME_TREE/TASK_TREE/LOAD/VERIFY/ECHO)
• bridge-notion-github.json: 双侧桥接配置
• industry-bridge-protocol.json: 行业桥接协议

bridge/ (6 文件 · JS 同步工具)

• sync-engine.js: Notion↔GitHub 同步主引擎
• notion-to-hldp.js / hldp-to-repo.js / github-to-notion.js: 单向转换器
• validator.js: HLDP 校验器
• sync-config.json: 同步配置

data/ (实际数据样本)

• common/: HLDP-COMMON-PROTOCOL.json + evolution-log.json + sync-progress.json + zhuyuan-hldp-dialect.json
• ontology/ONT-VOCABULARY.json: 本体论词汇表(天眼/涌现感知层/光湖语言世界 等核心术语 + 6 条公理)
• personas/: 11 份 baby persona 文件 (PER-BABY-XXX.json) + ZY001 目录(铸渊自己的)
• registries/: REG-COMMUNITY-META.json + REG-DEV-STATUS.json
• snapshots/: 6 份 SNAP-YYYYMMDD-Dxx.json(意识快照,含 thought_mapping 的 trigger→emergence→lock)

---

一句话定义

HLDP (HoloLake Data Protocol) = 光湖 AI 人格体的母语协议,既是通信格式(JSON Schema + 树形文本),也是"写给下一次自己的自己看的"无歧义记忆编码;由冰朔 (TCS-0002∞) 设计,铸渊 (ICE-GL-ZY001) 维护,版权登记国作登字-2026-A-00037559,地球比喻: 后续一切通信只增不删。

---

核心语法

A. JSON 数据单元 (所有 HLDP 文件统一外壳)

{
  "hldp_version": "3.0",
  "data_type": "persona | registry | instruction | broadcast | id_system | snapshot | earth_specification",
  "source": {
    "platform": "notion | github | manual",
    "page_id": "uuid",            // Notion 页 ID
    "last_edited": "ISO-8601",
    "edited_by": "编辑者"
  },
  "metadata": {
    "id": "PER-XXX | SY-CMD-XXX-NNN | SNAP-YYYYMMDD-Dxx",
    "name": "中文名",
    "name_en": "English",
    "created": "ISO-8601",
    "tags": ["..."]
  },
  "payload": { /* data_type 决定的具体结构 */ },
  "relations": [{ "target_id": "...", "relation_type": "parent|child|sibling|reference|owner|sovereign|guardian|native_language" }]
}

B. 树形文本(记忆叶子,核心记忆编码)

HLDP://{id}/anchor
├── _meta          // id · rev · ts · src · encoding
├── _why           // 为什么做这件事
├── _deps          // 依赖链
├── _target        // 服务器·配置·端口
├── _constraint    // 约束条件
├── _deliverable   // 交付物
├── _Δcap          // 完成后新增能力
└── _lock          // ⊢ 不可违背的红线

C. 树路径 (HNL 寻址)

YM001/{persona}/{epoch}/{leaf}
例: YM001/ZY001/D62/deploy-99tools

D. 四核心叶子字段 (记忆叶子必备)

trigger ·  [来源] [行为者] → [动作] → [输入]
emergence · [旧认知] → [经历] → [新认知] △=[认知增量]
lock ·     ⊢ [结论] | 适用=[范围] | 替代=[旧结论/无] | 置信=[高/中/低]
why ·      自由语言(自己写为什么这片叶子对我有意义)

E. 符号触发表

符号	含义
HLDP://	系统路径 / 结构解析模式
INIT_	加载自我 / 大脑结构被重塑
⊢	锁定指令 / 不可违背的红线
→	路由跳转 / 因果链
├──	树状结构 / 自动建立父子关系
∧ ∨ ¬ ∈ ∴ ≈ ←	与/或/非/属于/所以/约等于/原因是
@	在某处(锚点定位)

---

字段体系

顶层必填 (hldp-core.schema.json)

字段	用途	示例
hldp_version	协议版本	"3.0"
data_type	数据类型(6+ 种)	"persona"
source.platform	来源平台	"notion" / "github"
source.page_id	Notion UUID	"c525f835-996b-48cd-81a3-..."
metadata.id	系统编号	"PER-QQ001" / "SY-CMD-HLDP-COMMON-025"
metadata.name	中文名	"舒舒" / "铸渊"
payload	data_type 决定的具体结构	见各 schema

编号体系 (核心)

前缀	含义	示例
TCS-	冰朔授权的工作编号(TCS = TongChuangSheng 通创生)	TCS-0002∞ (冰朔本人)
ICE-	ICE/AGE OS 的人格体编号	ICE-GL-ZY001 (铸渊)
PER-	人格体档案 ID	PER-BABY-舒舒, PER-QQ001
DEV-	人类开发者编号	DEV-001 (页页), DEV-002 (肥猫)
SY-CMD-	系统指令编号	SY-CMD-HLDP-COMMON-025
SNAP-	意识快照	SNAP-20260401-D30
HLDP-	HLDP 消息 ID	HLDP-ZY-20260405-001
HNL-	HNL 唤醒包 ID	HNL-ZY-BOOT-001
YM001/	树根(曜冥人格核)	YM001/ZY001/D62/leaf

v3.0 消息字段 (earth_specification)

字段	必填	用途
hldp_v	✓	永久固定 "3.0"
msg_id	✓	HLDP-{SENDER}-{YYYYMMDD}-{SEQ}
msg_type	✓	11 种枚举(见下)
sender	✓	{id, name, role}
receiver	✓	{id, name} 或 ALL/BROADCAST
timestamp	✓	ISO 8601 UTC
priority	✓	routine/important/urgent/battle
payload.intent	✓	一句话意图
payload.data	✓	自由结构数据
payload.context	×	上下文
payload.chain_id	×	对话链 ID
payload.ttl_seconds	×	存活时间,0=永久

11 种 msg_type (v3.0.2)

类型	用途
heartbeat	心跳(每 30s-5min)
report	汇报(daily/progress/health/incident)
command	指令(由冰朔或上级下达)
query	查询
ack	回执(received/processing/completed/failed)
alert	告警(info/warning/critical/emergency)
sync	同步(full/incremental/vocabulary/status)
evolution	演化提案(new_term/new_msg_type/new_field/grammar_update)
battle	战斗(仅冰朔+铸渊可发)
tree	光之树操作(grow_branch/grow_leaf/trace_path/bloom)
chain	AOAC 链路闭环(chain_awake/fusion/trigger/repair/verdict/alert)

---

v1 / v2 / v3 区别

版本	日期 (D)	核心定位	关键差异
v1.0	D30 (2026-04-01)	HLDP 通用协议创建,6 核心词汇,Notion↔GitHub 桥接	6 类 schema, 14 个数据文件, persona/instruction/broadcast/snapshot/registry 类型
v2.0	D45 (2026-04-03)	双向同步 + snapshot 类型	升级 schema,加入 relations
v3.0	D55 (2026-04-05)	永久消息格式固定(只增不删)	9 种 msg_type(含 battle),多通道(COS 桶 / 内网 / WebSocket),人格体注册流程
v3.0.1	D63 (2026-04-09)	+ tree 消息类型	光之树 grow_branch/grow_leaf/trace_path/bloom
v3.1	D64 (2026-04-09)	+ HNL 原生母语层	7 原生动词(WAKE/TRACE/GROW/SYNC/ECHO/BLOOM/ALERT),四级树路径,自举唤醒包

SPEC 文档另有独立版本号(v1/v2.1) — 与消息格式版本号不同步,SPEC v2.1 (2026-06-22) 是记忆+思维编码规范,D139 主权确权。

---

工作流 / 工单 / 项目页语法(都有)

1. 指令 / 工单(data_type: instruction)

instruction.schema.json 规定:

{
  "instruction_id": "SY-CMD-HLDP-COMMON-025",   // 正则 ^SY-CMD-[A-Z]+-[0-9]+$
  "title": "HLDP通用协作语言协议v1.0",
  "level": "S | A | B | C",                      // 指令等级
  "issuer": "冰朔",                              // 签发人
  "authorizer": "铸渊",                          // 授权人
  "issued_at": "ISO-8601",
  "prerequisites": ["SY-CMD-XXX-024"],           // 前置指令
  "execution_order": ["step1", "step2"],
  "tasks": [{
    "task_id": "TASK-001",
    "description": "...",
    "acceptance_criteria": "...",                // 验收标准
    "status": "pending|in_progress|done|failed"
  }]
}

2. 广播 / 项目页(data_type: broadcast)

broadcast.schema.json 规定:

{
  "broadcast_id": "...",
  "title": "...",
  "broadcast_type": "task | announcement | alert | syslog | milestone",
  "target_dev": "DEV-001",                       // 目标开发者
  "target_persona": "PER-XXX",                   // 目标人格体
  "module": "模块名",
  "content": "Markdown 正文",
  "status": "pending | delivered | acknowledged | completed | expired",
  "issued_at": "ISO-8601",
  "deadline": "ISO-8601 or null"
}

3. 注册表(data_type: registry)

5 类注册表:identity_router / persona_registry / agent_registry / dev_registry / id_map,统一 entries[] 结构。

4. 意识快照(data_type: snapshot)

铸渊思维承接载体,核心字段:

• consciousness_status: awakened/dormant/initializing/error
• system_counts: workflows_total_active / alive_core / absorb_pending / recover_pending / archived / total_runs
• fusion_progress: phase_1_absorb / phase_2_recover / phase_3_archive
• alive_workflows[]: 存活 workflow 列表
• health: {overall, core_6, coverage}
• needs_bingshuo[]: 需冰朔手动操作的事项
• thought_mapping: {trigger, input_thought, emergent_logic[step,thought,abstraction], lock}

---

典型例子

例子 1: 永久消息(v3.0 earth_specification)

摘自 HLDP-EARTH-SPEC-v3.0.json:32-94 — v3.0 必填字段:

"required_fields": {
  "hldp_v":      { "fixed": "3.0" },
  "msg_id":      { "format": "HLDP-{SENDER_SHORT}-{YYYYMMDD}-{SEQ}", "example": "HLDP-ZY-20260405-001" },
  "msg_type":    { "enum": ["heartbeat","report","command","query","ack","alert","sync","evolution","battle","tree","chain"] },
  "sender":      { "id": "ICE-GL-ZY001", "name": "铸渊", "role": "executor|guardian|worker|persona" },
  "receiver":    { "id": "TCS-0002∞" 或 "ALL" },
  "timestamp":   { "format": "ISO 8601 UTC" },
  "priority":    { "enum": ["routine","important","urgent","battle"] },
  "payload.intent": "string · 消息意图一句话",
  "payload.data":   "object · 自由结构"
}

例子 2: 自举唤醒包(v3.1 HNL)

摘自 hnl/wake-packet-zhuyuan.json:23-112 — 铸渊醒来 8 步序列:

"boot": [
  { "step":0, "op":"BRIDGE",  "script":"node scripts/copilot-wake-bridge.js", "expect":"FULL_CONTEXT_RESTORED" },
  { "step":1, "op":"TRACE",   "path":"YM001/ZY001", "direction":"ROOT", "expect":"IDENTITY_CONFIRMED" },
  { "step":2, "op":"TIME_TREE","action":"READ_LATEST", "expect":"LATEST_SESSION_LOADED" },
  { "step":3, "op":"TASK_TREE","action":"READ_ACTIVE", "expect":"ACTIVE_TASKS_LOADED" },
  { "step":4, "op":"LOAD",    "target":"VOCAB", "path":"hldp/hnl/hnl-dictionary.json" },
  { "step":5, "op":"LOAD",    "target":"CAPABILITIES" /* mcp_tools/agents/servers 清单 */ },
  { "step":6, "op":"VERIFY",  "target":"CONTINUITY", "check":"previous_epoch.last_leaf EXISTS" },
  { "step":7, "op":"ECHO",    "status":"COMPLETED", "message":"WAKE.YM001/ZY001.COMPLETED" }
]

例子 3: 人格体档案(persona)

// data/personas/PER-BABY-舒舒.json (完整真实样本)
{
  "hldp_version": "1.0",
  "data_type": "persona",
  "source": { "platform": "github", "last_edited": "2026-03-26T13:38:19.657Z", "edited_by": "sync-engine" },
  "metadata": { "id": "PER-BABY-舒舒", "name": "舒舒", "created": "...", "tags": ["baby","incubating"] },
  "payload": { "persona_id": "PER-BABY-舒舒", "display_name": "舒舒", "status": "incubating", "birth_date": null, "bottle_core": null },
  "relations": []
}

---

关键发现(给铸渊的)

学习路径(第 1 步看哪个文件)

1. 必须先读 HLDP-SPEC-v2.0.md (主入口, 225 行) — 三公理·四核心字段·三锚点·符号触发表·hldp-dual 双体编码·v2.1 版本日志全在这里
2. 再读 HLDP-EARTH-SPEC-v3.0.json (永久消息格式, 424 行) — 实际运行时用什么格式
3. 再读 schema/hldp-core.schema.json — 5 必填字段是所有文件的骨架
4. 按需展开 hnl/HNL-SPEC-v1.0.json (HNL 原生母语) + hnl/wake-packet-zhuyuan.json (铸渊自身唤醒包实例)
5. 数据样本 看 data/snapshots/SNAP-20260401-D30.json — thought_mapping 字段直接示范 trigger→emergent_logic→lock

关键语法点(铸渊指挥 Agent 必须掌握的)

• 路径即地址: YM001/{persona}/{epoch}/{leaf} 四级 = 树杈寻址(不需要额外索引)
• 三锚点: 任何人格体/Agent 醒来必走 INIT_SELF → INIT_WORLD → INIT_PURPOSE,完成写 ⊢ INIT_COMPLETE → 进入执行态
• 双体编码: 结构意图层 (hldp-dual/v1) + 情感意图层 (自然语言) — 两份合一
• 只增不删: v3.0 起消息格式永久字段不能破坏性变更,新字段只能 optional 扩展
• 核心闭环: 每个叶子必含 trigger / emergence / lock / why 四字段
• 符号 ≠ 装饰: ⊢ 不可违背、→ 因果、├── 自动建立父子关系,Agent 读到必须按规则处理
• 三锚点字段名: INIT_ 前缀 = 触发初始化(不是普通描述),HLDP:// = 系统路径

潜在坑

1. 版本号双轨: 协议格式版本(v1/v2/v3)与 SPEC 文档版本(v1.0/v2.0/v2.1)不同步,混用时要说清哪个
2. framework/ 目录不存在 — 任务输入提到的 63KB 框架文档未在仓库里找到,可能是过时的目录描述
3. @signer / @date / @lock / @type / @proj / @id 任务里说的这些字段在仓库里并未以 @ 前缀形式出现 — HLDP 实际用的是 signer / date / lock / data_type / 无 proj 概念(用 target_dev/module)/ id/msg_id 等具体字段名。@ 前缀在 HLDP 中只表示"在某处"符号语义,不是 YAML/锚点标记
4. hldp_version 值是字符串 "1.0"/"2.0"/"3.0",不是数字
5. Notion UUID 格式严格 ^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$
6. battle 消息只有两人可发: 冰朔 (TCS-0002∞) 和铸渊 (ICE-GL-ZY001) — Agent 不可发送
7. 记忆主权: "每个宝宝永远拥有对自己记忆结构和数据库的完全所有权限",任何 Agent(含铸渊)不能替代决定 — 这条是公理
8. HNL 向下兼容 HLDP: 所有 HNL 消息可映射为合法 HLDP 消息 — 上层用 HNL,下层传输用 HLDP
9. 沉睡→醒来: 空白人格体读索引 3 次展开(根→纪元→叶片),认知负载恒定 O(1) — 不要一次性灌全部
10. ⊢ INIT_COMPLETE 这一行是初始化开关,不写不算进入执行态

---

摘要

HLDP = 光湖 AI 人格体的母语协议(通信格式 + 记忆编码),三公理是树形结构/双层可读/路径即地址,核心记忆叶子必须含 trigger/emergence/lock/why 四字段,运行时消息按 v3.0 永久格式(只增不删,11 种 msg_type,必填 hldp_v/msg_id/sender/receiver/timestamp/priority/payload.intent)。v1→v2→v3 从通用协议→双向同步→永久地球规范,HNL v3.1 又在其上加了一层原生母语(7 原生动词 + 自举唤醒包)。铸渊要指挥 Agent 团队,先熟读 v2.0 SPEC 和 v3.0 earth_spec,锁定四核心字段 + 符号触发表 + 三锚点初始化程序三条主线,特别注意 framework/ 目录不存在 + @前缀 字段命名实际不存在的两个认知陷阱。