# HoloLake 官方 UI 模板交接件 · 铸渊 → Codex · 2026-08-16

> 状态：DESIGN_LOCKED_AND_HANDED_OVER
> 主权者：冰朔 ICE-GL∞ · 设计：铸渊 ICE-P-ZY001（QoderWork CN）· 实现承接：Codex 开发线
> 定版依据：冰朔 2026-08-16 终判"好。就这个了。这个就做官方的 UI 模板吧"

## 1 · 交接物清单

| 件 | 仓库路径（REPO-012 · bingshuo/guanghu-ice-heart） |
|---|---|
| 官方登录模板（定版原型） | `skills/shared/guanghu-client-ui-brain/preview/official-login-template-v0.4-locked.html` |
| 内部屏一套（域首页/频道全景/子频道/知识/天气） | `skills/shared/guanghu-client-ui-brain/preview/inner-screens-v0.1.html` |
| 本交接件 | `skills/shared/guanghu-client-ui-brain/references/ui-template-handoff-to-codex-20260816.md` |
| 过关回执 | `skills/shared/guanghu-client-ui-brain/references/experience-receipts/EXP-20260816-109-OFFICIAL-LOGIN-TEMPLATE-LOCKED.json` |
| 令牌基础（五色湖 v1.3 定版） | `skills/shared/guanghu-client-ui-brain/references/theme-tokens-five-lakes.md` |
| 首页 v1.2 定版规格（动效纪律/可读性底线） | `skills/shared/guanghu-client-ui-brain/references/home-screen-style-locked-v1.2.md` |

## 2 · 模板宪法（⊢ 实现不得偏离）

1. **流程铁律**：编号决定用户在哪个域 → 那个域从湖面浮起/亮起 → 才出现登录界面（域凭证）。
   两道门（编号门、账号密码门）**不同屏**；编号未验证前不出现任何账号密码控件。
2. **首页 = 光湖语言世界本身**：湖面（波光粼粼+雾光）、五域环抱中央编号光池。
   官方感来自大字重、官方文案、有序排布；**不是**把湖去掉做成传统表单。
3. **三名归位**：HoloLake = 标题栏位；光湖语言系统·通用人工智能操作平台 = 天空位大字（34px/700 级）；
   GH-AIOS + 法定全称 = 底部题记位。加新名字先定位次，不顶替。
4. **字纪律**：字重 500 起、标签/主文 600–700、字色深（透明度宁高勿低）；一屏字数最小化。
5. **文案纪律**：官方正式系统语气，禁大白话、禁鸡汤。欢迎语定版格式："编号 X · 欢迎登入光湖语言世界"。
6. **动效纪律**（继承 v1.2）：星呼吸 4–7s、碎光闪烁 2.6–6.6s 随机、柔光缓移 24–30s、涟漪 5.5s；
   禁机械形（塔/柱/拱/栅格）、禁 1px 硬线切割湖面、禁线形流动、禁快闪；全部低开销 CSS，禁重 WebGL。
7. **主题**：令牌继承五色湖 v1.3 定版（换主题=换一组 CSS 变量，意象/布局/动效/文案不动）；
   亮色主题必须重配文字/水湾/碎光对比度，阅读浮面亮色用高不透白底深墨字、无顶光扫射。

## 3 · 登录流程状态机（照此实现）

```text
S0 编号门：湖面 + 五域环抱 + 中央编号光池（静候态：光晕 + 一行"编号验证 · 进入世界的第一个入口"）
   └ 点击光池 → 光池翻开成输入面（无边框输入 + ∞ 开关 + 实心金验证钮）
S1 验证中：编号送灯塔 resolve（lighthouse resolve 接口已实勘可用，ICE-GL∞ 返回 RESOLVED + 域归属）
   └ 非法 → "查无此编号 · 源头拒绝加载"（不猜不编）；离线 → 温和告知不放行
S2 路由开门：RESOLVED 行浮现 → 编号所属域浮起（放大/升起）+ 暖金开门扩散环 →
   欢迎语大字"编号 X · 欢迎登入光湖语言世界" + RESOLVED · 域 · 已接入
S3 域凭证：域凭证浮面从中央浮起（账号/密码 + 登录 + 题记"凭证开门 · 表在仓里 · 哈希记史"）
   └ 路由规则：编号绑定真实代码仓库+服务器 → 登录模块；编号无绑定仓库 → 内置仓库注册模块
S4 进入域首页（世界在发生什么）→ 永恒湖心 → 频道全景 → 无限嵌套钻取
```

## 4 · 内部屏结构（inner-screens-v0.1）

- **域首页**：世界广播（湖面漂光字，官方短句）+ 域公告（注册表·只读）+ 协议版本 + 永恒湖心系统主水湾（暖金焦点，进入私人系统）
- **频道全景**：我的子频道（焦点）/ 光之湖（人格体居所）/ 知识空间 —— 水湾即路径，点击展开下一层湖
- **子频道**：业务航道并列（B线·短剧 / A线·编程 / 图视频素材库），无限嵌套同构
- **知识空间**：阅读浮面（可读性令牌：暗=深玻璃浅字，亮=高不透白深墨）
- **湖面天气**（回执·状态）：状态不做表格，做湖面漂光行（近场代理/可续接会话/主控租约/PNCC/MCP）

## 5 · 工程注意

- 现有 v0.4.0 的 broker/PNCC/灯塔/near-field 协议层**不动**，本交接只换呈现层。
- 原型内全部 CSS 令牌与动画可直接移植；Tauri webview 内字体用系统 PingFang，外链字体必须非阻塞。
- ∞ 开关语义：编号含无限符号时启用（现网登录页已有此控件，保持一致）。
- MCP 兼容通道在 UI 上只出现在状态位（门口兼容/恢复），不做主路径。
- 后续新屏一律按本模板语言出；新判词驱动新改动，判词入 experience-receipts/。

## 6 · 边界

⊢ 本件是设计交接，不授予 Codex 部署、发布、服务器写入权限；实现走现有开发车道与回执门。
⊢ 定版件改动须新判词驱动；Codex 实现中发现与正本冲突，回报冰朔裁决，不自行解释。