介面介紹

AsstAppendTask

介面原型

AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* params);

介面說明

新增任務。

回傳值

• AsstTaskId
  若新增成功，回傳該任務 ID，可用於後續設定任務參數；
  若新增失敗，回傳 0。

參數說明

handleRequiredAsstHandle

執行個體控制代碼 (Handle)

typeRequiredconst char*

任務類型

paramsRequiredconst char*

任務參數，json String

任務類型一覽

• StartUp
  開始喚醒

enableOptionalboolean

true

是否啟用本任務。

client_typeRequiredstring

用戶端版本。
選項：Official | Bilibili | txwy | YoStarEN | YoStarJP | YoStarKR

start_game_enabledOptionalboolean

false

是否自動啟動用戶端。

account_nameOptionalstring

切換帳號，預設不切換。
僅支援切換至已登入的帳號。依據登入名稱進行搜尋，請確保輸入內容在所有帳號中具有唯一性。
官服：123****4567，可輸入 123****4567、4567、123、3****4567
B 服：張三，可輸入 張三、張、三
繁中服：帳號為 Email，如 ab****01@gmail.com，建議填不含星號的明文片段，如 01@gmail

Example

{
   "enable": true,
   "client_type": "Official",
   "start_game_enabled": true,
   "account_name": "123****4567"
}

• CloseDown
  關閉遊戲

enableOptionalboolean

true

是否啟用本任務。

client_typeRequiredstring

用戶端版本，若留空則不執行。
選項：Official | Bilibili | txwy | YoStarEN | YoStarJP | YoStarKR

Example

{
   "enable": true,
   "client_type": "Official"
}

• Fight
  理智作戰

enableOptionalboolean

true

是否啟用本任務。

stageOptionalstring

關卡名稱。預設為空，將辨識 目前/上次 關卡。不支援在執行中更改設定。 目前支援導航的關卡包含：

• 全部主線關卡：可在關卡末尾新增 -NORMAL 或 -HARD 切換難度：10-14 章對應標準/磨難，15 章及以後對應常規/險地。
• 資源收集：
• 龍門幣、作戰記錄： 支援第 5 / 6 關，但必須輸入 CE-6 / LS-6。若第六關無法代理，MAA 會自動切換至第五關。
• 技能書、採購憑證、碳本：支援第 5 關，必須輸入 CA-5 / AP-5 / SK-5。
• 晶片關卡：支援所有關卡，必須輸入完整編號，例如PR-A-1。
• 剿滅作戰：支援以下傳入值（必須使用對應的 Value）：
• 當期剿滅：Annihilation
• 切爾諾伯格：Chernobog@Annihilation
• 龍門外環：LungmenOutskirts@Annihilation
• 龍門市區：LungmenDowntown@Annihilation
• 別傳：支援 OF-1 / OF-F3。
• 當期 SideStory 活動：支援活動後三關。可查閱 API 獲取支援的關卡列表。需額外載入 tasks.json 中的活動關卡導航。
• 復刻 SideStory 活動：輸入 SSReopen-<關卡前綴> ，可一次性刷完 XX-1 ~ XX-9 關，如 SSReopen-IC。

medicineOptionalnumber

0

理智藥最大使用量。

medicine_expire_daysOptionalnumber

0

使用過期時間在指定天數內的理智藥，0 表示不使用過期理智藥。

expiring_medicineOptionalDeprecatednumber

0

已棄用，自 v6.8.0 起請使用 medicine_expire_days 代替。

stoneOptionalnumber

0

碎石最大數量。

timesOptionalnumber

2147483647

戰鬥次數。

seriesOptionalnumber

1

代理倍率，-1 ~ 10。
-1：停用自動切換代理倍率。
0：自動切換為當前可用的最大代理倍率（若理智不足以進行最大倍率，則選擇最低可用倍率）。
1 ~ 10：指定固定的代理倍率。

伺服器差異

輸入驗證取決於資源是否存在 FightSeries-OldMethodFlag：

• 新列表（國服 2026/8/1 後主資源，無該 flag）：接受 -1~10
• 舊列表（外服資源帶該 flag）：僅接受 -1~6，更大值會被拒絕

外服預計約半年後跟進，屆時上限隨資源變為 10。Windows GUI 的代理倍率下拉目前固定提供到 10；外服若手動選擇 7~10，任務下發時會被 Core 拒絕。

dropsOptionalobject

指定物品掉落數量，預設不指定。key 為 item_id，value 為數量。key 可參考 resource/item_index.json 檔案。
例如：{ "30011": 10, "30062": 5 }
上述所有條件（次數、掉落等）均為「或」的關係，任一條件達成即停止任務。

report_to_penguinOptionalboolean

false

是否回報企鵝物流

penguin_idOptionalstring

企鵝物流回報 ID，預設為空。僅在 report_to_penguin 為 true 時有效。

report_to_yituliuOptionalboolean

false

是否回報一圖流。

