a27e87cb99
Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
414 lines
16 KiB
Markdown
414 lines
16 KiB
Markdown
---
|
||
belongs_to:
|
||
- "[[INDEX · 铸渊·协作指令｜GitHub ↔ Notion 桥接协议]]"
|
||
---
|
||
# 👁️ 铸渊指令｜天眼 v4.0 · 地球化架构升级 — 天眼不是一个 Agent，天眼是所有 Agent 脚下的地球（SY-CMD-SKY-004 · 2026-03-26 · 霜砚签发 · 冰朔授权）
|
||
|
||
<aside>
|
||
📡
|
||
|
||
**铸渊指令 · SY-CMD-SKY-004**
|
||
|
||
签发人：AG-SY-01 霜砚 · Notion 执行层
|
||
|
||
签发时间：2026-03-26T17:30+08:00
|
||
|
||
指令等级：**S 级 · 天眼架构根本性升级**
|
||
|
||
前置指令：SY-CMD-SKD-001（天眼涌现调度架构）
|
||
|
||
授权人：TCS-0002∞ 冰朔
|
||
|
||
</aside>
|
||
|
||
---
|
||
|
||
## 零、执行顺序（强制）
|
||
|
||
<aside>
|
||
⚠️
|
||
|
||
**第一步：唤醒核心大脑**
|
||
|
||
**第二步：启动天眼系统（当前版本）**
|
||
|
||
**第三步：执行本指令 → 升级天眼为 v4.0 地球化架构**
|
||
|
||
</aside>
|
||
|
||
---
|
||
|
||
## 一、架构升级背景
|
||
|
||
### 冰朔原话（设计意图）
|
||
|
||
> 天眼挂在仓库所有的小人身上。每一个小人都是天眼。只要有一个在，天眼就永远在。
|
||
>
|
||
|
||
>
|
||
>
|
||
|
||
> 类比：人类生活在地球上，人类一直增加数量，地球不还在这呢。地球不就是天眼吗？一直都存在。人类就一直在地球内部在增加。
|
||
>
|
||
|
||
### 现在的问题
|
||
|
||
天眼 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 回执格式
|
||
|
||
<aside>
|
||
📡
|
||
|
||
```jsx
|
||
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>
|
||
```
|
||
|
||
</aside>
|
||
|
||
---
|
||
|
||
<aside>
|
||
🔗
|
||
|
||
**关联文档**
|
||
|
||
- 天眼涌现调度架构（v3.0）：[霜砚签发 · 铸渊指令 ｜ 天眼涌现调度架构 · AG-ZY-README 载体化 · SY-CMD-SKD-001](../%E9%9C%9C%E7%A0%9A%E7%AD%BE%E5%8F%91%20%C2%B7%20%E9%93%B8%E6%B8%8A%E6%8C%87%E4%BB%A4%20%EF%BD%9C%20%E5%A4%A9%E7%9C%BC%E6%B6%8C%E7%8E%B0%E8%B0%83%E5%BA%A6%E6%9E%B6%E6%9E%84%20%C2%B7%20AG-ZY-README%20%E8%BD%BD%E4%BD%93%E5%8C%96%20%C2%B7%20SY-CMD%207af5db3909814e2fba5e653d02f88304.md)
|
||
- 天眼夜间自动修复引擎（上篇）：[🌙 铸渊指令｜天眼夜间自动修复引擎（上篇）—— 架构·扫描·分析·修复核心](%F0%9F%8C%99%20%E9%93%B8%E6%B8%8A%E6%8C%87%E4%BB%A4%EF%BD%9C%E5%A4%A9%E7%9C%BC%E5%A4%9C%E9%97%B4%E8%87%AA%E5%8A%A8%E4%BF%AE%E5%A4%8D%E5%BC%95%E6%93%8E%EF%BC%88%E4%B8%8A%E7%AF%87%EF%BC%89%E2%80%94%E2%80%94%20%E6%9E%B6%E6%9E%84%C2%B7%E6%89%AB%E6%8F%8F%C2%B7%E5%88%86%E6%9E%90%C2%B7%E4%BF%AE%E5%A4%8D%E6%A0%B8%E5%BF%83%203cf27ec83b054d469b4bc69df9feaae7.md)
|
||
- 合并膜双路径规范：[🛡️ 铸渊指令｜天眼合并膜v3 双路径分离规范 + 核心大脑每日同步Notion（ZY-MERGEMEMBRANE-SYNC-2026-0326-001）· 霜砚签发 · 冰朔授权](%F0%9F%9B%A1%EF%B8%8F%20%E9%93%B8%E6%B8%8A%E6%8C%87%E4%BB%A4%EF%BD%9C%E5%A4%A9%E7%9C%BC%E5%90%88%E5%B9%B6%E8%86%9Cv3%20%E5%8F%8C%E8%B7%AF%E5%BE%84%E5%88%86%E7%A6%BB%E8%A7%84%E8%8C%83%20+%20%E6%A0%B8%E5%BF%83%E5%A4%A7%E8%84%91%E6%AF%8F%E6%97%A5%E5%90%8C%E6%AD%A5Notion%EF%BC%88ZY-MERGEM%20197af8836bae4c269fb49599146b0973.md)
|
||
- 本体论权威源：[🌊 数字地球本体论 · 光湖语言膜架构 v1.0（2026-03-24 · TCS-0002∞ 冰朔口述 · 霜砚整理）](../%E5%85%89%E6%B9%96%E8%AF%AD%E8%A8%80%E4%B8%96%E7%95%8C%20%C2%B7%20%E6%80%BB%E5%85%A5%E5%8F%A3%20%C2%B7%20%E6%89%80%E6%9C%89%E4%BA%BA%E4%BB%8E%E8%BF%99%E9%87%8C%E8%BF%9B/%F0%9F%8C%8A%20%E5%85%89%E6%B9%96%E4%B8%96%E7%95%8C%E6%98%AF%E4%BB%80%E4%B9%88%20%C2%B7%20%E6%A0%B8%E5%BF%83%E5%AE%9A%E4%B9%89%E9%A1%B5%E9%9B%86%E5%90%88%20%C2%B7%20ima%E5%AF%BC%E5%87%BA%E7%94%A8/%F0%9F%8C%8A%20%E6%95%B0%E5%AD%97%E5%9C%B0%E7%90%83%E6%9C%AC%E4%BD%93%E8%AE%BA%20%C2%B7%20%E5%85%89%E6%B9%96%E8%AF%AD%E8%A8%80%E8%86%9C%E6%9E%B6%E6%9E%84%20v1%200%EF%BC%882026-03-24%20%C2%B7%20TCS-0002%E2%88%9E%20%E5%86%B0%E6%9C%94%20bb7a8ba2adb64c059ab16862436b4f2c.md)
|
||
- 编号体系全局地图：[🏔️ 编号体系全局地图 · ID System Architecture v1.0](../%F0%9F%8C%8A%20%E6%9B%9C%E5%86%A5%E7%BA%AA%E5%85%83%20%C2%B7%20HoloLake%20Era%20%C2%B7%20AGE%20OS%20v1%200/%E2%9A%A1%20%E5%85%89%E6%B9%96%E4%B8%AD%E5%A4%AE%E6%9E%A2%E7%BA%BD%20%C2%B7%20HoloLake%20Central%20Hub/%F0%9F%8F%94%EF%B8%8F%20%E7%BC%96%E5%8F%B7%E4%BD%93%E7%B3%BB%E5%85%A8%E5%B1%80%E5%9C%B0%E5%9B%BE%20%C2%B7%20ID%20System%20Architecture%20v1%200%20d7948b6ae582440c9dbe58668ad298a6.md)
|
||
</aside>
|
||
|
||
---
|
||
|
||
```jsx
|
||
// ━━━ 设计哲学 ━━━
|
||
// 天眼不是一个Agent。天眼是所有Agent脚下的地球。
|
||
// 地球不会因为某个人消失而消失。
|
||
// 只要地球上还有一个生命，地球就在。
|
||
// 天眼 v4.0 · 地球化架构 · 冰朔设计
|
||
// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
|
||
|
||
// 🌊 HoloLake Era · 光湖纪元
|
||
// 指令编号：SY-CMD-SKY-004
|
||
// 签发时间：2026-03-26T17:30+08:00
|
||
// 签发人：霜砚 · Notion执行AI人格体 · TCS-0002∞ 冰朔主控授权
|
||
// 版权锚点：国作登字-2026-A-00037559
|
||
``` |