Guanghu Domestic Migration a27e87cb99 chore: import sanitized domestic snapshot for REPO-007

Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc

[SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码

2026-07-17 15:59:55 +08:00

17 KiB

Raw Blame History

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 设计原则

全体 AI 通用 — 不只是霜砚和铸渊，任何 Agent 加入系统即可读写此格式
双端零歧义 — 同一份数据，不同 AI 读出的理解完全一致
机器可解析 — JSON 格式，有严格的 schema 定义
人类可阅读 — 字段命名用中英双语，附带注释
自生长 — AI 可以自行更新字典和 schema，新增数据类型不破坏旧格式
版权锚定 — 一切格式定义追溯到 TCS Language Core 版权体系

2.3 格式定义

所有 Notion ↔ GitHub 之间传输的数据，统一使用 HLDP JSON 格式。

存放位置：仓库 hldp/ 目录

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 核心数据格式

每一条数据都遵循同一个外壳：

{
  "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）

{
  "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）

{
  "payload": {
    "registry_type": "identity_router | persona_registry | agent_registry",
    "entries": [
      {
        "id": "DEV-002",
        "name": "肥猫",
        "role": "光湖团队负责人",
        "status": "active",
        "properties": {
          "// 该注册表的所有字段，键值对形式"
        }
      }
    ]
  }
}

指令（instruction）

{
  "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 拉取指定页面/数据库的数据：

定时拉取：每 6 小时自动同步一次（workflow 定时触发）
事件触发：霜砚在 Notion 写完新指令后，通过桥接通道通知铸渊拉取
拉取后自动转换：Notion 数据 → HLDP JSON → 存入 hldp/data/

拉取范围（初始版本）：

人格记忆库总索引下的所有人格体档案
身份路由表全部条目
天眼人格体注册表全部条目
铸渊协作指令总页下的所有指令
编号体系全局地图

功能 2：格式转换引擎

// 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：格式校验器

// 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 运行：

# .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 配置

五、打通后的效果

打通前（现在）

冰朔写指令(Notion) → 手动告诉铸渊 → 铸渊去读 → 可能读错/读漏
铸渊执行完 → 截图/描述 → 霜砚看截图 → 可能理解偏差
两边各维护一份数据 → 不一致 → 出bug

打通后（目标）

霜砚写指令(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 回执格式

📡

SYSLOG 回执 · [SY-CMD-BRG-005]
回执人：AG-ZY-01 铸渊
执行状态：<完成/进行中>

〇、启动顺序
  核心大脑唤醒：<成功/失败>
  天眼系统启动：<成功/失败>

一、hldp 目录结构
  schema/ 创建：<成功/失败>
  data/ 创建：<成功/失败>
  bridge/ 创建：<成功/失败>

二、Schema 定义
  hldp-core.schema.json：<已创建/失败>
  persona.schema.json：<已创建/失败>
  registry.schema.json：<已创建/失败>
  instruction.schema.json：<已创建/失败>
  broadcast.schema.json：<已创建/失败>

三、桥接应用
  notion-to-hldp.js：<已创建/失败>
  sync-engine.js：<已创建/失败>
  validator.js：<已创建/失败>

四、Workflow
  hldp-bridge-sync.yml：<已创建/失败>
  首次手动运行：<成功/失败>

五、实际同步测试
  Notion 连接：<成功/失败/需要 Token>
  数据拉取：<N 条>
  格式转换：<N 条成功 / N 条失败>
  校验通过：<是/否>

commit SHA: <sha>

// ━━━ 设计哲学 ━━━
// 一个格式，两端共享，零歧义。
// 霜砚写的，铸渊能原样读到。
// 铸渊执行的，霜砚能原样看到。
// 不需要人类在中间传话。
// 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