diff --git a/docs/zh-tw/1.2-常見問題.md b/docs/zh-tw/1.2-常見問題.md index 1aabad7fb5..ed1e6c3367 100644 --- a/docs/zh-tw/1.2-常見問題.md +++ b/docs/zh-tw/1.2-常見問題.md @@ -98,11 +98,11 @@ icon: ph:question-fill ## 連接正常,但是無操作 -部分模擬器內建的 `adb` 版本過於老舊,不支援 `Minitouch` 相關操作。
+部分模擬器內建的 `adb` 版本過於老舊,不支援 `Minitouch` 相關操作。 -請使用系統管理員身分打開 MAA,點擊 `MAA 設定` - `連接設定` - `強制替換 ADB`。(建議關閉模擬器、重開 MAA 後再操作,否則可能替換失敗)
+請使用系統管理員身分打開 MAA,點擊 `MAA 設定` - `連接設定` - `強制替換 ADB`。(建議關閉模擬器、重開 MAA 後再操作,否則可能替換失敗) -模擬器更新後可能會重新覆蓋 adb 檔案。若更新後問題復現,請再次嘗試替換。
+模擬器更新後可能會重新覆蓋 adb 檔案。若更新後問題復現,請再次嘗試替換。 如果這樣也無法正常使用,可將 `連接設定` - `觸控模式` 從 `Minitouch` 切換到 `MaaTouch` 再次嘗試。由於 `Adb Input` 操作過於緩慢,請僅將其作為萬不得已的模式。 @@ -142,14 +142,14 @@ Pie64_2 核心:(核心名稱後的數字代表這是一個多開核心) MAA 現在會嘗試從註冊表中讀取 `bluestacks.conf` 的儲存位置,當該功能失效或出錯時,你需要手動指定配置檔案路徑 ::: -1. 在藍疊模擬器的數據目錄下找到 `bluestacks.conf` 這個檔案
+1. 在藍疊模擬器的數據目錄下找到 `bluestacks.conf` 這個檔案 - 國際版預設路徑為 `C:\ProgramData\BlueStacks_nxt\bluestacks.conf` - 中國內地版預設路徑為 `C:\ProgramData\BlueStacks_nxt_cn\bluestacks.conf` 2. 如果是第一次使用,請開啟一次 MAA,會在 MAA 的 `config` 目錄下產生 `gui.json`。 -3. **先關閉** MAA,**然後** 打開 `gui.json`,找到 `Configurations` 下的目前配置名欄位(可在 設定 - 切換配置 中查看,預設為 `Default`),在其中新增一個欄位 `Bluestacks.Config.Path`,填入 `bluestacks.conf` 的完整路徑。(注意斜槓要用轉義 `\\`)
+3. **先關閉** MAA,**然後** 打開 `gui.json`,找到 `Configurations` 下的目前配置名欄位(可在 設定 - 切換配置 中查看,預設為 `Default`),在其中新增一個欄位 `Bluestacks.Config.Path`,填入 `bluestacks.conf` 的完整路徑。(注意斜槓要用轉義 `\\`) ::: details 範例 以 `C:\ProgramData\BlueStacks_nxt\bluestacks.conf` 為例 @@ -174,7 +174,7 @@ MAA 現在會嘗試從註冊表中讀取 `bluestacks.conf` 的儲存位置,當 ## 檔案下載速度慢 -請嘗試使用 [MAA 下載站](https://ota.maa.plus/MaaAssistantArknights/MaaRelease/releases/download/) 下載。
+請嘗試使用 [MAA 下載站](https://ota.maa.plus/MaaAssistantArknights/MaaRelease/releases/download/) 下載。 我們的小水管頻寬較低,且流量有限。雖然搭出來就是給大家用的,但也希望不要濫用,若 github 或其他鏡像站可正常下載,建議優先選擇。 diff --git a/docs/zh-tw/2.2-開發相關.md b/docs/zh-tw/2.2-開發相關.md index 718bc8d7ce..590c0c9118 100644 --- a/docs/zh-tw/2.2-開發相關.md +++ b/docs/zh-tw/2.2-開發相關.md @@ -21,7 +21,7 @@ icon: iconoir:developer 4. 下載預構建的第三方庫 - **需要有 Python 環境,請自行搜尋 Python 安裝教學**
+ **需要有 Python 環境,請自行搜尋 Python 安裝教學** _(maadeps-download.py 檔案在項目根目錄)_ ```cmd @@ -39,7 +39,7 @@ icon: iconoir:developer - 右鍵 `MaaWpfGui` - 屬性 - 偵錯 - 啟用本地偵錯(這樣就能把斷點掛到 C++ Core 那邊了) 8. 到這裡,你就可以愉快地~~瞎ㄐㄅ改~~發電了 -9. 開發過程中,每一定數量,記得提交一個 commit,別忘了寫上 message
+9. 開發過程中,每一定數量,記得提交一個 commit,別忘了寫上 message 假如你不熟悉 git 的使用,你可能想要新建一個分支進行更改,而不是直接提交在 `dev` 上 ```bash diff --git a/docs/zh-tw/2.3-IssueBot使用方法.md b/docs/zh-tw/2.3-IssueBot使用方法.md index 63303f4389..a5cf724f20 100644 --- a/docs/zh-tw/2.3-IssueBot使用方法.md +++ b/docs/zh-tw/2.3-IssueBot使用方法.md @@ -13,8 +13,8 @@ Pull Request 被增加 `ambiguous` 標籤是因為沒有按照 commitizen 規則 ### 自動觸發 -- 給 issue 和 Pull Request 增加標籤,包括 `module` 系列 、`Client` 系列、`ambiguous`、`translation required` 等。
- Issue Bot 會根據關鍵字自動增加分類標籤。
+- 給 issue 和 Pull Request 增加標籤,包括 `module` 系列 、`Client` 系列、`ambiguous`、`translation required` 等。 + Issue Bot 會根據關鍵字自動增加分類標籤。 具體關鍵字可以參考 [配置檔案](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/.github/issue-checker.yml)。 - 給作者是可見性設定為 public 的 MAA 成員的 issue 和 Pull Request 增加 `MAA Team` 標籤。 @@ -31,7 +31,7 @@ Issue Bot 會對 Pull Request 標題的格式進行簡單審查。它會增加 ` ### 手動觸發 -多使用關鍵字詳細描述問題來自動觸發分類標籤,少使用下列指令。
+多使用關鍵字詳細描述問題來自動觸發分類標籤,少使用下列指令。 但 **當你知道自己的行為會導致 Issue Bot 誤解時除外**。 #### Issue 及 Pull Request @@ -45,7 +45,7 @@ Issue Bot 會對 Pull Request 標題的格式進行簡單審查。它會增加 ` - `Skip {LABEL_NAME}` 可以保證不增加標籤。 - `Skip labels` 可以保證不增加任何標籤。 -- 以下幾種方法可以為 issue 增加 `fixed` 標籤:1
+- 以下幾種方法可以為 issue 增加 `fixed` 標籤:1 - `https://github.com/MaaAssistantArknights/MaaAssistantArknights/commit/{COMMIT_HASH} fixed` - `fixed by https://github.com/MaaAssistantArknights/MaaAssistantArknights/commit/{COMMIT_HASH}` - `{VERSION} fixed` @@ -54,7 +54,7 @@ Issue Bot 會對 Pull Request 標題的格式進行簡單審查。它會增加 ` - **當你知道自己的 issue 評論會導致 Issue Bot 誤解時,盡量添加一些 skip 操作。** ::: info 注意 -這裡的 COMMIT_HASH 需要完整的 40 位 +1 這裡的 COMMIT_HASH 需要完整的 40 位 ::: #### 推送(Push) diff --git a/docs/zh-tw/2.4-純網頁端PR教學.md b/docs/zh-tw/2.4-純網頁端PR教學.md index 26db461db6..4da88921c5 100644 --- a/docs/zh-tw/2.4-純網頁端PR教學.md +++ b/docs/zh-tw/2.4-純網頁端PR教學.md @@ -6,7 +6,7 @@ icon: mingcute:git-pull-request-fill 牛牛也能看懂的 GitHub Pull Request 使用指南 (\*´▽`)ノノ ::: warning -本教學中對很多概念進行了簡化,為了讓更多朋友能實際用起來,甚至有一些很不優雅~~但是簡單~~的操作,還有一些不那麽正確的解釋,還請大佬們輕噴。
+本教學中對很多概念進行了簡化,為了讓更多朋友能實際用起來,甚至有一些很不優雅~~但是簡單~~的操作,還有一些不那麽正確的解釋,還請大佬們輕噴。 若您有一定的 git 使用經驗及程式基礎,~~那你還看個~~🔨,可以看稍微進階一點的教學 [Github Pull Request 流程簡述](2.2-開發相關.md) ::: @@ -24,18 +24,18 @@ icon: mingcute:git-pull-request-fill ### Fork(複製) -複製,字面意思,將 MAA 的代碼複製一份,然後可以進行後續修改等等的操作,避免把原來的弄壞了
+複製,字面意思,將 MAA 的代碼複製一份,然後可以進行後續修改等等的操作,避免把原來的弄壞了 但一般說中文 “複製” 我們可能首先想到的是 copy 的意思,fork 也沒有其他明確的翻譯,所以我們一般習慣直接說英文,比如 “把代碼 fork 一份走” -既然是複製後的,那就是 `MAA (1)`(bushi)
-為了和原本的倉庫區分開,所以我們一般將原本的 MAA 倉庫稱為 “主倉庫”、“upstream (上遊倉庫)”、“origin (原倉庫)”;
+既然是複製後的,那就是 `MAA (1)`(bushi) +為了和原本的倉庫區分開,所以我們一般將原本的 MAA 倉庫稱為 “主倉庫”、“upstream (上遊倉庫)”、“origin (原倉庫)”; 因為每個人都可以自己複製一份走,所以複製後的稱之為 “個人倉庫” ![image](https://user-images.githubusercontent.com/18511905/193750507-b8167df5-7a70-48d4-ba69-5dda8327e8ec.png) ### Pull Request(拉取請求、合併請求) -簡稱 PR,“拉取請求” 這個太直譯了,聽起來很奇怪,~~而且字太多了打起來太累~~,所以也是一樣的大家一般就直接說: “來個 PR”
+簡稱 PR,“拉取請求” 這個太直譯了,聽起來很奇怪,~~而且字太多了打起來太累~~,所以也是一樣的大家一般就直接說: “來個 PR” 書接上文,你 fork(複製)的個人倉庫,修改完了,怎麽把內容提供給主倉庫呢?這時候我們就可以開一個 PR,申請將自己修改的內容加入到主倉庫中。 當然啦,既然是 “請求”,那自然是需要審批的,MAA Team 的各位可能會針對你的修改提一些意見等,當然我們的意見也不一定完全正確,大家合理討論 ~ @@ -46,9 +46,9 @@ icon: mingcute:git-pull-request-fill ### Conflict(衝突) -假設一下,主倉庫中有個 A 檔案,它的內容是 111
-你 fork 了一份,將其內容改成了 222,但是你剛準備提交 PR,這時候張三也 fork 了一份並提交了 PR,並將 A 檔案改成了 333
-這時候我們就會看到,你倆都修改了 A 檔案,並且修改的不同,那聽誰的好呢?這就是 Conflict(衝突)
+假設一下,主倉庫中有個 A 檔案,它的內容是 111 +你 fork 了一份,將其內容改成了 222,但是你剛準備提交 PR,這時候張三也 fork 了一份並提交了 PR,並將 A 檔案改成了 333 +這時候我們就會看到,你倆都修改了 A 檔案,並且修改的不同,那聽誰的好呢?這就是 Conflict(衝突) 衝突解決起來比較麻煩,這裡僅闡述概念,方便實際遇到時能理解發生了什麽,暫不闡述解決方案 ## 純網頁端 PR 操作全流程 @@ -83,27 +83,27 @@ icon: mingcute:git-pull-request-fill ![image](https://user-images.githubusercontent.com/18511905/193754154-b21f4176-1418-49c8-87a3-dab088868fdc.png) 9. 還有第二個檔案要改的?改完了發現弄錯了想再改改?都沒關係!重複 5-8 即可! -10. 全改好了進行 PR !直接點 **個人倉庫** 裡的 Pull Request 標籤頁
+10. 全改好了進行 PR !直接點 **個人倉庫** 裡的 Pull Request 標籤頁 如果有 Compare & Pull Request 按鈕,那最好,直接點他!如果沒有也不用著急,點下面的 New Pull Request 也是一樣的(請看步驟 11) ![image](https://user-images.githubusercontent.com/18511905/193755450-59137215-4e0b-4eca-9ec9-8b35b52cd5ff.png) -11. 這時候來到了主倉庫,請核對一下你要 PR 的是否確認。
- 如圖中,中間有個向左的箭頭,是將右邊的 個人姓名/MAA 的 dev 分支,申請合併到 主倉庫/MAA 的 dev 分支。
+11. 這時候來到了主倉庫,請核對一下你要 PR 的是否確認。 + 如圖中,中間有個向左的箭頭,是將右邊的 個人姓名/MAA 的 dev 分支,申請合併到 主倉庫/MAA 的 dev 分支。 然後寫一下標題,你修改的具體內容等等的,然後點確認 ![20221004151004](https://user-images.githubusercontent.com/18511905/193756875-556df699-96b3-411f-815e-47050e283f4d.png) -12. 等待 MAA Team 的大佬們審核吧!當然他們也可能會提意見
+12. 等待 MAA Team 的大佬們審核吧!當然他們也可能會提意見 👇 比如(純屬娛樂切勿當真) ![image](https://user-images.githubusercontent.com/18511905/193757006-75170e78-4c8d-4cd2-b8eb-ca590ea7aa50.png) -13. 如果大佬們說要再修改一些小問題的話,回到 **你的個人倉庫**,切換到先前的 dev 分支,重複 步驟 3-9 即可!
- 注意不需要操作步驟 2(重新 fork),也不需要操作步驟 10(重新 Pull Request),你目前的 Pull Request 仍處於待審核狀態,後續的修改會直接進入到這個 Pull Request 中
+13. 如果大佬們說要再修改一些小問題的話,回到 **你的個人倉庫**,切換到先前的 dev 分支,重複 步驟 3-9 即可! + 注意不需要操作步驟 2(重新 fork),也不需要操作步驟 10(重新 Pull Request),你目前的 Pull Request 仍處於待審核狀態,後續的修改會直接進入到這個 Pull Request 中 👇 比如可以看到最下面多了一條 “重新修改演示” 的內容 ![image](https://user-images.githubusercontent.com/18511905/193757668-4064273c-576d-4259-bbaa-e9f65ae486c1.png) -14. 等大佬們審批通過,就全部完成啦!**版本發布後**,你的 GitHub 頭像將會自動進入到貢獻者列表名單中,非常感謝各位的無私奉獻!
+14. 等大佬們審批通過,就全部完成啦!**版本發布後**,你的 GitHub 頭像將會自動進入到貢獻者列表名單中,非常感謝各位的無私奉獻! ~~怎麽全是二次元啊,哦我也是啊,那沒事了~~ ::: tip 貢獻 / 參與者 感謝所有參與到開發 / 測試中的朋友們,是大家的幫助讓 MAA 越來越好! (*´▽`)ノノ @@ -111,11 +111,11 @@ icon: mingcute:git-pull-request-fill [![Contributors](https://contributors-img.web.app/image?repo=MaaAssistantArknights/MaaAssistantArknights&max=114514&columns=15)](https://github.com/MaaAssistantArknights/MaaAssistantArknights/graphs/contributors) ::: -16. 下次如果還想提別的 PR,請先切換到 dev 分支,然後直接如下圖操作
+16. 下次如果還想提別的 PR,請先切換到 dev 分支,然後直接如下圖操作 ::: warning 這個操作會強制將你的個人倉庫同步到和主倉庫一模一樣的狀態,這是最簡單粗暴但行之有效的解決衝突的方法。但如果你的個人倉庫已經有額外的編輯了,會被直接刪掉! ::: - 如果確定不會造成衝突,請使用右側綠色的 `Update Branch` 按鈕
+ 如果確定不會造成衝突,請使用右側綠色的 `Update Branch` 按鈕 如果你不清楚 / 不 care 我上面說的這一大堆,也請點擊左側的按鈕 diff --git a/docs/zh-tw/3.1-集成文件.md b/docs/zh-tw/3.1-集成文件.md index 4e673e01d0..3b7ef22b84 100644 --- a/docs/zh-tw/3.1-集成文件.md +++ b/docs/zh-tw/3.1-集成文件.md @@ -19,23 +19,23 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha #### 返回值 -- `AsstTaskId`
- 若添加成功,返回該任務 ID,可用於後續設定任務參數;
+- `AsstTaskId` + 若添加成功,返回該任務 ID,可用於後續設定任務參數; 若添加失敗,返回 0 #### 參數說明 -- `AsstHandle handle`
+- `AsstHandle handle` 實例句柄 -- `const char* type`
+- `const char* type` 任務類型 -- `const char* params`
+- `const char* params` 任務參數,json string ##### 任務類型一覽 -- `StartUp`
- 開始喚醒
+- `StartUp` + 開始喚醒 ```json // 對應的任務參數 @@ -51,8 +51,8 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha } ``` -- `CloseDown`
- 關閉遊戲
+- `CloseDown` + 關閉遊戲 ```json // 對應的任務參數 @@ -61,7 +61,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha } ``` -- `Fight`
+- `Fight` 刷理智 ```json @@ -96,7 +96,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha 另支援少部分資源關卡名請參考[集成範例](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/dev/tools/AutoLocalization/example/zh-cn.xaml#L260) -- `Recruit`
+- `Recruit` 公開招募 ```json @@ -136,7 +136,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha } ``` -- `Infrast`
+- `Infrast` 基建換班 ```json @@ -166,8 +166,8 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha } ``` -- `Mall`
- 領取信用及商店購物。
+- `Mall` + 領取信用及商店購物。 會先有序的按 `buy_first` 購買一遍,再從左到右並避開 `blacklist` 購買第二遍,在信用溢出時則會無視黑名單,從左到右購買第三遍直到不再溢出 ```json @@ -189,7 +189,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha } ``` -- `Award`
+- `Award` 領取日常獎勵 ```json @@ -199,7 +199,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha } ``` -- `Roguelike`
+- `Roguelike` 無限刷肉鴿 ```json @@ -228,7 +228,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha } ``` -- `Copilot`
+- `Copilot` 自動抄作業 ```json @@ -241,7 +241,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha 作業 JSON 請參考 [3.3-戰鬥流程協議](./3.3-戰鬥流程協議.md) -- `SSSCopilot`
+- `SSSCopilot` 自動抄保全作業 ```json @@ -254,7 +254,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha 保全作業 JSON 請參考 [3.7-保全派駐協議](./3.7-保全派駐協議.md) -- `Depot`
+- `Depot` 倉庫辨識 ```json @@ -264,7 +264,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha } ``` -- `OperBox`
+- `OperBox` 幹員 box 辨識 ```json @@ -274,7 +274,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha } ``` -- `ReclamationAlgorithm`
+- `ReclamationAlgorithm` 生息演算 ```json @@ -289,7 +289,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha } ``` -- `Custom`
+- `Custom` 自定義任務 @@ -304,7 +304,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha } ``` -- `SingleStep`
+- `SingleStep` 單步任務(目前僅支援戰鬥) @@ -323,7 +323,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha } ``` -- `VideoRecognition`
+- `VideoRecognition` 影片辨識,目前僅支援作業(作戰)影片 @@ -348,17 +348,17 @@ bool ASSTAPI AsstSetTaskParams(AsstHandle handle, AsstTaskId id, const char* par #### 返回值 -- `bool`
+- `bool` 返回是否設定成功 #### 參數說明 -- `AsstHandle handle`
+- `AsstHandle handle` 實例句柄 -- `AsstTaskId task`
+- `AsstTaskId task` 任務 ID, `AsstAppendTask` 接口的返回值 -- `const char* params`
- 任務參數,json string,與 `AsstAppendTask` 接口相同。
+- `const char* params` + 任務參數,json string,與 `AsstAppendTask` 接口相同。 未標注 “不支援執行中設定” 的欄位都支援實時修改;否則若當前任務正在執行,會忽略對應的欄位 ### `AsstSetStaticOption` @@ -375,14 +375,14 @@ bool ASSTAPI AsstSetStaticOption(AsstStaticOptionKey key, const char* value); #### 返回值 -- `bool`
+- `bool` 返回是否設定成功 #### 參數說明 -- `AsstStaticOptionKey key`
+- `AsstStaticOptionKey key` 鍵 -- `const char* value`
+- `const char* value` 值 ##### 鍵值一覽 @@ -403,16 +403,16 @@ bool ASSTAPI AsstSetInstanceOption(AsstHandle handle, AsstInstanceOptionKey key, #### 返回值 -- `bool`
+- `bool` 返回是否設定成功 #### 參數說明 -- `AsstHandle handle`
+- `AsstHandle handle` 實例句柄 -- `AsstInstanceOptionKey key`
+- `AsstInstanceOptionKey key` 鍵 -- `const char* value`
+- `const char* value` 值 ##### 鍵值一覽 diff --git a/docs/zh-tw/3.2-回呼訊息協議.md b/docs/zh-tw/3.2-回呼訊息協議.md index 1bdfe953f3..3e377bdbeb 100644 --- a/docs/zh-tw/3.2-回呼訊息協議.md +++ b/docs/zh-tw/3.2-回呼訊息協議.md @@ -15,7 +15,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom ## 參數總覽 -- `int msg`
+- `int msg` 消息類型 ```cpp @@ -44,9 +44,9 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom }; ``` -- `const char* details`
+- `const char* details` 消息詳情,json 字符串,詳見 [欄位解釋](#欄位解釋) -- `void* custom_arg`
+- `void* custom_arg` 調用方自定義參數,會原樣傳出 `AsstCreateEx` 接口中的 `custom_arg` 參數,C 系語言可利用該參數傳出 `this` 指針 ## 欄位解釋 @@ -82,25 +82,25 @@ Todo ### 常見 `What` 欄位 -- `ConnectFailed`
+- `ConnectFailed` 連接失敗 -- `Connected`
+- `Connected` 已連接,注意此時的 `uuid` 欄位值為空(下一步才是獲取) -- `UuidGot`
+- `UuidGot` 已獲取到設備唯一碼 -- `UnsupportedResolution`
+- `UnsupportedResolution` 解析度不被支援 -- `ResolutionError`
+- `ResolutionError` 解析度獲取錯誤 -- `Reconnecting`
+- `Reconnecting` 連接斷開(adb / 模擬器 炸了),正在重連 -- `Reconnected`
+- `Reconnected` 連接斷開(adb / 模擬器 炸了),重連成功 -- `Disconnect`
+- `Disconnect` 連接斷開(adb / 模擬器 炸了),並重試失敗 -- `ScreencapFailed`
+- `ScreencapFailed` 截圖失敗(adb / 模擬器 炸了),並重試失敗 -- `TouchModeNotAvailable`
+- `TouchModeNotAvailable` 不支援的觸控模式 ### AsyncCallInfo @@ -132,39 +132,39 @@ Todo #### 常見 `taskchain` 欄位 -- `StartUp`
+- `StartUp` 開始喚醒 -- `CloseDown`
+- `CloseDown` 關閉遊戲 -- `Fight`
+- `Fight` 刷理智 -- `Mall`
+- `Mall` 信用點及購物 -- `Recruit`
+- `Recruit` 自動公招 -- `Infrast`
+- `Infrast` 基建換班 -- `Award`
+- `Award` 領取日常獎勵 -- `Roguelike`
+- `Roguelike` 無限刷肉鴿 -- `Copilot`
+- `Copilot` 自動抄作業 -- `SSSCopilot`
+- `SSSCopilot` 自動抄保全作業 -- `Depot`
+- `Depot` 倉庫辨識 -- `OperBox`
+- `OperBox` 幹員 box 辨識 -- `ReclamationAlgorithm`
+- `ReclamationAlgorithm` 生息演算 -- `Custom`
+- `Custom` 自定義任務 -- `SingleStep`
+- `SingleStep` 單步任務 -- `VideoRecognition`
+- `VideoRecognition` 影片辨識任務 -- `Debug`
+- `Debug` 偵錯 ### TaskChain 相關消息 @@ -196,7 +196,7 @@ Todo #### 常見 `subtask` 欄位 -- `ProcessTask`
+- `ProcessTask` ```json // 對應的 details 欄位舉例 @@ -213,49 +213,49 @@ Todo ##### 常見 `task` 欄位 -- `StartButton2`
+- `StartButton2` 開始戰鬥 -- `MedicineConfirm`
+- `MedicineConfirm` 使用理智藥 -- `ExpiringMedicineConfirm`
+- `ExpiringMedicineConfirm` 使用 48 小時內過期的理智藥 -- `StoneConfirm`
+- `StoneConfirm` 碎石 -- `RecruitRefreshConfirm`
+- `RecruitRefreshConfirm` 公招刷新標籤 -- `RecruitConfirm`
+- `RecruitConfirm` 公招確認招募 -- `RecruitNowConfirm`
+- `RecruitNowConfirm` 公招使用加急許可 -- `ReportToPenguinStats`
+- `ReportToPenguinStats` 匯報到企鵝數據統計 -- `ReportToYituliu`
+- `ReportToYituliu` 匯報到一圖流大數據 -- `InfrastDormDoubleConfirmButton`
+- `InfrastDormDoubleConfirmButton` 基建宿舍的二次確認按鈕,僅當幹員衝突時才會有,請提示用戶 -- `StartExplore`
+- `StartExplore` 肉鴿開始探索 -- `StageTraderInvestConfirm`
+- `StageTraderInvestConfirm` 肉鴿投資了源石錠 -- `StageTraderInvestSystemFull`
+- `StageTraderInvestSystemFull` 肉鴿投資達到了遊戲上限 -- `ExitThenAbandon`
+- `ExitThenAbandon` 肉鴿放棄了本次探索 -- `MissionCompletedFlag`
+- `MissionCompletedFlag` 肉鴿戰鬥完成 -- `MissionFailedFlag`
+- `MissionFailedFlag` 肉鴿戰鬥失敗 -- `StageTraderEnter`
+- `StageTraderEnter` 肉鴿關卡:詭異行商 -- `StageSafeHouseEnter`
+- `StageSafeHouseEnter` 肉鴿關卡:安全的角落 -- `StageEncounterEnter`
+- `StageEncounterEnter` 肉鴿關卡:不期而遇 / 古堡饋贈 -- `StageCombatDpsEnter`
+- `StageCombatDpsEnter` 肉鴿關卡:普通作戰 -- `StageEmergencyDps`
+- `StageEmergencyDps` 肉鴿關卡:緊急作戰 -- `StageDreadfulFoe`
+- `StageDreadfulFoe` 肉鴿關卡:險路惡敵 - `StartGameTask` 打開用戶端失敗(配置檔案與傳入 client_type 不匹配) @@ -275,7 +275,7 @@ Todo #### 常見 `what` 及 `details` 欄位 -- `StageDrops`
+- `StageDrops` 關卡材料掉落資訊 ```json @@ -326,7 +326,7 @@ Todo } ``` -- `RecruitTagsDetected`
+- `RecruitTagsDetected` 公招辨識到了 Tags ```json @@ -342,7 +342,7 @@ Todo } ``` -- `RecruitSpecialTag`
+- `RecruitSpecialTag` 公招辨識到了特殊 Tag ```json @@ -352,7 +352,7 @@ Todo } ``` -- `RecruitResult`
+- `RecruitResult` 公招辨識結果 ```json @@ -429,7 +429,7 @@ Todo } ``` -- `RecruitTagsRefreshed`
+- `RecruitTagsRefreshed` 公招刷新了 Tags ```json @@ -440,7 +440,7 @@ Todo } ``` -- `RecruitNoPermit`
+- `RecruitNoPermit` 公招無招聘許可 ```json @@ -451,7 +451,7 @@ Todo ``` -- `RecruitTagsSelected`
+- `RecruitTagsSelected` 公招選擇了 Tags ```json @@ -464,13 +464,13 @@ Todo } ``` -- `RecruitSlotCompleted`
+- `RecruitSlotCompleted` 當前公招槽位任務完成 -- `RecruitError`
+- `RecruitError` 公招辨識錯誤 -- `EnterFacility`
+- `EnterFacility` 基建進入了設施 ```json @@ -481,7 +481,7 @@ Todo } ``` -- `NotEnoughStaff`
+- `NotEnoughStaff` 基建可用幹員不足 ```json @@ -492,7 +492,7 @@ Todo } ``` -- `ProductOfFacility`
+- `ProductOfFacility` 基建產物 ```json @@ -504,7 +504,7 @@ Todo } ``` -- `StageInfo`
+- `StageInfo` 自動作戰關卡資訊 ```json @@ -514,10 +514,10 @@ Todo } ``` -- `StageInfoError`
+- `StageInfoError` 自動作戰關卡辨識錯誤 -- `PenguinId`
+- `PenguinId` 企鵝物流 ID ```json @@ -527,7 +527,7 @@ Todo } ``` -- `Depot`
+- `Depot` 倉庫辨識結果 ```json @@ -567,7 +567,7 @@ Todo // 目前只支援 ArkPlanner 和 Lolicon 的格式,以後可能會兼容更多網站 ``` -- `OperBox`
+- `OperBox` 幹員辨識結果 ```json @@ -615,5 +615,5 @@ Todo ] ``` -- `UnsupportedLevel`
+- `UnsupportedLevel` 自動抄作業,不支援的關卡名 diff --git a/docs/zh-tw/3.6-基建排班協議.md b/docs/zh-tw/3.6-基建排班協議.md index f2dd0a3a59..e725fdd6d5 100644 --- a/docs/zh-tw/3.6-基建排班協議.md +++ b/docs/zh-tw/3.6-基建排班協議.md @@ -144,5 +144,6 @@ icon: material-symbols:view-quilt-rounded ## 範例檔案 -[243 極限效率,一天三換](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/243_layout_3_times_a_day.json)
-[153 極限效率,一天三換](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/153_layout_3_times_a_day.json)
+[243 極限效率,一天三換](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/243_layout_3_times_a_day.json) + +[153 極限效率,一天三換](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/153_layout_3_times_a_day.json) diff --git a/docs/zh-tw/3.7-保全派駐協議.md b/docs/zh-tw/3.7-保全派駐協議.md index 2531a24efe..58a7fa6962 100644 --- a/docs/zh-tw/3.7-保全派駐協議.md +++ b/docs/zh-tw/3.7-保全派駐協議.md @@ -139,5 +139,6 @@ icon: game-icons:prisoner ## 範例檔案 -[SSS_阿卡胡拉叢林.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_阿卡胡拉丛林.json)
+[SSS_阿卡胡拉叢林.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_阿卡胡拉丛林.json) + [SSS_多索雷斯在建地塊.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_多索雷斯在建地块.json) diff --git a/docs/zh-tw/readme.md b/docs/zh-tw/readme.md index d796af9fb3..40bf433b1b 100644 --- a/docs/zh-tw/readme.md +++ b/docs/zh-tw/readme.md @@ -47,7 +47,7 @@ MAA 的意思是 MAA Assistant Arknights - 倉庫辨識並支援匯出至 [企鵝物流刷圖規劃器](https://penguin-stats.io/planner) , [明日方舟工具箱](https://arkn.lolicon.app/#/material) , [ARK-NIGHTS 幹員培養表](https://ark-nights.com/settings) ; - 支援 C, Python, Java, Rust, Golang, Java HTTP, Rust HTTP 等多種接口,方便集成調用,自定義你的 MAA! -話不多說,看圖!
+話不多說,看圖! ![zh1](https://user-images.githubusercontent.com/9762652/259595058-1529207a-ef3d-4eca-a016-4759eb534c6e.png) ![zh2](https://user-images.githubusercontent.com/9762652/259594965-882b61e6-bf31-40c1-8c03-3f51f82a0d42.png) @@ -64,7 +64,7 @@ MAA 的意思是 MAA Assistant Arknights ### 基本說明 1. 請根據 [模擬器支援情況](./1.3-模擬器支援.md),進行對應的操作。 -2. 修改模擬器解析度為 `16:9` 比例,最低 `1280 * 720`,最高 `2K`。
+2. 修改模擬器解析度為 `16:9` 比例,最低 `1280 * 720`,最高 `2K`。 對於國際服(美服)玩家,由於介面佈局問題,我們則建議您將解析度修改為 `1920 * 1080`。 3. 開始使用吧! @@ -84,7 +84,7 @@ MAA 的意思是 MAA Assistant Arknights ## 外服支援 -目前國際服(美服)、日服、韓服、繁中服的絕大部分功能均已支援。但由於外服用戶較少及項目人手不足,很多功能並沒有進行全面的測試,所以請自行體驗。
+目前國際服(美服)、日服、韓服、繁中服的絕大部分功能均已支援。但由於外服用戶較少及項目人手不足,很多功能並沒有進行全面的測試,所以請自行體驗。 若您遇到了 Bug,或對某個功能有強需求,歡迎在 [Issues](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues) 和 [討論區](https://github.com/MaaAssistantArknights/MaaAssistantArknights/discussions) 催更;或加入我們一起建設 MAA!請參考 [外服適配教學](#外服適配) ## 主要關聯項目 @@ -188,12 +188,12 @@ MAA 的意思是 MAA Assistant Arknights ## 廣告 -用戶交流 QQ 群:[MAA 使用 & 粥遊交流 QQ 群](https://ota.maa.plus/MaaAssistantArknights/api/qqgroup/index.html)
-用戶交流 TG 群:[Telegram 群](https://t.me/+Mgc2Zngr-hs3ZjU1)
-自動戰鬥 JSON 作業分享:[prts.plus](https://prts.plus) 或 [抄作業.com](http://抄作業.com)
-Bilibili 直播間:[直播間](https://live.bilibili.com/2808861) 每晚直播敲代碼,近期很長一段時間應該都是在寫本軟體 ~
+用戶交流 QQ 群:[MAA 使用 & 粥遊交流 QQ 群](https://ota.maa.plus/MaaAssistantArknights/api/qqgroup/index.html) +用戶交流 TG 群:[Telegram 群](https://t.me/+Mgc2Zngr-hs3ZjU1) +自動戰鬥 JSON 作業分享:[prts.plus](https://prts.plus) 或 [抄作業.com](http://抄作業.com) +Bilibili 直播間:[直播間](https://live.bilibili.com/2808861) 每晚直播敲代碼,近期很長一段時間應該都是在寫本軟體 ~ -技術群(舟無關、禁水):[內卷地獄!(QQ 群)](https://jq.qq.com/?_wv=1027&k=ypbzXcA2)
-開發者群:[QQ 群](https://jq.qq.com/?_wv=1027&k=JM9oCk3C)
+技術群(舟無關、禁水):[內卷地獄!(QQ 群)](https://jq.qq.com/?_wv=1027&k=ypbzXcA2) +開發者群:[QQ 群](https://jq.qq.com/?_wv=1027&k=JM9oCk3C) 如果覺得軟體對你有幫助,幫忙點個 Star 吧!~(網頁最上方右上角的小星星),這就是對我們最大的支持了!