# 拖动功能问题修复说明

## 问题描述
禁用调试工具的拖动功能后（`enableDragging = false`），发现其他UI上的棋子也无法拖动了。

## 问题原因

### Unity事件系统机制
在Unity的事件系统中，当一个GameObject实现了拖动接口（`IBeginDragHandler`, `IDragHandler`, `IEndDragHandler`）时：

1. **事件会被该对象"拦截"**：即使在方法内部直接 `return`，Unity也认为该对象已经处理了事件
2. **事件不会继续传递**：被拦截的事件不会传递给下层或其他UI元素
3. **影响范围广泛**：这会导致场景中所有在该对象下方的可拖动UI元素都无法接收拖动事件

### 之前的实现问题
```csharp
public void OnBeginDrag(PointerEventData eventData)
{
    if (!enableDragging) return; // ❌ 直接返回，但事件已被拦截
    // ... 正常的拖动逻辑
}
```

这种实现方式会导致：
- 调试工具的悬浮按钮拦截了所有拖动事件
- 其他UI元素（如棋子）无法接收到拖动事件
- 即使 `enableDragging = false`，问题依然存在

## 解决方案

### 核心思路
当 `enableDragging = false` 时，不应该简单地返回，而是应该将事件**主动传递**给其他可以处理该事件的UI元素。

### 实现细节

#### 1. 修改拖动事件处理方法
在 `OnBeginDrag`, `OnDrag`, `OnEndDrag` 中添加事件传递逻辑：

```csharp
public void OnBeginDrag(PointerEventData eventData)
{
    if (!enableDragging)
    {
        // ✅ 将事件传递给父级或下层UI元素
        PassEventToParent(eventData, ExecuteEvents.beginDragHandler);
        return;
    }
    // ... 正常的拖动逻辑
}
```

#### 2. 实现事件传递方法
添加 `PassEventToParent` 方法，按以下顺序尝试传递事件：

```csharp
private void PassEventToParent<T>(PointerEventData eventData, ExecuteEvents.EventFunction<T> eventFunction) 
    where T : IEventSystemHandler
{
    // 步骤1: 向上传递给父级对象
    Transform parent = transform.parent;
    while (parent != null)
    {
        if (ExecuteEvents.Execute(parent.gameObject, eventData, eventFunction))
        {
            return; // 父级处理了，停止传递
        }
        parent = parent.parent;
    }

    // 步骤2: 如果父级都没处理，传递给射线检测到的下一个对象
    var raycastResults = new List<RaycastResult>();
    EventSystem.current.RaycastAll(eventData, raycastResults);
    
    foreach (var result in raycastResults)
    {
        if (result.gameObject == gameObject)
            continue; // 跳过自己
            
        if (ExecuteEvents.Execute(result.gameObject, eventData, eventFunction))
        {
            return; // 下层对象处理了，停止传递
        }
    }
}
```

### 工作原理

1. **事件拦截**：悬浮按钮首先接收到拖动事件
2. **条件判断**：检查 `enableDragging` 是否为 `false`
3. **向上传递**：尝试将事件传递给父级对象树
4. **射线检测**：如果父级未处理，通过射线检测找到下层UI元素
5. **事件执行**：让找到的对象执行相应的拖动事件处理

## 修改文件
- `Packages/com.bywaystudios.meowmentdebugtool/Runtime/DraggableFloatingButton.cs`
  - 修改 `OnBeginDrag` 方法
  - 修改 `OnDrag` 方法
  - 修改 `OnEndDrag` 方法
  - 新增 `PassEventToParent` 方法

## 测试建议

### 测试场景1：禁用拖动模式
1. 设置 `enableDragging = false`
2. 点击悬浮按钮 → 应该正常打开调试窗口
3. 尝试拖动其他UI上的棋子 → **应该能够正常拖动**

### 测试场景2：启用拖动模式
1. 设置 `enableDragging = true`
2. 拖动悬浮按钮 → 应该能够正常拖动
3. 点击悬浮按钮（不拖动）→ 应该打开调试窗口

### 测试场景3：多层UI叠加
1. 创建多个可拖动的UI元素，部分重叠
2. 确保悬浮按钮在最上层
3. 禁用悬浮按钮拖动后，测试下层UI元素能否正常拖动

## 技术要点

### Unity事件传递机制
- `ExecuteEvents.Execute()`：手动触发事件处理
- `EventSystem.RaycastAll()`：获取所有被射线击中的UI元素
- 事件处理器接口：`IEventSystemHandler`

### 泛型约束
使用泛型方法支持不同类型的事件处理：
```csharp
private void PassEventToParent<T>(...) where T : IEventSystemHandler
```

### 事件类型
- `ExecuteEvents.beginDragHandler` - 开始拖动
- `ExecuteEvents.dragHandler` - 拖动中
- `ExecuteEvents.endDragHandler` - 结束拖动

## 可能的副作用

### 性能考虑
- `RaycastAll` 会执行完整的射线检测，可能有轻微性能开销
- 仅在 `enableDragging = false` 时触发，实际影响很小

### 兼容性
- 需要确保场景中有 `EventSystem`
- 依赖 Unity 的 EventSystem 模块

## 总结
通过主动传递事件而不是简单地忽略事件，解决了禁用拖动后影响其他UI元素的问题。这是一个典型的UI事件系统问题，需要理解Unity的事件传递机制才能正确处理。