mirror of https://github.com/MaaAssistantArknights/MaaAssistantArknights.git synced 2026-07-16 01:40:46 +08:00

Files

Constrat ba631144af fix: perhaps vue fix (#17296 )

* fix: perhaps fix?

* fix: typo

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* fix: forgor

---------

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

2026-07-08 13:19:24 +08:00

36 KiB

Raw Permalink 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
实例句柄
:::
::: 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服：张三，可输入 张三、张、三

繁中服：账号为 Email，如 ab****01@gmail.com，建议填不含星号的明文片段，如 01@gmail
:::
::::

Example

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

CloseDown
关闭游戏

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。
当期 SS 活动后三关。可访问 API 获取支持的关卡列表。需额外加载 tasks.json 文件中的活动关卡导航。
复刻的 SS 活动。输入 SSReopen-<关卡前缀> ，可一次性刷完 XX-1 ~ XX-9 关，如 SSReopen-IC。 :::
::: field name="medicine" type="number" optional default="0"
最大使用理智药数量。
:::
::: field name="medicine_expire_days" type="number" optional default="0"
使用过期时间在指定天数内的理智药，0 表示不使用过期理智药。
:::
::: field name="expiring_medicine" type="number" optional default="0" deprecated
已弃用，自 v6.8.0 起请使用 medicine_expire_days 代替。
:::
::: 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,
   "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
公开招募

:::: 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 - 如果可能, 同时选择更多的高星 Tag 组合, 即使可能冲突
:::
::: 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"
已废弃，仅用于兼容旧参数。

当未提供 preserve_tags 且该值为 true 时，会在识别到 支援机械 时跳过；元素 不再视为旧版 1 星词条。
::: ::: field name="preserve_tags" type="array" optional
需要保留并跳过当前公招槽位的 Tag 名称列表。默认为空。

当识别到任一指定 Tag 时，MAA 会保留该槽位并跳过本次招募。
:::
::: 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,
   "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
基建换班

:::: 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 主题下无 hope 奖励）。
random: 随机奖励选项：游戏中指“消耗所有源石锭换一个随机收藏品”（通用）。
key: 钥匙奖励，仅在 Mizuki 主题时有效。
dice: 骰子奖励，仅在 Mizuki 主题时有效。
ideas: 2 构想奖励，仅在 Sarkaz 主题时有效。
ticket: 票券奖励，仅在 JieGarden 主题时有效。 :::
::: field name="use_foldartal" type="boolean" optional
是否使用密文板。模式 5 下默认值 false，其他模式下默认值 true。仅适用于 Sami 主题。
:::
::: 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 模式，“点刺成锭分队” or “后勤分队” 时可能为 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<object>"
作业列表，与 filename 二选一（必填）；当 filename 与 copilot_list 同时存在时，忽视 copilot_list；此参数生效时仅可执行 set_params 一次。
每个对象包含：

filename: 作业 JSON 文件的路径；相对路径与绝对路径均可
stage_name: 关卡名，具体请参考 PRTS.Map
is_raid: 是否切换为突袭模式，可选，默认值 false :::
::: field name="loop_times" type="number" optional default="1"
循环次数。仅在单一作业模式下（即指定 filename 时）有效；此参数生效时仅可执行 set_params 一次。
:::
::: field name="use_sanity_potion" type="boolean" optional default="false"
是否允许在剩余理智不足时使用理智药。
:::
::: field name="formation" type="boolean" optional default="false"
是否进行自动编队。
:::
::: field name="formation_index" type="number" optional default="0"
自动编队所使用的编队栏位的编号。仅在 formation 为 true 时有效。
为 0–4 的整数，其中 0 表示选择当前编队，1-4 分别表示第一、二、三、四编队。
:::
::: field name="user_additional" type="array<object>" optional default="[]"
自定义追加干员列表。仅在 formation 为 true 时有效。
每个对象包含：
name: 干员名，可选，默认值 ""，若留空则忽视此干员
skill: 需要携带的技能，可选，默认值 1；为 1–3 的整数，若不在此范围内则遵从游戏内默认的技能选择
:::
::: field name="add_trust" type="boolean" optional default="false"
是否在自动编队时以信赖值升序自动填充空余栏位。仅在 formation 为 true 时有效。
:::
::: field name="ignore_requirements" type="boolean" optional default="false"
是否在自动编队时忽视干员属性要求。仅在 formation 为 true 时有效。
:::
::: field name="support_unit_usage" type="number" optional default="0"
助战干员的使用模式。为 0–3 的整数。仅在 formation 为 true 时有效。
0 - 表示不使用助战干员
1 - 如果有且仅有一名缺失干员则尝试寻找助战干员补齐编队，如果无缺失干员则不使用助战干员
2 - 如果有且仅有一名缺失干员则尝试寻找助战干员补齐编队，如果无缺失干员则使用指定助战干员

3 - 如果有且仅有一名缺失干员则尝试寻找助战干员补齐编队，如果无缺失干员则使用随机助战干员
:::
::: field name="support_unit_name" type="string" optional default=""
指定助战干员名。仅在 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
自动抄保全作业

:::: field-group
::: field name="enable" type="boolean" optional default="true"
是否启用本任务。
:::
::: field name="filename" type="string" required
作业 JSON 的文件路径，绝对、相对路径均可。不支持运行期设置。
:::
::: field name="loop_times" type="number" optional
循环执行次数。
:::
::::
保全作业 JSON 请参考保全派驻协议

Example

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

ParadoxCopilot 自动抄悖论模拟作业

:::: field-group
::: field name="enable" type="boolean" optional default="true"
是否启用本任务。
:::
::: field name="filename" type="string" required
单个作业 JSON 的文件路径，绝对、相对路径均可。不支持运行期设置。必选，与 list 二选一。
:::
::: field name="list" type="array" required
作业 JSON 列表，绝对、相对路径均可。不支持运行期设置。必选，与 filename 二选一。
:::
::::

Example

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

Depot
仓库识别

:::: field-group
::: field name="enable" type="boolean" optional default="true"
是否启用本任务。
:::
::::

Example

{
   "enable": true
}

OperBox
干员 box 识别

:::: field-group
::: field name="enable" type="boolean" optional default="true"
是否启用本任务。
:::
::::

Example

{
   "enable": true
}

Reclamation
生息演算

:::: field-group
::: field name="enable" type="boolean" optional default="true"
是否启用本任务。
:::
::: field name="theme" type="string" optional default="Tales"
主题。
Fire - 沙中之火（已关闭）
Tales - 沙洲遗闻
RelaunchAnchor - 重启锚点
:::
::: field name="mode" type="number" optional default="0"
模式。不同主题支持的模式不同：
Tales（沙洲遗闻）：
0 - 无存档，通过进出关卡刷生息点数。
1 - 有存档，通过组装支援道具刷生息点数。
RelaunchAnchor（重启锚点）：
16 (RA1) - RA-1，自动执行精耕细作、建设、交付资源、结算循环。
32 (RA15) - RA-15，用圣聆初雪完成 60 杀任务。
48 (RA4) - RA-4，使用筹划经营策略给予的赤金解锁区域，使用维什戴尔完成击杀 boss 任务。 :::
::: field name="tools_to_craft" type="array" optional default="["荧光棒"]"
自动制造的物品，建议填写子串。仅 Tales 主题有效。
:::
::: field name="increment_mode" type="number" optional default="0"
点击类型。仅 Tales 主题有效。
0 - 连点
1 - 长按
:::
::: field name="num_craft_batches" type="number" optional default="16"
单次最大制造轮数。仅 Tales 主题有效。
:::
::::

Example

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

Custom
自定义任务

:::: field-group
::: field name="enable" type="boolean" optional default="true"
是否启用本任务。
:::
::: field name="task_names" type="array" required
执行数组中第一个匹配上的任务（及后续 next 等）。若想执行多个任务，可多次 append Custom task。
:::
::::

Example

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

SingleStep
单步任务（目前仅支持战斗）

:::: field-group
::: field name="enable" type="boolean" optional default="true"
是否启用本任务。
:::
::: field name="type" type="string" required default="copilot"
目前仅支持 "copilot"。
:::
::: field name="subtask" type="string" required
子任务类型。
stage - 设置关卡名，需要 "details": { "stage": "xxxx" }。
start - 开始作战，无 details。
action - 单步作战操作，details 需为作战协议中的单个 action，例如："details": { "name": "史尔特尔", "location": [ 4, 5 ], "direction": "左" }，详情参考战斗流程协议。
:::
::: field name="details" type="object" optional
子任务的详细参数。
:::
::::

Example

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

VideoRecognition
视频识别，目前仅支持作业（作战）视频

:::: field-group
::: field name="enable" type="boolean" optional default="true"
是否启用本任务。
:::
::: field name="filename" type="string" required
视频的文件路径，绝对、相对路径均可。不支持运行期设置。
:::
::::

Example

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

`AsstSetTaskParams`

接口原型

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

接口说明

设置任务参数

返回值

bool
返回是否设置成功

参数说明

:::: field-group
::: field name="handle" type="AsstHandle" required
实例句柄
:::
::: field name="task" type="AsstTaskId" required
任务 ID, AsstAppendTask 接口的返回值
:::
::: field name="params" type="const char*" required
任务参数，json string，与 AsstAppendTask 接口相同。
未标注“不支持运行中设置”的字段都支持实时修改；否则若当前任务正在运行，会忽略对应的字段
:::
::::

`AsstSetStaticOption`

接口原型

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

接口说明

设置进程级参数

返回值

bool
返回是否设置成功

参数说明

:::: field-group
::: field name="key" type="AsstStaticOptionKey" required
键
:::
::: field name="value" type="const char*" required
值
:::
::::

键值一览

暂无

`AsstSetInstanceOption`

接口原型

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

接口说明

设置实例级参数

返回值

bool
返回是否设置成功

参数说明

:::: field-group
::: field name="handle" type="AsstHandle" required
实例句柄
:::
::: field name="key" type="AsstInstanceOptionKey" required
键
:::
::: field name="value" type="const char*" required
值
:::
::::

键值一览

:::: field-group
::: field name="Invalid" type="number" optional default="0"
无效占位。枚举值：0。
:::
::: field name="MinitouchEnabled" type="boolean" optional
已弃用。原为是否启用 Minitouch；"1" 开，"0" 关。注意设备可能不支持。枚举值：1（已弃用）。
:::
::: field name="TouchMode" type="string" optional default="minitouch"
触控模式设置。可选值：minitouch | maatouch | adb | MaaFwAdb。默认 minitouch。枚举值：2。
:::
::: field name="DeploymentWithPause" type="boolean" optional
是否暂停下干员，同时影响抄作业、肉鸽、保全。可用值："1" 或 "0"。枚举值：3。
:::
::: field name="AdbLiteEnabled" type="boolean" optional
是否使用 AdbLite。可用值："0" 或 "1"。枚举值：4。
:::
::: field name="KillAdbOnExit" type="boolean" optional
退出时是否杀掉 Adb 进程。可用值："0" 或 "1"。枚举值：5。
:::
::: field name="ClientType" type="string" optional
客户端类型（游戏渠道）。大多数连接配置不需要设置。仅当传给 AsstConnect / AsstAsyncConnect 的 config 在连接阶段命令里使用 [PackageName] 时，才需要在连接前调用 AsstSetInstanceOption(..., ClientType, ...)。当前内置配置仅 Androws 和 WSA 的 displayId 查询依赖该值。该选项不替代 StartUp / CloseDown 等任务参数里的 client_type。枚举值：6。
:::
::::

36 KiB Raw Permalink Blame History Unescape Escape

集成文档

接口介绍

AsstAppendTask

接口原型

接口说明

返回值

参数说明

任务类型一览

AsstSetTaskParams

接口原型

接口说明

返回值

参数说明

AsstSetStaticOption

接口原型

接口说明

返回值

参数说明

键值一览

AsstSetInstanceOption

接口原型

接口说明

返回值

参数说明

键值一览

36 KiB

Raw Permalink Blame History

`AsstAppendTask`

`AsstSetTaskParams`

`AsstSetStaticOption`

`AsstSetInstanceOption`