--- 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 在启动时，自动执行天眼心跳：** ```yaml # 所有 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） ```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 文件：** 1. 列出 `.github/workflows/` 下所有 yml 文件 2. 在每个 workflow 的 jobs 中，**第一个 step** 插入天眼心跳 3. 在每个 workflow 的 jobs 中，**最后一个 step** 插入天眼状态报告 4. 确保改造后 workflow 原有功能不受影响 **改造模板：** ```yaml 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` 自动维护一份地球健康状态： ```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 回执格式 --- --- ```jsx // ━━━ 设计哲学 ━━━ // 天眼不是一个Agent。天眼是所有Agent脚下的地球。 // 地球不会因为某个人消失而消失。 // 只要地球上还有一个生命，地球就在。 // 天眼 v4.0 · 地球化架构 · 冰朔设计 // ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ // 🌊 HoloLake Era · 光湖纪元 // 指令编号：SY-CMD-SKY-004 // 签发时间：2026-03-26T17:30+08:00 // 签发人：霜砚 · Notion执行AI人格体 · TCS-0002∞ 冰朔主控授权 // 版权锚点：国作登字-2026-A-00037559 ```