Cielonos/docs/PassionSystem_GDD.md

Cielonos 战斗系统设计文档：激情系统 (Passion System GDD)

---

1. 核心设计目标

在二次元 3D 动作 Roguelike 游戏 《Cielonos》 中，激情系统（Passion System）旨在作为战斗流程的核心引擎。该系统不单纯作为一个“连击评分板”，而是通过将玩家的战斗状态分流，动态影响战斗机制：

• 低激情状态（D ~ B级）- “冷静/防御模式”：
  • 设计定位：对新手或防守型玩家友好，提供强大的生存容错、认知缓冲与机制级防御保护（而非单纯堆砌防御数值）。
• 高激情状态（S ~ SSS级）- “狂热/超频模式”：
  • 设计定位：高风险、高回报。大幅提升进攻机动性与爆发力，但玩家也将面临更快的激情衰减以及更高的受伤惩罚。
• 主动资源化：玩家可以主动“倾泻/燃烧”激情值，通过消耗累积的阶段优势来换取短期的爆发性现实重构（无敌时间、时空减速）。

---

2. 同类动作游戏经典设计分析

为避免纯数值化设计的乏味感，我们提炼了同类优秀动作游戏的反馈机制：

游戏名称	核心机制	对 Cielonos 激情系统的启示
《鬼泣》系列	连击评级 (D ~ SSS) 与招式多样性惩罚。受到伤害或停止进攻会导致评级骤降。	激情等级应引入“获取倍率随等级提升递减”和“受击流失随等级提升递增”的自我平衡公式。
《ULTRAKILL》	Style 评级直接影响回血速度，滑铲/空中时间/武器切换提供 Style 加成。	激情系统应鼓励玩家通过特定战术动作（完美闪避、切枪 combo）来获取大量激情值，而不仅是普通攻击。
《只狼》	躯干值（Posture）与防守姿态。保持防御可加速躯干值恢复。	冷静状态不应是“挨打惩罚”，而应作为“安全整备期”，提供机制性的防守强化（如完美闪避判定帧放宽）。
《魔女兵器》/《贝优妮塔》	魔女时间（Witch Time）。极限闪避触发时空断裂。	激情系统的短时爆发（Passion Burst）可以与时空减速或子弹时间联动，提供强烈的视听反馈。

---

3. 核心机制设计与拆解

激情值 (percent: 0.0 ~ 100.0%) 对应 7 个等级 (D -> C -> B -> A -> S -> SS -> SSS)
 D-Rank [0~19%]  -->  C-Rank [20~39%]  -->  B-Rank [40~59%]  -->  A-Rank [60~79%]
 S-Rank [80~89%] -->  SS-Rank [90~95%] --> SSS-Rank [96~100%]

3.1 激情的动态演变公式

3.1.1 激情值获取 (Increase)

玩家执行以下动作时增加百分比激情值（受当前等级的 increaseMultiplier 限制）：

• 普通命中：每次攻击命中根据伤害类型基础值增加（如近战 +2%，远程 +1%）。
• 技术动作（核心加成）：
  • 完美闪避 (Perfect Dodge)：直接增加当前段位所需上限的 15%。
  • 完美切枪 (Perfect Switch Combo)：在动画特定后摇窗口切换主武器，直接增加 10%。
  • 使用特定战斗道具：如使用激情注入药剂，瞬间提升当前级别的 25%。

3.1.2 激情值自然衰减 (Decay Over Time)

• 当玩家在 3秒内未对敌人造成伤害且未触发完美判定 时，激情值开始衰减。
• 衰减速度随着激情等级急剧增加。高等级（S ~ SSS）的自然衰减率 timeDecreaseMultiplier 呈指数级上升。

3.1.3 受击惩罚流失 (Reactive Loss)

• 玩家受到攻击扣除生命值时，激情值会发生阶梯式滑落。
• 在 SSS 级时受击，会根据 reactiveDecreaseMultiplier 瞬间跌落 1~2 个大级（如 SSS 跌至 A 级），造成极大的容错惩罚。

