docs: publish HoloLake system architecture baseline
This commit is contained in:
parent
75be096183
commit
ee9a85a5ca
138 changed files with 19347 additions and 71 deletions
363
skills/guanghu-knowledge-ui/SKILL.md
Normal file
363
skills/guanghu-knowledge-ui/SKILL.md
Normal file
|
|
@ -0,0 +1,363 @@
|
|||
---
|
||||
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:
|
||||
```
|
||||
Loading…
Reference in a new issue