接口介绍

AsstAppendTask

接口原型

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

接口说明

添加任务

返回值

• AsstTaskId
  若添加成功，返回该任务 ID, 可用于后续设置任务参数；
  若添加失败，返回 0

参数说明

handleRequiredAsstHandle

实例句柄

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。
• 当期 SS 活动 后三关。可访问 API 获取支持的关卡列表。需额外加载 tasks.json 文件中的活动关卡导航。
• 复刻的 SS 活动。输入 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 - 如果可能, 同时选择更多的高星 Tag 组合, 即使可能冲突

timesOptionalnumber

0

招募多少次。若仅公招计算，可设置为 0。

set_timeOptionalboolean

true

是否设置招募时限。仅在 times 为 0 时生效。

expediteOptionalboolean

false

是否使用加急许可。

expedite_timesOptionalnumber

加急次数，仅在 expedite 为 true 时有效。当前版本已不生效，加急不受次数限制，直至 times 达到上限。

skip_robotOptionalboolean

true

已废弃，仅用于兼容旧参数。
当未提供 preserve_tags 且该值为 true 时，会在识别到 支援机械 时跳过；元素 不再视为旧版 1 星词条。

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 | Recycle | 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 主题。
30003 - 刷开局，先打准备局，再开目标局。准备局取得 blackflow_start_animals 要求的襁褓动物并进入第三层后放弃；目标局在选择支援页命中 blackflow_start_rewards 中任意一项时不做选择，退出到主题页并保留该局，任务结束。准备局使用 collectible_mode_squad，difficulty 不为 -1 时在 0 难度下进行；目标局使用 squad 与 difficulty，到选择支援页即结束；roles 与开局干员用于准备局，提供 collectible_mode_roles、collectible_mode_core_char_list 时准备局改用这两项。开启 blackflow_start_utopia 时目标局选取奖励后进入第一层，见该字段。仅适用于 BlackFlow 主题，需配合 blackflow_start_animals 与 blackflow_start_rewards。

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 主题下无 hope 奖励）。
random: 随机奖励选项：游戏中指“消耗所有源石锭换一个随机收藏品”（通用）。
key: 钥匙奖励，仅在 Mizuki 主题时有效。
dice: 骰子奖励，仅在 Mizuki 主题时有效。
ideas: 2 构想奖励，仅在 Sarkaz 主题时有效。
ticket: 票券奖励，仅在 JieGarden 主题时有效。

use_foldartalOptionalboolean

是否使用密文板。模式 5 下默认值 false，其他模式下默认值 true。仅适用于 Sami 主题。

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值时为指挥分队。
黑流树海模式 30003 中为准备局使用的分队。

start_with_seedOptionalstring

使用种子刷钱时填入固定种子，留空则不启用。
仅在 Sarkaz 主题，Investment 模式，“点刺成锭分队” or “后勤分队” 时生效。

blackflow_strategyOptionalstring

黑流树海主题的策略；留空时按 mode 与 investment_enabled 推断。
baby_animal - 第一层检查普通商店，第二、三层探索并进入秘境行商培育种子，需配合 blackflow_cultivation_target
investment - 第一层以战斗次数最少、预计时间最短的完整路线抵达固定普通商店
burn_with_investment - 第一层完成投资后尽快抵达第三层，到达即重开
burn - 尽快抵达第三层，到达即重开
ending1 - 以第一结局为目标推进刷等级
ending2 - 以第二结局为目标推进刷等级
ending3 - 以第三结局为目标推进刷等级
以上取值仅在刷等级模式（mode 0）下适用，对应结局是否开放以游戏内为准；指定结局后，开局照常招募干员。
模式 30003 不读取此项。有动物要求时，准备局按 baby_animal 的路线培育；没有动物要求时，准备局尽快抵达第三层，investment_enabled 为 true 时先在第一层投资。准备局的开局干员为机械师、collectible_mode_squad 为特勤分队或堡垒战术分队、准备局的职业组为稳扎稳打或坚不可摧时，视为满天赋机械师开局，自带结构性原理：准备局招到机械师后放弃其余开局招募，路线按需用结构性原理移动；没有动物要求时，第二层直接用它飞向出口。

blackflow_cultivation_targetOptionalstring

swaddled_cat

刷襁褓动物模式的目标。可选值：swaddled_cat | swaddled_feathered_serpent | swaddled_dog | swaddled_cerberus；仅在 blackflow_strategy 为 baby_animal 时使用。

blackflow_start_animalsOptionalarray<string>

模式 30003 准备局要培育的襁褓动物，0 至 2 项，可重复，羽蛇最多一项。可选值：swaddled_cat | swaddled_dog | swaddled_cerberus | swaddled_feathered_serpent。各项按数量同时满足，例如两项 swaddled_cat 要求至少两只猫，多出的其他动物不影响；培育结束仍未凑齐时放弃该局，重新进行准备局。为空数组时准备局只需进入第三层。模式 30003 下必填。

