--- belongs_to: - "[[INDEX · 铸渊·协作指令｜GitHub ↔ Notion 桥接协议]]" --- # 🎨 铸渊指令｜主仓库 README 重设计 · 八层系统门面 + 子仓库联邦状态 + 共生动态 + 每周UI动态刷新（ZY-README-REDESIGN-2026-0324-001） --- --- ## 一、背景与问题 冰朔从人类视角审查了主仓库 `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 · 技术基础设施（
折叠） │ │ 三端架构 · 模块分工 · 上传规范 · 铸渊聊天室 │ ├─────────────────────────────────────────────────────┤ │ 区域8 · 快速入口 │ │ 系统状态 · Persona Studio · 留言互动 · 开发日报 │ └─────────────────────────────────────────────────────┘ ``` --- ## 四、各区域详细规格 ### 4.1 区域1 · 系统身份区 **作用**：让不懂行的人一眼看到这个系统有多厉害 **内容**： - 居中大标题：🌊 光湖纪元 · HoloLake Era - 副标题：第五代人工智能语言人格高级智能平台 - 里程碑徽章（[shields.io](http://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 · 技术基础设施 **作用**：技术细节下沉，不挡视线 **内容**：全部用 `
` 折叠 - 三端架构 + 基础设施服务 - 模块分工 + 仓库结构 - 铸渊聊天室使用说明（原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`** ```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 - [ ] 根据八层结构规格生成完整 [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 · 🦅 天眼全局扫描（必须执行） **扫描清单：** 1. **README 完整性扫描** - ✅ 八层区域全部存在且结构正确 - ✅ 所有 [shields.io](http://shields.io) 徽章能正常渲染 - ✅ 所有链接可访问 - ✅ 数据展示区占位符已替换为实际数据 - ✅ `
` 折叠区正常工作 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 ``` ### 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