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

114 lines
4.8 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.

# 光湖团队 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 JD 节点打包:`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 未闭环项
Windows 包必须在 `JD-FD-PRIMARY` Linux 节点执行,不在 Mac 上伪造:
```bash
COREPACK_HOME=<JD 节点缓存路径> \
CARGO_TARGET_DIR=<JD 节点构建路径> \
HOLOLAKE_SKIP_INSTALL=0 \
npm run package:team:windows
```
输出目标名:`HoloLake-Era-0.1.7-Team-Foundation-Windows-x64-setup.exe`
完成标准包括 PE32+ x86-64、NSIS 安装包、内容门、SHA-256、服务器归档和回传后二次校验。当前 Mac 没有 JD 节点 SSH 通道,所以 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 已完成。