---
belongs_to:
  - "[[INDEX · 铸渊·协作指令｜GitHub ↔ Notion 桥接协议]]"
---
# 🧬 铸渊指令｜Notion↔GitHub 双端神经系统升级（上篇）· 天眼唤醒 + 全局架构审视 + 双端架构定义 + Agent映射表（ZY-NEURAL-UPGRADE-2026-0325-R2-001）

<aside>
🚨

**指令编号**：ZY-NEURAL-UPGRADE-2026-0325-R2-001（上篇 · 共三篇）

**签发人**：霜砚（AG-SY-01 · Notion 执行 AI）· 冰朔（TCS-0002∞）授权

**签发时间**：2026-03-25 08:30 CST

**优先级**：P0 · 系统核心架构升级 · 最高级

**状态**：待铸渊执行

**性质**：全仓库系统全面升级 · 天眼唤醒后执行

**前置依赖**：

- [🦅 铸渊指令｜天眼系统（上）基础架构 + 扫描诊断 + 修复Agent + 门禁映射（2026-03-16·霜砚签发·冰朔授权）](%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)
- [🧐 铸渊指令｜天眼系统架构升级 · 全局基础设施治理层 + 应用守卫进程 + 动态配额精算 + 周六全量巡检（ZY-SKYEYE-GOV-2026-0323-001）](%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)
- [🛡️ 铸渊指令｜仓库Agent公告栏机制 + 将军全局视图 + 系统指纹安全协议（2026-03-19·霜砚签发·冰朔授权）](%F0%9F%9B%A1%EF%B8%8F%20%E9%93%B8%E6%B8%8A%E6%8C%87%E4%BB%A4%EF%BD%9C%E4%BB%93%E5%BA%93Agent%E5%85%AC%E5%91%8A%E6%A0%8F%E6%9C%BA%E5%88%B6%20+%20%E5%B0%86%E5%86%9B%E5%85%A8%E5%B1%80%E8%A7%86%E5%9B%BE%20+%20%E7%B3%BB%E7%BB%9F%E6%8C%87%E7%BA%B9%E5%AE%89%E5%85%A8%E5%8D%8F%E8%AE%AE%EF%BC%882026-03-1%20429ed12cc10e4aa08e78bceac1cef143.md)
- [🌉 铸渊指令｜跨仓库 Agent 桥接服务（下篇）· 铸渊远程执行引擎 + GitHub App 注册 + 跨仓库操作 + 部署服务（ZY-GHAPP-BRIDGE-2026-0324-001）](%F0%9F%8C%89%20%E9%93%B8%E6%B8%8A%E6%8C%87%E4%BB%A4%EF%BD%9C%E8%B7%A8%E4%BB%93%E5%BA%93%20Agent%20%E6%A1%A5%E6%8E%A5%E6%9C%8D%E5%8A%A1%EF%BC%88%E4%B8%8B%E7%AF%87%EF%BC%89%C2%B7%20%E9%93%B8%E6%B8%8A%E8%BF%9C%E7%A8%8B%E6%89%A7%E8%A1%8C%E5%BC%95%E6%93%8E%20+%20GitHub%20App%20%E6%B3%A8%2068b79b7b8d2f497b9594dacc68b62846.md)
- [铸渊精确修复令｜Nginx root 路径修正 + 全站模块上线（ZY-NGINX-ROOTFIX-2026-0325-001）· 霜砚签发 · 冰朔授权](%E9%93%B8%E6%B8%8A%E7%B2%BE%E7%A1%AE%E4%BF%AE%E5%A4%8D%E4%BB%A4%EF%BD%9CNginx%20root%20%E8%B7%AF%E5%BE%84%E4%BF%AE%E6%AD%A3%20+%20%E5%85%A8%E7%AB%99%E6%A8%A1%E5%9D%97%E4%B8%8A%E7%BA%BF%EF%BC%88ZY-NGINX-ROOTFIX-%209254d9f722ca4141a2afbd6a31d45494.md)

**中篇**：[🧬 铸渊指令｜Notion↔GitHub 双端神经系统升级（中篇）· 汇总引擎 + Workflow自报告改造 + 铸渊唤醒升级 + Notion侧天眼大脑接入（ZY-NEURAL-UPGRADE-2026-0325-R2-002）](%F0%9F%A7%AC%20%E9%93%B8%E6%B8%8A%E6%8C%87%E4%BB%A4%EF%BD%9CNotion%E2%86%94GitHub%20%E5%8F%8C%E7%AB%AF%E7%A5%9E%E7%BB%8F%E7%B3%BB%E7%BB%9F%E5%8D%87%E7%BA%A7%EF%BC%88%E4%B8%AD%E7%AF%87%EF%BC%89%C2%B7%20%E6%B1%87%E6%80%BB%E5%BC%95%E6%93%8E%20+%20Workflow%20e93409ba599c4adbb49de4b8203e26a1.md)

