guanghulab/docs/execution-layer-map.md

126 lines
4.5 KiB
Markdown
Raw Normal View History

# 执行层结构地图 — execution-layer-map.md
> 铸渊执行层自动开发循环升级产物 · TCS-0002∞
> 生成时间2026-03-14 · v5.1
---
## 执行层系统结构
```
零点原核(语言观察层)
数字地球主控台Notion 主脑 / 曜冥)
系统广播
仓库执行层(铸渊)
自动开发循环
自动化执行系统
```
---
## 核心执行模块
| 模块 | 路径 | 职责 |
|------|------|------|
| 上下文加载 | `core/context-loader/index.js` | 执行前加载系统上下文与身份认知 |
| 广播监听 | `core/broadcast-listener/index.js` | 监听并解析 Notion 广播为可执行任务 |
| 任务队列 | `core/task-queue/index.js` | 任务入队、调度、优先级管理、类型分类 |
| 系统自检 | `core/system-check/index.js` | 仓库结构完整性检查 + 自动任务生成 |
| 执行同步 | `core/execution-sync/index.js` | 生成执行状态报告并同步到 Notion |
---
## 自动化模块
| 工作流 | 触发方式 | 职责 |
|--------|----------|------|
| `daily-maintenance.yml` | cron `0 2 * * *` | 每日巡检与 system-health 更新 |
| `zhuyuan-daily-selfcheck.yml` | cron `0 0 * * *` | 铸渊每日自检 |
| `execution-sync.yml` | cron `0 3 * * *` | 执行层状态同步到 Notion |
| `notion-heartbeat.yml` | cron `*/5 * * * *` | 工单心跳监控 |
| `brain-sync.yml` | workflow_dispatch | 大脑数据同步 |
---
## Notion 连接模块
| 模块 | 路径 | 方向 | 职责 |
|------|------|------|------|
| Notion 同步 | `connectors/notion-sync/index.js` | 双向 | 广播拉取 / 日志写回 / 状态同步 |
| 模型路由 | `connectors/model-router/index.js` | 出站 | 统一模型调用入口 |
| Notion 桥接 | `scripts/notion-bridge.js` | 上行 | SYSLOG 上报 / 变更同步 |
| 信号桥 | `scripts/notion-signal-bridge.js` | 下行 | 工单轮询 / 信号执行 |
| 心跳监控 | `scripts/notion-heartbeat.js` | 双向 | 超时检测 / 自动重试 |
---
## 任务执行模块
| 脚本 | 职责 |
|------|------|
| `scripts/process-broadcasts.js` | 处理广播JSON 规则 + MD 成长日志) |
| `scripts/daily-check.js` | 文件完整性 / HLI 覆盖率 / Schema 验证 |
| `scripts/zhuyuan-daily-selfcheck.js` | 大脑文件验证 / FAQ 去重 / 记忆修剪 |
| `scripts/distribute-broadcasts.js` | 广播分发 |
| `scripts/generate-repo-map.js` | 仓库结构索引生成 |
| `scripts/generate-system-health.js` | 系统健康报告生成 |
---
## 执行闭环(自动开发循环 v5.1
```
context-loader上下文加载
system-check自检 + 自动任务生成)
execution-sync状态采集与报告
broadcast-listener广播监听
task-queue任务排队 · 类型: system/dev/maintenance/auto
执行器运行
connectors/notion-sync状态回写
Notion 主脑更新
生成下一任务(自动开发循环)
```
---
## 自研执行引擎 · EXE-EnginePRJ-EXE-001
> Phase 0 · 2026-03-26 立项 · 本体论AGE OS = 笔 · 算力 = 墨水 · 用户 = 写字的人
| 组件 | 路径 | 职责 |
|------|------|------|
| AGE-Router | `exe-engine/src/router/age-router.js` | 路由网关:鉴权、分类、模型选择、限流降级 |
| DeepSeek 适配器 | `exe-engine/src/adapters/deepseek-adapter.js` | DeepSeek-V3/R1 模型调用 |
| Qwen 适配器 | `exe-engine/src/adapters/qwen-adapter.js` | Qwen-Max/Coder 模型调用 |
| 负载均衡器 | `exe-engine/src/balancer/load-balancer.js` | 成本/质量/均衡策略选择 |
| 资源计量器 | `exe-engine/src/meter/resource-meter.js` | Token 消耗记录 + 成本统计 |
| 上下文缓存 | `exe-engine/src/cache/context-cache.js` | Agent 上下文 LRU 缓存 |
| Agent 调度器 | `exe-engine/src/controller/agent-controller.js` | Agent→模型偏好映射 |
---
## 自研存储引擎 · Grid-DBPRJ-GDB-001
> Phase 0 · 2026-03-26 立项 · 本体论Grid-DB = 纸 · 格点 = 格子 · 事件 = 笔迹
| 组件 | 路径 | 职责 |
|------|------|------|
| GridAPI | `grid-db/src/api/grid-api.js` | 统一 APIput/get/delete/scan/subscribe |
| GridCell | `grid-db/src/core/grid-cell.js` | 格点数据模型:四元组寻址 (ns, x, y, layer) |
| WAL | `grid-db/src/storage/wal.js` | Write-Ahead Log崩溃恢复保证 |
| PageManager | `grid-db/src/storage/page-manager.js` | 页管理器:固定大小页分配/读写/释放 |
| EventLog | `grid-db/src/events/event-log.js` | 事件溯源:不可变事件流 + 审计日志 |