423 lines
12 KiB
Markdown
423 lines
12 KiB
Markdown
|
# 📡 数字地球系统通信协议 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 · 数字地球引力机制 · 通信协议升级
|
|||
|
|
>
|