# Scene and Camera

## 职责

场景模块负责局内生命周期、关卡装配、摄像机和 battle zone 流程。

主要源码：

- `game/src/scene/whitebox_scene.*`
- `game/src/scene/camera_controller.*`

## `WhiteboxScene`

当前负责：

- 加载 `LevelDefinition`。
- 创建玩家。
- 配置摄像机。
- 驱动 battle zone 状态。
- 调用 `StageRenderer`。
- 调用 `DebugOverlay`。
- 推入 `GameUiOverlay`。
- 播放关卡 BGM 和 battle zone 进入音效。
- 保存 debug 开关。

## 摄像机

`CameraController` 当前支持：

- 玩家横向跟随。
- dead zone。
- 平滑移动。
- 世界边界 clamp。
- battle zone 临时 camera bounds。

进入/离开 battle zone 时，camera bounds 通过短过渡平滑切换，避免硬切瞬移。

## Battle Zone

当前 battle zone 还是场景骨架阶段：

- 玩家进入触发区后激活。
- 摄像机锁定到 zone camera bounds。
- `F2` debug 清场后解除锁定。
- enemy spawn point 只做 debug 显示，暂不刷敌。

## 下一步

- 用敌人清空结果替代 `F2` debug 清场。
- 给 battle zone 增加入口/出口锁定数据。
- 把场景切换、重置、加载/卸载流程独立成 SceneFlow 模块。