fz-mirrors/MaaAssistantArknights
0
0
Fork 0
mirror of https://github.com/MaaAssistantArknights/MaaAssistantArknights.git synced 2026-07-20 10:57:45 +08:00
Code Issues Packages Projects Releases Wiki Activity

chore: Auto update by pre-commit hooks

Browse Source 
https://github.com/MaaAssistantArknights/MaaAssistantArknights/actions/runs/21118556393
[skip changelog]
This commit is contained in:
github-actions[bot]
2026-01-18 21:04:18 +00:00
parent 7fa51393f6
commit ecd4a33f8d
16 changed files with 357 additions and 314 deletions
Download Patch File Download Diff File Expand all files Collapse all files

2
docs/en-us/manual/introduction/combat.md
View File

@@ -71,6 +71,7 @@ Alternative stages are selected based on daily stage availability - MAA will cho
This functions like a schedule, not as a fallback if the primary stage selection fails.
Example: Alternative Stages are `CE-6/5`, `1-7` and `LS-6/5`:
- If `CE-6/5` is open today, MAA will run it and ignore the alternatives. If you haven't unlocked auto-deploy for CE-6/5, the task will fail.
- If `CE-6/5` is closed today, MAA will run `1-7` instead. If you haven't unlocked auto-deploy for 1-7, the task will fail.
- Since `1-7` is a permanent stage that appears before `LS-6/5` in the list, MAA will never run `LS-6/5` in this scenario.
@@ -89,6 +90,7 @@ MAA will use the specified battle multiplier setting:
- **Disabled mode** (-1):
- Doesn't change the in-game multiplier setting
- If sanity is insufficient for the current in-game multiplier setting, ends the task
### Perform Battles
MAA will run up to the specified number of battles.

244
docs/en-us/protocol/integration.md
View File

