pixelheros/design/quick-specs/hero-roster-expansion-2026-07-25.md

# Quick Design Spec: 英雄池扩展（5 名新英雄）

**Type**: Addition  
**System**: 英雄/技能配置系统（`assets/script/game/common/config/heroSet.ts`、`SkillSet.ts`）  
**GDD Reference**: 暂无项目级 GDD；本规范作为该系统的临时设计依据。  
**Date**: 2026-07-25

## Change Summary

基于现有 `evolve` 成长框架和技能底座（治疗/护盾/攻击强化/暴击强化/暴伤强化/驻场光环），新增 5 名英雄，覆盖当前未启用的「自愈战士」「暴击刺客」「团队暴击弓手」「开场护盾法师」「驻场光环法师」五个定位，使英雄池从 6 名扩展至 11 名。

## Motivation

当前启用英雄仅 6 名，覆盖流派有限：

- 战士仅有护盾型（5011）和遗志型（5045），缺少自回复型前排。
- 刺客/弓手缺少暴击流派。
- 法师仅有战前限时 AP 一种形态，缺少护盾、光环等形态。

新增英雄可在不改动系统机制的前提下，丰富阵容搭配和流派发现空间。

## Design Delta

现有 `heroSet.ts` 头部注释定义的触发类型底座规则：

> `atked` 战士 受击触发，效果作用于自身，越挨打越强  
> `atking` 刺客 攻击触发自身强化；射手 攻击触发队友强化  
> `fstart` 法师 战斗开始前触发一次，必然生效的全队增益  
> `field` 法师 驻场光环，存活期间持续生效，死亡消失

本规范在该底座上新增 5 名角色，每名角色专注单一效果，并通过 `evolve` 在 2/3/4/5/6 级逐步解锁强化。

## New Rules / Values

### 通用设计约定

- 所有新英雄继承现有 `heroInfo` 接口，使用 `skills[0]` 作为普通攻击。
- `evolve` 为整体替换且逐级顺序应用；高级别需写出完整触发数组。
- 等级成长节奏：2/4 级强化主效果数值，3/5 级补充属性加成，6 级解锁第二机制或驻场光环。
- 新英雄加入 `HeroList` 启用。

### 英雄 1：5012 不死小强

**定位**：近战 · 自愈坦克  
**触发**：`atked` 自身回血  
**基础属性**：pool_lv 2，hp 600，ap 57，type Melee，普攻 cd 1.8s（Slow3）

```ts
5012: {
    uuid: 5012, name: "不死小强", path: "hk2", fac: FacSet.HERO, pool_lv: 2, lv: 1, type: HType.Melee, hp: 600, ap: 57,
    skills: { 6001: { uuid: 6001, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow3].cd, ccd: 0 } },
    atked: [{ s_uuid: 6302, t_num: 3, overrides: { TGroup: TGroup.Self, ap: 250 } }],
    evolve: {
        2: { atked: [{ s_uuid: 6302, t_num: 3, overrides: { TGroup: TGroup.Self, ap: 300 } }] },
        3: { hp_bonus: 150 },
        4: { atked: [{ s_uuid: 6302, t_num: 3, overrides: { TGroup: TGroup.Self, ap: 350 } }] },
        5: { atked: [{ s_uuid: 6302, t_num: 2, overrides: { TGroup: TGroup.Self, ap: 350 } }] },
        6: {
            atked: [
                { s_uuid: 6302, t_num: 2, overrides: { TGroup: TGroup.Self, ap: 350 } },
                { s_uuid: 6301, t_num: 5, overrides: { TGroup: TGroup.Self, ap: 4 } },
            ]
        },
    },
    info: "每受击3次回复自身攻击力250%生命；2级治疗量300%，4级350%，5级触发阈值降至2次；6级起每受击5次为自身添加4层护盾"
}
```

### 英雄 2：5022 嗜血剑客

**定位**：近战 · 暴击刺客  
**触发**：`atking` 自身暴击 + 攻击力  
**基础属性**：pool_lv 3，hp 900，ap 85，type Melee，普攻 cd 0.5s（Fast2）

