docs(all) 添加注释

systems/ControlMode.js

@@ -1,24 +1,44 @@
+// 游戏控制模式常量定义
+// 这些常量用于指定游戏当前使用的控制方式
 export const CONTROL_MODE = {
-  SINGLE: 'single',
-  GROUP: 'group',
-  JOYSTICK: 'joystick'
+  SINGLE: 'single',       // 单单位控制模式：只控制当前激活的单个单位
+  GROUP: 'group',         // 组控制模式：同时控制多个选中的单位
+  JOYSTICK: 'joystick'    // 摇杆控制模式：使用虚拟摇杆控制单位
 };
 
+// 当前激活的单位变量
+// 用于存储当前玩家正在直接控制的单个单位
+// 初始值为null，表示没有激活的单位
 export let activeUnit = null;
+
+// 选中的单位列表
+// 用于存储玩家当前选中的所有单位
+// 初始值为空数组，表示没有选中任何单位
 export let selectedUnits = [];
 
+// 设置当前激活单位的函数
+// @param {Object} unit - 要设置为激活状态的单位对象
 export function setActiveUnit(unit) {
+  // 将传入的单位设置为当前激活单位
   activeUnit = unit;
-  // 不再重置selectedUnits数组，这样可以同时选中多个单位
+  // 注意：这里不再重置selectedUnits数组，这样可以同时选中多个单位
+  // 而只激活其中一个作为当前操作的单位
 }
 
+// 将单位添加到选择列表的函数
+// @param {Object} unit - 要添加到选择列表的单位对象
 export function addToSelection(unit) {
+  // 检查单位是否已经在选择列表中，如果不在则添加
   if (!selectedUnits.includes(unit)) {
+    // 将单位添加到选择列表的末尾
     selectedUnits.push(unit);
   }
 }
 
+// 清除选择列表的函数
 export function clearSelection() {
+  // 将当前激活单位设置为null（取消激活）
   activeUnit = null;
+  // 将选中的单位列表重置为空数组（取消所有选择）
   selectedUnits = [];
 }