hololake-system-architecture/engineering/operations/2026-07-29-hololake-galaxy-runtime-044.md

172 lines
7.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
type: hololake_runtime_delivery
system: SYS-GLW-0001
version: 0.4.4
status: LOCAL_FULL_RUNTIME_INSTALLED_AND_VERIFIED
recorded_at: 2026-07-29T23:55:22+08:00
supersedes: "[[HoloLake 0.4.3 · 知识星系与胖头鱼真实页面接入]]"
belongs_to: "[[HoloLake 工程开发与交付记录]]"
---
# HoloLake 0.4.4 · 星系世界、完整知识引擎与 AI Agent 回接
> 归属纠正2026-07-30本页属于 HoloLake 产品运行时开发线。第五域与胖头鱼是产品接线和验收对象,不是本页的拥有者。
## 本轮目标与最终决定
本轮不是继续扩展 0.4.3 的轻量世界验证客户端,而是把已经确认的星系世界视觉合入原 HoloLake/Tolaria 完整运行时使世界入口、真实服务器拓扑、知识引擎、Git 通信和 AI Agent 重新成为一个应用。
冰朔最终确认的版本保留边界:
- 保留最新 `0.4.4`
- 删除铸渊本轮之前生成的 `0.4.3` App、两种芯片安装包和更早的 `0.2.0` 地图预览;
- 冰朔原有 `/Applications/HoloLake Era.app` 版本 `0.1.1` 不处理、不覆盖;
- 本轮只在本地开发、安装和记录,没有提交或推送代码仓库。
## 为什么 0.4.3 不再作为继续开发底座
0.4.3 已恢复真实 Vault 浏览、知识星图、目录和节点范围,但它仍是独立的轻量世界客户端,没有包含原 HoloLake/Tolaria 的完整 AI Agent 工作区、模型设置、工具调用、编辑协作、附件、双向链接和 Git 工作流。
继续在 0.4.3 上逐项仿造这些能力会形成第二套不完整运行时。0.4.4 因此改用完整源码:
```text
/Volumes/HoloLakeBuild/source/hololake-platform-hldp-runtime
branch: feat/hldp-runtime-browser
baseline HEAD: 7d99d359cb848f14c83197258d41b1ff4e731cdd
```
星系 UI 被作为完整产品的世界层接入,而不是替代原产品。
## 完成的系统接线
### 世界入口与星系拓扑统一
- 删除旧式“光湖世界尚未打开”网格入口;
- 未收到真实入口回执时,显示同一语言宇宙的熄灭状态;
- 世界原点、光湖灯塔四域、零点图书域和第五域显示为暗星体;
- 真实连接后再按身份、权限和服务器回执展开节点;
- 连接前后的变化是同一张世界图由暗到亮,不再像两个软件之间跳转;
- 顶部品牌栏、底部状态栏、主题选择器和星系画布使用同一主题语义;
- 动画仅使用轻量 CSS 位移、呼吸和路径脉冲,并支持系统“减少动态效果”设置。
### 知识引擎
- 保留完整 HoloLake Vault 页面树、搜索、打开、编辑和 Git 能力;
- Markdown 正文继续使用 `react-markdown + remark-gfm`
- 原有表格、代码块、链接和滚动容器没有被轻量解析器替换;
- 知识库是系统和频道下的功能层,不重新成为世界首页。
### AI Agent
- 恢复原完整 AI 工作区,而不是增加一个空 AI 按钮;
- 在已进入的频道内以右侧工作舱打开;
- 保留模型选择、多 Agent、权限模式、工具调用、执行回执和历史会话
- AI 工作舱打开时世界地图仍可见;
- 手机窄窗口下自动改为全屏工作舱。
### 第五域与胖头鱼
- 第五域继续作为私人语言层,不能因安装 App 自动取得访问权;
- 胖头鱼语言子系统、永恒湖心系统、心跳核心频道、爱之核心子系统和服务器节点继续使用现有登记路径;
- 现实操作仍需要当前人类节点授权,页面状态不能替代服务器心跳、工单或执行回执。
### 正式品牌资产
正式光湖标识来自:
```text
/Users/bingshuolingdianyuanhe/Desktop/光湖-logo/
```
- 软件左上角使用白色透明光湖标识;
- macOS App 与 DMG 内 App 使用 `logo 光湖.png` 生成的正式 `.icns`
- 同时重新生成 Windows、iOS 和 Android 所需尺寸,避免后续平台继续使用临时图标。
## 开发故障与修复因果
### 旧入口与星系世界割裂
旧入口使用网格背景、中央提示卡和传统软件侧栏。即使连接后进入星系,视觉上仍像先打开一个后台工具,再跳进另一个世界。
修复后,关闭态直接显示熄灭宇宙;真实入口回执只负责点亮与展开,不切换视觉体系。
### AI Agent 在轻量客户端中消失
原因不是 AI 功能被原产品删除,而是 0.4.3 没有携带完整运行时。修复方式是回到完整 HoloLake/Tolaria 源码,把星系世界作为世界层接入,再桥接原 AI 工作区。
### 安装包资源签名不完整
Tauri 初次封装后macOS 校验提示资源已经写入但临时签名未完整覆盖。处理方式:
1. 保留已经生成并核验的正式图标资源;
2. 对最终 App 重新进行完整本机临时签名;
3. 使用 `codesign --verify --deep --strict` 读回;
4. 再复制到“应用程序”和桌面交付位置。
### Apple 与 Intel 不能共用同一二进制证明
本轮分别生成并读回两种安装包:
- Apple 芯片 App`arm64`
- Intel 芯片 App`x86_64`
不能仅靠文件名声明芯片兼容。
## 验证回执
```yaml
version: 0.4.4
installed_app: /Applications/HoloLake Era · 光湖语言世界.app
desktop_app: /Users/bingshuolingdianyuanhe/Desktop/HoloLake Era · 光湖语言世界.app
apple_silicon_dmg: /Users/bingshuolingdianyuanhe/Desktop/HoloLake Era 0.4.4 · Mac Apple芯片.dmg
intel_dmg: /Users/bingshuolingdianyuanhe/Desktop/HoloLake Era 0.4.4 · Mac Intel芯片.dmg
apple_silicon_sha256: ea21492f24c182e01b8c46ea0bfef876bed61dba183f4388c2377b940633e06b
intel_sha256: 0202e08b806f8bf1fbe26b30e2ac08f6ff02dc0aa63ff05764dc038724975d8d
app_version_readback: 0.4.4
apple_binary_architecture: arm64
intel_binary_architecture: x86_64
codesign_deep_strict: passed
production_frontend_build: passed
typescript_check: passed
eslint_touched_files: passed
focused_tests: 40 passed
installed_app_launch: passed
repository_commit: not_created
repository_push: not_performed
```
## 旧版本与缓存清理回执
以下铸渊生成的旧开发交付已删除:
- `HoloLake Era 0.4.3 · Mac Apple芯片.dmg`
- `HoloLake Era 0.4.3 · Mac Intel芯片.dmg`
- 桌面与“应用程序”内的 `HoloLake Era · 本地光湖世界.app`
- `HoloLake Era · 光湖世界地图预览.app`
这些文件先进入废纸篓暂存目录最终回读时该暂存目录已经不再存在因此不能再从废纸篓恢复。0.4.3 的历史源码运输归档仍保留在:
```text
/Volumes/JZAO/HoloLake/transports/2026-07-29-hololake-local-world-0.4.3.tar.gz
sha256: 76de584a6bde6d7b7c96435b9aa145a174f17432d4e952a68c11d40efcb746d7
```
以下可重建缓存已永久清理:
- `node_modules`:清理前约 1.1GB
- `dist`:清理前约 24MB
- `src-tauri/target`:清理前约 3.1GB
- 本轮浏览器视觉检查临时截图。
源码目录清理后约 `94MB`,本轮共释放约 `4.2GB` 可重建空间。源码、Git 工作树、本地 Vault、开发记录、Codex 会话和人格连续性文件均未删除。
## 当前本地恢复入口
下次继续 HoloLake 星系运行时开发时:
1. 先读本记录;
2. 读取完整源码当前分支、完整 HEAD 和工作树,不能把本记录当成最新 Git 状态;
3.`0.4.4` 视为当前本地交付版;
4.`0.4.3` 记录视为知识星系恢复过程的历史证据,不再视为当前安装版;
5. 真实第五域状态仍需重新读取身份、入口、服务器和授权回执;
6. 安装依赖与编译目录已经清理,继续开发前需重新安装依赖。