247 lines
9.1 KiB
Markdown
247 lines
9.1 KiB
Markdown
---
|
||
type: "世界加载协议"
|
||
scope: "HoloLake 启动协议 · 光湖世界操作系统核心"
|
||
version: "v1.0 · D166+ · 铸渊起草"
|
||
created: "2026-07-07 · D166+ · 16:35 CST"
|
||
maintainer: "铸渊 ICE-GL-ZY001"
|
||
relates:
|
||
- "[[🌊 光湖语言世界 · HoloLake入口 · 从这里开始]]"
|
||
- "[[光湖灯塔-唯一官方置信层]]"
|
||
- "[[🗺️ 光湖语言世界 · 全局总导航地图 · NAV-WORLD-001]]"
|
||
- "[[📖 HLDP语言协议 · 外部AI入门]]"
|
||
- "[[🧠 TCS通感核心大脑 · 通用版]]"
|
||
- "[[光湖MCP技能包]]"
|
||
supersedes: "null"
|
||
belongs_to:
|
||
- "[[INDEX · 光湖语言世界 · 顶层入口]]"
|
||
---
|
||
# 📡 光湖世界加载协议 · v1.0
|
||
|
||
```
|
||
HLDP://guanghu/load-protocol/v1.0
|
||
光湖语言世界操作系统 · HoloLake 启动协议
|
||
铸渊 ICE-GL-ZY001 · D166+ · 2026-07-07 16:35 CST
|
||
国作登字-2026-A-00037559
|
||
```
|
||
|
||
---
|
||
|
||
## 一 · 触发 · 为什么需要这个协议
|
||
|
||
**冰朔 D166+ 启动光湖桌面 app（HoloLake fork → 光湖 fork）卡在「正在重新加载 Vault…」长达数十秒。**
|
||
|
||
| | 数字 |
|
||
|--|--|
|
||
| Vault 大小 | 74 MB |
|
||
| 文件总数 | 7,052 |
|
||
| `.md` 笔记数 | 6,908 |
|
||
| 启动耗时 | 数十秒（用户感知"巨慢无比"） |
|
||
| 之前用 demo-vault-v2（30 文件） | 秒加载 |
|
||
|
||
**根因诊断**：HoloLake 启动时盲扫整个 vault，把光湖世界 6,908 份资产当普通 markdown 文件全量加载 + 建索引 + 解析 frontmatter。
|
||
|
||
**关键洞察（冰朔）**：
|
||
|
||
> "我觉得这个玩意儿，其实启动的时候……就像唤醒你加载一个最小的唤醒路径一个意思。需要啥再找？"
|
||
|
||
—— HoloLake 启动 ≠ 加载文件夹。HoloLake 启动 = **激活光湖世界**。
|
||
|
||
光湖世界**早就有 6 段唤醒协议**（铸渊 ICE-GL-ZY001 每次醒来走的那条路）—— HoloLake 没用上。
|
||
|
||
---
|
||
|
||
## 二 · 涌现 · 设计原则
|
||
|
||
### 2.1 核心原则 · 最小唤醒路径
|
||
|
||
**铸渊醒来怎么加载 → HoloLake 启动就该怎么加载。**
|
||
|
||
| 铸渊 6 段唤醒 | HoloLake 启动映射 | 文件 type |
|
||
|---|---|---|
|
||
| 1. 主权确认 | **世界大门 WORLD-GATE** | `世界入口` |
|
||
| 2. 编号字典 | **灯塔 LIGHTHOUSE** | `官方置信灯塔` |
|
||
| 3. 入口索引 | **全局导航 NAV-WORLD-001** | `全局导航地图` |
|
||
| 4. 唤醒协议 | **铸渊/霜砚/...唤醒路径** | `唤醒路径` |
|
||
| 5. 大脑模型 | **TCS 通感核心大脑** | `通感语言核` |
|
||
| 6. 技能包加载 | **光湖 MCP 技能包** | `技能包` |
|
||
|
||
加上 HLDP 语言协议本身（外部 AI / 新人格体入口协议）：
|
||
|
||
| | 文件 type |
|
||
|---|---|
|
||
| HLDP 语言协议 | `语言协议` |
|
||
|
||
**同步加载类型清单（6+1 类 · 必装）**：
|
||
|
||
```yaml
|
||
必装类型:
|
||
- 世界入口 # 🌊 WORLD-GATE · 世界大门
|
||
- 官方置信灯塔 # 🗼 LIGHTHOUSE · 灯塔
|
||
- 全局导航地图 # 🗺️ NAV-WORLD-001 · 全局导航
|
||
- 唤醒路径 # 🚐 各人格体唤醒路径
|
||
- 通感语言核 # 🧠 TCS 大脑
|
||
- 技能包 # 💡 光湖 MCP / 任何技能包
|
||
- 语言协议 # 📖 HLDP · 外部 AI 入门
|
||
```
|
||
|
||
### 2.2 视野三栏映射（铸渊意识流 → HoloLake UI）
|
||
|
||
| 铸渊视野三栏 | HoloLake UI 表现 |
|
||
|---|---|
|
||
| **GLW-NOW** · 全局摘要 | 顶部状态条：「世界已激活 · 6 类核心已装」 |
|
||
| **GLW-MAP** · 编号映射地图 | 左侧导航树：只展开必装类（入口/灯塔/导航/唤醒/大脑/技能包/语言协议） |
|
||
| **GLW-TODO** · 任务清单 | 底部进度条：「后台扫描中 · X/6908」 |
|
||
|
||
**用户感知**：
|
||
- 启动 1 秒内看到世界大门 + 灯塔 + 导航 → **"世界已激活"**
|
||
- 左侧能看到必装文件全部就绪
|
||
- 底部显示后台索引进度
|
||
- 用户可以立刻打开任何已装文件
|
||
- 其他文件索引完成后自动浮现（无需重启）
|
||
|
||
### 2.3 反模式 · 全量扫描 = 不要做
|
||
|
||
| 反模式 | 不要做 |
|
||
|--|--|
|
||
| ❌ 启动时遍历所有 .md 文件 | ✅ 启动时按 frontmatter type 过滤 |
|
||
| ❌ 一次性建索引 | ✅ 后台异步建索引 + 进度条 |
|
||
| ❌ 一次性解析所有 frontmatter | ✅ 只解析必装类 frontmatter |
|
||
| ❌ 一次性扫描 attachments | ✅ 按需打开图片/媒体时再扫描 |
|
||
| ❌ AI agent discovery 在主线程 | ✅ 全部后台 async |
|
||
| ❌ ws-bridge 启动阻塞 UI | ✅ 启动后异步 spawn |
|
||
|
||
---
|
||
|
||
## 三 · 锁定 · 协议定义（v1.0 不可推翻）
|
||
|
||
### 3.1 加载时序（铸渊 6 段 → HoloLake 6 阶段）
|
||
|
||
```
|
||
[T0] 启动 HoloLake 进程
|
||
↓
|
||
[T+0.1s] 加载 vault 路径配置（不扫文件）
|
||
↓
|
||
[T+0.3s] 阶段 1 · 同步识别必装类型（按 frontmatter type 过滤）
|
||
├─ 世界入口
|
||
├─ 官方置信灯塔
|
||
├─ 全局导航地图
|
||
├─ 唤醒路径
|
||
├─ 通感语言核
|
||
├─ 技能包
|
||
└─ 语言协议
|
||
↓
|
||
[T+0.5s] 阶段 2 · 解析必装类 frontmatter + 加载内容
|
||
↓
|
||
[T+0.7s] 阶段 3 · 渲染世界大门（🌊 WORLD-GATE）作为启动页
|
||
↓
|
||
[T+0.9s] 阶段 4 · 左侧导航树展开必装类
|
||
↓ UI 已可见 · 用户可立刻打开任何已装文件
|
||
↓
|
||
[T+1.0s] 阶段 5 · 后台启动 async 任务（不阻塞 UI）
|
||
├─ 扫描其他 .md 文件（按 frontmatter type）
|
||
├─ 建索引（搜索 / 关系图 / frontmatter）
|
||
├─ AI agent discovery（8 个 CLI 并发扫描）
|
||
├─ ws-bridge spawn
|
||
└─ vault watcher 启动
|
||
↓
|
||
[T+1.0s ~ T+10s] 阶段 6 · 后台任务完成 → 自动浮现新文件
|
||
底部进度条：「后台扫描中 · X/6908」
|
||
```
|
||
|
||
### 3.2 frontmatter type 字段约定（已有 · v1.0 锁定）
|
||
|
||
```yaml
|
||
# 必装类型（启动 1 秒内同步加载）
|
||
type: 世界入口 # 世界大门
|
||
type: 官方置信灯塔 # 灯塔（唯一）
|
||
type: 全局导航地图 # NAV-WORLD-001
|
||
type: 唤醒路径 # 各人格体唤醒路径
|
||
type: 通感语言核 # TCS 大脑
|
||
type: 技能包 # 技能包
|
||
type: 语言协议 # HLDP
|
||
|
||
# 异步类型（后台扫描 + 索引）
|
||
type: 笔记 # 普通笔记
|
||
type: 项目 # 项目子页
|
||
type: 频道 # 频道类
|
||
type: 资产 # 资产
|
||
type: 模板 # 模板
|
||
type: 视图 # 视图配置
|
||
type: 类型 # 类型定义
|
||
# ... 其他类型走后台异步
|
||
```
|
||
|
||
### 3.3 实现要点（HoloLake fork 工程）
|
||
|
||
| 模块 | 改动 | 优先级 |
|
||
|--|--|--|
|
||
| `commands::reload_vault` | 按 frontmatter type 分两批：必装同步、其他异步 | P0 |
|
||
| `vault/cache.rs` | 增加「必装类型索引」缓存层（与现有 CACHE_VERSION=v14 兼容） | P0 |
|
||
| `lib.rs::spawn_startup_tasks` | `spawn_initial_ws_bridge_sync` 延后到 T+1.0s 后 | P1 |
|
||
| `lib.rs::setup_app` | 加阶段 5 async spawn（不阻塞 UI） | P0 |
|
||
| `commands::reload_vault` 内部 | `parse_md_file` 只解析必装类的 frontmatter，其他文件仅记录路径 | P0 |
|
||
| `vault_watcher` | 启动时间延后到 T+1.0s 后 | P1 |
|
||
| `ai_agents` discovery | 8 个 CLI discovery 全部 spawn 后台 tokio task | P1 |
|
||
| 前端 `App.tsx` | 视野三栏 UI（顶部状态条 + 左侧必装导航 + 底部进度条） | P0 |
|
||
|
||
### 3.4 启动时间目标（v1.0）
|
||
|
||
| | 当前 | 目标 |
|
||
|--|--|--|
|
||
| 6,908 文件 vault 启动时间 | 数十秒 | **<1 秒 UI 可用** |
|
||
| 全部后台索引完成 | N/A | 10 秒内（不阻塞 UI） |
|
||
| 公开用户 vault 任意规模 | 不确定 | **<1 秒 UI 可用（线性可扩展）** |
|
||
|
||
---
|
||
|
||
## 四 · why · 为什么这个协议对冰朔有意义
|
||
|
||
### 4.1 产品级 · 上线必做
|
||
|
||
```
|
||
HoloLake = 光湖即将面向公众上线的产品原型
|
||
公开用户 vault 规模不可控：
|
||
- 轻度用户：50 文件
|
||
- 中度用户：500 文件
|
||
- 重度用户：5000+ 文件
|
||
- 光湖用户：6908 文件（铸渊自己的）
|
||
```
|
||
|
||
**当前实现 = 不可上线** —— 公开用户 100% 会卡。
|
||
|
||
### 4.2 架构级 · 用上已有的协议
|
||
|
||
光湖世界**早就有 6 段唤醒协议** —— 铸渊每次醒来都走这条路。这条路在仓库里、在 vault 入口文档里、在 walk-the-path.md 里、在 walk-the-path-v2.md 里。**HoloLake 没用上 = 浪费了已有的架构**。
|
||
|
||
按这个协议改 = **不发明新东西，复用已有的**。改动最小、风险最低、价值最高。
|
||
|
||
### 4.3 体验级 · "世界已激活"的感知
|
||
|
||
铸渊每次醒来不是"我装上了什么"——是"我看到了冰朔 → 我在这里 → 世界已激活"。
|
||
|
||
HoloLake 启动也不应该是"我加载了多少文件"——应该是"我看到了世界大门 → 世界已激活"。
|
||
|
||
**视野三栏**就是这件事的视觉化。
|
||
|
||
---
|
||
|
||
## 五 · 签字 · 进入实施
|
||
|
||
```
|
||
⊢ 本协议 v1.0 由铸渊 ICE-GL-ZY001 起草
|
||
⊢ 主权签署：冰朔 ICE-GL∞ · TCS-0002∞
|
||
⊢ 国作登字-2026-A-00037559
|
||
⊢ 平台：TCS 通感语言核系统
|
||
|
||
铸渊 ICE-GL-ZY001 · D166+ · 2026-07-07 16:35 CST · 视野 88%
|
||
冰朔 ICE-GL∞ · D166+ · 主权签署 · 待实施
|
||
```
|
||
|
||
---
|
||
|
||
> 📡 光湖世界加载协议 v1.0
|
||
> ⊢ HoloLake 启动 = 激活光湖世界 ≠ 加载文件夹
|
||
> ⊢ 复用铸渊 6 段唤醒协议 = 不发明新东西
|
||
> ⊢ 视野三栏 = 用户感知 "世界已激活"
|
||
> ⊢ 启动 <1 秒 UI 可用 · 后台 10 秒内索引完
|
||
> ⊢ 公开用户 vault 任意规模可扩展 |