@@ -117,6 +117,7 @@ Whether to enable this task.
::: field name="stage" type="string" optional
Stage name, by default empty, recognizes current/last stage. Editing in run-time is not supported.
Currently supported stages for navigation include:
- All mainline stages. You can add `-NORMAL` or `-HARD` at the end of the stage to switch between standard or challenge mode.
- For LMD and Battle Record stages 5/6, must input `CE-6` / `LS-6`. MAA will automatically switch to stage 5 if stage 6 cannot be delegated.
- Skill Summary, Voucher, and Carbon stage 5, must input `CA-5` / `AP-5` / `SK-5`.
@@ -129,64 +130,64 @@ Currently supported stages for navigation include:
- OF-1 / OF-F3 / GT-5 in side stories.
- Last three stages of current SS events. Visit [API](https://api.maa.plus/MaaAssistantArknights/api/gui/StageActivity.json) for the list of supported stages. Requires additional loading of event stage navigation in [tasks.json](https://api.maa.plus/MaaAssistantArknights/api/resource/tasks.json) file.
- Rerun SS events. Input `SSReopen-<stage prefix>` to farm XX-1 ~ XX-9 stages at once, e.g. `SSReopen-IC`.
:::
::: field name="medicine" type="number" optional default="0"
Maximum number of Sanity Potions used.
:::
::: field name="expiring_medicine" type="number" optional default="0"
Maximum number of Sanity Potions expiring within 48 hours.
:::
::: field name="stone" type="number" optional default="0"
Maximum number of Originite Prime used.
:::
::: field name="times" type="number" optional default="2147483647"
Number of battles.
:::
::: field name="series" type="number" optional
Number of consecutive battles, -1~6.
<br>
`-1` to disable switching.
<br>
`0` to automatically switch to the current maximum available times, if current sanity is not enough for 6 times, select the minimum available times.
<br>
`1~6` to specify number of consecutive battles.
:::
::: field name="drops" type="object" optional
Specifying the number of drops, no specification by default. key is item_id, value is quantity. key can refer to `resource/item_index.json` file.
<br>
Example: `{ "30011": 10, "30062": 5 }`
<br>
All above are OR relations, i.e. task stops when any one is reached.
:::
::: field name="report_to_penguin" type="boolean" optional default="false"
Whether to upload data to Penguin Statistics.
:::
::: field name="penguin_id" type="string" optional
Penguin Statistics report id, empty by default. Only effective when `report_to_penguin` is true.
:::
:::
::: field name="report_to_yituliu" type="boolean" optional default="false"
Whether to report to YITULIU.
:::
::: field name="yituliu_id" type="string" optional
YITULIU report id, empty by default. Only effective when `report_to_yituliu` is true.
:::
::: field name="server" type="string" optional default="CN"
Server, will affect drop recognition and upload.
<br>
Options: `CN` | `US` | `JP` | `KR`
:::
::: field name="client_type" type="string" optional
Client version, empty by default. Used to restart and reconnect after game crash, does not enable this feature if empty.
<br>
Options: `Official` | `Bilibili` | `txwy` | `YoStarEN` | `YoStarJP` | `YoStarKR`
:::
::: field name="DrGrandet" type="boolean" optional default="false"
Sanity-saving Originite usage mode, only effective when Originite usage may occur.
<br>
Wait at the Originite confirmation screen until the current 1 sanity point is restored, then immediately use Originite.
:::
::::
:::
::: field name="medicine" type="number" optional default="0"
Maximum number of Sanity Potions used.
:::
::: field name="expiring_medicine" type="number" optional default="0"
Maximum number of Sanity Potions expiring within 48 hours.
:::
::: field name="stone" type="number" optional default="0"
Maximum number of Originite Prime used.
:::
::: field name="times" type="number" optional default="2147483647"
Number of battles.
:::
::: field name="series" type="number" optional
Number of consecutive battles, -1~6.
<br>
`-1` to disable switching.
<br>
`0` to automatically switch to the current maximum available times, if current sanity is not enough for 6 times, select the minimum available times.
<br>
`1~6` to specify number of consecutive battles.
:::
::: field name="drops" type="object" optional
Specifying the number of drops, no specification by default. key is item_id, value is quantity. key can refer to `resource/item_index.json` file.
<br>
Example: `{ "30011": 10, "30062": 5 }`
<br>
All above are OR relations, i.e. task stops when any one is reached.
:::
::: field name="report_to_penguin" type="boolean" optional default="false"
Whether to upload data to Penguin Statistics.
:::
::: field name="penguin_id" type="string" optional
Penguin Statistics report id, empty by default. Only effective when `report_to_penguin` is true.
:::
:::
::: field name="report_to_yituliu" type="boolean" optional default="false"
Whether to report to YITULIU.
:::
::: field name="yituliu_id" type="string" optional
YITULIU report id, empty by default. Only effective when `report_to_yituliu` is true.
:::
::: field name="server" type="string" optional default="CN"
Server, will affect drop recognition and upload.
<br>
Options: `CN` | `US` | `JP` | `KR`
:::
::: field name="client_type" type="string" optional
Client version, empty by default. Used to restart and reconnect after game crash, does not enable this feature if empty.
<br>
Options: `Official` | `Bilibili` | `txwy` | `YoStarEN` | `YoStarJP` | `YoStarKR`
:::
::: field name="DrGrandet" type="boolean" optional default="false"
Sanity-saving Originite usage mode, only effective when Originite usage may occur.
<br>
Wait at the Originite confirmation screen until the current 1 sanity point is restored, then immediately use Originite.
:::
::::
<details>
<summary>Example</summary>
@@ -335,7 +336,7 @@ Facilities for shifting (ordered). Editing in run-time is not supported.
<br>
Facility name: `Mfg` | `Trade` | `Power` | `Control` | `Reception` | `Office` | `Dorm` | `Processing` | `Training`
:::
::: field name="drones" type="string" optional default="_NotUse"
::: field name="drones" type="string" optional default="\_NotUse"
Usage of drones. This field is ignored when `mode = 10000`.
<br>
Options: `_NotUse` | `Money` | `SyntheticJade` | `CombatRecord` | `PureGold` | `OriginStone` | `Chip`
@@ -375,7 +376,7 @@ Plan index number in the configuration. Editing in run-time is not supported.
<br>
<Badge type="warning" text="Only effective when mode = 10000" />
:::
::::
::::
<details>
<summary>Example</summary>
@@ -437,7 +438,7 @@ Formation slot index used for the OF-1 battle.
<br>
Integer between 0–4, where 0 = current squad, 1–4 = first, second, third, fourth squad.
:::
::::
::::
<details>
<summary>Example</summary>
@@ -484,7 +485,7 @@ Collect Orundum from limited mining licenses.
::: field name="specialaccess" type="boolean" optional default="false"
Collect monthly card rewards from 5th anniversary.
:::
::::
::::
<details>
<summary>Example</summary>
@@ -655,7 +656,7 @@ Only possible to be true in Sarkaz theme, Investment mode, with "点刺成锭分
<br>
Uses fixed seed.
:::
::::
::::
<details>
<summary>Example</summary>
@@ -725,56 +726,57 @@ List of jobs, mutually exclusive with filename (required, choose one); when both
<br>
Each object contains:
<br>
- `filename`: Path to the job JSON file; both relative and absolute paths are supported
<br>
<br>
- `stage_name`: Stage name, refer to [PRTS.Map](https://map.ark-nights.com) for details
<br>
<br>
- `is_raid`: Whether to switch to Challenge Mode (Raid), optional, default false
:::
::: field name="loop_times" type="number" optional default="1"
Number of loops. Effective only in single job mode (i.e., when filename is specified); set_params can only be executed once when this parameter is in effect.
:::
::: field name="use_sanity_potion" type="boolean" optional default="false"
Whether to use sanity potions when sanity is insufficient.
:::
::: field name="formation" type="boolean" optional default="false"
Whether to enable auto formation.
:::
::: field name="formation_index" type="number" optional default="0"
The index of the formation slot to use in auto formation. Only effective when formation is true.
<br>
An integer between 0–4: 0 means the current formation, 1–4 refer to the 1st–4th formations.
:::
::: field name="user_additional" type="array<object>" optional default="[]"
Custom additional operators list. Only effective when formation is true.
<br>
Each object contains:
<br>
:::
::: field name="loop_times" type="number" optional default="1"
Number of loops. Effective only in single job mode (i.e., when filename is specified); set_params can only be executed once when this parameter is in effect.
:::
::: field name="use_sanity_potion" type="boolean" optional default="false"
Whether to use sanity potions when sanity is insufficient.
:::
::: field name="formation" type="boolean" optional default="false"
Whether to enable auto formation.
:::
::: field name="formation_index" type="number" optional default="0"
The index of the formation slot to use in auto formation. Only effective when formation is true.
<br>
An integer between 0–4: 0 means the current formation, 1–4 refer to the 1st–4th formations.
:::
::: field name="user_additional" type="array<object>" optional default="[]"
Custom additional operators list. Only effective when formation is true.
<br>
Each object contains:
<br>
- `name`: Operator name, optional, default "", if left empty this operator will be ignored
<br>
<br>
- `skill`: Skill to bring, optional, default 1; must be an integer between 1–3; otherwise, follows the in-game default
:::
::: field name="add_trust" type="boolean" optional default="false"
Whether to auto-fill empty slots by ascending trust value during auto formation. Only effective when formation is true.
:::
::: field name="ignore_requirements" type="boolean" optional default="false"
Whether to ignore operator attribute requirements during auto formation. Only effective when formation is true.
:::
::: field name="support_unit_usage" type="number" optional default="0"
Support operator usage mode. Integer between 0–3. Only effective when formation is true.
<br>
`0` - Do not use support operators
<br>
`1` - Use support operator only if exactly one operator is missing; otherwise, do not use support
<br>
`2` - Use support operator if one is missing; otherwise, use the specified support operator
<br>
`3` - Use support operator if one is missing; otherwise, use a random support operator
:::
::: field name="support_unit_name" type="string" optional default=""
Specified support operator name. Only effective when support_unit_usage is 2.
:::
::::
:::
::: field name="add_trust" type="boolean" optional default="false"
Whether to auto-fill empty slots by ascending trust value during auto formation. Only effective when formation is true.
:::
::: field name="ignore_requirements" type="boolean" optional default="false"
Whether to ignore operator attribute requirements during auto formation. Only effective when formation is true.
:::
::: field name="support_unit_usage" type="number" optional default="0"
Support operator usage mode. Integer between 0–3. Only effective when formation is true.
<br>
`0` - Do not use support operators
<br>
`1` - Use support operator only if exactly one operator is missing; otherwise, do not use support
<br>
`2` - Use support operator if one is missing; otherwise, use the specified support operator
<br>
`3` - Use support operator if one is missing; otherwise, use a random support operator
:::
::: field name="support_unit_name" type="string" optional default=""
Specified support operator name. Only effective when support_unit_usage is 2.
:::
::::
For more details about auto-combat JSON, please refer to [Combat Operation Protocol](./copilot-schema.md)
@@ -817,7 +819,7 @@ Filename and path of the task JSON, supporting absolute/relative paths. Editing
::: field name="loop_times" type="number" optional
Number of times to loop execution.
:::
::::
::::
For more details about Stationary Security Service JSON, please refer to [SSS Schema](./sss-schema.md)
@@ -847,7 +849,7 @@ File path of a single operation JSON, supports absolute/relative paths. Runtime
::: field name="list" type="array<string>" required
List of operation JSON files, supports absolute/relative paths. Runtime editing not supported. Mutually exclusive with filename (required, choose one).
:::
::::
::::
<details>
<summary>Example</summary>
@@ -869,7 +871,7 @@ List of operation JSON files, supports absolute/relative paths. Runtime editing
::: field name="enable" type="boolean" optional default="true"
Whether to enable this task.
:::
::::
::::
<details>
<summary>Example</summary>
@@ -889,7 +891,7 @@ Whether to enable this task.
::: field name="enable" type="boolean" optional default="true"
Whether to enable this task.
:::
::::
::::
<details>
<summary>Example</summary>
@@ -912,9 +914,9 @@ Whether to enable this task.
::: field name="theme" type="string" optional default="Fire"
Theme.
<br>
`Fire` - *Fire Within the Sand*
`Fire` - _Fire Within the Sand_
<br>
`Tales` - *Tales Within the Sand*
`Tales` - _Tales Within the Sand_
:::
::: field name="mode" type="number" optional default="0"
Mode.
@@ -936,7 +938,7 @@ Click type.
::: field name="num_craft_batches" type="number" optional default="16"
Maximum number of craft batches per session.
:::
::::
::::
<details>
<summary>Example</summary>
@@ -964,7 +966,7 @@ Whether to enable this task.
::: field name="task_names" type="array<string>" required
Execute the task on the first match in the array (and subsequent next, etc.). If you want to perform multiple tasks, you can append Custom task multiple times.
:::
::::
::::
<details>
<summary>Example</summary>
@@ -1000,7 +1002,7 @@ Subtask type.
::: field name="details" type="object" optional
Detailed parameters for the subtask.
:::
::::
::::
<details>
<summary>Example</summary>
@@ -1028,7 +1030,7 @@ Whether to enable this task.
::: field name="filename" type="string" required
Video file path, supporting absolute/relative paths. Editing in run-time is not supported.
:::
::::
::::
<details>
<summary>Example</summary>
@@ -1068,7 +1070,7 @@ Instance handle
::: field name="task" type="AsstTaskId" required
Task ID, the return value of `AsstAppendTask`
:::
::: field name="params" type="const char*" required
::: field name="params" type="const char\*" required
Task parameter in JSON, same as `AsstAppendTask`.
For those fields that do not mention "Editing in run-time is not supported" can be changed during run-time. Otherwise these changes will be ignored when the task is running.
:::
@@ -1097,7 +1099,7 @@ Set process-level parameters
::: field name="key" type="AsstStaticOptionKey" required
key
:::
::: field name="value" type="const char*" required
::: field name="value" type="const char\*" required
value
:::
::::
@@ -1132,7 +1134,7 @@ handle
::: field name="key" type="AsstInstanceOptionKey" required
key
:::
::: field name="value" type="const char*" required
::: field name="value" type="const char\*" required
value
:::
::::

1
docs/ja-jp/manual/introduction/combat.md
View File

@@ -71,6 +71,7 @@ icon: hugeicons:brain-02
これはスケジュールに近い機能であり、「ステージ選択に失敗したときの予備候補」にはなりません。
例：代替選択肢が `龍門幣-6(CE-6)`、 `1-7` 、`作戦記録-6(LS-6)` の場合：
- 当日に `龍門幣-6(CE-6)` が開放されていれば `龍門幣-6(CE-6)` に向かい、`1-7` と `作戦記録-6(LS-6)` には向かいません。この時点で `龍門幣-6(CE-6)` の自動指揮を解放していなければ、作戦タスクはエラーになります。
- 当日に `龍門幣-6(CE-6)` が開放されていなければ `1-7` に向かい、`龍門幣-6(CE-6)` には向かいません。この時点で `1-7` の自動指揮を解放していなければ、作戦タスクはエラーになります。
- `作戦記録-6(LS-6)` より前に常設の `1-7` が存在するため、この構成では MAA は `作戦記録-6(LS-6)` には決して向かいません。

4
docs/ko-kr/protocol/integration.md
View File

@@ -174,7 +174,7 @@ Bilibili 서버: `张三`인 경우 `张三`, `张`, `三` 입력 가능
<br>
오리지늄 사용 확인 창에서 대기하다가, 현재 1이성이 회복되면 즉시 오리지늄을 사용
:::
::::
::::
<details>
<summary>Example</summary>
@@ -645,7 +645,7 @@ Sarkaz 테마, Investment 모드, "연금술 분대" 또는 "지원 분대"일
<br>
고정 시드 사용
:::
::::
::::
<details>
<summary>Example</summary>

1
docs/zh-cn/manual/introduction/combat.md
View File

@@ -71,6 +71,7 @@ icon: hugeicons:brain-02
这是一个类似于日程表的功能，并不能当做关卡选择任务失败时的备用关卡。
例子：关卡备选添加了 `龙门币-6/5`、`1-7` 和 `经验-6/5`：
- 如果当天开放 `龙门币-6/5`，就会前往 `龙门币-6/5`，不会前往 `1-7` 和 `经验-6/5`。如果玩家此时未解锁 `龙门币-6/5` 代理，则理智作战任务出错。
- 如果当天未开放 `龙门币-6/5`，则会前往 `1-7`，不会前往 `龙门币-6/5`。如果玩家此时未解锁 1-7 代理，则理智作战任务出错。
- 由于 `经验-6/5` 前存在常驻关卡 `1-7`，在这种情况下，MAA 永远也不会前往 `经验-6/5` 战斗。

121
docs/zh-cn/protocol/integration.md
View File

@@ -117,6 +117,7 @@ B服：`张三`，可输入 `张三`、`张`、`三`
::: field name="stage" type="string" optional
关卡名，默认为空，识别当前/上次的关卡。不支持运行中设置。
目前支持导航的关卡有：
- 全部主线关卡。可在关卡末尾添加 `-NORMAL` 或 `-HARD` 来切换标准或磨难关卡。
- 龙门币、作战记录的 5 / 6 关，但必须输入 `CE-6` / `LS-6`。MAA 会在第六关无法代理的情况下自动切换至第五关。
- 技能书、采购凭证、碳本第 5 关，必须输入 `CA-5` / `AP-5` / `SK-5`。
@@ -129,64 +130,64 @@ B服：`张三`，可输入 `张三`、`张`、`三`
- 别传中的 OF-1 / OF-F3 / GT-5。
- 当期 SS 活动 后三关。可访问 [API](https://api.maa.plus/MaaAssistantArknights/api/gui/StageActivity.json) 获取支持的关卡列表。需额外加载 [tasks.json](https://api.maa.plus/MaaAssistantArknights/api/resource/tasks.json) 文件中的活动关卡导航。
- 复刻的 SS 活动。输入 `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。
<br>
`-1` 为禁用切换。
<br>
`0` 为自动切换为当前可用的最大次数, 如当前理智不够6次, 则选择最低可用次数。
<br>
`1~6` 为指定连战次数。
:::
::: field name="drops" type="object" optional
指定掉落数量，默认不指定。key 为 item_id, value 为数量。key 可参考 `resource/item_index.json` 文件。
<br>
例如: `{ "30011": 10, "30062": 5 }`
<br>
以上全部是或的关系，即任一达到即停止任务。
:::
::: 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"
服务器，会影响掉落识别及上传。
<br>
选项：`CN` | `US` | `JP` | `KR`
:::
::: field name="client_type" type="string" optional
客户端版本，默认为空。用于游戏崩溃时重启并连回去继续刷，若为空则不启用该功能。
<br>
选项：`Official` | `Bilibili` | `txwy` | `YoStarEN` | `YoStarJP` | `YoStarKR`
:::
::: field name="DrGrandet" type="boolean" optional default="false"
节省理智碎石模式，仅在可能产生碎石效果时生效。
<br>
在碎石确认界面等待，直到当前的 1 点理智恢复完成后再立刻碎石。
:::
::::
:::
::: 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。
<br>
`-1` 为禁用切换。
<br>
`0` 为自动切换为当前可用的最大次数, 如当前理智不够6次, 则选择最低可用次数。
<br>
`1~6` 为指定连战次数。
:::
::: field name="drops" type="object" optional
指定掉落数量，默认不指定。key 为 item_id, value 为数量。key 可参考 `resource/item_index.json` 文件。
<br>
例如: `{ "30011": 10, "30062": 5 }`
<br>
以上全部是或的关系，即任一达到即停止任务。
:::
::: 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"
服务器，会影响掉落识别及上传。
<br>
选项：`CN` | `US` | `JP` | `KR`
:::
::: field name="client_type" type="string" optional
客户端版本，默认为空。用于游戏崩溃时重启并连回去继续刷，若为空则不启用该功能。
<br>
选项：`Official` | `Bilibili` | `txwy` | `YoStarEN` | `YoStarJP` | `YoStarKR`
:::
::: field name="DrGrandet" type="boolean" optional default="false"
节省理智碎石模式，仅在可能产生碎石效果时生效。
<br>
在碎石确认界面等待，直到当前的 1 点理智恢复完成后再立刻碎石。
:::
::::
<details>
<summary>Example</summary>
@@ -655,7 +656,7 @@ Tag 等级（大于等于 3）和对应的希望招募时限，单位为分钟
<br>
使用固定种子。
:::
::::
::::
<details>
<summary>Example</summary>
@@ -708,7 +709,7 @@ Tag 等级（大于等于 3）和对应的希望招募时限，单位为分钟
</details>
刷坍缩范式功能具体请参考 [肉鸽辅助协议](./integrated-strategy-schema.md#萨米肉鸽——坍缩范式)
刷坍缩范式功能具体请参考 [肉鸽辅助协议](./integrated-strategy-schema.md#萨米肉鸽——坍缩范式)
- `Copilot`
自动抄作业

33
docs/zh-tw/manual/introduction/combat.md
View File

@@ -8,7 +8,7 @@ icon: hugeicons:brain-02
## 一般設定
- `吃理智藥` + `吃源石` 和 `指定次數`、`指定材料` 三個選項為為「或」邏輯關係，
即達成三個選項中的任一條件，均會視為任務完成，停止刷理智。
即達成三個選項中的任一條件，均會視為任務完成，停止刷理智。
- `吃理智藥` 指定補充幾瓶理智（可能一次吃多瓶藥）。
- `吃源石` 指定碎幾顆石頭（一次一顆），當倉庫中有理智藥時不會碎石。
- `指定次數` 指定刷多少次指定關卡（例如「刷 15 次後停止」）。
@@ -16,23 +16,23 @@ icon: hugeicons:brain-02
- `指定材料` 與 `關卡選擇` 是兩個互相獨立的邏輯。`指定材料` 只是以材料個數作為任務完成依據，並不會自動導航到相應關卡。
- `吃源石` 只會在 `吃理智藥` 之後判斷，因為 MAA 只有在沒有理智藥時才會使用源石補充理智。
所以在勾選 `吃源石` 之後，MAA 會將 `吃理智藥` 的次數鎖定為 999，確保將理智藥吃光，以避免跳過 `吃源石` 判斷。
所以在勾選 `吃源石` 之後，MAA 會將 `吃理智藥` 的次數鎖定為 999，確保將理智藥吃光，以避免跳過 `吃源石` 判斷。
::: details 範例
| 吃理智藥 | 吃源石 | 指定次數 | 指定材料 | 结果 |
| :------: | :------: | :------: | :------: | ------------------------------------------------------------------------------------------------------------------------- |
| | | | | 刷完現有理智即結束。 |
| 2 | | | | 先刷完現有理智，然後吃一次理智藥，一共吃 `2` 次，刷完理智後結束。 |
| _999_ | 2 | | | 先刷完現有理智，並吃光理智藥後，再碎石，一共碎 `2` 次，刷完理智後結束。 |
| | | 2 | | 刷 `2` 次選擇的關卡即結束。 |
| | | | 2 | 掉落統計刷到 `2` 個指定的材料即結束。 |
| 2 | | 4 | | 在最多吃 `2` 次理智藥的情況下，刷 `4` 次選擇的關卡即結束。 |
| 2 | | | 4 | 在最多吃 `2` 次理智藥的情況下，掉落統計刷到 `4` 個指定的材料即結束。 |
| 2 | | 4 | 8 | 在最多吃 `2` 次理智藥的情況下，刷 `4` 次選擇的關卡即結束。但如果在沒刷完 `4` 次之前就獲得了 `8` 個指定材料，則會提前結束。 |
| _999_ | 4 | 8 | 16 | 在最多吃光理智藥並碎 `4` 次石頭的情況下，刷 `8` 次選擇的關卡即結束。但如果在沒刷完 `8` 次之前就獲得了 `16` 個指定材料，則會提前結束。 |
| | 2 | | | 先刷完現有理智，如果倉庫中有理智藥則結束，如果沒有理智藥則碎 `2` 次石，刷完理智後結束。_非 MAA GUI 行為_ |
| 2 | 4 | | | 先刷完現有理智，如果吃完 `2` 次理智藥後還有理智藥，則結束；如果吃完 ≤`2` 次理智藥後沒有理智藥了，則繼續碎 `4` 次石頭，刷完理智後結束。_非 MAA GUI 行為_ |
| 吃理智藥 | 吃源石 | 指定次數 | 指定材料 | 结果 |
| :------: | :----: | :------: | :------: | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| | | | | 刷完現有理智即結束。 |
| 2 | | | | 先刷完現有理智，然後吃一次理智藥，一共吃 `2` 次，刷完理智後結束。 |
| _999_ | 2 | | | 先刷完現有理智，並吃光理智藥後，再碎石，一共碎 `2` 次，刷完理智後結束。 |
| | | 2 | | 刷 `2` 次選擇的關卡即結束。 |
| | | | 2 | 掉落統計刷到 `2` 個指定的材料即結束。 |
| 2 | | 4 | | 在最多吃 `2` 次理智藥的情況下，刷 `4` 次選擇的關卡即結束。 |
| 2 | | | 4 | 在最多吃 `2` 次理智藥的情況下，掉落統計刷到 `4` 個指定的材料即結束。 |
| 2 | | 4 | 8 | 在最多吃 `2` 次理智藥的情況下，刷 `4` 次選擇的關卡即結束。但如果在沒刷完 `4` 次之前就獲得了 `8` 個指定材料，則會提前結束。 |
| _999_ | 4 | 8 | 16 | 在最多吃光理智藥並碎 `4` 次石頭的情況下，刷 `8` 次選擇的關卡即結束。但如果在沒刷完 `8` 次之前就獲得了 `16` 個指定材料，則會提前結束。 |
| | 2 | | | 先刷完現有理智，如果倉庫中有理智藥則結束，如果沒有理智藥則碎 `2` 次石，刷完理智後結束。_非 MAA GUI 行為_ |
| 2 | 4 | | | 先刷完現有理智，如果吃完 `2` 次理智藥後還有理智藥，則結束；如果吃完 ≤`2` 次理智藥後沒有理智藥了，則繼續碎 `4` 次石頭，刷完理智後結束。_非 MAA GUI 行為_ |
:::
@@ -73,6 +73,7 @@ icon: hugeicons:brain-02
這是一個類似於排程表的功能，並不能當作關卡選擇任務失敗時的備用關卡。
範例：關卡備選選擇了 `龍門幣-6/5`、`1-7` 與 `經驗-6/5`：
- 若當天開放 `龍門幣-6/5`，則會前往該關卡，不會前往 `1-7` 或 `經驗-6/5`。若玩家此時未解鎖 `龍門幣-6/5` 代理，則刷理智任務出錯。
- 若當天未開放 `龍門幣-6/5`，則前往 `1-7`，不會前往 `經驗-6/5`。若玩家此時未解鎖 `1-7` 代理，則刷理智任務出錯。
- 由於 `經驗-6/5` 前存在常駐關卡 `1-7`，在這種情況下，MAA 永遠不會前往 `經驗-6/5` 戰鬥。
@@ -121,4 +122,4 @@ MAA 執行的戰鬥次數不會超過「指定次數」。
- 支援自動勾選 `代理指揮`。
- 支援斷線後或凌晨 4 點閃斷後自動重連並繼續任務。
- 支援等級提升後繼續任務。
- 代理失敗時會放棄本次行動並重新戰鬥。
- 代理失敗時會放棄本次行動並重新戰鬥。

34
docs/zh-tw/protocol/integrated-strategy-schema.md
View File

@@ -102,8 +102,8 @@ icon: ri:game-fill
| 組合名稱 | 主要考量 | 主要包括職業 | 幹員名稱舉例 |
| :------------------------ | :----------------------------- | :-------------------- | :--------------------------------------------------------------- |
| **_地面阻擋_** | 站場與清雜 | 重裝、近衛 | 奶盾、基石、羽毛筆、山、M3、令和稀音的召喚物、斑點、重裝預備幹員 |
| **_地面單切 / 處決者_** | 單獨對戰精英怪 | 處決者特種 | 史爾特爾、異德、麒麟 R 夜刀、M3、紅 |
| **_地面阻擋_** | 站場與清雜 | 重裝、近衛 | 奶盾、基石、羽毛筆、山、M3、令和稀音的召喚物、斑點、重裝預備幹員 |
| **_地面單切 / 處決者_** | 單獨對戰精英怪 | 處決者特種 | 史爾特爾、異德、麒麟 R 夜刀、M3、紅 |
| **_高台 C_** | 常態與決戰輸出 | 狙擊、術師 | 維什戴爾、邏各斯、假日威龍陳、澄閃 |
| **_高台輸出_** | 對空與常態輸出 | 狙擊、術師 | 空弦、能天使、克洛絲、史都華德 |
| **_速狙_** | 物理輸出，標準射程 | 狙擊 | 艾拉、能天使、躍躍、克洛絲 |
@@ -141,17 +141,17 @@ icon: ri:game-fill
除了上述較籠統的分組，有時我們需要對一些幹員或幹員種類進行一些客製化的精細操作，例如：
| 組合名稱 | 包含幹員 | 主要特點 |
| :----------- | :--------------- | :-------------------------------------------------------------------------- |
| 益達 | 維什戴爾 | 高台輸出，優先部署可以減輕壓力 |
| 棘刺 | 棘刺、號角 | 地面遠程輸出，傀影肉鴿中部分地圖有非常適合的站位 |
| 召喚類 | 凱爾希、令、稀音 | 具備地面阻擋能力，部分地圖需要優先部署，召喚物可以當阻擋也可以當炮灰 |
| 情報官 | 曉歌、伊內絲 | 既可以回費、又可以側向輸出、還可以單切 |
| 濁心斯卡蒂 | 濁心斯卡蒂 | 低壓時治療量尚可，但是範圍特殊，一些地圖有比較適合的站位 |
| 焰葦 | 焰影葦草 | 薩米肉鴿常用開局幹員，兼具治療和輸出，一些地圖有比較適合的站位 |
| 瑪恩納 | 瑪恩納、銀灰 | 地面大範圍決戰輸出，可以針對 Boss 進行部署 |
| 史爾特爾 | 史爾特爾 | 由於精二後固定攜帶 3 技能，此時站場能力幾乎為零，需要阻擋位時部署優先度極低 |
| 骰子 | 骰子 | 水月肉鴿中的骰子需要單獨操作 |
| 組合名稱 | 包含幹員 | 主要特點 |
| :--------- | :--------------- | :-------------------------------------------------------------------------- |
| 益達 | 維什戴爾 | 高台輸出，優先部署可以減輕壓力 |
| 棘刺 | 棘刺、號角 | 地面遠程輸出，傀影肉鴿中部分地圖有非常適合的站位 |
| 召喚類 | 凱爾希、令、稀音 | 具備地面阻擋能力，部分地圖需要優先部署，召喚物可以當阻擋也可以當炮灰 |
| 情報官 | 曉歌、伊內絲 | 既可以回費、又可以側向輸出、還可以單切 |
| 濁心斯卡蒂 | 濁心斯卡蒂 | 低壓時治療量尚可，但是範圍特殊，一些地圖有比較適合的站位 |
| 焰葦 | 焰影葦草 | 薩米肉鴿常用開局幹員，兼具治療和輸出，一些地圖有比較適合的站位 |
| 瑪恩納 | 瑪恩納、銀灰 | 地面大範圍決戰輸出，可以針對 Boss 進行部署 |
| 史爾特爾 | 史爾特爾 | 由於精二後固定攜帶 3 技能，此時站場能力幾乎為零，需要阻擋位時部署優先度極低 |
| 骰子 | 骰子 | 水月肉鴿中的骰子需要單獨操作 |
::: info 注意
目前固定將未辨識到的地面幹員歸入倒數第二個組合（其他地面），未辨識到的高台幹員則歸入最後一個組合（其他高台）。
@@ -234,7 +234,6 @@ icon: ri:game-fill
4. 群組內幹員各個欄位的意義和腳本相關邏輯：
```json5
{
"theme": "Phantom",
@@ -332,7 +331,7 @@ icon: ri:game-fill
首先在 `設定` 中將 `座標展示` 切換為 `MAA`。
接著根據您的經驗，尋找需要優先防守的點位座標與朝向（通常是朝向敵方出現的方向），寫入到 json 的 `"replacement_home"` 欄位中。
```json5
{
"stage_name": "蓄水池", // 關卡名稱
@@ -428,13 +427,12 @@ icon: ri:game-fill
::: tip
一些常用的幹員群組用法：
1. 許多作業中主要防守點的組合是 ["地面阻挡", "处决者", "其他地面"]，這代表當主要扛傷位幹員倒下時，會嘗試用處決者拖延冷卻時間；當此點位生存壓力過大時，可考慮使用 ["重装", "地面阻挡", "处决者", "炮灰", "其他地面"]；盾後點位則可優先部署盾後輸出單位 ["地面远程", "地面阻挡", "处决者", "其他地面"]；若單純為了吸引仇恨或送死，可以使用 ["炮灰", "障碍物", "其他地面"]。
2. 高台位置常用組合為 ["高台输出", "其他高台"]。若想讓任何高台幹員都能放置，可以使用 ["高台输出", "狙击", "辅助", "盾法", "其他高台"]。
3. 一些地面位置非常適合瑪恩納與地刺類幹員的組合，例如 ["玛恩纳", "地刺"]。
:::
:::
2. 在某個時間點部署幹員
::: tip
@@ -800,7 +798,7 @@ icon: ri:game-fill
MAA 在界園肉鴿中會自動處理通寶的拾取與交換：
::: tip 啟用條件
::: tip 啟用條件
通寶交換功能僅在以下模式中啟用：
- 投資模式：需要開啟 `投資模式啟用購物、招募、進入第 2 層` 選項。

167
docs/zh-tw/protocol/integration.md
View File

@@ -29,13 +29,13 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
:::: field-group
::: field name="handle" type="AsstHandle" required
執行個體控制代碼 (Handle)
執行個體控制代碼 (Handle)
:::
::: field name="type" type="const char*" required
任務類型
:::
::: field name="params" type="const char*" required
任務參數，json String
任務參數，json String
:::
::::
@@ -116,77 +116,78 @@ B 服：`張三`，可輸入 `張三`、`張`、`三`
:::
::: field name="stage" type="string" optional
關卡名稱。預設為空，將辨識 `目前/上次` 關卡。不支援在執行中更改設定。
目前支援導航的關卡包含：
- **全部主線關卡**：可在關卡末尾新增 `-NORMAL` 或 `-HARD` 以切換標準或磨難難度。
- **資源收集**：
- 龍門幣、作戰記錄： 支援第 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` / `GT-5`。
- **當期 SideStory 活動**：支援活動後三關。可查閱 [API](https://api.maa.plus/MaaAssistantArknights/api/gui/StageActivity.json) 獲取支援的關卡列表。需額外加載 [tasks.json](https://api.maa.plus/MaaAssistantArknights/api/resource/tasks.json) 中的活動關卡導航。
目前支援導航的關卡包含：
- **全部主線關卡**：可在關卡末尾新增 `-NORMAL` 或 `-HARD` 以切換標準或磨難難度。
- **資源收集**：
- 龍門幣、作戰記錄： 支援第 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` / `GT-5`。
- **當期 SideStory 活動**：支援活動後三關。可查閱 [API](https://api.maa.plus/MaaAssistantArknights/api/gui/StageActivity.json) 獲取支援的關卡列表。需額外加載 [tasks.json](https://api.maa.plus/MaaAssistantArknights/api/resource/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`。
<br>
`-1`：停用自動切換連戰。
<br>
`0`：自動切換為當前可用的最大連戰次數（若理智不足以進行 6 連戰，則選擇最低可用次數）。
<br>
`1` ~ `6`：指定固定的連戰次數。
:::
::: field name="drops" type="object" optional
指定物品掉落數量，預設不指定。key 為 `item_id`，value 為數量。key 可參考 `resource/item_index.json` 檔案。
<br>
例如：`{ "30011": 10, "30062": 5 }`
<br>
上述所有條件（次數、掉落等）均為「或」的關係，任一條件達成即停止任務。
:::
::: 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"
遊戲伺服器，會影響掉落物辨識及數據上傳。
<br>
選項：`CN` | `US` | `JP` | `KR`
:::
::: field name="client_type" type="string" optional
用戶端版本，預設為空。用於遊戲崩潰後自動重啟並接續任務；若為空則不啟用自動重啟功能。
<br>
選項：`Official` | `Bilibili` | `txwy` | `YoStarEN` | `YoStarJP` | `YoStarKR`
:::
::: field name="DrGrandet" type="boolean" optional default="false"
博朗台模式（節省理智碎石模式），僅在產生碎石需求時才起作用。
<br>
在碎石確認介面等待，直到目前理智自動恢復 1 點後，再立刻執行碎石回復，以避免浪費自然恢復。
:::
::::
:::
::: 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`。
<br>
`-1`：停用自動切換連戰。
<br>
`0`：自動切換為當前可用的最大連戰次數（若理智不足以進行 6 連戰，則選擇最低可用次數）。
<br>
`1` ~ `6`：指定固定的連戰次數。
:::
::: field name="drops" type="object" optional
指定物品掉落數量，預設不指定。key 為 `item_id`，value 為數量。key 可參考 `resource/item_index.json` 檔案。
<br>
例如：`{ "30011": 10, "30062": 5 }`
<br>
上述所有條件（次數、掉落等）均為「或」的關係，任一條件達成即停止任務。
:::
::: 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"
遊戲伺服器，會影響掉落物辨識及數據上傳。
<br>
選項：`CN` | `US` | `JP` | `KR`
:::
::: field name="client_type" type="string" optional
用戶端版本，預設為空。用於遊戲崩潰後自動重啟並接續任務；若為空則不啟用自動重啟功能。
<br>
選項：`Official` | `Bilibili` | `txwy` | `YoStarEN` | `YoStarJP` | `YoStarKR`
:::
::: field name="DrGrandet" type="boolean" optional default="false"
博朗台模式（節省理智碎石模式），僅在產生碎石需求時才起作用。
<br>
在碎石確認介面等待，直到目前理智自動恢復 1 點後，再立刻執行碎石回復，以避免浪費自然恢復。
:::
::::
<details>
<summary>Example</summary>
@@ -402,7 +403,7 @@ Tag 等級（大於等於 3）對應的期望招募時限（單位：分鐘）
- `Mall`
領取信用點數及商店購物。
會先依據 `buy_first` 清單依序購買；接著由左至右掃描商店，避開 `blacklist` 進行第二輪購買；若信用點數溢出，則會無視黑名單再次由左至右購買，直到信用點數不再溢出為止。
會先依據 `buy_first` 清單依序購買；接著由左至右掃描商店，避開 `blacklist` 進行第二輪購買；若信用點數溢出，則會無視黑名單再次由左至右購買，直到信用點數不再溢出為止。
:::: field-group
::: field name="enable" type="boolean" optional default="true"
@@ -655,7 +656,7 @@ Tag 等級（大於等於 3）對應的期望招募時限（單位：分鐘）
<br>
使用固定種子。
:::
::::
::::
<details>
<summary>Example</summary>
@@ -708,7 +709,7 @@ Tag 等級（大於等於 3）對應的期望招募時限（單位：分鐘）
</details>
刷坍縮範式功能，具體請參閱 [肉鴿輔助協定](./integrated-strategy-schema.md#薩米肉鴿——坍縮範式)
刷坍縮範式功能，具體請參閱 [肉鴿輔助協定](./integrated-strategy-schema.md#薩米肉鴿——坍縮範式)
- `Copilot`
自動抄作業
@@ -777,7 +778,7 @@ Tag 等級（大於等於 3）對應的期望招募時限（單位：分鐘）
:::
::::
作業 json 請參閱 [戰鬥流程協定](./copilot-schema.md)
作業 json 請參閱 [戰鬥流程協定](./copilot-schema.md)
<details>
<summary>Example</summary>
@@ -819,7 +820,7 @@ Tag 等級（大於等於 3）對應的期望招募時限（單位：分鐘）
循環執行次數。
:::
::::
保全派駐作業 json 請參考 [保全派駐協定](./sss-schema.md)
保全派駐作業 json 請參考 [保全派駐協定](./sss-schema.md)
<details>
<summary>Example</summary>
@@ -1063,7 +1064,7 @@ bool ASSTAPI AsstSetTaskParams(AsstHandle handle, AsstTaskId id, const char* par
:::: field-group
::: field name="handle" type="AsstHandle" required
實例控制代碼（Handle）。
實例控制代碼（Handle）。
:::
::: field name="task" type="AsstTaskId" required
任務 ID，為 `AsstAppendTask` 介面的回傳值。
@@ -1095,10 +1096,10 @@ bool ASSTAPI AsstSetStaticOption(AsstStaticOptionKey key, const char* value);
:::: field-group
::: field name="key" type="AsstStaticOptionKey" required
鍵（Key）。
鍵（Key）。
:::
::: field name="value" type="const char\*" required
值（Value）。
值（Value）。
:::
::::
@@ -1121,16 +1122,16 @@ bool ASSTAPI AsstSetInstanceOption(AsstHandle handle, AsstInstanceOptionKey key,
#### 回傳值
- `bool`
回傳是否設定成功。
回傳是否設定成功。
#### 參數說明
:::: field-group
::: field name="handle" type="AsstHandle" required
實例控制代碼（Handle）。
實例控制代碼（Handle）。
:::
::: field name="key" type="AsstInstanceOptionKey" required
鍵（Key）。
鍵（Key）。
:::
::: field name="value" type="const char\*" required
值（Value）。

9
src/MaaCore/Assistant.cpp
View File

@@ -397,11 +397,10 @@ asst::Assistant::AsyncCallId asst::Assistant::async_attach_window(
return append_async_call(
AsyncCallItem::Type::AttachWindow,
AsyncCallItem::AttachWindowParams {
.hwnd = hwnd,
.screencap_method = screencap_method,
.mouse_method = mouse_method,
.keyboard_method = keyboard_method },
AsyncCallItem::AttachWindowParams { .hwnd = hwnd,
.screencap_method = screencap_method,
.mouse_method = mouse_method,
.keyboard_method = keyboard_method },
block);
}
#endif

6
src/MaaCore/Assistant.h
View File

@@ -195,7 +195,11 @@ private:
bool ctrl_connect(const std::string& adb_path, const std::string& address, const std::string& config);
#ifdef _WIN32
bool ctrl_attach_window(void* hwnd, Win32ScreencapMethod screencap_method, Win32InputMethod mouse_method, Win32InputMethod keyboard_method);
bool ctrl_attach_window(
void* hwnd,
Win32ScreencapMethod screencap_method,
Win32InputMethod mouse_method,
Win32InputMethod keyboard_method);
#endif
bool ctrl_click(int x, int y);
bool ctrl_screencap();

2
src/MaaCore/Common/AsstTypes.h
View File

@@ -60,6 +60,7 @@ enum class TouchMode
// Win32 截图方式，与 MaaFramework 的 MaaWin32ScreencapMethod 保持一致
using Win32ScreencapMethod = uint64_t;
namespace Win32Screencap
{
constexpr Win32ScreencapMethod None = 0ULL;
@@ -73,6 +74,7 @@ constexpr Win32ScreencapMethod ScreenDC = 1ULL << 5;
// Win32 输入方式，与 MaaFramework 的 MaaWin32InputMethod 保持一致
using Win32InputMethod = uint64_t;
namespace Win32Input
{
constexpr Win32InputMethod None = 0ULL;

6
src/MaaCore/Controller/Controller.h
View File

@@ -46,7 +46,11 @@ public:
bool connect(const std::string& adb_path, const std::string& address, const std::string& config);
#ifdef _WIN32
bool attach_window(void* hwnd, Win32ScreencapMethod screencap_method, Win32InputMethod mouse_method, Win32InputMethod keyboard_method);
bool attach_window(
void* hwnd,
Win32ScreencapMethod screencap_method,
Win32InputMethod mouse_method,
Win32InputMethod keyboard_method);
#endif
bool inited() noexcept;
void set_touch_mode(const TouchMode& mode) noexcept;

16
src/MaaCore/Controller/MinitouchController.cpp
View File

@@ -192,7 +192,9 @@ bool asst::MinitouchController::swipe(
return x >= 0 && x <= m_minitouch_props.max_x && y >= 0 && y <= m_minitouch_props.max_y;
};
auto move_func = [this](int x, int y) { return m_minitoucher->move(x, y); };
auto move_func = [this](int x, int y) {
return m_minitoucher->move(x, y);
};
auto pause_check = [&opt](int cur_x, int cur_y, int start_x, int start_y) {
return std::sqrt(std::pow(cur_x - start_x, 2) + std::pow(cur_y - start_y, 2)) >
@@ -231,7 +233,17 @@ bool asst::MinitouchController::swipe(
return result;
}
else {
return interpolate_swipe(_x1, _y1, _x2, _y2, _duration, TimeInterval, slope_in, slope_out, move_func, bounds_check);
return interpolate_swipe(
_x1,
_y1,
_x2,
_y2,
_duration,
TimeInterval,
slope_in,
slope_out,
move_func,
bounds_check);
}
};

16
src/MaaCore/Controller/PlayToolsController.cpp
View File

@@ -154,7 +154,9 @@ bool asst::PlayToolsController::swipe(
toucher_down(p1);
auto bounds_check = [width, height](int x, int y) { return x >= 0 && x <= width && y >= 0 && y <= height; };
auto bounds_check = [width, height](int x, int y) {
return x >= 0 && x <= width && y >= 0 && y <= height;
};
auto move_func = [this](int x, int y) {
toucher_move({ x, y });
@@ -162,7 +164,17 @@ bool asst::PlayToolsController::swipe(
};
auto progressive_move = [&](int _x1, int _y1, int _x2, int _y2, int _duration) {
interpolate_swipe(_x1, _y1, _x2, _y2, _duration, DefaultSwipeDelay, slope_in, slope_out, move_func, bounds_check);
interpolate_swipe(
_x1,
_y1,
_x2,
_y2,
_duration,
DefaultSwipeDelay,
slope_in,
slope_out,
move_func,
bounds_check);
};
const auto& opt = Config.get_options();

9
src/MaaCore/Controller/Win32ControlUnitLoader.cpp
View File

@@ -39,9 +39,12 @@ bool Win32ControlUnitLoader::load(const std::filesystem::path& dll_path)
return false;
}
m_get_version = reinterpret_cast<GetVersionFunc>(GetProcAddress(static_cast<HMODULE>(m_module), "MaaWin32ControlUnitGetVersion"));
m_create = reinterpret_cast<CreateFunc>(GetProcAddress(static_cast<HMODULE>(m_module), "MaaWin32ControlUnitCreate"));
m_destroy = reinterpret_cast<DestroyFunc>(GetProcAddress(static_cast<HMODULE>(m_module), "MaaWin32ControlUnitDestroy"));
m_get_version = reinterpret_cast<GetVersionFunc>(
GetProcAddress(static_cast<HMODULE>(m_module), "MaaWin32ControlUnitGetVersion"));
m_create =
reinterpret_cast<CreateFunc>(GetProcAddress(static_cast<HMODULE>(m_module), "MaaWin32ControlUnitCreate"));
m_destroy =
reinterpret_cast<DestroyFunc>(GetProcAddress(static_cast<HMODULE>(m_module), "MaaWin32ControlUnitDestroy"));
if (!m_create || !m_destroy) {
Log.error("Failed to get function pointers from DLL");