v5.10.0

5.10.0 (2026-04-06)

✨ 新功能

• (win32) 添加鼠标锁定跟随模式，支持后台 TPS/FPS 视角控制 (#1232) @ZeroAd-06 @Z_06 @claude Opus 4.6 (1M context) @sisyphus

• (wlroots) Key modifiers (#1215) @heipiao233

• 完整的 macOS 原生截图和控制以及 MaaToolkit 的 DesktopWindow 支持 (#1116) @YJBeetle @MistEO @nekosu

• Delete minicap @MistEO

• Delete minicap @neko-para

• Macos 支持 contact 区分按键 (#1218) @YJBeetle

• Macos utils (#1214) @neko-para

• Win32 WGC try_disable_cursor @MistEO

• Win32 secondary_windows @MistEO

• PiCLI 支持 PI v2.5 协议 (#1227) @MistEO

• Record & Replay Controller (#1146) @MistEO @nekosu

• Android native support (#1222) @Aliothmoon @MistEO

• Win32 click popup for MessageInput (#1230) @MistEO

• MacOS scroll 支持 (#1224) @YJBeetle @MistEO

• Add optional anchor info for reco sink (#1187) @neko-para @MistEO

• Controller ScreenshotResizeMethod (#1243) @MistEO

• Wait_freezes msg (#1178) @MistEO

🐛 Bug修复

• (MacOS) Global event 的一些小补丁 (#1233) @YJBeetle @Copilot

• (win32) Window pos恢复位置检查是否出屏幕了 @MistEO

• (wlroots) Connected check (#1210) @litwak913

• 修复截图失败时后续崩溃问题 @MistEO

• Cache image for FramePool @MistEO

• Cached image for FramePool @MistEO

• 修复 StopTask 在 need_to_stop 时丢失 action 结果 (#1213) @Windsland52 @MistEO

🚜 代码重构

• Export ControlUnit (#1235) @MistEO

• Remove attach/detach thread management (#1240) @Aliothmoon

• MaaFW style refactoring (#1241) @MistEO

📚 文档

• (pi) Document PI 2.5 PI_* env vars for Agent subprocesses (#1226) @MistEO

• (pipeline) 对齐执行语义并补充 JumpBack/Anchor 与 v5.9 变更内容 (#1216) @Windsland52 @MistEO

• 移除社区项目 maa-mcp @MistEO

• 添加 MacOS 控制器虚拟键码参考链接 (#1223) @YJBeetle @nekosu

• 社区项目添加自动涂绿幕工具 (#1234) @Joe-Bao

• 添加社区项目 maafw-cli (#1238) @otowa-kotori

• 添加社区项目 maafgo (#1249) @xlxyvergil @MistEO

🔧 日常维护

• Specific default formatter @neko-para

Ai

• Add meojson usage @MistEO

新贡献者 ❤️

• @xlxyvergil made their first contribution in #1249
• @YJBeetle made their first contribution in #1224
• @Aliothmoon made their first contribution in #1240
• @otowa-kotori made their first contribution in #1238
• @Joe-Bao made their first contribution in #1234
• @heipiao233 made their first contribution in #1215