fz-mirrors/MaaAssistantArknights
0
0
Fork 0
mirror of https://github.com/MaaAssistantArknights/MaaAssistantArknights.git synced 2026-07-16 01:40:46 +08:00
Code Issues Packages Projects Releases Wiki Activity
Files
87faaf2cfd7e9f6edbc3bfb38ca6534b83937b21
MaaAssistantArknights/docs/zh-tw/protocol/integration.md

36 KiB
Raw Blame History

order, icon
order icon
1 bxs:book

整合文件

介面介紹

AsstAppendTask

介面原型

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

介面說明

新增任務。

回傳值

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

參數說明

:::: field-group
::: field name="handle" type="AsstHandle" required
執行個體控制代碼 (Handle)
:::
::: field name="type" type="const char*" required
任務類型
:::
::: field name="params" type="const char*" required
任務參數，json String
:::
::::

任務類型一覽
  • StartUp
    開始喚醒

:::: field-group
::: field name="enable" type="boolean" optional default="true"
是否啟用本任務。
:::
::: field name="client_type" type="string" required
用戶端版本。

選項：Official | Bilibili | txwy | YoStarEN | YoStarJP | YoStarKR
:::
::: field name="start_game_enabled" type="boolean" optional default="false"
是否自動啟動用戶端。
:::
::: field name="account_name" type="string" optional
切換帳號，預設不切換。

僅支援切換至已登入的帳號。依據登入名稱進行搜尋，請確保輸入內容在所有帳號中具有唯一性。

官服：123****4567，可輸入 123****4567、4567、123、3****4567

B 服：張三，可輸入 張三、張、三
:::
::::

Example 
{
   "enable": true,
   "client_type": "Official",
   "start_game_enabled": true,
   "account_name": "123****4567"
}
  • CloseDown
    關閉遊戲

:::: field-group
::: field name="enable" type="boolean" optional default="true"
是否啟用本任務。
:::
::: field name="client_type" type="string" required
用戶端版本，若留空則不執行。

選項：Official | Bilibili | txwy | YoStarEN | YoStarJP | YoStarKR
:::
::::

Example 
{
   "enable": true,
   "client_type": "Official"
}
  • Fight
    理智作戰

:::: field-group
::: field name="enable" type="boolean" optional default="true"
是否啟用本任務。
:::
::: field name="stage" type="string" optional
關卡名稱。預設為空，將辨識 目前/上次 關卡。不支援在執行中更改設定。
目前支援導航的關卡包含：

  • 全部主線關卡：可在關卡末尾新增 -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。 :::
    ::: field name="medicine" type="number" optional default="0"
    理智藥最大使用量。
    :::
    ::: field name="expiring_medicine" type="number" optional default="0"
    48 小時內過期理智藥最大使用量。
    :::
    ::: field name="stone" type="number" optional default="0"
    碎石最大數量。
    :::
    ::: field name="times" type="number" optional default="2147483647"
    戰鬥次數。
    :::
    ::: field name="series" type="number" optional
    連戰次數，-1 ~ 6。
    -1：停用自動切換連戰。
    0：自動切換為當前可用的最大連戰次數（若理智不足以進行 6 連戰，則選擇最低可用次數）。
    1 ~ 6：指定固定的連戰次數。
    :::
    ::: field name="drops" type="object" optional
    指定物品掉落數量，預設不指定。key 為 item_id，value 為數量。key 可參考 resource/item_index.json 檔案。

    例如：{ "30011": 10, "30062": 5 }

    上述所有條件（次數、掉落等）均為「或」的關係，任一條件達成即停止任務。
    :::
    ::: field name="report_to_penguin" type="boolean" optional default="false"
    是否回報企鵝物流
    :::
    ::: field name="penguin_id" type="string" optional
    企鵝物流回報 ID，預設為空。僅在 report_to_penguin 為 true 時有效。
    :::
    ::: field name="report_to_yituliu" type="boolean" optional default="false"
    是否回報一圖流。
    :::
    ::: field name="yituliu_id" type="string" optional
    一圖流回報 ID，預設為空。僅在 report_to_yituliu 為 true 時有效。
    :::
    ::: field name="server" type="string" optional default="CN"
    遊戲伺服器，會影響掉落物辨識及數據上傳。

    選項：CN | US | JP | KR
    :::
    ::: field name="client_type" type="string" optional
    用戶端版本，預設為空。用於遊戲崩潰後自動重啟並接續任務；若為空則不啟用自動重啟功能。
    選項：Official | Bilibili | txwy | YoStarEN | YoStarJP | YoStarKR
    :::
    ::: field name="DrGrandet" type="boolean" optional default="false"
    博朗台模式（節省理智碎石模式），僅在產生碎石需求時才起作用。
    在碎石確認介面等待，直到目前理智自動恢復 1 點後，再立刻執行碎石回復，以避免浪費自然恢復。
    :::
    ::::
