RELEASE: v5.3.0

moomiji · moomiji · commit 58442b7de829 · 2026-01-20T00:37:30.000+08:00
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -1,42 +1,22 @@
 ### NuGet Link
 
-[![](https://img.shields.io/badge/NuGet-Maa.Framework-%23004880)](https://www.nuget.org/packages/Maa.Framework/5.1.0) [![](https://img.shields.io/badge/NuGet-Maa.Framework.Native-%23004880)](https://www.nuget.org/packages/Maa.Framework.Native/5.1.0) [![](https://img.shields.io/badge/NuGet-Binding-%23004880)](https://www.nuget.org/packages/Maa.Framework.Binding/5.1.0) [![](https://img.shields.io/badge/NuGet-Native-%23004880)](https://www.nuget.org/packages/Maa.Framework.Binding.Native/5.1.0)
+[![](https://img.shields.io/badge/NuGet-Maa.Framework-%23004880)](https://www.nuget.org/packages/Maa.Framework/5.3.0) [![](https://img.shields.io/badge/NuGet-Maa.Framework.Native-%23004880)](https://www.nuget.org/packages/Maa.Framework.Native/5.3.0) [![](https://img.shields.io/badge/NuGet-Binding-%23004880)](https://www.nuget.org/packages/Maa.Framework.Binding/5.3.0) [![](https://img.shields.io/badge/NuGet-Native-%23004880)](https://www.nuget.org/packages/Maa.Framework.Binding.Native/5.3.0)
 
-## What's Changed in v5.1.0
+## What's Changed in v5.3.0
 
-**Full Changelog**: https://github.com/MaaXYZ/MaaFramework.Binding.CSharp/compare/v4.5.0...v5.1.0
-
-### Breaking changes
-
-- [Breaking change] feat: more win32 screencap methods @moomiji
-- [Breaking change] chore: method ToControllerWith() instead of null check in ToController() @moomiji
-- [Breaking change] feat: controller features @moomiji
-- [Breaking change] refactor: split win32 mouse and keyboard @moomiji
-- [Breaking change] chore: remove obsolete method @moomiji
-- [Breaking change] feat: LoadPlugin() & rename IMaaUtility -> IMaaGlobal @moomiji
-- [Breaking change] chore: remove MaaToolkitProjectInterface @moomiji
+**Full Changelog**: https://github.com/MaaXYZ/MaaFramework.Binding.CSharp/compare/v5.1.0...v5.3.0
 
 ### New features
 
-- feat: add Win32InputMethod (#20) @SweetSmellFox
-- feat: 同步 MaaFW v5.1 接口及回调消息 (#19) @MistEO
-- feat: add context param on NotificationHandler @moomiji
-- feat: override image @moomiji
-- feat: forward callback to the agent server @moomiji
-- feat: support query action detail @moomiji
-
-### Fix
-
-- fix: MaaJobStatusException message formatting @moomiji
-- fix: library directory resolution logic @moomiji
-- fix: handle is null when add sink @moomiji
+- feat: IMaaContext.IsCancellationRequested @moomiji
+- feat: IMaaTasker.AppendAction() support optional parameter @moomiji
+- feat: support null handle wrapper @moomiji
+- feat: support PlayCover controller @moomiji
+- feat: IMaaResource.Append OcrModel Pipeline Image @moomiji
+- feat: new global option @moomiji
+- feat: IMaaController.Shell & GetShellOutput @moomiji
+- feat: IMaaTasker.AppendRecognition & AppendAction @moomiji
 
 ### Other
 
-- chore: update obsolete messages @moomiji
-- refactor: auto attach & detach agentClient.Dispose @moomiji
-- chore: update interop to framework v5.1.4 @moomiji
-- chore: fix code quality analysis warnings @moomiji
-- chore: MaaAgentServer add exception document @moomiji
-- refactor: callback event part.2 @moomiji
-- refactor: callback event @moomiji
+- chore: update interop to framework v5.3.3 @moomiji
diff --git a/README.md b/README.md
@@ -4,7 +4,7 @@
 
 # MaaFramework.Binding.CSharp
 
-_✨ C# Binding for [MaaFramework](https://github.com/MaaXYZ/MaaFramework/blob/v5.1.4) ✨_
+_✨ C# Binding for [MaaFramework](https://github.com/MaaXYZ/MaaFramework/blob/v5.3.3) ✨_
 
 _💫 A universal interop API wrapper 💫_
 
@@ -42,7 +42,7 @@ Required dependencies for `MaaFramework.Binding.CSharp`:
 
 ### Resource Setup
 
-Refer to MaaFramework docs: [English](https://github.com/MaaXYZ/MaaFramework/blob/v5.1.4/docs/en_us/1.1-QuickStarted.md#prepare-resource-files) | [简体中文](https://github.com/MaaXYZ/MaaFramework/blob/v5.1.4/docs/zh_cn/1.1-快速开始.md#准备资源文件)
+Refer to MaaFramework docs: [English](https://github.com/MaaXYZ/MaaFramework/blob/v5.3.3/docs/en_us/1.1-QuickStarted.md#prepare-resource-files) | [简体中文](https://github.com/MaaXYZ/MaaFramework/blob/v5.3.3/docs/zh_cn/1.1-快速开始.md#准备资源文件)
 
 See [SampleResource](./src/MaaFramework.Binding.UnitTests/SampleResource) for implementation.
 
diff --git a/README.zh_cn.md b/README.zh_cn.md
@@ -4,7 +4,7 @@
 
 # MaaFramework.Binding.CSharp
 
-_✨ [MaaFramework](https://github.com/MaaXYZ/MaaFramework/blob/v5.1.4) 的 C# 绑定 ✨_
+_✨ [MaaFramework](https://github.com/MaaXYZ/MaaFramework/blob/v5.3.3) 的 C# 绑定 ✨_
 
 _💫 一个通用的互操作 API 封装 💫_
 
@@ -42,7 +42,7 @@ _💫 一个通用的互操作 API 封装 💫_
 
 ### 资源准备
 
-参考 MaaFramework 文档：[English](https://github.com/MaaXYZ/MaaFramework/blob/v5.1.4/docs/en_us/1.1-QuickStarted.md#prepare-resource-files) | [简体中文](https://github.com/MaaXYZ/MaaFramework/blob/v5.1.4/docs/zh_cn/1.1-快速开始.md#准备资源文件)
+参考 MaaFramework 文档：[English](https://github.com/MaaXYZ/MaaFramework/blob/v5.3.3/docs/en_us/1.1-QuickStarted.md#prepare-resource-files) | [简体中文](https://github.com/MaaXYZ/MaaFramework/blob/v5.3.3/docs/zh_cn/1.1-快速开始.md#准备资源文件)
 
 实现示例可查看 [SampleResource](./src/MaaFramework.Binding.UnitTests/SampleResource)。
 
diff --git a/docs/articles/changelog-all-version.md b/docs/articles/changelog-all-version.md
@@ -1,3 +1,22 @@
+## v5.3.0
+
+**Full Changelog**: https://github.com/MaaXYZ/MaaFramework.Binding.CSharp/compare/v5.1.0...v5.3.0
+
+### New features
+
+- feat: IMaaContext.IsCancellationRequested @moomiji
+- feat: IMaaTasker.AppendAction() support optional parameter @moomiji
+- feat: support null handle wrapper @moomiji
+- feat: support PlayCover controller @moomiji
+- feat: IMaaResource.Append OcrModel Pipeline Image @moomiji
+- feat: new global option @moomiji
+- feat: IMaaController.Shell & GetShellOutput @moomiji
+- feat: IMaaTasker.AppendRecognition & AppendAction @moomiji
+
+### Other
+
+- chore: update interop to framework v5.3.3 @moomiji
+
 ## v5.1.0
 
 **Full Changelog**: https://github.com/MaaXYZ/MaaFramework.Binding.CSharp/compare/v4.5.0...v5.1.0
diff --git a/docs/articles/overview-of-wrapper-and-api.md b/docs/articles/overview-of-wrapper-and-api.md
@@ -1,4 +1,4 @@
-# Overview of Wrapper (v5.1.0) and Api ([v5.1.4](https://github.com/MaaXYZ/MaaFramework/tree/v5.1.4))
+# Overview of Wrapper (v5.3.0) and Api ([v5.3.3](https://github.com/MaaXYZ/MaaFramework/tree/v5.3.3))
 
 ## Enums
 
diff --git a/sample/csharp/1.main.cs b/sample/csharp/1.main.cs
@@ -1,6 +1,6 @@
 ﻿#!/usr/bin/dotnet run
 
-#:package Maa.Framework@5.1.0
+#:package Maa.Framework@5.3.0
 
 #nullable enable
 
diff --git a/sample/csharp/2.AgentChild.cs b/sample/csharp/2.AgentChild.cs
@@ -1,6 +1,6 @@
 ﻿#!/usr/bin/dotnet run
 
-#:package Maa.Framework.Binding.Native@5.1.0
+#:package Maa.Framework.Binding.Native@5.3.0
 
 #nullable enable
 
diff --git a/sample/csharp/2.AgentMain.cs b/sample/csharp/2.AgentMain.cs
@@ -1,6 +1,6 @@
 ﻿#!/usr/bin/dotnet run
 
-#:package Maa.Framework@5.1.0
+#:package Maa.Framework@5.3.0
 
 #nullable enable
 
diff --git a/sample/csharp/3.CSBinding README Example.cs b/sample/csharp/3.CSBinding README Example.cs
@@ -1,6 +1,6 @@
 ﻿#!/usr/bin/dotnet run
 
-#:package Maa.Framework@5.1.0
+#:package Maa.Framework@5.3.0
 
 #nullable enable
 
diff --git a/src/MaaFramework.Binding.Native/NativeBindingContext.cs b/src/MaaFramework.Binding.Native/NativeBindingContext.cs
@@ -11,7 +11,7 @@ public static class NativeBindingContext
     /// <summary>
     ///     Gets the version of NativeBinding.
     /// </summary>
-    public static string BindingVersion => "v5.1.0";
+    public static string BindingVersion => "v5.3.0";
 
     /// <summary>
     ///     Gets the version of MaaFramework.

Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,4 @@`
`1`		`-# Overview of Wrapper (v5.1.0) and Api ([v5.1.4](https://github.com/MaaXYZ/MaaFramework/tree/v5.1.4))`
	`1`	`+# Overview of Wrapper (v5.3.0) and Api ([v5.3.3](https://github.com/MaaXYZ/MaaFramework/tree/v5.3.3))`
`2`	`2`
`3`	`3`	`## Enums`
`4`	`4`