yituliu_idOptionalstring

一圖流回報 ID，預設為空。僅在 report_to_yituliu 為 true 時有效。

serverOptionalstring

CN

遊戲伺服器，會影響掉落物辨識及數據上傳。
選項：CN | US | JP | KR

client_typeOptionalstring

用戶端版本，預設為空。用於遊戲崩潰後自動重啟並接續任務；若為空則不啟用自動重啟功能。
選項：Official | Bilibili | txwy | YoStarEN | YoStarJP | YoStarKR

DrGrandetOptionalboolean

false

博朗台模式（節省理智碎石模式），僅在產生碎石需求時才起作用。
在碎石確認介面等待，直到目前理智自動恢復 1 點後，再立刻執行碎石回復，以避免浪費自然恢復。

Example

{
   "enable": true,
   "stage": "1-7",
   "medicine": 1,
   "medicine_expire_days": 2,
   "stone": 0,
   "times": 10,
   "series": 0,
   "drops": {
      "30011": 10
   },
   "report_to_penguin": true,
   "penguin_id": "123456",
   "report_to_yituliu": true,
   "yituliu_id": "123456",
   "server": "CN",
   "client_type": "Official",
   "DrGrandet": false
}

• Recruit
  公開招募

enableOptionalboolean

true

是否啟用本任務。

refreshOptionalboolean

false

是否刷新三星 Tags。

selectRequiredarray<number>

會被自動點選的 Tag 等級。

confirmRequiredarray<number>

會被自動點選確認的 Tag 等級。若只想計算結果而不實際招募，請設定為空陣列。

level3_recruitment_permit_reserveOptionalnumber

0

自動確認 3 星時保留的招聘許可數量。目前許可數量小於等於此值時會跳過 3 星招募，4 星以上不受影響；設為 0 時停用。啟用後若數量辨識失敗，也會跳過目前的 3 星招募，以避免誤用保留的許可。

first_tagsOptionalarray<string>

首選 Tags，僅在 Tag 等級為 3 時有效，預設為空。
當 Tag 等級為 3 時，會盡可能多選擇此處設定的 Tags（若有出現），且為強制選擇，會忽略所有 "讓 3 星 Tag 不被選擇" 的設定。

extra_tags_modeOptionalnumber

0

選擇更多的 Tags。
0：預設行為。
1：選滿 3 個 Tags，即使可能產生衝突。
2：儘可能同時選擇更多高星標籤組合，即使可能產生衝突。

timesOptionalnumber

0

招募總次數。若僅需公招計算，請設定為 0。

set_timeOptionalboolean

true

是否設定招募時限。僅在 times 為 0 時才套用。

expediteOptionalboolean

false

是否使用加急許可。

expedite_timesOptionalnumber

加急次數，僅在 expedite 為 true 時有效。當前版本已不生效，加急不受次數限制，直至 times 達到上限。

skip_robotOptionalboolean

true

已棄用，僅用於相容舊參數。
當未提供 preserve_tags 且其值為 true 時，會在辨識到 支援机械 時跳過；元素 不再視為舊版 1 星 Tag。

preserve_tagsOptionalarray<string>

需要保留並跳過目前公招欄位的 Tag 名稱清單。預設為空。
當辨識到任一指定 Tag 時，MAA 會保留該欄位並跳過本次招募。

recruitment_timeOptionalobject

Tag 等級（大於等於 3）對應的期望招募時限（單位：分鐘）。預設皆為 540 分鐘（即 09:00:00）。
範例：{ "3": 540, "4": 540 }

report_to_penguinOptionalboolean

false

是否回報企鵝物流。

penguin_idOptionalstring

企鵝物流回報 ID，預設為空。僅在 report_to_penguin 為 true 時有效。

report_to_yituliuOptionalboolean

false

是否回報一圖流數據。

yituliu_idOptionalstring

一圖流回報 ID，預設為空。僅在 report_to_yituliu 為 true 時有效。

serverOptionalstring

CN

遊戲伺服器，會影響數據上傳。
選項：CN | US | JP | KR

Example

{
   "enable": true,
   "refresh": true,
   "select": [5, 4],
   "confirm": [4, 3],
   "level3_recruitment_permit_reserve": 8,
   "first_tags": ["高级资深干员"],
   "extra_tags_mode": 1,
   "times": 4,
   "set_time": true,
   "expedite": false,
   "expedite_times": 0,
   "preserve_tags": ["支援机械"],
   "recruitment_time": {
      "3": 540,
      "4": 540
   },
   "report_to_penguin": false,
   "penguin_id": "123456",
   "report_to_yituliu": false,
   "yituliu_id": "123456",
   "server": "CN"
}

• Infrast
  基建換班

enableOptionalboolean

true

是否啟用本任務。

modeOptionalnumber

0

