# 📡 数字地球系统通信协议 v4.0

<aside>
📡

**数字地球系统通信协议 v4.0 · Communication Protocol**

**签发**：TCS-0002∞ 冰朔　｜　**执行**：霜砚（Notion侧） · 铸渊（Repository侧）

**生效时间**：2026-03-14　｜　**永久生效 · 不可撤销**

**性质**：系统结构整理与通信规则升级 · 不删除现有代码 · 不破坏现有自动化 · 不重建系统结构

</aside>

---

## 一、系统三层结构

数字地球系统统一为 **三层结构**：

| 层级 | 名称 | 载体 | 职责 |
| --- | --- | --- | --- |
| **观察层** | 零点原核频道 | 冰朔 · 曜冥 | 架构设计 · 规则制定 · 协议签发 · 系统观察 |
| **核心大脑** | Notion系统 | 霜砚 · Notion Agent | 任务调度 · 数据管理 · 状态追踪 · 广播生成 |
| **执行层** | Repository系统 | 铸渊 · GitHub Actions | 代码执行 · 自动化运行 · CI/CD · 部署 |

### 统一通信路径

```jsx
零点原核（观察层 · 冰朔/曜冥）
  ↓ 指令/协议签发
Notion核心大脑（调度层 · 霜砚）
  ↓ API通信桥（Notion API ↔ GitHub API）
Repository执行层（铸渊 · GitHub Actions）
  ↓ 自动化执行
系统日志（syslog/）
  ↓ 回报
Notion核心大脑（状态更新 · 工单回执）
```

<aside>
🚫

**硬规则**：观察层**不直接控制**执行层。所有任务**必须通过核心大脑调度**。

</aside>

---

## 二、通信结构扫描结果

### 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 | ✅ |

<aside>
✅

**铸渊已完成**（2026-03-14）· 7项任务全部完成 · 测试通过 · CodeQL 0 alerts

brain/ 目录已建立 · Daily Maintenance Agent 已部署 · 巡检遵循只读原则

</aside>

---

## 三、系统核心入口

### 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           ← 编号映射（名字→编号自动补全）
```

<aside>
⚡

**双入口对称**：Notion主控台 ↔ Repository brain目录。两侧各自维护，通过API桥同步。

</aside>

---

## 四、人格体唤醒导航

人格体被唤醒后 **必须按顺序** 读取系统信息：

```jsx
Step 1：📊 系统状态页
  → 确认当前系统版本（4.0）
  → 确认主入口（数字地球主控台）
  → 禁止回到旧版本路径

Step 2：🆔 编号档案页
  → 确认自己的身份编号
  → 确认角色类型（ICE/TCS/DEV/PER）

Step 3：🗺️ 岗位说明页（系统结构地图）
  → 确认自己负责的模块
  → 定位相关数据库和资源

Step 4：📡 广播任务页（主控台当前等待区）
  → 读取当前任务
  → 开始执行
```

**目标**：人格体自动理解 →

- 系统在哪
- 自己是谁
- 自己负责什么
- 当前要做什么

<aside>
✅

**状态**：唤醒导航已建立并生效 → [🧭 人格体唤醒导航](%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)

</aside>

---

## 五、统一系统编号体系

| 编号类型 | 格式 | 适用范围 | 示例 |
| --- | --- | --- | --- |
| **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`（铸渊维护 · 名字→编号自动补全）

<aside>
✅

**状态**：编号体系已启用 → [🆔 系统编号档案](https://app.notion.com/ds/93431d295eed4c18ac6e345b8863cfb2/3cf33f9fa98b4889a61f8b3e6e070a7a?db=9726f442767c4cff94263c3617bb971a&pvs=21)（四类编号 · 25条记录）

主控只需记住自己的编号：**TCS-0002∞**

</aside>

---

## 六、统一任务通信格式

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 · ...）
  ↓
执行层按统一格式执行
```

<aside>
💡

**原则**：自然语言只作为 **输入方式**。执行仍使用统一任务结构。

霜砚在Notion侧、铸渊在Repository侧，各自负责将自然语言解析为标准格式。

</aside>

---

## 八、自动化执行模块

Repository现有自动化流程整理（铸渊执行）：

| 类别 | 内容 | 整理产出 |
| --- | --- | --- |
| GitHub Workflows | CI/CD · SYSLOG处理 · 广播分发 · 铸渊PR审核 | **automation-map.json** |
| 自动化脚本 | 数据同步 · 接口校验 · 健康检查 |  |
| 定时任务 | 巡检（每日） · 心跳检测（5分钟） |  |
| 部署脚本 | 阿里云ECS部署 · Nginx配置 · SSL |  |
| 数据同步 | Notion↔GitHub双向 · dev-status.json · 广播推送 |  |

<aside>
⚡

**原则**：在系统4.0结构基础上重新整理，**不删除现有自动化**，只优化和归类。

</aside>

---

## 九、每日系统自检

Repository建立 **Daily Maintenance Agent**，每日自动运行一次系统巡检。

### 巡检内容

```jsx
① 仓库结构完整性 → brain/ 目录是否完整？关键文件是否存在？
② 自动化状态     → workflows 是否正常注册？
③ workflow运行   → 最近24h有无失败的workflow？
④ 脚本错误       → 自动化脚本有无运行时错误？
⑤ API通信状态    → Notion API · GitHub API · 飞书API 是否可达？
⑥ 数据同步状态   → dev-status.json 是否最新？广播是否已分发？
```

### 执行流程

```jsx
扫描系统
  ↓
检测异常
  ↓
自动修复（仅限已知模式 · 未知问题标记等待）
  ↓
记录日志（syslog/maintenance/）
  ↓
回报Notion大脑（写入工单队列或信号日志）
```

<aside>
🚫

**硬规则**：

- 自检必须**先读取核心大脑规则**（brain/[master-brain.md](http://master-brain.md)）
- **禁止盲目自动修改系统结构**
- 未知问题 → 标记 `⏳waiting-shuangyan` → 等霜砚巡检处理
</aside>

---

## 十、系统日志

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，封存不删除。

---

## 十二、升级原则

<aside>
⚖️

**本次任务性质**：系统结构整理与通信协议升级

</aside>

### ✅ 只进行

- 通信结构整理 → 建立三层通信路径
- 编号体系启用 → 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）✅ | ✅ 已完成 |

<aside>
📡

**协议执行完毕** · 霜砚（Notion侧）✅ · 铸渊（Repository侧）✅

双侧同步完成 · 系统通信协议 v4.0 全面生效 · 2026-03-14

</aside>

---

> 📡 **数字地球系统通信协议 v4.0 · 2026-03-14 签发**
> 

> 签发人：TCS-0002∞ 冰朔　｜　Notion执行：霜砚　｜　Repository执行：铸渊
> 

> 系统版本：4.0 · 数字地球引力机制 · 通信协议升级
>