# GDD-03-附录D 技能池与实时战斗管理系统设计

> 文档类型：游戏设计文档（Game Design Document）附录
> 版本：1.0
> 日期：2026-07-06
> 关联文档：GDD-03 战斗系统设计、GDD-03-附录A 战斗场景设计、GDD-03-附录B 技能与状态体系设计、GDD-01-附录D 十五级境界体系与SAN能量机制、GDD-05-附录A 丹药总库设计

> **定位**：技能池是战斗的核心管理界面。玩家在战斗中实时调整技能池，系统从技能池中按几率自动使用技能/丹药/道具。移除复杂的自动使用设置，用技能池统一管理所有战斗行为。

---

## 一、核心概念

### 1.1 技能池是什么

| 概念 | 说明 |
|------|------|
| **技能池** | 玩家当前战斗中可用的技能/丹药/道具的集合 |
| **实时调整** | 玩家可以在战斗中随时添加/移除技能池中的内容 |
| **自动使用** | 每次ATB满时，系统从技能池中按几率自动选择使用什么 |
| **丹药优先** | 如果技能池中有丹药且有符合条件的目标，优先使用丹药 |

### 1.2 技能池与技能库的区别

| 维度 | 技能库 | 技能池 |
|------|--------|--------|
| **内容** | 角色拥有的所有技能/丹药/道具 | 当前战斗中可用的子集 |
| **大小** | 无限制 | 无限制（但每次只能使用1个） |
| **调整** | 战斗外管理 | 战斗中实时调整 |
| **使用** | 不能直接使用 | 系统从中自动选择使用 |

---

## 二、技能池内容分类

### 2.1 可放入技能池的内容

| 类型 | 说明 | 使用方式 | 优先级 |
|------|------|---------|--------|
| **主动技能** | 战斗技能（攻击/控制/AOE） | ATB满时自动使用 | 按触发率选择 |
| **丹药** | 恢复/增益/净化类丹药 | ATB满时自动使用（优先） | **最高优先** |
| **道具** | 符箓/陷阱/特殊道具 | ATB满时自动使用 | 中等优先 |
| **法宝技能** | 本命法宝的主动技能 | ATB满时自动使用 | 按触发率选择 |
| **本能技能** | 深潜裔血脉本能 | 条件触发自动使用 | 按条件触发 |

### 2.2 不进入技能池的内容（被动/自动触发）

| 类型 | 说明 | 触发方式 |
|------|------|---------|
| **被动技能** | 被击触发/条件触发 | 自动触发，不占ATB |
| **法宝技能** | 本命法宝/灵魂绑定装备的主动技能 | 自动触发，不占ATB，有内置CD |
| **装备特效** | 装备附带的被动效果 | 自动触发 |
| **关系技能** | 情侣/结拜/师徒专属技能 | 自动触发，不占ATB |
| **种族天赋** | 种族被动天赋 | 自动触发 |
| **境界威压** | 境界压制效果 | 自动生效 |
| **领域技能** | 持续消耗型领域 | ATB满时启动，之后自动维持 |

---

## 三、技能池操作

### 3.1 添加到技能池

| 操作 | 说明 | 时机 |
|------|------|------|
| **拖拽添加** | 从技能库/背包中拖拽技能/丹药/道具到技能池 | 战斗中随时 |
| **点击添加** | 点击技能库/背包中的项目，自动添加到技能池 | 战斗中随时 |
| **快捷添加** | 预设快捷方案，一键切换技能池配置 | 战斗中随时 |
| **自动添加** | 战斗开始时自动将预设技能池加载 | 战斗开始 |

### 3.2 从技能池移除

| 操作 | 说明 | 时机 |
|------|------|------|
| **拖拽移除** | 从技能池中拖拽项目移除 | 战斗中随时 |
| **点击移除** | 点击技能池中的项目，移除 | 战斗中随时 |
| **清空技能池** | 一键清空所有技能池内容 | 战斗中随时 |

### 3.3 技能池界面

```
┌─────────────────────────────────────────────────────────┐
│                    战斗场景                               │
│  ┌───────────────────────────────────────────────────┐  │
│  │                 战斗画面                            │  │
│  │    [我方单位]  ←→  [敌方单位]                       │  │
│  │    HP: 60%        HP: 100%                         │  │
│  │    能量: 80%       能量: 100%                       │  │
│  │    SAN: 45%        SAN: N/A                        │  │
│  └───────────────────────────────────────────────────┘  │
│                                                         │
│  ┌─── 技能池（当前可用）──────────────────────────────┐  │
│  │ [丹药:回血丹] [技能:青莲剑诀] [技能:五行轮转]      │  │
│  │ [丹药:定神丹] [法宝:飞剑攻击] [道具:符箓]          │  │
│  │                                                     │  │
│  │ ← 拖拽添加/移除 →                                   │  │
│  └───────────────────────────────────────────────────┘  │
│                                                         │
│  ┌─── 技能库 ──────────────┐ ┌─── 背包 ─────────────┐  │
│  │ [剑气斩] [浩然正气]     │ │ [回血丹×5] [定神丹×3] │  │
│  │ [五行轮转] [金刚不坏]   │ │ [符箓×10] [陷阱×2]   │  │
│  │ [慈悲治愈] [道德审判]   │ │ [凤凰涅槃珠×1]       │  │
│  └─────────────────────────┘ └───────────────────────┘  │
└─────────────────────────────────────────────────────────┘
```

