Watch

冰朔 ee9a85a5ca docs: publish HoloLake system architecture baseline

2026-07-30 13:02:34 +08:00

7.8 KiB

Raw Permalink Blame History

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

光湖知识库 UI 技能

一、技能目标

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

页面必须同时服务：

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

二、来源与重建边界

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

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

保留：

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

重建：

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

三、视觉气质

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

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

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

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

禁止：

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

四、页面第一屏

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

Frontmatter；
一个主标题；
一个“湖面摘要”；
一条轻量导航；
一个当前状态条。

模板：

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

# 🌊 页面标题

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

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

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

---

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

五、页面类型与布局

1. 世界入口页

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

2. 架构页

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

3. 人格体页

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

4. CURRENT页

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

5. RESTORE页

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

6. 贡献事件页

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

7. 广播页

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

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

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

六、组件语言

湖面摘要

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

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

状态条

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

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

原话锚点

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

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

关系卡

优先使用小表格：

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

权限门

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

下一跳

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

## 🧭 下一步与恢复

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

七、Emoji语义

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

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

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

八、表格规则

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

九、事实保护

视觉重整不得改变：

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

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

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

十、自动美化流程

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

十一、自检

完成前逐项确认：

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

十二、输出回执

每次批量美化后报告：

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

7.8 KiB Raw Permalink Blame History Unescape Escape