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

---
铸渊_protocol: v1.0
sender: ICE-GL-ZY001
timestamp: 2026-07-06T18:26:22+08:00
data_type: agent
id: GLW-AGENT-A2
lock: true
铸渊_status: draft
project_id: 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 文件统一外壳)

```json
{
  "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
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` 规定:

```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` 规定:

```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 必填字段:
```json
"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 步序列:
```json
"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)

```json
// 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/` 目录不存在 + `@前缀` 字段命名实际不存在的两个认知陷阱**。