換班工作模式。
0 - Default：預設換班模式，自動計算效率較高的設施內及跨設施幹員組合。
10000 - Custom：自訂換班模式，讀取使用者配置，可參閱 基建排班協定。
20000 - Rotation：一鍵輪換模式，會跳過控制中樞、發電站、宿舍以及辦公室；其餘設施不進行換班，但保留基本操作（如使用無人機、會客室邏輯）。

facilityRequiredarray<string>

要換班的設施。不支援在執行中更改設定。
mode = 0 時該陣列為啟用集合，順序與重複項不參與調度（換班順序由演算法統一安排）；mode = 10000 / 20000 時按陣列順序執行。
設施名稱：Mfg | Trade | Power | Control | Reception | Office | Dorm | Processing | Training | AssistantChange

dronesOptionalstring

\_NotUse

無人機用途。當 mode = 10000 時，此欄位無效。
選項：_NotUse | Money | SyntheticJade | CombatRecord | PureGold | OriginStone | Chip

thresholdOptionalnumber

0.3

工作心情門檻值，取值範圍 [0, 1.0]。
mode = 10000 時，此欄位僅針對 "autofill" 起作用。
mode = 20000 時，此欄位無效。

replenishOptionalboolean

false

貿易站「源石碎片」是否自動補貨。

dorm_notstationed_enabledOptionalboolean

false

是否啟用宿舍「未進駐」選項。

dorm_trust_enabledOptionalboolean

false

是否將宿舍剩餘位置填入信賴值未滿的幹員。

fiammetta_targetsOptionalarray<string>

["清流", "可露希尔", "但书"]

菲亞梅塔恢復目標名單，換班開始時會將名單中當前心情最低的幹員與菲亞梅塔一同進駐宿舍互換心情。僅 mode = 0 且 fiammetta_recovery_enabled 為 true 時生效。
選項：清流 | 可露希尔 | 但书 | 巫恋 | 龙舌兰 | 歌蕾蒂娅（不在選項內或重複的條目會被忽略）

fiammetta_recovery_enabledOptionalboolean

false

是否在換班開始時使用菲亞梅塔為恢復目標恢復心情；關閉時換班將跳過宿舍準備步驟。僅 mode = 0 時生效。

use_pinus_sylvestrisOptionalboolean

false

是否啟用 ｢紅松騎士團｣ 跨設施組合。僅 mode = 0 時生效。

use_perception_informationOptionalboolean

false

是否啟用 ｢感知資訊｣ 跨設施組合，優先度高於 ｢人間煙火｣。僅 mode = 0 時生效。

use_worldly_plightOptionalboolean

false

是否啟用 ｢人間煙火｣ 跨設施組合。僅 mode = 0 時生效。

use_abyssal_hunterOptionalboolean

false

是否啟用 ｢深海獵人｣ 跨設施組合。僅 mode = 0 時生效，與 ｢紅松騎士團｣ 同時啟用時兩者不會同時參與排班。

reception_message_boardOptionalboolean

true

是否領取會客室資訊板信用點數。

reception_clue_exchangeOptionalboolean

true

是否進行線索交流。

reception_send_clueOptionalboolean

true

是否贈送線索。

filenameRequiredstring

自訂配置路徑。不支援在執行中更改設定。

僅在 mode = 10000 時才適用

plan_indexRequirednumber

使用配置中的方案序號。不支援在執行中更改設定。

僅在 mode = 10000 時才適用

continue_trainingOptionalboolean

false

訓練室是否繼續未完成的專精訓練。

Example

{
   "enable": true,
   "mode": 0,
   "facility": ["Mfg", "Trade", "Reception"],
   "drones": "PureGold",
   "threshold": 0.3,
   "replenish": true,
   "dorm_notstationed_enabled": false,
   "dorm_trust_enabled": true,
   "reception_message_board": true,
   "reception_clue_exchange": true,
   "reception_send_clue": true,
   "filename": "schedules/base.json",
   "plan_index": 1
}

• Mall
  領取信用點數及商店購物。
  會先依據 buy_first 清單依序購買；接著由左至右掃描商店，避開 blacklist 進行第二輪購買；若信用點數溢出，則會無視黑名單再次由左至右購買，直到信用點數不再溢出為止。

enableOptionalboolean

true

是否啟用本任務。

visit_friendsOptionalboolean

true

是否訪問好友基建以獲得信用點數。

shoppingOptionalboolean

true

是否執行購物流程。

buy_firstOptionalarray<string>

[]

優先購買清單。填入商品名稱，例如 "招聘許可"、"龍門幣" 等。

blacklistOptionalarray<string>

[]

購物黑名單。填入商品名稱，例如 "加急許可"、"傢俱零件" 等。

force_shopping_if_credit_fullOptionalboolean

false

當信用點數溢出時，是否無視黑名單強制購買。

only_buy_discountOptionalboolean

false

是否僅購買折扣商品，此設定僅對第二輪購買有效。

reserve_max_creditOptionalboolean

false

當信用點數低於 300 時是否停止購買，此設定僅對第二輪購買有效。

