狗屎Minimax坏我代码

2026-04-18 13:57:19 -04:00
parent 41140a2017
commit 7379583165
473 changed files with 34480 additions and 8069 deletions
--- a/docs/闪避反馈系统设计.md
+++ b/docs/闪避反馈系统设计.md
@@ -0,0 +1,701 @@
+# Cielonos 闪避系统摄像机反馈设计方案
+
+## 一、现有系统分析
+
+### 1.1 反馈系统架构
+
+```
+FeedbackManager
+    ↓
+FeedbackPlayer（运行时播放器）
+    ↓
+FeedbackData（ScriptableObject - 包含多个Track）
+    ↓
+FeedbackTrack（轨道 - 并行播放）
+    ↓
+FeedbackClip（片段 - 包含FeedbackAction）
+    ↓
+FeedbackActionBase（具体的反馈动作）
+    ├── CameraRotationShakeAction ✓
+    ├── CameraFieldOfViewAction ✓
+    ├── CameraPositionShakeAction ✓
+    ├── RadialBlurAction ✓
+    ├── VignetteAction ✓
+    ├── TimeScaleModifierAction ✓
+    ├── ChromaticAberrationAction ✓
+    └── ... 其他后处理效果
+```
+
+### 1.2 闪避系统架构
+
+```
+DodgeSubmodule
+    ├── DodgeSource[]（闪避源列表）
+    │   ├── dodgeTime（闪避持续时间）
+    │   ├── perfectTime（完美闪避窗口，0.2秒）
+    │   ├── isPerfectDodging（是否处于完美闪避中）
+    │   └── 回调方法
+    └── 方法
+        ├── ApplyDodge()
+        ├── RemoveDodge()
+        ├── PerfectDodge() → 触发"PerfectDodge"反馈
+        └── NormalDodge() → 触发"NormalDodge"反馈
+
+PlayerAnimationSubcontroller
+    ├── SetupDash() → 触发"Dash"反馈
+    └── SetupDodge() → 触发"Dodge"反馈
+```
+
+### 1.3 现有的闪避反馈
+
+在 `DodgeSource.Default()` 工厂方法中，已经预设了：
+- **PerfectDodge** 触发：
+  - `MMF_RadialBlur` - 径向模糊
+  - `MMF_AdvancedVignette` - 高级暗角
+- **Dash/Dodge** 触发：
+  - `MMF_CinemachineRotation` - 旋转震动
+  - `MMF_RadialBlur` - 径向模糊
+
+---
+
+## 二、闪避反馈设计方案
+
+### 2.1 普通闪避（Dash & Dodge）的摄像机反馈
+
+#### 设计目标
+- **Dash（冲刺）**：强调速度感、移动感、动态感
+- **Dodge（后撤步）**：强调突然性、灵活性、敏捷感
+
+#### Dash（冲刺）的反馈设计
+
+| 效果类型 | 参数配置 | 说明 |
+|---------|---------|------|
+| **FOV变化** | +8° → 0°（0.3秒） | 冲刺时视野扩大，增强速度感 |
+| **旋转震动** | X:2° Y:1° Z:3°（0.2秒） | 轻微旋转，增加动态感 |
+| **径向模糊** | 中心扩散（0.25秒） | 运动模糊效果，增强速度感知 |
+| **色调（可选）** | 轻微偏蓝（0.2秒） | 冷色调增强速度感 |
+
+#### Dodge（后撤步）的反馈设计
+
+| 效果类型 | 参数配置 | 说明 |
+|---------|---------|------|
+| **FOV变化** | +5° → 0°（0.2秒） | 轻微扩大，比Dash弱 |
+| **旋转震动** | X:1° Y:0.5° Z:1.5°（0.15秒） | 比Dash更轻微 |
+| **径向模糊** | 中心扩散（0.15秒） | 比Dash更短促 |
+| **色调（可选）** | 轻微偏青（0.15秒） | 青色增强灵活感 |
+
+### 2.2 完美闪避（Perfect Dodge）的摄像机反馈
+
+#### 设计目标
+- **强调**：时机感、成就感、满足感
+- **核心**：时间扭曲 + 视觉强化 + 中心聚焦
+
+#### Perfect Dodge 的完整反馈设计
+
+##### 1. 时间扭曲效果
+| 效果类型 | 参数配置 | 说明 |
+|---------|---------|------|
+| **时间缩放** | 0.3x → 1.0x（0.3秒） | 瞬间慢动作，然后快速恢复 |
+| **曲线** | 先慢后快（EaseInOut） | 自然恢复 |
+
+##### 2. 中心聚焦效果
+| 效果类型 | 参数配置 | 说明 |
+|---------|---------|------|
+| **暗角强化** | 强度 0.5 → 0.2（0.4秒） | 聚焦中心，增强紧张感 |
+| **暗角中心** | 偏移到攻击来源方向 | 视觉引导 |
+| **色调偏移** | 轻微偏蓝（0.2秒） | 冷色调增强冷静感 |
+
+##### 3. 运动模糊效果
+| 效果类型 | 参数配置 | 说明 |
+|---------|---------|------|
+| **径向模糊强化** | 中心到边缘（0.2秒） | 强烈的速度感 |
+| **模糊强度** | 0.8 → 0.0（0.3秒） | 快速衰减 |
+
+##### 4. 色散效果
+| 效果类型 | 参数配置 | 说明 |
+|---------|---------|------|
+| **色差（Chromatic Aberration）** | RGB分离 0.3 → 0.0（0.25秒） | 增强视觉冲击 |
+| **分离中心** | 攻击来源方向 | 动态分离 |
+
+##### 5. 相机震动
+| 效果类型 | 参数配置 | 说明 |
+|---------|---------|------|
+| **旋转震动** | X:3° Y:2° Z:5°（0.3秒） | 比普通闪避更强 |
+| **震动曲线** | QuickImpact（快速冲击） | 即时峰值，快速衰减 |
+
+##### 6. 屏幕特效
+| 效果类型 | 参数配置 | 说明 |
+|---------|---------|------|
+| **屏幕闪光** | 中心白闪光（0.1秒） | 瞬间高亮 |
+| **Bloom强化** | 强度+0.5（0.2秒） | 增强发光效果 |
+
+#### 完美闪避反馈时间线
+
+```
+时间（秒）：  0.0  0.05  0.1  0.15  0.2  0.25  0.3  0.35  0.4
+─────────────────────────────────────────────────────────────────
+时间缩放      ████▓▒▒░░░░
+             0.3x → 1.0x
+
+FOV           ▓▓▓▒▒░░░░░
+             +8° → 0°
+
+径向模糊      ██████▓▒░░░
+             强度0.8 → 0.0
+
+暗角          ▓▓▓▓▓▒▒░░░
+             强度0.5 → 0.2
+
+色差          ████████░░░
+             分离0.3 → 0.0
+
+屏幕闪光      ██░░░░░░░░░
+             瞬间
+
+相机震动      █████▓▒░░░░
+             3°旋转
+```
+
+---
+
+## 三、需要创建/完善的反馈组件
+
+### 3.1 现有组件（可直接使用）
+
+| 组件 | 状态 | 用途 |
+|------|------|------|
+| CameraRotationShakeAction | ✅ 已存在 | 相机旋转震动 |
+| CameraFieldOfViewAction | ✅ 已存在 | FOV变化 |
+| CameraPositionShakeAction | ✅ 已存在 | 相机位置震动 |
+| RadialBlurAction | ✅ 已存在 | 径向模糊 |
+| VignetteAction | ✅ 已存在 | 暗角效果 |
+| ChromaticAberrationAction | ✅ 已存在 | 色差效果 |
+| TimeScaleModifierAction | ✅ 已存在 | 时间缩放 |
+
+### 3.2 需要创建的新组件
+
+#### 1. MotionBlurAction（运动模糊）
+**优先级**：P0 - 必须
+
+**功能**：
+- 控制运动模糊效果（SpeedLines或MotionBlur后处理）
+- 支持模糊强度、方向、中心点控制
+
+**参数**：
+```csharp
+public class MotionBlurAction : CurveShakeAction
+{
+    public bool modifyDirection;      // 是否修改方向
+    public Vector2 direction;          // 模糊方向
+    
+    public bool modifyStrength;        // 是否修改强度
+    public float strengthMin;         // 最小模糊强度
+    public float strengthMax;         // 最大模糊强度
+    
+    public bool modifySamples;        // 是否修改采样数
+    public int samplesMin;            // 最小采样数
+    public int samplesMax;            // 最大采样数
+}
+```
+
+#### 2. ScreenFlashAction（屏幕闪光）
+**优先级**：P1 - 重要
+
+**功能**：
+- 控制屏幕中心的白闪光效果
+- 支持颜色、强度、衰减速度控制
+
+**参数**：
+```csharp
+public class ScreenFlashAction : FeedbackActionBase
+{
+    [Title("Flash Settings")]
+    public Color flashColor = Color.white;
+    public float maxIntensity = 1.0f;
+    public AnimationCurve fadeCurve;  // 衰减曲线
+    
+    public bool useCenterOffset;      // 是否使用中心偏移
+    public Vector2 centerOffset;      // 中心偏移
+    
+    public bool affectBloom;          // 是否影响Bloom
+    public float bloomIntensity = 0.5f;
+}
+```
+
+#### 3. ColorGradeAction（色调调整）
+**优先级**：P2 - 可选
+
+**功能**：
+- 动态调整画面色调
+- 支持色温、色调、对比度调整
+
+**参数**：
+```csharp
+public class ColorGradeAction : FeedbackActionBase
+{
+    public bool modifyTemperature;    // 是否修改色温
+    public float temperatureMin;      // 冷色调（负值）
+    public float temperatureMax;      // 暖色调（正值）
+    
+    public bool modifyTint;           // 是否修改色调
+    public Color tintColor;          // 色调颜色
+    
+    public bool modifySaturation;     // 是否修改饱和度
+    public float saturationOffset;     // 饱和度偏移
+}
+```
+
+#### 4. SpeedLinesAction（速度线）
+**优先级**：P1 - 重要
+
+**功能**：
+- 控制屏幕边缘的速度线效果
+- 增强速度感和动态感
+
+**参数**：
+```csharp
+public class SpeedLinesAction : CurveShakeAction
+{
+    [Title("Speed Lines Settings")]
+    public bool modifyCount;         // 是否修改线条数量
+    public int countMin;             // 最小线条数
+    public int countMax;             // 最大线条数
+    
+    public bool modifyLength;        // 是否修改线条长度
+    public float lengthMin;          // 最小长度
+    public float lengthMax;          // 最大长度
+    
+    public bool modifyOpacity;       // 是否修改不透明度
+    public float opacityMin;         // 最小不透明度
+    public float opacityMax;         // 最大不透明度
+    
+    public bool modifyCenter;        // 是否修改中心
+    public Vector2 center;          // 中心点
+}
+```
+
+---
+
+## 四、实现计划
+
+### 4.1 Phase 1: 普通闪避反馈（1天）
+
+#### 目标
+实现 Dash 和 Dodge 的基本摄像机反馈
+
+#### 任务
+1. [ ] **创建/配置 Dash FeedbackData**
+   - 名称：`DodgeDash`
+   - Track 1: "Camera" - CameraFieldOfViewAction
+     - FOV: +8° → 0°（0.3秒）
+   - Track 2: "Camera" - CameraRotationShakeAction
+     - Rotation: (2°, 1°, 3°)
+     - Curve: SmoothBump
+   - Track 3: "PostProcess" - RadialBlurAction
+     - Intensity: 0.3 → 0.0（0.25秒）
+
+2. [ ] **创建/配置 Dodge FeedbackData**
+   - 名称：`DodgeBackstep`
+   - Track 1: "Camera" - CameraFieldOfViewAction
+     - FOV: +5° → 0°（0.2秒）
+   - Track 2: "Camera" - CameraRotationShakeAction
+     - Rotation: (1°, 0.5°, 1.5°)
+     - Curve: QuickImpact
+   - Track 3: "PostProcess" - RadialBlurAction
+     - Intensity: 0.2 → 0.0（0.15秒）
+
+3. [ ] **修改 PlayerAnimationSubcontroller**
+   - SetupDash() 使用新的"DodgeDash" FeedbackData
+   - SetupDodge() 使用新的"DodgeBackstep" FeedbackData
+
+4. [ ] **测试调整**
+   - 根据实际效果调整参数
+   - 确保Dash和Dodge有明显区别
+
+### 4.2 Phase 2: 完美闪避反馈（1-2天）
+
+#### 目标
+实现 Perfect Dodge 的特殊摄像机反馈
+
+#### 任务
+1. [ ] **创建 ScreenFlashAction（如果尚未实现）**
+   - 屏幕中心白闪光
+   - 快速衰减
+
+2. [ ] **创建 MotionBlurAction（如果尚未实现）**
+   - 运动模糊效果
+   - 支持方向和强度控制
+
+3. [ ] **创建/配置 Perfect Dodge FeedbackData**
+   - 名称：`PerfectDodge`
+   
+   - Track 1: "Time" - TimeScaleModifierAction
+     - Mode: Dynamic
+     - Curve: Custom（0.3x → 1.0x）
+     - Duration: 0.3秒
+   
+   - Track 2: "Camera" - CameraFieldOfViewAction
+     - FOV: +8° → 0°（0.3秒）
+   
+   - Track 3: "Camera" - CameraRotationShakeAction
+     - Rotation: (3°, 2°, 5°)
+     - Curve: QuickImpact
+     - Duration: 0.3秒
+   
+   - Track 4: "PostProcess" - VignetteAction
+     - Intensity: 0.5 → 0.2（0.4秒）
+     - 中心偏移到攻击来源
+   
+   - Track 5: "PostProcess" - RadialBlurAction
+     - Intensity: 0.8 → 0.0（0.3秒）
+   
+   - Track 6: "PostProcess" - ChromaticAberrationAction
+     - Intensity: 0.3 → 0.0（0.25秒）
+   
+   - Track 7: "Effect" - ScreenFlashAction
+     - Color: White
+     - Intensity: 1.0 → 0.0（0.1秒）
+   
+   - Track 8: "Effect" - BloomEnhanceAction（可选）
+     - Intensity: +0.5（0.2秒）
+
+4. [ ] **修改 DodgeSource.Default() 工厂方法**
+   - 更新 PerfectDodge 回调逻辑
+   - 确保所有反馈正确触发
+
+5. [ ] **测试调整**
+   - 调整时间曲线
+   - 确保慢动作效果明显
+   - 优化视觉效果
+
+### 4.3 Phase 3: 优化和细节（1天）
+
+#### 目标
+完善细节，提升品质
+
+#### 任务
+1. [ ] **添加速度线效果（SpeedLines）**
+   - 冲刺时显示速度线
+   - 增强速度感
+
+2. [ ] **添加色调调整（可选）**
+   - Dash: 冷色调（蓝）
+   - Dodge: 青色（青绿）
+   - Perfect Dodge: 偏蓝
+
+3. [ ] **创建编辑器预览工具**
+   - 在Editor中预览闪避效果
+   - 快速调整参数
+
+4. [ ] **性能优化**
+   - 确保反馈系统不会造成性能问题
+   - 优化后处理效果
+
+5. [ ] **创建反馈预设库**
+   - Dash_Powerful（强力冲刺）
+   - Dash_Light（轻盈冲刺）
+   - Dodge_Quick（快速后撤）
+   - Dodge_Strong（强力后撤）
+   - PerfectDodge_Time（时间扭曲型）
+   - PerfectDodge_Impact（冲击型）
+
+---
+
+## 五、参数配置建议
+
+### 5.1 Dash（冲刺）
+
+```csharp
+// DodgeDash FeedbackData
+{
+    // FOV
+    FOV Offset: +8°
+    FOV Duration: 0.3s
+    FOV Curve: EaseOut
+    
+    // Rotation Shake
+    Rotation: (2°, 1°, 3°)
+    Duration: 0.2s
+    Curve: SmoothBump
+    
+    // Radial Blur
+    Intensity: 0.3
+    Duration: 0.25s
+    Center: Dynamic (player screen position)
+}
+```
+
+### 5.2 Dodge（后撤步）
+
+```csharp
+// DodgeBackstep FeedbackData
+{
+    // FOV
+    FOV Offset: +5°
+    FOV Duration: 0.2s
+    FOV Curve: EaseOut
+    
+    // Rotation Shake
+    Rotation: (1°, 0.5°, 1.5°)
+    Duration: 0.15s
+    Curve: QuickImpact
+    
+    // Radial Blur
+    Intensity: 0.2
+    Duration: 0.15s
+    Center: Dynamic (player screen position)
+}
+```
+
+### 5.3 Perfect Dodge
+
+```csharp
+// PerfectDodge FeedbackData
+{
+    // Time Scale
+    Time Scale: 0.3x → 1.0x
+    Duration: 0.3s
+    Curve: EaseInOut
+    
+    // FOV
+    FOV Offset: +10°
+    FOV Duration: 0.4s
+    FOV Curve: EaseOut
+    
+    // Rotation Shake
+    Rotation: (3°, 2°, 5°)
+    Duration: 0.3s
+    Curve: QuickImpact
+    
+    // Vignette
+    Intensity: 0.5 → 0.2
+    Duration: 0.4s
+    Center Offset: Attack direction
+    
+    // Radial Blur
+    Intensity: 0.8 → 0.0
+    Duration: 0.3s
+    Center: Dynamic
+    
+    // Chromatic Aberration
+    Intensity: 0.3 → 0.0
+    Duration: 0.25s
+    
+    // Screen Flash
+    Color: White
+    Intensity: 1.0 → 0.0
+    Duration: 0.1s
+}
+```
+
+---
+
+## 六、实现建议
+
+### 6.1 创建流程
+
+1. **创建 FeedbackData**
+   - 在 `Resources/Feedbacks/` 目录下创建
+   - 命名为 `DodgeDash.asset`, `DodgeBackstep.asset`, `PerfectDodge.asset`
+
+2. **配置 FeedbackTracks**
+   - 为每个效果创建独立的 Track
+   - 建议 Track 命名：
+     - "Camera" - 相机相关效果
+     - "PostProcess" - 后处理效果
+     - "Effect" - 特殊效果
+     - "Time" - 时间控制
+
+3. **添加 FeedbackClips**
+   - 在每个 Track 中添加 Clip
+   - 配置时间范围
+   - 选择对应的 FeedbackAction
+
+4. **配置 FeedbackAction 参数**
+   - 根据设计文档调整参数
+   - 使用预设曲线
+   - 设置正确的持续时间
+
+5. **在代码中引用**
+   - 在 `PlayerAnimationSubcontroller` 中引用 FeedbackData
+   - 在 `DodgeSource` 中配置 PerfectDodge 回调
+
+### 6.2 代码修改建议
+
+#### DodgeSource.Default() 工厂方法修改
+
+```csharp
+public static DodgeSource Default(CharacterBase sourceCharacter, float duration = Mathf.Infinity)
+{
+    DodgeSource defaultDodge = new DodgeSource(
+        sourceCharacter, null, "DefaultDodge", 0, 
+        "NormalDodge", "PerfectDodge", duration, 0.2f
+    );
+    
+    if (sourceCharacter is Player player)
+    {
+        // 普通闪避反馈
+        defaultDodge.onNormalDodge = () =>
+        {
+            // 可以根据闪避类型（Dash/Dodge）播放不同的反馈
+            // player.feedbackSc["NormalDodge"].Play();
+        };
+        
+        // 完美闪避反馈
+        defaultDodge.onPerfectDodge = () =>
+        {
+            // 更新效果中心点
+            var radialBlur = player.feedbackSc["PerfectDodge"].feedback
+                .GetFeedbackOfType<RadialBlurAction>();
+            if (radialBlur != null)
+            {
+                radialBlur.modifyCenter = true;
+                radialBlur.center = player.GetNormalizedScreenPosition();
+            }
+            
+            var vignette = player.feedbackSc["PerfectDodge"].feedback
+                .GetFeedbackOfType<VignetteAction>();
+            if (vignette != null)
+            {
+                vignette.modifyCenter = true;
+                vignette.center = player.GetNormalizedScreenPosition();
+            }
+            
+            // 播放完美闪避反馈
+            player.feedbackSc["PerfectDodge"].Play();
+            
+            Debug.Log("Perfect Dodge!");
+        };
+    }
+    return defaultDodge;
+}
+```
+
+#### PlayerAnimationSubcontroller 修改
+
+```csharp
+// SetupDash() 中
+public void SetupDash(Vector3 direction, bool isInputDirection, float length)
+{
+    if (player.movementSc.canDash && player.movementSc.canDodge && 
+        fullBodyFuncAnimSm.Play("Dash"))
+    {
+        length = length < 0 ? player.attributeSm["DashLength"] : length;
+        float dashMultiplier = length / fullBodyFuncAnimSm.collection["Dash"]
+            .variableCollection.GetVariable<float>("RootMoveZ");
+        player.landMovementSc.dashMoveMultiplier = dashMultiplier;
+        
+        // 根据方向计算相机旋转
+        Vector3 cameraForward = player.viewSc.playerCamera.transform.forward.Flatten();
+        Vector3 dashCameraRotation;
+        if (isInputDirection)
+        {
+            player.landMovementSc.TurnToInputDirection(direction);
+            Vector3 playerForward = player.transform.forward.Flatten();
+            dashCameraRotation = CalculateDashAngles(playerForward, cameraForward);
+        }
+        else
+        {
+            player.landMovementSc.TurnToDirection(direction, 0f);
+            dashCameraRotation = CalculateDashAngles(direction, cameraForward);
+        }
+        
+        // 配置动态参数
+        var rotationShake = player.feedbackSc["DodgeDash"].feedback
+            .GetFeedbackOfType<CameraRotationShakeAction>();
+        if (rotationShake != null)
+        {
+            rotationShake.directionSettings.targetDirection = direction;
+        }
+        
+        // 播放 Dash 反馈
+        player.feedbackSc["DodgeDash"].Play();
+    }
+}
+
+// SetupDodge() 中
+public void SetupDodge(float length)
+{
+    if (player.movementSc.canDodge && fullBodyFuncAnimSm.Play("Dodge"))
+    {
+        length = length < 0 ? player.attributeSm["DodgeLength"] : length;
+        float dashMultiplier = length / fullBodyFuncAnimSm.collection["Dodge"]
+            .variableCollection.GetVariable<float>("RootMoveZ");
+        player.landMovementSc.dashMoveMultiplier = dashMultiplier;
+        
+        // 配置动态参数
+        var rotationShake = player.feedbackSc["DodgeBackstep"].feedback
+            .GetFeedbackOfType<CameraRotationShakeAction>();
+        if (rotationShake != null)
+        {
+            rotationShake.directionSettings.targetDirection = -player.transform.forward.Flatten();
+        }
+        
+        // 播放 Dodge 反馈
+        player.feedbackSc["DodgeBackstep"].Play();
+    }
+}
+```
+
+---
+
+## 七、测试清单
+
+### 7.1 功能测试
+
+- [ ] Dash 反馈正常播放
+- [ ] Dodge 反馈正常播放
+- [ ] Perfect Dodge 反馈正常播放
+- [ ] 所有效果平滑过渡
+- [ ] 无视觉抖动或撕裂
+- [ [ ] 时间缩放正常工作
+- [ ] 后处理效果正常工作
+
+### 7.2 性能测试
+
+- [ ] 60 FPS 稳定运行
+- [ ] 无内存泄漏
+- [ ] Feedback 实例正确回收
+- [ ] 后处理效果不影响性能
+
+### 7.3 体验测试
+
+- [ ] Dash 速度感明显
+- [ ] Dodge 突然性明显
+- [ ] Perfect Dodge 成就感强烈
+- [ ] 效果与动作匹配
+- [ ] 反馈强度适中（不晕眩）
+
+---
+
+## 八、后续优化方向
+
+### 8.1 高级功能
+
+1. **动态反馈强度**
+   - 根据冲刺距离调整反馈强度
+   - 根据完美闪避时机早晚调整强度
+
+2. **连闪避加成**
+   - 连续完美闪避时增强反馈
+   - 视觉上越来越夸张
+
+3. **敌人攻击适配**
+   - 根据攻击类型调整反馈
+   - 重攻击有更强的反馈
+
+### 8.2 辅助功能
+
+1. **难度设置**
+   - 新手模式：增强反馈提示
+   - 高手模式：减少辅助反馈
+
+2. **无障碍选项**
+   - 减少运动模糊
+   - 减少时间缩放
+   - 减少屏幕效果
+
+---
+
+*文档生成日期: 2026-04-17*  
+*生成者: Game Designer Agent*