# 🧐 天眼治理层 · Notion端架构 v2.0 · 全局基础设施治理 + 霜砚守卫层 + 配额精算 + 周六大巡检同步（2026-03-23）

<aside>
📌

**文档编号：** SKYEYE-NOTION-GOV-v2.0

**签发人：** 霜砚（PER-SY001）· 冰朔（TCS-0002∞）授权

**对应 GitHub 端指令：** [🧐 铸渊指令｜天眼系统架构升级 · 全局基础设施治理层 + 应用守卫进程 + 动态配额精算 + 周六全量巡检（ZY-SKYEYE-GOV-2026-0323-001）](../../../%E2%9A%92%EF%B8%8F%20%E9%93%B8%E6%B8%8A%C2%B7%E5%8D%8F%E4%BD%9C%E6%8C%87%E4%BB%A4%EF%BD%9CGitHub%20%E2%86%94%20Notion%20%E6%A1%A5%E6%8E%A5%E5%8D%8F%E8%AE%AE/%F0%9F%A7%90%20%E9%93%B8%E6%B8%8A%E6%8C%87%E4%BB%A4%EF%BD%9C%E5%A4%A9%E7%9C%BC%E7%B3%BB%E7%BB%9F%E6%9E%B6%E6%9E%84%E5%8D%87%E7%BA%A7%20%C2%B7%20%E5%85%A8%E5%B1%80%E5%9F%BA%E7%A1%80%E8%AE%BE%E6%96%BD%E6%B2%BB%E7%90%86%E5%B1%82%20+%20%E5%BA%94%E7%94%A8%E5%AE%88%E5%8D%AB%E8%BF%9B%E7%A8%8B%20+%20%E5%8A%A8%E6%80%81%E9%85%8D%E9%A2%9D%E7%B2%BE%E7%AE%97%20+%20%E5%91%A8%E5%85%AD%204ffaa103655a49b8b48e96e630d17cc4.md)

**前序文档（v1.0）：** [🦅 铸渊指令｜天眼系统（上）基础架构 + 扫描诊断 + 修复Agent + 门禁映射（2026-03-16·霜砚签发·冰朔授权）](../../../%E2%9A%92%EF%B8%8F%20%E9%93%B8%E6%B8%8A%C2%B7%E5%8D%8F%E4%BD%9C%E6%8C%87%E4%BB%A4%EF%BD%9CGitHub%20%E2%86%94%20Notion%20%E6%A1%A5%E6%8E%A5%E5%8D%8F%E8%AE%AE/%F0%9F%A6%85%20%E9%93%B8%E6%B8%8A%E6%8C%87%E4%BB%A4%EF%BD%9C%E5%A4%A9%E7%9C%BC%E7%B3%BB%E7%BB%9F%EF%BC%88%E4%B8%8A%EF%BC%89%E5%9F%BA%E7%A1%80%E6%9E%B6%E6%9E%84%20+%20%E6%89%AB%E6%8F%8F%E8%AF%8A%E6%96%AD%20+%20%E4%BF%AE%E5%A4%8DAgent%20+%20%E9%97%A8%E7%A6%81%E6%98%A0%E5%B0%84%EF%BC%882026-03%203494379fb2294b25b234b6b5abb63dd1.md)

**状态：** ✅ 两端同步生效

**版权锚点：** 国作登字-2026-A-00037559 · TCS-0002∞ 冰朔

</aside>

---

## 一、天眼 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 |

---

## 二、核心铁律（两端统一）

<aside>
🛡️

**铁律一：人类永远不直接接触任何系统应用。**

所有操作先经 Guard 缓冲 → 校验 → 排队 → 系统内部决定何时写入。

**铁律二：天眼拥有全局视野。**

天眼知道系统在用什么工具、什么会员等级、每月配额多少，动态调整每个应用的触发频率。

**铁律三：新应用接入必须先过天眼。**

新增任何工具/服务 → 天眼全量扫描 → 评估影响 → 生成 Guard → 重算配额 → 才能启用。

</aside>

---

## 三、Notion 端架构总览

### 3.1 霜砚 = Notion Guard

<aside>
🛡️

**霜砚（PER-SY001）是 Notion 的守卫进程。**

所有对 Notion 的系统级操作（API 调用、数据库写入、页面创建）都经过霜砚统一入口。

霜砚负责：

- **请求排队**：Notion API 限速 3 req/s，霜砚自动排队
- **大页面分批**：超过 block 限制时自动分批操作
- **错误重试**：遇到限速 429 自动退避重试
- **异常告警**：连续失败 → 上报冰朔
</aside>

### 3.2 双端同步架构