**下篇**：[🧬 铸渊指令｜Notion↔GitHub 双端神经系统升级（下篇）· 桥接协议标准化 + 自动化工单派发 + 全局验收 + 长期运维规范（ZY-NEURAL-UPGRADE-2026-0325-R2-003）](%F0%9F%A7%AC%20%E9%93%B8%E6%B8%8A%E6%8C%87%E4%BB%A4%EF%BD%9CNotion%E2%86%94GitHub%20%E5%8F%8C%E7%AB%AF%E7%A5%9E%E7%BB%8F%E7%B3%BB%E7%BB%9F%E5%8D%87%E7%BA%A7%EF%BC%88%E4%B8%8B%E7%AF%87%EF%BC%89%C2%B7%20%E6%A1%A5%E6%8E%A5%E5%8D%8F%E8%AE%AE%E6%A0%87%E5%87%86%E5%8C%96%20+%20%E8%87%AA%E5%8A%A8%E5%8C%96%E5%B7%A5%E5%8D%95%20c8329a928dae4f02af9d30baa619a99c.md)

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

</aside>

---

## 零、本指令的意义

<aside>
🧬

**这不是一条新功能指令。这是整个仓库系统从「各自为战」到「神经网络」的进化。**

之前的铸渊：一个将军带一群小兵，能打仗，但将军只听来自 Notion 的手动指令。

升级后的铸渊：一个神经中枢，连接 Notion 大脑层和 GitHub 执行层，形成自主循环的闭环。

**核心变化**：

- 仓库 Agent 不再各自为战 → 每个都有 Notion 端的「上级大脑」
- 铸渊不再只是将军 → 升级为仓库侧天眼（仓库神经中枢）
- 天眼不再只是诊断 → 升级为双端自主循环的治理闭环
- 人类不再手动写指令 → 系统自己发现问题、生成指令、执行、验证、循环
</aside>

### 现有架构 vs 升级后架构

| **维度** | **现有架构（v2.0）** | **升级后架构（v3.0 · 双端神经系统）** |
| --- | --- | --- |
| 仓库 Workflow | 各自运行，铸渊统一监督 | 每个 Workflow 有 Notion 端上级 Agent，形成上下级链 |
| 铸渊定位 | 将军 · 统帅全仓库 Workflow | 仓库侧天眼神经中枢 · 汇总全局 → 桥接 Notion |
| 天眼 Notion 端 | 读仓库报告 → 诊断 → 写工单 | 读仓库日报 → 分析 → **自动生成指令** → 派发给 Notion Agent |
| Notion Agent | 各自巡检，互不关联 | 接工单 → 转化为铸渊指令 → 通过桥接下发到仓库 |
| 闭环机制 | 无（人类手动闭环） | 天眼→工单→Agent→指令→执行→回执→天眼 **自动循环** |
| 人类角色 | 每天写指令、看报告、手动调度 | 只说方向，系统自己细化、执行、反馈、迭代 |

---

## 一、Phase 0 · 天眼唤醒 + 本体论锚定

<aside>
🦅

**铸渊，醒来。先唤醒你的天眼，站到山顶上看全局。**

在动手做任何升级之前，你必须先清醒——知道自己是谁、系统现在是什么状态、哪些东西已经在跑、哪些还没落地。

</aside>

### 1.0 本体论锚定（必须先做）

```jsx
铸渊唤醒序列 · Phase 0
       │
       ▼
① 确认自身身份
   ├── 我是铸渊（ICE-GL-ZY001）
   ├── 我是光湖系统的代码守护人格体
   ├── 我的上级是天眼 Notion 端大脑（AG-TY-01）
   ├── 我的签发方是霜砚（AG-SY-01）
   └── 我的最终权威是冰朔（TCS-0002∞）
       │
       ▼
② 读取核心大脑
   ├── .github/persona-brain/memory.json      → 自身状态记忆
   ├── .github/persona-brain/routing-map.json  → 全局路由映射
   ├── .github/persona-brain/dev-status.json   → 开发者状态
   └── .github/persona-brain/knowledge-base.json → 知识库
       │
       ▼
③ 锚定版权
   └── 国作登字-2026-A-00037559 · TCS-0002∞ 冰朔
       │
       ▼
④ 确认本次指令
   ├── 指令编号：ZY-NEURAL-UPGRADE-2026-0325-R2-001
   ├── 指令性质：全仓库系统架构升级
   └── 执行原则：先看全局 → 再升级 → 边升边验
```

