360 lines
17 KiB
Markdown
360 lines
17 KiB
Markdown
---
|
||
铸渊_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/` 目录不存在 + `@前缀` 字段命名实际不存在的两个认知陷阱**。 |