chore(UnitTests): add test cases

- and add [ExcludeFromCodeCoverage]

Author: moomiji

src/MaaFramework.Binding.Native/Buffers/MaaImageBuffer.cs

@@ -12,6 +12,7 @@ namespace MaaFramework.Binding.Buffers;
 public class MaaImageBuffer : MaaDisposableHandle<MaaImageBufferHandle>, IMaaImageBuffer<MaaImageBufferHandle>, IMaaImageBufferStatic<MaaImageBufferHandle>
 {
     /// <inheritdoc/>
+    [ExcludeFromCodeCoverage(Justification = "Debugger display.")]
     public override string ToString() => IsInvalid
         ? $"Invalid {GetType().Name}"
         : $"{GetType().Name}: {Width}x{Height} {{ {nameof(Channels)} = {Channels}, {nameof(Type)} = {Type} }}";

src/MaaFramework.Binding.Native/Buffers/MaaRectBuffer.cs

@@ -1,4 +1,5 @@
-using MaaFramework.Binding.Abstractions;
+using System.Diagnostics.CodeAnalysis;
+using MaaFramework.Binding.Abstractions;
 using static MaaFramework.Binding.Interop.Native.MaaBuffer;
 
 namespace MaaFramework.Binding.Buffers;
@@ -9,6 +10,7 @@ namespace MaaFramework.Binding.Buffers;
 public class MaaRectBuffer : MaaDisposableHandle<MaaRectHandle>, IMaaRectBuffer<MaaRectHandle>, IMaaRectBufferStatic<MaaRectHandle>
 {
     /// <inheritdoc/>
+    [ExcludeFromCodeCoverage(Justification = "Debugger display.")]
     public override string ToString() => IsInvalid
         ? $"Invalid {GetType().Name}"
         : $"{GetType().Name} {{ {nameof(X)} = {X}, {nameof(Y)} = {Y}, {nameof(Width)} = {Width}, {nameof(Height)} = {Height} }}";

src/MaaFramework.Binding.Native/MaaController.cs

@@ -19,6 +19,7 @@ public class MaaController : MaaCommon, IMaaController<MaaControllerHandle>
         ? $"Invalid {GetType().Name}"
         : $"{GetType().Name} {{ }}";
 
+    [ExcludeFromCodeCoverage(Justification = "Test for stateful mode.")]
     internal MaaController(MaaControllerHandle handle)
     {
         SetHandle(handle, needReleased: false);

src/MaaFramework.Binding.Native/MaaResource.cs

@@ -15,10 +15,12 @@ public class MaaResource : MaaCommon, IMaaResource<MaaResourceHandle>
     private readonly HashSet<string> _postedPaths = [];
 
     /// <inheritdoc/>
+    [ExcludeFromCodeCoverage(Justification = "Debugger display.")]
     public override string ToString() => IsInvalid
         ? $"Invalid {GetType().Name}"
         : $"{GetType().Name} {{ Paths = [{string.Join(", ", _postedPaths)}], CustomActions = [{string.Join(", ", _actions.Names)}] , CustomRecognitions = [{string.Join(" & ", _recognitions.Names)}] }}";
 
+    [ExcludeFromCodeCoverage(Justification = "Test for stateful mode.")]
     internal MaaResource(MaaResourceHandle handle)
     {
         SetHandle(handle, needReleased: false);

src/MaaFramework.Binding.Native/MaaTasker.cs

@@ -30,6 +30,7 @@ public class MaaTasker : MaaCommon, IMaaTasker<MaaTaskerHandle>
 
 #pragma warning disable CS8618 // 在退出构造函数时，不可为 null 的字段必须包含非 null 值。请考虑添加 "required" 修饰符或声明为可为 null。
     [SetsRequiredMembers]
+    [ExcludeFromCodeCoverage(Justification = "Test for stateful mode.")]
     internal MaaTasker(MaaTaskerHandle handle)
     {
         SetHandle(handle, needReleased: false);
@@ -252,6 +253,7 @@ public MaaTaskJob Stop()
     ///     Wrapper of <see cref="MaaTaskerPostStop"/>.
     /// </remarks>
     [Obsolete("Use Stop() instead.")]
+    [ExcludeFromCodeCoverage(Justification = "Use Stop() instead.")]
     public MaaTaskJob Abort() => Stop();
 
     /// <inheritdoc/>

src/MaaFramework.Binding.UnitTests/Test_Buffers.cs

@@ -89,6 +89,8 @@ public void Test_MaaImage_NoCache(MaaTypes type, MaaImage image)
     {
         Assert.IsNotNull(image);
         Assert.IsNotNull(image.Buffer);
+        Assert.IsFalse(
+            image.IsStateless);
 
         Assert.AreEqual(
             "MaaImage: 1920x1080 { Channels = 3, Type = 16 }", image.ToString());
@@ -114,6 +116,8 @@ public void Test_MaaImage_Cache(MaaTypes type, MaaImage image)
     {
         Assert.IsNotNull(image);
         Assert.IsNotNull(image.Buffer);
+        Assert.IsFalse(
+            image.IsStateless);
 
         Assert.IsTrue(
             image.TryCache());

src/MaaFramework.Binding.UnitTests/Test_Custom.cs

@@ -22,6 +22,15 @@ internal static class Custom
         }
     }
     """;
+    public static string DirectCustomAction = $$"""
+    {
+        "{{nameof(DirectCustomAction)}}": {
+            "action": "Custom",
+            "custom_action": "{{nameof(EmptyAction)}}"
+        }
+    }
+    """;
+
     private static string RecognitionParam => $$"""{"{{nameof(RecognitionParam)}}":true}""";
     private static string ActionParam => $$"""{"{{nameof(ActionParam)}}":true}""";
     private static string Detail { get; set; } = string.Empty;
@@ -127,6 +136,16 @@ public bool Run(in IMaaContext context, in RunArgs args, in RunResults results)
         }
     }
 
+    internal sealed class EmptyAction : IMaaCustomAction
+    {
+        public string Name { get; set; } = nameof(EmptyAction);
+
+        public bool Run(in IMaaContext context, in RunArgs args, in RunResults results)
+        {
+            return true;
+        }
+    }
+
     internal sealed class TestController(IMaaController c) : IMaaCustomController, IMaaDisposable
     {
         #region Test_IMaaDisposable

src/MaaFramework.Binding.UnitTests/Test_IMaaAgentClient.cs

@@ -90,7 +90,7 @@ public void Interface_LinkStart_LinkStop_AgentServerProcess_IsConnected_IsAlive_
             maaAgentClient.LinkStop());
         Assert.IsTrue( // double stop
             maaAgentClient.LinkStop());
-        Task.Delay(100).Wait(); // wait for process exit
+        Task.Delay(1000).Wait(); // wait for process exit
         Assert.IsTrue(
             maaAgentClient.AgentServerProcess.HasExited);
         Assert.IsFalse(

src/MaaFramework.Binding.UnitTests/Test_IMaaTasker.cs

@@ -251,7 +251,6 @@ public void Interface_Register_Unregister_Clear(MaaTypes type, IMaaTasker maaTas
             => maaTasker.Resource.Unregister(Custom.InvalidResource));
     }
 
-
     [TestMethod]
     [MaaData(MaaTypes.All, nameof(Data), "EmptyNode")]
     public void Interface_AppendTask_IsRunning(MaaTypes type, IMaaTasker maaTasker, string taskEntryName)
@@ -366,8 +365,10 @@ public void Interface_Stop_IsStopping(MaaTypes type, IMaaTasker maaTasker)
         Assert.IsNotNull(maaTasker);
         var job =
             maaTasker.Stop();
-        Assert.IsTrue(
-            maaTasker.IsStopping);
+        var isStopping = maaTasker.IsStopping;
+        if (!job.Status.IsDone())
+            Assert.IsTrue(isStopping);
+
         Interface_IMaaPost_Success(job);
         Task.Delay(100).Wait();
         Assert.IsFalse(
@@ -412,4 +413,21 @@ public void Interface_GetTaskDetail_InvalidData(MaaTypes type, IMaaTasker maaTas
     }
 
     #endregion
+
+    [TestMethod]
+    [MaaData(MaaTypes.All, nameof(Data))]
+    public void Case_DirectCustomAction(MaaTypes type, IMaaTasker maaTasker)
+    {
+        _ = MaaUtility.Shared.Version;
+
+        Assert.IsTrue(
+            maaTasker.Resource.Register(new Custom.EmptyAction()));
+        var job = maaTasker
+            .AppendTask(nameof(Custom.DirectCustomAction), Custom.DirectCustomAction)
+            .WaitFor(MaaJobStatus.Succeeded);
+
+        Assert.IsNotNull(job.QueryTaskDetail());
+        Assert.IsNotNull(job.QueryNodeDetail());
+        Assert.IsNotNull(job.QueryRecognitionDetail());
+    }
 }

src/MaaFramework.Binding/Custom/IMaaCustomAction.cs

@@ -33,5 +33,8 @@ public sealed record RunArgs(string NodeName, TaskDetail TaskDetail, string Acti
 /// <summary>
 ///     The action run results.
 /// </summary>
+/// <remarks>
+///     (This a empty record.)
+/// </remarks>
 public sealed record RunResults;
 #pragma warning restore S2094 // Classes should not be empty