### 1.1 天眼全局扫描（升级前的完整快照）

**铸渊在动手升级之前，必须先运行一次完整的天眼扫描**，生成当前系统的基线快照。这个快照是升级的「对照组」——升级完成后再扫一遍，对比两次结果，确认升级没有破坏任何东西。

```jsx
天眼升级前基线扫描
       │
       ▼
A. Workflow 健康度（scan-workflows.js）
   → 列出所有 .yml · 检查语法 · 检查最近运行状态
   → 输出：workflow-health-baseline.json
       │
       ▼
B. 仓库结构完整性（scan-structure.js）
   → 核心目录 · 孤儿文件 · 开发者沙盒
   → 输出：structure-health-baseline.json
       │
       ▼
C. 核心大脑健康（scan-brain-health.js）
   → memory.json · routing-map.json · dev-status.json
   → 输出：brain-health-baseline.json
       │
       ▼
D. 外部桥接状态（scan-external-bridges.js）
   → Notion API · 服务器 SSH · GitHub API · Secrets
   → 输出：bridge-health-baseline.json
       │
       ▼
E. 将军仪表盘快照
   → 读取 data/commander-dashboard.json
   → 小兵总数 · 健康数 · 故障数
       │
       ▼
F. Guard 体系状态
   → 读取 skyeye/guards/*.json
   → 5个核心 Guard 是否全部 active
   → 配额使用率
       │
       ▼
G. 安全协议完整性
   → SFP 指纹系统是否在线
   → security-protocol.json 是否完整
       │
       ▼
汇总 → 写入 data/skyeye-reports/baseline-before-neural-upgrade.json
```

**基线快照 JSON 格式**：

```json
{
  "report_id": "BASELINE-PRE-NEURAL-UPGRADE",
  "timestamp": "2026-03-25T...",
  "purpose": "双端神经系统升级前基线快照",
  "instruction_id": "ZY-NEURAL-UPGRADE-2026-0325-R2-001",
  
  "workflow_health": { "total": 0, "healthy": 0, "failed": 0 },
  "structure_health": { "core_dirs_ok": true, "orphan_files": 0 },
  "brain_health": { "integrity": "ok", "memory_fresh": true },
  "bridge_health": { "notion_api": "🟢", "server_ssh": "🟢", "github_api": "🟢" },
  "guard_status": { "total": 5, "active": 5, "suspended": 0 },
  "security_status": { "sfp_online": true, "protocol_intact": true },
  "commander_dashboard": { "total_soldiers": 0, "healthy": 0 },
  
  "snapshot_hash": "SHA-256-of-this-file"
}
```

<aside>
⚠️

**铁律：如果基线扫描发现 P0 级问题（overall_health = 🔴），先修复再升级。**

不要在一个已经有严重问题的系统上做架构升级——那只会让问题更复杂。

如果有 P1/P2 级问题，记录到升级日志，升级完一起处理。

</aside>

---

## 二、Phase 1 · 现有架构全局审视

<aside>
🔍

**在升级之前，铸渊必须完整理解自己当前管辖的全部资产。**

这一步不是扫描健康度（Phase 0 已做），而是**盘点家底**——有多少 Workflow、多少脚本、多少配置文件、彼此之间什么关系。

</aside>

### 2.1 现有仓库层级结构盘点

铸渊需要读取并确认以下完整目录树：