Example 
{
   "enable": true,
   "stage": "1-7",
   "medicine": 1,
   "expiring_medicine": 0,
   "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
    公開招募

:::: field-group
::: field name="enable" type="boolean" optional default="true"
是否啟用本任務。
:::
::: field name="refresh" type="boolean" optional default="false"
是否刷新三星 Tags。
:::
::: field name="select" type="array" required
會被自動點選的 Tag 等級。
:::
::: field name="confirm" type="array" required
會被自動點選確認的 Tag 等級。若只想計算結果而不實際招募，請設定為空陣列。
:::
::: field name="first_tags" type="array" optional
首選 Tags，僅在 Tag 等級為 3 時有效，預設為空。
當 Tag 等級為 3 時，會盡可能多選擇此處設定的 Tags（若有出現），且為強制選擇，會忽略所有 "讓 3 星 Tag 不被選擇" 的設定。
:::
::: field name="extra_tags_mode" type="number" optional default="0"
選擇更多的 Tags。
0：預設行為。
1：選滿 3 個 Tags，即使可能產生衝突。
2：儘可能同時選擇更多高星標籤組合，即使可能產生衝突。
:::
::: field name="times" type="number" optional default="0"
招募總次數。若僅需公招計算，請設定為 0。
:::
::: field name="set_time" type="boolean" optional default="true"
是否設定招募時限。僅在 times 為 0 時才套用。
:::
::: field name="expedite" type="boolean" optional default="false"
是否使用加急許可。
:::
::: field name="expedite_times" type="number" optional
加急次數，僅在 expedite 為 true 時有效。預設無限次使用（直到 times 達到上限）。
:::
::: field name="skip_robot" type="boolean" optional default="true"
是否在辨識到小車 Tag 時跳過。
:::
::: field name="recruitment_time" type="object" optional
Tag 等級（大於等於 3）對應的期望招募時限（單位：分鐘）。預設皆為 540 分鐘（即 09:00:00）。
範例：{ "3": 540, "4": 540 }
:::
::: field name="report_to_penguin" type="boolean" optional default="false"
是否回報企鵝物流。
:::
::: field name="penguin_id" type="string" optional
企鵝物流回報 ID，預設為空。僅在 report_to_penguin 為 true 時有效。
:::
::: field name="report_to_yituliu" type="boolean" optional default="false"
是否回報一圖流數據。
:::
::: field name="yituliu_id" type="string" optional
一圖流回報 ID，預設為空。僅在 report_to_yituliu 為 true 時有效。
:::
::: field name="server" type="string" optional default="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,
   "skip_robot": true,
   "recruitment_time": {
      "3": 540,
      "4": 540
   },
   "report_to_penguin": false,
   "penguin_id": "123456",
   "report_to_yituliu": false,
   "yituliu_id": "123456",
   "server": "CN"
}
  • Infrast
    基建換班

