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

5.4 KiB
Raw Blame History

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

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

1. 已确认的产品顺序

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

企业侧的开发顺序是:

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

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

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

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

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

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

3. 真实源码入口

  • 团队 GLS 页面:src/TeamFoundationApp.tsx
  • 团队独立渲染入口:src/team-foundation-main.tsx
  • 团队独立 HTMLteam-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 IDcom.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 上伪造。手动触发:

.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(后续文档修正提交以实际 HEAD 为准。第一次推送完整执行了前端测试、Rust lint、1074 项 Rust 测试与覆盖率Playwright 冒烟测试因本机缺少对应 headless-shell 运行器未执行成功。远端随后明确拒绝:repo_push_grant_expired。重新取得 repo-push 邮件授权后,应先推送当前 main,再触发上述 Windows CI。

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 已完成。