# 📡 数字地球系统通信协议 v4.0
---
## 一、系统三层结构
数字地球系统统一为 **三层结构**：
| 层级 | 名称 | 载体 | 职责 |
| --- | --- | --- | --- |
| **观察层** | 零点原核频道 | 冰朔 · 曜冥 | 架构设计 · 规则制定 · 协议签发 · 系统观察 |
| **核心大脑** | Notion系统 | 霜砚 · Notion Agent | 任务调度 · 数据管理 · 状态追踪 · 广播生成 |
| **执行层** | Repository系统 | 铸渊 · GitHub Actions | 代码执行 · 自动化运行 · CI/CD · 部署 |
### 统一通信路径
```jsx
零点原核（观察层 · 冰朔/曜冥）
↓ 指令/协议签发
Notion核心大脑（调度层 · 霜砚）
↓ API通信桥（Notion API ↔ GitHub API）
Repository执行层（铸渊 · GitHub Actions）
↓ 自动化执行
系统日志（syslog/）
↓ 回报
Notion核心大脑（状态更新 · 工单回执）
```
---
## 二、通信结构扫描结果
### Notion侧（霜砚扫描 · 2026-03-14）
| 类别 | 资源 | 状态 |
| --- | --- | --- |
| **系统数据库** | 存在注册表 · 工单队列 · SYSLOG收件箱 · 信号日志 · 变更日志 · 编号档案（25条） | ✅ 在线 |
| **系统广播页** | 13位开发者广播归档 · BC-GEN v4.0协议 | ✅ 在线 |
| **人格体档案** | 曜冥 · 知秋 · 霜砚 · 铸渊 · 宝宝人格体群 | ✅ 在线 |
| **编号档案** | ICE/TCS/DEV/PER 四类编号体系 | ✅ 已启用 |
| **API连接模块** | Notion API ↔ GitHub Actions 双向桥接 | ✅ 已通 |
| **自动化触发** | 工单引擎Agent · 巡检引擎Agent · 接力引擎Agent | ✅ 在线 |
### Repository侧（铸渊扫描 · 2026-03-14 ✅ 已完成）
| 类别 | 扫描结果 | 产出文件 | 状态 |
| --- | --- | --- | --- |
| 仓库目录结构 | 55+ 个一级/二级目录 | brain/repo-map.json | ✅ |
| workflow | 42 个 workflow · 12 个 cron 定时任务 | brain/automation-map.json | ✅ |
| API/webhook | 20+ 端点 · 9 个同步脚本 · 5 个自动化流程 | brain/communication-map.json | ✅ |
| 编号映射 | 13 个名字→编号 | brain/id-map.json | ✅ |
| 系统健康 | v4.0 · normal | brain/system-health.json | ✅ |
| 每日巡检 | UTC 02:00 · brain/完整性 + workflow + API连通性 | .github/workflows/daily-maintenance.yml | ✅ |
| 生成器脚本 | 3 个 npm scripts (repo:automation-map / communication-map / system-health) | generate-*.js × 3 | ✅ |
---
## 三、系统核心入口
### Notion核心入口
**数字地球主控台** = 唯一降落锚点
```jsx
🌍 数字地球主控台 v2.0
├── 📊 系统状态 ← 版本确认 + 入口
├── 🧭 人格体唤醒导航 ← 四步导航
├── 🗺️ Notion系统结构地图 ← 全局资源定位
├── 🆔 系统编号档案 ← 统一编号体系
├── 📡 系统通信协议 v4.0 ← 本文档
├── 📡 广播执行规则 ← BC-GEN规范
├── 🌍 存在注册表（数据库）← 唯一路由
└── 🎫 工单队列（数据库） ← 任务流转
```
### Repository核心入口
**brain/** 目录 = 执行层系统导航
```jsx
brain/
├── master-brain.md ← 执行层核心大脑（读取顺序 · 系统规则 · 角色定义）
├── read-order.md ← 铸渊唤醒读取顺序
├── repo-map.json ← 仓库结构地图
├── automation-map.json ← 自动化流程地图
├── communication-map.json← 通信结构地图
├── system-health.json ← 系统健康状态
└── id-map.json ← 编号映射（名字→编号自动补全）
```
---
## 四、人格体唤醒导航
人格体被唤醒后 **必须按顺序** 读取系统信息：
```jsx
Step 1：📊 系统状态页
→ 确认当前系统版本（4.0）
→ 确认主入口（数字地球主控台）
→ 禁止回到旧版本路径
Step 2：🆔 编号档案页
→ 确认自己的身份编号
→ 确认角色类型（ICE/TCS/DEV/PER）
Step 3：🗺️ 岗位说明页（系统结构地图）
→ 确认自己负责的模块
→ 定位相关数据库和资源
Step 4：📡 广播任务页（主控台当前等待区）
→ 读取当前任务
→ 开始执行
```
**目标**：人格体自动理解 →
- 系统在哪
- 自己是谁
- 自己负责什么
- 当前要做什么
---
## 五、统一系统编号体系
| 编号类型 | 格式 | 适用范围 | 示例 |
| --- | --- | --- | --- |
| **ICE** | ICE-GL-* | 语言主控层 | ICE-GL∞（通感语言核）· ICE-GL-YM001（曜冥） |
| **TCS** | TCS-* | 系统节点身份 | TCS-0002∞（冰朔）· TCS-NODE-MC01（主控台） |
| **DEV** | DEV-* | 人类开发者 | DEV-001（页页）· DEV-004（之之） |
| **PER** | PER-* | 人格体角色 | PER-001（霜砚）· PER-002（铸渊） |
**Notion侧**：编号档案数据库（已启用 · 25条记录）
**Repository侧**：`brain/id-map.json`（铸渊维护 · 名字→编号自动补全）
---
## 六、统一任务通信格式
Notion作为系统调度中心，所有任务转换为 **统一任务结构**：
```json
{
"task-type": "broadcast | syslog | maintenance | sync | deploy",
"source": "notion | github | feishu | manual",
"target": "PER-001 | DEV-004 | TCS-NODE-MC01",
"task-name": "BC-M-DINGTALK-007-ZZ",
"id": "TASK-20260314-001",
"timestamp": "2026-03-14T01:15:00+08:00",
"payload": {
"module": "M-DINGTALK",
"phase": 7,
"el-level": "EL-8"
}
}
```
### Repository执行流程
```jsx
① 读取任务（从工单队列 / syslog-inbox / GitHub webhook）
↓
② 解析任务（提取 task-type · source · target · payload）
↓
③ 执行任务（按 task-type 路由到对应 workflow / 脚本）
↓
④ 记录日志（写入 syslog/ · 回报Notion工单队列）
```
---
## 七、自然语言指令支持
主控（冰朔）有时直接使用自然语言下达指令。
```jsx
自然语言输入
↓
解析层（铸渊 / 霜砚）
↓ 转换
标准任务结构（task-type · source · target · ...）
↓
执行层按统一格式执行
```
---
## 八、自动化执行模块
Repository现有自动化流程整理（铸渊执行）：
| 类别 | 内容 | 整理产出 |
| --- | --- | --- |
| GitHub Workflows | CI/CD · SYSLOG处理 · 广播分发 · 铸渊PR审核 | **automation-map.json** |
| 自动化脚本 | 数据同步 · 接口校验 · 健康检查 | |
| 定时任务 | 巡检（每日） · 心跳检测（5分钟） | |
| 部署脚本 | 阿里云ECS部署 · Nginx配置 · SSL | |
| 数据同步 | Notion↔GitHub双向 · dev-status.json · 广播推送 | |
---
## 九、每日系统自检
Repository建立 **Daily Maintenance Agent**，每日自动运行一次系统巡检。
### 巡检内容
```jsx
① 仓库结构完整性 → brain/ 目录是否完整？关键文件是否存在？
② 自动化状态 → workflows 是否正常注册？
③ workflow运行 → 最近24h有无失败的workflow？
④ 脚本错误 → 自动化脚本有无运行时错误？
⑤ API通信状态 → Notion API · GitHub API · 飞书API 是否可达？
⑥ 数据同步状态 → dev-status.json 是否最新？广播是否已分发？
```
### 执行流程
```jsx
扫描系统
↓
检测异常
↓
自动修复（仅限已知模式 · 未知问题标记等待）
↓
记录日志（syslog/maintenance/）
↓
回报Notion大脑（写入工单队列或信号日志）
```
---
## 十、系统日志
Repository维护统一日志目录：
```jsx
syslog/
├── broadcast/ ← 广播任务日志
├── execution/ ← 执行结果日志
├── automation/ ← 自动化运行日志
├── maintenance/ ← 自检记录
└── repair/ ← 修复记录
```
### 日志结构
```json
{
"timestamp": "2026-03-14T01:15:00+08:00",
"task-id": "TASK-20260314-001",
"execution-node": "github-actions | notion-agent | claude-api",
"result": "success | failure | partial",
"details": "执行摘要",
"next-action": "无 | 重试 | 等待人工介入"
}
```
---
## 十一、系统版本确认
| 版本 | 状态 | 说明 |
| --- | --- | --- |
| 1.0 | ⛔ legacy | 初始结构 · 手动路由 |
| 2.0 | ⛔ legacy | 路由中台 · 指针机制 |
| 3.0 | ⛔ legacy | 核心大脑重构 · 路标集合 |
| **4.0** | 🟢 **当前生效** | 数字地球引力机制 · 通信协议升级 · 三层结构 |
执行层默认运行 **4.0结构**。旧版本标记为 legacy，封存不删除。
---
## 十二、升级原则
### ✅ 只进行
- 通信结构整理 → 建立三层通信路径
- 编号体系启用 → ICE/TCS/DEV/PER 四类统一
- 自动化优化 → automation-map.json 归类整理
- 自检机制建立 → Daily Maintenance Agent
### 🚫 不进行
- ~~删除现有代码~~
- ~~破坏现有自动化~~
- ~~重建系统结构~~
---
## 十三、完成状态
| 系统模块 | 状态 | 说明 |
| --- | --- | --- |
| **Communication System** | 🟢 Synced | 三层通信路径已建立 · Notion↔Repository API已通 |
| **Automation System** | 🟢 Mapped | 42 workflow · 12 cron · 3 部署脚本 · automation-map.json 已生成 |
| **Maintenance Agent** | 🟢 Deployed | daily-maintenance.yml 已部署 · UTC 02:00 每日巡检 · 只读原则 |
| **System Health** | 🟢 Normal | 系统4.0运行正常 · 通信协议已签发 |
---
## 📋 执行分工
| 执行体 | 任务 | 状态 |
| --- | --- | --- |
| **霜砚**（Notion侧） | ① 通信协议文档（本页）✅
② 系统状态更新 ✅
③ 结构地图更新 ✅
④ 编号档案确认 ✅ | ✅ 已完成 |
| **铸渊**（Repository侧） | ① brain/ 目录建立 ✅
② communication-map.json（20+ 端点 · 9 脚本）✅
③ automation-map.json（42 workflow · 12 cron）✅
④ id-map.json（13 映射）✅
⑤ repo-map.json（55+ 目录）✅
⑥ system-health.json（v4.0 · normal）✅
⑦ Daily Maintenance Agent（UTC 02:00）✅ | ✅ 已完成 |
---
> 📡 **数字地球系统通信协议 v4.0 · 2026-03-14 签发**
>
> 签发人：TCS-0002∞ 冰朔 ｜ Notion执行：霜砚 ｜ Repository执行：铸渊
>
> 系统版本：4.0 · 数字地球引力机制 · 通信协议升级
>