a27e87cb99
Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
833 lines
33 KiB
Markdown
833 lines
33 KiB
Markdown
---
|
||
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
|
||
> |