整合文件
約 6812 字大約 23 分鐘
介面介紹
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 ~ 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 等級。若只想計算結果而不實際招募，請設定為空陣列。
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],
"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>
要換班的設施（依序）。不支援在執行中更改設定。
設施名稱：Mfg | Trade | Power | Control | Reception | Office | Dorm | Processing | Training
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
是否將宿舍剩餘位置填入信賴值未滿的幹員。
reception_message_boardOptionalboolean
true
是否領取會客室資訊板信用點數。
reception_clue_exchangeOptionalboolean
true
是否進行線索交流。
reception_send_clueOptionalboolean
true
是否贈送線索。
filenameRequiredstring
自定義配置路徑。不支援在執行中更改設定。
plan_indexRequirednumber
使用配置中的方案序號。不支援在執行中更改設定。
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
領取五週年贈送的月卡獎勵。
Example
{
"enable": true,
"award": true,
"mail": true,
"recruit": true,
"orundum": false,
"mining": true,
"specialaccess": false
}Roguelike
無限刷肉鴿
enableOptionalboolean
true
是否啟用本任務。
themeOptionalstring
Phantom
主題。 Phantom - 傀影與猩紅孤鑽 Mizuki - 水月與深藍之樹 Sami - 探索者的銀淞止境 Sarkaz - 薩卡茲的無終奇語 JieGarden - 歲的界園誌異
modeOptionalnumber
0
模式。 0 - 刷分 / 獎勵點數：盡可能穩定地打更多層數。 1 - 刷源石錠：第一層投資完後立即退出。 2 - 已棄用 兼顧模式 0 與 1，投資後再退出；若無投資則繼續往後打。 3 - 開發中... 4 - 凹開局：先在難度 0 下到達第三層後重啟，再到指定難度下凹開局獎勵。若未獲得「熱水壺」或「希望」則回到難度 0 重新開始。在 Phantom 主題下則不切換難度，僅在目前難度下嘗試到達第三層、重開、凹開局。 5 - 刷坍縮範式：僅適用於 Sami 主題；透過戰鬥漏怪等方式加快累積坍縮值。若遇到的首個坍縮範式存在於 expected_collapsal_paradigms 清單中則停止任務，否則重啟。 6 - 刷月度小隊獎勵：除了模式適配外，其餘邏輯同模式 0。 7 - 刷深入調查獎勵：除了模式適配外，其餘邏輯同模式 0。
squadOptionalstring
指挥分队
開局分隊名稱。
rolesOptionalstring
取长补短
開局職業組合。
core_charOptionalstring
開局幹員名稱。僅支援單個幹員的中文名稱（不分遊戲伺服器）；若留空或設定為空字串 "" 則根據練度自動選擇。
use_supportOptionalboolean
false
開局幹員是否使用助戰幹員。
use_nonfriend_supportOptionalboolean
false
是否接受非好友助戰幹員。僅在 use_support 為 true 時有效。
starts_countOptionalnumber
2147483647
開始探索的次數上限。達到後自動停止任務。
difficultyOptionalnumber
0
指定難度等級。若未解鎖，則會選擇目前已解鎖的最高難度。
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_seedOptionalboolean
false
是否使用種子刷錢。
僅在 Sarkaz 主題中的 Investment 模式，且為「點刺成錠分隊」或「後勤分隊」時才可能為 true。
使用固定種子。
Example
{
"enable": true,
"theme": "Sami",
"mode": 5,
"squad": "指挥分队",
"roles": "取长补短",
"core_char": "塑心",
"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": false
}刷坍縮範式功能，具體請參閱 肉鴿輔助協定
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：指定攜帶技能，選填，預設為 1。範圍為 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<string>
作業 json 列表。支援絕對或相對路徑。不支援在執行中更改設定。與 filename 二選一（必填）。
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 主題有效。
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）使用：
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。
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"。
subtaskRequiredstring
子任務類型。 stage：設定關卡名稱，格式為 "details": { "stage": "xxxx" }。 start：開始作戰，無需設定 details。 action：單步作戰操作，details 須為作戰協議中的單一動作（action），例如："details": { "name": "史尔特尔", "location": [ 4, 5 ], "direction": "左" }，詳情請參閱 戰鬥流程協定。
detailsOptionalobject
子任務的詳細參數。
Example
{
"enable": true,
"type": "copilot",
"subtask": "stage",
"details": {
"stage": "1-7"
}
}VideoRecognition
影片辨識（目前僅支援作業 / 作戰影片）
enableOptionalboolean
true
是否啟用本任務。
filenameRequiredstring
影片檔案路徑。支援絕對或相對路徑。不支援在執行中更改設定。
Example
{
"enable": true,
"filename": "videos/copilot.mp4"
}AsstSetTaskParams
介面原型
bool ASSTAPI AsstSetTaskParams(AsstHandle handle, AsstTaskId id, const char* params);介面說明
設定任務參數。
回傳值
bool
回傳是否設定成功。
參數說明
handleRequiredAsstHandle
實例控制代碼（Handle）。
taskRequiredAsstTaskId
任務 ID，為 AsstAppendTask 介面的回傳值。
paramsRequiredconst char\*
任務參數，json 字串，格式與 AsstAppendTask 介面相同。 未標註「不支援在執行中更改設定」的欄位皆支援即時修改；若該欄位不支援且目前任務正在執行，將忽略該欄位的變更。
AsstSetStaticOption
介面原型
bool ASSTAPI AsstSetStaticOption(AsstStaticOptionKey key, const char* value);介面說明
設定行程級（Process-level）全域參數。
回傳值
bool
回傳是否設定成功。
參數說明
keyRequiredAsstStaticOptionKey
鍵（Key）。
valueRequiredconst char\*
值（Value）。
鍵值一覽
暫無
AsstSetInstanceOption
介面原型
bool ASSTAPI AsstSetInstanceOption(AsstHandle handle, AsstInstanceOptionKey key, const char* value);介面說明
設定實例級（Instance-level）參數。
回傳值
bool
回傳是否設定成功。
參數說明
handleRequiredAsstHandle
實例控制代碼（Handle）。
keyRequiredAsstInstanceOptionKey
鍵（Key）。
valueRequiredconst char\*
值（Value）。
鍵值一覽
InvalidOptionalnumber
0
無效佔位。列舉值：0。
MinitouchEnabledOptionalboolean
已棄用。原為是否啟用 Minitouch；"1" 開，"0" 關。請注意設備可能不支援。列舉值：1（已棄用）。
TouchModeOptionalstring
minitouch
觸控模式設定。可選值：minitouch | maatouch | adb | MaaFwAdb。預設為 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。