:::: field-group
::: field name="enable" type="boolean" optional default="true"
是否啟用本任務。
:::
::: field name="mode" type="number" optional default="0"
換班工作模式。
0 - Default：預設換班模式，單設施最優解。
10000 - Custom：自定義換班模式，讀取使用者配置，可參閱 基建排班協定。
20000 - Rotation：一鍵輪換模式，會跳過控制中樞、發電站、宿舍以及辦公室；其餘設施不進行換班，但保留基本操作（如使用無人機、會客室邏輯）。
:::
::: field name="facility" type="array" required
要換班的設施（依序）。不支援在執行中更改設定。
設施名稱：Mfg | Trade | Power | Control | Reception | Office | Dorm | Processing | Training
:::
::: field name="drones" type="string" optional default="_NotUse"
無人機用途。當 mode = 10000 時，此欄位無效。
選項：_NotUse | Money | SyntheticJade | CombatRecord | PureGold | OriginStone | Chip
:::
::: field name="threshold" type="number" optional default="0.3"
工作心情門檻值，取值範圍 [0, 1.0]。
mode = 10000 時，此欄位僅針對 "autofill" 起作用。
mode = 20000 時，此欄位無效。
:::
::: field name="replenish" type="boolean" optional default="false"
貿易站「源石碎片」是否自動補貨。
:::
::: field name="dorm_notstationed_enabled" type="boolean" optional default="false"
是否啟用宿舍「未進駐」選項。
:::
::: field name="dorm_trust_enabled" type="boolean" optional default="false"
是否將宿舍剩餘位置填入信賴值未滿的幹員。
:::
::: field name="reception_message_board" type="boolean" optional default="true"
是否領取會客室資訊板信用點數。
:::
::: field name="reception_clue_exchange" type="boolean" optional default="true"
是否進行線索交流。
:::
::: field name="reception_send_clue" type="boolean" optional default="true"
是否贈送線索。
:::
::: field name="filename" type="string" required
自定義配置路徑。不支援在執行中更改設定。

:::
::: field name="plan_index" type="number" required
使用配置中的方案序號。不支援在執行中更改設定。

:::
::::

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 進行第二輪購買；若信用點數溢出，則會無視黑名單再次由左至右購買，直到信用點數不再溢出為止。

:::: field-group
::: field name="enable" type="boolean" optional default="true"
是否啟用本任務。
:::
::: field name="visit_friends" type="boolean" optional default="true"
是否訪問好友基建以獲得信用點數。
:::
::: field name="shopping" type="boolean" optional default="true"
是否執行購物流程。
:::
::: field name="buy_first" type="array" optional default="[]"
優先購買清單。填入商品名稱，例如 "招聘許可"、"龍門幣" 等。
:::
::: field name="blacklist" type="array" optional default="[]"
購物黑名單。填入商品名稱，例如 "加急許可"、"傢俱零件" 等。
:::
::: field name="force_shopping_if_credit_full" type="boolean" optional default="false"
當信用點數溢出時，是否無視黑名單強制購買。
:::
::: field name="only_buy_discount" type="boolean" optional default="false"
是否僅購買折扣商品，此設定僅對第二輪購買有效。
:::
::: field name="reserve_max_credit" type="boolean" optional default="false"
當信用點數低於 300 時是否停止購買，此設定僅對第二輪購買有效。
:::
::: field name="credit_fight" type="boolean" optional default="false"
是否借助戰打一次 OF-1 關卡，以便在隔日獲取更多信用點數。
:::
::: field name="formation_index" type="number" optional default="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
    領取各種獎勵