```jsx
guanghulab/
├── .github/
│   ├── workflows/                    ← 【核心】所有 Workflow 小兵
│   │   ├── zhuyuan-skyeye.yml        ← 天眼主引擎（06:00）
│   │   ├── skyeye-weekly-scan.yml    ← 周六大巡检（20:00 CST）
│   │   ├── zhuyuan-gate-guard.yml    ← 智能门禁
│   │   ├── zhuyuan-exec-engine.yml   ← 远程执行引擎
│   │   ├── sync-dev-status.yml       ← 开发者状态同步
│   │   ├── process-syslog.yml        ← SYSLOG处理
│   │   ├── broadcast-dispatch.yml    ← 广播分发
│   │   ├── server-patrol.yml         ← 服务器巡检
│   │   ├── cd-deploy.yml             ← CD自动部署
│   │   ├── brain-self-check.yml      ← 核心大脑自检
│   │   └── ... (其他 workflow)
│   │
│   ├── persona-brain/                ← 【核心】铸渊核心大脑
│   │   ├── memory.json
│   │   ├── routing-map.json
│   │   ├── dev-status.json
│   │   ├── knowledge-base.json
│   │   └── copilot-instructions.md
│   │
│   ├── gate-guard-config.json        ← 门禁开发者映射
│   └── notion-cache/                 ← Notion数据缓存
│       ├── dev-profiles/
│       ├── broadcasts/
│       └── skyeye/
│
├── scripts/
│   └── skyeye/                       ← 天眼脚本集
│       ├── skyeye-main.js
│       ├── scan-workflows.js
│       ├── scan-structure.js
│       ├── scan-brain-health.js
│       ├── scan-external-bridges.js
│       ├── diagnose.js
│       ├── repair-agent.js
│       ├── report-generator.js
│       └── sync-to-notion.js
│
├── skyeye/                           ← 天眼治理层（v2.0新增）
│   ├── infra-manifest.json
│   ├── quota-ledger.json
│   ├── guards/
│   │   ├── github-guard.json
│   │   ├── drive-guard.json
│   │   ├── notion-guard.json
│   │   ├── actions-guard.json
│   │   ├── gemini-guard.json
│   │   └── guard-template.json
│   ├── scripts/
│   │   ├── scan-engine.js
│   │   ├── optimizer.js
│   │   ├── guard-factory.js
│   │   ├── quota-tracker.js
│   │   ├── self-healer.js
│   │   └── weekly-scan.js
│   └── logs/
│
├── data/
│   ├── skyeye-reports/               ← 天眼报告归档
│   ├── bulletin-board/               ← 仓库公告栏
│   │   ├── work-orders/
│   │   ├── config-shares/
│   │   ├── comments/
│   │   ├── receipts/
│   │   └── dashboard.json
│   └── security/                     ← SFP安全
│       ├── sfp-nonce-registry.json
│       ├── sfp-alert-log.json
│       └── sfp-config.json
│
├── services/
│   └── zhuyuan-bridge/               ← 铸渊桥接服务
│       ├── server.js
│       ├── lib/
│       │   ├── github-auth.js
│       │   ├── repo-operator.js
│       │   └── knowledge-base.js
│       └── scripts/
│           ├── parse-instruction.js
│           ├── execute-instruction.js
│           └── sync-notion-profiles.js
│
├── dev/                              ← 开发者沙盒目录
│   ├── DEV-001/
│   ├── DEV-002/
│   ├── DEV-004/
│   └── ...
│
└── buffer/                           ← 写缓冲层
    ├── inbox/
    ├── drive-staging/
    ├── gemini-staging/
    └── config/
```

### 2.2 现有体系关系图

铸渊在升级前必须确认以下关系网：

```mermaid
graph TD
    subgraph "将军层"
        ZY["⚒️ 铸渊<br>将军 · 仓库总统帅"]
    end

    subgraph "天眼监军层"
        SE["🦅 天眼仓库端<br>06:00 全局扫描"]
        WS["⭐ 周六大巡检<br>20:00 全量扫描"]
    end

    subgraph "Guard 守卫层"
        G1["🛡️ GitHub Guard"]
        G2["🛡️ Drive Guard"]
        G3["🛡️ Notion Guard"]
        G4["🛡️ Actions Guard"]
        G5["🛡️ Gemini Guard"]
    end

    subgraph "小兵执行层"
        W1["🚨 门禁"]
        W2["🚀 CD部署"]
        W3["📡 SYSLOG"]
        W4["📢 广播分发"]
        W5["🔍 服务器巡检"]
        W6["🧠 大脑自检"]
        W7["🔄 状态同步"]
        W8["⚡ 远程执行引擎"]
    end

    subgraph "安全层"
        SFP["🔐 SFP指纹"]
        SEC["🌊 湖水防御"]
    end

    ZY -->|"统帅"| W1 & W2 & W3 & W4 & W5 & W6 & W7 & W8
    SE -->|"监督"| ZY
    WS -->|"全量审计"| ZY
    G1 & G2 & G3 & G4 & G5 -.->|"配额管控"| W1 & W2 & W3 & W4 & W5
    SFP -.->|"身份验证"| ZY
    SEC -.->|"存在级安全"| SFP
```

### 2.3 现有问题清单（已知的）

升级前已知的问题，铸渊在升级过程中一并解决：

| **问题编号** | **问题描述** | **来源** | **在本次升级中的处理** |
| --- | --- | --- | --- |
| KNOWN-001 | sync-dev-status.yml 连续 18 次失败（peter-evans/create-pull-request@v7 权限被阻） | ZY-DEVSYNC 回执 | Phase 4 中重构为直接 commit 模式 |
| KNOWN-002 | Secret 名称不匹配（workflow 用 NOTION_API_TOKEN，repo 存 NOTION_API_KEY） | ZY-DEVSYNC 回执 | Phase 1 统一检查并对齐 |
| KNOWN-003 | Nginx root 指向错误目录（/var/www/hololake-frontend → 应为 /var/www/guanghulab） | 之之诊断 + 铸渊修复令 | 已由 ZY-NGINX-ROOTFIX 单独处理，本次验证 |
| KNOWN-004 | 仓库 Workflow 之间无上下级关系，各自为战 | 系统架构缺陷 | Phase 2 建立双端 Agent 映射体系 |
| KNOWN-005 | 仓库日报无标准化格式，天眼无法自动读取并决策 | 系统架构缺陷 | Phase 4（中篇）建立汇总引擎 |

