---
name: combo_praise_text.aicomponent
description: 连击表扬文案弹出动画。在点击成功消除路径时，根据连击数在点击位置弹出 GOOD/NICE/GREAT/AWESOME/INCREDIBLE/LEGENDARY 文字动画，给玩家正向反馈。
triggers: 需要实现连击正向反馈文字弹出动画时触发。
---

# 连击表扬文案弹出（Combo Praise Text Popup）

## 说明

当玩家连续成功消除路径时，在点击位置弹出表扬文案：

| 连击数 | 文案 |
|-----|-----|
| 1 | GOOD |
| 2 | NICE |
| 3 | GREAT |
| 4 | AWESOME |
| 5 | INCREDIBLE |
| 6+ | LEGENDARY |

## Scaffold

`src/game/scenes/GameUI/ComboPraiseText.ts`（从 ComboManager.ts 提取 `maybeShowComboPraiseText` 方法）

## Recipe

| 决策 | 原因 |
|------|------|
| **从 ComboManager 提取** | 表扬文字弹出是纯视觉反馈，与连击计数逻辑耦合度低；提取为独立函数后，可在不使用 ComboManager 的场景中单独复用 |
| **位置跟随点击点** | 文字在玩家点击位置弹出，强化操作→反馈的直接关联；固定位置的文字反馈感觉"延迟" |
| **LEGENDARY 封顶** | 超过 6 连击后文案不再升级，避免需要维护过长的文案列表 |

## Adapter

- **Role**: `comboPraiseText` — 连击正向反馈文字弹出动画
- **Provides**: `maybeShowComboPraiseText(scene, comboCount, x, y)` 函数
- **Requires**: `phaser.aicomponent`（Tween + Text API）
- **Consumed by**: `combo_display.aicomponent`（ComboManager 在连击计数变化时调用）
- **Integration point**: `src/game/scenes/GameUI/ComboPraiseText.ts` → ComboManager.addCombo() 内部触发

## Imports

- `phaser.aicomponent`（硬依赖：Tween + Text API）

## Skill Definition

```yaml
tools:
  - read_file
  - write_file
inputs:
  - source: ref/ComboManager.ts
outputs:
  - comboPraiseText: maybeShowComboPraiseText function
```