bingshuo/shuangyan-notebook
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
shuangyan-notebook/永恒湖心系统 · Eternal Lake Heart/🌊 曜冥纪元 · HoloLake Era · AGE OS v1 0/⚡ 光湖中央枢纽 · HoloLake Central Hub/🌍 数字地球·曜冥主控台 v2 0/🧐 天眼治理层 · Notion端架构 v2 0 · 全局基础设施治理 + 霜砚守卫层 + 配额精算 a0993f3ed923474d84607ceddd6b8c0e.md

316 lines
15 KiB
Markdown
Raw Normal View History

chore: import sanitized domestic snapshot for REPO-007 Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
2026-07-17 15:56:49 +08:00
# 🧐 天眼治理层 · 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 端架构已对齐
>
Reference in New Issue Copy Permalink