MaaAssistantArknights

MaaAssistantArknights2025/8/5大约 6 分钟

MAA Logo

MaaAssistantArknights

license commit

MAA 的意思是 MAA Assistant Arknights

一款明日方舟遊戲小助手

基於圖像辨識技術，一鍵完成全部日常任務！

絕讚更新中 ✿✿ヽ(°▽°)ノ✿

下載與安裝

請閱讀文檔後前往官網或 Releases 下載，並參考新手上路進行安裝。

亮點功能

刷理智，掉落辨識及上傳企鵝物流數據統計，一圖流；
智能基建換班，自動計算幹員效率，單設施內最優解；同時也支援自定義排班；
自動公招，可選使用加急許可，一次全部刷完！公招數據上傳企鵝物流數據統計，一圖流；
支援手動辨識公招介面，方便對高星公招做出選擇 ~~（你的這個高資回費出的是推王呢還是推王呢）~~
支援辨識幹員列表，統計已有和未有幹員（還能為手動辨識公招介面提供已有潛能數據提示）；
支援辨識養成材料，並可匯出至企鵝物流刷圖規劃器和明日方舟工具箱計算缺少的養成材料；
訪問好友、收取信用及購物、領取日常獎勵等，一鍵全日常自動長草；
肉鴿全自動刷源石錠和蠟燭，自動辨識幹員及練度；
選擇作業 JSON 文件，自動抄作業，影片範例；
倉庫辨識並支援匯出至企鵝物流刷圖規劃器，明日方舟工具箱， ARK-NIGHTS 幹員培養表；
支援 C, Python, Java, Rust, Golang, Java HTTP, Rust HTTP 等多種接口，方便集成調用，自定義你的 MAA！

話不多說，看圖！

使用說明

功能介紹

請參閱用戶手冊。

外服支援

目前國際服（美服）、日服、韓服、繁中服的絕大部分功能均已支援。但由於外服用戶較少及項目人手不足，很多功能並沒有進行全面的測試，所以請自行體驗。
若您遇到了 Bug，或對某個功能有強需求，歡迎在 Issues 和討論區催更；或加入我們一起建設 MAA！請參考外服適配教學

主要關聯項目

目前項目組非常缺前端大佬，若您有相關經驗，歡迎加入我們！

多語言 (i18n)

MAA 支援多國語言，並使用 Weblate 進行在地化管理。如果您通曉多門語言，歡迎前往 MAA Weblate 協助我們進行翻譯。

MAA 以中文（簡體）為第一語言，翻譯詞條皆以中文（簡體）為準。

致謝

開源庫

圖像辨識庫：opencv
~~文字辨識庫：chineseocr_lite~~
文字辨識庫：PaddleOCR
深度學習部署庫：FastDeploy
機器學習加速器：onnxruntime
~~關卡掉落辨識：企鵝物流辨識~~
地圖格子辨識：Arknights-Tile-Pos
C++ JSON 庫：meojson
C++ 運算符解析器：calculator
~~C++ base64 編解碼：cpp-base64~~
C++ 解壓壓縮庫：zlib
C++ Gzip 封裝：gzip-hpp
安卓觸控事件器：Minitouch
安卓觸控事件器：MaaTouch
WPF MVVM 框架：Stylet
WPF 控件庫：HandyControl
C# JSON 庫：Newtonsoft.Json
下載器：aria2

數據源

~~公開招募數據：明日方舟工具箱~~
~~幹員及基建數據：PRTS明日方舟中文WIKI~~
關卡數據：企鵝物流數據統計
遊戲數據及資源：明日方舟用戶端素材
遊戲數據：《明日方舟》Yostar遊戲數據

貢獻 / 參與者

感謝所有參與到開發 / 測試中的朋友們，是大家的幫助讓 MAA 越來越好！ (*´▽｀)ノノ

開發相關

Windows

下載預構建的第三方庫
```
python maadeps-download.py
```
使用 Visual Studio 2022 打開 MAA.sln，右鍵 MaaWpfGui，設為啟動項目
VS 上方配置選擇 RelWithDebInfo, x64 （如果編譯 Release 包或 ARM 平台，請忽略這步）
右鍵 MaaWpfGui - 屬性 - 偵錯 - 啟用本地偵錯（這樣就能把斷點掛到 C++ Core 那邊了）
（可選）若準備提交 PR，建議啟用 clang-format 支援

linux | macOS

請參考 linux 編譯教學

API

外服適配

請參考外服適配教學，對於陸服已支援的功能，絕大部分的外服適配工作僅需要截圖 + 簡單的 JSON 修改即可。

想參與開發，但不太會用 Github?

Github Pull Request 流程簡述

Issue bot

請參考 Issue bot 使用方法

聲明

本軟體使用 GNU Affero General Public License v3.0 only 開源，並附帶額外用戶協議。
本軟體 logo 並非使用 AGPL 3.0 協議開源，耗毛、vie 兩位畫師及軟體全體開發者保留所有權利。不得以 AGPL 3.0 協議已授權為由在未經授權的情況下使用本軟體 logo，不得在未經授權的情況下將本軟體 logo 用於任何商業用途。
本軟體開源、免費，僅供學習交流使用。若您遇到商家使用本軟體進行代練並收費，可能是設備與時間等費用，產生的問題及後果與本軟體無關。

DirectML 支援說明

本軟體支援 GPU 加速功能，其在 Windows 平台上依賴 Microsoft 提供的獨立元件 DirectML。 DirectML 並非本專案的開源部分，也不受 AGPL 3.0 的約束。為方便用戶，我們隨安裝包附帶了一個未經修改的 DirectML.dll 檔案。如果您無需 GPU 加速功能，可安全移除該 DLL 文件，軟體的核心功能仍可正常運作。