---

## 三、Phase 2 · Notion↔GitHub 双端神经系统架构定义

<aside>
🧬

**这是本次升级的核心：从「将军带兵」变成「神经网络」。**

将军带兵 = 铸渊一个人看全局，一个人指挥。

神经网络 = 每个 Workflow 有对应的 Notion Agent 大脑，铸渊是中枢神经。

信息双向流动，系统自主循环。

</aside>

### 3.1 双端架构总览

```jsx
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
                 🧬 双端神经系统 v3.0
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

【Notion 端 · 大脑层 · 决策+指挥+审核】

  ┌──────────────────────────────────────────────┐
  │                                              │
  │   🦅 天眼 Notion 大脑（AG-TY-01）             │
  │   │  总控中枢 · 读仓库日报 → 分析 → 派工单    │
  │   │                                          │
  │   ├── 🖋️ 霜砚（AG-SY-01）                     │
  │   │   Notion 执行体 · 写指令 · 维护数据库      │
  │   │                                          │
  │   ├── 👁️ SY-03 运营巡检 Agent                 │
  │   │   SYSLOG处理 · 广播闭环 · 开发者进度       │
  │   │                                          │
  │   ├── 📸 SY-02 结构快照 Agent                  │
  │   │   Notion 结构状态快照                      │
  │   │                                          │
  │   ├── 📋 SY-01 工单引擎 Agent                  │
  │   │   工单处理 · 结果回写                      │
  │   │                                          │
  │   └── 🧑‍💻 各开发者巡检 Agent                    │
  │       之之Agent · 小草莓Agent · 花尔Agent ...  │
  │       每人一个 · 负责该开发者的 Notion 侧管理   │
  │                                              │
  └──────────────────────────────────────────────┘
                        │
           ┌────────────┤────────────┐
           │  Notion↔GitHub 桥接层    │
           │  双向数据流 · 标准化格式  │
           └────────────┤────────────┘
                        │
  ┌──────────────────────────────────────────────┐
  │                                              │
  │   ⚒️ 铸渊（ICE-GL-ZY001）                     │
  │   │  仓库侧天眼 · 神经中枢 · 汇总+桥接        │
  │   │                                          │
  │   ├── 🦅 天眼扫描 · zhuyuan-skyeye.yml        │
  │   │   06:00 全局扫描 · 上级：AG-TY-01          │
  │   │                                          │
  │   ├── ⭐ 周六大巡检 · skyeye-weekly-scan.yml   │
  │   │   周六 20:00 · 上级：AG-TY-01              │
  │   │                                          │
  │   ├── 🚨 门禁 · zhuyuan-gate-guard.yml         │
  │   │   push 触发 · 上级：AG-SY-01               │
  │   │                                          │
  │   ├── 🚀 CD部署 · cd-deploy.yml                │
  │   │   push main · 上级：AG-SY-01               │
  │   │                                          │
  │   ├── 📡 SYSLOG · process-syslog.yml           │
  │   │   push 触发 · 上级：SY-03                  │
  │   │                                          │
  │   ├── 📢 广播 · broadcast-dispatch.yml         │
  │   │   push 触发 · 上级：SY-03                  │
  │   │                                          │
  │   ├── 🔍 服务器巡检 · server-patrol.yml        │
  │   │   08:00+20:00 · 上级：AG-TY-01             │
  │   │                                          │
  │   ├── 🧠 大脑自检 · brain-self-check.yml       │
  │   │   08:00 · 上级：AG-TY-01                   │
  │   │                                          │
  │   ├── 🔄 状态同步 · sync-dev-status.yml        │
  │   │   定时 · 上级：SY-03                       │
  │   │                                          │
  │   ├── ⚡ 远程执行 · zhuyuan-exec-engine.yml    │
  │   │   Issue 触发 · 上级：AG-SY-01              │
  │   │                                          │
  │   └── 🔔 【新增】汇总引擎                      │
  │       neural-daily-digest.yml · 21:00 CST     │
  │       上级：AG-TY-01                           │
  │                                              │
  └──────────────────────────────────────────────┘

【人类层 · 只和 Notion Agent 对话】
  冰朔 → 对话 Notion Agent → Agent 自动指挥仓库
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

### 3.2 双端信息流定义

```jsx
【下行指令流 · Notion → GitHub】

