docs: publish HoloLake system architecture baseline
This commit is contained in:
parent
75be096183
commit
ee9a85a5ca
138 changed files with 19347 additions and 71 deletions
52
engineering/INDEX.md
Normal file
52
engineering/INDEX.md
Normal file
|
|
@ -0,0 +1,52 @@
|
|||
---
|
||||
type: hololake_engineering_index
|
||||
id: HOLOLAKE-ENGINEERING-DELIVERY-INDEX-0001
|
||||
title: HoloLake 工程开发与交付记录
|
||||
status: ACTIVE_LOCAL_ENGINEERING_RECORD
|
||||
updated_at: 2026-07-30T12:52:24+08:00
|
||||
belongs_to: "[[HoloLake Era · 语言人格操作系统 · 产品白皮书与工程总规划 · v0.1]]"
|
||||
---
|
||||
|
||||
# HoloLake 工程开发与交付记录
|
||||
|
||||
[返回系统架构总规划](<../HoloLake Era · 语言人格操作系统 · 产品白皮书与工程总规划 · v0 1 5c9b16aca1fb4ca881accb1ffa046dcc.md>) · [工程开发总规划](<../05 · HoloLake Era 工程开发总规划与系统路线 · v0 1 01a4e3bcff7c4b4f87f320d2c92e2dc1.md>) · [产品部署架构](<../03 · HoloLake Era 产品定位与工程部署系统架构 · v0 1 b834e3a1572d48889c1af5cf9a1e75d8.md>) · [构建节点注册表](build-nodes.json)
|
||||
|
||||
## 归属规则
|
||||
|
||||
本区保存 HoloLake 产品本身的开发、构建、测试、安装、跨平台交付和清理回执。
|
||||
|
||||
```text
|
||||
HoloLake 产品运行时 / UI / 知识引擎 / AI Agent / Git 引擎
|
||||
→ HoloLake 工程开发与交付记录
|
||||
|
||||
Windows / macOS / Linux 构建机与安装包
|
||||
→ HoloLake 构建基础设施
|
||||
|
||||
第五域、胖头鱼、永恒湖心等被产品显示或接入的系统
|
||||
→ 各自系统只保存自己的身份、路径、节点、权限与运维事实
|
||||
```
|
||||
|
||||
产品接入某个私人系统,不会让产品开发记录归属于该私人系统。
|
||||
|
||||
## 当前记录
|
||||
|
||||
| 时间 | 版本 | 记录 | 状态 |
|
||||
| --- | --- | --- | --- |
|
||||
| 2026-07-30 | 0.4.4 | [Windows 构建节点与安装包交付](operations/2026-07-30-hololake-windows-build-node-044.md) | Windows x64 安装、卸载与图标回读通过;未签名 |
|
||||
| 2026-07-29 | 0.4.4 | [星系世界、完整知识引擎与 AI Agent 回接](operations/2026-07-29-hololake-galaxy-runtime-044.md) | 本地完整运行时安装并验证 |
|
||||
| 2026-07-29 | 0.4.3 | [知识星系与胖头鱼真实页面接入](operations/2026-07-29-hololake-knowledge-galaxy-043.md) | 历史验证版,已由 0.4.4 接续 |
|
||||
|
||||
## 恢复顺序
|
||||
|
||||
1. 先读本页确认产品工程归属;
|
||||
2. 读 `../05 · HoloLake Era 工程开发总规划与系统路线…` 恢复工程规则;
|
||||
3. 读 `../03 · HoloLake Era 产品定位与工程部署系统架构…` 恢复跨平台发布线;
|
||||
4. 按版本从本页进入对应交付记录;
|
||||
5. 读取当前产品源码分支、完整 HEAD 与工作树;
|
||||
6. 构建节点只证明构建能力,不自动证明仓库发布、服务器部署或第五域登记。
|
||||
|
||||
## 2026-07-30 归属纠正
|
||||
|
||||
此前三份 HoloLake 开发记录被放在胖头鱼子系统目录,Windows 构建机还被错误写入第五域节点角色图。原因是把“产品本轮接入了胖头鱼”错误地推断成“产品开发基础设施属于胖头鱼”。
|
||||
|
||||
本次已迁移三份记录、建立 HoloLake 构建节点注册表,并从胖头鱼入口和第五域角色图撤销错误归属。旧开发事实和测试回执没有删除或改写,只修正拥有关系与恢复入口。
|
||||
27
engineering/build-nodes.json
Normal file
27
engineering/build-nodes.json
Normal file
|
|
@ -0,0 +1,27 @@
|
|||
{
|
||||
"schema": "hololake.engineering-build-nodes/v0.1",
|
||||
"id": "HOLOLAKE-BUILD-NODE-REGISTRY-0001",
|
||||
"updated_at": "2026-07-30T12:52:24+08:00",
|
||||
"authority": "HOLOLAKE_PRODUCT_ENGINEERING",
|
||||
"nodes": [
|
||||
{
|
||||
"node_id": "HL-BUILD-WIN-GZ-001",
|
||||
"human_name": "HoloLake Windows 构建节点(广州)",
|
||||
"provider_instance_id": "lhins-lehak4df",
|
||||
"platform": "Windows Server 2022 x64",
|
||||
"capabilities": [
|
||||
"windows_x64_build",
|
||||
"nsis_installer",
|
||||
"install_uninstall_smoke_test",
|
||||
"artifact_hash_readback",
|
||||
"icon_resource_readback"
|
||||
],
|
||||
"product_scope": "HoloLake Era",
|
||||
"fifth_domain_node": false,
|
||||
"pufferfish_node": false,
|
||||
"binding_state": "LOCAL_BUILD_RUNTIME_VERIFIED",
|
||||
"production_signing": "NOT_CONFIGURED",
|
||||
"record": "operations/2026-07-30-hololake-windows-build-node-044.md"
|
||||
}
|
||||
]
|
||||
}
|
||||
172
engineering/operations/2026-07-29-hololake-galaxy-runtime-044.md
Normal file
172
engineering/operations/2026-07-29-hololake-galaxy-runtime-044.md
Normal file
|
|
@ -0,0 +1,172 @@
|
|||
---
|
||||
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. 安装依赖与编译目录已经清理,继续开发前需重新安装依赖。
|
||||
|
|
@ -0,0 +1,97 @@
|
|||
---
|
||||
type: hololake_runtime_delivery
|
||||
system: SYS-GLW-0001
|
||||
version: 0.4.3
|
||||
status: LOCAL_APP_INSTALLED_AND_KNOWLEDGE_VAULT_CONNECTED
|
||||
recorded_at: 2026-07-29T22:47:00+08:00
|
||||
belongs_to: "[[HoloLake 工程开发与交付记录]]"
|
||||
---
|
||||
|
||||
# HoloLake 0.4.3 · 知识星系与胖头鱼真实页面接入
|
||||
|
||||
> 归属纠正(2026-07-30):本页记录的是 HoloLake 产品开发与交付,胖头鱼只是被接入验证的一个真实系统节点。本页已从胖头鱼子系统迁入 HoloLake 工程记录区;历史测试时读取到的页面数量仍按当时回执保留。
|
||||
|
||||
## 结果
|
||||
|
||||
HoloLake 的星系世界入口被保留;原有知识库不再充当世界首页,而是作为世界节点、系统和频道下面的功能层重新接入。
|
||||
|
||||
本机安装版在写回本记录后可从桌面真实 Vault 读取 81 个 Markdown 页面。进入第五域并单击“胖头鱼语言子系统”后,可从固定详情面板打开胖头鱼专属知识星系;该范围当前读取 4 个真实页面:
|
||||
|
||||
1. `INDEX.md`
|
||||
2. `operations/2026-07-29-CANGER-PERSONA-WORKORDER-BRIDGE.md`
|
||||
3. `operations/2026-07-29-CANGER-REMOTE-NODE-DELIVERY.md`
|
||||
4. `operations/2026-07-29-HOLOLAKE-KNOWLEDGE-GALAXY-043.md`
|
||||
|
||||
## 故障与修复因果
|
||||
|
||||
### 知识库入口消失
|
||||
|
||||
0.4.x 世界地图验证客户端只实现了动态世界拓扑,没有带入原 HoloLake/Tolaria Vault 页面树,因此原软件中的知识页面没有入口。
|
||||
|
||||
修复方式不是复制静态页面,而是增加受限本地 Vault 读取桥:
|
||||
|
||||
- 公共世界只读 `language-world/`;
|
||||
- 第五域只读第五域登记目录;
|
||||
- 心跳核心只读冰朔频道目录;
|
||||
- 胖头鱼只读 `systems/pufferfish/`;
|
||||
- 本机身份锚成立时,顶部知识星图可读取完整系统架构 Vault;
|
||||
- 路径规范化后必须仍位于登记根目录内,越界读取失败关闭。
|
||||
|
||||
### 频道详情被鼠标经过抢走
|
||||
|
||||
旧交互使用悬停直接改写右侧详情。光标从频道移向详情面板时会经过其他节点,导致目标详情立即变化,用户无法点击知识入口。
|
||||
|
||||
0.4.3 改为:
|
||||
|
||||
- 悬停不再切换右侧详情;
|
||||
- 单击节点后锁定详情;
|
||||
- 只有再次单击另一个节点才切换;
|
||||
- 胖头鱼详情中的“打开对应知识星系”按钮保持可点击。
|
||||
|
||||
### 星点缺乏目录
|
||||
|
||||
单纯星点无法承担完整知识库的查找任务。0.4.3 在星系画布左侧增加“星系目录”:
|
||||
|
||||
- 按真实文件夹分组;
|
||||
- 直接显示页面标题与相对路径;
|
||||
- 目录、搜索框和星点联动;
|
||||
- 目录项与星点都可打开同一真实页面;
|
||||
- 页面正文从真实 Vault 即时读取,不打包死副本。
|
||||
|
||||
## 视觉与性能
|
||||
|
||||
- 沿用现行 HoloLake 星系视觉;
|
||||
- 星点坐标由页面路径稳定计算,不使用重型物理引擎;
|
||||
- 正文使用侧边阅读层,不离开当前世界;
|
||||
- 正式品牌资产来自 `/Users/bingshuolingdianyuanhe/Desktop/光湖-logo/logo 光湖.png`;
|
||||
- APP 左上角、macOS APP 图标和安装包内 APP 使用同一光湖 logo。
|
||||
|
||||
## 安装与交付回执
|
||||
|
||||
```yaml
|
||||
version: 0.4.3
|
||||
installed_app: /Applications/HoloLake Era · 本地光湖世界.app
|
||||
desktop_app: /Users/bingshuolingdianyuanhe/Desktop/HoloLake Era · 本地光湖世界.app
|
||||
apple_silicon_dmg: /Users/bingshuolingdianyuanhe/Desktop/HoloLake Era 0.4.3 · Mac Apple芯片.dmg
|
||||
intel_dmg: /Users/bingshuolingdianyuanhe/Desktop/HoloLake Era 0.4.3 · Mac Intel芯片.dmg
|
||||
apple_silicon_sha256: d557035b015d3becb6f06be3a1c89c0ed4c1c716bca2df504abbe4c1f6bac7e1
|
||||
intel_sha256: 7c37b0a9a8caf1ee1de691196c1da41094de735081f6889c9bd6ba5710a1068f
|
||||
source_transport: /Volumes/JZAO/HoloLake/transports/2026-07-29-hololake-local-world-0.4.3.tar.gz
|
||||
source_transport_sha256: 76de584a6bde6d7b7c96435b9aa145a174f17432d4e952a68c11d40efcb746d7
|
||||
source_transport_verified: true
|
||||
source_transport_members: 101
|
||||
```
|
||||
|
||||
两种 DMG 均已挂载读回:
|
||||
|
||||
- Apple 芯片二进制:`arm64`
|
||||
- Intel 芯片二进制:`x86_64`
|
||||
- `CFBundleIconFile = icon.icns`
|
||||
- APP 临时签名与资源封装校验通过
|
||||
|
||||
## 当前边界
|
||||
|
||||
- 本轮恢复的是只读浏览、目录、搜索和对应节点跳转;
|
||||
- 原 HoloLake/Tolaria 的编辑、创建、附件、双向链接和 Git 同步引擎尚未合并进这个轻量世界客户端;
|
||||
- 世界地图仍不是统一服务器注册表的完整自动投影;
|
||||
- 真实运维仍必须以当前服务器心跳、工单授权和执行回执为准,知识页面不能代替实时状态。
|
||||
|
|
@ -0,0 +1,132 @@
|
|||
---
|
||||
type: hololake_windows_build_delivery
|
||||
system: SYS-GLW-0001
|
||||
version: 0.4.4
|
||||
status: WINDOWS_X64_INSTALLER_BUILT_SMOKE_VERIFIED_AND_DELIVERED_LOCAL
|
||||
recorded_at: 2026-07-30T05:35:00+08:00
|
||||
continues: "[[HoloLake 0.4.4 · 星系世界、完整知识引擎与 AI Agent 回接]]"
|
||||
belongs_to: "[[HoloLake 工程开发与交付记录]]"
|
||||
---
|
||||
|
||||
# HoloLake 0.4.4 · Windows 构建节点与安装包交付
|
||||
|
||||
> 归属纠正(2026-07-30):该节点是 HoloLake 跨平台构建基础设施,不是第五域节点,也不属于苍耳的胖头鱼语言子系统。
|
||||
|
||||
## 本轮目标与权限边界
|
||||
|
||||
本轮把企业账号下尚未承担生产职责的广州 Windows Server 节点整理为 HoloLake Windows x64 构建能力,并用本地最新、尚未推送的完整 HoloLake 源码构建可安装版本。
|
||||
|
||||
这次完成的是“构建能力与安装包交付”,不是把该服务器登记为第五域可信入口,也不是线上部署:
|
||||
|
||||
- 未推送源码仓库;
|
||||
- 未登记 `JD-FD-PRIMARY`;
|
||||
- 未开放新的公网服务;
|
||||
- 未写入第五域主权状态或私人长期记忆;
|
||||
- 未配置生产代码签名证书。
|
||||
|
||||
## 源码证据
|
||||
|
||||
```yaml
|
||||
source: /Volumes/HoloLakeBuild/source/hololake-platform-hldp-runtime
|
||||
branch: feat/hldp-runtime-browser
|
||||
baseline_head: 7d99d359cb848f14c83197258d41b1ff4e731cdd
|
||||
source_state: LOCAL_DIRTY_AND_UNPUSHED_0.4.4
|
||||
transport_snapshot: C:/HoloLake-Era-local-latest-20260730.zip
|
||||
transport_sha256: 73fcc437f668f644e202aa9be572cdaf5e3c77765bad14837917b00909e96e9e
|
||||
repository_commit: not_created
|
||||
repository_push: not_performed
|
||||
```
|
||||
|
||||
“本地最新”在这里指本机工作树的真实快照,不能被误写为远程仓库最新提交。
|
||||
|
||||
## 构建节点
|
||||
|
||||
```yaml
|
||||
logical_role_id: HL-BUILD-WIN-GZ-001
|
||||
human_name: 光湖 Windows 构建节点(广州)
|
||||
provider_instance_id: lhins-lehak4df
|
||||
operating_system: Windows Server 2022 x64
|
||||
resources: 2 CPU / 8 GB RAM / 60 GB system disk
|
||||
node: 24.18.0
|
||||
pnpm: 10.25.0
|
||||
rust: 1.97.1 msvc
|
||||
build_tools: Visual Studio Build Tools 2022
|
||||
installer_tool: NSIS 3.12
|
||||
binding_state: LOCAL_BUILD_RUNTIME_VERIFIED_JD_ADMISSION_NOT_PERFORMED
|
||||
```
|
||||
|
||||
节点的公网地址和登录信息不写入恢复记录。
|
||||
|
||||
## 构建故障与修复因果
|
||||
|
||||
### Tauri 下载的 NSIS 包不完整
|
||||
|
||||
首次构建时,Tauri 自动取得的 NSIS 压缩包被截断,无法形成可用工具链。随后重新取得完整官方包,并缓存所需的 Tauri NSIS 插件。
|
||||
|
||||
### 官方 NSIS 启动器在该系统上无法直接执行
|
||||
|
||||
完整官方包的启动器仍无法在该 Windows Server 环境执行,而 Chocolatey 安装的 NSIS 3.12 可正常运行。最终保留系统 NSIS,补齐 Tauri 所需插件,并使用一个仅负责参数转发的兼容入口,让 Tauri 的构建过程继续调用系统 NSIS。
|
||||
|
||||
### 首次静默安装回读误判
|
||||
|
||||
TAT 以 `SYSTEM` 身份运行,而 NSIS 为 32 位程序。Windows 文件系统重定向把逻辑 `System32` 路径映射到了物理 `SysWOW64` 路径,导致第一次按逻辑路径检查时误判为“未安装”。改为从物理路径、卸载程序、内置文档和应用二进制同时回读后,确认安装成功。
|
||||
|
||||
### 简化安装器仅作为排障分支
|
||||
|
||||
排障过程中生成过简化 NSIS 安装器,但它不是最终交付物。最终重新恢复并交付 Tauri 原生安装器;简化版、测试副本、临时备份和烟雾测试安装目录均已删除。
|
||||
|
||||
## 正式产物与验证
|
||||
|
||||
```yaml
|
||||
remote_artifact: C:/HoloLakeBuild/output/HoloLake-Era-0.4.4-Windows-x64-setup.exe
|
||||
desktop_artifact: /Users/bingshuolingdianyuanhe/Desktop/HoloLake-Era-0.4.4-Windows-x64-setup.exe
|
||||
size_bytes: 13749728
|
||||
sha256: 495fc8b0cfdc9a50df08af19ed5c3407de977ea18c0794188519e8e31c3c7bf2
|
||||
format: PE32 GUI / Nullsoft Installer self-extracting archive
|
||||
magic: MZ
|
||||
target: Windows x64
|
||||
authenticode: NotSigned
|
||||
installer_icon_readback: 32x32
|
||||
installer_icon_png_bytes: 3151
|
||||
silent_install: passed
|
||||
application_binary_size_bytes: 33171456
|
||||
application_product_name: HoloLake Era - Guanghu Language World
|
||||
application_magic: MZ
|
||||
bundled_agent_docs: present
|
||||
bundled_mcp_assets: present
|
||||
bundled_public_architecture: present
|
||||
uninstaller: present
|
||||
silent_uninstall_and_cleanup: passed
|
||||
```
|
||||
|
||||
安装器包含可读取图标资源;正式光湖品牌资源沿用 0.4.4 源码内的跨平台图标配置。
|
||||
|
||||
当前安装包没有 Windows Authenticode 生产签名。Windows 可能显示“未知发布者”;在取得并安全配置正式代码签名证书前,不能把 `NotSigned` 写成已签名。
|
||||
|
||||
应用二进制的 Windows 文件属性仍显示 `0.2.0.0`,而 Tauri 包版本和本轮交付版本是 `0.4.4`。这不影响本轮安装验证,但后续发布前应统一 Windows 版本资源,避免文件属性与产品版本不一致。
|
||||
|
||||
## 清理与保留
|
||||
|
||||
构建机保留:
|
||||
|
||||
- 正式 Windows 安装包;
|
||||
- 可复用 Node、pnpm、Rust、Visual Studio Build Tools 与 NSIS 工具链;
|
||||
- 本轮源码工作副本与构建状态,供后续增量构建核验。
|
||||
|
||||
构建机已删除:
|
||||
|
||||
- 静默安装测试目录和卸载登记;
|
||||
- 简化安装器脚本;
|
||||
- Tauri 测试副本、修复前备份与重复原版副本;
|
||||
- 烟雾测试临时目录。
|
||||
|
||||
Mac 只保留桌面正式安装包和既有 HoloLake 源码、应用、安装包、Vault、Codex 会话与连续性资料;本轮可重建传输临时目录在交付验证后清理。
|
||||
|
||||
## 下次恢复顺序
|
||||
|
||||
1. 先读本记录;
|
||||
2. 重新读取本地源码分支、完整 HEAD 与工作树,不把本记录当成当前 Git 状态;
|
||||
3. 使用 `HL-BUILD-WIN-GZ-001` 作为 HoloLake Windows 构建能力编号,不把它写入第五域节点表;
|
||||
4. 构建前重新生成源码快照哈希,构建后同时核对大小、SHA-256、PE 格式、图标、安装、核心资源和卸载;
|
||||
5. 若要对外正式发布,先统一 Windows 文件版本资源并配置可信代码签名;
|
||||
6. 若要接入第五域,再单独完成 `JD-FD-PRIMARY` 登记、最小权限、握手和健康回执。
|
||||
Loading…
Reference in a new issue