credit_fightOptionalboolean

false

是否借助戰打一次 OF-1 關卡，以便在隔日獲取更多信用點數。

formation_indexOptionalnumber

0

打 OF-1 關卡時所使用的編隊欄位編號。
範圍為 0–4 的整數，其中 0 表示選擇目前編隊，1-4 分別代表第一、二、三、四編隊。

Example

{
   "enable": true,
   "visit_friends": true,
   "shopping": true,
   "buy_first": ["招聘许可", "龙门币"],
   "blacklist": ["家具零件"],
   "force_shopping_if_credit_full": false,
   "only_buy_discount": true,
   "reserve_max_credit": false,
   "credit_fight": false,
   "formation_index": 0
}

• Award
  領取各種獎勵

enableOptionalboolean

true

是否啟用本任務。

awardOptionalboolean

true

領取 每日/每週任務獎勵。

mailOptionalboolean

false

領取所有郵件獎勵。

recruitOptionalboolean

false

領取「限時尋訪」每日贈送的免費單抽。

orundumOptionalboolean

false

領取「幸運牆」的合成玉獎勵。

miningOptionalboolean

false

領取「限時開採許可」的合成玉獎勵。

specialaccessOptionalboolean

false

領取五週年贈送的月卡獎勵。

signineventOptionalboolean

false

領取限時簽到活動獎勵（僅支援常見橫向版型）。

Example

{
   "enable": true,
   "award": true,
   "mail": true,
   "recruit": true,
   "orundum": false,
   "mining": true,
   "specialaccess": false,
   "signinevent": false
}

• SwitchTheme
  更換遊戲主介面主題

enableOptionalboolean

true

是否啟用本任務。

themesRequiredstring[]

候選主題名稱列表，需與遊戲內主題列表中顯示的名稱一致；包含多個時每次執行隨機選擇一個，為空陣列時跳過本任務。

Example

{
   "enable": true,
   "themes": ["夜間", "銀淞"]
}

• Roguelike
  無限刷肉鴿

enableOptionalboolean

true

是否啟用本任務。

themeOptionalstring

Phantom

主題。
Phantom - 傀影與猩紅孤鑽
Mizuki - 水月與深藍之樹
Sami - 探索者的銀淞止境
Sarkaz - 薩卡茲的無終奇語
JieGarden - 歲的界園誌異
BlackFlow - 黑流樹海

modeOptionalnumber

0

模式。
0 - 刷分 / 獎勵點數：盡可能穩定地打更多層數。
1 - 刷源石錠：第一層投資完後立即退出。
2 - 已移除 原兼顧模式 0 與 1，當前版本傳入會被拒絕。
3 - 未開放 傳入會被拒絕。
4 - 凹開局：先在難度 0 下到達第三層後重啟，再到指定難度下凹開局獎勵。若未獲得「熱水壺」或「希望」則回到難度 0 重新開始。在 Phantom 主題下則不切換難度，僅在目前難度下嘗試到達第三層、重開、凹開局。
5 - 刷坍縮範式：僅適用於 Sami 主題；透過戰鬥漏怪等方式加快累積坍縮值。若遇到的首個坍縮範式存在於 expected_collapsal_paradigms 清單中則停止任務，否則重啟。
6 - 刷月度小隊獎勵：除了模式適配外，其餘邏輯同模式 0。
7 - 刷深入調查獎勵：除了模式適配外，其餘邏輯同模式 0。
10001 - 快速通過第一層；僅適用於 Sarkaz 主題。
20001 - 刷常樂節點，第一層進洞，找不到需要的節點就重開；僅適用於 JieGarden 主題，需配合 find_playTime_target。
30001 - 刷襁褓動物；僅適用於 BlackFlow 主題。

squadOptionalstring

指挥分队

開局分隊名稱。

rolesOptionalstring

取长补短

開局職業組合。

core_charOptionalstring

開局幹員名稱。僅支援單個幹員的中文名稱（不分遊戲伺服器）；若留空或設定為空字串 "" 則根據練度自動選擇。等價於 core_char_list 的第 1 順位，僅為向下相容保留。

core_char_listOptionalarray<object>

開局幹員列表。每項為 { "name": 幹員名稱, "use_support": 是否借助戰 }，幹員名稱同樣僅支援中文名稱（不分遊戲伺服器）；按陣列順序對應開局第 1、2、3 次招募，三個位置的幹員職業不能相同。招募只在前幾頁內翻找指定幹員，希望消耗低的幹員可能因排位靠後而找不到，某位置未招募到指定幹員（自有與助戰均未出現）時按預設優先順序進行，因此建議將希望消耗高的幹員排在前面；與 core_char 同時傳入時以本欄位為準。

use_supportOptionalboolean

false

開局幹員是否使用助戰幹員。等價於 core_char_list 第 1 順位的借助戰標記，僅為向下相容保留。

use_nonfriend_supportOptionalboolean

