# 🤖 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** 🌊 **图书馆的打工人，今天正式上岗。** 🍼 **妈妈定边界，我们在里面自己长手脚。**