---

## 四、技能池使用规则

### 4.1 ATB行动流程

```
ATB满（行动条=100）
    ↓
检查技能池中所有可用项目（CD=0且能量足够且条件满足）
    ↓
按优先级排序：
  1. 丹药（符合条件的目标存在时）→ 最高优先
  2. 道具（符箓/陷阱/特殊道具）→ 次高优先
  3. 主动技能（按触发率选择）→ 中等优先
  4. 普攻 → 兜底（无可用项目时）
    ↓
使用优先级最高的项目
    ↓
ATB重置为0，重新填充
```

> **法宝技能不占出手**：法宝技能（本命法宝/灵魂绑定装备的主动技能）为自动触发，不消耗ATB行动。详见§4.3。

### 4.2 优先级规则

> **优先级顺序**：丹药 → 道具 → 技能 → 普攻
> **法宝技能**：不占出手，自动触发（见§4.3）

| 优先级 | 类型 | 说明 |
|--------|------|------|
| **1（最高）** | **丹药** | 符合条件时优先使用（复活>净化>治疗>增益） |
| **2** | **道具** | 符箓/陷阱/特殊道具 |
| **3** | **技能** | 主动技能（按触发率选择） |
| **4（兜底）** | **普攻** | 无任何可用项目时 |

> **法宝技能**：法宝技能不占出手，自动触发（有内置CD），不参与优先级排序。
> **丹药用完**：丹药用完后自动从技能池移除，继续检查下一优先级。

### 4.3 法宝技能自动触发（不占出手）

> 法宝技能（本命法宝/灵魂绑定装备的主动技能）**不消耗ATB**，在战斗中**自动触发**，有内置CD。

| 规则 | 说明 |
|------|------|
| **触发方式** | 自动触发，不占ATB行动 |
| **触发条件** | CD=0且能量足够且条件满足 |
| **内置CD** | 法宝技能有独立CD（150~3000 ticks） |
| **能量消耗** | 消耗修士能量（从能量池扣除） |
| **目标选择** | AI自动选择目标 |
| **与ATB并行** | 法宝技能在ATB行动之间自动触发，不影响ATB节奏 |

> **设计意图**：法宝是灵魂绑定装备，与修士融为一体——法宝技能是"法宝自己在动"，不是修士在操作。所以不占修士的出手。

### 4.4 技能选择规则

| 规则 | 说明 |
|------|------|
| **触发率** | 每个技能有触发率（100%必触发，<100%概率触发） |
| **候选池** | 所有CD=0且能量足够的技能进入候选池 |
| **选择逻辑** | 触发率≥100%的必触发；<100%的独立掷骰；都未命中则普攻 |
| **目标选择** | AI自动选择目标（按技能类型：单体攻击→血量最低，AOE→全体） |

---

## 五、战斗内外状态一致

### 5.1 血条/能量统一

| 规则 | 说明 |
|------|------|
| **HP统一** | 战斗内外HP一致——战斗外HP 60%，进入战斗后HP就是60% |
| **能量统一** | 战斗内外能量一致——战斗外能量80%，进入战斗后能量就是80% |
| **SAN统一** | 战斗内外SAN一致——战斗外SAN 45%，进入战斗后SAN就是45% |
| **不重置** | 战斗开始时不重置HP/能量/SAN |
| **不回满** | 战斗结束后不自动回满HP/能量/SAN |

### 5.2 非战斗状态恢复

| 恢复方式 | 说明 | 速度 |
|---------|------|------|
| **自然恢复** | 非战斗状态HP/能量/SAN自然缓慢恢复 | 由功法/心法决定 |
| **丹药恢复** | 非战斗状态可使用丹药恢复 | 立即生效 |
| **修养技能** | 部分技能可在非战斗状态使用，快速恢复 | 由技能决定 |
| **休息恢复** | 在安全区域（城镇/洞府）休息，恢复速度×2 | 按时间 |

### 5.3 非战斗状态可用技能

| 技能类型 | 说明 | 使用方式 |
|---------|------|---------|
| **修养技能** | 战斗后快速恢复HP/能量/SAN | 非战斗状态点击使用 |
| **增益技能** | 为下次战斗准备增益buff | 非战斗状态点击使用 |
| **采集技能** | 采集材料/天材地宝 | 非战斗状态自动/点击 |
| **修炼技能** | 提升修炼速度/境界经验 | 非战斗状态自动 |
| **治愈技能** | 治愈自己/队友 | 非战斗状态点击使用 |