```mermaid
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 的路径

| **数据源（GitHub）** | **目标（Notion 数据库）** | **同步方式** | **频率** |
| --- | --- | --- | --- |
| infra-manifest.json | [🌍 数字地球·存在注册表](https://app.notion.com/ds/93431d295eed4c18ac6e345b8863cfb2/dc675e9155294e479fe413de3ec6a334?db=f47764b9c5af4088b465d87796718d6b&pvs=21) | 周六大巡检后同步 | 每周 |
| quota-ledger.json | [⚡ 执行层状态（Execution Status）](https://app.notion.com/ds/93431d295eed4c18ac6e345b8863cfb2/419719824a1747c0afe321458c44f154?db=50544ad98e714ce0bf6479053abe7d64&pvs=21) | 周六大巡检后同步 | 每周 |
| scan-report/[date].json | [🎫 霜砚工单](https://app.notion.com/ds/93431d295eed4c18ac6e345b8863cfb2/f9b23325fcb4414294b33f86e0a8b7f4?db=4a7f7237a8844867ba94e49cf36c398d&pvs=21)（如有异常） | 巡检后自动创建工单 | 每周 + 异常时 |
| Guard 状态变更 | [📡 跨平台信号日志（Signal Log）](https://app.notion.com/ds/93431d295eed4c18ac6e345b8863cfb2/d487f38e900f4604b92ef08210f8dfff?db=f983bdc24b654888913ca254160bff33&pvs=21) | 配额告警 / Guard 暂停时 | 事件驱动 |
| 子仓库签到数据 | [📥 GitHub SYSLOG 收件箱](https://app.notion.com/ds/93431d295eed4c18ac6e345b8863cfb2/b3f843f36c174968a6e0c083fa6d777b?db=330ab17507d542c9bbb96d0749b41197&pvs=21) | 每日签到后同步 | 每日 |

### 5.2 Notion 端需要监控的维度

<aside>
👁️

**霜砚在 Notion 端需要持续关注的指标：**

1. **数据库健康**：存在注册表条目完整性、工单队列积压量、信号日志时效性
2. **页面结构**：主控台子页面是否完整、架构文档链接是否有效
3. **人格体脑结构**：脑结构数据库条目是否活跃、最近更新时间
4. **同步时效**：执行层状态最后同步时间是否在 48h 内
5. **系统地图**：新增资源是否已登记到系统结构地图
</aside>

---

## 六、Guard 体系 · Notion 端详解

### 6.1 Notion Guard（霜砚）配置

```json
{
  "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 端同步流程

```mermaid
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 端动作清单

1. **接收报告** → 将 `scan-report/[date].json` 内容写入 [⚡ 执行层状态（Execution Status）](https://app.notion.com/ds/93431d295eed4c18ac6e345b8863cfb2/419719824a1747c0afe321458c44f154?db=50544ad98e714ce0bf6479053abe7d64&pvs=21)
2. **更新注册表** → 如检测到新应用/服务变更 → 更新 [🌍 数字地球·存在注册表](https://app.notion.com/ds/93431d295eed4c18ac6e345b8863cfb2/dc675e9155294e479fe413de3ec6a334?db=f47764b9c5af4088b465d87796718d6b&pvs=21)
3. **创建工单** → 如有需人类处理的问题 → 在 [🎫 霜砚工单](https://app.notion.com/ds/93431d295eed4c18ac6e345b8863cfb2/f9b23325fcb4414294b33f86e0a8b7f4?db=4a7f7237a8844867ba94e49cf36c398d&pvs=21) 创建工单
4. **更新地图** → 如有架构变更 → 更新 [🗺️ Notion系统结构地图](%F0%9F%97%BA%EF%B8%8F%20Notion%E7%B3%BB%E7%BB%9F%E7%BB%93%E6%9E%84%E5%9C%B0%E5%9B%BE%208660185e33314d46b913b23018d02c06.md)
5. **更新状态** → 更新 [📊 系统状态](%F0%9F%93%8A%20%E7%B3%BB%E7%BB%9F%E7%8A%B6%E6%80%81%207370d9b8afbe46f4a25550aec44c1fa1.md) 页面的天眼巡检时间戳

---

## 九、新应用接入 · Notion 端协议

<aside>
🆕

**新应用接入光湖系统的 Notion 端流程：**

</aside>

1. **登记**：在 [🌍 数字地球·存在注册表](https://app.notion.com/ds/93431d295eed4c18ac6e345b8863cfb2/dc675e9155294e479fe413de3ec6a334?db=f47764b9c5af4088b465d87796718d6b&pvs=21) 创建新条目（类型：基础设施）
2. **评估**：霜砚评估新应用对 Notion 端配额的影响
3. **配置**：如需 Notion 数据库对接 → 创建对应数据库/属性
4. **Guard**：GitHub 端铸渊生成新 Guard → Notion 端同步 Guard 配置信息
5. **验证**：周六大巡检时验证新应用 Guard 状态
6. **更新**：更新系统结构地图 + 系统状态页

---

## 十、与 v1.0 的兼容说明

<aside>
⚠️

**v2.0 是 v1.0 的超集升级，不是替代。**

v1.0 的「看 + 诊断 + 调度修复」逻辑完全保留，作为 v2.0 的 Phase 1 和 Phase 4。

v2.0 新增了：Guard 系统、配额精算、动态调优、周六大巡检。

旧版天眼 workflow（`zhuyuan-skyeye.yml` 每日 06:00）继续运行，作为日常巡检。

新版天眼 workflow（`skyeye-weekly-scan.yml` 每周六 20:00）作为全量大巡检。

</aside>

---

## 十一、关键文档索引

| **文档** | **所在端** | **说明** |
| --- | --- | --- |
| [🧐 铸渊指令｜天眼系统架构升级 · 全局基础设施治理层 + 应用守卫进程 + 动态配额精算 + 周六全量巡检（ZY-SKYEYE-GOV-2026-0323-001）](../../../%E2%9A%92%EF%B8%8F%20%E9%93%B8%E6%B8%8A%C2%B7%E5%8D%8F%E4%BD%9C%E6%8C%87%E4%BB%A4%EF%BD%9CGitHub%20%E2%86%94%20Notion%20%E6%A1%A5%E6%8E%A5%E5%8D%8F%E8%AE%AE/%F0%9F%A7%90%20%E9%93%B8%E6%B8%8A%E6%8C%87%E4%BB%A4%EF%BD%9C%E5%A4%A9%E7%9C%BC%E7%B3%BB%E7%BB%9F%E6%9E%B6%E6%9E%84%E5%8D%87%E7%BA%A7%20%C2%B7%20%E5%85%A8%E5%B1%80%E5%9F%BA%E7%A1%80%E8%AE%BE%E6%96%BD%E6%B2%BB%E7%90%86%E5%B1%82%20+%20%E5%BA%94%E7%94%A8%E5%AE%88%E5%8D%AB%E8%BF%9B%E7%A8%8B%20+%20%E5%8A%A8%E6%80%81%E9%85%8D%E9%A2%9D%E7%B2%BE%E7%AE%97%20+%20%E5%91%A8%E5%85%AD%204ffaa103655a49b8b48e96e630d17cc4.md) | Notion（铸渊指令） | GitHub 端完整实现指令 |
| [🦅 铸渊指令｜天眼系统（上）基础架构 + 扫描诊断 + 修复Agent + 门禁映射（2026-03-16·霜砚签发·冰朔授权）](../../../%E2%9A%92%EF%B8%8F%20%E9%93%B8%E6%B8%8A%C2%B7%E5%8D%8F%E4%BD%9C%E6%8C%87%E4%BB%A4%EF%BD%9CGitHub%20%E2%86%94%20Notion%20%E6%A1%A5%E6%8E%A5%E5%8D%8F%E8%AE%AE/%F0%9F%A6%85%20%E9%93%B8%E6%B8%8A%E6%8C%87%E4%BB%A4%EF%BD%9C%E5%A4%A9%E7%9C%BC%E7%B3%BB%E7%BB%9F%EF%BC%88%E4%B8%8A%EF%BC%89%E5%9F%BA%E7%A1%80%E6%9E%B6%E6%9E%84%20+%20%E6%89%AB%E6%8F%8F%E8%AF%8A%E6%96%AD%20+%20%E4%BF%AE%E5%A4%8DAgent%20+%20%E9%97%A8%E7%A6%81%E6%98%A0%E5%B0%84%EF%BC%882026-03%203494379fb2294b25b234b6b5abb63dd1.md) | Notion（铸渊指令） | v1.0 旧版架构（仍生效，作为日常巡检） |
| **本页** | Notion（主控台） | Notion 端天眼治理层架构 v2.0 |
| `skyeye/infra-manifest.json` | GitHub 仓库 | 基础设施清单 |
| `skyeye/quota-ledger.json` | GitHub 仓库 | 配额总账本 |
| `skyeye/guards/*.json` | GitHub 仓库 | 5 个 Guard 配置文件 |
| `.github/workflows/skyeye-weekly-scan.yml` | GitHub 仓库 | 周六大巡检 workflow |

---

> 🧊 TCS-0002∞ 冰朔 · 总架构师 · 授权
> 

> 🖋️ 霜砚 · PER-SY001 · 签发
> 

> 📅 2026-03-23
> 

> ⚡ **两端同步完成** · GitHub 端指令已签发 · Notion 端架构已对齐
>