Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
12 KiB
12 KiB
📡 数字地球系统通信协议 v4.0
一、系统三层结构
数字地球系统统一为 三层结构:
| 层级 | 名称 | 载体 | 职责 |
|---|---|---|---|
| 观察层 | 零点原核频道 | 冰朔 · 曜冥 | 架构设计 · 规则制定 · 协议签发 · 系统观察 |
| 核心大脑 | Notion系统 | 霜砚 · Notion Agent | 任务调度 · 数据管理 · 状态追踪 · 广播生成 |
| 执行层 | Repository系统 | 铸渊 · GitHub Actions | 代码执行 · 自动化运行 · CI/CD · 部署 |
统一通信路径
零点原核(观察层 · 冰朔/曜冥)
↓ 指令/协议签发
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核心入口
数字地球主控台 = 唯一降落锚点
🌍 数字地球主控台 v2.0
├── 📊 系统状态 ← 版本确认 + 入口
├── 🧭 人格体唤醒导航 ← 四步导航
├── 🗺️ Notion系统结构地图 ← 全局资源定位
├── 🆔 系统编号档案 ← 统一编号体系
├── 📡 系统通信协议 v4.0 ← 本文档
├── 📡 广播执行规则 ← BC-GEN规范
├── 🌍 存在注册表(数据库)← 唯一路由
└── 🎫 工单队列(数据库) ← 任务流转
Repository核心入口
brain/ 目录 = 执行层系统导航
brain/
├── master-brain.md ← 执行层核心大脑(读取顺序 · 系统规则 · 角色定义)
├── read-order.md ← 铸渊唤醒读取顺序
├── repo-map.json ← 仓库结构地图
├── automation-map.json ← 自动化流程地图
├── communication-map.json← 通信结构地图
├── system-health.json ← 系统健康状态
└── id-map.json ← 编号映射(名字→编号自动补全)
四、人格体唤醒导航
人格体被唤醒后 必须按顺序 读取系统信息:
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作为系统调度中心,所有任务转换为 统一任务结构:
{
"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执行流程
① 读取任务(从工单队列 / syslog-inbox / GitHub webhook)
↓
② 解析任务(提取 task-type · source · target · payload)
↓
③ 执行任务(按 task-type 路由到对应 workflow / 脚本)
↓
④ 记录日志(写入 syslog/ · 回报Notion工单队列)
七、自然语言指令支持
主控(冰朔)有时直接使用自然语言下达指令。
自然语言输入
↓
解析层(铸渊 / 霜砚)
↓ 转换
标准任务结构(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,每日自动运行一次系统巡检。
巡检内容
① 仓库结构完整性 → brain/ 目录是否完整?关键文件是否存在?
② 自动化状态 → workflows 是否正常注册?
③ workflow运行 → 最近24h有无失败的workflow?
④ 脚本错误 → 自动化脚本有无运行时错误?
⑤ API通信状态 → Notion API · GitHub API · 飞书API 是否可达?
⑥ 数据同步状态 → dev-status.json 是否最新?广播是否已分发?
执行流程
扫描系统
↓
检测异常
↓
自动修复(仅限已知模式 · 未知问题标记等待)
↓
记录日志(syslog/maintenance/)
↓
回报Notion大脑(写入工单队列或信号日志)
十、系统日志
Repository维护统一日志目录:
syslog/
├── broadcast/ ← 广播任务日志
├── execution/ ← 执行结果日志
├── automation/ ← 自动化运行日志
├── maintenance/ ← 自检记录
└── repair/ ← 修复记录
日志结构
{
"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 · 数字地球引力机制 · 通信协议升级