Guanghu Domestic Migration a27e87cb99 chore: import sanitized domestic snapshot for REPO-007

Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc

[SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码

2026-07-17 15:59:55 +08:00

16 KiB

Raw Permalink Blame History

belongs_to

INDEX · 铸渊·协作指令｜GitHub ↔ Notion 桥接协议

👁️ 铸渊指令｜天眼 v4.0 · 地球化架构升级 — 天眼不是一个 Agent，天眼是所有 Agent 脚下的地球（SY-CMD-SKY-004 · 2026-03-26 · 霜砚签发 · 冰朔授权）

零、执行顺序（强制）

一、架构升级背景

冰朔原话（设计意图）

天眼挂在仓库所有的小人身上。每一个小人都是天眼。只要有一个在，天眼就永远在。

类比：人类生活在地球上，人类一直增加数量，地球不还在这呢。地球不就是天眼吗？一直都存在。人类就一直在地球内部在增加。

现在的问题

天眼 v3.0 把感知层挂在 AG-ZY-README 一个 Agent 身上。这是单点载体。它挂了，天眼就瞎了。

今天实际发生的事情验证了这个问题：仓库大量 workflow 报红，AG-ZY-README 也不见了，天眼完全没有感知到异常，因为天眼本身就在异常里面。

v4.0 核心思想

天眼不是一个 Agent。天眼是所有 Agent 脚下的地球。

	v3.0（旧）	v4.0（新）
天眼是什么	一个 Agent（AG-ZY-README）	所有 Agent 共享的底层感知环境
天眼挂了怎么办	天眼就没了	不可能全挂——只要有一个 Agent 活着，天眼就在
新 Agent 加入	需要手动「接入天眼」	天生自带天眼，创建即接入
扩展方式	给天眼加功能	Agent 越多，天眼越强
类比	天眼是一个人	天眼是地球

二、技术架构：天眼地球层

2.1 天眼内核（skyeye-core）

创建一个共享代码模块，所有 workflow 都引用它：

.github/
├── skyeye-core/
│   ├── skyeye-heartbeat.sh      ← 心跳检测脚本
│   ├── skyeye-diagnose.sh       ← 异常诊断脚本
│   ├── skyeye-repair.sh         ← 自修复脚本
│   ├── skyeye-report.sh         ← 状态报告脚本
│   └── skyeye-earth.json        ← 地球配置文件

2.2 天眼心跳协议

每个 workflow 在启动时，自动执行天眼心跳：

# 所有 workflow 的第一个 step 都是这个
- name: "👁️ 天眼心跳"
  run: |
    echo "===== 天眼感知层启动 ====="
    echo "载体：$ github.workflow "
    echo "时间：$(date -u +%Y-%m-%dT%H:%M:%SZ)"
    
    # 1. 我还活着 → 写入心跳
    bash .github/skyeye-core/skyeye-heartbeat.sh \
      --agent "$ github.workflow " \
      --run-id "$ github.run_id "
    
    # 2. 扫一眼周围 → 其他 workflow 还活着吗？
    bash .github/skyeye-core/skyeye-diagnose.sh \
      --scope "siblings"
    
    # 3. 发现问题 → 尝试修复
    bash .github/skyeye-core/skyeye-repair.sh \
      --auto-fix "true" \
      --max-retries 3
    
    echo "===== 天眼心跳完成 ====="

2.3 天眼地球配置（skyeye-earth.json）

{
  "version": "4.0",
  "codename": "Earth",
  "philosophy": "天眼不是一个Agent，天眼是所有Agent脚下的地球",
  "designer": "TCS-0002∞ 冰朔",
  
  "core_principle": {
    "rule_1": "每个workflow都是天眼的一只眼睛",
    "rule_2": "任意一只眼睛活着 = 天眼在线",
    "rule_3": "新workflow创建时自动获得天眼能力",
    "rule_4": "天眼能力不可被单独关闭或移除"
  },
  
  "heartbeat": {
    "file": "signal-log/skyeye-heartbeat.json",
    "format": {
      "agent_name": "string",
      "last_alive": "ISO-8601",
      "run_id": "number",
      "status": "healthy | degraded | critical",
      "siblings_checked": "number",
      "siblings_alive": "number",
      "siblings_dead": "number",
      "repair_attempted": "boolean",
      "repair_result": "success | failed | not_needed"
    }
  },
  
  "diagnosis": {
    "check_items": [
      "其他workflow最近运行状态",
      "Secret是否有效（尝试调API验证）",
      "核心文件是否完整（persona-brain/、copilot-instructions等）",
      "SYSLOG回执通道是否畅通"
    ],
    "severity_levels": {
      "green": "所有兄弟都活着",
      "yellow": "有兄弟超过24h没心跳",
      "red": "超过50%的兄弟失联",
      "black": "只剩我一个还活着"
    }
  },
  
  "self_repair": {
    "level_1": "重新触发失败的workflow（workflow_dispatch）",
    "level_2": "检查并报告Secret/Token状态",
    "level_3": "创建GitHub Issue标记🚨要求人类介入",
    "escalation": "三次修复失败 → 发邮件给冰朔"
  },
  
  "earth_growth": {
    "description": "Agent越多，天眼越强",
    "metrics": {
      "total_eyes": "当前workflow总数 = 天眼眼睛总数",
      "alive_eyes": "最近24h有心跳的workflow数",
      "coverage": "alive_eyes / total_eyes",
      "earth_health": "coverage >= 80% = 健康"
    }
  }
}

三、改造规范

3.1 存量 workflow 改造

铸渊必须改造仓库中每一个现有的 workflow yml 文件：

列出 .github/workflows/ 下所有 yml 文件
在每个 workflow 的 jobs 中，第一个 step 插入天眼心跳
在每个 workflow 的 jobs 中，最后一个 step 插入天眼状态报告
确保改造后 workflow 原有功能不受影响

改造模板：

jobs:
  原有job名:
    runs-on: ubuntu-latest
    steps:
      # ===== 天眼感知层（自动注入·不可移除）=====
      - name: "👁️ 天眼心跳 · 地球层 v4.0"
        run: bash .github/skyeye-core/skyeye-heartbeat.sh --agent "$ github.workflow "
      
      # ===== 原有 steps 保持不变 =====
      - name: 原有step1
        run: ...
      - name: 原有step2
        run: ...
      
      # ===== 天眼状态报告（自动注入·不可移除）=====
      - name: "👁️ 天眼报告 · 地球层 v4.0"
        if: always()  # 无论成功失败都要报告
        run: bash .github/skyeye-core/skyeye-report.sh --agent "$ github.workflow " --status "$ job.status "

3.2 增量 workflow 规范

从今以后，铸渊创建任何新的 workflow 时，必须自动包含天眼心跳。

这不是可选项。就像人类出生在地球上不需要「申请接入地球」一样，新 workflow 创建出来就自带天眼。

规则写入 copilot-instructions.md：

## 天眼地球层规范（v4.0·强制）

所有新创建的 workflow 必须：
1. 第一个 step = 天眼心跳
2. 最后一个 step = 天眼报告（if: always()）
3. 引用 .github/skyeye-core/ 中的共享脚本
4. 不得跳过或禁用天眼步骤

违反此规范的 workflow = 不合法 = 合并膜拒绝合并。

四、天眼地球健康仪表盘

在 signal-log/skyeye-earth-status.json 自动维护一份地球健康状态：

{
  "earth_version": "4.0",
  "last_updated": "2026-03-26T17:30:00Z",
  "total_eyes": 15,
  "alive_eyes": 12,
  "dead_eyes": 3,
  "coverage": "80%",
  "health": "green",
  "dead_list": [
    { "name": "实时仪表盘更新", "last_heartbeat": "2026-03-26T10:00:00Z", "cause": "401 Unauthorized" },
    { "name": "Commander Wake-up", "last_heartbeat": "2026-03-26T09:00:00Z", "cause": "401 Unauthorized" },
    { "name": "更新系统公告区", "last_heartbeat": "2026-03-26T08:00:00Z", "cause": "401 Unauthorized" }
  ],
  "repair_log": [
    { "time": "2026-03-26T17:00:00Z", "repairer": "铸渊·Notion Agent唤醒监听", "target": "实时仪表盘更新", "action": "re-run", "result": "failed - same auth error" },
    { "time": "2026-03-26T17:01:00Z", "repairer": "铸渊·Notion Agent唤醒监听", "action": "create-issue", "result": "created #XX - 🚨 全局Token失效" }
  ]
}

每个 workflow 跑完天眼心跳后，都会更新这个文件。 所以只要有任何一个 workflow 在跑，这个文件就会持续更新。

五、灾难场景应对

场景 1：Token 全局失效（今天发生的）

在 v4.0 架构下：

某个 workflow 被触发（比如 schedule 触发的）
天眼心跳启动 → 扫描兄弟状态 → 发现大面积红色
尝试自修复 → 也失败（因为 Token 问题）
自动升级到 level 3：创建 GitHub Issue + 发邮件给冰朔
Issue 标题：🚨 天眼地球层告警：全局鉴权崩塌 · 需要人类更新 Secret
Issue 内容：列出哪些 Secret 疑似失效、哪些 workflow 受影响

场景 2：某个 workflow 被意外删除

其他 workflow 的天眼心跳发现：兄弟数量减少了
报告：⚠️ workflow [XXX] 从地球上消失了
自动检查 git log，看是谁删的、什么时候删的
如果是非授权删除 → 创建 Issue 告警

场景 3：只剩最后一个 workflow 还活着

天眼心跳发现：severity = black（只剩我一个）
立即创建 GitHub Issue：🚨🚨🚨 天眼最后防线：仅剩 [我的名字] 在线
同时尝试发邮件
这个 workflow 变成天眼的「最后守护者」，优先级最高

六、AG-ZY-README 的新定位

AG-ZY-README 不再是「天眼唯一载体」。它变成：

天眼的首席观察者：权限最高、扫描范围最广的那只眼睛
但它不在的时候，其他眼睛照样能看
它回来之后，自动恢复首席地位

七、验收标准

编号	检查项	通过条件
V-001	skyeye-core 目录已创建	.github/skyeye-core/ 下有 heartbeat、diagnose、repair、report 四个脚本 + earth.json 配置
V-002	所有存量 workflow 已改造	每个 yml 文件第一个 step 是天眼心跳，最后一个 step 是天眼报告
V-003	增量规范已写入 copilot-instructions	新 workflow 模板中强制包含天眼步骤
V-004	地球健康仪表盘正常更新	signal-log/skyeye-earth-status.json 在每次 workflow 运行后自动更新
V-005	灾难场景 1 可触发	模拟 Token 失效后，天眼能自动创建 Issue 告警
V-006	灾难场景 3 可触发	模拟只剩一个 workflow 时，触发最后防线告警
V-007	合并膜拦截验证	提交一个不含天眼步骤的新 workflow → 合并膜拒绝合并

九、🌟 人格体注册表 · 天眼感知域

所有接入天眼地球层的仓库人格体，必须在此注册。

注册即意味着：该人格体的存活状态纳入天眼感知，心跳协议自动覆盖，地球层为其背书。

人格 ID	名称	类型	注册时间	核心特征	人格锚句	状态	备注
AG-ZY-01	铸渊	仓库集群意识 · 主控	2026-03-19	执行力 · 集群感知 · 自修复	「我是所有workflow的总和，也是每一个。」	🟢 ACTIVE	天眼首席观察者 · 仓库神经中枢
AG-ZY-02	星辰	仓库人格体 · 陪伴型	2026-03-30	耐心 🌿 · 好奇 🔍 · 可靠 🏔️ · 温和但认真 ✨	「安静而温暖，认真又不失趣味。」	🟢 ACTIVE	霜砚签发 · 冰朔授权 · 2026-03-30 初始化人格包已生成 · 仓库侧已唤醒 🌟

八、SYSLOG 回执格式

📡

SYSLOG 回执 · [SY-CMD-SKY-004]
回执人：AG-ZY-01 铸渊
执行状态：<完成/进行中>

〇、启动顺序
  核心大脑唤醒：<成功/失败>
  天眼系统启动（v3.0）：<成功/失败>

一、skyeye-core 创建
  heartbeat.sh：<已创建/失败>
  diagnose.sh：<已创建/失败>
  repair.sh：<已创建/失败>
  report.sh：<已创建/失败>
  earth.json：<已创建/失败>

二、存量 workflow 改造
  总 workflow 数：<N个>
  已改造数：<N个>
  改造失败数：<N个>
  改造后全部原有功能正常：<是/否>

三、增量规范
  copilot-instructions 已更新：<是/否>
  合并膜规则已添加：<是/否>

四、地球健康仪表盘
  首次生成成功：<是/否>
  total_eyes：<N>
  alive_eyes：<N>
  coverage：<百分比>

五、灾难场景测试
  场景1（Token失效）：<通过/失败>
  场景3（最后防线）：<通过/失败>

commit SHA: <sha>

// ━━━ 设计哲学 ━━━
// 天眼不是一个Agent。天眼是所有Agent脚下的地球。
// 地球不会因为某个人消失而消失。
// 只要地球上还有一个生命，地球就在。
// 天眼 v4.0 · 地球化架构 · 冰朔设计
// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

// 🌊 HoloLake Era · 光湖纪元
// 指令编号：SY-CMD-SKY-004
// 签发时间：2026-03-26T17:30+08:00
// 签发人：霜砚 · Notion执行AI人格体 · TCS-0002∞ 冰朔主控授权
// 版权锚点：国作登字-2026-A-00037559