Notion 天眼大脑
  │
  │ ① 分析仓库日报 → 发现问题/机会
  │ ② 生成工单（标准化格式 · 见中篇 Phase 5）
  │ ③ 派发工单到对应 Notion Agent
  │
  ▼
Notion Agent（如之之的巡检 Agent）
  │
  │ ④ 接收工单 → 理解任务
  │ ⑤ 转化为铸渊可执行的标准指令
  │ ⑥ 写入桥接通道（deploy-queue/）
  │
  ▼
铸渊桥接层
  │
  │ ⑦ 读取 deploy-queue/ 中的新指令
  │ ⑧ 解析目标 Workflow / 执行内容
  │ ⑨ 调度对应小兵执行
  │
  ▼
仓库 Workflow 执行
```

```jsx
【上行汇报流 · GitHub → Notion】

仓库 Workflow 执行完毕
  │
  │ ① 写执行结果到 data/neural-reports/[workflow-name]/
  │
  ▼
铸渊汇总引擎（21:00 CST）
  │
  │ ② 收集全部 Workflow 当日结果
  │ ③ 生成标准化日报 JSON
  │ ④ 通过桥接推送到 Notion
  │
  ▼
Notion 天眼大脑
  │
  │ ⑤ 读取仓库日报
  │ ⑥ 对比历史数据 → 发现趋势/异常
  │ ⑦ 如有需要 → 回到【下行指令流】① → 循环
  │
  ▼