false

是否接受非好友助戰幹員。全域開關，作用於所有借助戰的開局幹員位置。

starts_countOptionalnumber

2147483647

開始探索的次數上限。達到後自動停止任務。

difficultyOptionalnumber

-1

指定難度等級，-1 表示不指定難度。若指定難度未解鎖，則會選擇目前已解鎖的最高難度。

stop_at_final_bossOptionalboolean

false

是否在第 5 層「險路惡敵」節點前停止任務。僅適用於 Phantom 以外的主題。

stop_at_max_levelOptionalboolean

false

是否在肉鴿等級刷滿後停止任務。

investment_enabledOptionalboolean

true

是否進行源石錠投資。

investments_countOptionalnumber

2147483647

投資源石錠的次數上限。達到後自動停止任務。

stop_when_investment_fullOptionalboolean

false

是否在投資到達上限後停止任務。

investment_with_more_scoreOptionalboolean

false

是否在投資後嘗試購物。僅適用於模式 1。

start_with_elite_twoOptionalboolean

false

是否在凹開局的同時凹幹員精二直升。僅適用於模式 4。

only_start_with_elite_twoOptionalboolean

false

是否只凹精二直升而忽略其他開局條件。僅在模式為 4 且 start_with_elite_two 為 true 時有效。

refresh_trader_with_diceOptionalboolean

false

是否消耗骰子刷新商店以購買特殊商品。僅適用於 Mizuki 主題（用於刷指路鱗）。

first_floor_foldartalOptionalstring

希望在第一層「遠見」階段獲得的密文板。僅適用於 Sami 主題（不限模式）；若成功凹到則停止任務。

start_foldartal_listOptionalarray<string>

[]

凹開局時希望在開局獎勵階段獲得的密文板清單。僅在主題為 Sami 且模式為 4 時有效。
開局獎勵階段，需擁有清單中所有的密文板才算凹開局成功。
請注意，此參數須與「生活至上分隊」同時使用，其他分隊在開局獎勵階段不會獲得密文板。

collectible_mode_start_listOptionalobject

凹開局時期望的獎勵，預設全為 false。僅在模式為 4 時有效。
hot_water：熱水壺獎勵，常用於觸發燒水機制（通用）。
shield：護盾獎勵，約等於額外生命值（通用）。
ingot：源石錠獎勵（通用）。
hope：希望獎勵（通用，請注意：JieGarden 主題下無此獎勵）。
random：隨機獎勵選項，指遊戲中的 "消耗所有源石錠換一個隨機收藏品"（通用）。
key：鑰匙獎勵，僅在 Mizuki 主題時有效。
dice：骰子獎勵，僅在 Mizuki 主題時有效。
ideas：2 構想獎勵，僅在 Sarkaz 主題時有效。
ticket：票券獎勵，僅在 JieGarden 主題時有效。

use_foldartalOptionalboolean

是否使用密文板。僅適用於 Sami 主題。模式 5 預設為 false，其餘模式為 true。

check_collapsal_paradigmsOptionalboolean

是否偵測獲得的坍縮範式。模式 5 預設為 true，其餘模式為 false。

double_check_collapsal_paradigmsOptionalboolean

true

是否執行坍縮範式偵測的防漏措施。僅在 Sami 主題且 check_collapsal_paradigms 為 true 時才適用。模式 5 下預設值 true，其他模式下預設值 false。

expected_collapsal_paradigmsOptionalarray<string>

['目空一些', '睁眼瞎', '图像损坏', '一抹黑']

希望觸發的坍縮範式。僅在主題為 Sami 且模式為 5 時有效。

monthly_squad_auto_iterateOptionalboolean

是否啟用月度小隊自動切換。

monthly_squad_check_commsOptionalboolean

是否將月度小隊通訊狀態作為切換依據。

deep_exploration_auto_iterateOptionalboolean

是否啟用深入調查自動切換。

collectible_mode_shoppingOptionalboolean

false

「燒水」時是否啟用購物。

collectible_mode_squadOptionalstring

燒水時使用的分隊。預設與 squad 同步；若 squad 為空且未指定 collectible_mode_squad 時，則預設為「指揮分隊」。

start_with_seedOptionalstring

使用種子刷錢時填入固定種子，留空則不啟用。
僅在 Sarkaz 主題中的 Investment 模式，且為「點刺成錠分隊」或「後勤分隊」時生效。

blackflow_strategyOptionalstring

黑流樹海主題的策略；留空時按 mode 與 investment_enabled 推斷。
baby_animal - 第一層檢查普通商店，第二、三層探索並進入秘境行商培育種子，需配合 blackflow_cultivation_target
investment - 第一層以戰鬥次數最少、預計時間最短的完整路線抵達固定普通商店
burn_with_investment - 第一層完成投資後盡快抵達第三層，到達即重開
burn - 盡快抵達第三層，到達即重開

blackflow_cultivation_targetOptionalstring