:::: field-group
::: field name="enable" type="boolean" optional default="true"
是否啟用本任務。
:::
::: field name="award" type="boolean" optional default="true"
領取 每日/每週任務獎勵。
:::
::: field name="mail" type="boolean" optional default="false"
領取所有郵件獎勵。
:::
::: field name="recruit" type="boolean" optional default="false"
領取「限時尋訪」每日贈送的免費單抽。
:::
::: field name="orundum" type="boolean" optional default="false"
領取「幸運牆」的合成玉獎勵。
:::
::: field name="mining" type="boolean" optional default="false"
領取「限時開採許可」的合成玉獎勵。
:::
::: field name="specialaccess" type="boolean" optional default="false"
領取五週年贈送的月卡獎勵。
:::
::::

Example 
{
   "enable": true,
   "award": true,
   "mail": true,
   "recruit": true,
   "orundum": false,
   "mining": true,
   "specialaccess": false
}
  • Roguelike
    無限刷肉鴿

:::: field-group
::: field name="enable" type="boolean" optional default="true"
是否啟用本任務。
:::
::: field name="theme" type="string" optional default="Phantom"
主題。
Phantom - 傀影與猩紅孤鑽
Mizuki - 水月與深藍之樹
Sami - 探索者的銀淞止境
Sarkaz - 薩卡茲的無終奇語
JieGarden - 歲的界園誌異
:::
::: field name="mode" type="number" optional default="0"
模式。
0 - 刷分 / 獎勵點數：盡可能穩定地打更多層數。
1 - 刷源石錠：第一層投資完後立即退出。
2 - 兼顧模式 0 與 1，投資後再退出；若無投資則繼續往後打。
3 - 開發中...
4 - 凹開局：先在難度 0 下到達第三層後重啟，再到指定難度下凹開局獎勵。若未獲得「熱水壺」或「希望」則回到難度 0 重新開始。在 Phantom 主題下則不切換難度，僅在目前難度下嘗試到達第三層、重開、凹開局。
5 - 刷坍縮範式：僅適用於 Sami 主題；透過戰鬥漏怪等方式加快累積坍縮值。若遇到的首個坍縮範式存在於 expected_collapsal_paradigms 清單中則停止任務，否則重啟。
6 - 刷月度小隊獎勵：除了模式適配外，其餘邏輯同模式 0。
7 - 刷深入調查獎勵：除了模式適配外，其餘邏輯同模式 0。
:::
::: field name="squad" type="string" optional default="指挥分队"
開局分隊名稱。
:::
::: field name="roles" type="string" optional default="取长补短"
開局職業組合。
:::
::: field name="core_char" type="string" optional
開局幹員名稱。僅支援單個幹員的中文名稱（不分遊戲伺服器）；若留空或設定為空字串 "" 則根據練度自動選擇。
:::
::: field name="use_support" type="boolean" optional default="false"
開局幹員是否使用助戰幹員。
:::
::: field name="use_nonfriend_support" type="boolean" optional default="false"
是否接受非好友助戰幹員。僅在 use_support 為 true 時有效。
:::
::: field name="starts_count" type="number" optional default="2147483647"
開始探索的次數上限。達到後自動停止任務。
:::
::: field name="difficulty" type="number" optional default="0"
指定難度等級。若未解鎖，則會選擇目前已解鎖的最高難度。
:::
::: field name="stop_at_final_boss" type="boolean" optional default="false"
是否在第 5 層「險路惡敵」節點前停止任務。僅適用於 Phantom 以外的主題。
:::
::: field name="stop_at_max_level" type="boolean" optional default="false"
是否在肉鴿等級刷滿後停止任務。
:::
::: field name="investment_enabled" type="boolean" optional default="true"
是否進行源石錠投資。
:::
::: field name="investments_count" type="number" optional default="2147483647"
投資源石錠的次數上限。達到後自動停止任務。
:::
::: field name="stop_when_investment_full" type="boolean" optional default="false"
是否在投資到達上限後停止任務。
:::
::: field name="investment_with_more_score" type="boolean" optional default="false"
是否在投資後嘗試購物。僅適用於模式 1。
:::
::: field name="start_with_elite_two" type="boolean" optional default="false"
是否在凹開局的同時凹幹員精二直升。僅適用於模式 4。
:::
::: field name="only_start_with_elite_two" type="boolean" optional default="false"
是否只凹精二直升而忽略其他開局條件。僅在模式為 4 且 start_with_elite_two 為 true 時有效。
:::
::: field name="refresh_trader_with_dice" type="boolean" optional default="false"
是否消耗骰子刷新商店以購買特殊商品。僅適用於 Mizuki 主題（用於刷指路鱗）。
:::
::: field name="first_floor_foldartal" type="string" optional
希望在第一層「遠見」階段獲得的密文板。僅適用於 Sami 主題（不限模式）；若成功凹到則停止任務。
:::
::: field name="start_foldartal_list" type="array" optional default="[]"
凹開局時希望在開局獎勵階段獲得的密文板清單。僅在主題為 Sami 且模式為 4 時有效。
開局獎勵階段，需擁有清單中所有的密文板才算凹開局成功。
請注意，此參數須與「生活至上分隊」同時使用，其他分隊在開局獎勵階段不會獲得密文板。
:::
::: field name="collectible_mode_start_list" type="object" optional
凹開局時期望的獎勵，預設全為 false。僅在模式為 4 時有效。
hot_water：熱水壺獎勵，常用於觸發燒水機制（通用）。
shield：護盾獎勵，約等於額外生命值（通用）。
ingot：源石錠獎勵（通用）。
hope：希望獎勵（通用，請注意：JieGarden 主題下無此獎勵）。
random：隨機獎勵選項，指遊戲中的 "消耗所有源石錠換一個隨機收藏品"（通用）。
key：鑰匙獎勵，僅在 Mizuki 主題時有效。
dice：骰子獎勵，僅在 Mizuki 主題時有效。
ideas：2 構想獎勵，僅在 Sarkaz 主題時有效。
ticket：票券獎勵，僅在 JieGarden 主題時有效。
:::
::: field name="use_foldartal" type="boolean" optional
是否使用密文板。僅適用於 Sami 主題。模式 5 預設為 false，其餘模式為 true。
:::
::: field name="check_collapsal_paradigms" type="boolean" optional
是否偵測獲得的坍縮範式。模式 5 預設為 true，其餘模式為 false。
:::
::: field name="double_check_collapsal_paradigms" type="boolean" optional default="true"
是否執行坍縮範式偵測的防漏措施。僅在 Sami 主題且 check_collapsal_paradigms 為 true 時才適用。模式 5 下預設值 true，其他模式下預設值 false。
:::
::: field name="expected_collapsal_paradigms" type="array" optional default="['目空一些', '睁眼瞎', '图像损坏', '一抹黑']"
希望觸發的坍縮範式。僅在主題為 Sami 且模式為 5 時有效。
:::
::: field name="monthly_squad_auto_iterate" type="boolean" optional
是否啟用月度小隊自動切換。
:::
::: field name="monthly_squad_check_comms" type="boolean" optional
是否將月度小隊通訊狀態作為切換依據。
:::
::: field name="deep_exploration_auto_iterate" type="boolean" optional
是否啟用深入調查自動切換。
:::
::: field name="collectible_mode_shopping" type="boolean" optional default="false"
「燒水」時是否啟用購物。
:::
::: field name="collectible_mode_squad" type="string" optional
燒水時使用的分隊。預設與 squad 同步；若 squad 為空且未指定 collectible_mode_squad 時，則預設為「指揮分隊」。
:::
::: field name="start_with_seed" type="boolean" optional default="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
    自動抄作業

:::: field-group
::: field name="enable" type="boolean" optional default="true"
是否啟用本任務。
:::
::: field name="filename" type="string"
單一作業 json 檔案路徑。與 copilot_list 二選一（必填），支援相對路徑與絕對路徑。
:::
::: field name="copilot_list" type="array

Reference in New Issue View Git Blame Copy Permalink