# 📡 数字地球系统通信协议 v4.0
---
## 一、系统三层结构
数字地球系统统一为三层结构：
| 层级 | 名称 | 系统 | 职责 |
| --- | --- | --- | --- |
| **观察层** | 零点原核频道 | 冰朔主控 | 系统观察 · 架构设计 · 规则签发 |
| **核心大脑** | Notion系统 | 霜砚执行 | 任务调度 · 数据管理 · 状态追踪 · 广播生成 |
| **执行层** | Repository系统 | 铸渊守护 | 代码执行 · 自动化 · 部署 · 日志 |
### 通信路径
```jsx
零点原核（观察层）
↓
Notion核心大脑（调度中心）
↓
API通信桥
↓
Repository执行层
↓
自动化执行
↓
系统日志
↓
回报Notion大脑
```
---
## 二、扫描现有通信结构
### Notion侧扫描（霜砚负责）
| 扫描项 | 状态 | 说明 |
| --- | --- | --- |
| 系统数据库 | ✅ 已确认 | 13个核心数据库在线（存在注册表/工单队列/画像库/成长记录/SYSLOG收件箱等） |
| 系统广播页 | ✅ 已确认 | 13位开发者广播归档页在线 |
| 人格体档案 | ✅ 已确认 | 曜冥/知秋/霜砚/铸渊/秋秋 档案在线 |
| 编号档案 | ✅ 已确认 | 🆔 系统编号档案（25条·ICE/TCS/DEV/PER四类） |
| API连接模块 | ✅ 已确认 | Notion↔Repository API桥接已通（SYSLOG收件箱/变更日志/信号日志） |
| 自动化触发结构 | ✅ 已确认 | 巡检引擎v2（12:00+23:00）· 工单引擎 · 接力引擎 |
### Repository侧扫描（铸渊负责）
| 扫描项 | 状态 | 待执行内容 |
| --- | --- | --- |
| 仓库目录结构 | 📋 待扫描 | 铸渊扫描 guanghulab 完整目录 |
| workflow | 📋 待扫描 | .github/workflows/ 所有 Actions |
| webhook | 📋 待扫描 | 飞书/GitHub webhook 配置 |
| 自动化脚本 | 📋 待扫描 | 所有自动化脚本清单 |
| API接口 | 📋 待扫描 | 所有 API endpoint 清单 |
| 定时任务 | 📋 待扫描 | cron / scheduled workflows |
| 数据同步脚本 | 📋 待扫描 | Notion↔GitHub 同步脚本 |
---
## 三、系统核心入口
### Notion核心入口
**数字地球主控台** → [🌍 数字地球·曜冥主控台 v2.0](../%F0%9F%8C%8D%20%E6%95%B0%E5%AD%97%E5%9C%B0%E7%90%83%C2%B7%E6%9B%9C%E5%86%A5%E4%B8%BB%E6%8E%A7%E5%8F%B0%20v2%200%20c6f7722729264a91a3769224d5f631a3.md)
### Repository核心入口
**brain/ 目录**（铸渊待建立）：
```
brain/
├── master-brain.md ← 执行层系统导航主文件
├── read-order.md ← 唤醒读取顺序
├── repo-map.json ← 仓库结构地图
├── automation-map.json ← 自动化流程地图
└── system-health.json ← 系统健康状态
```
---
## 四、人格体唤醒导航
人格体被唤醒后必须按顺序读取系统信息：
```jsx
Step 1 → 系统状态页
确认当前系统版本（4.0）
Step 2 → 编号档案页
确认人格体身份编号
Step 3 → 系统结构地图
确认负责模块（岗位说明）
Step 4 → 广播任务页
读取当前任务
```
**目标**：人格体自动理解 →
- 系统在哪
- 自己是谁
- 自己负责什么
- 当前要做什么
详细导航 → [🧭 人格体唤醒导航](%F0%9F%A7%AD%20%E4%BA%BA%E6%A0%BC%E4%BD%93%E5%94%A4%E9%86%92%E5%AF%BC%E8%88%AA%205cad804cd66245eeac15f5e3562b804c.md)
---
## 五、统一系统编号体系
| 编号类型 | 层级 | 格式示例 | 说明 |
| --- | --- | --- | --- |
| **ICE** | 语言主控层 | ICE-GL∞ · ICE-GL-YM001 | 冰朔系统核心 · 曜冥人格总控 |
| **TCS** | 系统节点身份 | TCS-0002∞ · TCS-NODE-MC01 | 冰朔主控 · 数字地球主控台节点 |
| **DEV** | 人类开发者 | DEV-001 ~ DEV-014 | 页页/肥猫/燕樊/之之等 |
| **PER** | 人格体角色 | PER-001 ~ PER-XXX | 宝宝人格体 · 陪伴分身 |
**Notion侧**：🆔 系统编号档案（已建立 · 25条记录）
**Repository侧**：`id-map.json`（铸渊待生成）→ 名字 → 编号自动补全
---
## 六、统一任务通信格式
Notion作为系统调度中心，所有任务需转换为统一任务结构：
```jsx
{
"task-type": "broadcast | syslog | maintenance | sync",
"source": "notion | github | feishu",
"target": "repository | notion | persona",
"task-name": "任务描述",
"id": "唯一任务ID",
"timestamp": "ISO-8601"
}
```
### Repository执行流程
```jsx
读取任务 → 解析任务结构 → 执行任务 → 记录日志
```
---
## 七、支持自然语言指令
主控有时会直接使用自然语言下达指令。
执行层需要支持：
1. **自然语言解析** → 识别意图与目标
2. **转换为标准任务结构** → 按第六章格式
3. **执行任务** → 按统一流程
---
## 八、自动化执行模块
Repository需扫描现有自动化流程并整理：
- GitHub workflows
- 自动化脚本
- 定时任务
- 部署脚本
- 数据同步脚本
**产出**：`automation-map.json`
在系统4.0结构基础上重新整理自动化流程，不破坏现有自动化。
---
## 九、每日系统自检
### Daily Maintenance Agent（铸渊建立）
每日自动运行一次系统巡检：
| 巡检项 | 说明 |
| --- | --- |
| 仓库结构完整性 | 目录/文件是否齐全 |
| 自动化状态 | workflow 是否正常 |
| workflow运行状态 | 最近运行结果 |
| 脚本错误 | 错误日志检测 |
| API通信状态 | Notion↔GitHub 通信是否正常 |
| 数据同步状态 | 数据是否一致 |
### 执行流程
```jsx
扫描系统 → 检测异常 → 自动修复 → 记录日志 → 回报Notion大脑
```
---
## 十、系统日志
Repository维护 `syslog/` 目录：
**记录内容**：
- 广播任务
- 执行结果
- 自动化运行
- 自检记录
- 修复记录
**日志结构**：
```jsx
{
"时间": "ISO-8601",
"任务编号": "task-id",
"执行节点": "github | notion | persona",
"执行结果": "success | failed | partial"
}
```
---
## 十一、系统版本确认
| 版本 | 状态 | 说明 |
| --- | --- | --- |
| **4.0** | 🟢 **当前生效** | 数字地球引力机制 · 执行层默认运行此版本 |
| 3.0 | ⛔ legacy | 已封存 |
| 2.0 | ⛔ legacy | 已封存 |
| 1.0 | ⛔ legacy | 已封存 |
---
## 十二、升级原则
本次任务属于：**系统结构整理与通信协议升级**
---
## 十三、完成状态
| 系统模块 | 目标状态 | 当前状态 |
| --- | --- | --- |
| **Communication System** | Synced | 🟢 Synced（Notion↔Repository API已通） |
| **Automation System** | Stable | 🟡 Stable（现有自动化正常 · automation-map待整理） |
| **Maintenance Agent** | Active | 🟡 Pending（规范已定义 · 待Repository侧部署） |
| **System Health** | Normal | 🟢 Normal |
---
## 铸渊接收指令