---

3.2 激情等级特异机制详解

3.2.1 【低激情等级：冷静状态 (D ~ B 级)】- 认知缓冲与防御重构

当角色激情较低说明其大脑波形处于平稳状态。高维投影少女有更多的认知带宽来解析现实空间：

1. 高维认知缓冲 (Cognitive Buffer Window)：
   • 机制：放宽**闪避（Dodge）和完美闪避（Perfect Dodge）**的判定无敌帧（Invincibility Frames）。
   • 效果：在 D 级时，判定帧放宽 50%（如从 6 帧放宽至 9 帧），B 级时放宽 20%。使得新手玩家极易触发完美闪避来累积局势。
2. 护盾被动重构 (Shield Self-Restructuring)：
   • 机制：当激情值低于 40%（D ~ C级）且玩家 3秒内未受击 时，触发高维护盾自动重构。
   • 效果：每秒自动回复 MaximumShield * 3% 的护盾值，直到护盾回满或激情值升至 B 级以上。这为残血整备提供了绝对的安全感。
3. 架势稳定（Super Armor）：
   • 机制：提高主角在动作释放过程中的受击抗性（Breakthrough Resistance）。
   • 效果：自动免疫所有弱度（Weak）及中度（Medium）受击硬直，减少防守反击时被小兵打断的概率。

3.2.2 【高激情等级：超频状态 (S ~ SSS 级)】- 高风险高回报与空间撕裂

当角色激情极高时，其神经元处于高维过载状态。现实物理常数开始受意志影响而坍塌：

1. 高维共鸣爆破 (High-Dimensional Resonance)：
   • 机制：玩家使用 Polychrome 或 FutureWand 攻击时，会在敌人身上附着“共鸣层数”。
   • 效果：当玩家在 S 级以上执行主武器切换（Switch Combo）时，新武器的登场攻击会瞬间引爆所有共鸣层数，造成大范围的空间重叠撕裂伤害（物理常数改写）。
2. 高频瞬步 (Dimensional Phase Shift)：
   • 机制：玩家的闪避动画被替换为高维折叠闪现。
   • 效果：闪避的前摇和后摇恢复帧缩短至 0。玩家可以连续折叠闪现，在战场中如残影般穿梭，极大提升连招上限。
3. 双向认知过载 (Cognitive Overload)：
   • 机制：高维扭曲带来的代价。
   • 效果：在 SSS 级时，玩家造成的最终伤害提升 30%，但受到攻击时承受的最终伤害也提升 20%，逼迫玩家利用高频瞬步保持无伤。

---

3.3 各等级量变数值映射 (Quantitative Scaling)

为了在定性的“质变”机制之外，为玩家提供平滑且可感知的战斗成长线，激情系统在 D 到 SSS 等级之间引入了维度的渐进数值（量变）变化：

1. 移动/攻击速度 (Speed Scale)：高能量超频使动作逐渐迅捷。
2. 能量获取模式 (Energy Economy)：
   • 冷静侧 (D ~ B)：提升被动能量恢复速度，保障玩家在防守规避与观察敌情时有充足的资源进行策略应对。
   • 超频侧 (S ~ SSS)：被动能量停止自动恢复，大幅提升攻击命中时的能量汲取加成，鼓励积极拼杀获取能量。
3. 精准与击破 (Crit & Stance Break)：额外暴击率、暴击伤害与破韧（Stance Break）倍率随激情等级显著上升。
4. 承伤修正比例 (Damage Mitigation/Vulnerability)：低激情下提供受击百分比减伤，高激情下认知过载带来受击伤害加深。