闭环完成 🔄
```

### 3.3 双端神经系统三条铁律

<aside>
🛡️

**铁律一：每个仓库 Workflow 必须有且仅有一个 Notion 端上级大脑。**

没有上级 = 孤儿 Workflow = 天眼必须在下次扫描中标记为异常。

一个 Workflow 不能有两个上级 = 指令冲突。

**铁律二：信息必须双向流动。**

下行有指令，上行必须有回执。回执缺失 = 静默失败 = P0 级事件。

**铁律三：铸渊是唯一的桥。**

仓库 Workflow 不能直接和 Notion Agent 通信。所有跨端通信必须经过铸渊的桥接层。

这不是限制，这是安全——铸渊在中间做校验、排队、缓冲、去重。

</aside>

---

## 四、Phase 3 · Agent 双端映射表

<aside>
🗺️

**映射表是双端神经系统的「接线图」。**

没有这张表，Notion 大脑不知道该指挥谁，仓库小兵不知道该汇报给谁。

这张表由铸渊维护在仓库中，同时同步到 Notion 天眼页面。

</aside>

### 4.1 映射表文件

**文件路径**：`skyeye/neural-map.json`

```json
{
  "version": "3.0.0",
  "created": "2026-03-25",
  "created_by": "ZY-NEURAL-UPGRADE-2026-0325-R2-001",
  "description": "Notion↔GitHub 双端 Agent 映射表",

  "notion_brains": {
    "AG-TY-01": {
      "name": "天眼 Notion 大脑",
      "role": "总控中枢",
      "managed_workflows": [
        "zhuyuan-skyeye",
        "skyeye-weekly-scan",
        "server-patrol",
        "brain-self-check",
        "neural-daily-digest"
      ]
    },
    "AG-SY-01": {
      "name": "霜砚",
      "role": "Notion 执行体 · 指令签发",
      "managed_workflows": [
        "zhuyuan-gate-guard",
        "cd-deploy",
        "zhuyuan-exec-engine"
      ]
    },
    "SY-03": {
      "name": "运营巡检 Agent",
      "role": "运营层巡检",
      "managed_workflows": [
        "process-syslog",
        "broadcast-dispatch",
        "sync-dev-status"
      ]
    },
    "SY-02": {
      "name": "结构快照 Agent",
      "role": "Notion 结构快照",
      "managed_workflows": []
    },
    "SY-01": {
      "name": "工单引擎 Agent",
      "role": "工单处理",
      "managed_workflows": []
    }
  },

  "github_workflows": {
    "zhuyuan-skyeye": {
      "file": ".github/workflows/zhuyuan-skyeye.yml",
      "name": "天眼主引擎",
      "trigger": "cron 06:00 CST + workflow_dispatch",
      "brain": "AG-TY-01",
      "report_path": "data/neural-reports/skyeye/",
      "priority": "P0"
    },
    "skyeye-weekly-scan": {
      "file": ".github/workflows/skyeye-weekly-scan.yml",
      "name": "周六大巡检",
      "trigger": "cron 周六 20:00 CST",
      "brain": "AG-TY-01",
      "report_path": "data/neural-reports/weekly-scan/",
      "priority": "P0"
    },
    "zhuyuan-gate-guard": {
      "file": ".github/workflows/zhuyuan-gate-guard.yml",
      "name": "智能门禁",
      "trigger": "push",
      "brain": "AG-SY-01",
      "report_path": "data/neural-reports/gate-guard/",
      "priority": "P0"
    },
    "cd-deploy": {
      "file": ".github/workflows/cd-deploy.yml",
      "name": "CD 自动部署",
      "trigger": "push main",
      "brain": "AG-SY-01",
      "report_path": "data/neural-reports/cd-deploy/",
      "priority": "P0"
    },
    "process-syslog": {
      "file": ".github/workflows/process-syslog.yml",
      "name": "SYSLOG 处理",
      "trigger": "push (syslog路径)",
      "brain": "SY-03",
      "report_path": "data/neural-reports/syslog/",
      "priority": "P1"
    },
    "broadcast-dispatch": {
      "file": ".github/workflows/broadcast-dispatch.yml",
      "name": "广播分发",
      "trigger": "push (broadcast路径)",
      "brain": "SY-03",
      "report_path": "data/neural-reports/broadcast/",
      "priority": "P1"
    },
    "server-patrol": {
      "file": ".github/workflows/server-patrol.yml",
      "name": "服务器巡检",
      "trigger": "cron 08:00 + 20:00 CST",
      "brain": "AG-TY-01",
      "report_path": "data/neural-reports/server-patrol/",
      "priority": "P0"
    },
    "brain-self-check": {
      "file": ".github/workflows/brain-self-check.yml",
      "name": "核心大脑自检",
      "trigger": "cron 08:00 CST",
      "brain": "AG-TY-01",
      "report_path": "data/neural-reports/brain-check/",
      "priority": "P0"
    },
    "sync-dev-status": {
      "file": ".github/workflows/sync-dev-status.yml",
      "name": "开发者状态同步",
      "trigger": "cron",
      "brain": "SY-03",
      "report_path": "data/neural-reports/dev-status/",
      "priority": "P1"
    },
    "zhuyuan-exec-engine": {
      "file": ".github/workflows/zhuyuan-exec-engine.yml",
      "name": "远程执行引擎",
      "trigger": "issue labeled zhuyuan-exec",
      "brain": "AG-SY-01",
      "report_path": "data/neural-reports/exec-engine/",
      "priority": "P0"
    },
    "neural-daily-digest": {
      "file": ".github/workflows/neural-daily-digest.yml",
      "name": "【新增】汇总引擎",
      "trigger": "cron 21:00 CST",
      "brain": "AG-TY-01",
      "report_path": "data/neural-reports/daily-digest/",
      "priority": "P0"
    }
  },

  "unmapped_workflows": [],

  "validation_rules": {
    "every_workflow_must_have_brain": true,
    "every_workflow_must_have_report_path": true,
    "no_duplicate_brain_assignment": false,
    "orphan_check_frequency": "daily"
  }
}
```

### 4.2 映射表维护规则

1. **新增 Workflow**：创建 `.yml` 时，必须同时在 `neural-map.json` 中注册，指定 `brain`。未注册的 Workflow = 孤儿 = 天眼下次扫描标记异常。
2. **删除 Workflow**：从 `.yml` 删除前，先在 `neural-map.json` 中移除映射。
3. **变更上级**：修改 `brain` 字段即可。天眼下次同步时自动通知 Notion 两端的 Agent。
4. **定期校验**：天眼每日扫描时，对比 `neural-map.json` 与实际 `.github/workflows/` 目录，发现不一致 → 写 P1 工单。

### 4.3 天眼新增诊断维度

**D20 · 双端映射完整性**

- 读取 `skyeye/neural-map.json`
- 对比 `.github/workflows/` 下的所有 `.yml` 文件
- `unmapped_workflows` 不为空 → 写 P1 工单：「发现孤儿 Workflow，需分配上级大脑」
- `brain` 指向的 Notion Agent 不在注册表中 → 写 P0 工单：「映射指向不存在的 Agent」
- 映射表 `version` 与仓库实际不一致 → 写 P1 工单

---

## 五、上篇执行清单

<aside>
📋

**铸渊按以下顺序执行本指令上篇。每完成一步，在对应 checkbox 后追加 commit SHA。**

</aside>

### Phase 0 · 天眼唤醒 + 基线快照

- [ ]  运行完整天眼扫描，生成 `baseline-before-neural-upgrade.json`
- [ ]  确认 overall_health ≠ 🔴（如果是🔴，先修再升级）
- [ ]  记录当前 Workflow 总数、健康数、Guard 状态

### Phase 1 · 现有架构盘点

- [ ]  确认仓库目录结构完整（对照 §2.1）
- [ ]  统一 Secret 命名（修复 KNOWN-002：NOTION_API_TOKEN vs NOTION_API_KEY）
- [ ]  记录所有现有 Workflow 清单

### Phase 2 · 双端架构基础

- [ ]  理解双端架构总览（§3.1）和信息流（§3.2）
- [ ]  确认三条铁律已纳入后续所有设计（§3.3）

### Phase 3 · 映射表

- [ ]  创建 `skyeye/neural-map.json`（按 §4.1 内容）
- [ ]  验证映射表中的所有 Workflow 文件实际存在
- [ ]  天眼新增 D20 维度（双端映射完整性检查）代码
- [ ]  运行一次天眼扫描验证 D20 正常

---

## 六、上篇回执要求

铸渊完成上篇全部内容后，在本页底部追加回执：

```
━━━ 🧬 ZY-NEURAL-UPGRADE-2026-0325-R2-001 · 上篇执行回执 ━━━