blackflow_start_rewardsOptionalnumber

模式 30003 目标局期望的开局奖励，位掩码，范围 0 至 4095。模式 30003 下必填。
1 未编号物；2 调查预付款；4 空间租赁；8 退行补偿；16 林间代步；32 巢寄生；64 襁褓天马；128 襁褓骏鹰；256 襁褓巨龙；512 襁褓九头蛇；1024 襁褓白泽；2048 襁褓金乌。后六项是羽蛇带来的蓝色奖励，只在 blackflow_start_animals 含羽蛇时生效，否则忽略。
目标局在选择支援页先认出页面上的全部奖励再判断：命中任意一项时完成；认出了奖励但没有期望的，放弃该局，重新进行准备局；一项都没认出，或要求了羽蛇奖励却读不出蓝色奖励时，停在选择支援页并停止任务，截图保存到 debug/roguelike。为 0 且未开启 blackflow_start_utopia 时，进入选择支援页即完成。进度通过 SubTaskExtraInfo 的 BlackFlowStartRun 回调，见 回调消息协议。

collectible_mode_rolesOptionalstring

模式 30003 准备局的职业组，不提供时准备局用 roles。

collectible_mode_core_char_listOptionalarray<object>

模式 30003 准备局的开局干员顺位，格式同 core_char_list，不提供时准备局用 core_char_list。

blackflow_start_utopiaOptionalboolean

false

模式 30003 目标局凹第一层实托邦。为 true 时，目标局在选择支援页命中 blackflow_start_rewards（为 0 时不要求）后，按 blackflow_start_reward_priority 选取奖励，带襁褓三头犬可选两次时再选一张；之后用 roles 与开局干员开局并进入第一层，第一层是实托邦时退出到主题页并保留该局，任务结束，否则放弃该局，重新进行准备局。实托邦按第一层层名的位置判断，难度 6 及以上才会出现，difficulty 由调用方选择。

blackflow_start_reward_priorityOptionalarray<string>

模式 30003 凹第一层实托邦时目标局选取奖励的先后顺序，blackflow_start_utopia 为 true 时必填，不可为空，不可重复。可选值：unnumbered_item 未编号物；survey_advance 调查预付款；space_lease 空间租赁；regression_compensation 退行补偿；forest_ride 林间代步；nest_parasitism 巢寄生；pegasus 襁褓天马；hippogriff 襁褓骏鹰；dragon 襁褓巨龙；hydra 襁褓九头蛇；bai_ze 襁褓白泽；golden_crow 襁褓金乌。不凹实托邦时，目标局命中后停在选择支援页保留该局，不选取奖励，不读取此项。凹实托邦时，目标局要进入第一层，必须在选择支援页选卡：命中 blackflow_start_rewards 后，选取优先级列表中排在最前且页面上存在的一张，带襁褓三头犬可选两次时再选一张。此时后六项羽蛇奖励照样参与排序，与 blackflow_start_animals 是否含羽蛇无关：准备局没有要求羽蛇也可能带上，目标局照样会出蓝色奖励。这和 blackflow_start_rewards 不同，那里的后六项是命中条件，只在要求了羽蛇时生效。列出的奖励都不在页面上时，按策略的默认顺序选一张普通奖励。

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 二选一（必填）；当 filename 与 copilot_list 同时存在时，忽视 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）与活动商店兑换任务（SS@Store@Begin）使用：

• params.pixel_paint.groups：按色分组点列。color 为色板序号（039，与游戏右侧色板顺序一致），points 为 [x, y] 格子坐标数组（023，左上为原点）。
• 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 时改点 √，消耗普通信物继续提升。
• params.event_shop.blacklist（string 数组，可选）：活动商店兑换任务（SS@Store@Begin）购买时的商品名黑名单。识别出的商品名包含任一条目即跳过该商品，滑动翻页继续购买其余商品；为空时不生效。

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

实例句柄

idRequiredAsstTaskId

任务 ID, AsstAppendTask 接口的返回值

paramsRequiredconst char\*

任务参数，json string，与 AsstAppendTask 接口相同。 未标注“不支持运行中设置”的字段都支持实时修改；否则若当前任务正在运行，会忽略对应的字段

AsstSetStaticOption

接口原型

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

接口说明

设置进程级参数

返回值

• AsstBool
  返回是否设置成功

参数说明

keyRequiredAsstStaticOptionKey

键

valueRequiredconst char\*

值

键值一览

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);

接口说明

设置实例级参数

返回值

• AsstBool
  返回是否设置成功

参数说明

handleRequiredAsstHandle

实例句柄

keyRequiredAsstInstanceOptionKey

键

valueRequiredconst char\*

值

键值一览

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。

编辑此页