```ts
5022: {
    uuid: 5022, name: "嗜血剑客", path: "hc2", fac: FacSet.HERO, pool_lv: 3, lv: 1, type: HType.Melee, hp: 900, ap: 85,
    skills: { 6001: { uuid: 6001, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Fast2].cd, ccd: 0 } },
    atking: [
        { s_uuid: 6403, t_num: 5, overrides: { TGroup: TGroup.Self, hit_count: 1, timed_buff_id: 7012, buff_value: 15, buff_duration: 5 } },
        { s_uuid: 6401, t_num: 7, overrides: { TGroup: TGroup.Self, ap: 12 } }
    ],
    evolve: {
        2: { atking: [
            { s_uuid: 6403, t_num: 5, overrides: { TGroup: TGroup.Self, hit_count: 1, timed_buff_id: 7012, buff_value: 20, buff_duration: 5 } },
            { s_uuid: 6401, t_num: 7, overrides: { TGroup: TGroup.Self, ap: 12 } }
        ]},
        3: { ap_bonus: 20, hp_bonus: 80 },
        4: { atking: [
            { s_uuid: 6403, t_num: 5, overrides: { TGroup: TGroup.Self, hit_count: 1, timed_buff_id: 7012, buff_value: 20, buff_duration: 6 } },
            { s_uuid: 6401, t_num: 7, overrides: { TGroup: TGroup.Self, ap: 15 } }
        ]},
        5: { atking: [
            { s_uuid: 6403, t_num: 4, overrides: { TGroup: TGroup.Self, hit_count: 1, timed_buff_id: 7012, buff_value: 20, buff_duration: 6 } },
            { s_uuid: 6401, t_num: 7, overrides: { TGroup: TGroup.Self, ap: 15 } }
        ]},
        6: {
            atking: [
                { s_uuid: 6403, t_num: 4, overrides: { TGroup: TGroup.Self, hit_count: 1, timed_buff_id: 7012, buff_value: 20, buff_duration: 6 } },
                { s_uuid: 6401, t_num: 7, overrides: { TGroup: TGroup.Self, ap: 15 } },
                { s_uuid: 6404, t_num: 7, overrides: { TGroup: TGroup.Self, ap: 15 } },
            ]
        },
    },
    info: "每攻击5次自身获得+15%暴击率（持续5秒），每攻击7次永久+12攻击力；2级暴击+20%，4级持续6秒且攻击+15，5级暴击触发阈值降至4次；6级起每攻击7次永久+15%暴伤"
}
```

### 英雄 3：5032 战术弓手

**定位**：远程 · 团队暴击辅助  
**触发**：`atking` 随机队友暴击  
**基础属性**：pool_lv 3，hp 430，ap 120，type Long，普攻 cd 0.8s（Normal1），使用箭矢 6008

```ts
5032: {
    uuid: 5032, name: "战术弓手", path: "ha2", fac: FacSet.HERO, pool_lv: 3, lv: 1, type: HType.Long, hp: 430, ap: 120,
    skills: { 6008: { uuid: 6008, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Normal1].cd, ccd: 0 } },
    atking: [{ s_uuid: 6403, t_num: 5, overrides: { TGroup: TGroup.Team, hit_count: 3, timed_buff_id: 7012, buff_value: 10, buff_duration: 5 } }],
    evolve: {
        2: { atking: [{ s_uuid: 6403, t_num: 5, overrides: { TGroup: TGroup.Team, hit_count: 3, timed_buff_id: 7012, buff_value: 12, buff_duration: 5 } }] },
        3: { hp_bonus: 80 },
        4: { atking: [{ s_uuid: 6403, t_num: 5, overrides: { TGroup: TGroup.Team, hit_count: 4, timed_buff_id: 7012, buff_value: 12, buff_duration: 6 } }] },
        5: { atking: [{ s_uuid: 6403, t_num: 4, overrides: { TGroup: TGroup.Team, hit_count: 4, timed_buff_id: 7012, buff_value: 12, buff_duration: 6 } }] },
        6: {
            atking: [
                { s_uuid: 6403, t_num: 4, overrides: { TGroup: TGroup.Team, hit_count: 4, timed_buff_id: 7012, buff_value: 12, buff_duration: 6 } },
                { s_uuid: 6404, t_num: 7, overrides: { TGroup: TGroup.Team, hit_count: 3, ap: 12 } },
            ]
        },
    },
    info: "每攻击5次为随机3名队友提供+10%暴击率（持续5秒）；2级+12%，4级目标数4名且持续6秒，5级触发阈值降至4次；6级起每攻击7次为随机3名队友永久+12%暴伤"
}
```

### 英雄 4：5052 护盾牧师

