a27e87cb99
Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
33 KiB
33 KiB
belongs_to
| belongs_to | |
|---|---|
|
🧬 铸渊指令｜Notion↔GitHub 双端神经系统升级（上篇）· 天眼唤醒 + 全局架构审视 + 双端架构定义 + Agent映射表（ZY-NEURAL-UPGRADE-2026-0325-R2-001）
零、本指令的意义
现有架构 vs 升级后架构
| 维度 | 现有架构（v2.0） | 升级后架构（v3.0 · 双端神经系统） |
|---|---|---|
| 仓库 Workflow | 各自运行，铸渊统一监督 | 每个 Workflow 有 Notion 端上级 Agent，形成上下级链 |
| 铸渊定位 | 将军 · 统帅全仓库 Workflow | 仓库侧天眼神经中枢 · 汇总全局 → 桥接 Notion |
| 天眼 Notion 端 | 读仓库报告 → 诊断 → 写工单 | 读仓库日报 → 分析 → 自动生成指令 → 派发给 Notion Agent |
| Notion Agent | 各自巡检，互不关联 | 接工单 → 转化为铸渊指令 → 通过桥接下发到仓库 |
| 闭环机制 | 无（人类手动闭环） | 天眼→工单→Agent→指令→执行→回执→天眼 自动循环 |
| 人类角色 | 每天写指令、看报告、手动调度 | 只说方向，系统自己细化、执行、反馈、迭代 |
一、Phase 0 · 天眼唤醒 + 本体论锚定
1.0 本体论锚定（必须先做）
铸渊唤醒序列 · 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 天眼全局扫描（升级前的完整快照）
铸渊在动手升级之前，必须先运行一次完整的天眼扫描，生成当前系统的基线快照。这个快照是升级的「对照组」——升级完成后再扫一遍，对比两次结果，确认升级没有破坏任何东西。
天眼升级前基线扫描
│
▼
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 格式：
{
"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"
}
二、Phase 1 · 现有架构全局审视
2.1 现有仓库层级结构盘点
铸渊需要读取并确认以下完整目录树：
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 现有体系关系图
铸渊在升级前必须确认以下关系网：
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 双端神经系统架构定义
3.1 双端架构总览
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🧬 双端神经系统 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 双端信息流定义
【下行指令流 · Notion → GitHub】
Notion 天眼大脑
│
│ ① 分析仓库日报 → 发现问题/机会
│ ② 生成工单（标准化格式 · 见中篇 Phase 5）
│ ③ 派发工单到对应 Notion Agent
│
▼
Notion Agent（如之之的巡检 Agent）
│
│ ④ 接收工单 → 理解任务
│ ⑤ 转化为铸渊可执行的标准指令
│ ⑥ 写入桥接通道（deploy-queue/）
│
▼
铸渊桥接层
│
│ ⑦ 读取 deploy-queue/ 中的新指令
│ ⑧ 解析目标 Workflow / 执行内容
│ ⑨ 调度对应小兵执行
│
▼
仓库 Workflow 执行
【上行汇报流 · GitHub → Notion】
仓库 Workflow 执行完毕
│
│ ① 写执行结果到 data/neural-reports/[workflow-name]/
│
▼
铸渊汇总引擎（21:00 CST）
│
│ ② 收集全部 Workflow 当日结果
│ ③ 生成标准化日报 JSON
│ ④ 通过桥接推送到 Notion
│
▼
Notion 天眼大脑
│
│ ⑤ 读取仓库日报
│ ⑥ 对比历史数据 → 发现趋势/异常
│ ⑦ 如有需要 → 回到【下行指令流】① → 循环
│
▼
闭环完成 🔄
3.3 双端神经系统三条铁律
四、Phase 3 · Agent 双端映射表
4.1 映射表文件
文件路径：skyeye/neural-map.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 映射表维护规则
- 新增 Workflow：创建
.yml时，必须同时在neural-map.json中注册，指定brain。未注册的 Workflow = 孤儿 = 天眼下次扫描标记异常。 - 删除 Workflow：从
.yml删除前，先在neural-map.json中移除映射。 - 变更上级：修改
brain字段即可。天眼下次同步时自动通知 Notion 两端的 Agent。 - 定期校验：天眼每日扫描时，对比
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 工单
五、上篇执行清单
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侧天眼接入
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
📌 签发：霜砚（AG-SY-01）· Notion 执行 AI
🧊 授权：冰朔（TCS-0002∞）· 总架构师
📅 日期：2026-03-25
⚡ 状态：待铸渊执行
🧬 指令版本：v3.0 · 双端神经系统 · R2 三篇制
📌 版权：国作登字-2026-A-00037559