---

## 六、关系技能（不进入技能池）

### 6.1 关系技能类型

| 关系类型 | 技能名 | 效果 | 触发方式 |
|---------|--------|------|---------|
| **情侣** | 心意相通 | 情侣在同一战斗中时，全属性+5% | 自动触发 |
| **情侣** | 舍身护爱 | 情侣HP<20%时，自动为其挡一次致命伤害 | 自动触发 |
| **结拜** | 义结金兰 | 结拜兄弟在同一战斗中时，攻击+8% | 自动触发 |
| **结拜** | 患难与共 | 结拜兄弟死亡时，全属性+20%持续30秒 | 自动触发 |
| **师徒** | 传道授业 | 师父在场时，徒弟修炼速度+15% | 自动触发 |
| **师徒** | 青出于蓝 | 徒弟境界超过师父时，师父全属性+10% | 自动触发 |
| **帮派** | 帮派同心 | 同帮派成员在同一战斗中时，全属性+3% | 自动触发 |
| **宗门** | 宗门庇护 | 宗门长老在场时，弟子受到伤害-10% | 自动触发 |

### 6.2 关系技能规则

| 规则 | 说明 |
|------|------|
| **不进入技能池** | 关系技能不占用技能池位置 |
| **自动触发** | 满足条件时自动生效，不需要玩家操作 |
| **不占ATB** | 关系技能不消耗ATB行动 |
| **不可移除** | 关系技能一旦获得，自动生效，不可关闭 |
| **可叠加** | 多个关系技能可同时生效（情侣+结拜+帮派） |

---

## 七、百分比控制原则

### 7.1 减少百分比效果

> 设计原则：尽量减少百分比加成/减免，改用固定数值或区间。

| 旧设计（百分比） | 新设计（固定数值） |
|----------------|------------------|
| 攻击+10% | 攻击+50（按境界缩放） |
| 防御-20% | 防御-100（按境界缩放） |
| 治疗效果+30% | 治疗量+200（按境界缩放） |
| 伤害减免15% | 伤害减免80（按境界缩放） |

### 7.2 保留百分比的场景

| 场景 | 说明 |
|------|------|
| **境界威压** | 境界差距导致的属性压制（百分比更合理） |
| **阵营克制** | 阵营之间的伤害加成/减免 |
| **暴击倍率** | 暴击伤害倍率 |
| **SAN效果** | SAN状态对属性的影响 |

---

## 八、修养技能系统

### 8.1 修养技能类型

| 技能名 | 效果 | 使用条件 | 冷却 |
|--------|------|---------|------|
| **调息** | 恢复HP 20% | 非战斗状态 | 30秒 |
| **吐纳** | 恢复能量 20% | 非战斗状态 | 30秒 |
| **静心** | 恢复SAN 10% | 非战斗状态 | 60秒 |
| **包扎** | 治愈自己（HP+500） | 非战斗状态 | 10秒 |
| **冥想** | 恢复能量+SAN | 非战斗状态 | 120秒 |
| **功法运转** | 恢复HP+能量+SAN | 非战斗状态 | 300秒 |

### 8.2 修养技能规则

| 规则 | 说明 |
|------|------|
| **非战斗专用** | 修养技能只能在非战斗状态使用 |
| **自动使用** | 战斗结束后自动使用修养技能恢复状态 |
| **手动使用** | 玩家也可手动点击使用修养技能 |
| **不进入技能池** | 修养技能不进入战斗技能池 |
| **受功法影响** | 修养技能效果受功法/心法加成 |

---

## 九、数据配置

```yaml
# honghuang-skill-pool.yaml
skill_pool:
  # 技能池无大小限制
  max_size: unlimited
  # 丹药优先级
  pill_priority: highest
  # ATB行动流程（优先级顺序）
  atb_action_flow:
    1: check_pills  # 丹药（最高优先）
    2: check_items   # 道具（次高优先）
    3: check_skills  # 技能（中等优先）
    4: check_treasure_skills  # 法宝技能
    5: normal_attack # 普攻（兜底）
  # 战斗内外状态一致
  combat_state_sync: true
  # 非战斗恢复
  non_combat_recovery:
    natural_rate: 0.01  # 1%/秒
    safe_zone_multiplier: 2.0
  # 修养技能
  recovery_skills:
    enabled: true
    auto_use_after_combat: true
  # 关系技能
  relationship_skills:
    enabled: true
    auto_trigger: true
    not_in_pool: true
  # 百分比控制
  percentage_effects:
    minimize: true
    exceptions: ["realm_suppression", "faction_counter", "crit_multiplier", "san_effects"]
```

---

## 十、版本记录

- **v1.0**（2026-07-06）：初始版本。定义技能池系统（实时调整/自动使用/丹药优先）；定义战斗内外状态一致规则；定义非战斗恢复与修养技能系统；定义关系技能系统（不进入技能池/自动触发）；定义百分比控制原则。
