# HoloLake Era iPhone / TestFlight 承接记录

状态日期：2026-07-18
当前版本：0.1.7
Bundle ID：`com.guanghulab.hololake`

## 为什么这样做

手机版不是把 Mac 三栏界面等比例缩小，而是保留第五域的同一套频道语义，为手机增加固定的五入口导航：零点原核、第五域、心跳核心、光之湖人格体、服务器节点。知识库仍是频道工作区中的能力，不重新变回软件主体。

## 真实文件入口

- 手机频道结构：`src/components/HoloLakeHome.tsx`
- 手机响应式样式与安全区：`src/App.css`
- 手机导航回归测试：`src/components/HoloLakeHome.test.tsx`
- iOS 专用 Tauri 配置：`src-tauri/tauri.ios.conf.json`
- XcodeGen 工程源：`src-tauri/gen/apple/project.yml`
- 已生成 Xcode 工程：`src-tauri/gen/apple/HoloLake.xcodeproj`
- iOS 权限基线：`src-tauri/capabilities/mobile.json`

旧的 `src-tauri/gen/apple/laputa.xcodeproj` 和 `laputa_iOS` 目录来自 Tolaria 基座，仅作为历史生成结构保留；TestFlight 的新承接入口是 `HoloLake.xcodeproj` / `HoloLake_iOS`，不得再用旧包名 `club.refactoring.tolaria` 发布。

## 已验证

- Web/TypeScript 生产构建通过：`npm run build`
- 第五域与手机频道导航测试通过：`src/components/HoloLakeHome.test.tsx`，8 项通过
- `aarch64-apple-ios` 与 `aarch64-apple-ios-sim` Rust 目标已安装
- Xcode 工程已经以 HoloLake 名称、0.1.7 版本和独立 Bundle ID 生成

## 尚未闭环的外部条件

1. Apple Developer 订阅已付款，但 Xcode 当前仍只显示 `Personal Team`；正式付费团队同步后才能建立发行签名并上传 TestFlight。
2. 本机 Xcode 的 iOS 26.5.1 + iOS 26.5 Simulator 组件未安装，官方界面显示占用 8.52 GB；应在冰朔确认磁盘占用后下载。
3. iOS Rust 原生检查已进入 Tauri Swift 层，但 SwiftPM 从 GitHub 拉取 `Brendonovich/swift-rs` 时网络连接失败。这是依赖下载阻断，不是当前代码编译错误；网络恢复后重跑原生检查。
4. 创建 Apple Development / Distribution 证书属于持久凭据操作，必须在正式团队出现后由冰朔当场确认，再在 Xcode 的 `Manage Certificates…` 中执行。

## 下一实例最短继续路径

1. 打开 Xcode → Settings → Apple Accounts，确认是否出现非 `Personal Team` 的正式团队。
2. 经冰朔确认后，安装 Xcode → Settings → Components 中的 iOS 26.5.1 + Simulator。
3. 网络可访问 GitHub 后运行：
   `cargo check --manifest-path src-tauri/Cargo.toml --target aarch64-apple-ios`
4. 用 `src-tauri/gen/apple/HoloLake.xcodeproj` 的 `HoloLake_iOS` scheme 做真机归档。
5. 正式团队出现且冰朔确认创建证书后，创建 App Store Connect 应用记录并上传 TestFlight 内测构建。

TestFlight 上线前不得把“前端构建通过”“Xcode 工程已生成”写成“手机版已发布”。