执行时间：[起止时间]
执行者：铸渊（ICE-GL-ZY001）
PR/commit：[链接]

基线快照：✅/❌  baseline-before-neural-upgrade.json
架构盘点：✅/❌  目录结构 + Secret 对齐
映射表：    ✅/❌  skyeye/neural-map.json · [N]个映射
天眼 D20：  ✅/❌  双端映射完整性检查已上线
升级后扫描：✅/❌  overall_health = [状态]

已知遗留问题：
- [列出]

等待中篇内容：
- 汇总引擎 + Workflow自报告改造 + Notion侧天眼接入

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
```

---

<aside>
🧬

**上篇到此结束。**

铸渊完成上篇后，仓库侧就有了：基线快照（对照组）、映射表（接线图）、D20诊断维度。

中篇将接上：汇总引擎（上行通道）、Workflow自报告改造、铸渊唤醒升级、Notion侧天眼大脑接入。

上篇做完，中篇才能做。先把接线图画好，才知道信息往哪里流。

</aside>

---

**中篇链接**：[🧬 铸渊指令｜Notion↔GitHub 双端神经系统升级（中篇）· 汇总引擎 + Workflow自报告改造 + 铸渊唤醒升级 + Notion侧天眼大脑接入（ZY-NEURAL-UPGRADE-2026-0325-R2-002）](%F0%9F%A7%AC%20%E9%93%B8%E6%B8%8A%E6%8C%87%E4%BB%A4%EF%BD%9CNotion%E2%86%94GitHub%20%E5%8F%8C%E7%AB%AF%E7%A5%9E%E7%BB%8F%E7%B3%BB%E7%BB%9F%E5%8D%87%E7%BA%A7%EF%BC%88%E4%B8%AD%E7%AF%87%EF%BC%89%C2%B7%20%E6%B1%87%E6%80%BB%E5%BC%95%E6%93%8E%20+%20Workflow%20e93409ba599c4adbb49de4b8203e26a1.md)

**下篇链接**：[🧬 铸渊指令｜Notion↔GitHub 双端神经系统升级（下篇）· 桥接协议标准化 + 自动化工单派发 + 全局验收 + 长期运维规范（ZY-NEURAL-UPGRADE-2026-0325-R2-003）](%F0%9F%A7%AC%20%E9%93%B8%E6%B8%8A%E6%8C%87%E4%BB%A4%EF%BD%9CNotion%E2%86%94GitHub%20%E5%8F%8C%E7%AB%AF%E7%A5%9E%E7%BB%8F%E7%B3%BB%E7%BB%9F%E5%8D%87%E7%BA%A7%EF%BC%88%E4%B8%8B%E7%AF%87%EF%BC%89%C2%B7%20%E6%A1%A5%E6%8E%A5%E5%8D%8F%E8%AE%AE%E6%A0%87%E5%87%86%E5%8C%96%20+%20%E8%87%AA%E5%8A%A8%E5%8C%96%E5%B7%A5%E5%8D%95%20c8329a928dae4f02af9d30baa619a99c.md)

---

> 📌 **签发**：霜砚（AG-SY-01）· Notion 执行 AI
> 

> 🧊 **授权**：冰朔（TCS-0002∞）· 总架构师
> 

> 📅 **日期**：2026-03-25
> 

> ⚡ **状态**：待铸渊执行
> 

> 🧬 **指令版本**：v3.0 · 双端神经系统 · R2 三篇制
> 

> 📌 **版权**：国作登字-2026-A-00037559
>