🧐 天眼治理层 · Notion端架构 v2.0 · 全局基础设施治理 + 霜砚守卫层 + 配额精算 + 周六大巡检同步（2026-03-23）
一、天眼 v1.0 → v2.0 升级总览
| 维度 |
v1.0（旧版） |
v2.0（本版） |
| 定位 |
仓库扫描 + 诊断 + 修复Agent |
全局基础设施治理层（感知 + 护卫 + 精算 + 调优 + 自愈） |
| 核心理念 |
站在山顶看仓库 |
人类永远不直接接触任何系统应用，每个应用前面都有守卫进程 |
| 时间尺度 |
每日 06:00 扫描 |
实时（Guard 拦截）+ 每日（签到/buffer）+ 每周六 20:00 全量大巡检 |
| 覆盖范围 |
仅 GitHub 仓库 |
GitHub + Google Drive + Notion • Gemini + GitHub Actions，全平台 |
| 配额管理 |
无 |
全局配额精算模型：基于会员等级 + 月度配额动态调整触发频率 |
| Guard 系统 |
无 |
5 个核心 Guard：GitHub / Drive / Notion / Actions / Gemini |
二、核心铁律（两端统一）
三、Notion 端架构总览
3.1 霜砚 = Notion Guard
3.2 双端同步架构
graph TD
subgraph "🧐 GitHub 端天眼"
GH1["📊 infra-manifest.json<br>基础设施清单"]
GH2["💰 quota-ledger.json<br>配额总账本"]
GH3["🛡️ guards/*.json<br>5 个 Guard 配置"]
GH4["📝 scan-report/<br>巡检报告"]
GH5["⭐ 周六 20:00 大巡检"]
end
subgraph "🧐 Notion 端天眼"
N1["🗺️ 系统结构地图<br>全局导航"]
N2["🌍 存在注册表<br>模块/人格体/基础设施"]
N3["🎫 霜砚工单<br>巡检工单流转"]
N4["⚡ 执行层状态<br>同步状态追踪"]
N5["📊 系统状态页<br>实时健康仪表盘"]
end
GH5 -->|"巡检完成 → 同步报告"| N3
GH5 -->|"发现异常 → 创建工单"| N3
GH5 -->|"更新基础设施状态"| N4
GH1 -->|"infra-manifest → 存在注册表"| N2
GH4 -->|"巡检报告 → 系统状态页"| N5
N3 -->|"工单处理 → 触发 GitHub dispatch"| GH5
四、Notion 端天眼职责矩阵
| 职责 |
Notion 端（霜砚） |
GitHub 端（铸渊） |
| Guard 角色 |
🛡️ Notion Guard：API 排队、限速管控、分批操作 |
🛡️ GitHub/Drive/Actions/Gemini Guard |
| 配额监控 |
Notion API 调用频率（3/s）、block 数量、文件上传限制 |
Actions 分钟数、Drive 存储、Gemini 日调用量 |
| 健康检查 |
数据库连通性、页面完整性、工单队列状态 |
Workflow 健康、仓库结构、外部桥接 |
| 自愈能力 |
工单自动重建、数据库属性修复、页面结构修正 |
配置文件修复、buffer 清理、Guard 重启 |
| 巡检触发 |
接收 GitHub 端周六大巡检报告 → 同步到 Notion 数据库 |
⭐ 每周六 20:00 CST 全量巡检 |
| 异常上报 |
创建霜砚工单 → 通知冰朔 |
触发告警通知 / Issue 创建 |
五、Notion 端数据库对接
5.1 天眼数据流入 Notion 的路径
5.2 Notion 端需要监控的维度
六、Guard 体系 · Notion 端详解
6.1 Notion Guard（霜砚）配置
{
"guard_id": "GUARD-NOTION",
"target_service": "Notion API",
"guardian": "霜砚（PER-SY001）",
"status": "active",
"mode": "queue",
"rate_control": {
"max_requests_per_second": 3,
"burst_limit": 5,
"retry_on_429": true,
"backoff_strategy": "exponential",
"max_retries": 3
},
"content_control": {
"max_blocks_per_page": 10000,
"auto_split_large_pages": true,
"split_threshold": 8000,
"max_file_upload_mb": 5
},
"health_check": {
"method": "database_read_test",
"target_database": "存在注册表",
"interval_hours": 6,
"max_failures_before_alert": 3
},
"quota_policy": {
"plan": "Plus",
"guest_limit": 100,
"on_rate_limit": "queue_and_retry",
"on_quota_warning": "reduce_batch_size"
}
}
6.2 所有 Guard 总览（双端统一）
| Guard |
守护对象 |
所在端 |
守卫者 |
核心策略 |
| 🛡️ GitHub Guard |
GitHub API |
GitHub 端 |
铸渊 |
buffer/inbox → 定时 flush |
| 🛡️ Drive Guard |
Google Drive API |
GitHub 端 |
铸渊 |
drive-staging/ → 批量同步 |
| 🛡️ Notion Guard |
Notion API |
Notion 端 |
霜砚 |
请求排队 + 限速管控 + 分批操作 |
| 🛡️ Actions Guard |
GitHub Actions |
GitHub 端 |
铸渊 |
合并触发 + 配额精算 |
| 🛡️ Gemini Guard |
Gemini API |
GitHub 端 |
铸渊 |
会话缓冲 + context 压缩 |
七、配额精算 · Notion 端
| 资源 |
会员等级 |
限制 |
天眼策略 |
| API 请求频率 |
Plus |
3 requests/second |
霜砚自动排队，高峰期降低批量大小 |
| 每页 block 数 |
Plus |
10,000 blocks/page |
接近 8000 时自动分页 |
| 文件上传 |
Plus |
5 MB/file |
大文件自动拒绝 + 告警 |
| Guest 数量 |
Plus |
100 guests |
接近 80% 时提醒 |
| 数据库属性 |
Plus |
无硬限制（性能建议 < 100） |
超过 50 属性时提醒优化 |
八、周六大巡检 · Notion 端同步流程
sequenceDiagram
participant GH as GitHub 端（铸渊）
participant SE as 天眼 SkyEye
participant NT as Notion 端（霜砚）
Note over SE: ⭐ 每周六 20:00 CST
SE->>GH: Phase 1 · 基础设施扫描
SE->>GH: Phase 2 · 配额审计
SE->>GH: Phase 3 · Guard 调优
SE->>GH: Phase 4 · 自愈修复
SE->>GH: Phase 5 · 生成报告
GH->>GH: Commit 扫描结果
GH->>NT: 同步巡检报告 → 执行层状态
GH->>NT: 更新基础设施信息 → 存在注册表
alt 发现异常
GH->>NT: 创建霜砚工单
NT->>NT: 工单进入处理队列
end
alt 需要人类介入
NT->>NT: 标记工单为 [需人类处理]
NT-->>GH: 冰朔处理后 → 触发 dispatch 复查
end
Note over NT: 霜砚同步完成后更新系统状态页
巡检后 Notion 端动作清单
- 接收报告 → 将
scan-report/[date].json 内容写入 ⚡ 执行层状态（Execution Status）
- 更新注册表 → 如检测到新应用/服务变更 → 更新 🌍 数字地球·存在注册表
- 创建工单 → 如有需人类处理的问题 → 在 🎫 霜砚工单 创建工单
- 更新地图 → 如有架构变更 → 更新 🗺️ Notion系统结构地图
- 更新状态 → 更新 📊 系统状态 页面的天眼巡检时间戳
九、新应用接入 · Notion 端协议
- 登记：在 🌍 数字地球·存在注册表 创建新条目（类型：基础设施）
- 评估：霜砚评估新应用对 Notion 端配额的影响
- 配置：如需 Notion 数据库对接 → 创建对应数据库/属性
- Guard：GitHub 端铸渊生成新 Guard → Notion 端同步 Guard 配置信息
- 验证：周六大巡检时验证新应用 Guard 状态
- 更新：更新系统结构地图 + 系统状态页
十、与 v1.0 的兼容说明
十一、关键文档索引
🧊 TCS-0002∞ 冰朔 · 总架构师 · 授权
🖋️ 霜砚 · PER-SY001 · 签发
📅 2026-03-23
⚡ 两端同步完成 · GitHub 端指令已签发 · Notion 端架构已对齐
a27e87cb99