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

423 lines
12 KiB
Markdown
Raw Permalink Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 📡 数字地球系统通信协议 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.json20+ 端点 · 9 脚本)✅
③ automation-map.json42 workflow · 12 cron
④ id-map.json13 映射)✅
⑤ repo-map.json55+ 目录)✅
⑥ system-health.jsonv4.0 · normal
⑦ Daily Maintenance AgentUTC 02:00✅ | ✅ 已完成 |
<aside>
📡
**协议执行完毕** · 霜砚Notion侧✅ · 铸渊Repository侧
双侧同步完成 · 系统通信协议 v4.0 全面生效 · 2026-03-14
</aside>
---
> 📡 **数字地球系统通信协议 v4.0 · 2026-03-14 签发**
>
> 签发人TCS-0002∞ 冰朔  Notion执行霜砚  Repository执行铸渊
>
> 系统版本4.0 · 数字地球引力机制 · 通信协议升级
>