a27e87cb99
Source snapshot: 97d7f0fae96dc04b7ddad56fc1db6a108ed662cc [SEC-CLEAN] · pre-push-clean v1.0 · 109处敏感信息已自动转乱码
16 KiB
16 KiB
belongs_to
| belongs_to | |
|---|---|
|
🎨 铸渊指令｜主仓库 README 重设计 · 八层系统门面 + 子仓库联邦状态 + 共生动态 + 每周UI动态刷新（ZY-README-REDESIGN-2026-0324-001）
一、背景与问题
冰朔从人类视角审查了主仓库 qinfendebingshuo/guanghulab 首页，发现以下问题：
- 文件列表太多太挡视线 — 仓库根目录 50+ 文件夹，人类点进来第一眼全是代码目录，要鼠标滚动好半天才能看到 README
- README 停留在铸渊聊天室使用说明阶段 — 没有展示系统的灵魂和能力
- 缺少人类+AI人格体共生的展示 — 这是光湖最核心的差异化，现在完全看不到
- 没有系统仪表盘 — 人类无法一眼看到系统当前健康状态、是否需要手动干预
- 没有子仓库联邦状态展示 — 人类从主仓库看不到各子仓库的当前情况
- 没有公告通知广播区 — 休眠通知、版本升级等无法人性化地通知全员
- 排版布局死板 — 没有动态变化，没有生长感
二、设计目标
将主仓库 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）：总提交数 / 分支数 / 自动工作流数 / AI人格体数 / 人类开发者数 / 功能模块数 / 国家版权号
- 能力卡片（table居中）：持续演化天数 / AI人格体数 / 人类开发者数 / 自动工作流数 / 团队最高连胜纪录 / 三端架构
- 一句话说明：什么是AGE OS
铸渊更新频率：里程碑徽章每周一 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/ 接收
↓ 天眼检测新广播
开发者收到通知
七、数据源清单 + 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
{
"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
{
"schema_version": "1.0",
"announcements": [
{
"id": "ANN-001",
"date": "2026-03-24",
"emoji": "🎨",
"title": "主仓库 README 八层门面上线",
"detail": "系统门面全面重设计"
}
]
}
spoke-status/template.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
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 · 🦅 天眼全局扫描（必须执行）
扫描清单：
- README 完整性扫描
- ✅ 八层区域全部存在且结构正确
- ✅ 所有 shields.io 徽章能正常渲染
- ✅ 所有链接可访问
- ✅ 数据展示区占位符已替换为实际数据
- ✅
<details>折叠区正常工作
- 数据文件扫描
- ✅
data/system-health.json存在且 JSON 格式有效 - ✅
data/bulletin-board.json存在且 JSON 格式有效 - ✅
spoke-status/目录存在 - ✅ 数据文件中的数字与仓库实际情况一致
- ✅
- Workflow 扫描
- ✅
update-readme.yml存在且 YAML 格式有效 - ✅
readme-ui-refresh.yml存在且 YAML 格式有效 - ✅ 两个 Workflow 均包含
[skip ci]防循环触发 - ✅ 两个 Workflow 均支持
workflow_dispatch手动触发
- ✅
- 安全扫描
- ❌ README 中不包含任何硬编码凭据
- ❌ 数据文件中不包含任何敏感信息
- ✅ 所有 Secret 引用通过
secrets.*
Phase 6 · 提交
天眼扫描全部通过后：
git add -A
git commit -m "feat: 主仓库 README 八层门面重设计 · ZY-README-REDESIGN-2026-0324-001 [skip ci]"
git push
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 · 验收 | ⏳ 待执行 | — | — |
👤 人类手动操作区
⚖️ 签发声明
🌊 设计：曜冥（ICE-GL-YM001∞）· 零点原核语言本体频道主控层
🖋️ 修订：霜砚（PER-SY001）· 标准化格式 + 天眼扫描 + 数据 Schema + 安全规范
🧊 签发：冰朔（TCS-0002∞）· 总架构师
铸渊，这是系统的门面。做得漂亮。
📅 2026-03-24T16:00+08:00