命令树优化，测试编辑区域优化

DeviceCommand/Devices/IOBoard.cs

@@ -12,22 +12,39 @@ using System.Threading.Tasks;
 namespace DeviceCommand.Devices
 {
     /// <summary>
-    ///  IO板卡 一对一由于板卡映射不完全一样采用IOGroup
+    /// IO 继电器板卡（一对一控制），基于 Modbus TCP 协议通过线圈（Coil）读写控制继电器输出。
+    /// 由于多块板卡的点位映射不完全一致，实际业务中使用 <see cref="IOBoardGroup"/> 统一调度三块板卡。
     /// </summary>
     //[ACPCommand]
     public class IOBoard : ModbusTcp
     {
-        
+        /// <summary>
+        /// 构造函数，初始化 Modbus TCP 连接配置。
+        /// </summary>
+        /// <param name="config">TCP 连接配置（IP、端口等）</param>
         public IOBoard(TcpConfig config) : base(config)
         {
            
         }
 
-
+        /// <summary>
+        /// 写入单个输出开关（线圈）状态。
+        /// </summary>
+        /// <param name="站号">Modbus 从站站号</param>
+        /// <param name="开始地址">线圈地址（0 起始）</param>
+        /// <param name="data">开关状态（true: 吸合/开启, false: 断开/关闭）</param>
         public async Task 写输出开关(byte 站号, ushort 开始地址, bool data)
         {
             await Modbus.WriteSingleCoilAsync(站号, 开始地址, data);
         }
+
+        /// <summary>
+        /// 批量写入输出开关状态。先读出全部 16 个线圈当前状态，
+        /// 在内存中修改指定偏移段的值后再整体写回，避免影响其他点位。
+        /// </summary>
+        /// <param name="站号">Modbus 从站站号</param>
+        /// <param name="开始地址">起始线圈地址（0 起始）</param>
+        /// <param name="datas">要写入的开关状态数组，按顺序从开始地址写入</param>
         public async Task 批量写输出开关(byte 站号, ushort 开始地址, bool[] datas)
         {
             var 批量写入 = await Modbus.ReadCoilsAsync(1, 0, 16);
@@ -40,10 +57,24 @@ namespace DeviceCommand.Devices
             }
             await Modbus.WriteMultipleCoilsAsync(站号, 0, 批量写入);
         }
+
+        /// <summary>
+        /// 读取单个输出开关（线圈）状态。
+        /// </summary>
+        /// <param name="站号">Modbus 从站站号</param>
+        /// <param name="开始地址">线圈地址（0 起始）</param>
         public async Task 读输出开关(byte 站号, ushort 开始地址)
         {
             await Modbus.ReadCoilsAsync(站号, 开始地址, 1);
         }
+
+        /// <summary>
+        /// 批量读取输出开关（线圈）状态。
+        /// </summary>
+        /// <param name="站号">Modbus 从站站号</param>
+        /// <param name="开始地址">起始线圈地址（0 起始）</param>
+        /// <param name="数量">要读取的线圈数量</param>
+        /// <returns>线圈状态数组，true 表示吸合/开启</returns>
         public async Task<bool[]> 批量读输出开关(byte 站号, ushort 开始地址,ushort 数量)
         {
             return await Modbus.ReadCoilsAsync(站号, 开始地址, 数量);