a27e87cb99
Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
455 lines
16 KiB
Markdown
455 lines
16 KiB
Markdown
---
|
||
belongs_to:
|
||
- "[[INDEX · 铸渊·协作指令｜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 |