專用 VS Code 擴充功能教學
約 1336 字大約 4 分鐘
此擴充功能針對 MaaAssistantArknights/MaaFramework 提供了一系列便利開發的功能,包括但不限於以下項目:
tasks.json支援:包含template 預覽、next 跳轉、任務引用等。- 擷取與裁剪圖片。
具體詳細內容可以前往 擴充功能商店 或 GitHub 倉庫 查看。
安裝
推薦直接在 VS Code 的擴充功能清單中搜尋 Maa 進行安裝。
提示
首次使用時,擴充功能會自動下載預設版本的資源。
搜尋命令 Maa: 選擇下載源,可切換下載來源(npm / cnpm)。
功能介紹
控制面板
左側活動列添加了專用控制面板,圖示如下:
擴充功能絕大部分的功能皆基於 interface.json 配置。在控制面板最上方可以選擇目前生效的 interface.json。
此外,擴充功能具備 Maa 相容模式。當在開啟的資料夾下偵測到 src/MaaCore 資料夾時,系統會自動啟用該模式。
語義化資源分析
透過切換控制面板中的「資源」下拉選單選擇預期資源,擴充功能會根據對應路徑進行索引與診斷。
若發現想編輯的 JSON 檔案沒有出現提示,請檢查目前啟動的資源是否包含該檔案。
所謂「任務的定義」,是指任務物件中的鍵 (Key)。
所謂「任務的引用」,是指其他任務中可以填入任務名稱的值 (Value)(例如
next欄位中)。
查詢任務定義與引用
擴充功能支援跳轉至定義、跳轉至引用,以及查看任務定義。
開啟 Maa 相容模式時,可解析 範本任務,支援連動父類別查詢任務定義與引用;懸停在任務定義上時,可查看同名的範本圖片。
使用 Ctrl + T 快捷鍵,可快速搜尋並跳轉至任務定義。
查詢與開啟圖片
擴充功能支援直接開啟圖片。
開啟 Maa 相容模式時,支援圖片路徑的遞迴搜尋。
任務自動補全
擴充功能支援根據所有已知任務進行自動補全。
開啟 Maa 相容模式時,輸入 @ 符號將觸發補全選單。
補全圖片路徑
擴充功能支援根據所有已知圖片路徑進行自動補全。
開啟 Maa 相容模式時,支援圖片路徑的遞迴搜尋。
校驗任務與圖片路徑
擴充功能支援定時掃描並分析所有任務:
- 檢查是否有重複命名的任務定義。
- 檢查是否有未知的任務引用。
- 檢查是否有未知的圖片引用。
- 檢查單一任務中是否有重複的任務引用。
多路徑資源支援
擴充功能支援資源包含多個路徑,並會按照指定順序進行邏輯覆蓋,即後載入的內容可以引用到先載入的內容。
計算任務 / 任務列表運算式 (僅限 MAA)
透過控制面板,可以計算任務實際展開的內容及其每一項的來源,亦可計算任務列表運算式展開後的結果。
MaaPiCli 功能 (僅限 MaaFramework 專案)
透過控制面板,可以掃描並選擇控制器、選擇資源、添加並管理任務,以及執行任務。
截圖裁剪與快速辨識
在 VS Code 的命令面板中搜尋並執行 Maa: 開啟截圖工具,即可開啟 截圖 / 裁剪 面板。
使用
Ctrl + Shift + P(macOS 為Command + Shift + P) 呼叫命令面板。
- 選擇並連線控制器後,可使用「截圖」按鈕直接獲取螢幕截圖。
- 可使用
上傳按鈕手動上傳圖片。 - 按住
Ctrl鍵,框選需要裁剪的區域。 - 使用滑鼠滾輪可進行縮放。
- 裁剪完成後,使用
下載按鈕,可自動將裁剪結果儲存至啟動資源中最頂層的圖片目錄。 - 使用
複製按鈕,可將 ROI 以陣列形式複製到剪貼簿。 - 按下
工具按鈕將開啟辨識工具面板,可直接對當前圖片進行辨識測試。
日誌查看功能
MaaFramework 日誌
在 VS Code 的命令面板中搜尋並執行 Maa: 開啟 maa 日誌,可查看偵錯期間產生的 maa.log 日誌。
MAA Pipeline Support 擴充功能日誌
在 VS Code 的命令面板中搜尋並執行 Maa: 開啟插件日誌,可查看擴充功能運作期間產生的 mse.log 日誌。
底部狀態列
MaaSupport <擴充功能版本>
點擊可聚焦至控制面板。
MaaFramework <MaaFw版本>
點擊可切換擴充功能使用的 MaaFramework 版本。可選擇的版本受限於當前擴充功能支援的範圍,若清單中沒有需要的版本,請考慮更換擴充功能之版本。
