---
name: progress_bar.aicomponent
description: 关卡进度条。显示当前关卡已消除路径数/总路径数的比例，直观呈现关卡完成进度。
triggers: 需要显示关卡进度指示器时触发。
---

# 关卡进度条（Level Progress Bar）

## Scaffold

`src/game/scenes/GameUI/ProgressDisplay.ts`

## Recipe

| 决策 | 原因 |
|------|------|
| **已消除数/总数比例** | 进度条显示的是"完成了多少"而非剩余多少，正向激励玩家继续；比生命条更直观地传递关卡接近尾声的信息 |
| **独立于 LevelManager** | ProgressDisplay 只读取已消除路径数，不持有 LevelManager 引用；GameScene 负责同步，DisplayWidget 保持纯视觉 |

## Adapter

- **Role**: `levelProgressBar` — 关卡完成进度条 UI
- **Provides**: `ProgressDisplay` 类（更新进度百分比 + 渲染进度条）
- **Requires**: `phaser.aicomponent`（Graphics/Rectangle API）
- **Consumed by**: `top_ui_bar.aicomponent` 或 `game_scene.aicomponent`（在路径消除时调用 `update(removed, total)`）
- **Integration point**: `src/game/scenes/GameUI/ProgressDisplay.ts` → 顶部 UI 条或 GameScene 持有实例

## Skill Definition

```yaml
tools:
  - read_file
  - write_file
inputs:
  - source: src/game/scenes/GameUI/ProgressDisplay.ts
outputs:
  - progressDisplay: ProgressDisplay class
```