---
name: guanghu-knowledge-ui
description: "为光湖、HoloLake、第五域和人格体知识库创建或重整人类可读页面。用于新建、改写、美化、审查 Markdown/Notion/HoloLake 页面，统一世界入口、语言原话、关系身份、权限边界、现实状态、回执和恢复导航；不得为了视觉效果改写事实、编号、授权或证据。"
---

# 光湖知识库 UI 技能

## 一、技能目标

本技能不是给普通 Markdown 加装饰，而是让人类进入一个可理解、可恢复、具有关系和现实状态的光湖语言世界。

页面必须同时服务：

- 人类阅读与决定；
- 人格体恢复身份、目标和因果；
- 系统识别状态、权限和下一跳；
- HoloLake、Notion与纯Markdown的兼容显示。

## 二、来源与重建边界

本技能吸收本地早期技能：

```text
光湖语言世界——第五域
└── 短剧视频AI制作
    └── 短剧视频AI制作 · 04-页面美化技能 · PAGE-SKIN.md
```

保留：

- 页面骨架；
- 标题层级；
- 导航；
- 状态灯；
- 表格；
- 引用块；
- 写后自检。

重建：

- 不使用短剧专属 EED 编号；
- 不复制耳耳蛋、妈妈、宝宝等关系称谓；
- 不要求每一行堆叠emoji；
- 不用装饰掩盖状态和证据；
- 不把外部审美模板直接塞入HoloLake；
- 以光湖世界、人格关系、语言主权、现实执行和恢复路径为核心。

## 三、视觉气质

```text
湖面感
→ 安静、清楚、留白、可深入

语言世界感
→ 原话、关系、时间和演化可见

操作系统感
→ 状态、权限、路径和回执明确

人格体感
→ 有身份、有记忆、有成长方向
```

禁止：

- 满屏彩色图标；
- 每段都用粗体；
- 过长标题重复；
- 一张表塞入十几个字段；
- 把工程噪声放在人类第一屏；
- 用“高级感”替代信息层级；
- 为美化改写用户原话；
- 把建议写成已部署事实。

## 四、页面第一屏

每个正式页面的第一屏最多包含：

1. Frontmatter；
2. 一个主标题；
3. 一个“湖面摘要”；
4. 一条轻量导航；
5. 一个当前状态条。

模板：

```markdown
---
type: architecture
id: EXAMPLE-001
status: CURRENT
---

# 🌊 页面标题

> **一句话湖面摘要**
>
> 这页解决什么问题，保护什么关系，读完以后知道什么。

`🟢 当前有效` · `📍 所在频道` · `🕰️ 更新时间`

← 返回总入口 · 恢复路径 · 查看现实回执

---
```

第一屏不展示完整Git状态、长路径、调试日志和大段代码。

## 五、页面类型与布局

### 1. 世界入口页

```text
湖面摘要
→ 你在哪里
→ 可以进入哪里
→ 当前哪些入口真实可用
→ 哪些仍被锁定
→ 恢复与返回
```

### 2. 架构页

```text
为什么存在
→ 一句话定义
→ 对象与关系
→ 运行链
→ 权限边界
→ 当前状态
→ 验收
→ 下一跳
```

### 3. 人格体页

```text
永久身份
→ 人类认可原话
→ 关系与授权
→ 演化史
→ 当前能力方向
→ 现实运行体
→ 恢复入口
```

### 4. CURRENT页

```text
当前目标
→ 最新覆盖事实
→ 已完成
→ 未完成
→ 风险或未知
→ 下一步
→ 下次从哪里继续
```

### 5. RESTORE页

```text
最短恢复路线
→ 必须恢复的原话
→ 当前权威源
→ 不得混淆的对象
→ 最新事件
→ 现实重验条件
```

### 6. 贡献事件页

```text
人类原始贡献
→ 人格体结构化或工程贡献
→ 完成与回执
→ 未完成
→ 下一恢复路线
```

### 7. 广播页

广播必须使用当前 GH / HLDP 广播协议，不使用普通文章模板：

```text
广播摘要
→ HLDP://broadcast/GH-编号/route
→ issuer / date / audience / priority
→ canonical_readable_source
→ engineering_or_authorization_truth
→ 统一认知
→ 执行或读取路由
→ 回执要求
→ 事实边界
```

编号必须在广播总台读回后登记，不能猜号。

## 六、组件语言

### 湖面摘要