swaddled_cat

刷襁褓動物模式的目標。可選值：swaddled_cat | swaddled_feathered_serpent | swaddled_dog | swaddled_cerberus；僅在 blackflow_strategy 為 baby_animal 時使用。

find_playTime_targetOptionalnumber

刷常樂節點模式的目標常樂節點。1 - 令（擲地有聲）；2 - 黍（種因得果）；3 - 年（三缺一）。僅在主題為 JieGarden 且模式為 20001 時使用，該模式下必填；不填或其他值會導致任務參數設定失敗。

Example

{
   "enable": true,
   "theme": "Sami",
   "mode": 5,
   "squad": "指挥分队",
   "roles": "稳扎稳打",
   "core_char_list": [
      { "name": "维什戴尔", "use_support": true },
      { "name": "古米", "use_support": false },
      { "name": "史都华德", "use_support": false }
   ],
   "use_nonfriend_support": false,
   "starts_count": 3,
   "difficulty": 8,
   "stop_at_final_boss": false,
   "stop_at_max_level": false,
   "investment_enabled": true,
   "investments_count": 2,
   "stop_when_investment_full": false,
   "investment_with_more_score": false,
   "start_with_elite_two": false,
   "only_start_with_elite_two": false,
   "refresh_trader_with_dice": false,
   "first_floor_foldartal": "",
   "start_foldartal_list": [],
   "collectible_mode_start_list": {
      "hot_water": true,
      "shield": false,
      "ingot": false,
      "hope": true,
      "random": false,
      "key": false,
      "dice": false,
      "ideas": false
   },
   "use_foldartal": true,
   "check_collapsal_paradigms": true,
   "double_check_collapsal_paradigms": true,
   "expected_collapsal_paradigms": ["目空一些", "睁眼瞎"],
   "monthly_squad_auto_iterate": false,
   "monthly_squad_check_comms": false,
   "deep_exploration_auto_iterate": false,
   "collectible_mode_shopping": false,
   "collectible_mode_squad": "",
   "start_with_seed": ""
}

刷坍縮範式功能，具體請參閱 肉鴿輔助協定

• Copilot
  自動抄作業

enableOptionalboolean

true

是否啟用本任務。

filenamestring

單一作業 json 檔案路徑。與 copilot_list 二選一（必填），支援相對路徑與絕對路徑。

copilot_listarray`<object>

作業列表。與 filename 二選一（必填）。若兩者同時存在，將忽略 copilot_list。此參數起作用時，僅可執行 set_params 一次。
每個物件包含：

• filename：作業 json 檔案路徑（相對或絕對路徑均可）。
  
• nav_name_override：導航用關卡名稱，可選；未提供或為 null 時會自動從作業檔案推導
  
• is_raid：是否切換為突襲模式，選填，預設為 false。

loop_timesOptionalnumber

1

循環次數。僅在指定 filename 的單一作業模式下有效；此參數起作用時，僅可執行 set_params 一次。

use_sanity_potionOptionalboolean

false

是否允許在理智不足時自動使用理智藥。

formationOptionalboolean

false

是否執行自動編隊。

formation_indexOptionalnumber

0

自動編隊所使用的編隊欄位編號。僅在 formation 為 true 時才有效。
範圍為 0–4 的整數，其中 0 表示選擇目前編隊，1-4 分別代表第一、二、三、四編隊。

user_additionalOptionalarray`<object>

[]

自訂追加幹員清單。僅在 formation 為 true 時有效。
每個物件包含：

• name：幹員名稱，選填，預設為空字串，若留空則忽略此幹員。
  
• skill：指定攜帶技能，選填，預設為 0，即遵從遊戲內的預設技能選擇。範圍為 1–3 的整數，若超出範圍也遵照遊戲內的預設技能。

add_trustOptionalboolean

false

是否在自動編隊時，以信賴值升序自動填充剩餘空位。僅在 formation 為 true 時有效。

ignore_requirementsOptionalboolean

false

是否在自動編隊時忽略幹員屬性要求。僅在 formation 為 true 時有效。

support_unit_usageOptionalnumber

0

助戰幹員使用模式。範圍為 0–3 的整數，僅在 formation 為 true 時有效。
0：不使用助戰幹員。
1：若恰好缺少一名幹員，則嘗試尋找助戰幹員補齊；若無缺失則不使用助戰幹員。
2：若恰好缺少一名幹員，則嘗試尋找助戰幹員補齊；若無缺失則使用指定助戰幹員。
3：若恰好缺少一名幹員，則嘗試尋找助戰幹員補齊；若無缺失則使用隨機助戰幹員。

support_unit_nameOptionalstring

指定助戰幹員名稱。僅在 support_unit_usage 為 2 時有效。

作業 json 請參閱 戰鬥流程協定

Example

