hololake-platform/docs/TEAM-FOUNDATION-HANDOFF.md

# 光湖团队 GLS 基座与企业四域开发承接

> 文档编号：HLP-DOC-TEAM-0001
> 状态：2026-07-18 实现基线
> 产品仓库：`REPO-008 bingshuo/hololake-platform`

## 1. 已确认的产品顺序

光湖只有一个 App 和一个持续演进的产品仓库，但团队基座与冰朔个人内测版是不同发行模式，不得把两边的可见内容混装。

企业侧的开发顺序是：

```text
GLS 团队基座
→ 团队重塑 Notion 原型的页面关系与编号
→ 光湖主域 / 光湖分域 / 光湖零域 / 光湖零感域
→ 团队成员从零感域进入自己的个人频道
→ 公众从公共域进入行业与模块
```

零点原核频道是企业端与冰朔第五域都会连接的桥，但不等于把冰朔第五域、永恒湖心或个人频道复制到企业团队包。

## 2. 团队第一版的严格边界

团队第一版只展示 `GLS-SYS-ARCH-001` 公开系统架构。以下内容不得进入团队首版可见界面：

- 第五域个人频道结构；
- 永恒湖心、心跳核心、光之湖人格体路径；
- 冰朔短剧视频、服务器登记和个人模块；
- 未重塑页面关系的 Notion 导出内容。

这不是删除 Tolaria 基座能力，而是冻结团队首版的产品入口，避免团队在错误页面关系上继续开发。

## 3. 真实源码入口

- 团队 GLS 页面：`src/TeamFoundationApp.tsx`
- 团队独立渲染入口：`src/team-foundation-main.tsx`
- 团队独立 HTML：`team-foundation.html`
- 团队 Tauri 身份：`src-tauri/tauri.team.conf.json`
- GLS 唯一内置数据：`src-tauri/resources/public-architecture/gls-system-architecture.json`
- 团队构建收尾：`scripts/finalize-team-foundation-build.mjs`
- Mac 打包：`scripts/build-macos-internal.sh`
- Windows CI 工作流：`.github/workflows/build-windows-manual.yml`
- Windows 本地/节点备用脚本：`scripts/build-windows-jd-cross.sh`
- 包内容硬门：`scripts/verify-internal-package-content.mjs`
- 自动测试：`src/TeamFoundationApp.test.tsx`

团队包使用独立 Bundle ID：`com.guanghulab.hololake.team-foundation`，可以与冰朔个人内测版并存。

## 4. Notion 原型素材源

冰朔桌面上的全量导出：

`/Users/bingshuolingdianyuanhe/Desktop/notion.zip`

2026-07-18 只读核验结果：外层约 497 MB，内部为两个 Notion 分卷压缩包。该文件是企业四域原型素材，不是可直接部署的页面树，也不进入团队安装包。

后续重塑必须先输出“页面关系映射表”，至少区分：原页面 ID、标题、父页面、目标域、目标频道、可见性、事实源、废弃/合并关系。未完成映射前不得批量导入仓库。

## 5. 已完成验证与产物

- 团队页面与冰朔频道测试合计 9 项通过；
- `npm run build:team-foundation` 通过，只编译团队独立入口；
- 团队 dist 私人内容扫描通过；
- GLS 与公开研发仓库内容门通过；
- Mac 应用 ad-hoc 签名验证通过；
- Mac DMG 校验通过，桌面复制后二次 SHA-256 通过。

Mac 团队基座包：

`/Users/bingshuolingdianyuanhe/Desktop/HoloLake-Era-0.1.7-Team-Foundation-Mac-aarch64.dmg`

外接盘归档：

`/Volumes/JZAO/HoloLake/artifacts/team-foundation/HoloLake-Era-0.1.7-Team-Foundation-Mac-aarch64.dmg`

## 6. Windows CI 与未闭环项

Windows 安装包沿用仓库已有的 Windows CI，不在 Mac 上伪造。手动触发：

```text
.github/workflows/build-windows-manual.yml
distribution = team-foundation
version = 0.1.7
artifact_name = HoloLake-Era-Team-Foundation-Windows-x64
```

输出目标名：`HoloLake-Era-0.1.7-Team-Foundation-Windows-x64-setup.exe`。

该工作流历史上成功生成过 Windows 包；本次已增加 `distribution` 选择，默认 `team-foundation`，通过 `src-tauri/tauri.team.conf.json` 只构建 GLS 团队入口。CI 成功只能证明 NSIS 产物生成；能否安装、启动和显示正确 GLS 页面仍须 Windows 实机验收。当前团队版 Windows 包尚未生成，不得写成双平台已经交付。

2026-07-18 功能提交为 `a6d83b0`，Windows CI 与本文修正提交为 `ab283b5`。第一次推送完整执行了前端测试、Rust lint、1074 项 Rust 测试与覆盖率；Playwright 冒烟测试因本机缺少对应 headless-shell 运行器未执行成功。远端曾因 `repo_push_grant_expired` 拒绝；冰朔完成新邮件工单批准后，已按导航地图读取、确认和仓库授权路径成功推送至远端 `main`。下一步是触发上述 Windows CI，并在 Windows 实机验证安装和启动。

## 7. 外接盘构建约束

JZAO 原文件系统会产生 `._` AppleDouble 文件，Rust/Tauri 会把它们误读为配置。Mac 原生缓存因此放在 JZAO 上的 APFS 稀疏映像：

- 映像：`/Volumes/JZAO/HoloLake/HoloLakeBuild.sparsebundle`
- 挂载点：`/Volumes/HoloLakeBuild`
- Cargo 缓存：`/Volumes/HoloLakeBuild/target/team`

iOS 26.5 模拟器导出包也保存在 JZAO：

`/Volumes/JZAO/HoloLake/Xcode-Platforms/iphonesimulator_26.5_23F77.exportedBundle`

Xcode 下载后曾自动在内置盘注册一份；已用 `simctl runtime delete` 精确移除，当前内置运行时列表为空。需要模拟器时必须重新讨论导入后的内置盘占用。

## 8. 下一实例最短读取顺序

1. 本文 `HLP-DOC-TEAM-0001`；
2. `docs/IOS-TESTFLIGHT.md`；
3. `docs/HOLOLAKE-LANGUAGE-WORLD-SYSTEM.md`；
4. `docs/skills/internal-release-packaging/SKILL.md`；
5. 上述真实源码入口与测试。

不得从 Notion 导出包猜页面关系，不得把团队 GLS 基座说成企业四域已经开发完成，也不得把 Mac 包成功说成 Windows/TestFlight 已完成。