docs(all) 添加注释

systems/SelectionSystem.js

@@ -1,70 +1,105 @@
-// systems/SelectionSystem.js
+// 选择系统：处理游戏中单位的选择逻辑，包括单个单位点击选择和多个单位框选
+
+// 从ControlMode.js导入选择管理相关的函数
 import { clearSelection, addToSelection, setActiveUnit } from './ControlMode.js';
 
+// 导出SelectionSystem类，用于创建选择系统实例
 export class SelectionSystem {
+  // 构造函数：初始化选择系统
+  // @param {Object} scene - 游戏场景实例
   constructor(scene) {
+    // 保存场景引用，用于访问游戏世界和发送事件
     this.scene = scene;
+    
+    // 选择框对象，用于显示框选区域
+    // 初始值为null，表示当前没有选择框
     this.selectionBox = null;
 
+    // 注册事件监听器，处理选择相关的事件
+    // 当开始选择时调用onStart方法
     scene.events.on('selection-start', this.onStart, this);
+    // 当选择区域更新时调用onUpdate方法
     scene.events.on('selection-update', this.onUpdate, this);
+    // 当选择结束时调用onEnd方法
     scene.events.on('selection-end', this.onEnd, this);
+    // 当选择单个单位时调用onSelectUnit方法
     scene.events.on('select-unit', this.onSelectUnit, this);
   }
 
+  // 处理选择开始事件
+  // @param {Object} pos - 选择开始的位置，包含x和y坐标
   onStart(pos) {
+    // 如果选择框不存在，则创建一个新的选择框
     if (!this.selectionBox) {
+      // 在游戏世界中创建一个矩形作为选择框
       this.selectionBox = this.scene.add.rectangle(pos.x, pos.y, 1, 1, 0x00ff00, 0.3)
-        .setStrokeStyle(1, 0xffffff)
-        .setVisible(true);
+        .setStrokeStyle(1, 0xffffff) // 设置白色边框，宽度为1像素
+        .setVisible(true); // 设置选择框可见
     } else {
+      // 如果选择框已存在，重置其位置和大小并设置可见
       this.selectionBox.setPosition(pos.x, pos.y).setSize(1, 1).setVisible(true);
     }
   }
 
+  // 处理选择区域更新事件
+  // @param {Object} rect - 更新后的选择区域矩形
   onUpdate(rect) {
+    // 如果选择框存在且可见
     if (this.selectionBox && this.selectionBox.visible) {
-      // 更新选择框的位置和大小
+      // 更新选择框的位置到矩形中心
       this.selectionBox.setPosition(rect.centerX, rect.centerY);
+      // 更新选择框的大小到矩形的宽度和高度
       this.selectionBox.setSize(rect.width, rect.height);
     }
   }
 
+  // 处理选择单个单位事件
+  // @param {Object} unit - 被选择的单位对象
   onSelectUnit(unit) {
     // 清除所有单位的选中状态
     this.scene.unitGroup.getChildren().forEach(u => {
+      // 检查单位是否有setSelected方法
       if (u.setSelected) {
+        // 设置单位为未选中状态
         u.setSelected(false);
       }
     });
     
-    // 清除当前选择
+    // 清除当前的选择列表和激活单位
     clearSelection();
     
-    // 选择点击的单位
+    // 设置点击的单位为激活单位
     setActiveUnit(unit);
+    // 将点击的单位添加到选择列表
     addToSelection(unit);
     
-    // 设置选中状态
+    // 设置点击的单位为选中状态
     if (unit.setSelected) {
       unit.setSelected(true);
     }
     
+    // 发送单位选中事件，通知其他系统
     this.scene.events.emit('units-selected', [unit]);
   }
   
+  // 处理选择结束事件
+  // @param {Object} rect - 最终的选择区域矩形
   onEnd(rect) {
+    // 如果选择框存在，将其设置为不可见
     if (this.selectionBox) {
       this.selectionBox.setVisible(false);
     }
 
+    // 获取场景中所有的单位
     const units = this.scene.unitGroup.getChildren();
+    
+    // 筛选出在选择区域内的单位
     const selected = units.filter(unit => {
+      // 获取单位的边界矩形
       const unitRect = unit.getBounds();
+      // 检查单位的边界矩形是否与选择区域重叠
       return Phaser.Geom.Rectangle.Overlaps(rect, unitRect);
     });
-    
-
 
     // 先清除所有单位的选中状态
     units.forEach(unit => {
@@ -73,18 +108,23 @@ export class SelectionSystem {
       }
     });
 
+    // 清除当前的选择列表和激活单位
     clearSelection();
 
+    // 如果有单位被选中
     if (selected.length > 0) {
-      // 先设置激活单位
+      // 设置选中列表中的第一个单位为激活单位
       setActiveUnit(selected[0]);
-      // 然后添加所有选中的单位（包括激活单位）
+      
+      // 将所有选中的单位添加到选择列表并设置为选中状态
       selected.forEach(unit => {
         addToSelection(unit);
         if (unit.setSelected) {
           unit.setSelected(true);
         }
       });
+      
+      // 发送单位选中事件，通知其他系统
       this.scene.events.emit('units-selected', selected);
     }
   }