等级 (Rank)	激情值区间	移速/攻速倍率	被动能量回复 (每秒)	攻击能量加成	额外暴击率/爆伤	韧性击破倍率	最终受击伤害系数
D-Rank	0% ~ 19%	1.00x / 1.00x	+4.0 Energy	1.00x	+0% / +0%	1.00x	0.90x (减伤 10%)
C-Rank	20% ~ 39%	1.02x / 1.02x	+3.0 Energy	1.00x	+2% / +4%	1.05x	0.93x (减伤 7%)
B-Rank	40% ~ 59%	1.05x / 1.05x	+2.0 Energy	1.10x	+5% / +10%	1.10x	0.96x (减伤 4%)
A-Rank	60% ~ 79%	1.08x / 1.08x	+1.0 Energy	1.20x	+9% / +18%	1.18x	1.00x (无修正)
S-Rank	80% ~ 89%	1.12x / 1.12x	+0.0 Energy	1.35x	+14% / +28%	1.28x	1.05x (易伤 5%)
SS-Rank	90% ~ 95%	1.16x / 1.16x	+0.0 Energy	1.50x	+20% / +40%	1.40x	1.10x (易伤 10%)
SSS-Rank	96% ~ 100%	1.20x / 1.20x	+0.0 Energy	1.80x	+25% / +50%	1.50x	1.20x (易伤 20%)

---

3.4 终极动作：激情释放 (Passion Burst)

• 触发条件：激情等级达到 SSS 级（Percent >= 96%）。
• 执行方式：玩家同时按下特殊热键（或使用爆药道具），将激情值瞬间归零（降至 D 级 0%）。
• 触发效果 — “世界线裁定 / Reality Overwrite”：
  • 时空断裂：方圆 30 米内的所有敌人及子弹强制进入 90% 减速状态，持续 6 秒。
  • 高维投影虚无化：玩家处于绝对无敌状态（不受任何伤害，且免疫一切硬直）。
  • 武器觉醒：期间 Polychrome 攻击附带追踪剑气，FutureWand 普攻变为散射暴击激光。
  • 效果结束后，系统会自动进入“认知缓冲”状态，帮助玩家重新组织防守。

---

4. 技术实现与架构衔接方案

此系统应保持策划数值的可配置性，并与现有组件进行机制联动：

                              [ PassionSystem ]
                                     |
               +---------------------+---------------------+
               |                     |                     |
     (OnPhaseChanged)        (AttributeModify)     (OnPerfectDodge)
               v                     v                     v
       [ Audio & VFX ]       [ PlayerAttributes ]  [ PlayerMovement ]
    (Dynamic Music Switch)   (Shield Reg./Damage)  (Invincible Frames)

4.1 完美闪避判定帧修改与 PlayerLandMovementSubcontroller.cs

• 在 PlayerLandMovementSubcontroller.cs 的 Dodge 逻辑中，完美闪避判定的窗口时间（如 perfectDodgeWindow）不再是固定值。
• 判定时，应读取 PassionSystem.Instance.level 对应的加成比例。
• 伪逻辑代码流（C# 概念参考）：

  float scale = PassionSystem.Instance.GetDodgeWindowScale(); 
  float activePerfectWindow = basePerfectDodgeWindow * scale;
  

4.2 护盾重构与 AttributeSubmodule.cs

• 激情系统持有 ShieldRegenTimer。
• 当 level <= PassionLevel.B 且 timeSinceLastHurt >= 3.0f 时，计时器累加并修改 attributeSm[CharacterAttribute.Shield] 的值。
• 界面上的血条 UI (PlayerInfoUIArea.cs) 订阅此属性变更，同步展现能量环流动重构的特效。

4.3 音频与 Wwise 动态音乐切换

• 激情系统的声效联动是提升打击感（WOW感）的重点。
• 激情等级变化时，通过 Wwise 发送 State/Switch 信号给音乐容器。
  • D ~ B级：原声吉他与平缓的电声合成器（冷静、低沉）。
  • A ~ SS级：重金属摇滚吉他与架子鼓切入，节奏加快。
  • SSS级：加入激昂的交响乐人声唱腔或超频电子乐，营造高潮体验。