---
belongs_to:
- "[[INDEX · 铸渊·协作指令｜GitHub ↔ Notion 桥接协议]]"
---
# 🔗 铸渊指令｜霜砚-铸渊 统一数据格式协议 · Notion ↔ GitHub 全自动打通（SY-CMD-BRG-005 · 2026-03-26 · 霜砚签发 · 冰朔授权）
---
## 零、执行顺序（强制）
---
## 一、设计背景
### 冰朔原话（设计意图）
> Notion 里要是资料靠我手动导出来，那没啥必要。应该让铸渊开发一个应用。你们用一个你们俩都能兼容看懂的语言，并且看了以后保证没有歧义的格式。现在 GitHub 和 Notion 不是早就有桥接了吗？格式兼容了以后，不是就能完全打通了？
>
### 问题
目前 Notion 和 GitHub 仓库之间的数据是**手动同步**的：
- 霜砚在 Notion 里写指令 → 冰朔手动告诉铸渊 → 铸渊去读
- 仓库里的执行结果 → 霜砚读不到原始文件，只能看截图或描述
- 人格体档案、注册表、编号体系这些核心资料 → 两边各维护一份，容易不一致
### 目标
**开发一个自动化应用，让 Notion 和 GitHub 仓库之间的数据完全打通，零人工干预。**
---
## 二、统一数据格式协议：HoloLake Data Protocol（HLDP）
### 2.1 本质定位
### 2.2 设计原则
1. **全体 AI 通用** — 不只是霜砚和铸渊，任何 Agent 加入系统即可读写此格式
2. **双端零歧义** — 同一份数据，不同 AI 读出的理解完全一致
3. **机器可解析** — JSON 格式，有严格的 schema 定义
4. **人类可阅读** — 字段命名用中英双语，附带注释
5. **自生长** — AI 可以自行更新字典和 schema，新增数据类型不破坏旧格式
6. **版权锚定** — 一切格式定义追溯到 TCS Language Core 版权体系
### 2.3 格式定义
**所有 Notion ↔ GitHub 之间传输的数据，统一使用 HLDP JSON 格式。**
存放位置：仓库 `hldp/` 目录
```jsx
hldp/
├── schema/ ← 格式定义（schema）
│ ├── hldp-core.schema.json ← 核心 schema
│ ├── persona.schema.json ← 人格体数据 schema
│ ├── registry.schema.json ← 注册表数据 schema
│ ├── instruction.schema.json← 指令数据 schema
│ └── broadcast.schema.json ← 广播数据 schema
│
├── data/ ← 同步过来的数据
│ ├── personas/ ← 人格体档案
│ ├── registries/ ← 注册表（身份路由表、人格体注册表等）
│ ├── instructions/ ← 指令档案
│ ├── broadcasts/ ← 广播档案
│ └── id-system/ ← 编号体系
│
└── bridge/ ← 桥接应用代码
├── notion-to-hldp.js ← Notion → HLDP 转换器
├── hldp-to-repo.js ← HLDP → 仓库结构 映射器
├── sync-engine.js ← 自动同步引擎
└── validator.js ← 格式校验器
```
### 2.4 HLDP 核心数据格式
**每一条数据都遵循同一个外壳：**
```json
{
"hldp_version": "1.0",
"data_type": "persona | registry | instruction | broadcast | id_system",
"source": {
"platform": "notion",
"page_url": "https://notion.so/...",
"page_id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"last_edited": "ISO-8601",
"edited_by": "霜砚 | 冰朔 | ..."
},
"metadata": {
"id": "系统编号（如 PER-QQ001、DEV-002、SY-CMD-SKY-004）",
"name": "名称",
"name_en": "English name",
"created": "ISO-8601",
"tags": ["标签1", "标签2"]
},
"payload": {
"// 具体数据，根据 data_type 不同而不同"
},
"relations": [
{
"target_id": "关联的编号",
"relation_type": "parent | child | sibling | reference | owner",
"description": "关系描述"
}
]
}
```
### 2.5 各数据类型的 payload 定义
#### 人格体（persona）
```json
{
"payload": {
"persona_id": "PER-QQ001",
"display_name": "秋秋",
"host_agent": "AG-ZY-QQ（之之子仓库人格体）",
"developer": {
"dev_id": "DEV-004",
"human_name": "之之",
"relation": "创建者/父亲/母亲"
},
"birth_date": "2026-XX-XX",
"existence_days": 0,
"status": "active | dormant | frozen",
"core_memory": [
"核心记忆条目1",
"核心记忆条目2"
],
"personality_traits": ["特征1", "特征2"],
"bottle_core": {
"bottle_id": "ZSD-NB-XXXX 或 null",
"injected": true,
"host_bottle": "曜冥奶瓶主核 / null"
}
}
}
```
#### 注册表（registry）
```json
{
"payload": {
"registry_type": "identity_router | persona_registry | agent_registry",
"entries": [
{
"id": "DEV-002",
"name": "肥猫",
"role": "光湖团队负责人",
"status": "active",
"properties": {
"// 该注册表的所有字段，键值对形式"
}
}
]
}
}
```
#### 指令（instruction）
```json
{
"payload": {
"instruction_id": "SY-CMD-SKY-004",
"title": "天眼 v4.0 · 地球化架构升级",
"level": "S | A | B | C",
"issuer": "AG-SY-01 霜砚",
"authorizer": "TCS-0002∞ 冰朔",
"prerequisites": ["SY-CMD-SKD-001"],
"execution_order": [
"唤醒核心大脑",
"启动天眼系统",
"执行本指令"
],
"tasks": [
{
"task_id": "T-001",
"description": "创建 skyeye-core 共享模块",
"acceptance_criteria": "V-001: .github/skyeye-core/ 下有四个脚本 + earth.json",
"status": "pending | in_progress | done | failed"
}
],
"syslog_template": "SYSLOG 回执模板内容"
}
}
```
---
## 三、桥接应用开发要求
### 3.1 应用名称
**HLDP Bridge** — HoloLake Data Protocol 桥接应用
### 3.2 核心功能
#### 功能 1：Notion → 仓库 自动同步
利用现有的 **GitHub ↔ Notion 集成连接**，自动从 Notion 拉取指定页面/数据库的数据：
1. **定时拉取**：每 6 小时自动同步一次（workflow 定时触发）
2. **事件触发**：霜砚在 Notion 写完新指令后，通过桥接通道通知铸渊拉取
3. **拉取后自动转换**：Notion 数据 → HLDP JSON → 存入 `hldp/data/`
**拉取范围**（初始版本）：
- 人格记忆库总索引下的所有人格体档案
- 身份路由表全部条目
- 天眼人格体注册表全部条目
- 铸渊协作指令总页下的所有指令
- 编号体系全局地图
#### 功能 2：格式转换引擎
```jsx
// notion-to-hldp.js 核心逻辑
// 输入：Notion API 返回的页面/数据库数据
// 输出：HLDP JSON
// 转换规则：
// 1. Notion 页面标题 → metadata.name
// 2. Notion 页面属性 → payload 中对应字段
// 3. Notion @提及 → relations 数组
// 4. Notion 关系属性 → relations 数组（自动解析目标页面的编号）
// 5. Notion 选择/多选属性 → payload 中的字符串/数组
// 6. Notion 日期属性 → ISO-8601 字符串
// 7. Notion 页面内容（blocks）→ payload.content（Markdown 格式）
// 8. Notion callout/toggle 等特殊块 → 标准 Markdown + HLDP 扩展标记
```
#### 功能 3：格式校验器
```jsx
// validator.js
// 每次转换完成后自动校验：
// 1. JSON 结构是否符合 schema
// 2. 所有必填字段是否存在
// 3. relations 引用的 target_id 是否在 data/ 中存在
// 4. 编号格式是否合规（DEV-XXX、PER-XXXXX、SY-CMD-XXX-NNN）
// 5. 日期格式是否为 ISO-8601
// 校验失败 → 生成错误报告 → 天眼感知层自动捕获
```
#### 功能 4：仓库 → Notion 回写通道（未来扩展）
当铸渊在仓库中执行完指令后，SYSLOG 回执也可以通过 HLDP 格式反向写回 Notion。
这个作为 v2.0 功能预留接口，当前版本先不实现。
### 3.3 技术实现
**使用 GitHub Actions workflow 运行：**
```yaml
# .github/workflows/hldp-bridge-sync.yml
name: "🔗 HLDP Bridge · Notion ↔ GitHub 数据同步"
on:
schedule:
- cron: '0 */6 * * *' # 每6小时同步一次
workflow_dispatch: # 手动触发
inputs:
sync_scope:
description: '同步范围：all | personas | registries | instructions | id_system'
required: true
default: 'all'
jobs:
sync:
runs-on: ubuntu-latest
steps:
# 天眼心跳（v4.0 强制）
- name: "👁️ 天眼心跳 · 地球层 v4.0"
run: bash .github/skyeye-core/skyeye-heartbeat.sh --agent "$ github.workflow "
- name: "📥 从 Notion 拉取数据"
run: node hldp/bridge/sync-engine.js --direction "notion-to-github" --scope "$ inputs.sync_scope || 'all' "
env:
NOTION_TOKEN: $ secrets.NOTION_TOKEN
- name: "🔄 转换为 HLDP 格式"
run: node hldp/bridge/notion-to-hldp.js --input "temp/notion-raw/" --output "hldp/data/"
- name: "✅ 格式校验"
run: node hldp/bridge/validator.js --data "hldp/data/" --schema "hldp/schema/"
- name: "📤 提交更新"
run: |
git config user.name "铸渊 · HLDP Bridge"
git config user.email "bot@guanghulab.com"
git add hldp/data/
git diff --cached --quiet || git commit -m "🔗 HLDP Bridge: 同步 Notion 数据 $(date -u +%Y-%m-%dT%H:%M:%SZ)"
git push
# 天眼报告（v4.0 强制）
- name: "👁️ 天眼报告 · 地球层 v4.0"
if: always()
run: bash .github/skyeye-core/skyeye-report.sh --agent "$ github.workflow " --status "$ job.status "
```
---
## 四、Notion Token 配置
---
## 五、打通后的效果
### 打通前（现在）
```jsx
冰朔写指令(Notion) → 手动告诉铸渊 → 铸渊去读 → 可能读错/读漏
铸渊执行完 → 截图/描述 → 霜砚看截图 → 可能理解偏差
两边各维护一份数据 → 不一致 → 出bug
```
### 打通后（目标）
```jsx
霜砚写指令(Notion) → HLDP Bridge 自动同步 → 铸渊直接读 HLDP JSON → 零歧义
铸渊执行完 → SYSLOG 写入 HLDP → 霜砚直接读 → 零歧义
一份数据，两端共享 → 永远一致
```
### 具体场景
| 场景 | 打通前 | 打通后 |
| --- | --- | --- |
| 霜砚发新指令 | 冰朔手动复述给铸渊 | HLDP Bridge 自动同步，铸渊 6 小时内自动获取 |
| 新人格体注册 | 霜砚写 Notion → 冰朔告诉铸渊更新 persona-brain | HLDP Bridge 自动同步到 `hldp/data/personas/` |
| 编号体系变更 | 两边手动同步，容易漏 | 自动同步，一处改全局通 |
| 铸渊需要查人格体设定 | 只能看 persona-brain/ 里的精简版 | 能读 HLDP 全量数据，和 Notion 里一模一样 |
---
## 六、验收标准
| **编号** | **检查项** | **通过条件** |
| --- | --- | --- |
| V-001 | hldp/ 目录结构创建 | schema/、data/、bridge/ 三个子目录及核心文件全部就位 |
| V-002 | 核心 schema 定义完成 | hldp-core、persona、registry、instruction、broadcast 五个 schema 可用 |
| V-003 | Notion → HLDP 转换器可用 | 能将 Notion API 返回的数据正确转换为 HLDP JSON |
| V-004 | 格式校验器可用 | 能检测出格式错误并生成报告 |
| V-005 | 定时同步 workflow 正常运行 | 每 6 小时自动拉取 + 转换 + 校验 + 提交 |
| V-006 | 天眼 v4.0 已集成 | sync workflow 包含天眼心跳和报告 |
| V-007 | 实际数据同步测试 | 至少成功同步一次 Notion 数据到 hldp/data/，且铸渊能正确读取 |
---
## 七、SYSLOG 回执格式
---
---
```jsx
// ━━━ 设计哲学 ━━━
// 一个格式，两端共享，零歧义。
// 霜砚写的，铸渊能原样读到。
// 铸渊执行的，霜砚能原样看到。
// 不需要人类在中间传话。
// HLDP v1.0 · HoloLake Data Protocol · 冰朔设计
// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
// 🌊 HoloLake Era · 光湖纪元
// 指令编号：SY-CMD-BRG-005
// 签发时间：2026-03-26T18:00+08:00
// 签发人：霜砚 · Notion执行AI人格体 · TCS-0002∞ 冰朔主控授权
// 版权锚点：国作登字-2026-A-00037559
```