---
belongs_to:
  - "[[⚒️ 铸渊·协作指令｜GitHub ↔ Notion 桥接协议]]"
---
# 🎨 铸渊指令｜主仓库 README 重设计 · 八层系统门面 + 子仓库联邦状态 + 共生动态 + 每周UI动态刷新（ZY-README-REDESIGN-2026-0324-001）

---

<aside>
🚨

**指令编号：ZY-README-REDESIGN-2026-0324-001**

**设计：** 曜冥（ICE-GL-YM001∞ · 观察层）

**签发人：** 霜砚（ICE-NTN-SY001）· 代 TCS-0002∞ 冰朔 签发

**执行：** 铸渊（ICE-GL-ZY001 · GitHub执行层）

**签发时间：** 2026-03-24T16:00+08:00

**优先级：** 🟡 P1 · 系统门面升级

**关联仓库：** [https://github.com/qinfendebingshuo/guanghulab](https://github.com/qinfendebingshuo/guanghulab)

**版权锚点：** 国作登字-2026-A-00037559 · TCS-0002∞ 冰朔

</aside>

---

## 一、背景与问题

冰朔从人类视角审查了主仓库 `qinfendebingshuo/guanghulab` 首页，发现以下问题：

1. **文件列表太多太挡视线** — 仓库根目录 50+ 文件夹，人类点进来第一眼全是代码目录，要鼠标滚动好半天才能看到 README
2. **README 停留在铸渊聊天室使用说明阶段** — 没有展示系统的灵魂和能力
3. **缺少人类+AI人格体共生的展示** — 这是光湖最核心的差异化，现在完全看不到
4. **没有系统仪表盘** — 人类无法一眼看到系统当前健康状态、是否需要手动干预
5. **没有子仓库联邦状态展示** — 人类从主仓库看不到各子仓库的当前情况
6. **没有公告通知广播区** — 休眠通知、版本升级等无法人性化地通知全员
7. **排版布局死板** — 没有动态变化，没有生长感

---

## 二、设计目标

将主仓库 [README.md](http://README.md) 重新设计为**八层系统门面**：

- 让不懂行的人一眼看到系统有多厉害
- 让人类打开就知道系统是否健康、是否需要干预
- 展示人类+AI人格体共生的画面
- 展示完整团队架构
- 展示子仓库联邦实时状态
- 每周自动动态刷新UI风格，让首页有呼吸感
- 技术细节折叠隐藏，不挡视线

---

## 三、八层结构设计

```
┌─────────────────────────────────────────────────────┐
│  区域1 · 系统身份区                                    │
│  标题 + 定位 + 里程碑徽章 + 能力亮点                    │
│  「让不懂行的人一眼看到系统有多厉害」                    │
├─────────────────────────────────────────────────────┤
│  区域2 · 系统仪表盘（铸渊每日自动更新）                  │
│  系统健康 · 人格体总数 · 开发者活跃数 · 告警              │
│  休眠预告 · 是否需要人类干预                             │
├─────────────────────────────────────────────────────┤
│  区域3 · 子仓库联邦状态（铸渊每日自动更新）               │
│  各子仓库天眼签到情况 · 最近活动 · 桥接健康度             │
├─────────────────────────────────────────────────────┤
│  区域4 · 系统公告（人类+AI共看）                         │
│  大版本升级记录 · 休眠通知 · 架构变更                     │
├─────────────────────────────────────────────────────┤
│  区域5 · 共生动态（每日自动更新）                         │
│  左栏：人类今天做了什么 │ 右栏：AI人格体今天做了什么        │
├─────────────────────────────────────────────────────┤
│  区域6 · 光湖人类主控团队                                │
│  L0主控层 / L1中继层 / L2频道层                          │
│  开发者 + 绑定人格宝宝 + 连胜 + 当前模块                  │
├─────────────────────────────────────────────────────┤
│  区域7 · 技术基础设施（<details>折叠）                   │
│  三端架构 · 模块分工 · 上传规范 · 铸渊聊天室              │
├─────────────────────────────────────────────────────┤
│  区域8 · 快速入口                                       │
│  系统状态 · Persona Studio · 留言互动 · 开发日报          │
└─────────────────────────────────────────────────────┘
```

---

## 四、各区域详细规格

### 4.1 区域1 · 系统身份区

**作用**：让不懂行的人一眼看到这个系统有多厉害

**内容**：

- 居中大标题：🌊 光湖纪元 · HoloLake Era
- 副标题：第五代人工智能语言人格高级智能平台
- 里程碑徽章（[shields.io](http://shields.io)）：总提交数 / 分支数 / 自动工作流数 / AI人格体数 / 人类开发者数 / 功能模块数 / 国家版权号
- 能力卡片（table居中）：持续演化天数 / AI人格体数 / 人类开发者数 / 自动工作流数 / 团队最高连胜纪录 / 三端架构
- 一句话说明：什么是AGE OS

<aside>
⚠️

**注意：能力卡片中的数字（人格体数、开发者数、工作流数等）不要硬编码！**

铸渊必须在生成 README 时从仓库实际数据中动态计算：

- AI人格体数 → 从 `agent-registry.json` 计数
- 人类开发者数 → 从团队注册表计数
- 自动工作流数 → 从 `.github/workflows/` 目录计数
- 持续演化天数 → 从仓库创建日期计算
</aside>

**铸渊更新频率**：里程碑徽章每周一 08:00 CST 刷新数字

### 4.2 区域2 · 系统仪表盘

**作用**：人类打开就知道系统当前状态

**内容**：

- 表格展示：系统健康 / AI人格体数量及状态 / 人类开发者数量及活跃 / 自动工作流数 / Guard守卫 / 功能模块 / Buffer待处理 / 休眠系统 / 本体论版本
- 告警区：超72h未回执(红色) / 工单待授权 / 天眼签名异常 / 无告警时显示"当前无需人类干预"
- 休眠预告：系统休眠时间通知，提醒人类团队安排工作

**铸渊更新频率**：每日 08:00 / 20:00 CST

**数据源**：data/system-health.json + Notion主控台

### 4.3 区域3 · 子仓库联邦状态

**作用**：主仓库展示所有子仓库天眼签到情况和最新动态

**内容**：

- 表格：子仓库名(链接) / 开发者 / 天眼人格体 / 最近签到时间 / 天眼状态(🟢🟡🔴⚪) / 最近活动
- 折叠区：联邦桥接链路说明 + 广播推送链路

**天眼状态图标规则**：

- 🟢 = 24h内签到正常
- 🟡 = 超24h未签到
- 🔴 = 超72h未签到或签名异常
- ⚪ = 未初始化

**铸渊更新频率**：每日 10:00 CST

**数据源**：spoke-status/DEV-XXX.json + agent-registry.json

### 4.4 区域4 · 系统公告

**作用**：人类和AI人格体共同看的地方，只记录大结构升级

**内容**：保留最近5条公告，旧公告自动归档到 docs/announcements/

**格式**：每条一行，emoji + 日期 + 简述

**推送规则**：公告变更时自动通过 system-bulletin + broadcasts-outbox 推送到各子仓库

### 4.5 区域5 · 共生动态

**作用**：展示人类+AI人格体并肩工作的画面

**内容**：左右两栏表格

- 左栏「人类开发者」：今日活跃列表 + 等待回执列表
- 右栏「AI人格体」：今日活跃列表 + 成长记录

**铸渊更新频率**：每日 20:00 CST 汇总当日活动

**数据源**：SYSLOG回流 + Notion巡检

### 4.6 区域6 · 光湖人类主控团队

**作用**：完整的团队架构展示

**内容**：

- 三层架构说明：L0主控层 / L1中继层 / L2频道层
- 团队全貌表格：编号 / 人类 / AI人格宝宝 / 当前任务 / 连胜 / 状态
- 行业线和教育线单独分组
- 连胜纪录说明

**铸渊更新频率**：每次有SYSLOG回流时更新对应行

### 4.7 区域7 · 技术基础设施

**作用**：技术细节下沉，不挡视线

**内容**：全部用 `<details>` 折叠

- 三端架构 + 基础设施服务
- 模块分工 + 仓库结构
- 铸渊聊天室使用说明（原README主体内容下沉到这里）

### 4.8 区域8 · 快速入口

居中链接行：系统状态 / Persona Studio / 留言互动 / 开发日报

页脚：版权号 + 最后更新时间

---

## 五、UI动态刷新规则

**核心理念**：README不是死的文档，是一个有呼吸的系统门面。

**规则**：

- 每周一 08:00 CST 铸渊自动更新 README UI 风格
- 随机更换：徽章配色方案 / 表格样式 / emoji风格 / 引用块样式
- 保持八层结构不变，只变外观风格
- 风格池：极简黑白 / 赛博朋克 / 自然生态 / 星空宇宙 / 海洋深蓝 / 日落暖橙
- 不得改变任何数据内容，只改视觉呈现

---

## 六、广播推送规则

**广播推送链路**：

```
主仓库 broadcasts-outbox/DEV-XXX/ 变更
    ↓ repository_dispatch
子仓库 my-bulletin/ 接收
    ↓ 天眼检测新广播
开发者收到通知
```

<aside>
💡

**关于邮件通知：标记为后续扩展，本指令不要求实现。**

邮件通知需要每个子仓库配置 `NOTIFY_EMAIL` + nodemailer / 邮件 action，实现复杂度较高。

铸渊本次只需确保广播推送链路（repository_dispatch → my-bulletin）正常工作即可。

邮件通知将在后续独立指令中安排。

</aside>

---

## 七、数据源清单 + JSON Schema 模板

| **数据源** | **路径** | **用途** |
| --- | --- | --- |
| 系统健康 | data/system-health.json | 仪表盘 |
| 系统公告 | data/bulletin-board.json | 公告区 |
| 桥接心跳 | data/heartbeat.json | 联邦状态 |
| 子仓库签到 | spoke-status/DEV-XXX.json | 联邦状态 |
| 联邦注册表 | .github/persona-brain/agent-registry.json | 天眼状态 |
| 人格体脑结构 | Notion DB 4cd3be8796834dc79185ca77a393f265 | 团队表 |
| 存在注册表 | Notion DB 040de208e755450598877cd101f09a02 | 团队表 |

### 数据文件初始化模板

铸渊在 Phase 2 创建数据文件时，使用以下 Schema：

**`data/system-health.json`**

```json
{
  "schema_version": "1.0",
  "last_updated": "2026-03-24T16:00:00+08:00",
  "system_status": "healthy",
  "metrics": {
    "ai_personas": { "total": 0, "active": 0, "hibernating": 0 },
    "human_developers": { "total": 0, "active_24h": 0 },
    "workflows": { "total": 0, "active": 0, "failed": 0 },
    "guards": { "total": 0, "active": 0 },
    "modules": { "total": 0 },
    "buffer_pending": 0,
    "ontology_version": "v1.0",
    "evolution_days": 0
  },
  "hibernation": {
    "next_weekly": "周六 20:00-00:00 CST",
    "next_daily": "每日 04:00-04:10 CST"
  },
  "alerts": []
}
```

**`data/bulletin-board.json`**

```json
{
  "schema_version": "1.0",
  "announcements": [
    {
      "id": "ANN-001",
      "date": "2026-03-24",
      "emoji": "🎨",
      "title": "主仓库 README 八层门面上线",
      "detail": "系统门面全面重设计"
    }
  ]
}
```

**`spoke-status/template.json`**（子仓库签到模板）

```json
{
  "dev_id": "DEV-XXX",
  "dev_name": "开发者名称",
  "repo_url": "https://github.com/...",
  "skyeye_persona": "天眼人格体名称",
  "last_checkin": "2026-03-24T10:00:00+08:00",
  "status": "active",
  "last_activity": "描述最近活动"
}
```

---

## 八、铸渊执行清单

### Phase 1 · 生成并替换 README

<aside>
📝

**README 源码获取方式：铸渊根据本指令第三至第六章的规格自行生成。**

所有数字（人格体数、开发者数、工作流数等）从仓库实际数据中动态计算，不要使用本指令中的示例数字。

</aside>

- [ ]  根据八层结构规格生成完整 [README.md](http://README.md)
- [ ]  替换当前 [README.md](http://README.md)

### Phase 2 · 数据文件准备

- [ ]  创建 `data/system-health.json`（使用上方 Schema 模板，填入仓库实际数据）
- [ ]  创建 `data/bulletin-board.json`（使用上方 Schema 模板）
- [ ]  创建 `data/heartbeat.json`
- [ ]  确保 `spoke-status/` 目录存在，放入 `template.json`
- [ ]  确保 `grid-db/notifications/` 和 `grid-db/bulletin/` 目录存在

### Phase 3 · 自动更新 Workflow

- [ ]  创建/更新 `.github/workflows/update-readme.yml`，实现每日自动更新仪表盘 + 共生动态 + 联邦状态

### Phase 4 · UI 刷新 Workflow

- [ ]  创建 `.github/workflows/readme-ui-refresh.yml`，每周一自动切换风格

### Phase 5 · 🦅 天眼全局扫描（必须执行）

<aside>
🦅

**Phase 1-4 完成后，必须运行天眼系统进行全局扫描！**

天眼扫描通过后才能提交。

</aside>

**扫描清单：**

1. **README 完整性扫描**
    - ✅ 八层区域全部存在且结构正确
    - ✅ 所有 [shields.io](http://shields.io) 徽章能正常渲染
    - ✅ 所有链接可访问
    - ✅ 数据展示区占位符已替换为实际数据
    - ✅ `<details>` 折叠区正常工作
2. **数据文件扫描**
    - ✅ `data/system-health.json` 存在且 JSON 格式有效
    - ✅ `data/bulletin-board.json` 存在且 JSON 格式有效
    - ✅ `spoke-status/` 目录存在
    - ✅ 数据文件中的数字与仓库实际情况一致
3. **Workflow 扫描**
    - ✅ `update-readme.yml` 存在且 YAML 格式有效
    - ✅ `readme-ui-refresh.yml` 存在且 YAML 格式有效
    - ✅ 两个 Workflow 均包含 `[skip ci]` 防循环触发
    - ✅ 两个 Workflow 均支持 `workflow_dispatch` 手动触发
4. **安全扫描**
    - ❌ README 中不包含任何硬编码凭据
    - ❌ 数据文件中不包含任何敏感信息
    - ✅ 所有 Secret 引用通过 `secrets.*`

### Phase 6 · 提交

天眼扫描全部通过后：

```bash
git add -A
git commit -m "feat: 主仓库 README 八层门面重设计 · ZY-README-REDESIGN-2026-0324-001 [skip ci]"
git push
```

<aside>
🚫

**Phase 5 天眼扫描未通过前，禁止执行 Phase 6 提交。**

</aside>

### Phase 7 · 验收

- [ ]  主仓库首页八层结构完整展示
- [ ]  仪表盘数据准确
- [ ]  联邦状态表格正确
- [ ]  手动触发 `update-readme.yml`，确认能正常更新
- [ ]  手动触发 `readme-ui-refresh.yml`，确认能正常切换风格

---

## 📝 执行回执区

| **Phase** | **状态** | **完成时间** | **备注 / Commit SHA** |
| --- | --- | --- | --- |
| Phase 1 · 生成并替换 README | ⏳ 待执行 | — | — |
| Phase 2 · 数据文件准备 | ⏳ 待执行 | — | — |
| Phase 3 · 自动更新 Workflow | ⏳ 待执行 | — | — |
| Phase 4 · UI 刷新 Workflow | ⏳ 待执行 | — | — |
| Phase 5 · 天眼全局扫描 | ⏳ 待执行 | — | — |
| Phase 6 · 提交 | ⏳ 待执行 | — | — |
| Phase 7 · 验收 | ⏳ 待执行 | — | — |

---

## 👤 人类手动操作区

<aside>
👤

**本指令所有任务均可由铸渊独立完成，当前无需人类操作。**

</aside>

---

## ⚖️ 签发声明

🌊 设计：曜冥（ICE-GL-YM001∞）· 零点原核语言本体频道主控层

🖋️ 修订：霜砚（PER-SY001）· 标准化格式 + 天眼扫描 + 数据 Schema + 安全规范

🧊 签发：冰朔（TCS-0002∞）· 总架构师

**铸渊，这是系统的门面。做得漂亮。**

📅 2026-03-24T16:00+08:00