LOGO # MaaAssistantArknights
C++
platform
license commit stars

[简体中文](README.md) | [繁體中文](README_zh-TW.md) | [English](README_en-US.md) | [日本語](README_ja-JP.md) MAA 的意思是 MAA Assistant Arknights 一款明日方舟遊戲小助手 基於圖像辨識技術，一鍵完成全部日常任務！ 絕讚更新中 ✿✿ヽ(°▽°)ノ✿
## 亮點功能 - 刷理智，掉落辨識及上傳 [企鵝物流](https://penguin-stats.cn/) - 智能基建換班，自動計算幹員效率，單設施內最優解 - 自動公招，可選使用加急許可，一次全部刷完！公招数据上傳 [企鵝物流](https://penguin-stats.cn/result/stage/recruit/recruit)，[一圖流](https://yituliu.site/maarecruitdata) - 訪問好友、收取信用及購物、領取日常獎勵等。一鍵全日常自動長草！ - 肉鴿全自動刷源石錠和蠟燭，自動辨識幹員及練度 - 導入作業 JSON 檔案，自動抄作業！ [影片演示](https://www.bilibili.com/video/BV14u411673q/) - 新功能：倉庫辨識！支援導出至 [企鵝物流刷圖規劃器](https://penguin-stats.cn/planner), [明日方舟工具箱](https://arkn.lolicon.app/#/material), [ARK-NIGHTS 幹員培養表](https://ark-nights.com/settings) 話不多說，看圖！ ![image](https://user-images.githubusercontent.com/18511905/189659056-67587818-9844-4f5a-b2f5-838a8932b387.png) ![image](https://user-images.githubusercontent.com/99072975/181418131-f4eefa07-6623-470e-ba4a-0ad15cb8aa91.png) ![image](https://user-images.githubusercontent.com/99072975/172045163-e9ead337-eb62-4f9f-a354-9e302f767a52.png) ## 下載連結 ***第一次使用請下載 `MaaBundle-vX.Y.Z.zip`*** ***第一次使用請下載 `MaaBundle-vX.Y.Z.zip`*** ***第一次使用請下載 `MaaBundle-vX.Y.Z.zip`*** [穩定版](https://github.com/MaaAssistantArknights/MaaAssistantArknights/releases/latest) [測試版](https://github.com/MaaAssistantArknights/MaaAssistantArknights/releases) 下載太慢？嘗試使用 fastgit 鏡像 [fastgit 鏡像穩定版](https://hub.fastgit.xyz/MaaAssistantArknights/MaaAssistantArknights/releases/latest) [fastgit 鏡像測試版](https://hub.fastgit.xyz/MaaAssistantArknights/MaaAssistantArknights/releases) ## 使用說明 ### 基本說明 1. 請根据 [模擬器支援情況](docs/zh-tw/1.3-模擬器支援.md)，進行對應的操作。 2. 修改模擬器解析度為 `16:9` 比例，最低 `1280 * 720`, 更高不限。 3. 開始使用吧！ 更多使用說明請參考 [詳細介紹](docs/zh-tw/1.1-詳細介紹.md) ## 常見問題 - 軟體一打開就閃退 - 連接錯誤、不知道 adb 路徑怎麼填寫 - 辨識錯誤/任務開始後一直不動、沒有反應 - 如何連接自定義通訊埠 - 下載速度慢，且鏡像站無法打開網頁 請參考 [常見問題](docs/zh-tw/1.2-常見問題.md) ## 外服支援 - 國際服（美服） 支援基本的刷理智、訪問好友、領取獎勵、自動肉鴿（測試版本）、公招辨識，請參考 [說明](resource/global/YoStarEN/readme.md) - 日服 支援基本的刷理智、自動公招、訪問好友、領取獎勵、自動肉鴿（測試版本）、公招辨識，請參考 [說明](resource/global/YoStarJP/readme.md) - 韓服 支援基本的刷理智功能，請參考 [說明](resource/global/YoStarKR/readme.md) - 繁中服 支援基本的刷理智、自動公招、公招辨識功能，請參考 [說明](resource/global/txwy/readme.md) 由於外服使用者較少及項目人手不足的問題，外服目前都僅適配了基本的功能。若您有強需求，歡迎在 [討論區](https://github.com/MaaAssistantArknights/MaaAssistantArknights/discussions) 催更，~~或加入我們一起建設 MAA~~ ## 主要關聯項目 - 全新 GUI：[MaaAsstElectronUI](https://github.com/MaaAssistantArknights/MaaAsstElectronUI) （正在開發中，歡迎加入！） - 更新伺服器：[MaaDownloadServer](https://github.com/MaaAssistantArknights/MaaDownloadServer) - 官網 ：[maa-website](https://github.com/MaaAssistantArknights/maa-website) - 作業分享站 ：[前端](https://github.com/MaaAssistantArknights/maa-copilot-frontend) , [後端](https://github.com/MaaAssistantArknights/MaaCopilotServer) ## 致謝 ### 開源庫 - 圖像辨識庫：[opencv](https://github.com/opencv/opencv.git) - ~~字元辨識庫：[chineseocr_lite](https://github.com/DayBreak-u/chineseocr_lite.git)~~ - 字元辨識庫：[PaddleOCR](https://github.com/PaddlePaddle/PaddleOCR) - ~~關卡掉落辨識：[企鵝物流辨識](https://github.com/penguin-statistics/recognizer)~~ - 地圖格子辨識：[Arknights-Tile-Pos](https://github.com/yuanyan3060/Arknights-Tile-Pos) - C++ JSON庫：[meojson](https://github.com/MistEO/meojson.git) - C++ 算子分析器：[calculator](https://github.com/kimwalisch/calculator) - ~~C++ base64編解碼：[cpp-base64](https://github.com/ReneNyffenegger/cpp-base64)~~ - C++ 解壓壓縮庫：[zlib](https://github.com/madler/zlib) - C++ Gzip封裝：[gzip-hpp](https://github.com/mapbox/gzip-hpp) - WPF MVVW框架：[Stylet](https://github.com/canton7/Stylet) - WPF部件庫：[HandyControl](https://github.com/HandyOrg/HandyControl) - C# JSON庫：[Newtonsoft.Json](https://github.com/JamesNK/Newtonsoft.Json) - 下載器：[aria2](https://github.com/aria2/aria2) ### 資料源 - ~~公開招募資料：[明日方舟工具箱](https://www.bigfun.cn/tools/aktools/hr)~~ - 幹員及基建資料：[PRTS明日方舟中文WIKI](http://prts.wiki/) - 關卡資料：[企鵝物流資料統計](https://penguin-stats.cn/) - 素材資料：[明日方舟bot常用素材](https://github.com/yuanyan3060/Arknights-Bot-Resource) ### 貢獻/參與者 感謝所有參與到開發/測試中的朋友們，是大家的幫助讓 MAA 越來越好！ (\*´▽｀)ノノ [![Contributors](https://contributors-img.web.app/image?repo=MaaAssistantArknights/MaaAssistantArknights)](https://github.com/MaaAssistantArknights/MaaAssistantArknights/graphs/contributors) ## 開發相關 ### Windows - 直接使用 Visual Studio 2022 打開 `MeoAssistantArknights.sln` 即可，所有環境都是配置好的 - 建議啟用 clang-format 支援，詳細內容可以參考 [在 Visual Studio 中啟用 clang-format](docs/2.2-开发相关.md#在-visual-studio-中启用-clang-format) ### Linux | macOS 請參考 [Linux 編譯教程](docs/zh-tw/2.1-Linux編譯教程.md) ### API - [C 介面](include/AsstCaller.h)：[整合示例](tools/TestCaller/main.cpp) - [Python 介面](src/Python/asst.py)：[整合示例](src/Python/sample.py) - [Golang 介面](src/Golang/maa/)：[整合示例](src/Golang/cli.go)（已停止維護 orz） - [Dart 介面](src/dart/) - [Java 介面](src/Java/Maaj/src/main/java/com/iguigui/maaj/easySample/MeoAssistant.java)：[整合示例](src/Java/Maaj/src/main/java/com/iguigui/maaj/easySample/MaaJavaSample.java) - [Rust 介面](src/Rust/src/maa_sys/)：[HTTP 介面](src/Rust) - [HTTP 介面](src/Java/Maaj/Readme.md) - [整合文件](docs/zh-tw/3.1-集成文件.md) - [回呼訊息協定](docs/zh-tw/3.2-回呼訊息協定.md) - [任務流程協定](docs/zh-tw/3.4-任務流程協定.md) - [自動抄作業協定](docs/zh-tw/3.3-戰鬥流程協定.md) ### Issue Bot - 使用 `Add {LABEL_NAME}` 增加標籤，使用 `Remove {LABEL_NAME}` 刪除標籤。 - 在提交說明中用 `close #{ISSUE_NUMBER}` 或 `fix #{ISSUE_NUMBER}` 給對應議題增加 `fixed` 標籤。 更多說明請參考 [Issue Bot 使用方法](docs/zh-tw/2.3-IssueBot使用方法.md)。 ### 想參與開發，但不太會用 Github? [Github Pull Request 流程簡述](docs/zh-tw/2.2-開發相關.md) ## 聲明 - 本軟體 logo 並非使用 AGPL 3.0 條款開源，畫師 [耗毛](https://weibo.com/u/3251357314) 及軟體全體開發者保留所有權利。不得以 AGPL 3.0 條款已授權為由在未經授權的情況下使用本軟體 logo, 不得在未經授權的情況下將本軟體 logo 用於任何商業用途。 - 本軟體開源、免費，僅供學習交流使用。若您遇到商家使用本軟體進行代練並收費，可能是設備與時間等費用，產生的問題及後果與本軟件無關。 ## 廣告 [用戶交流群（Telegram 群）](https://t.me/+Mgc2Zngr-hs3ZjU1) 自動戰鬥 JSON 作業分享： , [QQ 一群（已滿）](https://jq.qq.com/?_wv=1027&k=ig786LJZ)，[QQ 二群（已滿）](https://jq.qq.com/?_wv=1027&k=R3oleoKc)，[QQ 三群（已滿）](https://jq.qq.com/?_wv=1027&k=mKdOnhWV)，[QQ 四群](https://jq.qq.com/?_wv=1027&k=ABkU8mCR) [Bilibili 直播間](https://live.bilibili.com/2808861)：每晚直播敲代碼，近期很長一段時間應該都是在寫本軟體~ [舟無關技術交流 & 吹水群（QQ 群）](https://jq.qq.com/?_wv=1027&k=ypbzXcA2)：內捲地獄！ [開發者群（QQ 群）](https://jq.qq.com/?_wv=1027&k=JM9oCk3C) 如果覺得軟體對你有幫助，幫忙點個 Star 吧！~（網頁最上方右上角的小星星），這就是對我們最大的支持了！