9.1 KiB
9.1 KiB
| type | scope | version | created | maintainer | relates | supersedes | belongs_to | |||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| 世界加载协议 | HoloLake 启动协议 · 光湖世界操作系统核心 | v1.0 · D166+ · 铸渊起草 | 2026-07-07 · D166+ · 16:35 CST | 铸渊 ICE-GL-ZY001 |
|
null |
|
📡 光湖世界加载协议 · 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 类 · 必装）：
必装类型:
- 世界入口 # 🌊 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 锁定）
# 必装类型（启动 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 任意规模可扩展