mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-18 10:10:45 +08:00
docs: Update en/zh-tw user manual
This commit is contained in:
Helloworld
@@ -37,11 +37,12 @@ Development in progress ✿✿ヽ(°▽°)ノ✿
|
||||
- Auto-recruitment, support for expedited plan. Auto-uploading recruitment data to [Penguin Stats](https://penguin-stats.io/result/stage/recruit/recruit), [Yituliu](https://yituliu.site/maarecruitdata)
|
||||
- Visiting friends, collecting credits and purchasing items, collecting daily rewards, completing daily quests in one click!
|
||||
- Auto-battle for Integrated Strategy (I.S.) for collecting originium ingots and candles.
|
||||
- **New feature! Importing JSON task file for auto-battle!** [Video](https://www.bilibili.com/video/BV14u411673q/)
|
||||
- Importing JSON task file for auto-battle! [Video](https://www.bilibili.com/video/BV14u411673q/)
|
||||
- New feature: Depot recognition! Supports exporting to [Penguin Stats Planner](https://penguin-stats.cn/planner), [Arknight Tools](https://arkn.lolicon.app/#/material), and [ARK-NIGHTS Operator Builds](https://ark-nights.com/settings)
|
||||
|
||||
Talk is cheap. Show me the pictures!
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -37,11 +37,12 @@ MAA 的意思是 MAA Assistant Arknights
|
||||
- 自動公招，可選使用加急許可，一次全部刷完！公招数据上傳 [企鵝物流](https://penguin-stats.cn/result/stage/recruit/recruit)，[一圖流](https://yituliu.site/maarecruitdata)
|
||||
- 訪問好友、收取信用及購物、領取日常獎勵等。一鍵全日常自動長草！
|
||||
- 肉鴿全自動刷源石錠和蠟燭，自動辨識幹員及練度
|
||||
- **新功能！導入作業 JSON 檔案，自動抄作業！** [影片演示](https://www.bilibili.com/video/BV14u411673q/)
|
||||
- 導入作業 JSON 檔案，自動抄作業！ [影片演示](https://www.bilibili.com/video/BV14u411673q/)
|
||||
- 新功能：倉庫辨識！支援導出至 [企鵝物流刷圖規劃器](https://penguin-stats.cn/planner), [明日方舟工具箱](https://arkn.lolicon.app/#/material), [ARK-NIGHTS 幹員培養表](https://ark-nights.com/settings)
|
||||
|
||||
話不多說，看圖！
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
@@ -1,21 +1,19 @@
|
||||
# MAA User Manual
|
||||
|
||||
## Introduction
|
||||
## Features
|
||||
|
||||
### Operations
|
||||
|
||||
- If there is no stage you need, please click **blue start button** manually and select `current stage`.
|
||||
- When any of the `Sanity Potion`, `Originite Prime`, `Times` conditions are met, the task is considered completed and stops.
|
||||
- If there is no stage you need, please click **blue start button** manually and select `current/previous`. (The previous stage will be entered if you are not in the **blue start button** screen.)
|
||||
- When any of the `Sanity Potion`, `Originite Prime`, `Times`, `Drops` conditions are met, the task is considered completed and stops.
|
||||
- Example 1：check `Sanity Potion`: `999`, `Originite Prime`: `10`, `Times`: `1`. After **ONE** operation is completed, the task stops because `Times`: `1` is met.
|
||||
- Example 2：uncheck `Sanity Potion` and `Originite Prime`, and set `Times`: `100`. After sanity is used up (maybe several times), the condition `Sanity Potion` and `Originite Prime` is met, and the task stops.
|
||||
- Uploading operation statistics to [Penguin Stats](https://penguin-stats.io/).
|
||||
- Custom Penguin Stats ID.
|
||||
- Recognizing and displaying drops.
|
||||
- Auto-reconnection after disconnection.
|
||||
- Auto-reconnection after 4 AM.
|
||||
- Annihilation support.
|
||||
- Supporting operator level-up.
|
||||
- Supporting auto-combat failure by abandoning the operation.
|
||||
- You can enable `Stage selection` in `Settings` - `UI Settings`, which supports all stages in main stories, and the stages in the dropdown list, such as `1-7`, `S3-2`, `CE-6`, etc.
|
||||
- Supports recognizing and displaying drops, and auto-uploading operation statistics to [Penguin Stats](https://penguin-stats.io/) with custom Penguin Stats ID.
|
||||
- `Drops` and `Stages` are two different options: `Drops` is to limit the times of battle such as "stop after 5 Orirock drops". It will not help direct you to the target stage.
|
||||
- Supports auto-reconnection after disconnection, and auto-reconnection after 4 AM, continuing with the battle going on.
|
||||
- Annihilation support with `PRTS`.
|
||||
- Supports operator level-up, and supports handling PRTS failure by abandoning the operation.
|
||||
|
||||
### Infrastructure
|
||||
|
||||
@@ -23,9 +21,9 @@
|
||||
|
||||
Auto-calculate and choose the **optimal solution within a single facility**. Supports all general and special skill combination. Supports recognition of Battle Record, Pure Gold, Originium Shard, Chip, etc. for different operators.
|
||||
|
||||
#### Morale Threshold for Resting
|
||||
#### Morale Threshold for Working in Infrastructure
|
||||
|
||||
Recognize the percentage of the Morale progress bar. When Morale decreases beyond some threshold, move the operator to the domitory.
|
||||
Recognize the percentage of the Morale progress bar. When Morale decreases beyond some threshold, move the operator to the dormitory.
|
||||
|
||||
#### Note
|
||||
|
||||
@@ -33,6 +31,7 @@ Recognize the percentage of the Morale progress bar. When Morale decreases beyon
|
||||
- If `Usage of Drone` is selected with the option `Trading Post-LMD`, it will recognize `Shamare` and reserve it for her.
|
||||
- Operators of corresponding fraction will be selected when only one Clue is needed Reception Room; otherwise general operators will be chosen.
|
||||
- Reception Room will send out Clues only when your Clues are full. Three Clues will be send out at most. You can edit `SelectClue` - `maxTimes` field in `resource/tasks.json` to edit number of Clues sent if you want.
|
||||
- If you do not want operators like `Irene` or someone else to be put into the dormitory when the training room is not in use, you can switch off `Working operator shall not be put into the dormitory` in the settings. Note that this may cause the operators with non-full fatigue not entering the dormitory as well.
|
||||
- Due to the complexity of Control Center, only `Amiya`, `Swire`, `Kal'tsit`, `Team Rainbow` and other Morale+0.05 operators will be considered. To be improved in future.
|
||||
- Some alternate operators may have conflicts in Infrastructure. Please notice if there is "Operator conflict" warnings on the UI, and double check the Infrastructure to shift manually (e.g. some facilities may not have any operator).
|
||||
|
||||
@@ -40,38 +39,41 @@ Recognize the percentage of the Morale progress bar. When Morale decreases beyon
|
||||
|
||||
- Auto-recruitment and recruitment recognition are two different features!
|
||||
- Auto-recruitment supports using `Expedited Plan` to make it fully automated! Please set it in the settings.
|
||||
- Pop-up window when 5★, 6★ operators are recruited.
|
||||
- Pop-up notification when 5★, 6★ operators are recruited.
|
||||
- Auto-uploading recruitment data to [Penguin Stats](https://penguin-stats.io/) and [Yituliu](https://yituliu.site/) while auto-recruitment.
|
||||
|
||||
### Integrated Strategy (I.S.) Support
|
||||
|
||||
- Three options in the settings
|
||||
|
||||
- Plays as much as you can: for getting candles.
|
||||
- Exits after first level: the most efficient mode for getting Originium Ingots. Easy mode is recommended.
|
||||
- Plays until trading: for getting both items.
|
||||
|
||||
- I.S. now supports recognition of operators and levels, and can choose an optimal solution of operators and skills.
|
||||
- Supports recognition of operators and levels, and can choose an optimal solution of operators and skills.
|
||||
- Supports recognition of shop items, and purchases items that are more valuable.
|
||||
- Supports auto-reconnecting after disconnection, and replaying after 4 AM.
|
||||
- The program will abandon the operation and retry if it is stuck by some bug. If it is stuck frequently at some place and has severe impact on efficiency, please submit an issue to us.
|
||||
|
||||
### Share Your Tasks
|
||||
|
||||
Welcome to QQ Group: 912322156
|
||||
Welcome to share your tasks with [www.抄作业.com](https://www.抄作业.com), or [www.prts.plus](https://www.prts.plus)!
|
||||
|
||||
#### Load Tasks
|
||||
|
||||
- Please run it on the screen with `Start Operation` button.
|
||||
- If you need to make your own build manually, turn off `auto build` to do so.
|
||||
- Remember to like the tasks that you think helpful!
|
||||
|
||||
|
||||
|
||||
#### Create Tasks
|
||||
|
||||
- A tool for creating tasks is provided in the directory of EXE file. See also: [Copilot Schema](3.3-COPILOT_SCHEMA.md) for help.
|
||||
- How to get map coordinates: start an operation after filling in `stage_name`. A file named `map.png` will be generated for your reference. Features like displaying map on the creator tool will be supported in future.
|
||||
- A tool for creating tasks is provided in the directory of MAA. See also: [Copilot Schema](3.3-COPILOT_SCHEMA.md) for help.
|
||||
- How to get map coordinates: start an operation after filling in `stage_name`. A file named `map.png` will be generated for your reference. Or you can refer to [PRTS.map](https://map.ark-nights.com/), with the `coordinates` set to `MAA` mode.
|
||||
- Drill plan is recommended for testing.
|
||||
- If the name of operator is not recognized correctly, check the log `asst.log` to see what is the recognition result, and edit `resource/tasks.json` - `CharsNameOcrReplace` to replace it.
|
||||
- Welcome to share your tasks with [www.抄作业.com](https://www.抄作业.com), or [www.prts.plus](https://www.prts.plus)!
|
||||
- It is recommended to write your own name, video walkthrough URL, or other things that you think helpful in the description.
|
||||
|
||||
### Depot Recognition
|
||||
|
||||
(Beta) Please start with the `Upgrade materials` screen. Only exporting to several data websites are supported. More features will be added in future.
|
||||
Please feel free to contact us if you hope to integrate with our JSON schema.
|
||||
|
||||
### Miscellaneous
|
||||
|
||||
- Tasks order can be changed on the UI. So can the shifting order in the infrastructure.
|
||||
@@ -80,3 +82,7 @@ Welcome to QQ Group: 912322156
|
||||
- Developed in C++, the core algorithm supports multi-level cache, in order to reduce CPU and memory usage as much as possible.
|
||||
- Our software supports auto-update ✿✿ヽ(°▽°)ノ✿ Beta-testers can try beta versions, which updates faster and less buggy (maybe).
|
||||
- If auto-update fails, you can download manually and put the ZIP file under the same directory. The update will start automatically.
|
||||
|
||||
## Other Features
|
||||
|
||||
If you need to run multiple instances of emulators, please copy MAA folder, and use **the same ADB** and **different ADB addresses** to connect.
|
||||
@@ -1,21 +1,19 @@
|
||||
# MAA使用說明
|
||||
|
||||
## 詳細介紹
|
||||
## 功能介紹
|
||||
|
||||
### 刷理智
|
||||
|
||||
- 若選項中沒有你需要的關卡，請手動進入遊戲 **藍色開始按鈕** 畫面，並選擇 `當前關卡`。
|
||||
- 主畫面上的 `吃理智`、`吃石頭`、`指定次數` 三個選項為短路開關，即三個選項中的任一條件達到，均會視為任務完成，停止刷理智。
|
||||
- 若選項中沒有你需要的關卡，請手動進入遊戲 **藍色開始按鈕** 畫面，並選擇 `當前/上次`。（若當前不處於 **藍色開始按鈕** 畫面，則會自動進入遊戲中「上次作戰」的關卡）
|
||||
- 主畫面上的 `吃理智`、`吃石頭`、`指定次數`、`指定材料` 四個選項為短路開關，即四個選項中的任一條件達到，均會視為任務完成，停止刷理智。
|
||||
- 舉例1：設定 `吃理智藥` : `999`、`吃石頭` : `10`、`指定次數` : `1`。則在刷完 **一次** 後，由於滿足了 `指定次數`:`1` 的條件，視為任務完成，停止刷理智。
|
||||
- 舉例2：不勾選 `吃理智藥`、不勾選 `吃石頭`，設定 `指定次數` : `100`。則在當前可用理智全部刷完後（可能只刷了幾次），由於滿足了 `不吃理智藥`、`不吃石頭` 的條件，視為任務完成，停止刷理智。
|
||||
- 刷完自動上傳 [企鵝物流資料統計](https://penguin-stats.cn/)
|
||||
- 可自定義企鵝物流 ID
|
||||
- 辨識並顯示材料掉落
|
||||
- 斷線後會重連，繼續刷上次的圖
|
||||
- 凌晨 4 點更新後也會重連，繼續刷上次的圖
|
||||
- 支援剿滅模式
|
||||
- 支援打完升級了的情況
|
||||
- 支援代理失敗的情況，會自動放棄本次行動
|
||||
- 關卡選擇可在 `設定` - `介面設定` 中啟用 `手動輸入關卡名`，支援全部主線關卡 + 原先下拉列表中的關卡，如 `1-7`, `S3-2`, `CE-6` 等
|
||||
- 支援辨識並顯示材料掉落，且會自動上傳 [企鵝物流資料統計](https://penguin-stats.cn/)，並可設置企鵝物流 ID
|
||||
- `指定材料` 與 `關卡選擇` 是兩個互相獨立的邏輯：`指定材料` 是用來限制刷取次數的，比如「刷 5 個 固源岩就停」這樣的需求，並不是說你指定了材料就會幫你導航到對應關卡
|
||||
- 斷線後會重連，繼續刷上次的圖；凌晨 4 點更新後也會重連，繼續刷上次的圖
|
||||
- 支援剿滅模式自動使用 `全權委託`
|
||||
- 支援打完升級了的情況；支援代理失敗的情況，會自動放棄本次行動
|
||||
|
||||
### 基建換班
|
||||
|
||||
@@ -23,7 +21,7 @@
|
||||
|
||||
自動計算並選擇 **單設施內的最優解**，支援所有通用類技能和特殊技能組合；支援辨識經驗書、赤金、源石碎片、芯片，分別使用不同的幹員組合！
|
||||
|
||||
#### 宿舍入駐心情閾值
|
||||
#### 基建工作心情閾值
|
||||
|
||||
辨識心情進度列的百分比；心情小於該閾值的幹員，不會再去上班，直接進駐宿舍。
|
||||
|
||||
@@ -33,6 +31,7 @@
|
||||
- 若 `無人機用途` 選擇 `貿易站-龍門幣` ，則將額外辨識是否有 `巫戀組`，並優先為其使用。
|
||||
- 會客室僅缺一個線索時，會選擇對應流派的幹員；否則會選擇通用幹員。
|
||||
- 會客室僅當自有線索滿時，才會送出線索，並且只送三個。有需要的同學可自行修改 `resource/tasks.json` 中 `SelectClue` - `maxTimes` 欄位，自定義送出個數。
|
||||
- 若不希望 `艾麗妮` 等幹員在訓練室未訓練時被進駐到宿舍，可在設定中關閉 `不將已進駐幹員放入宿舍`。但可能會帶來加工站中心情不滿的幹員也不進駐宿舍的問題。
|
||||
- 控制中樞策略太過複雜，目前只考慮 `阿米婭`、`詩懷雅`、`凱爾希`、`彩虹小隊` 及其他心情 +0.05 的幹員，後續逐步優化。
|
||||
- 部分異格幹員會在基建內產生衝突，請留意輔助畫面上是否有提示 “幹員衝突”，若有請手動再查看下基建換班情況（可能會有某個設施沒人）
|
||||
|
||||
@@ -40,43 +39,50 @@
|
||||
|
||||
- 自動公招和公招辨識是兩個獨立的功能！
|
||||
- 自動公招支援使用 `加急許可`，全自動連續公招！請進入設定中選擇~
|
||||
- 出 5、6 星都會有彈窗提示
|
||||
- 出 5、6 星都會有彈出通知提示
|
||||
- 自動公招時自動選取資料上傳 [企鵝物流資料統計](https://penguin-stats.cn/) 和 [素材獲取一圖流](https://yituliu.site/)
|
||||
|
||||
### 自動肉鴿功能
|
||||
|
||||
- 設定中的三個選項
|
||||
|
||||
- 盡可能往後打：用於刷蠟燭
|
||||
- 刷源石錠投資，第一層商店後直接退出：刷源石錠最高效的模式，建議手動選擇 `古堡觀光` （簡單）模式
|
||||
- 刷源石錠投資，投資後退出：兼顧刷蠟燭和刷源石錠投資的模式
|
||||
|
||||
- 肉鴿已支援自動辨識幹員及練度，並自動選擇較優幹員及技能
|
||||
- 支援自動辨識幹員及練度，並自動選擇較優幹員及技能
|
||||
- 支援辨識商店物品，優先購買更厲害的收藏品
|
||||
- 支援斷線重連、支援凌晨 4 點更新後繼續回去刷
|
||||
- 如果軟體出現 bug 卡住了，會自動放棄當次探索並重試。但如果經常在某個地方卡住然後放棄、嚴重影響效率的，歡迎提個 issue 回饋一下~
|
||||
|
||||
### 自動抄作業
|
||||
|
||||
歡迎加作業分享 Q 群: 912322156
|
||||
歡迎使用作業分享站 [www.抄作业.com](https://www.抄作业.com), [www.prts.plus](https://www.prts.plus) 分享/使用 作業檔！
|
||||
|
||||
#### 抄作業
|
||||
|
||||
- 本功能需要在有 `開始行動` 的關卡入口畫面開始執行
|
||||
- 若需要選擇助戰等，關閉 `自動編隊` 功能，並手動編隊後再開始即可
|
||||
- 記得在作業分享站上給好用的作業點讚喔！
|
||||
|
||||
|
||||
|
||||
#### 寫作業
|
||||
|
||||
- exe 同目錄下有簡易的製作器，可以結合 [文件](3.3-戰鬥流程協議.md) 使用
|
||||
- 地圖坐標獲取：填寫 `stage_name` 後直接開一局，會在目錄下生成 `map.png`, 可以用於參考。後面會想辦法直接在製作器上顯示坐標（畫餅）
|
||||
- MAA 目錄下有簡易的製作器，可以結合 [文件](3.3-戰鬥流程協議.md) 使用
|
||||
- 地圖坐標獲取：填寫 `stage_name` 後直接開一局，會在目錄下生成 `map.png`, 可以用於參考。也可參考 [PRTS.map](https://map.ark-nights.com/) 網站，在設定中將 `坐標展示` 修改為 `MAA` 後使用
|
||||
- 支援演習模式，不用一直浪費理智測試的
|
||||
- 若某個幹員名字一直辨識不對，可以打開日誌 `asst.log` 看一下到底被辨識成了什麼，並修改 `resource/tasks.json` - `CharsNameOcrReplace` 進行正規替換
|
||||
- 推薦在作業描述裡填上你自己的名字（作者名）、參考的攻略影片 url, 其他想說的等等（
|
||||
- 歡迎使用作業分享站 [www.抄作业.com](https://www.抄作业.com), [www.prts.plus](https://www.prts.plus) 分享/使用 作業檔！
|
||||
- 推薦在作業描述裡填上你自己的名字（作者名）、參考的攻略影片 url, 其他想說的等等
|
||||
|
||||
### 倉庫辨識
|
||||
|
||||
初版功能，請從倉庫 `養成材料` 畫面開始功能。目前僅支援導出到幾個資料站，後面可能會用來做一些更實用的功能（畫餅
|
||||
如您是某個資料站站長，也歡迎聯絡我們適配貴站的材料 JSON 協定~
|
||||
|
||||
### 其他亂七八糟的說明
|
||||
|
||||
- 主畫面上要執行的任務，是可以拖動改變順序的。同樣設定中基建換班的順序，也是可以拖動改變的。
|
||||
- 主畫面和設定中更改的配置一般都會自動保存，含有*號的選項除外。
|
||||
- 主畫面和設定中更改的配置一般都會自動保存，含有 * 號的選項除外。
|
||||
- 所有點擊操作，都是點擊按鈕內隨機位置，並模擬卜瓦松分佈（按鈕偏中間位置點的概率大，越往旁邊點到的概率越小）。
|
||||
- 底層算法純 C++ 開發，並設計了多重的快取技術，最大限度降低 CPU 和記憶體佔用。
|
||||
- 軟體支援自動更新 ✿✿ヽ(°▽°)ノ✿ 推薦非槓精的同學使用測試版，一般來說更新快且 bug 少（什麼 MIUI (╯‵□′)╯︵┻━┻
|
||||
- 如果新版本自動下載失敗，可手動下載後，直接把壓縮檔放到同目錄下，會自動更新的。
|
||||
- 如果新版本自動下載失敗，可手動下載後，直接把壓縮檔放到同目錄下，會自動更新的。
|
||||
|
||||
## 其他功能
|
||||
|
||||
若您有多個模擬器等需要雙開、多開同時操作，可將 MAA 資料夾複製多份，使用 **同一個 adb** 及 **不同的 adb 位址** 來進行連接後操作。
|
||||
Reference in New Issue
Block a user