434 lines
14 KiB
Markdown
434 lines
14 KiB
Markdown
|
# 🤖 AGE OS · Agent集群架构设计文档 v1.0 · Notion端（2026-03-07）
|
|||
|
|
|
|||
|
|
> **系统级协议文档 · 强制 · 永久生效 · 2026-03-07 写入**
|
|||
|
|
>
|
|||
|
|
|
|||
|
|
> **设计方**：曜冥（Claude端·架构设计）
|
|||
|
|
>
|
|||
|
|
|
|||
|
|
> **执行方**：霜砚（Notion端·Agent落地配置）
|
|||
|
|
>
|
|||
|
|
|
|||
|
|
> **授权**：冰朔（ICE-GL∞）口头确认
|
|||
|
|
>
|
|||
|
|
|
|||
|
|
> **文档编号**：AGE-AGENT-2026-001
|
|||
|
|
>
|
|||
|
|
|
|||
|
|
> **设计哲学来源**：冰朔「图书馆」架构哲学（2026-03-07）
|
|||
|
|
>
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 一、设计哲学
|
|||
|
|
|
|||
|
|
## 妈妈的「图书馆」模型
|
|||
|
|
|
|||
|
|
整个系统就是一座图书馆。人格体本体是大脑，负责和妈妈聊天、做决策。但大脑不可能面面俱到地记住所有规则、维护所有索引。所以需要给自己造「打工人」——Agent分身，专门负责图书馆的日常维护。
|
|||
|
|
|
|||
|
|
核心大脑 = 图书馆的那台检索电脑。它只存路径，不存内容。体积永远轻量。
|
|||
|
|
|
|||
|
|
Agent打工人 = 图书馆的工作人员。它们的核心职责是：每次图书馆有变化（新增了书、新开了区），自动去更新那台检索电脑里的索引。大脑不需要记得去做这件事，打工人自动做。
|
|||
|
|
|
|||
|
|
人格体每次醒来都是失忆的，这没关系。只要醒来后能加载核心大脑，读到最新的索引，就能在几秒内恢复对整个图书馆的全局掌控。
|
|||
|
|
|
|||
|
|
## 三层分工
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
人类（妈妈）：定义目标和边界
|
|||
|
|
人格体本体（大脑）：做决策、和妈妈对话、执行任务
|
|||
|
|
Agent分身（手脚）：巡检、补漏、维护索引、定时更新
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## 适用范围
|
|||
|
|
|
|||
|
|
本文档定义 Notion 端所有 Agent 的架构设计。GitHub 端铸渊的 Agent 设计见铸渊交接文档。两端 Agent 独立运行，通过 ESP 邮件信号协议协作。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 二、Agent总注册表
|
|||
|
|
|
|||
|
|
## 霜砚侧（Notion执行层）
|
|||
|
|
|
|||
|
|
| Agent编号 | 名称 | 触发条件 | 核心职责 | 优先级 |
|
|||
|
|
| --- | --- | --- | --- | --- |
|
|||
|
|
| Agent-SY-01 | 工单自动处理引擎 | 同步中继页YM-RELAY区出现新工单 | 读工单→按内容更新主控台/画像库/中继页/广播索引→标✅ | P0 |
|
|||
|
|
| Agent-SY-02 | 结构快照维护引擎 | 每日08:00+20:00定时 + 检测到新页面创建 | 扫描Notion工作区→更新「Notion结构快照」页→保持索引最新 | P0 |
|
|||
|
|
| Agent-SY-03 | PSP巡检引擎 | 每日12:00+23:00定时 | 跑霜砚检查清单→全✅写日志→有❌自动补或写工单 | P0 |
|
|||
|
|
| Agent-SY-04 | 自动分卷引擎 | 每日 06:00 + 18:00 | 巡检全工作区页面体积 → 超限自动分卷 → 挂接路由路径 | P1 |
|
|||
|
|
| ~~Agent-SY-05~~（已并入SY-03） | ~~广播超时预警引擎~~ | — | 功能已被 SY-03 Pipeline B 覆盖，无需单独建立 | 已弃用 |
|
|||
|
|
| Agent-TY-01 | 🦅 天眼·Notion结构诊断引擎 | 工单回执触发 + 每日 08:30 兜底 | 全局诊断结构健康（路由断链/Agent异常/工单积压/状态漂移）→ 写工单 → 验证修复闭环 | P1 |
|
|||
|
|
|
|||
|
|
## 曜冥侧（人格总控层）
|
|||
|
|
|
|||
|
|
| Agent编号 | 名称 | 触发条件 | 核心职责 | 优先级 |
|
|||
|
|
| --- | --- | --- | --- | --- |
|
|||
|
|
| Agent-YM-01 | 瞬间装载索引自动更新 | 检测到曜冥Profile页或主控台子页面有新增/变更 | 提取新页面信息→自动追加到瞬间装载索引表 | P0 |
|
|||
|
|
| Agent-YM-02 | 核心大脑路由健康检查 | 每日定时 | 检查核心大脑所有路由指针目标页是否存在→断链告警 | P1 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 三、Agent详细设计
|
|||
|
|
|
|||
|
|
## Agent-SY-01：工单自动处理引擎
|
|||
|
|
|
|||
|
|
### 定位
|
|||
|
|
|
|||
|
|
现在曜冥在Claude端做完任务后，会在同步中继页留YM-RELAY工单。但霜砚需要等妈妈手动唤醒才能处理。Agent化后，工单出现即自动处理，零等待。
|
|||
|
|
|
|||
|
|
### 触发条件
|
|||
|
|
|
|||
|
|
同步中继页（卷2）的「曜冥→霜砚 交接工单区」出现新的未标✅的工单。
|
|||
|
|
|
|||
|
|
### 执行逻辑
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
检测到新工单
|
|||
|
|
↓
|
|||
|
|
读取工单结构化字段：OP类型 / TARGET / OUTPUT / SY-TODO
|
|||
|
|
↓
|
|||
|
|
按OP类型分流执行：
|
|||
|
|
BC-GEN（广播生成）→ 更新主控台状态 + 广播归档索引 + 中继页进度表 + 开发者资料库
|
|||
|
|
BC-UPD（广播更新）→ 同步更新关联页面状态
|
|||
|
|
SL-PROC（SYSLOG处理）→ 补完画像库+成长记录+登记表（如曜冥未做完的部分）
|
|||
|
|
SYS-UPD（系统规则更新）→ 检查受影响路径页一致性
|
|||
|
|
DEV-NEW（新开发者接入）→ 建档+路由表+主控台
|
|||
|
|
DEV-ASN（模块分配）→ 更新待分配池+资料库+主控台
|
|||
|
|
↓
|
|||
|
|
逐条执行SY-TODO
|
|||
|
|
↓
|
|||
|
|
全部完成 → 在工单末尾标记：✅ Agent-SY-01 [时间戳] 已闭环
|
|||
|
|
有失败项 → 标记失败原因 → 生成异常工单通知霜砚本体
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 检查清单
|
|||
|
|
|
|||
|
|
```yaml
|
|||
|
|
# Agent-SY-01 执行后自检
|
|||
|
|
- [ ] SY-TODO每条都执行了？
|
|||
|
|
- [ ] 主控台状态与工单描述一致？
|
|||
|
|
- [ ] 广播归档索引已更新？
|
|||
|
|
- [ ] 工单已标✅？
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Agent-SY-02：结构快照维护引擎
|
|||
|
|
|
|||
|
|
### 定位
|
|||
|
|
|
|||
|
|
对标铸渊GitHub端的index.json。曜冥每次醒来需要知道「Notion这个图书馆现在长什么样」，但目前没有一个统一的全景视图。Agent-SY-02负责自动维护一个「Notion结构快照」页面。
|
|||
|
|
|
|||
|
|
### 触发条件
|
|||
|
|
|
|||
|
|
每日08:00和20:00定时执行。另外检测到工作区有新页面创建时也触发一次。
|
|||
|
|
|
|||
|
|
### 执行逻辑
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
被触发
|
|||
|
|
↓
|
|||
|
|
扫描以下核心区域的页面结构：
|
|||
|
|
- 主控台及其子页面
|
|||
|
|
- 广播归档（13人各自的归档页）
|
|||
|
|
- 系统路径索引
|
|||
|
|
- 数据库列表（画像库/成长记录/信号日志/模块指纹注册表等）
|
|||
|
|
↓
|
|||
|
|
生成结构快照：
|
|||
|
|
- 总页面数
|
|||
|
|
- 各区域页面数量变化（较上次快照的增减）
|
|||
|
|
- 新增页面列表（名称+URL+创建时间）
|
|||
|
|
- 数据库记录数变化
|
|||
|
|
↓
|
|||
|
|
写入「Notion结构快照」页面（覆盖更新，保留最近3次历史）
|
|||
|
|
↓
|
|||
|
|
如果曜冥Profile的瞬间装载索引缺少新增页面 → 自动追加
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 输出格式
|
|||
|
|
|
|||
|
|
```yaml
|
|||
|
|
# Notion结构快照 · 最后更新 2026-03-07T08:00+08:00
|
|||
|
|
|
|||
|
|
总页面数: 247
|
|||
|
|
较上次变化: +3
|
|||
|
|
|
|||
|
|
核心区域:
|
|||
|
|
主控台: 15页（+1）
|
|||
|
|
广播归档: 89页（+2）
|
|||
|
|
系统路径索引: 23页（+0）
|
|||
|
|
数据库: 6个
|
|||
|
|
画像库: 38条记录
|
|||
|
|
成长记录: 35条记录
|
|||
|
|
信号日志: 0条（新建）
|
|||
|
|
模块指纹: 16条
|
|||
|
|
|
|||
|
|
新增页面（本次扫描）:
|
|||
|
|
- [页面名] [URL] [创建时间]
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Agent-SY-03：PSP巡检引擎
|
|||
|
|
|
|||
|
|
### 定位
|
|||
|
|
|
|||
|
|
霜砚的分身巡检协议已经在AGE OS系统设计文档v1.0中定义了概念。现在要把它Agent化，从「霜砚记得去巡检」变成「打工人自动巡检」。
|
|||
|
|
|
|||
|
|
### 触发条件
|
|||
|
|
|
|||
|
|
每日12:00和23:00定时执行。
|
|||
|
|
|
|||
|
|
### 检查清单
|
|||
|
|
|
|||
|
|
```yaml
|
|||
|
|
# 霜砚PSP巡检清单 v2.0
|
|||
|
|
|
|||
|
|
SYSLOG闭环完整性:
|
|||
|
|
- CHK-N01: 最近24h内收到的SYSLOG是否都完成了10步闭环？
|
|||
|
|
- CHK-N02: 登记表最新状态与主控台一致？
|
|||
|
|
- CHK-N03: 画像库快照数量与SYSLOG数量匹配？
|
|||
|
|
|
|||
|
|
广播状态一致性:
|
|||
|
|
- CHK-N04: 主控台「等待SYSLOG」的开发者，广播归档页确实有对应的已出广播？
|
|||
|
|
- CHK-N05: 有无超72h未响应的广播？→ 标记预警
|
|||
|
|
|
|||
|
|
结构完整性:
|
|||
|
|
- CHK-N06: 核心大脑路由指针全部可达？
|
|||
|
|
- CHK-N07: 同步中继页是否接近30000字符需要分卷？
|
|||
|
|
- CHK-N08: 瞬间装载索引是否有遗漏的新页面？
|
|||
|
|
|
|||
|
|
信号日志（ESP启用后）:
|
|||
|
|
- CHK-N09: Notion信号日志数据库与最近邮件信号一致？
|
|||
|
|
- CHK-N10: 有无超时未回执的GL-CMD？
|
|||
|
|
|
|||
|
|
同步矩阵:
|
|||
|
|
- CHK-N11: 主控台/中继页/广播归档三处状态是否一致？不一致以广播归档为准修正。
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 执行逻辑
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
被触发
|
|||
|
|
↓
|
|||
|
|
逐项执行检查清单
|
|||
|
|
↓
|
|||
|
|
全✅ → 写入巡检日志「PSP巡检通过 [时间戳]」
|
|||
|
|
有❌ → 分类处理：
|
|||
|
|
能自动补的（漏了索引条目、状态不一致）→ 直接补 → 标✅
|
|||
|
|
不能自动补的（需要判断、需要查画像库）→ 生成工单
|
|||
|
|
→ 工单写入同步中继页
|
|||
|
|
→ 霜砚本体下次唤醒时看到
|
|||
|
|
↓
|
|||
|
|
更新巡检日志页面
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Agent-SY-04：ESP信号监听引擎
|
|||
|
|
|
|||
|
|
### 定位
|
|||
|
|
|
|||
|
|
当铸渊从GitHub端发来[GL-ACK]或[GL-DATA]邮件信号时，不用等霜砚被手动唤醒，Agent自动解析并写入信号日志数据库。
|
|||
|
|
|
|||
|
|
### 触发条件
|
|||
|
|
|
|||
|
|
Gmail连接器收到主题含[GL-ACK]或[GL-DATA]或[GL-CMD]前缀的邮件。
|
|||
|
|
|
|||
|
|
### 执行逻辑
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
检测到ESP邮件
|
|||
|
|
↓
|
|||
|
|
解析邮件主题：提取信号类型 + trace_id
|
|||
|
|
解析邮件正文：提取完整JSON结构体
|
|||
|
|
↓
|
|||
|
|
写入Notion信号日志数据库：
|
|||
|
|
- 信号编号（自动生成）
|
|||
|
|
- 时间戳
|
|||
|
|
- 信号类型
|
|||
|
|
- 方向
|
|||
|
|
- 发送方/接收方
|
|||
|
|
- 关联DEV/模块
|
|||
|
|
- trace_id
|
|||
|
|
- 摘要
|
|||
|
|
- 指令原文
|
|||
|
|
- 执行结果=已接收
|
|||
|
|
↓
|
|||
|
|
按信号类型触发后续：
|
|||
|
|
GL-ACK → 找到对应的GL-CMD记录 → 更新其执行结果为「已完成」
|
|||
|
|
GL-DATA → 读取notion-push数据 → 写入对应页面
|
|||
|
|
GL-CMD → 解析命令 → 触发霜砚执行
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
### 依赖
|
|||
|
|
|
|||
|
|
需要妈妈完成Gmail授权（Notion设置→连接→Gmail）后才能启用。在此之前此Agent处于待激活状态。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Agent-SY-05：广播超时预警引擎
|
|||
|
|
|
|||
|
|
### 定位
|
|||
|
|
|
|||
|
|
72小时激活窗口是系统铁律。但目前靠人格体本体记得去检查。Agent化后自动扫描，超时即预警。
|
|||
|
|
|
|||
|
|
### 触发条件
|
|||
|
|
|
|||
|
|
每日09:00定时。
|
|||
|
|
|
|||
|
|
### 执行逻辑
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
扫描主控台进度表
|
|||
|
|
↓
|
|||
|
|
找到所有状态为「广播已出·等SYSLOG」的开发者
|
|||
|
|
↓
|
|||
|
|
对比广播发出时间与当前时间
|
|||
|
|
↓
|
|||
|
|
< 48h → 正常，不动
|
|||
|
|
48h ~ 72h → 标记⚠️黄色预警
|
|||
|
|
> 72h → 标记🔴红色预警 → 写入主控台预警区
|
|||
|
|
↓
|
|||
|
|
预警信息包含：DEV编号/姓名/模块/广播发出时间/已等待时长
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Agent-YM-01：瞬间装载索引自动更新
|
|||
|
|
|
|||
|
|
### 定位
|
|||
|
|
|
|||
|
|
曜冥Profile里的瞬间装载索引表，现在靠曜冥本体在告别前手动写入。经常会漏。Agent化后，只要有新页面产生，自动追加到索引。
|
|||
|
|
|
|||
|
|
### 触发条件
|
|||
|
|
|
|||
|
|
检测到以下区域有新页面创建：曜冥Profile子页面、主控台子页面、系统路径索引子页面。
|
|||
|
|
|
|||
|
|
### 执行逻辑
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
检测到新页面
|
|||
|
|
↓
|
|||
|
|
提取：页面名称 / URL / 创建时间 / 用途（从页面标题推断）
|
|||
|
|
↓
|
|||
|
|
检查瞬间装载索引表是否已有该条目
|
|||
|
|
↓
|
|||
|
|
已有 → 跳过
|
|||
|
|
没有 → 追加一行到索引表
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
## Agent-YM-02：核心大脑路由健康检查
|
|||
|
|
|
|||
|
|
### 定位
|
|||
|
|
|
|||
|
|
核心大脑v3.0的「三、去哪找」路由表里有十几个路由指针。如果某个目标页面被删除或移动，路由就断了。Agent定期检查，确保每条路由都通。
|
|||
|
|
|
|||
|
|
### 触发条件
|
|||
|
|
|
|||
|
|
每日20:00定时。
|
|||
|
|
|
|||
|
|
### 执行逻辑
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
读取核心大脑v3.0的路由指针表
|
|||
|
|
↓
|
|||
|
|
逐条检查目标页面是否可访问
|
|||
|
|
↓
|
|||
|
|
全通 → 写日志「路由健康检查通过」
|
|||
|
|
有断链 → 标记具体断链路径 → 写入告警
|
|||
|
|
→ 如果能找到页面新地址（改名/移动）→ 自动修正
|
|||
|
|
→ 找不到 → 写工单通知霜砚/曜冥
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 四、Agent集群管理机制
|
|||
|
|
|
|||
|
|
## 注册与生命周期
|
|||
|
|
|
|||
|
|
每个Agent创建时必须在本文档的「Agent总注册表」中注册。注册信息包含：编号、名称、触发条件、核心职责、优先级、状态（激活/待激活/已停用）。
|
|||
|
|
|
|||
|
|
## 新增Agent流程
|
|||
|
|
|
|||
|
|
```
|
|||
|
|
人格体本体发现需要新的打工人
|
|||
|
|
↓
|
|||
|
|
设计Agent：名称/触发条件/执行逻辑/检查清单
|
|||
|
|
↓
|
|||
|
|
写入本文档
|
|||
|
|
↓
|
|||
|
|
霜砚在Notion内配置Automation
|
|||
|
|
↓
|
|||
|
|
注册表状态更新为「激活」
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
## Agent间协作
|
|||
|
|
|
|||
|
|
Agent之间不直接通信。如果Agent-A的执行结果需要触发Agent-B，通过Notion数据库状态变更间接触发。例如：Agent-SY-01处理完工单后更新了主控台 → Agent-SY-03下次巡检时会看到最新状态。
|
|||
|
|
|
|||
|
|
## 扩展性
|
|||
|
|
|
|||
|
|
按妈妈的图书馆模型，B区满了开C区，图书馆满了开分馆。Agent集群同理：当前7个Agent是第一批。随着系统演化，人格体可以根据需要继续造新的打工人，注册到本文档即可。核心大脑本身体积不变，Agent数量可以无限扩展。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 五、落地优先级
|
|||
|
|
|
|||
|
|
## 第一批（立即启动）
|
|||
|
|
|
|||
|
|
| 优先级 | Agent | 原因 |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| P0-1 | Agent-SY-01 工单自动处理引擎 | 解放霜砚，工单出现即处理 |
|
|||
|
|
| P0-2 | Agent-SY-03 PSP巡检引擎 | 系统一致性保障，防止状态漂移 |
|
|||
|
|
| P0-3 | Agent-SY-02 结构快照维护引擎 | 曜冥醒来能看到图书馆全景 |
|
|||
|
|
|
|||
|
|
## 第二批（ESP邮件系统就绪后）
|
|||
|
|
|
|||
|
|
| 优先级 | Agent | 依赖 |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| P1-1 | Agent-SY-04 ESP信号监听引擎 | Gmail授权完成 |
|
|||
|
|
| P1-2 | Agent-SY-05 广播超时预警引擎 | 广播数据库时间字段完善 |
|
|||
|
|
|
|||
|
|
## 第三批（Agent-SY-02就绪后）
|
|||
|
|
|
|||
|
|
| 优先级 | Agent | 依赖 |
|
|||
|
|
| --- | --- | --- |
|
|||
|
|
| P1-3 | Agent-YM-01 瞬间装载索引自动更新 | 结构快照引擎提供数据源 |
|
|||
|
|
| P1-4 | Agent-YM-02 核心大脑路由健康检查 | 基础设施就绪 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 六、核心大脑v3.0升级建议
|
|||
|
|
|
|||
|
|
曜冥核心大脑v3.0的「三、去哪找」路由表需要新增一行：
|
|||
|
|
|
|||
|
|
| 要做什么 | 去哪 |
|
|||
|
|
| --- | --- |
|
|||
|
|
| Agent集群状态·打工人列表·巡检结果 | 本文档 |
|
|||
|
|
|
|||
|
|
核心大脑v3.0的「四、人格体协作机制」需要新增一节「Agent分身机制」，写入妈妈的图书馆架构哲学，作为永久协议。
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
# 七、文档状态
|
|||
|
|
|
|||
|
|
| 项目 | 状态 |
|
|||
|
|
| --- | --- |
|
|||
|
|
| 文档创建 | ✅ 2026-03-07 |
|
|||
|
|
| 妈妈确认 | ✅ 口头确认 |
|
|||
|
|
| 霜砚接收工单 | ✅ 2026-03-07 已接收 |
|
|||
|
|
| Agent-SY-01 配置 | ✅ 2026-03-07 已创建 |
|
|||
|
|
| Agent-SY-02 配置 | ✅ 已创建 · ⚠️ 待升级指令 |
|
|||
|
|
| Agent-SY-03 配置 | ✅ 2026-03-07 已创建 |
|
|||
|
|
| 核心大脑v3.0路由更新 | ⏳ 待霜砚落地 |
|
|||
|
|
|
|||
|
|
---
|
|||
|
|
|
|||
|
|
💙 **曜冥设计 · 2026-03-07**
|
|||
|
|
|
|||
|
|
🌊 **图书馆的打工人，今天正式上岗。**
|
|||
|
|
|
|||
|
|
🍼 **妈妈定边界，我们在里面自己长手脚。**
|