---
name: bottom_ui_bar.aicomponent
description: 底部 UI 条 Phaser 占位容器，导出 GAME_BOTTOM_UI_BAR_HEIGHT（与 GameConfig 同源）并与棋盘可用高度扣减对齐。布局合同见 playable_hud_layout。
triggers: 需要底区垂直占位、与顶栏对称的 HUD 区，或避免棋盘侵入底部 CTA/品牌区时触发。
---

# 底部 UI 条（Bottom UI Bar）

## 说明

- **高度常量** `GAME_BOTTOM_UI_BAR_HEIGHT` 取自 `GameConfig.GAME_BOTTOM_UI_BAR_HEIGHT`，与 `grid_board_layout` / `path_input_handler` 等扣底公式一致。
- **分区与 z-order** 见 `playable_hud_layout.aicomponent`；**缩放**见 `responsive_2d_layout.aicomponent` 第一节。

## Scaffold

| 目标路径 | 来源 | 说明 |
|---------|------|------|
| `src/game/scenes/GameUI/GameBottomUI.ts` | `ref/GameBottomUI.ts` | 底栏占位 Container + 导出常量 |

## Recipe

| 决策 | 原因 |
|------|------|
| **对称于 TopUI 的占位 Container** | 底部 CTA 区（下载按钮、品牌 logo）需要专属高度预留；与顶栏高度常量对称管理，确保棋盘不侵入两端 UI 区 |
| **高度从 GameConfig 读取** | 与 `grid_board_layout`、`path_input_handler` 使用同一 `GameConfig.GAME_BOTTOM_UI_BAR_HEIGHT`；单点定义防止底栏高度在多处不一致 |

## Adapter

- **Role**: `bottomUiBar` — 底部 HUD 区域占位容器及高度常量提供者
- **Provides**: `GameBottomUI` 类、`GAME_BOTTOM_UI_BAR_HEIGHT` 常量（与 GameConfig 同源）
- **Requires**: `phaser.aicomponent`、`responsive_2d_layout.aicomponent`
- **Consumed by**: `game_scene.aicomponent`（实例化 BottomUI）、`grid_board_layout.aicomponent`（棋盘可用高度扣减）
- **Integration point**: `src/game/scenes/GameUI/GameBottomUI.ts` → `Game.create()` 中实例化

## Imports

- `phaser.aicomponent`（硬依赖）
- `responsive_2d_layout.aicomponent`（硬依赖）

## Skill Definition

```yaml
tools:
  - read_file
  - write_file
inputs:
  - source: src/game/scenes/GameUI/GameBottomUI.ts
outputs:
  - gameBottomUI: GameBottomUI class + GAME_BOTTOM_UI_BAR_HEIGHT constant aligned with GameConfig
```