42c0d75e89
<img width="3190" height="208" alt="07832262dcc66157005c08cc95a03fd1" src="https://github.com/user-attachments/assets/84630506-c595-4999-ac7b-9c79f200bb16" /> <img width="1753" height="91" alt="b8ee23114f21ed1047697a77e713f1e5" src="https://github.com/user-attachments/assets/6d781864-9c65-4774-85c7-8c22a1210285" /> 完整包体积 +67 M 更新包第一次也会大差不多这么多，后面因为增量的原因不会影响 ## Summary by Sourcery 记录迁移到自包含（self-contained）的 .NET 部署方式，并相应更新运行时和操作系统支持要求。 新功能： - 通过自包含部署，将 .NET 运行时打包进 Windows GUI 构建中，从而不再需要单独安装 .NET。 增强改进： - 在所有支持的语言中明确说明：安装时仅需要 Visual C++ 运行时，因为 .NET 现在已随程序一同提供。 - 更新 Linux/Wine 使用文档，以反映 Windows 构建已包含 .NET 运行时这一事实。 - 重新措辞操作系统支持说明，解释由于运行时和系统组件依赖，MAA 需要 Windows 10 或更高版本。 构建： - 调整 WPF GUI 项目和依赖设置脚本以使用自包含发布模式，并停止安装外部的 .NET Desktop Runtime。 文档： - 更新所有语言的常见问题（FAQ）、安装说明和新手指南，使其与新的自包含部署方式和运行时要求保持一致。 <details> <summary>Original summary in English</summary> ## Summary by Sourcery Document the switch to self-contained .NET deployment and update runtime and OS support requirements accordingly. New Features: - Bundle the .NET runtime into the Windows GUI build via self-contained deployment to remove the need for a separate .NET installation. Enhancements: - Clarify across all supported languages that only the Visual C++ runtime is required at install time, as .NET is now included. - Update Linux/Wine usage docs to reflect that the Windows build already contains the .NET runtime. - Reword OS support notes to explain that MAA requires Windows 10 or later due to its runtime and system component dependencies. Build: - Adjust the WPF GUI project and dependency setup script to use self-contained publish mode and stop installing the external .NET Desktop Runtime. Documentation: - Refresh FAQ, installation, and newbie guides in all languages to match the new self-contained deployment and runtime requirements. </details>
icon, index, dir
| icon | index | dir | ||
|---|---|---|---|---|
| ic:round-home | true |
|
::: center
MAA
MAA stands for MAA Assistant Arknights
An Arknights assistant
Based on image recognition technology, complete all daily tasks with one click!
Development actively in progress ✿✿ヽ(°▽°)ノ✿
:::
Download and Installation
Please read the documentation and then visit the official website or Releases to download. Refer to Getting Started for installation instructions.
Key Features
- Auto-farming sanity, drop item recognition and auto-uploading to Penguin Stats, Yituliu.
- Intelligent base shift management, auto-calculating operator efficiency for optimal solutions within facilities; also supports customized scheduling.
- Auto-recruitment with option to use expedited plans, clearing all at once! Auto-uploading recruitment data to Penguin Stats, Yituliu.
- Manual recruitment tag identification for better high-star recruitment decisions
(Will that Senior Operator tag give you SilverAsh or SilverAsh?) - Operator list recognition, counting owned and missing operators and their potentials, displayed during recruitment identification.
- Material recognition and export to Penguin Stats Planner, Arknights Toolbox, ARK-NIGHTS Operator Builds.
- Visiting friends, collecting credits and shopping, collecting daily rewards, etc. - one-click daily automation.
- Fully automatic Integrated Strategy (IS) for farming Originium Ingots and levels, auto-farming and direct upgrades, smart operator recognition.
- Select JSON copilot files for automatic stage clearing, Video demonstration.
- Support for C, Python, Java, Rust, Golang, Java HTTP, Rust HTTP and other interfaces, easy integration and customization for your MAA!
See it in action!
Usage Instructions
Feature Introduction
Please refer to the User Manual.
Support for Overseas Clients
Most features now support Global (EN), Japanese, Korean, and Traditional Chinese servers. However, due to the smaller number of overseas users and limited project personnel, many features haven't been thoroughly tested, so please try them yourself.
If you encounter bugs or have specific feature requests, please let us know in Issues and Discussions, or join us to help improve MAA! Please refer to the Overseas Clients Adaptation section.
::: tip
For Global (EN) server, due to interface layout issues, the only supported resolution is 1920x1080
:::
CLI Support
MAA supports command-line interface (CLI) operation on Linux, macOS, and Windows, useful for automation scripts or on servers without graphical interfaces. Please refer to the CLI Usage Guide
Join Us
Main Related Projects
- New Framework: MaaFramework
- Copilot Site Frontend: zoot-plus-frontend
- Copilot Site Backend: ZootPlusBackend
- Official Website: Frontend
- Deep Learning: MaaAI
Multilingual Support (i18n)
MAA uses Chinese (Simplified) as its primary language, and all translation entries are based on Chinese (Simplified).
Development Participation
Please refer to the Development Guide.
API
- C interface: Integration Example
- Python interface: Integration Example
- Golang interface: Integration Example
- Dart interface
- Java interface: Integration Example
- Java HTTP interface
- Rust interface: HTTP interface
- TypeScript interface
- Woolang interface: Integration Example
- Integration Documentation
- Callback Message Protocol
- Task Workflow Protocol
- Auto-Copilot Protocol
Overseas Clients Adaptation
Please refer to the Overseas Clients Adaptation Guide. For features already supported in the CN server, most adaptation work for overseas clients only requires screenshots + simple JSON modifications.
Issue bot
Please refer to the Issue Bot Usage Guide
Acknowledgements
Open-source Libraries
- Image recognition library: opencv
Text recognition library: chineseocr_lite- Text recognition library: PaddleOCR
- Deep learning deployment library: FastDeploy
- Machine learning accelerator: onnxruntime
Stage drop recognition: Penguin Stats Recognizer- Map tile recognition: Arknights-Tile-Pos
- C++ JSON library: meojson
- C++ operator parser: calculator
C++ base64 encoding/decoding: cpp-base64- C++ compression library: zlib
- C++ Gzip wrapper: gzip-hpp
- Android touch event generator: Minitouch
- Android touch event generator: MaaTouch
- WPF MVVM framework: Stylet
- WPF control library: HandyControl -> HandyControls
- C# logging: Serilog
- C# JSON library: Newtonsoft.Json & System.Text.Json
Downloader: aria2
Data Sources
Recruitment data: Arknights ToolboxOperator and base data: PRTS Wiki- Stage data: Penguin Statistics
- Game data and resources: Arknights Client Resources
- Game data: Arknights Yostar Game Data
Contributors
Thanks to all friends who have participated in development and testing - your help makes MAA better and better! (*´▽｀)ノノ
Disclaimer
- This software is open source under the GNU Affero General Public License v3.0 only license, with additional Terms of Service.
- The software's logo is NOT licensed under AGPL 3.0. The artists 耗毛, vie, and all the software developers reserve all rights. The logo must not be used without authorization, even with AGPL 3.0 license claims, and must not be used for any commercial purposes without authorization.
- This software is open source and free, intended only for learning and communication purposes. If you encounter merchants using this software for paid services, they may be charging for equipment and time costs; any problems and consequences arising from this are not related to this software.
DirectML Support Information
This software supports GPU acceleration, which relies on Microsoft's standalone component DirectML on Windows. DirectML is not part of this project's open-source components and is not subject to AGPL 3.0. For user convenience, we include an unmodified DirectML.dll file with the installation package. If you don't need GPU acceleration, you can safely delete this DLL file, and the core functionality will still work normally.
Community
User Exchange QQ Groups: MAA Usage & Arknights Exchange QQ Group
Discord Server: Invite Link
User Exchange Telegram Group: Telegram Group
Auto-battle JSON strategy sharing: prts.plus
Bilibili Live: MrEO Live coding streams & MAA-Official Live gaming/chat
Technical Group (non-Arknights, no casual chat): Internal Competition Hell! (QQ Group)
Developer Group: QQ Group
If you find the software helpful, please give us a Star! ~ (the small star at the top right of the webpage), that's the biggest support