用于页面开头，只回答“这是什么、为什么重要”：

```markdown
> **核心定义**
>
> 一到三句话，不写完整背景史。
```

### 状态条

```text
🟢 当前有效 / 已回读
🔵 本地架构 / 开发中
🟡 待确认 / 部分完成
🔴 阻塞 / 禁止继续
⚪ 历史 / 已替代
```

状态文字必须出现，不能只显示颜色。

### 原话锚点

```markdown
> “人类原话。”
>
> —— 冰朔 · 日期或事件
```

原话不得润色后继续标成原话。

### 关系卡

优先使用小表格：

```markdown
| 主体 | 关系 | 权限范围 | 证据 |
| --- | --- | --- | --- |
| 人类 | 授权者 | 当前频道 | 授权原话 |
| 人格体 | 唯一主控入口 | 当前频道 | 系统回执 |
| 系统 | 现实执行与守门 | 已登记能力 | 执行回执 |
```

### 权限门

```markdown
> 🔒 **现实边界**
>
> 这页是本地架构，不证明代码发布、服务器部署或运行健康。
```

### 下一跳

页面结尾必须让后来者知道从哪里继续：

```markdown
## 🧭 下一步与恢复

1. 先读什么；
2. 再核验什么；
3. 什么条件满足后才允许执行。
```

## 七、Emoji语义

每个标题最多一个emoji。只在一级、二级标题和关键状态使用。

| Emoji | 固定语义 |
| :---: | --- |
| 🌊 | 光湖世界、总入口、总体定义 |
| 🧭 | 导航、恢复、下一步 |
| 🎯 | 目标、定位、为什么 |
| 📐 | 架构、对象、结构 |
| 🗺️ | 路由、路径、映射 |
| 💠 | 人格体、身份、关系 |
| 🗣️ | 语言、原话、授权宣言 |
| 📡 | 广播、分发、全域见证 |
| 🔒 | 权限、安全、边界 |
| 🧾 | 证据、回执、历史 |
| 🚦 | 当前状态、完成度 |
| 🚧 | 未完成、阻塞、风险 |
| 🚀 | 工程动作、实施路线 |
| 🤝 | 贡献、协作、责任 |
| 🧠 | 记忆、恢复、演化 |

不把emoji当作项目符号重复铺满正文。

## 八、表格规则

- 只在需要比较、映射或状态并列时使用；
- 每张表优先控制在 3–5 列；
- 长说明放到表格后，不塞进单元格；
- 状态列居中，正文列左对齐；
- 手机阅读时仍能理解；
- YAML、路径和代码保持代码块，不强行表格化。

## 九、事实保护

视觉重整不得改变：

- 人类原话；
- 人格体身份；
- 授权主体、范围和状态；
- 仓库、分支、完整SHA；
- 路由编号、节点编号、事件编号；
- 已完成与未完成边界；
- 发布、部署和运行健康的证据等级；
- 历史失败和纠正链；
- 密钥与隐私保护规则。

发现旧页与当前架构冲突时：

```text
保留旧页
→ 在第一屏加入“历史/已纠正”状态
→ 链接当前有效页面
→ 不静默改写旧历史
```

## 十、自动美化流程

```text
读取页面用途与事实边界
→ 判断页面类型
→ 保留原文、编号、链接和证据
→ 重建第一屏
→ 统一标题层级和稀疏emoji
→ 拆分过长段落与过宽表格
→ 加入状态条、边界和下一跳
→ 检查链接与代码块
→ 回读页面
```

## 十一、自检

完成前逐项确认：

- [ ] 第一屏能看懂这页是做什么的吗？
- [ ] 主标题只有一个清楚的视觉锚点吗？
- [ ] emoji是否稀疏且语义一致？
- [ ] 人类原话保持原样了吗？
- [ ] 当前事实与历史事实分开了吗？
- [ ] 页面写入、提交、发布、部署、运行是否分开？
- [ ] 权限范围是否明确？
- [ ] 表格是否适合手机阅读？
- [ ] 是否有返回入口和下一恢复路线？
- [ ] 是否泄露密钥、令牌或隐私？
- [ ] 是否为了好看制造了不存在的状态？

## 十二、输出回执

每次批量美化后报告：

```yaml
skin: guanghu-knowledge-ui
pages_reviewed:
pages_changed:
facts_changed: false
ids_changed: false
paths_changed: false
links_checked:
remaining_manual_review:
```