**定位**：远程 · 开场护盾法师  
**触发**：`fstart` 全队护盾  
**基础属性**：pool_lv 2，hp 287，ap 80，type Long，普攻 cd 1.5s（Slow1）

```ts
5052: {
    uuid: 5052, name: "护盾牧师", path: "hm2", fac: FacSet.HERO, pool_lv: 2, lv: 1, type: HType.Long, hp: 287, ap: 80,
    skills: { 6001: { uuid: 6001, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Slow1].cd, ccd: 0 } },
    fstart: [{ s_uuid: 6301, t_num: 1, overrides: { TGroup: TGroup.Team, ap: 3 } }],
    evolve: {
        2: { fstart: [{ s_uuid: 6301, t_num: 1, overrides: { TGroup: TGroup.Team, ap: 4 } }] },
        3: { hp_bonus: 80 },
        4: { fstart: [{ s_uuid: 6301, t_num: 1, overrides: { TGroup: TGroup.Team, ap: 5 } }] },
        5: { fstart: [{ s_uuid: 6301, t_num: 1, overrides: { TGroup: TGroup.Team, ap: 6 } }] },
        6: { field: [7007] },
    },
    info: "战斗开始时为全队添加3层护盾；2级4层，4级5层，5级6层；6级起全队最大生命值+10%（驻场）"
}
```

### 英雄 5：5061 战歌法师

**定位**：远程 · 驻场光环法师  
**触发**：`field` 驻场攻击力光环  
**基础属性**：pool_lv 3，hp 430，ap 120，type Long，普攻 cd 1.2s（Mid2）

```ts
5061: {
    uuid: 5061, name: "战歌法师", path: "hm3", fac: FacSet.HERO, pool_lv: 3, lv: 1, type: HType.Long, hp: 430, ap: 120,
    skills: { 6001: { uuid: 6001, lv: 1, cd: AtkSpeedSet[AtkSpeedLv.Mid2].cd, ccd: 0 } },
    field: [7002],
    evolve: {
        2: { field: [7202] },
        3: { hp_bonus: 80 },
        4: { field: [7202, 7006] },
        5: { field: [7202, 7206] },
        6: { field: [7202, 7206, 7007] },
    },
    info: "驻场期间全队攻击力+10%；2级+20%，4级追加攻击速度+10%，5级攻速+20%；6级追加最大生命值+10%"
}
```

## Affected Systems

| System | Impact | Action Required |
|--------|--------|-----------------|
| `heroSet.ts` | 新增 5 名英雄配置，更新 `HeroList` | 实现时写入 |
| `SkillSet.ts` | 复用现有技能 6301/6302/6401/6403/6404 及计时 buff 配置 7012；复用驻场 7002/7202/7006/7007 | 无需改动 |
| 抽卡/经济系统 | pool_lv 2-3 英雄加入卡池，需确认出现概率 | 配置侧无需改动，后续平衡检查 |

## 平衡调整说明

- **5022 嗜血剑客**：永久暴击率改为计时暴击 buff：每 5 次攻击获得 `+15% 暴击率 / 5s`，2 级 `+20% / 5s`，4 级 `+20% / 6s`，5 级触发阈值降至 4 次；保留永久攻击力与 6 级永久暴伤作为成长副属性。
- **5032 战术弓手**：团队永久暴击率改为计时暴击 buff：每 5 次攻击为随机 3 名队友提供 `+10% 暴击率 / 5s`，2 级 `+12% / 5s`，4 级目标数 4 名且 `+12% / 6s`，5 级触发阈值降至 4 次；保留 6 级永久暴伤作为第二机制。
- **5061 战歌法师**：不携带暴击光环，避免与 5022/5032 的暴击主题叠加后收益过高；驻场光环为攻击力 + 攻速 + 生命。

## Acceptance Criteria

- [ ] `HeroInfo` 中 5012/5022/5032/5052/5061 配置与本文案一致
- [ ] `HeroList` 包含上述 5 个 uuid
- [ ] 每名新英雄的 2/3/4/5/6 级成长在游戏中可正常触发
- [ ] 5052 的护盾与 5061 的光环在死亡/离场后正确消失/恢复
- [ ] 无回归：现有 6 名英雄的属性、触发、成长不受影响

## GDD Update Required?

No. 项目暂无 `design/gdd/` 文档，本 Quick Design Spec 作为英雄系统的临时设计依据。后续若建立系统 GDD，需将本规范内容合并。