117 lines
5.5 KiB
Markdown
117 lines
5.5 KiB
Markdown
# 光湖团队 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 已完成。
|