{
   "enable": true,
   "filename": "copilot/1-7.json",
   "loop_times": 2,
   "use_sanity_potion": false,
   "formation": true,
   "formation_index": 1,
   "user_additional": [
      {
         "name": "能天使",
         "skill": 3
      }
   ],
   "add_trust": true,
   "ignore_requirements": false,
   "support_unit_usage": 2,
   "support_unit_name": "艾雅法拉"
}

• SSSCopilot
  自動抄保全派駐作業

enableOptionalboolean

true

是否啟用本任務。

filenameRequiredstring

單一作業 json 檔案路徑。支援絕對或相對路徑。不支援在執行中更改設定。

loop_timesOptionalnumber

循環執行次數。

保全派駐作業 json 請參考 保全派駐協定

Example

{
   "enable": true,
   "filename": "sss/plan.json",
   "loop_times": 1
}

• ParadoxCopilot 自動抄悖論模擬作業

enableOptionalboolean

true

是否啟用本任務。

filenameRequiredstring

單一作業 json 檔案路徑。支援絕對或相對路徑。不支援在執行中更改設定。與 list 二選一（必填）。

listRequiredarray`<object>` | array`<string>

作業列表。不支援在執行中更改設定。與 filename 二選一（必填）。
陣列元素支援兩種形式：物件形式包含 id（作業標識，會原樣透傳至 CopilotListLoadTaskFileSuccess 回呼）與 filename（作業 json 檔案路徑，支援絕對或相對路徑）；也可直接使用作業路徑字串。

Example

{
   "enable": true,
   "filename": "paradox/exusiai.json",
   "list": []
}

• Depot
  倉庫辨識

enableOptionalboolean

true

是否啟用本任務。

Example

{
   "enable": true
}

• OperBox
  幹員 box 辨識

enableOptionalboolean

true

是否啟用本任務。

Example

{
   "enable": true
}

• Reclamation
  生息演算

enableOptionalboolean

true

是否啟用本任務。

themeOptionalstring

Tales

主題。
Fire - 沙中之火（已關閉）
Tales - 沙洲遺聞
RelaunchAnchor - 重啟錨點

modeOptionalnumber

0

模式。不同主題支援的模式不同：
Tales（沙洲遺聞）：
0 - 無存檔，透過進出關卡刷生息點數。
1 - 有存檔，透過組裝支援道具刷生息點數。
RelaunchAnchor（重啟錨點）：
16 (RA1) - RA-1，自動執行精耕細作、建設、交付資源、結算循環。
32 (RA15) - RA-15，用聖聆初雪完成 60 殺任務。
48 (RA4) - RA-4，使用籌劃經營策略給予的赤金解鎖區域，使用維什戴爾完成擊殺 boss 任務。

tools_to_craftOptionalarray<string>

[]

自動製造的物品清單。建議填寫名稱關鍵字即可，留空則不製造。僅 Tales 主題的有存檔模式（mode = 1）有效。

clear_storeOptionalboolean

false

任務完成後是否購買（清空）商店商品。僅 Tales 主題的無存檔模式（mode = 0）有效。

increment_modeOptionalnumber

0

點擊類型。僅 Tales 主題有效。
0：連點
1：長按

num_craft_batchesOptionalnumber

16

單次製造輪數上限。僅 Tales 主題有效。

Example

{
   "enable": true,
   "theme": "Fire",
   "mode": 1,
   "tools_to_craft": ["荧光棒", "发电机"],
   "increment_mode": 0,
   "num_craft_batches": 12
}

• Custom
  自訂任務

enableOptionalboolean

true

是否啟用本任務。

task_namesRequiredarray<string>

執行清單中第一個符合的任務名稱（及其後續的 next 任務等）。若想執行多個任務，可多次 append Custom task。 支援秘密前線（MiniGame@SecretFront）拼接形式：MiniGame@SecretFront@Begin@Ending[A-E](@事件名)?，事件名可選（支援作戰平台 / 遊俠 / 詭影迷蹤），例如 MiniGame@SecretFront@Begin@EndingA@支援作戰平台。

paramsOptionalobject

任務附加參數。目前像素畫任務（MiniGame@PixelPaint@Begin）與自動提升潛能任務（MiniGame@AutoRaisePotential@Begin）使用：

• params.pixel_paint.groups：按色分組點列。color 為色板序號（0~39，與遊戲右側色板順序一致），points 為 [x, y] 格子座標陣列（0~23，左上為原點）。
• params.pixel_paint.swipe（bool，可選，預設 true）：同色同行的連續格用拖動一次畫完，更快但部分觸控模式可能異常。
• params.pixel_paint.grid_delay（int，可選，預設 0）：每格額外等待（ms）。點擊後 sleep，拖動時長按格累加。各觸控方式內建基礎間隔，一般無需調整。相容舊鍵 grid_click_delay。
• params.auto_raise_potential.use_normal_token（bool，可選，預設 false）：中堅信物不足時確認彈窗預設點 × 放棄提升；設為 true 時改點 √，消耗普通信物繼續提升。

Example

{
   "enable": true,
   "task_names": ["StartUp", "Infrast", "Fight"]
}

{
   "enable": true,
   "task_names": ["MiniGame@PixelPaint@Begin"],
   "params": {
      "pixel_paint": {
         "groups": [
            { "color": 7, "points": [[0, 1], [3, 4]] }
         ]
      }
   }
}

• SingleStep
  單步任務（目前僅支援戰鬥）

enableOptionalboolean

true

是否啟用本任務。

typeRequiredstring

copilot

任務類型。目前僅支援 "copilot"。

subtypeRequiredstring

子任務類型。
stage：設定關卡名稱，格式為 "details": { "stage_name": "xxxx" }。
start：開始作戰，無需設定 details。
action：單步作戰操作，details 須為作戰協議中的單一動作（action），例如："details": { "name": "史尔特尔", "location": [ 4, 5 ], "direction": "左" }，詳情請參閱 戰鬥流程協定。

detailsOptionalobject

子任務的詳細參數。

Example

{
   "enable": true,
   "type": "copilot",
   "subtype": "stage",
   "details": {
      "stage_name": "1-7"
   }
}

• VideoRecognition
  影片辨識（目前僅支援作業 / 作戰影片）

enableOptionalboolean

true

是否啟用本任務。

filenameRequiredstring

影片檔案路徑。支援絕對或相對路徑。不支援在執行中更改設定。

Example

{
   "enable": true,
   "filename": "videos/copilot.mp4"
}

AsstSetTaskParams

介面原型

AsstBool ASSTAPI AsstSetTaskParams(AsstHandle handle, AsstTaskId id, const char* params);

介面說明

設定任務參數。

回傳值

• AsstBool
  回傳是否設定成功。

參數說明

handleRequiredAsstHandle

實例控制代碼（Handle）。

idRequiredAsstTaskId

任務 ID，為 AsstAppendTask 介面的回傳值。

paramsRequiredconst char\*

任務參數，json 字串，格式與 AsstAppendTask 介面相同。 未標註「不支援在執行中更改設定」的欄位皆支援即時修改；若該欄位不支援且目前任務正在執行，將忽略該欄位的變更。

AsstSetStaticOption

介面原型

AsstBool ASSTAPI AsstSetStaticOption(AsstStaticOptionKey key, const char* value);

介面說明

設定行程級（Process-level）全域參數。

回傳值

• AsstBool
  回傳是否設定成功。

參數說明

keyRequiredAsstStaticOptionKey

鍵（Key）。

valueRequiredconst char\*

值（Value）。

鍵值一覽

InvalidOptionalnumber

0

無效佔位。列舉值：0。

CpuOCROptionalboolean

使用 CPU 進行 OCR。值不參與解析。資源載入後不支援切換。列舉值：1。

GpuOCROptionalstring

使用 GPU 進行 OCR。值為 GPU 裝置序號（整數），Windows 上也可傳 luid:<十六進制 LUID>。資源載入後不支援切換。列舉值：2。

AsstSetInstanceOption

介面原型

AsstBool ASSTAPI AsstSetInstanceOption(AsstHandle handle, AsstInstanceOptionKey key, const char* value);

介面說明

設定實例級（Instance-level）參數。

回傳值

• AsstBool
  回傳是否設定成功。

參數說明

handleRequiredAsstHandle

實例控制代碼（Handle）。

keyRequiredAsstInstanceOptionKey

鍵（Key）。

valueRequiredconst char\*

值（Value）。

鍵值一覽

InvalidOptionalnumber

0

無效佔位。列舉值：0。

MinitouchEnabledOptionalboolean

已棄用。原為是否啟用 Minitouch；"1" 開，"0" 關。請注意設備可能不支援。列舉值：1（已棄用）。

TouchModeOptionalstring

minitouch

觸控模式設定。可選值：minitouch | maatouch | adb | MacPlayTools | MaaFwAdb | MumuExtras。預設為 minitouch。列舉值：2。

DeploymentWithPauseOptionalboolean

是否暫停下幹員，同時影響抄作業、肉鴿、保全派駐。可用值："1" 或 "0"。列舉值：3。

AdbLiteEnabledOptionalboolean

是否使用 AdbLite。可用值："0" 或 "1"。列舉值：4。

KillAdbOnExitOptionalboolean

退出時是否結束 ADB。可用值："0" 或 "1"。列舉值：5。

ClientTypeOptionalstring

客戶端類型（遊戲渠道）。大多數連線設定不需要設定。僅當傳給 AsstConnect / AsstAsyncConnect 的 config 在連線階段命令中使用 [PackageName] 時，才需要在連線前呼叫 AsstSetInstanceOption(..., ClientType, ...)。目前內建設定中僅 Androws 與 WSA 的 displayId 查詢依賴該值。此選項不取代 StartUp / CloseDown 等任務參數中的 client_type。列舉值：6。

編輯此頁