mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-16 09:50:40 +08:00
docs: 更新&重构文档 (#8316)
~~怎么就发版了~~ 把除了jp以外所有的`<br>`全都改成了双空格或者回车 jp在另一个专门写jp的pr ~~md就好好去用md的换行啊kora!~~ 更新所有的一图流链接 ~~甚至改了个maacore注释结果一直触发action对不起github~~ 添加win7用net8的缓解措施 添加手机助手会占用adb 改了一些小东西 大概 具体看comment 加回了mumu6的文档 但是标记停更 同步zh的readme和根目录下的的readme 修改了一些文风 大概更贴近“官方文档”这种? 哪里不对劲可以说说(
This commit is contained in:
53
README.md
53
README.md
@@ -35,19 +35,18 @@ MAA 的意思是 MAA Assistant Arknights
|
||||
|
||||
## 亮点功能
|
||||
|
||||
- 刷理智,掉落识别及上传 [企鹅物流](https://penguin-stats.cn/);
|
||||
- 刷理智,掉落识别及上传 [企鹅物流](https://penguin-stats.cn/),[一图流](https://ark.yituliu.cn/);
|
||||
- 智能基建换班,自动计算干员效率,单设施内最优解;同时也支持 [自定义排班](https://maa.plus/docs/协议文档/基建排班协议.html);
|
||||
- 自动公招,可选使用加急许可,一次全部刷完!公招数据上传 [企鹅物流](https://penguin-stats.cn/result/stage/recruit/recruit),[一图流](https://yituliu.site/maarecruitdata);
|
||||
- 支持手动识别公招界面,方便对高星公招做出选择; ~~(你的这个高姿回费出的是推王呢还是推王呢)~~
|
||||
- 支持识别干员列表,统计已有和未有干员(还能为手动识别公招界面提供已有潜能数据提示);
|
||||
- 支持识别养成材料,并可导出至 [企鹅物流刷图规划](https://penguin-stats.cn/planner) 和 [明日方舟工具箱](https://arkn.lolicon.app/#/material) 计算缺少的养成材料;
|
||||
- 自动公招,可选使用加急许可,一次全部刷完!公招数据自动上传 [企鹅物流](https://penguin-stats.cn/result/stage/recruit/recruit),[一图流](https://ark.yituliu.cn/survey/maarecruitdata);
|
||||
- 支持手动识别公招界面,方便对高星公招做出选择 ~~(你的这个高姿回费出的是推王呢还是推王呢)~~;
|
||||
- 支持识别干员列表,统计已有和未有干员及潜能,并在公招识别显示;
|
||||
- 支持识别养成材料,并导出至 [企鹅物流刷图规划](https://penguin-stats.cn/planner)、[明日方舟工具箱](https://arkn.lolicon.app/#/material)、[ARK-NIGHTS 干员培养表](https://ark-nights.com/settings);
|
||||
- 访问好友、收取信用及购物、领取日常奖励等,一键全日常自动长草;
|
||||
- 肉鸽全自动刷源石锭和蜡烛,自动识别干员及练度;
|
||||
- 肉鸽全自动刷源石锭和等级,自动烧水和凹直升,智能识别干员及练度;
|
||||
- 选择作业 JSON 文件,自动抄作业, [视频演示](https://www.bilibili.com/video/BV1H841177Fk/);
|
||||
- 仓库识别并支持导出至 [企鹅物流刷图规划器](https://penguin-stats.cn/planner), [明日方舟工具箱](https://arkn.lolicon.app/#/material), [ARK-NIGHTS 干员培养表](https://ark-nights.com/settings);
|
||||
- 支持 C, Python, Java, Rust, Golang, Java HTTP, Rust HTTP 等多种接口,方便集成调用,自定义你的 MAA!
|
||||
|
||||
话不多说,看图!<br>
|
||||
话不多说,看图!
|
||||
|
||||

|
||||

|
||||
@@ -63,12 +62,12 @@ MAA 的意思是 MAA Assistant Arknights
|
||||
|
||||
### 基本说明
|
||||
|
||||
1. 请根据 [模拟器和设备支持情况](https://maa.plus/docs/用户手册/模拟器和设备支持),进行对应的操作;
|
||||
2. 修改模拟器分辨率为 `16:9` 比例,最低 `1280 * 720`,最高 `2K`;<br>
|
||||
1. 请根据 [模拟器和设备支持](https://maa.plus/docs/用户手册/模拟器和设备支持),进行对应的操作;
|
||||
2. 修改模拟器分辨率为 `16:9` 比例,最低 `1280 * 720`,最高 `2K`;
|
||||
对于国际服(美服)玩家,由于界面布局、字号等问题,我们则建议您将分辨率修改为 `1920 * 1080`;
|
||||
3. 开始使用吧!
|
||||
|
||||
更多使用说明请参考 [详细介绍](https://maa.plus/docs/用户手册/详细介绍.html)
|
||||
更多使用说明请参阅 [详细介绍](https://maa.plus/docs/用户手册/详细介绍.html)
|
||||
|
||||
### 常见问题
|
||||
|
||||
@@ -80,16 +79,16 @@ MAA 的意思是 MAA Assistant Arknights
|
||||
- 下载到一半提示“登陆”/“鉴权”;
|
||||
- 连接正常,任务开始了,但是没反应。
|
||||
|
||||
请参考 [常见问题](https://maa.plus/docs/用户手册/常见问题.html)
|
||||
请参阅 [常见问题](https://maa.plus/docs/用户手册/常见问题.html)
|
||||
|
||||
### 外服支持
|
||||
|
||||
目前国际服(美服)、日服、韩服、繁中服的绝大部分功能均已支持。但由于外服用户较少及项目人手不足,很多功能并没有进行全面的测试,所以请自行体验。<br>
|
||||
若您遇到了 Bug,或对某个功能有强需求,欢迎在 [Issues](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues) 和 [讨论区](https://github.com/MaaAssistantArknights/MaaAssistantArknights/discussions) 催更;或加入我们一起建设 MAA!请参考 [外服适配教程](#外服适配)
|
||||
目前国际服(美服)、日服、韩服、繁中服的绝大部分功能均已支持。但由于外服用户较少及项目人手不足,很多功能并没有进行全面的测试,所以请自行体验。
|
||||
若您遇到了 Bug,或对某个功能有强需求,欢迎在 [Issues](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues) 和 [讨论区](https://github.com/MaaAssistantArknights/MaaAssistantArknights/discussions) 催更;或加入我们一起建设 MAA!请参阅 [外服适配教程](#外服适配)
|
||||
|
||||
### CLI支持
|
||||
|
||||
MAA 支持命令行界面(CLI)操作,支持 Linux,macOS 和 Windows,可用于自动化脚本或在无图形界面的服务器上使用。请参考 [CLI 使用指南](https://maa.plus/docs/用户手册/CLI使用指南.html)
|
||||
MAA 支持命令行界面(CLI)操作,支持 Linux,macOS 和 Windows,可用于自动化脚本或在无图形界面的服务器上使用。请参阅 [CLI 使用指南](https://maa.plus/docs/用户手册/CLI使用指南.html)
|
||||
|
||||
## 加入我们
|
||||
|
||||
@@ -127,7 +126,7 @@ MAA 以中文(简体)为第一语言,翻译词条均以中文(简体)
|
||||
|
||||
### Linux | macOS
|
||||
|
||||
请参考 [Linux 编译教程](https://maa.plus/docs/开发文档/Linux编译教程.html)
|
||||
请参阅 [Linux 编译教程](https://maa.plus/docs/开发文档/Linux编译教程.html)
|
||||
|
||||
### API
|
||||
|
||||
@@ -147,7 +146,7 @@ MAA 以中文(简体)为第一语言,翻译词条均以中文(简体)
|
||||
|
||||
### 外服适配
|
||||
|
||||
请参考 [外服适配教程](https://maa.plus/docs/开发文档/外服适配教程.html),对于国服已支持的功能,绝大部分的外服适配工作仅需要截图 + 简单的 JSON 修改即可。
|
||||
请参阅 [外服适配教程](https://maa.plus/docs/开发文档/外服适配教程.html),对于国服已支持的功能,绝大部分的外服适配工作仅需要截图 + 简单的 JSON 修改即可。
|
||||
|
||||
### 想参与开发,但不太会用 GitHub?
|
||||
|
||||
@@ -155,7 +154,7 @@ MAA 以中文(简体)为第一语言,翻译词条均以中文(简体)
|
||||
|
||||
### Issue bot
|
||||
|
||||
请参考 [Issue bot 使用方法](https://maa.plus/docs/开发文档/IssueBot使用方法.html)
|
||||
请参阅 [Issue bot 使用方法](https://maa.plus/docs/开发文档/IssueBot使用方法.html)
|
||||
|
||||
## 致谢
|
||||
|
||||
@@ -184,7 +183,7 @@ MAA 以中文(简体)为第一语言,翻译词条均以中文(简体)
|
||||
### 数据源
|
||||
|
||||
- ~~公开招募数据:[明日方舟工具箱](https://www.bigfun.cn/tools/aktools/hr)~~
|
||||
- ~~干员及基建数据:[PRTS明日方舟中文WIKI](http://prts.wiki/)~~
|
||||
- ~~干员及基建数据:[PRTS Wiki](http://prts.wiki/)~~
|
||||
- 关卡数据:[企鹅物流数据统计](https://penguin-stats.cn/)
|
||||
- 游戏数据及资源:[明日方舟客户端素材](https://github.com/yuanyan3060/ArknightsGameResource)
|
||||
- ~~游戏数据:[《明日方舟》游戏数据](https://github.com/Kengxxiao/ArknightsGameData)~~
|
||||
@@ -197,17 +196,17 @@ MAA 以中文(简体)为第一语言,翻译词条均以中文(简体)
|
||||
|
||||
## 声明
|
||||
|
||||
- 本软件 logo 并非使用 AGPL 3.0 协议开源,[耗毛](https://weibo.com/u/3251357314)、vie 两位画师及软件全体开发者保留所有权利。不得以 AGPL 3.0 协议已授权为由在未经授权的情况下使用本软件 logo,不得在未经授权的情况下将本软件 logo 用于任何商业用途。
|
||||
- 本软件开源、免费,仅供学习交流使用。若您遇到商家使用本软件进行代练并收费,可能是设备与时间等费用,产生的问题及后果与本软件无关。
|
||||
- 本软件 logo 并非使用 AGPL 3.0 协议开源,[耗毛](https://weibo.com/u/3251357314)、vie 两位画师及软件全体开发者保留所有权利。不得以 AGPL 3.0 协议已授权为由在未经授权的情况下使用本软件 logo,不得在未经授权的情况下将本软件 logo 用于任何用途。
|
||||
- 本软件开源、免费,仅供学习交流使用。若您遇到商家使用本软件进行代练并收费,可能由于设备或时间等原因,产生的任何问题及后果与本软件无关。
|
||||
|
||||
## 广告
|
||||
|
||||
用户交流 QQ 群:[MAA 使用 & 粥游交流 QQ 群](https://ota.maa.plus/MaaAssistantArknights/api/qqgroup/index.html)<br>
|
||||
用户交流 TG 群:[Telegram 群](https://t.me/+Mgc2Zngr-hs3ZjU1)<br>
|
||||
自动战斗 JSON 作业分享:[prts.plus](https://prts.plus) 或 [抄作业.com](http://抄作业.com)<br>
|
||||
Bilibili 直播间:[直播间](https://live.bilibili.com/2808861) 每晚直播敲代码,近期很长一段时间应该都是在写本软件~<br>
|
||||
用户交流 QQ 群:[MAA 使用 & 粥游交流 QQ 群](https://ota.maa.plus/MaaAssistantArknights/api/qqgroup/index.html)
|
||||
用户交流 TG 群:[Telegram 群](https://t.me/+Mgc2Zngr-hs3ZjU1)
|
||||
自动战斗 JSON 作业分享:[prts.plus](https://prts.plus) 或 [抄作业.com](http://抄作业.com)
|
||||
Bilibili 直播间:[直播间](https://live.bilibili.com/2808861) 每晚直播敲代码,近期很长一段时间应该都是在写本软件~
|
||||
|
||||
技术群(舟无关、禁水):[内卷地狱!(QQ 群)](https://jq.qq.com/?_wv=1027&k=ypbzXcA2)<br>
|
||||
开发者群:[QQ 群](https://jq.qq.com/?_wv=1027&k=JM9oCk3C)<br>
|
||||
技术群(舟无关、禁水):[内卷地狱!(QQ 群)](https://jq.qq.com/?_wv=1027&k=ypbzXcA2)
|
||||
开发者群:[QQ 群](https://jq.qq.com/?_wv=1027&k=JM9oCk3C)
|
||||
|
||||
如果觉得软件对你有帮助,帮忙点个 Star 吧!~(网页最上方右上角的小星星),这就是对我们最大的支持了!
|
||||
|
||||
@@ -111,7 +111,7 @@
|
||||
- Auto-recruitment and recruitment recognition are two different features!
|
||||
- Auto-recruitment supports using `Expedited Plan` to make it fully automated! Please enable `Auto use Expedited` in `Task Settings` - `Recruit` , and modify `Recruit max times`.
|
||||
- Pop-up notification when 5★, 6★ operators are recruited.
|
||||
- Auto-uploading recruitment data to [Penguin Stats](https://penguin-stats.io/) and [Yituliu](https://yituliu.site/) while auto-recruitment.
|
||||
- Auto-uploading recruitment data to [Penguin Stats](https://penguin-stats.io/) and [Yituliu](https://ark.yituliu.cn/) while auto-recruitment.
|
||||
|
||||
### Depot Recognition (test function)
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
This document is machine-translated. If you have the ability, please refer to the Chinese version. We would greatly appreciate any errors or suggestions for improvement.
|
||||
|
||||
⚠️ **PALLAS WARNING** ⚠️ **Buff Stacking Warning** ⚠️<br>
|
||||
⚠️ **PALLAS WARNING** ⚠️ **Buff Stacking Warning** ⚠️
|
||||
|
||||
Many concepts in this tutorial have been simplified in order to make it more accessible to a wider audience, even at the expense of some elegance and accuracy.
|
||||
For those who have experience using Git and programming knowledge, you may refer to the more advanced tutorial:[DEVELOPMENT](2.2-DEVELOPMENT.md)
|
||||
@@ -23,8 +23,8 @@ This chapter contains slightly dry content. If you're not interested, you can sk
|
||||
|
||||
Copy, literally meaning to make a copy of MAA's code, and then perform subsequent modifications and operations to avoid damaging the original.
|
||||
|
||||
Since it's a copy, let's assume it's called `MAA (1)`.<br>
|
||||
To distinguish it from the original repository, we usually refer to the original MAA repository as "main repository", "upstream", or "origin".<br>
|
||||
Since it's a copy, let's assume it's called `MAA (1)`.
|
||||
To distinguish it from the original repository, we usually refer to the original MAA repository as "main repository", "upstream", or "origin".
|
||||
Since everyone can make a copy of their own, the copied repository is called a "personal repository".
|
||||
|
||||

|
||||
|
||||
@@ -16,22 +16,22 @@ Appends a task.
|
||||
|
||||
#### Return Value
|
||||
|
||||
- `TaskId`<br>
|
||||
- `TaskId`
|
||||
The task ID if the task is successfully appended, for the following configuration;
|
||||
0 if the task is not successfully appended.
|
||||
|
||||
#### Parameter Description
|
||||
|
||||
- `AsstHandle handle`<br>
|
||||
- `AsstHandle handle`
|
||||
Instance handle
|
||||
- `const char* type`<br>
|
||||
- `const char* type`
|
||||
Task type
|
||||
- `const char* params`<br>
|
||||
- `const char* params`
|
||||
Task parameters in JSON
|
||||
|
||||
##### List of Task Types
|
||||
|
||||
- `StartUp`<br>
|
||||
- `StartUp`
|
||||
Start-up
|
||||
|
||||
```json
|
||||
@@ -44,8 +44,8 @@ Appends a task.
|
||||
}
|
||||
```
|
||||
|
||||
- `CloseDown`<br>
|
||||
Close Game Client<br>
|
||||
- `CloseDown`
|
||||
Close Game Client
|
||||
|
||||
```json
|
||||
// Corresponding task parameters
|
||||
@@ -54,7 +54,7 @@ Appends a task.
|
||||
}
|
||||
```
|
||||
|
||||
- `Fight`<br>
|
||||
- `Fight`
|
||||
Operation
|
||||
|
||||
```json
|
||||
@@ -89,7 +89,7 @@ Appends a task.
|
||||
|
||||
Supports some of the special stages,Please refer to [autoLocalization example](..\..\tools\AutoLocalization\example\en-us.xaml#L260).
|
||||
|
||||
- `Recruit`<br>
|
||||
- `Recruit`
|
||||
Recruitment
|
||||
|
||||
```json
|
||||
@@ -128,7 +128,7 @@ Supports some of the special stages,Please refer to [autoLocalization example](.
|
||||
}
|
||||
```
|
||||
|
||||
- `Infrast`<br>
|
||||
- `Infrast`
|
||||
Infrastructure shifting
|
||||
|
||||
```json
|
||||
@@ -154,7 +154,7 @@ Supports some of the special stages,Please refer to [autoLocalization example](.
|
||||
}
|
||||
```
|
||||
|
||||
- `Mall`<br>
|
||||
- `Mall`
|
||||
Collecting Credits and auto-purchasing
|
||||
Will buy items in order following `buy_first` list, buy other items from left to right ignoring items in `blacklist`, and buy other items from left to right ignoring the `blacklist` while credit overflows.
|
||||
|
||||
@@ -177,8 +177,8 @@ Supports some of the special stages,Please refer to [autoLocalization example](.
|
||||
}
|
||||
```
|
||||
|
||||
- `Award`<br>
|
||||
Collecting daily awards.<br>
|
||||
- `Award`
|
||||
Collecting daily awards.
|
||||
|
||||
```json
|
||||
// Corresponding task parameters
|
||||
@@ -187,7 +187,7 @@ Supports some of the special stages,Please refer to [autoLocalization example](.
|
||||
}
|
||||
```
|
||||
|
||||
- `Roguelike`<br>
|
||||
- `Roguelike`
|
||||
Integrated Strategies
|
||||
|
||||
```json
|
||||
@@ -217,7 +217,7 @@ Supports some of the special stages,Please refer to [autoLocalization example](.
|
||||
}
|
||||
```
|
||||
|
||||
- `Copilot`<br>
|
||||
- `Copilot`
|
||||
Copilot auto-combat feature
|
||||
|
||||
```json
|
||||
@@ -230,7 +230,7 @@ Supports some of the special stages,Please refer to [autoLocalization example](.
|
||||
|
||||
For more details about auto-copilot JSON, please refer to [Copilot Schema](3.3-COPILOT_SCHEMA.md)
|
||||
|
||||
- `SSSCopilot`<br>
|
||||
- `SSSCopilot`
|
||||
Copilot auto-combat feature for STATIONARY SECURITY SERVICE
|
||||
|
||||
```json
|
||||
@@ -253,7 +253,7 @@ For more details about auto-copilot JSON, please refer to [Copilot Schema](3.7-S
|
||||
}
|
||||
```
|
||||
|
||||
- `OperBox`<br>
|
||||
- `OperBox`
|
||||
Operator box recognition
|
||||
|
||||
```json
|
||||
@@ -263,7 +263,7 @@ For more details about auto-copilot JSON, please refer to [Copilot Schema](3.7-S
|
||||
}
|
||||
```
|
||||
|
||||
- `ReclamationAlgorithm`<br>
|
||||
- `ReclamationAlgorithm`
|
||||
ReclamationAlgorithm ( A new mode in CN client)
|
||||
|
||||
```json
|
||||
@@ -278,7 +278,7 @@ For more details about auto-copilot JSON, please refer to [Copilot Schema](3.7-S
|
||||
}
|
||||
```
|
||||
|
||||
- `Custom`<br>
|
||||
- `Custom`
|
||||
|
||||
Custom Task
|
||||
|
||||
@@ -293,7 +293,7 @@ For more details about auto-copilot JSON, please refer to [Copilot Schema](3.7-S
|
||||
}
|
||||
```
|
||||
|
||||
- `SingleStep`<br>
|
||||
- `SingleStep`
|
||||
|
||||
Single-step task (currently only supports copilot)
|
||||
|
||||
@@ -312,7 +312,7 @@ For more details about auto-copilot JSON, please refer to [Copilot Schema](3.7-S
|
||||
}
|
||||
```
|
||||
|
||||
- `VideoRecognition`<br>
|
||||
- `VideoRecognition`
|
||||
|
||||
Video recognition, currently only supports operation (combat) video
|
||||
|
||||
@@ -337,16 +337,16 @@ Set task parameters
|
||||
|
||||
#### Return Value
|
||||
|
||||
- `bool`<br>
|
||||
- `bool`
|
||||
Whether the parameters are successfully set.
|
||||
|
||||
#### Parameter Description
|
||||
|
||||
- `AsstHandle handle`<br>
|
||||
- `AsstHandle handle`
|
||||
Instance handle
|
||||
- `TaskId task`<br>
|
||||
- `TaskId task`
|
||||
Task ID, the return value of `AsstAppendTask`
|
||||
- `const char* params`<br>
|
||||
- `const char* params`
|
||||
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.
|
||||
|
||||
@@ -364,14 +364,14 @@ Set process-level parameters
|
||||
|
||||
#### Return Value
|
||||
|
||||
- `bool`<br>
|
||||
- `bool`
|
||||
Is the setup successful
|
||||
|
||||
#### Parameter Description
|
||||
|
||||
- `AsstStaticOptionKey key`<br>
|
||||
- `AsstStaticOptionKey key`
|
||||
key
|
||||
- `const char* value`<br>
|
||||
- `const char* value`
|
||||
value
|
||||
|
||||
##### List of Key and value
|
||||
@@ -392,16 +392,16 @@ Set instance-level parameters
|
||||
|
||||
#### Return Value
|
||||
|
||||
- `bool`<br>
|
||||
- `bool`
|
||||
Is the setup successful
|
||||
|
||||
#### Parameter Description
|
||||
|
||||
- `AsstHandle handle`<br>
|
||||
- `AsstHandle handle`
|
||||
handle
|
||||
- `AsstInstanceOptionKey key`<br>
|
||||
- `AsstInstanceOptionKey key`
|
||||
key
|
||||
- `const char* value`<br>
|
||||
- `const char* value`
|
||||
value
|
||||
|
||||
##### List of Key and value
|
||||
|
||||
@@ -10,7 +10,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
|
||||
## Overview
|
||||
|
||||
- `int msg`<br>
|
||||
- `int msg`
|
||||
The message type
|
||||
|
||||
```cpp
|
||||
@@ -37,9 +37,9 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
};
|
||||
```
|
||||
|
||||
- `const char* details`<br>
|
||||
- `const char* details`
|
||||
Message details, JSON. See also: [Field Description](#field-description)
|
||||
- `void* custom_arg`<br>
|
||||
- `void* custom_arg`
|
||||
Custom arguments of the caller, will pass the `custom_arg` argument of `AsstCreateEx` interface. C-like languages can pass the `this` pointer with it.
|
||||
|
||||
## Field Description
|
||||
@@ -75,25 +75,25 @@ Todo
|
||||
|
||||
### Commonly-used `What` Field Values
|
||||
|
||||
- `ConnectFailed`<br>
|
||||
- `ConnectFailed`
|
||||
Connection failed.
|
||||
- `Connected`<br>
|
||||
- `Connected`
|
||||
Connected. Note that the `uuid` field is empty now (and will be retrieved in the next step)
|
||||
- `UuidGot`<br>
|
||||
- `UuidGot`
|
||||
UUID has been retrieved.
|
||||
- `UnsupportedResolution`<br>
|
||||
- `UnsupportedResolution`
|
||||
The resolution is not supported.
|
||||
- `ResolutionError`<br>
|
||||
- `ResolutionError`
|
||||
Cannot get the resolution.
|
||||
- `Reconnecting`<br>
|
||||
- `Reconnecting`
|
||||
Disconnected (adb/emulator crashed), and reconnecting
|
||||
- `Reconnected`<br>
|
||||
- `Reconnected`
|
||||
Disconnected (adb/emulator crashed), and reconnected successfully
|
||||
- `Disconnect`<br>
|
||||
- `Disconnect`
|
||||
Disconnected (adb/emulator crashed), and failed to reconnect
|
||||
- `ScreencapFailed`<br>
|
||||
- `ScreencapFailed`
|
||||
Screencap Failed (adb/emulator crashed), and failed to reconnect
|
||||
- `TouchModeNotAvailable`<br>
|
||||
- `TouchModeNotAvailable`
|
||||
Touch Mode is not available
|
||||
|
||||
### AsyncCallInfo
|
||||
@@ -125,39 +125,39 @@ Todo
|
||||
|
||||
#### Commonly-used `taskchain` Field Values
|
||||
|
||||
- `StartUp`<br>
|
||||
- `StartUp`
|
||||
Start-up.
|
||||
- `CloseDown`<br>
|
||||
- `CloseDown`
|
||||
Close Game Client
|
||||
- `Fight`<br>
|
||||
- `Fight`
|
||||
Fighting.
|
||||
- `Mall`<br>
|
||||
- `Mall`
|
||||
Mall.
|
||||
- `Recruit`<br>
|
||||
- `Recruit`
|
||||
Auto-recruitment.
|
||||
- `Infrast`<br>
|
||||
- `Infrast`
|
||||
Infrastructure.
|
||||
- `Award`<br>
|
||||
- `Award`
|
||||
Get Daily Rewards
|
||||
- `Roguelike`<br>
|
||||
- `Roguelike`
|
||||
Roguelike.
|
||||
- `Copilot`<br>
|
||||
- `Copilot`
|
||||
Auto-Combat by json file
|
||||
- `SSSCopilot`<br>
|
||||
- `SSSCopilot`
|
||||
Auto-Combat by json file for STATIONARY SECURITY SERVICE
|
||||
- `Depot`<br>
|
||||
- `Depot`
|
||||
Depot Recognition
|
||||
- `OperBox`<br>
|
||||
- `OperBox`
|
||||
Operator Box Recognition
|
||||
- `ReclamationAlgorithm`<br>
|
||||
- `ReclamationAlgorithm`
|
||||
Reclamation Algorithm ( A new mode in CN client)
|
||||
- `Custom`<br>
|
||||
- `Custom`
|
||||
Custom Task
|
||||
- `SingleStep`<br>
|
||||
- `SingleStep`
|
||||
Single Step Task
|
||||
- `VideoRecognition`<br>
|
||||
- `VideoRecognition`
|
||||
Video Recognition for Copilot
|
||||
- `Debug`<br>
|
||||
- `Debug`
|
||||
Debug.
|
||||
|
||||
### Information Related to TaskChain
|
||||
@@ -189,7 +189,7 @@ Todo
|
||||
|
||||
#### Commonly-used `subtask` Field Values
|
||||
|
||||
- `ProcessTask`<br>
|
||||
- `ProcessTask`
|
||||
|
||||
```json
|
||||
// Example of corresponding details field
|
||||
@@ -206,49 +206,49 @@ Todo
|
||||
|
||||
##### Commonly-used `task` Field Values
|
||||
|
||||
- `StartButton2`<br>
|
||||
- `StartButton2`
|
||||
Starting.
|
||||
- `MedicineConfirm`<br>
|
||||
- `MedicineConfirm`
|
||||
Confirmation of using Sanity Potion.
|
||||
- `ExpiringMedicineConfirm`<br>
|
||||
- `ExpiringMedicineConfirm`
|
||||
Confirmation of using Expiring Sanity Potion.
|
||||
- `StoneConfirm`<br>
|
||||
- `StoneConfirm`
|
||||
Confirmation of using Originite Prime.
|
||||
- `RecruitRefreshConfirm`<br>
|
||||
- `RecruitRefreshConfirm`
|
||||
Confirmation of refreshing recruitment list.
|
||||
- `RecruitConfirm`<br>
|
||||
- `RecruitConfirm`
|
||||
Confirmation of recruitment.
|
||||
- `RecruitNowConfirm`<br>
|
||||
- `RecruitNowConfirm`
|
||||
Confirmation of expedited recruitment.
|
||||
- `ReportToPenguinStats`<br>
|
||||
- `ReportToPenguinStats`
|
||||
Reporting to Penguin Stats.
|
||||
- `ReportToYituliu`<br>
|
||||
- `ReportToYituliu`
|
||||
Reporting to Yituliu Big Data.
|
||||
- `InfrastDormDoubleConfirmButton`<br>
|
||||
- `InfrastDormDoubleConfirmButton`
|
||||
Double confirmation at infrastructure, only happens when there is a conflict with other operators.
|
||||
- `StartExplore`<br>
|
||||
- `StartExplore`
|
||||
Integrated Strategy: starting.
|
||||
- `StageTraderInvestConfirm`<br>
|
||||
- `StageTraderInvestConfirm`
|
||||
Integrated Strategy: trading items with Originium Ingot.
|
||||
- `StageTraderInvestSystemFull`<br>
|
||||
- `StageTraderInvestSystemFull`
|
||||
Integrated Strategy: trading system full.
|
||||
- `ExitThenAbandon`<br>
|
||||
- `ExitThenAbandon`
|
||||
Integrated Strategy: exit confirmation.
|
||||
- `MissionCompletedFlag`<br>
|
||||
- `MissionCompletedFlag`
|
||||
Integrated Strategy: mission completed.
|
||||
- `MissionFailedFlag`<br>
|
||||
- `MissionFailedFlag`
|
||||
Integrated Strategy: mission failed.
|
||||
- `StageTraderEnter`<br>
|
||||
- `StageTraderEnter`
|
||||
Integrated Strategy: Cunning Merchant
|
||||
- `StageSafeHouseEnter`<br>
|
||||
- `StageSafeHouseEnter`
|
||||
Integrated Strategy: Safehouse
|
||||
- `StageEncounterEnter`<br>
|
||||
- `StageEncounterEnter`
|
||||
Integrated Strategy: Chance Meeting
|
||||
- `StageCombatDpsEnter`<br>
|
||||
- `StageCombatDpsEnter`
|
||||
Integrated Strategy: Operation
|
||||
- `StageEmergencyDps`<br>
|
||||
- `StageEmergencyDps`
|
||||
Integrated Strategy: Emergency Operation
|
||||
- `StageDreadfulFoe`<br>
|
||||
- `StageDreadfulFoe`
|
||||
Integrated Strategy: Dreadful Foe
|
||||
- `StartGameTask`
|
||||
Failed to launch client (incompatible config file with client_type)
|
||||
@@ -268,7 +268,7 @@ Todo
|
||||
|
||||
#### Commonly-used `what` And `details` Field Values
|
||||
|
||||
- `StageDrops`<br>
|
||||
- `StageDrops`
|
||||
Stage drop information
|
||||
|
||||
```json
|
||||
@@ -316,7 +316,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitTagsDetected`<br>
|
||||
- `RecruitTagsDetected`
|
||||
Recruitment tags detected
|
||||
|
||||
```json
|
||||
@@ -332,7 +332,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitSpecialTag`<br>
|
||||
- `RecruitSpecialTag`
|
||||
Special recruitment tags detected
|
||||
|
||||
```json
|
||||
@@ -342,7 +342,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitResult`<br>
|
||||
- `RecruitResult`
|
||||
Recruitment result
|
||||
|
||||
```json
|
||||
@@ -419,7 +419,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitTagsRefreshed`<br>
|
||||
- `RecruitTagsRefreshed`
|
||||
Recruitment tags refreshed
|
||||
|
||||
```json
|
||||
@@ -430,7 +430,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitNoPermit`<br>
|
||||
- `RecruitNoPermit`
|
||||
Ran out of recruit permit
|
||||
|
||||
```json
|
||||
@@ -441,7 +441,7 @@ Todo
|
||||
```
|
||||
|
||||
|
||||
- `RecruitTagsSelected`<br>
|
||||
- `RecruitTagsSelected`
|
||||
Recruitment tags selected
|
||||
|
||||
```json
|
||||
@@ -454,13 +454,13 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitSlotCompleted`<br>
|
||||
- `RecruitSlotCompleted`
|
||||
Recruitment slot completed
|
||||
|
||||
- `RecruitError`<br>
|
||||
- `RecruitError`
|
||||
Error when recognizing recruitment
|
||||
|
||||
- `EnterFacility`<br>
|
||||
- `EnterFacility`
|
||||
Entering the facility
|
||||
|
||||
```json
|
||||
@@ -471,7 +471,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `NotEnoughStaff`<br>
|
||||
- `NotEnoughStaff`
|
||||
Available operators not enough
|
||||
|
||||
```json
|
||||
@@ -482,7 +482,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `ProductOfFacility`<br>
|
||||
- `ProductOfFacility`
|
||||
Production of the facility
|
||||
|
||||
```json
|
||||
@@ -494,7 +494,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `StageInfo`<br>
|
||||
- `StageInfo`
|
||||
Auto-battle stage info
|
||||
|
||||
```json
|
||||
@@ -504,10 +504,10 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `StageInfoError`<br>
|
||||
- `StageInfoError`
|
||||
Auto-battle stage info error
|
||||
|
||||
- `PenguinId`<br>
|
||||
- `PenguinId`
|
||||
Penguin ID
|
||||
|
||||
```json
|
||||
@@ -517,7 +517,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `DepotInfo`<br>
|
||||
- `DepotInfo`
|
||||
Recognition result of depot
|
||||
|
||||
```json
|
||||
@@ -557,7 +557,7 @@ Todo
|
||||
// Only ArkPlanner and Lolicon formats are supported. More websites will be supported in future.
|
||||
```
|
||||
|
||||
- `OperBoxInfo`<br>
|
||||
- `OperBoxInfo`
|
||||
Recognition result of operator box
|
||||
|
||||
```json
|
||||
@@ -602,5 +602,5 @@ Todo
|
||||
]
|
||||
```
|
||||
|
||||
- `UnsupportedLevel`<br>
|
||||
- `UnsupportedLevel`
|
||||
Unsupported level name
|
||||
|
||||
@@ -143,5 +143,6 @@ Note: As JSON format does not support comments, please remove the comments when
|
||||
|
||||
## Example
|
||||
|
||||
[243_layout_3_times_a_day](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/243_layout_3_times_a_day.json)<br>
|
||||
[153_layout_3_times_a_day](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/153_layout_3_times_a_day.json)<br>
|
||||
[243_layout_3_times_a_day](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/243_layout_3_times_a_day.json)
|
||||
|
||||
[153_layout_3_times_a_day](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/153_layout_3_times_a_day.json)
|
||||
|
||||
@@ -138,5 +138,6 @@ This document is machine-translated. If you have the ability, please refer to th
|
||||
|
||||
## Example
|
||||
|
||||
[SSS_阿卡胡拉丛林.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_阿卡胡拉丛林.json)<br>
|
||||
[SSS_阿卡胡拉丛林.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_阿卡胡拉丛林.json)
|
||||
|
||||
[SSS_多索雷斯在建地块.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_多索雷斯在建地块.json)
|
||||
|
||||
@@ -37,7 +37,7 @@ Development in progress ✿✿ヽ(°▽°)ノ✿<br>
|
||||
|
||||
- Auto-battle, drop items recognition, auto-uploading to [Penguin Stats](https://penguin-stats.io/).
|
||||
- Auto-shifting in the Base, auto efficiency calculation of operators, optimal solution in single room.
|
||||
- Auto-recruitment, support for expedited plan. Auto-uploading recruitment data to [Penguin Stats](https://penguin-stats.io/result/stage/recruit/recruit), [Yituliu](https://yituliu.site/maarecruitdata).
|
||||
- Auto-recruitment, support for expedited plan. Auto-uploading recruitment data to [Penguin Stats](https://penguin-stats.io/result/stage/recruit/recruit), [Yituliu](https://ark.yituliu.cn/survey/maarecruitdata).
|
||||
- Visiting friends, collecting credits and purchasing items, collecting daily rewards, completing daily quests in one click!
|
||||
- Auto-battle for Integrated Strategy (I.S.) for collecting originium ingots and candles.
|
||||
- Importing JSON task file for auto-battle! [Video](https://www.bilibili.com/video/BV1H841177Fk/)
|
||||
|
||||
@@ -65,7 +65,7 @@
|
||||
- 자동 공개모집과 공개모집 인식은 서로 다른 기능입니다!
|
||||
- 자동 공개모집의 경우 `즉시 완료 허가증` 사용을 통한 완전 자동화를 지원합니다! 설정에서 변경 가능합니다.
|
||||
- ★5/★6 오퍼레이터가 모집되면 팝업 알림이 뜹니다.
|
||||
- 자동 공개모집 중 공개모집 데이터를 [펭귄 물류](https://penguin-stats.io/)와 [Yituliu](https://yituliu.site/)로 자동으로 전송합니다.
|
||||
- 자동 공개모집 중 공개모집 데이터를 [펭귄 물류](https://penguin-stats.io/)와 [Yituliu](https://ark.yituliu.cn/)로 자동으로 전송합니다.
|
||||
|
||||
### 통합전략 지원
|
||||
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
이 문서는 기계 번역된 것입니다. 가능하시다면, 중국어 버전을 참조해주세요. 오류나 개선 제안에 대해 감사드리겠습니다.
|
||||
|
||||
⚠️ **팔라스 경고** ⚠️ **버프 스태킹 경고** ⚠️ `<br>`
|
||||
⚠️ **팔라스 경고** ⚠️ **버프 스태킹 경고** ⚠️
|
||||
|
||||
이 튜토리얼에서는 일부 개념을 간소화하여 더 넓은 사용자들이 쉽게 접근할 수 있도록 설명되었습니다. 이를 위해 일부 우아함과 정확성이 희생되었을 수 있습니다. Git과 프로그래밍 지식에 익숙한 경우, 더 고급스러운 튜토리얼인 [개발 가이드](2.2-개발_환경_구축하기.md)를 참조하시기 바랍니다.
|
||||
|
||||
|
||||
@@ -16,22 +16,22 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
|
||||
|
||||
#### 반환 값
|
||||
|
||||
- `TaskId <br>`
|
||||
- `TaskId`
|
||||
작업이 성공적으로 추가되면 작업 ID가 반환됩니다.
|
||||
그렇지 않으면 0이 반환됩니다.
|
||||
|
||||
#### 매개변수 설명
|
||||
|
||||
- `AsstHandle handle <br>`
|
||||
- `AsstHandle handle`
|
||||
인스턴스 핸들
|
||||
- `const char* type <br>`
|
||||
- `const char* type`
|
||||
작업 유형
|
||||
- `const char* params <br>`
|
||||
- `const char* params`
|
||||
JSON 형식의 작업 매개변수
|
||||
|
||||
##### 작업 유형 목록
|
||||
|
||||
- `StartUp <br>`
|
||||
- `StartUp`
|
||||
게임 시작
|
||||
|
||||
```json
|
||||
@@ -44,7 +44,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
|
||||
}
|
||||
```
|
||||
|
||||
- `CloseDown <br>`
|
||||
- `CloseDown`
|
||||
게임 종료
|
||||
|
||||
```json
|
||||
@@ -54,7 +54,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
|
||||
}
|
||||
```
|
||||
|
||||
- `Fight <br>`
|
||||
- `Fight`
|
||||
작전
|
||||
|
||||
```json
|
||||
@@ -86,7 +86,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
|
||||
}
|
||||
```
|
||||
|
||||
- `Recruit <br>`
|
||||
- `Recruit`
|
||||
공개모집
|
||||
|
||||
```json
|
||||
@@ -123,7 +123,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
|
||||
}
|
||||
```
|
||||
|
||||
- `Infrast <br>`
|
||||
- `Infrast`
|
||||
기반시설 교대
|
||||
|
||||
```json
|
||||
@@ -149,7 +149,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
|
||||
}
|
||||
```
|
||||
|
||||
- `Mall <br>`
|
||||
- `Mall`
|
||||
크레딧 수집 및 자동 구매
|
||||
"구매 우선 항목" 목록에 따라 순서대로 아이템을 구매하며 "무시 항목"에 있는 항목을 무시하고 크레딧이 넘칠 때까지 다른 항목을 순서대로 구매합니다.
|
||||
|
||||
@@ -172,7 +172,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
|
||||
}
|
||||
```
|
||||
|
||||
- `Award <br>`
|
||||
- `Award`
|
||||
임무 보상 수령
|
||||
|
||||
```json
|
||||
@@ -182,7 +182,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
|
||||
}
|
||||
```
|
||||
|
||||
- `Roguelike <br>`
|
||||
- `Roguelike`
|
||||
통합전략
|
||||
|
||||
```json
|
||||
@@ -211,7 +211,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
|
||||
}
|
||||
```
|
||||
|
||||
- `Copilot <br>`
|
||||
- `Copilot`
|
||||
Copilot 기반 자동 전투 기능
|
||||
|
||||
```json
|
||||
@@ -224,7 +224,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
|
||||
|
||||
더 많은 자세한 정보는 [전투 스키마](3.3-전투_스키마.md)를 참조하세요.
|
||||
|
||||
- `SSSCopilot <br>`
|
||||
- `SSSCopilot`
|
||||
보안파견용 AI 동반(Copilot 기반) 자동 전투 기능
|
||||
|
||||
```json
|
||||
@@ -247,7 +247,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
|
||||
}
|
||||
```
|
||||
|
||||
- `OperBox <br>`
|
||||
- `OperBox`
|
||||
오퍼레이터 보유 목록 인식 결과
|
||||
|
||||
```json
|
||||
@@ -257,7 +257,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
|
||||
}
|
||||
```
|
||||
|
||||
- `ReclamationAlgorithm <br>`
|
||||
- `ReclamationAlgorithm`
|
||||
생명연산
|
||||
|
||||
```json
|
||||
@@ -272,7 +272,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
|
||||
}
|
||||
```
|
||||
|
||||
- `Custom<br>`
|
||||
- `Custom`
|
||||
|
||||
사용자 정의 태스크
|
||||
|
||||
@@ -287,7 +287,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
|
||||
}
|
||||
```
|
||||
|
||||
- `SingleStep<br>`
|
||||
- `SingleStep`
|
||||
|
||||
단일 단계 태스크 (현재로서는 Copilot만 지원)
|
||||
|
||||
@@ -306,7 +306,7 @@ TaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const char* p
|
||||
}
|
||||
```
|
||||
|
||||
- `VideoRecognition<br>`
|
||||
- `VideoRecognition`
|
||||
|
||||
비디오 인식, 현재로서는 전투 비디오만 지원합니다.
|
||||
|
||||
@@ -331,16 +331,16 @@ bool ASSTAPI AsstSetTaskParams(AsstHandle handle, TaskId id, const char* params)
|
||||
|
||||
#### 반환 값
|
||||
|
||||
- `bool<br>`
|
||||
- `bool`
|
||||
매개변수가 성공적으로 설정되었는지 여부입니다.
|
||||
|
||||
#### 매개변수 설명
|
||||
|
||||
- `AsstHandle handle<br>`
|
||||
- `AsstHandle handle`
|
||||
인스턴스 핸들
|
||||
- `TaskId task<br>`
|
||||
- `TaskId task`
|
||||
태스크 ID, `AsstAppendTask`의 반환 값입니다.
|
||||
- `const char* params<br>`
|
||||
- `const char* params`
|
||||
JSON 형식의 태스크 매개변수, `AsstAppendTask`와 동일합니다.
|
||||
"Editing in run-time is not supported"으로 표시되지 않은 필드는 실행 중에 변경할 수 있습니다. 그렇지 않으면 태스크가 실행 중일 때 이러한 변경 사항은 무시됩니다.
|
||||
|
||||
@@ -358,14 +358,14 @@ bool ASSTAPI AsstSetStaticOption(AsstStaticOptionKey key, const char* value);
|
||||
|
||||
#### 반환 값
|
||||
|
||||
- `bool<br>`
|
||||
- `bool`
|
||||
설정이 성공적인지 여부입니다.
|
||||
|
||||
#### 매개변수 설명
|
||||
|
||||
- `AsstStaticOptionKey key<br>`
|
||||
- `AsstStaticOptionKey key`
|
||||
키
|
||||
- `const char* value<br>`
|
||||
- `const char* value`
|
||||
값
|
||||
|
||||
##### 키와 값 목록
|
||||
@@ -386,16 +386,16 @@ bool ASSTAPI AsstSetInstanceOption(AsstHandle handle, AsstInstanceOptionKey key,
|
||||
|
||||
#### 반환 값
|
||||
|
||||
- `bool<br>`
|
||||
- `bool`
|
||||
설정이 성공적인지 여부입니다.
|
||||
|
||||
#### 매개변수 설명
|
||||
|
||||
- `AsstHandle handle<br>`
|
||||
- `AsstHandle handle`
|
||||
핸들
|
||||
- `AsstInstanceOptionKey key<br>`
|
||||
- `AsstInstanceOptionKey key`
|
||||
키
|
||||
- `const char* value<br>`
|
||||
- `const char* value`
|
||||
값
|
||||
|
||||
##### 키와 값 목록
|
||||
|
||||
@@ -10,7 +10,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
|
||||
## 개요
|
||||
|
||||
- `int msg`<br>
|
||||
- `int msg`
|
||||
메시지 유형입니다.
|
||||
|
||||
```cpp
|
||||
@@ -36,9 +36,9 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
SubTaskStopped, // 서브태스크 중지
|
||||
};
|
||||
```
|
||||
- `const char* details`<br>
|
||||
- `const char* details`
|
||||
메시지 세부사항, JSON 형식입니다. 또한 [필드 설명](#필드-설명)도 참조하세요.
|
||||
- `void* custom_arg`<br>
|
||||
- `void* custom_arg`
|
||||
호출자의 사용자 정의 인수로, `AsstCreateEx` 인터페이스의 `custom_arg` 인수를 전달합니다. C 언어 기반 언어에서는 이를 통해 `this` 포인터를 전달할 수 있습니다.
|
||||
|
||||
## 필드 설명
|
||||
@@ -74,25 +74,25 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
|
||||
### 자주 사용되는 `what` 필드 값
|
||||
|
||||
- `ConnectFailed`<br>
|
||||
- `ConnectFailed`
|
||||
연결 실패.
|
||||
- `Connected`<br>
|
||||
- `Connected`
|
||||
연결됨. 이제 `uuid` 필드는 비어 있습니다 (다음 단계에서 가져올 것입니다).
|
||||
- `UuidGot`<br>
|
||||
- `UuidGot`
|
||||
UUID를 가져왔습니다.
|
||||
- `UnsupportedResolution`<br>
|
||||
- `UnsupportedResolution`
|
||||
해상도가 지원되지 않습니다.
|
||||
- `ResolutionError`<br>
|
||||
- `ResolutionError`
|
||||
해상도를 가져올 수 없습니다.
|
||||
- `Reconnecting`<br>
|
||||
- `Reconnecting`
|
||||
연결이 끊어졌습니다 (adb/에뮬레이터 충돌), 재연결 중
|
||||
- `Reconnected`<br>
|
||||
- `Reconnected`
|
||||
연결이 끊어졌습니다 (adb/에뮬레이터 충돌), 재연결 성공
|
||||
- `Disconnect`<br>
|
||||
- `Disconnect`
|
||||
연결이 끊어졌습니다 (adb/에뮬레이터 충돌), 재연결 실패
|
||||
- `ScreencapFailed`<br>
|
||||
- `ScreencapFailed`
|
||||
스크린샷 실패 (adb/에뮬레이터 충돌), 재연결 실패
|
||||
- `TouchModeNotAvailable`<br>
|
||||
- `TouchModeNotAvailable`
|
||||
터치 모드를 사용할 수 없습니다
|
||||
|
||||
### AsyncCallInfo
|
||||
@@ -124,39 +124,39 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
|
||||
#### 자주 사용되는 `taskchain` 필드 값
|
||||
|
||||
- `StartUp`<br>
|
||||
- `StartUp`
|
||||
시작.
|
||||
- `CloseDown`<br>
|
||||
- `CloseDown`
|
||||
게임 클라이언트 닫기
|
||||
- `Fight`<br>
|
||||
- `Fight`
|
||||
전투.
|
||||
- `Mall`<br>
|
||||
- `Mall`
|
||||
상점.
|
||||
- `Recruit`<br>
|
||||
- `Recruit`
|
||||
자동 인원 모집.
|
||||
- `Infrast`<br>
|
||||
- `Infrast`
|
||||
시설.
|
||||
- `Award`<br>
|
||||
- `Award`
|
||||
일일 보상 받기
|
||||
- `Roguelike`<br>
|
||||
- `Roguelike`
|
||||
로그라이크.
|
||||
- `Copilot`<br>
|
||||
- `Copilot`
|
||||
JSON 파일로 자동 전투
|
||||
- `SSSCopilot`<br>
|
||||
- `SSSCopilot`
|
||||
JSON 파일로 자동 전투 for STATIONARY SECURITY SERVICE
|
||||
- `Depot`<br>
|
||||
- `Depot`
|
||||
창고 인식
|
||||
- `OperBox`<br>
|
||||
- `OperBox`
|
||||
오퍼레이터 박스 인식
|
||||
- `ReclamationAlgorithm`<br>
|
||||
- `ReclamationAlgorithm`
|
||||
Reclamation Algorithm (CN 클라이언트의 새로운 모드)
|
||||
- `Custom`<br>
|
||||
- `Custom`
|
||||
사용자 정의 태스크
|
||||
- `SingleStep`<br>
|
||||
- `SingleStep`
|
||||
단일 단계 태스크
|
||||
- `VideoRecognition`<br>
|
||||
- `VideoRecognition`
|
||||
Copilot용 비디오 인식
|
||||
- `Debug`<br>
|
||||
- `Debug`
|
||||
디버그.
|
||||
|
||||
### TaskChain과 관련된 정보
|
||||
@@ -188,7 +188,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
|
||||
#### 자주 사용되는 `subtask` 필드 값
|
||||
|
||||
- `ProcessTask`<br>
|
||||
- `ProcessTask`
|
||||
```json
|
||||
// 상세 정보에 대한 예시
|
||||
{
|
||||
@@ -203,51 +203,51 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
|
||||
##### 자주 사용되는 `task` 필드 값
|
||||
|
||||
- `StartButton2`<br>
|
||||
- `StartButton2`
|
||||
시작 중입니다.
|
||||
- `MedicineConfirm`<br>
|
||||
- `MedicineConfirm`
|
||||
이성 회복제 사용 확인.
|
||||
- `ExpiringMedicineConfirm`<br>
|
||||
- `ExpiringMedicineConfirm`
|
||||
만료가 임박한 이성 회복 아이템을 사용 확인.
|
||||
- `StoneConfirm`<br>
|
||||
- `StoneConfirm`
|
||||
오리지늄 조각 사용 확인.
|
||||
- `RecruitRefreshConfirm`<br>
|
||||
- `RecruitRefreshConfirm`
|
||||
공개모집 새로고침 여부 확인.
|
||||
- `RecruitConfirm`<br>
|
||||
- `RecruitConfirm`
|
||||
공개모집 확인.
|
||||
- `RecruitNowConfirm`<br>
|
||||
- `RecruitNowConfirm`
|
||||
즉시 완료 허가증 확인.
|
||||
- `ReportToPenguinStats`<br>
|
||||
- `ReportToPenguinStats`
|
||||
펭귄 스텟에 보고합니다.
|
||||
- `ReportToYituliu`<br>
|
||||
- `ReportToYituliu`
|
||||
Yituliu 빅데이터에 보고합니다.
|
||||
- `InfrastDormDoubleConfirmButton`<br>
|
||||
- `InfrastDormDoubleConfirmButton`
|
||||
기반시설 더블 확인 버튼입니다. 다른 오퍼레이터와 충돌이 있을 때만 발생합니다.
|
||||
- `StartExplore`<br>
|
||||
- `StartExplore`
|
||||
통합전략: 시작 중입니다.
|
||||
- `StageTraderInvestConfirm`<br>
|
||||
- `StageTraderInvestConfirm`
|
||||
통합전략: 오리지늄 각뿔 아이템 거래.
|
||||
- `StageTraderInvestSystemFull`<br>
|
||||
- `StageTraderInvestSystemFull`
|
||||
통합전략: 투자 시스템이 가득 참.
|
||||
- `ExitThenAbandon`<br>
|
||||
- `ExitThenAbandon`
|
||||
통합전략: 나가기 확인.
|
||||
- `MissionCompletedFlag`<br>
|
||||
- `MissionCompletedFlag`
|
||||
통합전략: 미션 완료.
|
||||
- `MissionFailedFlag`<br>
|
||||
- `MissionFailedFlag`
|
||||
통합전략: 미션 실패.
|
||||
- `StageTraderEnter`<br>
|
||||
- `StageTraderEnter`
|
||||
통합전략: 교활한 상인 진입.
|
||||
- `StageSafeHouseEnter`<br>
|
||||
- `StageSafeHouseEnter`
|
||||
통합전략: 안전가옥 진입.
|
||||
- `StageEncounterEnter`<br>
|
||||
- `StageEncounterEnter`
|
||||
통합전략: 우연한 만남 진입.
|
||||
- `StageCombatDpsEnter`<br>
|
||||
- `StageCombatDpsEnter`
|
||||
통합전략: 작전 진입.
|
||||
- `StageEmergencyDps`<br>
|
||||
- `StageEmergencyDps`
|
||||
통합전략: 긴급 작전 진입.
|
||||
- `StageDreadfulFoe`<br>
|
||||
- `StageDreadfulFoe`
|
||||
통합전략: 보스 진입.
|
||||
- `StartGameTask`<br>
|
||||
- `StartGameTask`
|
||||
클라이언트를 시작할 수 없음 (클라이언트 유형과 호환되지 않는 구성 파일).
|
||||
- 기타 할 일
|
||||
|
||||
@@ -265,7 +265,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
|
||||
#### 자주 사용되는 `what`과 `details` 필드 값
|
||||
|
||||
- `StageDrops`<br>
|
||||
- `StageDrops`
|
||||
스테이지 드롭 정보
|
||||
|
||||
```json
|
||||
@@ -312,7 +312,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
]
|
||||
}
|
||||
```
|
||||
- `RecruitTagsDetected`<br>
|
||||
- `RecruitTagsDetected`
|
||||
공개모집 태그 감지
|
||||
|
||||
```json
|
||||
@@ -328,7 +328,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
}
|
||||
|
||||
```
|
||||
- `RecruitSpecialTag`<br>
|
||||
- `RecruitSpecialTag`
|
||||
고급 특별 채용 감지
|
||||
|
||||
```
|
||||
@@ -337,7 +337,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
"tag": "高级资深干员" // 고급 특별 채용
|
||||
}
|
||||
```
|
||||
- `RecruitResult`<br>
|
||||
- `RecruitResult`
|
||||
공개모집 결과
|
||||
|
||||
```json
|
||||
@@ -413,7 +413,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
]
|
||||
}
|
||||
```
|
||||
- `RecruitTagsRefreshed`<br>
|
||||
- `RecruitTagsRefreshed`
|
||||
공개모집 태그 갱신 완료
|
||||
|
||||
```json
|
||||
@@ -423,7 +423,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
"refresh_limit": 3 // 갱신 횟수 제한
|
||||
}
|
||||
```
|
||||
- `RecruitNoPermit`<br>
|
||||
- `RecruitNoPermit`
|
||||
모집 라이센스가 없습니다
|
||||
|
||||
```json
|
||||
@@ -432,7 +432,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
"continue": true, // 계속 새로고침할지 말지
|
||||
}
|
||||
```
|
||||
- `RecruitTagsSelected`<br>
|
||||
- `RecruitTagsSelected`
|
||||
공개모집 태그 선택 완료
|
||||
|
||||
```json
|
||||
@@ -444,11 +444,11 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
]
|
||||
}
|
||||
```
|
||||
- `RecruitSlotCompleted`<br>
|
||||
- `RecruitSlotCompleted`
|
||||
영입 슬롯 완료
|
||||
- `RecruitError`<br>
|
||||
- `RecruitError`
|
||||
영입 인식 오류
|
||||
- `EnterFacility`<br>
|
||||
- `EnterFacility`
|
||||
기반시설 입장
|
||||
|
||||
```json
|
||||
@@ -458,7 +458,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
"index": 0 // 시설 ID
|
||||
}
|
||||
```
|
||||
- `NotEnoughStaff`<br>
|
||||
- `NotEnoughStaff`
|
||||
사용 가능한 오퍼레이터가 부족함
|
||||
|
||||
```json
|
||||
@@ -468,7 +468,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
"index": 0 // 시설 ID
|
||||
}
|
||||
```
|
||||
- `ProductOfFacility`<br>
|
||||
- `ProductOfFacility`
|
||||
시설의 생산물
|
||||
|
||||
```json
|
||||
@@ -479,7 +479,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
"index": 0 // 시설 ID
|
||||
}
|
||||
```
|
||||
- `StageInfo`<br>
|
||||
- `StageInfo`
|
||||
자동 전투 스테이지 정보
|
||||
|
||||
```json
|
||||
@@ -488,9 +488,9 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
"name": string // 스테이지 이름
|
||||
}
|
||||
```
|
||||
- `StageInfoError`<br>
|
||||
- `StageInfoError`
|
||||
자동 전투 스테이지 정보 오류
|
||||
- `PenguinId`<br>
|
||||
- `PenguinId`
|
||||
PenguinStats ID
|
||||
|
||||
```json
|
||||
@@ -499,7 +499,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
"id": string
|
||||
}
|
||||
```
|
||||
- `DepotInfo`<br>
|
||||
- `DepotInfo`
|
||||
창고 인식 결과
|
||||
|
||||
```json
|
||||
@@ -540,7 +540,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
}
|
||||
// 현재는 ArkPlanner와 Lolicon 포맷만 지원하며, 미래에 더 많은 웹사이트가 지원될 예정입니다.
|
||||
```
|
||||
- `OperBoxInfo`<br>
|
||||
- `OperBoxInfo`
|
||||
오퍼레이터 보유 목록 인식 결과
|
||||
|
||||
```json
|
||||
@@ -584,5 +584,5 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
}
|
||||
]
|
||||
```
|
||||
- `UnsupportedLevel`<br>
|
||||
- `UnsupportedLevel`
|
||||
지원되지 않는 레벨 이름
|
||||
|
||||
@@ -119,5 +119,6 @@
|
||||
|
||||
## 예시
|
||||
|
||||
[243_layout_3_times_a_day](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/243_layout_3_times_a_day.json) `<br>` 243 3교대
|
||||
[153_layout_3_times_a_day](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/153_layout_3_times_a_day.json) `<br>` 153 3교대
|
||||
[243_layout_3_times_a_day](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/243_layout_3_times_a_day.json) 243 3교대
|
||||
|
||||
[153_layout_3_times_a_day](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/153_layout_3_times_a_day.json) 153 3교대
|
||||
|
||||
@@ -138,5 +138,6 @@
|
||||
|
||||
## 예시
|
||||
|
||||
[SSS_阿卡胡拉丛林.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_阿卡胡拉丛林.json) `<br>` 아카후알라 정글
|
||||
[SSS_阿卡胡拉丛林.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_阿卡胡拉丛林.json) 아카후알라 정글
|
||||
|
||||
[SSS_多索雷斯在建地块.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_多索雷斯在建地块.json) 도솔레스 건설부지
|
||||
|
||||
@@ -38,7 +38,7 @@ MAA는 MAA Assistant Arknights의 약자입니다
|
||||
|
||||
- 자동 전투, 아이템 드랍 인식, [펭귄 물류](https://penguin-stats.io/)로의 자동 업로드
|
||||
- 기반시설 자동 배치, 오퍼레이터 효율과 시설 내 최적 배치방안 자동 계산
|
||||
- 자동 공개모집과 선택적 즉시 모집, [펭귄 물류](https://penguin-stats.io/result/stage/recruit/recruit)와 [Yituliu](https://yituliu.site/maarecruitdata)로의 자동 업로드
|
||||
- 자동 공개모집과 선택적 즉시 모집, [펭귄 물류](https://penguin-stats.io/result/stage/recruit/recruit)와 [Yituliu](https://ark.yituliu.cn/survey/maarecruitdata)로의 자동 업로드
|
||||
- 친구 방문, 크레딧 획득과 아이템 구매, 일일 임무와 보상까지 한 번에!
|
||||
- 통합전략에서의 오리지늄각뿔과 양초 획득을 위한 자동 전투, 오퍼레이터와 레벨의 자동 인식
|
||||
- 전투 JSON 파일을 통한 자동 전투용 전략 복사! [영상 데모](https://www.bilibili.com/video/BV1H841177Fk/)
|
||||
@@ -51,7 +51,7 @@ MAA는 MAA Assistant Arknights의 약자입니다
|
||||
|
||||
## 다운로드
|
||||
|
||||
[안정 버전](https://github.com/MaaAssistantArknights/MaaAssistantArknights/releases/latest)<br>
|
||||
[안정 버전](https://github.com/MaaAssistantArknights/MaaAssistantArknights/releases/latest)
|
||||
[베타 버전](https://github.com/MaaAssistantArknights/MaaAssistantArknights/releases)
|
||||
|
||||
## 사용 방법
|
||||
@@ -59,7 +59,7 @@ MAA는 MAA Assistant Arknights의 약자입니다
|
||||
### 기본 설정
|
||||
|
||||
1. [에뮬레이터 지원](./1.3-에뮬레이터_지원.md) 문서를 참고하여 에뮬레이터/기기를 설정해 주세요.
|
||||
2. 에뮬레이터 해상도를 '1280 * 720' 이상으로 변경하세요. 최대값은 '2K'이고 가로세로 비율은 '16:9'입니다. <br>
|
||||
2. 에뮬레이터 해상도를 '1280 * 720' 이상으로 변경하세요. 최대값은 '2K'이고 가로세로 비율은 '16:9'입니다.
|
||||
YostarEN의 경우 게임 인터페이스 문제로 인해 해상도를 '1920 * 1080'으로 변경하는 것을 권장합니다
|
||||
3. 어시스턴트 시작!
|
||||
|
||||
@@ -78,7 +78,7 @@ MAA는 MAA Assistant Arknights의 약자입니다
|
||||
|
||||
## 해외 서버 지원
|
||||
|
||||
현재 인터내셔널 클라이언트(영어 클라이언트), 일본 클라이언트, 한국 클라이언트, 중국어 번체 클라이언트의 대부분의 기능을 지원하고 있습니다. 다만, 해외 사용자 수가 적고 프로젝트 인력이 부족한 관계로 많은 기능이 충분히 테스트되지 않았으니 직접 경험해 보시기 바랍니다.<br>
|
||||
현재 인터내셔널 클라이언트(영어 클라이언트), 일본 클라이언트, 한국 클라이언트, 중국어 번체 클라이언트의 대부분의 기능을 지원하고 있습니다. 다만, 해외 사용자 수가 적고 프로젝트 인력이 부족한 관계로 많은 기능이 충분히 테스트되지 않았으니 직접 경험해 보시기 바랍니다.
|
||||
버그가 발생하거나 특정 기능에 대한 강력한 수요가 있는 경우 문제 및 토론에 오신 것을 환영합니다. 그리고 MAA를 구축하는 데 자유롭게 참여하십시오! [해외클라이언트현지화](#해외클라이언트현지화)을 참조하십시오.
|
||||
|
||||
## 관련 프로젝트
|
||||
@@ -179,10 +179,10 @@ MAA의 개선을 위한 개발/테스트에 기여해준 모든 친구들에게
|
||||
|
||||
## 광고
|
||||
|
||||
사용자 그룹: [Telegram](https://t.me/+Mgc2Zngr-hs3ZjU1), [QQ 그룹](https://ota.maa.plus/MaaAssistantArknights/api/qqgroup/index.html)<br>
|
||||
[전략 JSON 공유](https://prts.plus)<br>
|
||||
[빌리빌리 라이브](https://live.bilibili.com/2808861): 코딩 과정을 밤마다 방송하고 있습니다. 이 프로그램에 대부분의 시간을 할애하고 있습니다.<br>
|
||||
[명일방주 무관 기술 공유 & 만담 (QQ 그룹)](https://jq.qq.com/?_wv=1027&k=ypbzXcA2): 지옥 같아요!<br>
|
||||
사용자 그룹: [Telegram](https://t.me/+Mgc2Zngr-hs3ZjU1), [QQ 그룹](https://ota.maa.plus/MaaAssistantArknights/api/qqgroup/index.html)
|
||||
[전략 JSON 공유](https://prts.plus)
|
||||
[빌리빌리 라이브](https://live.bilibili.com/2808861): 코딩 과정을 밤마다 방송하고 있습니다. 이 프로그램에 대부분의 시간을 할애하고 있습니다.
|
||||
[명일방주 무관 기술 공유 & 만담 (QQ 그룹)](https://jq.qq.com/?_wv=1027&k=ypbzXcA2): 지옥 같아요!
|
||||
[개발자 그룹 (QQ 그룹)](https://jq.qq.com/?_wv=1027&k=JM9oCk3C)
|
||||
|
||||
프로그램이 도움이 된다고 생각하시면 Star를 눌러주세요! (페이지 우측 상단의 작은 별) 저희에게 가장 큰 도움이 됩니다!
|
||||
|
||||
@@ -35,19 +35,18 @@ MAA 的意思是 MAA Assistant Arknights
|
||||
|
||||
## 亮点功能
|
||||
|
||||
- 刷理智,掉落识别及上传 [企鹅物流](https://penguin-stats.cn/);
|
||||
- 刷理智,掉落识别及上传 [企鹅物流](https://penguin-stats.cn/),[一图流](https://ark.yituliu.cn/);
|
||||
- 智能基建换班,自动计算干员效率,单设施内最优解;同时也支持 [自定义排班](./协议文档/基建排班协议.md);
|
||||
- 自动公招,可选使用加急许可,一次全部刷完!公招数据上传 [企鹅物流](https://penguin-stats.cn/result/stage/recruit/recruit),[一图流](https://yituliu.site/maarecruitdata);
|
||||
- 支持手动识别公招界面,方便对高星公招做出选择; ~~(你的这个高姿回费出的是推王呢还是推王呢)~~
|
||||
- 支持识别干员列表,统计已有和未有干员(还能为手动识别公招界面提供已有潜能数据提示);
|
||||
- 支持识别养成材料,并可导出至 [企鹅物流刷图规划](https://penguin-stats.cn/planner) 和 [明日方舟工具箱](https://arkn.lolicon.app/#/material) 计算缺少的养成材料;
|
||||
- 自动公招,可选使用加急许可,一次全部刷完!公招数据自动上传 [企鹅物流](https://penguin-stats.cn/result/stage/recruit/recruit),[一图流](https://ark.yituliu.cn/survey/maarecruitdata);
|
||||
- 支持手动识别公招界面,方便对高星公招做出选择 ~~(你的这个高姿回费出的是推王呢还是推王呢)~~;
|
||||
- 支持识别干员列表,统计已有和未有干员及潜能,并在公招识别显示;
|
||||
- 支持识别养成材料,并导出至 [企鹅物流刷图规划](https://penguin-stats.cn/planner)、[明日方舟工具箱](https://arkn.lolicon.app/#/material)、[ARK-NIGHTS 干员培养表](https://ark-nights.com/settings);
|
||||
- 访问好友、收取信用及购物、领取日常奖励等,一键全日常自动长草;
|
||||
- 肉鸽全自动刷源石锭和蜡烛,自动识别干员及练度;
|
||||
- 肉鸽全自动刷源石锭和等级,自动烧水和凹直升,智能识别干员及练度;
|
||||
- 选择作业 JSON 文件,自动抄作业, [视频演示](https://www.bilibili.com/video/BV1H841177Fk/);
|
||||
- 仓库识别并支持导出至 [企鹅物流刷图规划器](https://penguin-stats.cn/planner), [明日方舟工具箱](https://arkn.lolicon.app/#/material), [ARK-NIGHTS 干员培养表](https://ark-nights.com/settings);
|
||||
- 支持 C, Python, Java, Rust, Golang, Java HTTP, Rust HTTP 等多种接口,方便集成调用,自定义你的 MAA!
|
||||
|
||||
话不多说,看图!<br>
|
||||
话不多说,看图!
|
||||
|
||||

|
||||

|
||||
@@ -63,12 +62,12 @@ MAA 的意思是 MAA Assistant Arknights
|
||||
|
||||
### 基本说明
|
||||
|
||||
1. 请根据 [模拟器支持情况](./用户手册/模拟器和设备支持/Windows模拟器.md),进行对应的操作;
|
||||
2. 修改模拟器分辨率为 `16:9` 比例,最低 `1280 * 720`,最高 `2K`;<br>
|
||||
1. 请根据 [模拟器和设备支持](./用户手册/模拟器和设备支持),进行对应的操作;
|
||||
2. 修改模拟器分辨率为 `16:9` 比例,最低 `1280 * 720`,最高 `2K`;
|
||||
对于国际服(美服)玩家,由于界面布局、字号等问题,我们则建议您将分辨率修改为 `1920 * 1080`;
|
||||
3. 开始使用吧!
|
||||
|
||||
更多使用说明请参考 [详细介绍](./用户手册/详细介绍.md)
|
||||
更多使用说明请参阅 [详细介绍](./用户手册/详细介绍.md)
|
||||
|
||||
### 常见问题
|
||||
|
||||
@@ -80,16 +79,16 @@ MAA 的意思是 MAA Assistant Arknights
|
||||
- 下载到一半提示“登陆”/“鉴权”;
|
||||
- 连接正常,任务开始了,但是没反应。
|
||||
|
||||
请参考 [常见问题](./用户手册/常见问题.md)
|
||||
请参阅 [常见问题](./用户手册/常见问题.md)
|
||||
|
||||
### 外服支持
|
||||
|
||||
目前国际服(美服)、日服、韩服、繁中服的绝大部分功能均已支持。但由于外服用户较少及项目人手不足,很多功能并没有进行全面的测试,所以请自行体验。<br>
|
||||
若您遇到了 Bug,或对某个功能有强需求,欢迎在 [Issues](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues) 和 [讨论区](https://github.com/MaaAssistantArknights/MaaAssistantArknights/discussions) 催更;或加入我们一起建设 MAA!请参考 [外服适配教程](#外服适配)
|
||||
目前国际服(美服)、日服、韩服、繁中服的绝大部分功能均已支持。但由于外服用户较少及项目人手不足,很多功能并没有进行全面的测试,所以请自行体验。
|
||||
若您遇到了 Bug,或对某个功能有强需求,欢迎在 [Issues](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues) 和 [讨论区](https://github.com/MaaAssistantArknights/MaaAssistantArknights/discussions) 催更;或加入我们一起建设 MAA!请参阅 [外服适配教程](#外服适配)
|
||||
|
||||
### CLI支持
|
||||
|
||||
MAA 支持命令行界面(CLI)操作,支持 Linux 和 macOS,可用于自动化脚本或在无图形界面的服务器上使用。请参考 [CLI 使用指南](./用户手册/CLI使用指南.md)
|
||||
MAA 支持命令行界面(CLI)操作,支持 Linux,macOS 和 Windows,可用于自动化脚本或在无图形界面的服务器上使用。请参阅 [CLI 使用指南](./用户手册/CLI使用指南.md)
|
||||
|
||||
## 加入我们
|
||||
|
||||
@@ -127,7 +126,7 @@ MAA 以中文(简体)为第一语言,翻译词条均以中文(简体)
|
||||
|
||||
### Linux | macOS
|
||||
|
||||
请参考 [Linux 编译教程](./开发文档/Linux编译教程.md)
|
||||
请参阅 [Linux 编译教程](./开发文档/Linux编译教程.md)
|
||||
|
||||
### API
|
||||
|
||||
@@ -147,7 +146,7 @@ MAA 以中文(简体)为第一语言,翻译词条均以中文(简体)
|
||||
|
||||
### 外服适配
|
||||
|
||||
请参考 [外服适配教程](./开发文档/外服适配教程.md),对于国服已支持的功能,绝大部分的外服适配工作仅需要截图 + 简单的 JSON 修改即可。
|
||||
请参阅 [外服适配教程](./开发文档/外服适配教程.md),对于国服已支持的功能,绝大部分的外服适配工作仅需要截图 + 简单的 JSON 修改即可。
|
||||
|
||||
### 想参与开发,但不太会用 GitHub?
|
||||
|
||||
@@ -155,7 +154,7 @@ MAA 以中文(简体)为第一语言,翻译词条均以中文(简体)
|
||||
|
||||
### Issue bot
|
||||
|
||||
请参考 [Issue bot 使用方法](./开发文档/IssueBot使用方法.md)
|
||||
请参阅 [Issue bot 使用方法](./开发文档/IssueBot使用方法.md)
|
||||
|
||||
## 致谢
|
||||
|
||||
@@ -184,7 +183,7 @@ MAA 以中文(简体)为第一语言,翻译词条均以中文(简体)
|
||||
### 数据源
|
||||
|
||||
- ~~公开招募数据:[明日方舟工具箱](https://www.bigfun.cn/tools/aktools/hr)~~
|
||||
- ~~干员及基建数据:[PRTS明日方舟中文WIKI](http://prts.wiki/)~~
|
||||
- ~~干员及基建数据:[PRTS Wiki](http://prts.wiki/)~~
|
||||
- 关卡数据:[企鹅物流数据统计](https://penguin-stats.cn/)
|
||||
- 游戏数据及资源:[明日方舟客户端素材](https://github.com/yuanyan3060/ArknightsGameResource)
|
||||
- ~~游戏数据:[《明日方舟》游戏数据](https://github.com/Kengxxiao/ArknightsGameData)~~
|
||||
@@ -197,17 +196,17 @@ MAA 以中文(简体)为第一语言,翻译词条均以中文(简体)
|
||||
|
||||
## 声明
|
||||
|
||||
- 本软件 logo 并非使用 AGPL 3.0 协议开源,[耗毛](https://weibo.com/u/3251357314)、vie 两位画师及软件全体开发者保留所有权利。不得以 AGPL 3.0 协议已授权为由在未经授权的情况下使用本软件 logo,不得在未经授权的情况下将本软件 logo 用于任何商业用途。
|
||||
- 本软件开源、免费,仅供学习交流使用。若您遇到商家使用本软件进行代练并收费,可能是设备与时间等费用,产生的问题及后果与本软件无关。
|
||||
- 本软件 logo 并非使用 AGPL 3.0 协议开源,[耗毛](https://weibo.com/u/3251357314)、vie 两位画师及软件全体开发者保留所有权利。不得以 AGPL 3.0 协议已授权为由在未经授权的情况下使用本软件 logo,不得在未经授权的情况下将本软件 logo 用于任何用途。
|
||||
- 本软件开源、免费,仅供学习交流使用。若您遇到商家使用本软件进行代练并收费,可能由于设备或时间等原因,产生的任何问题及后果与本软件无关。
|
||||
|
||||
## 广告
|
||||
|
||||
用户交流 QQ 群:[MAA 使用 & 粥游交流 QQ 群](https://ota.maa.plus/MaaAssistantArknights/api/qqgroup/index.html)<br>
|
||||
用户交流 TG 群:[Telegram 群](https://t.me/+Mgc2Zngr-hs3ZjU1)<br>
|
||||
自动战斗 JSON 作业分享:[prts.plus](https://prts.plus) 或 [抄作业.com](http://抄作业.com)<br>
|
||||
Bilibili 直播间:[直播间](https://live.bilibili.com/2808861) 每晚直播敲代码,近期很长一段时间应该都是在写本软件~<br>
|
||||
用户交流 QQ 群:[MAA 使用 & 粥游交流 QQ 群](https://ota.maa.plus/MaaAssistantArknights/api/qqgroup/index.html)
|
||||
用户交流 TG 群:[Telegram 群](https://t.me/+Mgc2Zngr-hs3ZjU1)
|
||||
自动战斗 JSON 作业分享:[prts.plus](https://prts.plus) 或 [抄作业.com](http://抄作业.com)
|
||||
Bilibili 直播间:[直播间](https://live.bilibili.com/2808861) 每晚直播敲代码,近期很长一段时间应该都是在写本软件~
|
||||
|
||||
技术群(舟无关、禁水):[内卷地狱!(QQ 群)](https://jq.qq.com/?_wv=1027&k=ypbzXcA2)<br>
|
||||
开发者群:[QQ 群](https://jq.qq.com/?_wv=1027&k=JM9oCk3C)<br>
|
||||
技术群(舟无关、禁水):[内卷地狱!(QQ 群)](https://jq.qq.com/?_wv=1027&k=ypbzXcA2)
|
||||
开发者群:[QQ 群](https://jq.qq.com/?_wv=1027&k=JM9oCk3C)
|
||||
|
||||
如果觉得软件对你有帮助,帮忙点个 Star 吧!~(网页最上方右上角的小星星),这就是对我们最大的支持了!
|
||||
|
||||
@@ -74,7 +74,7 @@ icon: ic:baseline-article
|
||||
|
||||
#### 自定義基建換班(測試功能)
|
||||
|
||||
- 一圖流的大佬們幫忙寫了一個 [排班產生器](https://yituliu.site/riicCal/),可參考 [基建排班協議](3.6-基建排班協議.md) 使用。
|
||||
- 一圖流的大佬們幫忙寫了一個 [排班產生器](https://ark.yituliu.cn/tools/schedule),可參考 [基建排班協議](3.6-基建排班協議.md) 使用。
|
||||
- 在 MAA 資料夾 `/resource/custom_infrast/` 下內建了幾套極限效率的作業,可用作參考。(全幹員且精二大佬可以試著直接用)
|
||||
|
||||
### 一鍵長草:獲取信用及購物
|
||||
@@ -134,7 +134,7 @@ icon: ic:baseline-article
|
||||
- **自動公招和公招辨識是兩個獨立的功能!**
|
||||
- 自動公招支援使用 `加急許可`,全自動連續公招!請進入 `任務設定` - `自動公招` 中選擇 `自動使用加急許可` ,並修改 `每次執行時最大招募次數` 。
|
||||
- 出 1、5、6 星都會彈出通知提示。
|
||||
- 自動公招時自動選取數據上傳 [企鵝物流數據統計](https://penguin-stats.io/) 和 [材料一圖流](https://yituliu.site/)。
|
||||
- 自動公招時自動選取數據上傳 [企鵝物流數據統計](https://penguin-stats.io/) 和 [材料一圖流](https://ark.yituliu.cn/)。
|
||||
|
||||
### 倉庫辨識(測試功能)
|
||||
|
||||
|
||||
@@ -98,11 +98,11 @@ icon: ph:question-fill
|
||||
|
||||
## 連接正常,但是無操作
|
||||
|
||||
部分模擬器內建的 `adb` 版本過於老舊,不支援 `Minitouch` 相關操作。<br>
|
||||
部分模擬器內建的 `adb` 版本過於老舊,不支援 `Minitouch` 相關操作。
|
||||
|
||||
請使用系統管理員身分打開 MAA,點擊 `MAA 設定` - `連接設定` - `強制替換 ADB`。(建議關閉模擬器、重開 MAA 後再操作,否則可能替換失敗)<br>
|
||||
請使用系統管理員身分打開 MAA,點擊 `MAA 設定` - `連接設定` - `強制替換 ADB`。(建議關閉模擬器、重開 MAA 後再操作,否則可能替換失敗)
|
||||
|
||||
模擬器更新後可能會重新覆蓋 adb 檔案。若更新後問題復現,請再次嘗試替換。<br>
|
||||
模擬器更新後可能會重新覆蓋 adb 檔案。若更新後問題復現,請再次嘗試替換。
|
||||
|
||||
如果這樣也無法正常使用,可將 `連接設定` - `觸控模式` 從 `Minitouch` 切換到 `MaaTouch` 再次嘗試。由於 `Adb Input` 操作過於緩慢,請僅將其作為萬不得已的模式。
|
||||
|
||||
@@ -142,14 +142,14 @@ Pie64_2 核心:(核心名稱後的數字代表這是一個多開核心)
|
||||
MAA 現在會嘗試從註冊表中讀取 `bluestacks.conf` 的儲存位置,當該功能失效或出錯時,你需要手動指定配置檔案路徑
|
||||
:::
|
||||
|
||||
1. 在藍疊模擬器的數據目錄下找到 `bluestacks.conf` 這個檔案<br>
|
||||
1. 在藍疊模擬器的數據目錄下找到 `bluestacks.conf` 這個檔案
|
||||
|
||||
- 國際版預設路徑為 `C:\ProgramData\BlueStacks_nxt\bluestacks.conf`
|
||||
- 中國內地版預設路徑為 `C:\ProgramData\BlueStacks_nxt_cn\bluestacks.conf`
|
||||
|
||||
2. 如果是第一次使用,請開啟一次 MAA,會在 MAA 的 `config` 目錄下產生 `gui.json`。
|
||||
|
||||
3. **先關閉** MAA,**然後** 打開 `gui.json`,找到 `Configurations` 下的目前配置名欄位(可在 設定 - 切換配置 中查看,預設為 `Default`),在其中新增一個欄位 `Bluestacks.Config.Path`,填入 `bluestacks.conf` 的完整路徑。(注意斜槓要用轉義 `\\`)<br>
|
||||
3. **先關閉** MAA,**然後** 打開 `gui.json`,找到 `Configurations` 下的目前配置名欄位(可在 設定 - 切換配置 中查看,預設為 `Default`),在其中新增一個欄位 `Bluestacks.Config.Path`,填入 `bluestacks.conf` 的完整路徑。(注意斜槓要用轉義 `\\`)
|
||||
|
||||
::: details 範例
|
||||
以 `C:\ProgramData\BlueStacks_nxt\bluestacks.conf` 為例
|
||||
@@ -174,7 +174,7 @@ MAA 現在會嘗試從註冊表中讀取 `bluestacks.conf` 的儲存位置,當
|
||||
|
||||
## 檔案下載速度慢
|
||||
|
||||
請嘗試使用 [MAA 下載站](https://ota.maa.plus/MaaAssistantArknights/MaaRelease/releases/download/) 下載。<br>
|
||||
請嘗試使用 [MAA 下載站](https://ota.maa.plus/MaaAssistantArknights/MaaRelease/releases/download/) 下載。
|
||||
|
||||
我們的小水管頻寬較低,且流量有限。雖然搭出來就是給大家用的,但也希望不要濫用,若 github 或其他鏡像站可正常下載,建議優先選擇。
|
||||
|
||||
|
||||
@@ -21,7 +21,7 @@ icon: iconoir:developer
|
||||
|
||||
4. 下載預構建的第三方庫
|
||||
|
||||
**需要有 Python 環境,請自行搜尋 Python 安裝教學**<br>
|
||||
**需要有 Python 環境,請自行搜尋 Python 安裝教學**
|
||||
_(maadeps-download.py 檔案在項目根目錄)_
|
||||
|
||||
```cmd
|
||||
@@ -39,7 +39,7 @@ icon: iconoir:developer
|
||||
- 右鍵 `MaaWpfGui` - 屬性 - 偵錯 - 啟用本地偵錯(這樣就能把斷點掛到 C++ Core 那邊了)
|
||||
|
||||
8. 到這裡,你就可以愉快地~~瞎ㄐㄅ改~~發電了
|
||||
9. 開發過程中,每一定數量,記得提交一個 commit,別忘了寫上 message<br>
|
||||
9. 開發過程中,每一定數量,記得提交一個 commit,別忘了寫上 message
|
||||
假如你不熟悉 git 的使用,你可能想要新建一個分支進行更改,而不是直接提交在 `dev` 上
|
||||
|
||||
```bash
|
||||
|
||||
@@ -13,8 +13,8 @@ Pull Request 被增加 `ambiguous` 標籤是因為沒有按照 commitizen 規則
|
||||
|
||||
### 自動觸發
|
||||
|
||||
- 給 issue 和 Pull Request 增加標籤,包括 `module` 系列 、`Client` 系列、`ambiguous`、`translation required` 等。<br>
|
||||
Issue Bot 會根據關鍵字自動增加分類標籤。<br>
|
||||
- 給 issue 和 Pull Request 增加標籤,包括 `module` 系列 、`Client` 系列、`ambiguous`、`translation required` 等。
|
||||
Issue Bot 會根據關鍵字自動增加分類標籤。
|
||||
具體關鍵字可以參考 [配置檔案](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/.github/issue-checker.yml)。
|
||||
- 給作者是可見性設定為 public 的 MAA 成員的 issue 和 Pull Request 增加 `MAA Team` 標籤。
|
||||
|
||||
@@ -31,7 +31,7 @@ Issue Bot 會對 Pull Request 標題的格式進行簡單審查。它會增加 `
|
||||
|
||||
### 手動觸發
|
||||
|
||||
多使用關鍵字詳細描述問題來自動觸發分類標籤,少使用下列指令。<br>
|
||||
多使用關鍵字詳細描述問題來自動觸發分類標籤,少使用下列指令。
|
||||
但 **當你知道自己的行為會導致 Issue Bot 誤解時除外**。
|
||||
|
||||
#### Issue 及 Pull Request
|
||||
@@ -45,7 +45,7 @@ Issue Bot 會對 Pull Request 標題的格式進行簡單審查。它會增加 `
|
||||
|
||||
- `Skip {LABEL_NAME}` 可以保證不增加標籤。
|
||||
- `Skip labels` 可以保證不增加任何標籤。
|
||||
- 以下幾種方法可以為 issue 增加 `fixed` 標籤:<sup>1</sup><br>
|
||||
- 以下幾種方法可以為 issue 增加 `fixed` 標籤:<sup>1</sup>
|
||||
- `https://github.com/MaaAssistantArknights/MaaAssistantArknights/commit/{COMMIT_HASH} fixed`
|
||||
- `fixed by https://github.com/MaaAssistantArknights/MaaAssistantArknights/commit/{COMMIT_HASH}`
|
||||
- `{VERSION} fixed`
|
||||
@@ -54,7 +54,7 @@ Issue Bot 會對 Pull Request 標題的格式進行簡單審查。它會增加 `
|
||||
- **當你知道自己的 issue 評論會導致 Issue Bot 誤解時,盡量添加一些 skip 操作。**
|
||||
|
||||
::: info 注意
|
||||
這裡的 COMMIT_HASH 需要完整的 40 位
|
||||
<sup>1</sup> 這裡的 COMMIT_HASH 需要完整的 40 位
|
||||
:::
|
||||
|
||||
#### 推送(Push)
|
||||
|
||||
@@ -6,7 +6,7 @@ icon: mingcute:git-pull-request-fill
|
||||
牛牛也能看懂的 GitHub Pull Request 使用指南 (\*´▽`)ノノ
|
||||
|
||||
::: warning
|
||||
本教學中對很多概念進行了簡化,為了讓更多朋友能實際用起來,甚至有一些很不優雅~~但是簡單~~的操作,還有一些不那麽正確的解釋,還請大佬們輕噴。<br>
|
||||
本教學中對很多概念進行了簡化,為了讓更多朋友能實際用起來,甚至有一些很不優雅~~但是簡單~~的操作,還有一些不那麽正確的解釋,還請大佬們輕噴。
|
||||
若您有一定的 git 使用經驗及程式基礎,~~那你還看個~~🔨,可以看稍微進階一點的教學 [Github Pull Request 流程簡述](2.2-開發相關.md)
|
||||
:::
|
||||
|
||||
@@ -24,18 +24,18 @@ icon: mingcute:git-pull-request-fill
|
||||
|
||||
### Fork(複製)
|
||||
|
||||
複製,字面意思,將 MAA 的代碼複製一份,然後可以進行後續修改等等的操作,避免把原來的弄壞了<br>
|
||||
複製,字面意思,將 MAA 的代碼複製一份,然後可以進行後續修改等等的操作,避免把原來的弄壞了
|
||||
但一般說中文 “複製” 我們可能首先想到的是 copy 的意思,fork 也沒有其他明確的翻譯,所以我們一般習慣直接說英文,比如 “把代碼 fork 一份走”
|
||||
|
||||
既然是複製後的,那就是 `MAA (1)`(bushi)<br>
|
||||
為了和原本的倉庫區分開,所以我們一般將原本的 MAA 倉庫稱為 “主倉庫”、“upstream (上遊倉庫)”、“origin (原倉庫)”;<br>
|
||||
既然是複製後的,那就是 `MAA (1)`(bushi)
|
||||
為了和原本的倉庫區分開,所以我們一般將原本的 MAA 倉庫稱為 “主倉庫”、“upstream (上遊倉庫)”、“origin (原倉庫)”;
|
||||
因為每個人都可以自己複製一份走,所以複製後的稱之為 “個人倉庫”
|
||||
|
||||

|
||||
|
||||
### Pull Request(拉取請求、合併請求)
|
||||
|
||||
簡稱 PR,“拉取請求” 這個太直譯了,聽起來很奇怪,~~而且字太多了打起來太累~~,所以也是一樣的大家一般就直接說: “來個 PR”<br>
|
||||
簡稱 PR,“拉取請求” 這個太直譯了,聽起來很奇怪,~~而且字太多了打起來太累~~,所以也是一樣的大家一般就直接說: “來個 PR”
|
||||
書接上文,你 fork(複製)的個人倉庫,修改完了,怎麽把內容提供給主倉庫呢?這時候我們就可以開一個 PR,申請將自己修改的內容加入到主倉庫中。
|
||||
|
||||
當然啦,既然是 “請求”,那自然是需要審批的,MAA Team 的各位可能會針對你的修改提一些意見等,當然我們的意見也不一定完全正確,大家合理討論 ~
|
||||
@@ -46,9 +46,9 @@ icon: mingcute:git-pull-request-fill
|
||||
|
||||
### Conflict(衝突)
|
||||
|
||||
假設一下,主倉庫中有個 A 檔案,它的內容是 111<br>
|
||||
你 fork 了一份,將其內容改成了 222,但是你剛準備提交 PR,這時候張三也 fork 了一份並提交了 PR,並將 A 檔案改成了 333<br>
|
||||
這時候我們就會看到,你倆都修改了 A 檔案,並且修改的不同,那聽誰的好呢?這就是 Conflict(衝突)<br>
|
||||
假設一下,主倉庫中有個 A 檔案,它的內容是 111
|
||||
你 fork 了一份,將其內容改成了 222,但是你剛準備提交 PR,這時候張三也 fork 了一份並提交了 PR,並將 A 檔案改成了 333
|
||||
這時候我們就會看到,你倆都修改了 A 檔案,並且修改的不同,那聽誰的好呢?這就是 Conflict(衝突)
|
||||
衝突解決起來比較麻煩,這裡僅闡述概念,方便實際遇到時能理解發生了什麽,暫不闡述解決方案
|
||||
|
||||
## 純網頁端 PR 操作全流程
|
||||
@@ -83,27 +83,27 @@ icon: mingcute:git-pull-request-fill
|
||||

|
||||
|
||||
9. 還有第二個檔案要改的?改完了發現弄錯了想再改改?都沒關係!重複 5-8 即可!
|
||||
10. 全改好了進行 PR !直接點 **個人倉庫** 裡的 Pull Request 標籤頁<br>
|
||||
10. 全改好了進行 PR !直接點 **個人倉庫** 裡的 Pull Request 標籤頁
|
||||
如果有 Compare & Pull Request 按鈕,那最好,直接點他!如果沒有也不用著急,點下面的 New Pull Request 也是一樣的(請看步驟 11)
|
||||
|
||||

|
||||
|
||||
11. 這時候來到了主倉庫,請核對一下你要 PR 的是否確認。<br>
|
||||
如圖中,中間有個向左的箭頭,是將右邊的 個人姓名/MAA 的 dev 分支,申請合併到 主倉庫/MAA 的 dev 分支。<br>
|
||||
11. 這時候來到了主倉庫,請核對一下你要 PR 的是否確認。
|
||||
如圖中,中間有個向左的箭頭,是將右邊的 個人姓名/MAA 的 dev 分支,申請合併到 主倉庫/MAA 的 dev 分支。
|
||||
然後寫一下標題,你修改的具體內容等等的,然後點確認
|
||||
|
||||

|
||||
|
||||
12. 等待 MAA Team 的大佬們審核吧!當然他們也可能會提意見<br>
|
||||
12. 等待 MAA Team 的大佬們審核吧!當然他們也可能會提意見
|
||||
👇 比如(純屬娛樂切勿當真)
|
||||

|
||||
|
||||
13. 如果大佬們說要再修改一些小問題的話,回到 **你的個人倉庫**,切換到先前的 dev 分支,重複 步驟 3-9 即可!<br>
|
||||
注意不需要操作步驟 2(重新 fork),也不需要操作步驟 10(重新 Pull Request),你目前的 Pull Request 仍處於待審核狀態,後續的修改會直接進入到這個 Pull Request 中<br>
|
||||
13. 如果大佬們說要再修改一些小問題的話,回到 **你的個人倉庫**,切換到先前的 dev 分支,重複 步驟 3-9 即可!
|
||||
注意不需要操作步驟 2(重新 fork),也不需要操作步驟 10(重新 Pull Request),你目前的 Pull Request 仍處於待審核狀態,後續的修改會直接進入到這個 Pull Request 中
|
||||
👇 比如可以看到最下面多了一條 “重新修改演示” 的內容
|
||||

|
||||
|
||||
14. 等大佬們審批通過,就全部完成啦!**版本發布後**,你的 GitHub 頭像將會自動進入到貢獻者列表名單中,非常感謝各位的無私奉獻!<br>
|
||||
14. 等大佬們審批通過,就全部完成啦!**版本發布後**,你的 GitHub 頭像將會自動進入到貢獻者列表名單中,非常感謝各位的無私奉獻!
|
||||
~~怎麽全是二次元啊,哦我也是啊,那沒事了~~
|
||||
::: tip 貢獻 / 參與者
|
||||
感謝所有參與到開發 / 測試中的朋友們,是大家的幫助讓 MAA 越來越好! (*´▽`)ノノ
|
||||
@@ -111,11 +111,11 @@ icon: mingcute:git-pull-request-fill
|
||||
[](https://github.com/MaaAssistantArknights/MaaAssistantArknights/graphs/contributors)
|
||||
:::
|
||||
|
||||
16. 下次如果還想提別的 PR,請先切換到 dev 分支,然後直接如下圖操作<br>
|
||||
16. 下次如果還想提別的 PR,請先切換到 dev 分支,然後直接如下圖操作
|
||||
::: warning
|
||||
這個操作會強制將你的個人倉庫同步到和主倉庫一模一樣的狀態,這是最簡單粗暴但行之有效的解決衝突的方法。但如果你的個人倉庫已經有額外的編輯了,會被直接刪掉!
|
||||
:::
|
||||
如果確定不會造成衝突,請使用右側綠色的 `Update Branch` 按鈕<br>
|
||||
如果確定不會造成衝突,請使用右側綠色的 `Update Branch` 按鈕
|
||||
|
||||
如果你不清楚 / 不 care 我上面說的這一大堆,也請點擊左側的按鈕
|
||||
|
||||
|
||||
@@ -19,23 +19,23 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
|
||||
#### 返回值
|
||||
|
||||
- `AsstTaskId`<br>
|
||||
若添加成功,返回該任務 ID,可用於後續設定任務參數;<br>
|
||||
- `AsstTaskId`
|
||||
若添加成功,返回該任務 ID,可用於後續設定任務參數;
|
||||
若添加失敗,返回 0
|
||||
|
||||
#### 參數說明
|
||||
|
||||
- `AsstHandle handle`<br>
|
||||
- `AsstHandle handle`
|
||||
實例句柄
|
||||
- `const char* type`<br>
|
||||
- `const char* type`
|
||||
任務類型
|
||||
- `const char* params`<br>
|
||||
- `const char* params`
|
||||
任務參數,json string
|
||||
|
||||
##### 任務類型一覽
|
||||
|
||||
- `StartUp`<br>
|
||||
開始喚醒<br>
|
||||
- `StartUp`
|
||||
開始喚醒
|
||||
|
||||
```json
|
||||
// 對應的任務參數
|
||||
@@ -51,8 +51,8 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `CloseDown`<br>
|
||||
關閉遊戲<br>
|
||||
- `CloseDown`
|
||||
關閉遊戲
|
||||
|
||||
```json
|
||||
// 對應的任務參數
|
||||
@@ -61,7 +61,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Fight`<br>
|
||||
- `Fight`
|
||||
刷理智
|
||||
|
||||
```json
|
||||
@@ -96,7 +96,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
|
||||
另支援少部分資源關卡名請參考[集成範例](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/dev/tools/AutoLocalization/example/zh-cn.xaml#L260)
|
||||
|
||||
- `Recruit`<br>
|
||||
- `Recruit`
|
||||
公開招募
|
||||
|
||||
```json
|
||||
@@ -136,7 +136,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Infrast`<br>
|
||||
- `Infrast`
|
||||
基建換班
|
||||
|
||||
```json
|
||||
@@ -166,8 +166,8 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Mall`<br>
|
||||
領取信用及商店購物。<br>
|
||||
- `Mall`
|
||||
領取信用及商店購物。
|
||||
會先有序的按 `buy_first` 購買一遍,再從左到右並避開 `blacklist` 購買第二遍,在信用溢出時則會無視黑名單,從左到右購買第三遍直到不再溢出
|
||||
|
||||
```json
|
||||
@@ -189,7 +189,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Award`<br>
|
||||
- `Award`
|
||||
領取日常獎勵
|
||||
|
||||
```json
|
||||
@@ -199,7 +199,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Roguelike`<br>
|
||||
- `Roguelike`
|
||||
無限刷肉鴿
|
||||
|
||||
```json
|
||||
@@ -228,7 +228,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Copilot`<br>
|
||||
- `Copilot`
|
||||
自動抄作業
|
||||
|
||||
```json
|
||||
@@ -241,7 +241,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
|
||||
作業 JSON 請參考 [3.3-戰鬥流程協議](./3.3-戰鬥流程協議.md)
|
||||
|
||||
- `SSSCopilot`<br>
|
||||
- `SSSCopilot`
|
||||
自動抄保全作業
|
||||
|
||||
```json
|
||||
@@ -254,7 +254,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
|
||||
保全作業 JSON 請參考 [3.7-保全派駐協議](./3.7-保全派駐協議.md)
|
||||
|
||||
- `Depot`<br>
|
||||
- `Depot`
|
||||
倉庫辨識
|
||||
|
||||
```json
|
||||
@@ -264,7 +264,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `OperBox`<br>
|
||||
- `OperBox`
|
||||
幹員 box 辨識
|
||||
|
||||
```json
|
||||
@@ -274,7 +274,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `ReclamationAlgorithm`<br>
|
||||
- `ReclamationAlgorithm`
|
||||
生息演算
|
||||
|
||||
```json
|
||||
@@ -289,7 +289,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Custom`<br>
|
||||
- `Custom`
|
||||
|
||||
自定義任務
|
||||
|
||||
@@ -304,7 +304,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `SingleStep`<br>
|
||||
- `SingleStep`
|
||||
|
||||
單步任務(目前僅支援戰鬥)
|
||||
|
||||
@@ -323,7 +323,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `VideoRecognition`<br>
|
||||
- `VideoRecognition`
|
||||
|
||||
影片辨識,目前僅支援作業(作戰)影片
|
||||
|
||||
@@ -348,17 +348,17 @@ bool ASSTAPI AsstSetTaskParams(AsstHandle handle, AsstTaskId id, const char* par
|
||||
|
||||
#### 返回值
|
||||
|
||||
- `bool`<br>
|
||||
- `bool`
|
||||
返回是否設定成功
|
||||
|
||||
#### 參數說明
|
||||
|
||||
- `AsstHandle handle`<br>
|
||||
- `AsstHandle handle`
|
||||
實例句柄
|
||||
- `AsstTaskId task`<br>
|
||||
- `AsstTaskId task`
|
||||
任務 ID, `AsstAppendTask` 接口的返回值
|
||||
- `const char* params`<br>
|
||||
任務參數,json string,與 `AsstAppendTask` 接口相同。<br>
|
||||
- `const char* params`
|
||||
任務參數,json string,與 `AsstAppendTask` 接口相同。
|
||||
未標注 “不支援執行中設定” 的欄位都支援實時修改;否則若當前任務正在執行,會忽略對應的欄位
|
||||
|
||||
### `AsstSetStaticOption`
|
||||
@@ -375,14 +375,14 @@ bool ASSTAPI AsstSetStaticOption(AsstStaticOptionKey key, const char* value);
|
||||
|
||||
#### 返回值
|
||||
|
||||
- `bool`<br>
|
||||
- `bool`
|
||||
返回是否設定成功
|
||||
|
||||
#### 參數說明
|
||||
|
||||
- `AsstStaticOptionKey key`<br>
|
||||
- `AsstStaticOptionKey key`
|
||||
鍵
|
||||
- `const char* value`<br>
|
||||
- `const char* value`
|
||||
值
|
||||
|
||||
##### 鍵值一覽
|
||||
@@ -403,16 +403,16 @@ bool ASSTAPI AsstSetInstanceOption(AsstHandle handle, AsstInstanceOptionKey key,
|
||||
|
||||
#### 返回值
|
||||
|
||||
- `bool`<br>
|
||||
- `bool`
|
||||
返回是否設定成功
|
||||
|
||||
#### 參數說明
|
||||
|
||||
- `AsstHandle handle`<br>
|
||||
- `AsstHandle handle`
|
||||
實例句柄
|
||||
- `AsstInstanceOptionKey key`<br>
|
||||
- `AsstInstanceOptionKey key`
|
||||
鍵
|
||||
- `const char* value`<br>
|
||||
- `const char* value`
|
||||
值
|
||||
|
||||
##### 鍵值一覽
|
||||
|
||||
@@ -15,7 +15,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
|
||||
## 參數總覽
|
||||
|
||||
- `int msg`<br>
|
||||
- `int msg`
|
||||
消息類型
|
||||
|
||||
```cpp
|
||||
@@ -44,9 +44,9 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
};
|
||||
```
|
||||
|
||||
- `const char* details`<br>
|
||||
- `const char* details`
|
||||
消息詳情,json 字符串,詳見 [欄位解釋](#欄位解釋)
|
||||
- `void* custom_arg`<br>
|
||||
- `void* custom_arg`
|
||||
調用方自定義參數,會原樣傳出 `AsstCreateEx` 接口中的 `custom_arg` 參數,C 系語言可利用該參數傳出 `this` 指針
|
||||
|
||||
## 欄位解釋
|
||||
@@ -82,25 +82,25 @@ Todo
|
||||
|
||||
### 常見 `What` 欄位
|
||||
|
||||
- `ConnectFailed`<br>
|
||||
- `ConnectFailed`
|
||||
連接失敗
|
||||
- `Connected`<br>
|
||||
- `Connected`
|
||||
已連接,注意此時的 `uuid` 欄位值為空(下一步才是獲取)
|
||||
- `UuidGot`<br>
|
||||
- `UuidGot`
|
||||
已獲取到設備唯一碼
|
||||
- `UnsupportedResolution`<br>
|
||||
- `UnsupportedResolution`
|
||||
解析度不被支援
|
||||
- `ResolutionError`<br>
|
||||
- `ResolutionError`
|
||||
解析度獲取錯誤
|
||||
- `Reconnecting`<br>
|
||||
- `Reconnecting`
|
||||
連接斷開(adb / 模擬器 炸了),正在重連
|
||||
- `Reconnected`<br>
|
||||
- `Reconnected`
|
||||
連接斷開(adb / 模擬器 炸了),重連成功
|
||||
- `Disconnect`<br>
|
||||
- `Disconnect`
|
||||
連接斷開(adb / 模擬器 炸了),並重試失敗
|
||||
- `ScreencapFailed`<br>
|
||||
- `ScreencapFailed`
|
||||
截圖失敗(adb / 模擬器 炸了),並重試失敗
|
||||
- `TouchModeNotAvailable`<br>
|
||||
- `TouchModeNotAvailable`
|
||||
不支援的觸控模式
|
||||
|
||||
### AsyncCallInfo
|
||||
@@ -132,39 +132,39 @@ Todo
|
||||
|
||||
#### 常見 `taskchain` 欄位
|
||||
|
||||
- `StartUp`<br>
|
||||
- `StartUp`
|
||||
開始喚醒
|
||||
- `CloseDown`<br>
|
||||
- `CloseDown`
|
||||
關閉遊戲
|
||||
- `Fight`<br>
|
||||
- `Fight`
|
||||
刷理智
|
||||
- `Mall`<br>
|
||||
- `Mall`
|
||||
信用點及購物
|
||||
- `Recruit`<br>
|
||||
- `Recruit`
|
||||
自動公招
|
||||
- `Infrast`<br>
|
||||
- `Infrast`
|
||||
基建換班
|
||||
- `Award`<br>
|
||||
- `Award`
|
||||
領取日常獎勵
|
||||
- `Roguelike`<br>
|
||||
- `Roguelike`
|
||||
無限刷肉鴿
|
||||
- `Copilot`<br>
|
||||
- `Copilot`
|
||||
自動抄作業
|
||||
- `SSSCopilot`<br>
|
||||
- `SSSCopilot`
|
||||
自動抄保全作業
|
||||
- `Depot`<br>
|
||||
- `Depot`
|
||||
倉庫辨識
|
||||
- `OperBox`<br>
|
||||
- `OperBox`
|
||||
幹員 box 辨識
|
||||
- `ReclamationAlgorithm`<br>
|
||||
- `ReclamationAlgorithm`
|
||||
生息演算
|
||||
- `Custom`<br>
|
||||
- `Custom`
|
||||
自定義任務
|
||||
- `SingleStep`<br>
|
||||
- `SingleStep`
|
||||
單步任務
|
||||
- `VideoRecognition`<br>
|
||||
- `VideoRecognition`
|
||||
影片辨識任務
|
||||
- `Debug`<br>
|
||||
- `Debug`
|
||||
偵錯
|
||||
|
||||
### TaskChain 相關消息
|
||||
@@ -196,7 +196,7 @@ Todo
|
||||
|
||||
#### 常見 `subtask` 欄位
|
||||
|
||||
- `ProcessTask`<br>
|
||||
- `ProcessTask`
|
||||
|
||||
```json
|
||||
// 對應的 details 欄位舉例
|
||||
@@ -213,49 +213,49 @@ Todo
|
||||
|
||||
##### 常見 `task` 欄位
|
||||
|
||||
- `StartButton2`<br>
|
||||
- `StartButton2`
|
||||
開始戰鬥
|
||||
- `MedicineConfirm`<br>
|
||||
- `MedicineConfirm`
|
||||
使用理智藥
|
||||
- `ExpiringMedicineConfirm`<br>
|
||||
- `ExpiringMedicineConfirm`
|
||||
使用 48 小時內過期的理智藥
|
||||
- `StoneConfirm`<br>
|
||||
- `StoneConfirm`
|
||||
碎石
|
||||
- `RecruitRefreshConfirm`<br>
|
||||
- `RecruitRefreshConfirm`
|
||||
公招刷新標籤
|
||||
- `RecruitConfirm`<br>
|
||||
- `RecruitConfirm`
|
||||
公招確認招募
|
||||
- `RecruitNowConfirm`<br>
|
||||
- `RecruitNowConfirm`
|
||||
公招使用加急許可
|
||||
- `ReportToPenguinStats`<br>
|
||||
- `ReportToPenguinStats`
|
||||
匯報到企鵝數據統計
|
||||
- `ReportToYituliu`<br>
|
||||
- `ReportToYituliu`
|
||||
匯報到一圖流大數據
|
||||
- `InfrastDormDoubleConfirmButton`<br>
|
||||
- `InfrastDormDoubleConfirmButton`
|
||||
基建宿舍的二次確認按鈕,僅當幹員衝突時才會有,請提示用戶
|
||||
- `StartExplore`<br>
|
||||
- `StartExplore`
|
||||
肉鴿開始探索
|
||||
- `StageTraderInvestConfirm`<br>
|
||||
- `StageTraderInvestConfirm`
|
||||
肉鴿投資了源石錠
|
||||
- `StageTraderInvestSystemFull`<br>
|
||||
- `StageTraderInvestSystemFull`
|
||||
肉鴿投資達到了遊戲上限
|
||||
- `ExitThenAbandon`<br>
|
||||
- `ExitThenAbandon`
|
||||
肉鴿放棄了本次探索
|
||||
- `MissionCompletedFlag`<br>
|
||||
- `MissionCompletedFlag`
|
||||
肉鴿戰鬥完成
|
||||
- `MissionFailedFlag`<br>
|
||||
- `MissionFailedFlag`
|
||||
肉鴿戰鬥失敗
|
||||
- `StageTraderEnter`<br>
|
||||
- `StageTraderEnter`
|
||||
肉鴿關卡:詭異行商
|
||||
- `StageSafeHouseEnter`<br>
|
||||
- `StageSafeHouseEnter`
|
||||
肉鴿關卡:安全的角落
|
||||
- `StageEncounterEnter`<br>
|
||||
- `StageEncounterEnter`
|
||||
肉鴿關卡:不期而遇 / 古堡饋贈
|
||||
- `StageCombatDpsEnter`<br>
|
||||
- `StageCombatDpsEnter`
|
||||
肉鴿關卡:普通作戰
|
||||
- `StageEmergencyDps`<br>
|
||||
- `StageEmergencyDps`
|
||||
肉鴿關卡:緊急作戰
|
||||
- `StageDreadfulFoe`<br>
|
||||
- `StageDreadfulFoe`
|
||||
肉鴿關卡:險路惡敵
|
||||
- `StartGameTask`
|
||||
打開用戶端失敗(配置檔案與傳入 client_type 不匹配)
|
||||
@@ -275,7 +275,7 @@ Todo
|
||||
|
||||
#### 常見 `what` 及 `details` 欄位
|
||||
|
||||
- `StageDrops`<br>
|
||||
- `StageDrops`
|
||||
關卡材料掉落資訊
|
||||
|
||||
```json
|
||||
@@ -326,7 +326,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitTagsDetected`<br>
|
||||
- `RecruitTagsDetected`
|
||||
公招辨識到了 Tags
|
||||
|
||||
```json
|
||||
@@ -342,7 +342,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitSpecialTag`<br>
|
||||
- `RecruitSpecialTag`
|
||||
公招辨識到了特殊 Tag
|
||||
|
||||
```json
|
||||
@@ -352,7 +352,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitResult`<br>
|
||||
- `RecruitResult`
|
||||
公招辨識結果
|
||||
|
||||
```json
|
||||
@@ -429,7 +429,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitTagsRefreshed`<br>
|
||||
- `RecruitTagsRefreshed`
|
||||
公招刷新了 Tags
|
||||
|
||||
```json
|
||||
@@ -440,7 +440,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitNoPermit`<br>
|
||||
- `RecruitNoPermit`
|
||||
公招無招聘許可
|
||||
|
||||
```json
|
||||
@@ -451,7 +451,7 @@ Todo
|
||||
```
|
||||
|
||||
|
||||
- `RecruitTagsSelected`<br>
|
||||
- `RecruitTagsSelected`
|
||||
公招選擇了 Tags
|
||||
|
||||
```json
|
||||
@@ -464,13 +464,13 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitSlotCompleted`<br>
|
||||
- `RecruitSlotCompleted`
|
||||
當前公招槽位任務完成
|
||||
|
||||
- `RecruitError`<br>
|
||||
- `RecruitError`
|
||||
公招辨識錯誤
|
||||
|
||||
- `EnterFacility`<br>
|
||||
- `EnterFacility`
|
||||
基建進入了設施
|
||||
|
||||
```json
|
||||
@@ -481,7 +481,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `NotEnoughStaff`<br>
|
||||
- `NotEnoughStaff`
|
||||
基建可用幹員不足
|
||||
|
||||
```json
|
||||
@@ -492,7 +492,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `ProductOfFacility`<br>
|
||||
- `ProductOfFacility`
|
||||
基建產物
|
||||
|
||||
```json
|
||||
@@ -504,7 +504,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `StageInfo`<br>
|
||||
- `StageInfo`
|
||||
自動作戰關卡資訊
|
||||
|
||||
```json
|
||||
@@ -514,10 +514,10 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `StageInfoError`<br>
|
||||
- `StageInfoError`
|
||||
自動作戰關卡辨識錯誤
|
||||
|
||||
- `PenguinId`<br>
|
||||
- `PenguinId`
|
||||
企鵝物流 ID
|
||||
|
||||
```json
|
||||
@@ -527,7 +527,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `Depot`<br>
|
||||
- `Depot`
|
||||
倉庫辨識結果
|
||||
|
||||
```json
|
||||
@@ -567,7 +567,7 @@ Todo
|
||||
// 目前只支援 ArkPlanner 和 Lolicon 的格式,以後可能會兼容更多網站
|
||||
```
|
||||
|
||||
- `OperBox`<br>
|
||||
- `OperBox`
|
||||
幹員辨識結果
|
||||
|
||||
```json
|
||||
@@ -615,5 +615,5 @@ Todo
|
||||
]
|
||||
```
|
||||
|
||||
- `UnsupportedLevel`<br>
|
||||
- `UnsupportedLevel`
|
||||
自動抄作業,不支援的關卡名
|
||||
|
||||
@@ -144,5 +144,6 @@ icon: material-symbols:view-quilt-rounded
|
||||
|
||||
## 範例檔案
|
||||
|
||||
[243 極限效率,一天三換](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/243_layout_3_times_a_day.json)<br>
|
||||
[153 極限效率,一天三換](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/153_layout_3_times_a_day.json)<br>
|
||||
[243 極限效率,一天三換](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/243_layout_3_times_a_day.json)
|
||||
|
||||
[153 極限效率,一天三換](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/153_layout_3_times_a_day.json)
|
||||
|
||||
@@ -139,5 +139,6 @@ icon: game-icons:prisoner
|
||||
|
||||
## 範例檔案
|
||||
|
||||
[SSS_阿卡胡拉叢林.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_阿卡胡拉丛林.json)<br>
|
||||
[SSS_阿卡胡拉叢林.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_阿卡胡拉丛林.json)
|
||||
|
||||
[SSS_多索雷斯在建地塊.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_多索雷斯在建地块.json)
|
||||
|
||||
@@ -37,7 +37,7 @@ MAA 的意思是 MAA Assistant Arknights
|
||||
|
||||
- 刷理智,掉落辨識及上傳 [企鵝物流數據統計](https://penguin-stats.io/);
|
||||
- 智能基建換班,自動計算幹員效率,單設施內最優解;同時也支援 [自定義排班](./3.6-基建排班協議.md);
|
||||
- 自動公招,可選使用加急許可,一次全部刷完!公招數據上傳 [企鵝物流數據統計](https://penguin-stats.io/result/stage/recruit/recruit) , [一圖流](https://yituliu.site/maarecruitdata) ;
|
||||
- 自動公招,可選使用加急許可,一次全部刷完!公招數據上傳 [企鵝物流數據統計](https://penguin-stats.io/result/stage/recruit/recruit) , [一圖流](https://ark.yituliu.cn/survey/maarecruitdata) ;
|
||||
- 支援手動辨識公招介面,方便對高星公招做出選擇 ~~(你的這個高資回費出的是推王呢還是推王呢)~~
|
||||
- 支援辨識幹員列表,統計已有和未有幹員(還能為手動辨識公招介面提供已有潛能數據提示);
|
||||
- 支援辨識養成材料,並可匯出至 [企鵝物流刷圖規劃器](https://penguin-stats.io/planner) 和 [明日方舟工具箱](https://arkn.lolicon.app/#/material) 計算缺少的養成材料;
|
||||
@@ -47,7 +47,7 @@ MAA 的意思是 MAA Assistant Arknights
|
||||
- 倉庫辨識並支援匯出至 [企鵝物流刷圖規劃器](https://penguin-stats.io/planner) , [明日方舟工具箱](https://arkn.lolicon.app/#/material) , [ARK-NIGHTS 幹員培養表](https://ark-nights.com/settings) ;
|
||||
- 支援 C, Python, Java, Rust, Golang, Java HTTP, Rust HTTP 等多種接口,方便集成調用,自定義你的 MAA!
|
||||
|
||||
話不多說,看圖!<br>
|
||||
話不多說,看圖!
|
||||
|
||||

|
||||

|
||||
@@ -64,7 +64,7 @@ MAA 的意思是 MAA Assistant Arknights
|
||||
### 基本說明
|
||||
|
||||
1. 請根據 [模擬器支援情況](./1.3-模擬器支援.md),進行對應的操作。
|
||||
2. 修改模擬器解析度為 `16:9` 比例,最低 `1280 * 720`,最高 `2K`。<br>
|
||||
2. 修改模擬器解析度為 `16:9` 比例,最低 `1280 * 720`,最高 `2K`。
|
||||
對於國際服(美服)玩家,由於介面佈局問題,我們則建議您將解析度修改為 `1920 * 1080`。
|
||||
3. 開始使用吧!
|
||||
|
||||
@@ -84,7 +84,7 @@ MAA 的意思是 MAA Assistant Arknights
|
||||
|
||||
## 外服支援
|
||||
|
||||
目前國際服(美服)、日服、韓服、繁中服的絕大部分功能均已支援。但由於外服用戶較少及項目人手不足,很多功能並沒有進行全面的測試,所以請自行體驗。<br>
|
||||
目前國際服(美服)、日服、韓服、繁中服的絕大部分功能均已支援。但由於外服用戶較少及項目人手不足,很多功能並沒有進行全面的測試,所以請自行體驗。
|
||||
若您遇到了 Bug,或對某個功能有強需求,歡迎在 [Issues](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues) 和 [討論區](https://github.com/MaaAssistantArknights/MaaAssistantArknights/discussions) 催更;或加入我們一起建設 MAA!請參考 [外服適配教學](#外服適配)
|
||||
|
||||
## 主要關聯項目
|
||||
@@ -188,12 +188,12 @@ MAA 的意思是 MAA Assistant Arknights
|
||||
|
||||
## 廣告
|
||||
|
||||
用戶交流 QQ 群:[MAA 使用 & 粥遊交流 QQ 群](https://ota.maa.plus/MaaAssistantArknights/api/qqgroup/index.html)<br>
|
||||
用戶交流 TG 群:[Telegram 群](https://t.me/+Mgc2Zngr-hs3ZjU1)<br>
|
||||
自動戰鬥 JSON 作業分享:[prts.plus](https://prts.plus) 或 [抄作業.com](http://抄作業.com)<br>
|
||||
Bilibili 直播間:[直播間](https://live.bilibili.com/2808861) 每晚直播敲代碼,近期很長一段時間應該都是在寫本軟體 ~<br>
|
||||
用戶交流 QQ 群:[MAA 使用 & 粥遊交流 QQ 群](https://ota.maa.plus/MaaAssistantArknights/api/qqgroup/index.html)
|
||||
用戶交流 TG 群:[Telegram 群](https://t.me/+Mgc2Zngr-hs3ZjU1)
|
||||
自動戰鬥 JSON 作業分享:[prts.plus](https://prts.plus) 或 [抄作業.com](http://抄作業.com)
|
||||
Bilibili 直播間:[直播間](https://live.bilibili.com/2808861) 每晚直播敲代碼,近期很長一段時間應該都是在寫本軟體 ~
|
||||
|
||||
技術群(舟無關、禁水):[內卷地獄!(QQ 群)](https://jq.qq.com/?_wv=1027&k=ypbzXcA2)<br>
|
||||
開發者群:[QQ 群](https://jq.qq.com/?_wv=1027&k=JM9oCk3C)<br>
|
||||
技術群(舟無關、禁水):[內卷地獄!(QQ 群)](https://jq.qq.com/?_wv=1027&k=ypbzXcA2)
|
||||
開發者群:[QQ 群](https://jq.qq.com/?_wv=1027&k=JM9oCk3C)
|
||||
|
||||
如果覺得軟體對你有幫助,幫忙點個 Star 吧!~(網頁最上方右上角的小星星),這就是對我們最大的支持了!
|
||||
|
||||
@@ -143,5 +143,6 @@ icon: game-icons:prisoner
|
||||
|
||||
## 示例文件
|
||||
|
||||
[SSS\_阿卡胡拉丛林.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_阿卡胡拉丛林.json)<br>
|
||||
[SSS\_阿卡胡拉丛林.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_阿卡胡拉丛林.json)
|
||||
|
||||
[SSS\_多索雷斯在建地块.json](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/copilot/SSS_多索雷斯在建地块.json)
|
||||
|
||||
@@ -17,7 +17,7 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
|
||||
## 参数总览
|
||||
|
||||
- `int msg`<br>
|
||||
- `int msg`
|
||||
消息类型
|
||||
|
||||
```cpp
|
||||
@@ -46,9 +46,9 @@ typedef void(ASST_CALL* AsstCallback)(int msg, const char* details, void* custom
|
||||
};
|
||||
```
|
||||
|
||||
- `const char* details`<br>
|
||||
- `const char* details`
|
||||
消息详情,json 字符串,详见 [字段解释](#字段解释)
|
||||
- `void* custom_arg`<br>
|
||||
- `void* custom_arg`
|
||||
调用方自定义参数,会原样传出 `AsstCreateEx` 接口中的 `custom_arg` 参数,C 系语言可利用该参数传出 `this` 指针
|
||||
|
||||
## 字段解释
|
||||
@@ -84,25 +84,25 @@ Todo
|
||||
|
||||
### 常见 `What` 字段
|
||||
|
||||
- `ConnectFailed`<br>
|
||||
- `ConnectFailed`
|
||||
连接失败
|
||||
- `Connected`<br>
|
||||
- `Connected`
|
||||
已连接,注意此时的 `uuid` 字段值为空(下一步才是获取)
|
||||
- `UuidGot`<br>
|
||||
- `UuidGot`
|
||||
已获取到设备唯一码
|
||||
- `UnsupportedResolution`<br>
|
||||
- `UnsupportedResolution`
|
||||
分辨率不被支持
|
||||
- `ResolutionError`<br>
|
||||
- `ResolutionError`
|
||||
分辨率获取错误
|
||||
- `Reconnecting`<br>
|
||||
- `Reconnecting`
|
||||
连接断开(adb / 模拟器 炸了),正在重连
|
||||
- `Reconnected`<br>
|
||||
- `Reconnected`
|
||||
连接断开(adb / 模拟器 炸了),重连成功
|
||||
- `Disconnect`<br>
|
||||
- `Disconnect`
|
||||
连接断开(adb / 模拟器 炸了),并重试失败
|
||||
- `ScreencapFailed`<br>
|
||||
- `ScreencapFailed`
|
||||
截图失败(adb / 模拟器 炸了),并重试失败
|
||||
- `TouchModeNotAvailable`<br>
|
||||
- `TouchModeNotAvailable`
|
||||
不支持的触控模式
|
||||
|
||||
### AsyncCallInfo
|
||||
@@ -134,39 +134,39 @@ Todo
|
||||
|
||||
#### 常见 `taskchain` 字段
|
||||
|
||||
- `StartUp`<br>
|
||||
- `StartUp`
|
||||
开始唤醒
|
||||
- `CloseDown`<br>
|
||||
- `CloseDown`
|
||||
关闭游戏
|
||||
- `Fight`<br>
|
||||
- `Fight`
|
||||
刷理智
|
||||
- `Mall`<br>
|
||||
- `Mall`
|
||||
信用点及购物
|
||||
- `Recruit`<br>
|
||||
- `Recruit`
|
||||
自动公招
|
||||
- `Infrast`<br>
|
||||
- `Infrast`
|
||||
基建换班
|
||||
- `Award`<br>
|
||||
- `Award`
|
||||
领取日常奖励
|
||||
- `Roguelike`<br>
|
||||
- `Roguelike`
|
||||
无限刷肉鸽
|
||||
- `Copilot`<br>
|
||||
- `Copilot`
|
||||
自动抄作业
|
||||
- `SSSCopilot`<br>
|
||||
- `SSSCopilot`
|
||||
自动抄保全作业
|
||||
- `Depot`<br>
|
||||
- `Depot`
|
||||
仓库识别
|
||||
- `OperBox`<br>
|
||||
- `OperBox`
|
||||
干员 box 识别
|
||||
- `ReclamationAlgorithm`<br>
|
||||
- `ReclamationAlgorithm`
|
||||
生息演算
|
||||
- `Custom`<br>
|
||||
- `Custom`
|
||||
自定义任务
|
||||
- `SingleStep`<br>
|
||||
- `SingleStep`
|
||||
单步任务
|
||||
- `VideoRecognition`<br>
|
||||
- `VideoRecognition`
|
||||
视频识别任务
|
||||
- `Debug`<br>
|
||||
- `Debug`
|
||||
调试
|
||||
|
||||
### TaskChain 相关消息
|
||||
@@ -198,7 +198,7 @@ Todo
|
||||
|
||||
#### 常见 `subtask` 字段
|
||||
|
||||
- `ProcessTask`<br>
|
||||
- `ProcessTask`
|
||||
|
||||
```json
|
||||
// 对应的 details 字段举例
|
||||
@@ -215,49 +215,49 @@ Todo
|
||||
|
||||
##### 常见 `task` 字段
|
||||
|
||||
- `StartButton2`<br>
|
||||
- `StartButton2`
|
||||
开始战斗
|
||||
- `MedicineConfirm`<br>
|
||||
- `MedicineConfirm`
|
||||
使用理智药
|
||||
- `ExpiringMedicineConfirm`<br>
|
||||
- `ExpiringMedicineConfirm`
|
||||
使用 48 小时内过期的理智药
|
||||
- `StoneConfirm`<br>
|
||||
- `StoneConfirm`
|
||||
碎石
|
||||
- `RecruitRefreshConfirm`<br>
|
||||
- `RecruitRefreshConfirm`
|
||||
公招刷新标签
|
||||
- `RecruitConfirm`<br>
|
||||
- `RecruitConfirm`
|
||||
公招确认招募
|
||||
- `RecruitNowConfirm`<br>
|
||||
- `RecruitNowConfirm`
|
||||
公招使用加急许可
|
||||
- `ReportToPenguinStats`<br>
|
||||
- `ReportToPenguinStats`
|
||||
汇报到企鹅数据统计
|
||||
- `ReportToYituliu`<br>
|
||||
- `ReportToYituliu`
|
||||
汇报到一图流大数据
|
||||
- `InfrastDormDoubleConfirmButton`<br>
|
||||
- `InfrastDormDoubleConfirmButton`
|
||||
基建宿舍的二次确认按钮,仅当干员冲突时才会有,请提示用户
|
||||
- `StartExplore`<br>
|
||||
- `StartExplore`
|
||||
肉鸽开始探索
|
||||
- `StageTraderInvestConfirm`<br>
|
||||
- `StageTraderInvestConfirm`
|
||||
肉鸽投资了源石锭
|
||||
- `StageTraderInvestSystemFull`<br>
|
||||
- `StageTraderInvestSystemFull`
|
||||
肉鸽投资达到了游戏上限
|
||||
- `ExitThenAbandon`<br>
|
||||
- `ExitThenAbandon`
|
||||
肉鸽放弃了本次探索
|
||||
- `MissionCompletedFlag`<br>
|
||||
- `MissionCompletedFlag`
|
||||
肉鸽战斗完成
|
||||
- `MissionFailedFlag`<br>
|
||||
- `MissionFailedFlag`
|
||||
肉鸽战斗失败
|
||||
- `StageTraderEnter`<br>
|
||||
- `StageTraderEnter`
|
||||
肉鸽关卡:诡异行商
|
||||
- `StageSafeHouseEnter`<br>
|
||||
- `StageSafeHouseEnter`
|
||||
肉鸽关卡:安全的角落
|
||||
- `StageEncounterEnter`<br>
|
||||
- `StageEncounterEnter`
|
||||
肉鸽关卡:不期而遇/古堡馈赠
|
||||
- `StageCombatDpsEnter`<br>
|
||||
- `StageCombatDpsEnter`
|
||||
肉鸽关卡:普通作战
|
||||
- `StageEmergencyDps`<br>
|
||||
- `StageEmergencyDps`
|
||||
肉鸽关卡:紧急作战
|
||||
- `StageDreadfulFoe`<br>
|
||||
- `StageDreadfulFoe`
|
||||
肉鸽关卡:险路恶敌
|
||||
- `StartGameTask`
|
||||
打开客户端失败(配置文件与传入 client_type 不匹配)
|
||||
@@ -277,7 +277,7 @@ Todo
|
||||
|
||||
#### 常见 `what` 及 `details` 字段
|
||||
|
||||
- `StageDrops`<br>
|
||||
- `StageDrops`
|
||||
关卡材料掉落信息
|
||||
|
||||
```json
|
||||
@@ -331,7 +331,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitTagsDetected`<br>
|
||||
- `RecruitTagsDetected`
|
||||
公招识别到了 Tags
|
||||
|
||||
```json
|
||||
@@ -341,7 +341,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitSpecialTag`<br>
|
||||
- `RecruitSpecialTag`
|
||||
公招识别到了特殊 Tag
|
||||
|
||||
```json
|
||||
@@ -351,7 +351,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitResult`<br>
|
||||
- `RecruitResult`
|
||||
公招识别结果
|
||||
|
||||
```json
|
||||
@@ -421,7 +421,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitTagsRefreshed`<br>
|
||||
- `RecruitTagsRefreshed`
|
||||
公招刷新了 Tags
|
||||
|
||||
```json
|
||||
@@ -432,7 +432,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitNoPermit`<br>
|
||||
- `RecruitNoPermit`
|
||||
公招无招聘许可
|
||||
|
||||
```json
|
||||
@@ -442,7 +442,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitTagsSelected`<br>
|
||||
- `RecruitTagsSelected`
|
||||
公招选择了 Tags
|
||||
|
||||
```json
|
||||
@@ -452,13 +452,13 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `RecruitSlotCompleted`<br>
|
||||
- `RecruitSlotCompleted`
|
||||
当前公招槽位任务完成
|
||||
|
||||
- `RecruitError`<br>
|
||||
- `RecruitError`
|
||||
公招识别错误
|
||||
|
||||
- `EnterFacility`<br>
|
||||
- `EnterFacility`
|
||||
基建进入了设施
|
||||
|
||||
```json
|
||||
@@ -469,7 +469,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `NotEnoughStaff`<br>
|
||||
- `NotEnoughStaff`
|
||||
基建可用干员不足
|
||||
|
||||
```json
|
||||
@@ -480,7 +480,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `ProductOfFacility`<br>
|
||||
- `ProductOfFacility`
|
||||
基建产物
|
||||
|
||||
```json
|
||||
@@ -492,7 +492,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `StageInfo`<br>
|
||||
- `StageInfo`
|
||||
自动作战关卡信息
|
||||
|
||||
```json
|
||||
@@ -502,10 +502,10 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `StageInfoError`<br>
|
||||
- `StageInfoError`
|
||||
自动作战关卡识别错误
|
||||
|
||||
- `PenguinId`<br>
|
||||
- `PenguinId`
|
||||
企鹅物流 ID
|
||||
|
||||
```json
|
||||
@@ -515,7 +515,7 @@ Todo
|
||||
}
|
||||
```
|
||||
|
||||
- `Depot`<br>
|
||||
- `Depot`
|
||||
仓库识别结果
|
||||
|
||||
```json
|
||||
@@ -555,7 +555,7 @@ Todo
|
||||
// 目前只支持 ArkPlanner 和 Lolicon 的格式,以后可能会兼容更多网站
|
||||
```
|
||||
|
||||
- `OperBox`<br>
|
||||
- `OperBox`
|
||||
干员识别结果
|
||||
|
||||
```json
|
||||
@@ -603,5 +603,5 @@ Todo
|
||||
]
|
||||
```
|
||||
|
||||
- `UnsupportedLevel`<br>
|
||||
- `UnsupportedLevel`
|
||||
自动抄作业,不支持的关卡名
|
||||
|
||||
@@ -134,5 +134,6 @@ icon: material-symbols:view-quilt-rounded
|
||||
|
||||
## 举例
|
||||
|
||||
[243 极限效率,一天三换](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/243_layout_3_times_a_day.json)<br>
|
||||
[153 极限效率,一天三换](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/153_layout_3_times_a_day.json)<br>
|
||||
[243 极限效率,一天三换](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/243_layout_3_times_a_day.json)
|
||||
|
||||
[153 极限效率,一天三换](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/resource/custom_infrast/153_layout_3_times_a_day.json)
|
||||
|
||||
@@ -22,7 +22,7 @@ icon: ri:game-fill
|
||||
|
||||
特别地,在`Sami/`下的`foldartal.json`表示萨米肉鸽密文板的使用逻辑
|
||||
|
||||
## 肉鸽第一步--干员招募
|
||||
## 肉鸽第一步——干员招募
|
||||
|
||||
`resource/roguelike/主题名/recruitment.json` 描述了干员招募的逻辑
|
||||
|
||||
@@ -113,12 +113,12 @@ icon: ri:game-fill
|
||||
目前固定将未识别到的地面干员归入倒数第二个编组后面(其他地面),未识别到的高台干员归入倒数第一个编组后面(其他高台)
|
||||
:::
|
||||
|
||||
### 预设阵容--阵容完备检测
|
||||
### 预设阵容——阵容完备检测
|
||||
|
||||
在你预计能够通关或者打到高层的队伍中,哪些干员属于基本核心阵容?是比不可少的?又需要几个?
|
||||
|
||||
::: info 注意
|
||||
目前脚本的招募逻辑是在阵容未满足阵容完备度之前,只招募 0 希望和 key 干员,存希望给高星 key 干员
|
||||
目前脚本的招募逻辑是在阵容未满足阵容完备度之前,只招募 0 希望和核心干员,存希望给高星核心干员
|
||||
所以不要将完备度数字设置太高,建议所有需要的干员数量(基本核心阵容)加起来在 4-8 位
|
||||
:::
|
||||
|
||||
@@ -206,11 +206,11 @@ icon: ri:game-fill
|
||||
|
||||
新增群组后,你可以从已有的群组中复制干员过来,参考大佬们已有的评分,在此基础上修改
|
||||
|
||||
## 肉鸽第二步--战斗逻辑
|
||||
## 肉鸽第二步——战斗逻辑
|
||||
|
||||
`resource/roguelike/主题名/autopilot/关卡名.json` 描述了每个关卡的作战策略
|
||||
|
||||
### MAA 肉鸽基本战斗逻辑--牛牛高血压之源
|
||||
### MAA 肉鸽基本战斗逻辑——牛牛高血压之源
|
||||
|
||||
1. 根据地图上格子类型进行基本的战斗操作
|
||||
|
||||
@@ -237,7 +237,7 @@ icon: ri:game-fill
|
||||
|
||||
或者有些关卡有多个蓝门,MAA 不知道哪个蓝门对应哪个红门,也会胡乱部署,
|
||||
|
||||
这个时候你需要打开[地图 wiki](https://map.ark-nights.com/areas?coord_override=MAA)一边对着地图一边在脑海里指挥作战了
|
||||
这个时候你需要打开 [地图 Wiki](https://map.ark-nights.com/areas?coord_override=MAA) 一边对着地图一边在脑海里指挥作战了
|
||||
|
||||
首先在`设置`里将`坐标展示`切换为`MAA`
|
||||
|
||||
@@ -294,7 +294,7 @@ icon: ri:game-fill
|
||||
"not_use_dice": false,
|
||||
```
|
||||
|
||||
### 还是高血压?是时候展现你真正的而技术了--定制作战策略!
|
||||
### 还是高血压?是时候展现你真正的技术了——定制作战策略!
|
||||
|
||||
使用`"deploy_plan"`和`"retreat_plan"`实现定制化操作
|
||||
|
||||
@@ -413,7 +413,7 @@ icon: ri:game-fill
|
||||
],
|
||||
```
|
||||
|
||||
### 对某个干员打法有特殊理解?--精细化操作特定干员
|
||||
### 对某个干员打法有特殊理解?——精细化操作特定干员
|
||||
|
||||
请将这位干员单独分组
|
||||
|
||||
@@ -425,7 +425,7 @@ icon: ri:game-fill
|
||||
|
||||
参考例子:1.傀影肉鸽的棘刺 2.水月肉鸽的异德 3.萨米肉鸽的焰苇
|
||||
|
||||
## 肉鸽第三步--不期而遇类节点逻辑
|
||||
## 肉鸽第三步——不期而遇类节点逻辑
|
||||
|
||||
`resource/roguelike/主题名/encounter.json` 描述了刷等级模式下不期而遇事件选择的策略
|
||||
|
||||
@@ -441,7 +441,7 @@ OCR 识别不期而遇事件,但是选项是操作固定的位置
|
||||
|
||||
### 优化不期而遇选项的优先度
|
||||
|
||||
请结合[prts.wiki](https://prts.wiki/w/%E9%9B%86%E6%88%90%E6%88%98%E7%95%A5)查看各个事件的选项效果,注意选项不一定固定
|
||||
请结合 [prts.wiki](https://prts.wiki/w/%E9%9B%86%E6%88%90%E6%88%98%E7%95%A5) 查看各个事件的选项效果,注意选项不一定固定
|
||||
|
||||
可以自己修改不期而遇事件选项以指引 MAA 走向某些图的特殊结局
|
||||
|
||||
@@ -471,9 +471,9 @@ OCR 识别不期而遇事件,但是选项是操作固定的位置
|
||||
...
|
||||
```
|
||||
|
||||
### 根据队伍情况动态调整某些选项的优先度(TODO)
|
||||
### 根据队伍情况动态调整某些选项的优先度(TODO)
|
||||
|
||||
## 肉鸽第四步--商店藏品的优先度
|
||||
## 肉鸽第四步——商店藏品的优先度
|
||||
|
||||
`resource/roguelike/主题名/shopping.json` 描述了商店购买藏品(和战斗后选择藏品?)的策略
|
||||
|
||||
@@ -521,7 +521,7 @@ OCR 识别不期而遇事件,但是选项是操作固定的位置
|
||||
|
||||
## 单独肉鸽定制逻辑
|
||||
|
||||
### 萨米肉鸽--密文板
|
||||
### 萨米肉鸽——密文板
|
||||
|
||||
`resource/roguelike/Sami/foldartal.json` 描述了萨米肉鸽密文板的策略
|
||||
|
||||
@@ -572,7 +572,7 @@ OCR 识别不期而遇事件,但是选项是操作固定的位置
|
||||
|
||||
```
|
||||
|
||||
## 希望实现的逻辑(todo)
|
||||
## 希望实现的逻辑(todo)
|
||||
|
||||
### 自动编队逻辑
|
||||
|
||||
@@ -580,7 +580,7 @@ OCR 识别不期而遇事件,但是选项是操作固定的位置
|
||||
|
||||
2. 可以根据现有阵容避开一些难度高的作战
|
||||
|
||||
### ~~优化寻路算法~~(已初步实现)
|
||||
### ~~优化寻路算法~~(已初步实现)
|
||||
|
||||
比如可以实现前三层多战,后面的少战,这样发育会更好
|
||||
|
||||
|
||||
@@ -21,23 +21,23 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
|
||||
#### 返回值
|
||||
|
||||
- `AsstTaskId`<br>
|
||||
若添加成功,返回该任务 ID, 可用于后续设置任务参数;<br>
|
||||
- `AsstTaskId`
|
||||
若添加成功,返回该任务 ID, 可用于后续设置任务参数;
|
||||
若添加失败,返回 0
|
||||
|
||||
#### 参数说明
|
||||
|
||||
- `AsstHandle handle`<br>
|
||||
- `AsstHandle handle`
|
||||
实例句柄
|
||||
- `const char* type`<br>
|
||||
- `const char* type`
|
||||
任务类型
|
||||
- `const char* params`<br>
|
||||
- `const char* params`
|
||||
任务参数,json string
|
||||
|
||||
##### 任务类型一览
|
||||
|
||||
- `StartUp`<br>
|
||||
开始唤醒<br>
|
||||
- `StartUp`
|
||||
开始唤醒
|
||||
|
||||
```json
|
||||
// 对应的任务参数
|
||||
@@ -53,8 +53,8 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `CloseDown`<br>
|
||||
关闭游戏<br>
|
||||
- `CloseDown`
|
||||
关闭游戏
|
||||
|
||||
```json
|
||||
// 对应的任务参数
|
||||
@@ -63,7 +63,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Fight`<br>
|
||||
- `Fight`
|
||||
刷理智
|
||||
|
||||
```json
|
||||
@@ -98,7 +98,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
|
||||
另支持少部分资源关卡名请参考[集成示例](..\tools\AutoLocalization\example\zh-cn.xaml#L260)
|
||||
|
||||
- `Recruit`<br>
|
||||
- `Recruit`
|
||||
公开招募
|
||||
|
||||
```json
|
||||
@@ -138,7 +138,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Infrast`<br>
|
||||
- `Infrast`
|
||||
基建换班
|
||||
|
||||
```json
|
||||
@@ -168,8 +168,8 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Mall`<br>
|
||||
领取信用及商店购物。<br>
|
||||
- `Mall`
|
||||
领取信用及商店购物。
|
||||
会先有序的按 `buy_first` 购买一遍,再从左到右并避开 `blacklist` 购买第二遍,在信用溢出时则会无视黑名单从左到右购买第三遍直到不再溢出
|
||||
|
||||
```json
|
||||
@@ -191,7 +191,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Award`<br>
|
||||
- `Award`
|
||||
领取日常奖励
|
||||
|
||||
```json
|
||||
@@ -201,7 +201,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Roguelike`<br>
|
||||
- `Roguelike`
|
||||
无限刷肉鸽
|
||||
|
||||
```json
|
||||
@@ -234,7 +234,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Copilot`<br>
|
||||
- `Copilot`
|
||||
自动抄作业
|
||||
|
||||
```json
|
||||
@@ -247,7 +247,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
|
||||
作业 JSON 请参考 [战斗流程协议](./战斗流程协议.md)
|
||||
|
||||
- `SSSCopilot`<br>
|
||||
- `SSSCopilot`
|
||||
自动抄保全作业
|
||||
|
||||
```json
|
||||
@@ -260,7 +260,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
|
||||
保全作业 JSON 请参考 [保全派驻协议](./保全派驻协议.md)
|
||||
|
||||
- `Depot`<br>
|
||||
- `Depot`
|
||||
仓库识别
|
||||
|
||||
```json
|
||||
@@ -270,7 +270,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `OperBox`<br>
|
||||
- `OperBox`
|
||||
干员 box 识别
|
||||
|
||||
```json
|
||||
@@ -280,7 +280,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `ReclamationAlgorithm`<br>
|
||||
- `ReclamationAlgorithm`
|
||||
生息演算
|
||||
|
||||
```json
|
||||
@@ -295,8 +295,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `Custom`<br>
|
||||
|
||||
- `Custom`
|
||||
自定义任务
|
||||
|
||||
```json
|
||||
@@ -310,8 +309,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `SingleStep`<br>
|
||||
|
||||
- `SingleStep`
|
||||
单步任务(目前仅支持战斗)
|
||||
|
||||
```json
|
||||
@@ -329,8 +327,7 @@ AsstTaskId ASSTAPI AsstAppendTask(AsstHandle handle, const char* type, const cha
|
||||
}
|
||||
```
|
||||
|
||||
- `VideoRecognition`<br>
|
||||
|
||||
- `VideoRecognition`
|
||||
视频识别,目前仅支持作业(作战)视频
|
||||
|
||||
```json
|
||||
@@ -354,17 +351,17 @@ bool ASSTAPI AsstSetTaskParams(AsstHandle handle, AsstTaskId id, const char* par
|
||||
|
||||
#### 返回值
|
||||
|
||||
- `bool`<br>
|
||||
- `bool`
|
||||
返回是否设置成功
|
||||
|
||||
#### 参数说明
|
||||
|
||||
- `AsstHandle handle`<br>
|
||||
- `AsstHandle handle`
|
||||
实例句柄
|
||||
- `AsstTaskId task`<br>
|
||||
- `AsstTaskId task`
|
||||
任务 ID, `AsstAppendTask` 接口的返回值
|
||||
- `const char* params`<br>
|
||||
任务参数,json string,与 `AsstAppendTask` 接口相同。<br>
|
||||
- `const char* params`
|
||||
任务参数,json string,与 `AsstAppendTask` 接口相同。
|
||||
未标注“不支持运行中设置”的字段都支持实时修改;否则若当前任务正在运行,会忽略对应的字段
|
||||
|
||||
### `AsstSetStaticOption`
|
||||
@@ -381,14 +378,14 @@ bool ASSTAPI AsstSetStaticOption(AsstStaticOptionKey key, const char* value);
|
||||
|
||||
#### 返回值
|
||||
|
||||
- `bool`<br>
|
||||
- `bool`
|
||||
返回是否设置成功
|
||||
|
||||
#### 参数说明
|
||||
|
||||
- `AsstStaticOptionKey key`<br>
|
||||
- `AsstStaticOptionKey key`
|
||||
键
|
||||
- `const char* value`<br>
|
||||
- `const char* value`
|
||||
值
|
||||
|
||||
##### 键值一览
|
||||
@@ -409,16 +406,16 @@ bool ASSTAPI AsstSetInstanceOption(AsstHandle handle, AsstInstanceOptionKey key,
|
||||
|
||||
#### 返回值
|
||||
|
||||
- `bool`<br>
|
||||
- `bool`
|
||||
返回是否设置成功
|
||||
|
||||
#### 参数说明
|
||||
|
||||
- `AsstHandle handle`<br>
|
||||
- `AsstHandle handle`
|
||||
实例句柄
|
||||
- `AsstInstanceOptionKey key`<br>
|
||||
- `AsstInstanceOptionKey key`
|
||||
键
|
||||
- `const char* value`<br>
|
||||
- `const char* value`
|
||||
值
|
||||
|
||||
##### 键值一览
|
||||
|
||||
@@ -15,8 +15,8 @@ Issue Bot 使用的 action 为 [issue-checker](https://github.com/zzyyyl/issue-c
|
||||
|
||||
### 自动触发
|
||||
|
||||
- 给 议题 和 拉取请求 增加标签,包括 `module` 系列,`Client` 系列,`ambiguous`,`translation required` 等。<br>
|
||||
Issue Bot 会根据关键词自动增加分类标签。<br>
|
||||
- 给 议题 和 拉取请求 增加标签,包括 `module` 系列,`Client` 系列,`ambiguous`,`translation required` 等。
|
||||
Issue Bot 会根据关键词自动增加分类标签。
|
||||
具体关键词可以参考[配置文件](https://github.com/MaaAssistantArknights/MaaAssistantArknights/blob/master/.github/issue-checker.yml)。
|
||||
- 给作者是可见性设置为 public 的 MAA 成员的 议题 和 拉取请求 增加 `MAA Team` 标签。
|
||||
|
||||
@@ -33,7 +33,7 @@ Issue Bot 会对拉取请求标题的格式进行简单审查。它会增加 `am
|
||||
|
||||
### 手动触发
|
||||
|
||||
多使用关键词详细描述问题来自动触发分类标签,少使用下列指令。<br>
|
||||
多使用关键词详细描述问题来自动触发分类标签,少使用下列指令。
|
||||
但**当你知道自己的行为会导致 Issue Bot 误解时除外**。
|
||||
|
||||
#### 议题(Issue)及拉取请求(Pull Request)
|
||||
@@ -47,7 +47,7 @@ Issue Bot 会对拉取请求标题的格式进行简单审查。它会增加 `am
|
||||
|
||||
- `Skip {LABEL_NAME}` 可以保证不增加标签。
|
||||
- `Skip labels` 可以保证不增加任何标签。
|
||||
- 以下几种方法可以为议题增加 `fixed` 标签:<sup>1</sup><br>
|
||||
- 以下几种方法可以为议题增加 `fixed` 标签:<sup>1</sup>
|
||||
- `https://github.com/MaaAssistantArknights/MaaAssistantArknights/commit/{COMMIT_HASH} fixed`
|
||||
- `fixed by https://github.com/MaaAssistantArknights/MaaAssistantArknights/commit/{COMMIT_HASH}`
|
||||
- `{VERSION} fixed`
|
||||
@@ -56,7 +56,7 @@ Issue Bot 会对拉取请求标题的格式进行简单审查。它会增加 `am
|
||||
- **当你知道自己的议题评论会导致 Issue Bot 误解时,尽量添加一些 skip 操作。**
|
||||
|
||||
::: info 注意
|
||||
这里的 COMMIT_HASH 需要完整的 40 位
|
||||
<sup>1</sup> 这里的 COMMIT_HASH 需要完整的 40 位
|
||||
:::
|
||||
|
||||
#### 推送(Push)
|
||||
|
||||
@@ -23,7 +23,7 @@ icon: iconoir:developer
|
||||
|
||||
4. 下载预构建的第三方库
|
||||
|
||||
**需要有 Python 环境,请自行搜索 Python 安装教程**<br>
|
||||
**需要有 Python 环境,请自行搜索 Python 安装教程**
|
||||
_(maadeps-download.py 文件在项目根目录)_
|
||||
|
||||
```cmd
|
||||
@@ -41,7 +41,7 @@ icon: iconoir:developer
|
||||
- 右键 `MaaWpfGui` - 属性 - 调试 - 启用本地调试(这样就能把断点挂到 C++ Core 那边了)
|
||||
|
||||
8. 到这里,你就可以愉快地 ~~瞎 JB 改~~ 发电了
|
||||
9. 开发过程中,每一定数量,记得提交一个 commit, 别忘了写上 message<br>
|
||||
9. 开发过程中,每一定数量,记得提交一个 commit, 别忘了写上 message
|
||||
假如你不熟悉 git 的使用,你可能想要新建一个分支进行更改,而不是直接提交在 `dev` 上
|
||||
|
||||
```bash
|
||||
|
||||
@@ -8,7 +8,7 @@ icon: mingcute:git-pull-request-fill
|
||||
牛牛也能看懂的 GitHub Pull Request 使用指南 (\*´▽ `)ノノ
|
||||
|
||||
::: warning
|
||||
本教程中对很多概念进行了简化,为了让更多朋友能实际用起来,甚至有一些很不优雅~~但是简单~~的操作,还有一些不那么正确的解释,还请大佬们轻喷。<br>
|
||||
本教程中对很多概念进行了简化,为了让更多朋友能实际用起来,甚至有一些很不优雅~~但是简单~~的操作,还有一些不那么正确的解释,还请大佬们轻喷。
|
||||
若您有一定的 git 使用经验及编程基础,~~那你还看个~~🔨,可以看稍微进阶一点的教程 [Github Pull Request 流程简述](./开始开发.md#github-pull-request-流程简述)
|
||||
:::
|
||||
|
||||
@@ -26,18 +26,18 @@ icon: mingcute:git-pull-request-fill
|
||||
|
||||
### Fork(复制)
|
||||
|
||||
复制,字面意思,将 MAA 的代码复制一份,然后可以进行后续修改等等的操作,避免把原来的弄坏了<br>
|
||||
复制,字面意思,将 MAA 的代码复制一份,然后可以进行后续修改等等的操作,避免把原来的弄坏了
|
||||
但一般说中文“复制”我们可能首先想到的是 copy 的意思,fork 也没有其他明确的翻译,所以我们一般习惯直接说英文,比如“把代码 fork 一份走”
|
||||
|
||||
既然是复制后的,那就是 `MAA (1)`(bushi)<br>
|
||||
为了和原本的仓库区分开,所以我们一般将原本的 MAA 仓库称为 “主仓库”、“upstream(上游仓库)”、“origin(原仓库)”;<br>
|
||||
既然是复制后的,那就是 `MAA (1)`(bushi)
|
||||
为了和原本的仓库区分开,所以我们一般将原本的 MAA 仓库称为 “主仓库”、“upstream(上游仓库)”、“origin(原仓库)”;
|
||||
因为每个人都可以自己复制一份走,所以复制后的称之为“个人仓库”
|
||||
|
||||

|
||||
|
||||
### Pull Request(拉取请求、合并请求)
|
||||
|
||||
简称 PR,“拉取请求”这个太直译了,听起来很奇怪,~~而且字太多了打起来太累~~,所以也是一样的大家一般就直接说:“来个 PR”<br>
|
||||
简称 PR,“拉取请求”这个太直译了,听起来很奇怪,~~而且字太多了打起来太累~~,所以也是一样的大家一般就直接说:“来个 PR”
|
||||
书接上文,你 fork(复制)的个人仓库,修改完了,怎么把内容提供给主仓库呢?这时候我们就可以开一个 PR,申请将自己修改的内容加入到主仓库中。
|
||||
|
||||
当然啦,既然是“请求”,那自然是需要审批的,MAA Team 的各位可能会针对你的修改提一些意见等,当然我们的意见也不一定完全正确,大家合理讨论~
|
||||
@@ -48,9 +48,9 @@ icon: mingcute:git-pull-request-fill
|
||||
|
||||
### Conflict(冲突)
|
||||
|
||||
假设一下,主仓库中有个 A 文件,它的内容是 111<br>
|
||||
你 fork 了一份,将其内容改成了 222,但是你刚准备提交 PR,这时候张三也 fork 了一份并提交了 PR,并将 A 文件改成了 333<br>
|
||||
这时候我们就会看到,你俩都修改了 A 文件,并且修改的不同,那听谁的好呢?这就是 Conflict(冲突)<br>
|
||||
假设一下,主仓库中有个 A 文件,它的内容是 111
|
||||
你 fork 了一份,将其内容改成了 222,但是你刚准备提交 PR,这时候张三也 fork 了一份并提交了 PR,并将 A 文件改成了 333
|
||||
这时候我们就会看到,你俩都修改了 A 文件,并且修改的不同,那听谁的好呢?这就是 Conflict(冲突)
|
||||
冲突解决起来比较麻烦,这里仅阐述概念,方便实际遇到时能理解发生了什么,暂不阐述解决方案
|
||||
|
||||
## 纯网页端 PR 操作全流程
|
||||
@@ -85,27 +85,27 @@ icon: mingcute:git-pull-request-fill
|
||||

|
||||
|
||||
9. 还有第二个文件要改的?改完了发现弄错了想再改改?都没关系!重复 5-8 即可!
|
||||
10. 全改好了进行 PR !直接点 **个人仓库** 里的 Pull Request 标签页<br>
|
||||
10. 全改好了进行 PR !直接点 **个人仓库** 里的 Pull Request 标签页
|
||||
如果有 Compare & Pull Request 按钮,那最好,直接点他!如果没有也不用着急,点下面的 New Pull Request 也是一样的(请看步骤 11)
|
||||
|
||||

|
||||
|
||||
11. 这时候来到了主仓库,请核对一下你要 PR 的是否确认。<br>
|
||||
如图中,中间有个向左的箭头,是将右边的的 个人姓名/MAA 的 dev 分支,申请合并到 主仓库/MAA 的 dev 分支。<br>
|
||||
11. 这时候来到了主仓库,请核对一下你要 PR 的是否确认。
|
||||
如图中,中间有个向左的箭头,是将右边的的 个人姓名/MAA 的 dev 分支,申请合并到 主仓库/MAA 的 dev 分支。
|
||||
然后写一下标题,你要修改了的具体内容等等的,然后点确认
|
||||
|
||||

|
||||
|
||||
12. 等待 MAA Team 的大佬们审核吧!当然他们也可能会提意见<br>
|
||||
12. 等待 MAA Team 的大佬们审核吧!当然他们也可能会提意见
|
||||
👇 比如(纯属娱乐切勿当真)
|
||||

|
||||
|
||||
13. 如果大佬们说要再修改一些小问题的话,回到 **你的个人仓库**,切换到先前的 dev 分支,重复 步骤 3-9 即可!<br>
|
||||
注意不需要操作步骤 2(重新 fork),也不需要操作步骤 10(重新 Pull Request),你当前的 Pull Request 仍处于待审核状态,后续的修改会直接进入到这个 Pull Request 中<br>
|
||||
13. 如果大佬们说要再修改一些小问题的话,回到 **你的个人仓库**,切换到先前的 dev 分支,重复 步骤 3-9 即可!
|
||||
注意不需要操作步骤 2(重新 fork),也不需要操作步骤 10(重新 Pull Request),你当前的 Pull Request 仍处于待审核状态,后续的修改会直接进入到这个 Pull Request 中
|
||||
👇 比如可以看到最下面多了一条“重新修改演示”的内容
|
||||

|
||||
|
||||
14. 等大佬们审批通过,就全部完成啦!**版本发布后**,你的 GitHub 头像将会自动进入到贡献者列表名单中,非常感谢各位的无私奉献!<br>
|
||||
14. 等大佬们审批通过,就全部完成啦!**版本发布后**,你的 GitHub 头像将会自动进入到贡献者列表名单中,非常感谢各位的无私奉献!
|
||||
~~怎么全是二次元啊,哦我也是啊,那没事了~~
|
||||
::: tip 贡献/参与者
|
||||
感谢所有参与到开发/测试中的朋友们,是大家的帮助让 MAA 越来越好! (\*´▽ `)ノノ
|
||||
@@ -113,11 +113,11 @@ icon: mingcute:git-pull-request-fill
|
||||
[](https://github.com/MaaAssistantArknights/MaaAssistantArknights/graphs/contributors)
|
||||
:::
|
||||
|
||||
15. 下次如果还想提别的 PR,请先切换到 dev 分支,然后直接如下图操作<br>
|
||||
15. 下次如果还想提别的 PR,请先切换到 dev 分支,然后直接如下图操作
|
||||
::: warning
|
||||
这个操作会强制将你的个人仓库同步到和主仓库一模一样的状态,这是最简单粗暴但行之有效的解决冲突的方法。但如果你的个人仓库已经有额外的编辑了,会被直接删掉!
|
||||
:::
|
||||
如果确定不会造成冲突,请使用右侧绿色的 `Update Branch` 按钮<br>
|
||||
如果确定不会造成冲突,请使用右侧绿色的 `Update Branch` 按钮
|
||||
|
||||
如果你不清楚/不 care 我上面说的这一大堆,也请点击左侧的按钮
|
||||
|
||||
|
||||
@@ -8,8 +8,8 @@ icon: ph:question-fill
|
||||
MAA 在 5.0 版本更新到了 .NET 8,对于最终用户来说,影响如下:
|
||||
1. MAA 现在需要 .NET 8 运行库,在启动时会自动提示用户安装。若安装失败,请阅读下文,下载安装包手动安装。
|
||||
2. MAA 不会再被 Windows Defender 误报了。~~为了这碟醋包的饺子~~
|
||||
3. [.NET 8 不支持 Windows 7/8/8.1 系统](https://github.com/dotnet/core/issues/7556),所以 MAA 也同样不再支持,即使它现在依旧能运行。
|
||||
4. 在 Windows 7 运行 MAA 时,会出现内存占用异常的问题,请参阅 [#8238](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/8238) 实施缓解措施。Windows 8/8.1 未经测试,若存在相同问题,请顺手发个 Issue 提醒我们补充文档。
|
||||
3. [.NET 8 不支持 Windows 7/8/8.1 系统](https://github.com/dotnet/core/issues/7556),所以 MAA 也同样不再支持,即使它现在依旧能正常运行。
|
||||
4. 在 Windows 7 上运行 MAA 时,会出现内存占用异常的问题,请参阅下文 Windows 7 部分实施缓解措施。Windows 8/8.1 未经测试,若存在相同问题,请顺手发个 Issue 提醒我们补充文档。
|
||||
:::
|
||||
|
||||
## 软件无法运行/闪退/报错
|
||||
@@ -45,6 +45,14 @@ MAA 在 5.0 版本更新到了 .NET 8,对于最终用户来说,影响如下
|
||||
- KB4490628:[下载链接 1](https://catalog.s.download.windowsupdate.com/c/msdownload/update/software/secu/2019/03/windows6.1-kb4490628-x64_d3de52d6987f7c8bdc2c015dca69eac96047c76e.msu)、[下载链接 2](http://download.windowsupdate.com/c/msdownload/update/software/secu/2019/03/windows6.1-kb4490628-x64_d3de52d6987f7c8bdc2c015dca69eac96047c76e.msu)
|
||||
3. Platform Update for Windows 7(DXGI 1.2、Direct3D 11.1,KB2670838):[下载链接 1](https://catalog.s.download.windowsupdate.com/msdownload/update/software/ftpk/2013/02/windows6.1-kb2670838-x64_9f667ff60e80b64cbed2774681302baeaf0fc6a6.msu)、[下载链接 2](http://download.windowsupdate.com/msdownload/update/software/ftpk/2013/02/windows6.1-kb2670838-x64_9f667ff60e80b64cbed2774681302baeaf0fc6a6.msu)
|
||||
|
||||
临时解决 .NET 8 应用在 Windows 7 中运行的异常内存占用问题 [#8238](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/8238)
|
||||
|
||||
1. 打开 `计算机`,右键空白处,点击属性,点击左侧 `高级系统设置`,点击 `环境变量`。
|
||||
2. 新建一个系统变量,变量名 `DOTNET_EnableWriteXorExecute`,变量值 `0`。
|
||||
3. 重启电脑。
|
||||
|
||||
我们无法保证将来的版本对 Windows 7 的兼容性,~~都是微软的错~~。
|
||||
|
||||
#### 官方整合包(确信)
|
||||
|
||||
::: info 注意
|
||||
@@ -82,19 +90,24 @@ MAA 在 5.0 版本更新到了 .NET 8,对于最终用户来说,影响如下
|
||||
|
||||
- [Bluestacks 5](https://support.bluestacks.com/hc/zh-tw/articles/360061342631-%E5%A6%82%E4%BD%95%E5%B0%87%E6%82%A8%E7%9A%84%E6%87%89%E7%94%A8%E5%BE%9EBlueStacks-4%E8%BD%89%E7%A7%BB%E5%88%B0BlueStacks-5#%E2%80%9C2%E2%80%9D) `5555`
|
||||
- [MuMu Pro](https://mumu.163.com/mac/function/20240126/40028_1134600.html) `16384`
|
||||
- [MuMu 6](https://mumu.163.com/help/20210531/35047_951108.html) `7555`
|
||||
- [MuMu 12](https://mumu.163.com/help/20230214/35047_1073151.html) `16384`
|
||||
- [逍遥](https://bbs.xyaz.cn/forum.php?mod=viewthread&tid=365537) `21503`
|
||||
- [夜神](https://support.yeshen.com/zh-CN/qt/ml) `62001`
|
||||
|
||||
其他模拟器可参考 [赵青青的博客](https://www.cnblogs.com/zhaoqingqing/p/15238464.html)。
|
||||
|
||||
### 关闭冗余 adb 进程
|
||||
### 关闭现有 adb 进程
|
||||
|
||||
关闭 MAA 后查找 `任务管理器` - `详细信息` 中有无名称包含 `adb` 的进程(通常和上文中填写的 `adb` 文件同名),如有,结束它后重试连接。
|
||||
|
||||
### 正确使用多个 adb
|
||||
|
||||
当 adb 版本不同时,新启动的进程会关闭旧的进程。因此在同时运行多个 adb,如 Android Studio、Alas、手机助手时,请确认它们的版本相同。
|
||||
|
||||
### 避免游戏加速器
|
||||
|
||||
在启动加速和停止加速之后,都需要重启 MAA、ADB 和模拟器再连接。
|
||||
部分加速器在启动加速和停止加速之后,都需要重启 MAA、ADB 和模拟器再连接。
|
||||
|
||||
### 重启电脑
|
||||
|
||||
@@ -106,27 +119,27 @@ MAA 在 5.0 版本更新到了 .NET 8,对于最终用户来说,影响如下
|
||||
|
||||
## 连接正常,但是无操作
|
||||
|
||||
部分模拟器自带的 `adb` 版本过于老旧,不支持 `Minitouch` 相关操作。<br>
|
||||
部分模拟器自带的 `adb` 版本过于老旧,不支持 `Minitouch` 相关操作。
|
||||
|
||||
请使用管理员权限打开 MAA,点击 `MAA 设置` - `连接设置` - `强制替换 ADB`。(建议关闭模拟器并重启 MAA 后再操作,否则可能替换失败)<br>
|
||||
请使用管理员权限打开 MAA,点击 `MAA 设置` - `连接设置` - `强制替换 ADB`。(建议关闭模拟器并重启 MAA 后再操作,否则可能替换失败)
|
||||
|
||||
模拟器更新后可能会重新覆盖 adb 文件。若更新后问题复现,请再次尝试替换。<br>
|
||||
模拟器更新后可能会重新覆盖 adb 文件。若更新后问题复现,请再次尝试替换。
|
||||
|
||||
如果即使这样也无法正常使用,可将 `连接设置` - `触控模式` 从 `Minitouch` 切换到 `MaaTouch` 再次尝试。由于 `Adb Input` 操作过于缓慢,请仅将其作为万不得已的模式。
|
||||
|
||||
## 蓝叠模拟器每次启动端口号都不一样(Hyper-V)
|
||||
|
||||
打开 MAA,在 `设置` - `连接设置` 中设置 `连接配置` 为 `蓝叠模拟器` ,随后勾选 `自动检测连接` 和 `每次重新检测` (或是在主界面 `开始唤醒` 旁的设置中勾选这两项)
|
||||
打开 MAA,在 `设置` - `连接设置` 中设置 `连接配置` 为 `蓝叠模拟器` ,随后勾选 `自动检测连接` 和 `每次重新检测`(或是在主界面 `开始唤醒` 旁的设置中勾选这两项)。
|
||||
|
||||
通常情况下这样设置就能连上了。如果没能连上,可能是你安装了多个模拟器核心或是该功能出现问题,可以根据下面的指导来进行额外设置
|
||||
通常情况下这样就可以连接。如果无法连接,可能是存在多个模拟器核心或出现了问题,请阅读下文进行额外设置。
|
||||
|
||||
### 指定 `Bluestacks.Config.Keyword`
|
||||
|
||||
::: info 注意
|
||||
如果你启用了多开功能或是安装了多个模拟器核心,那么你需要进行额外设置来指定使用的模拟器编号
|
||||
如果启用了多开功能或安装了多个模拟器核心,则需要进行额外设置来指定使用的模拟器编号
|
||||
:::
|
||||
|
||||
在`gui.json`中搜索 `Bluestacks.Config.Keyword` 字段,内容为`"bst.instance.模拟器编号.status.adb_port"`,模拟器编号可在模拟器路径的`BlueStacks_nxt\Engine`中看到
|
||||
在 `.\config\gui.json` 中搜索 `Bluestacks.Config.Keyword` 字段,内容为 `"bst.instance.<模拟器编号>.status.adb_port"`,模拟器编号可在模拟器路径的 `BlueStacks_nxt\Engine` 中看到
|
||||
|
||||
::: details 示例
|
||||
Nougat64 核心:
|
||||
@@ -145,17 +158,17 @@ Pie64_2 核心:(核心名称后的数字代表这是一个多开核心)
|
||||
### 指定 `Bluestacks.Config.Path`
|
||||
|
||||
::: info 注意
|
||||
MAA 现在会尝试从注册表中读取 `bluestacks.conf` 的存储位置,当该功能失效或出错时,你需要手动指定配置文件路径
|
||||
MAA 现在会尝试从注册表中读取 `bluestacks.conf` 的存储位置,当该功能无法工作时,则需要手动指定配置文件路径
|
||||
:::
|
||||
|
||||
1. 在蓝叠模拟器的数据目录下找到 `bluestacks.conf` 这个文件<br>
|
||||
1. 在蓝叠模拟器的数据目录下找到 `bluestacks.conf` 这个文件
|
||||
|
||||
- 国际版默认路径为 `C:\ProgramData\BlueStacks_nxt\bluestacks.conf`
|
||||
- 中国内地版默认路径为 `C:\ProgramData\BlueStacks_nxt_cn\bluestacks.conf`
|
||||
|
||||
2. 如果是第一次使用,请开启一次 MAA,会在 MAA 的 `config` 目录下生成 `gui.json`。
|
||||
2. 如果是第一次使用,请运行一次 MAA,使 MAA 自动生成配置文件。
|
||||
|
||||
3. **先关闭** MAA,**然后** 打开 `gui.json`,找到 `Configurations` 下的当前配置名字段(可在 设置-切换配置 中查看,默认为 `Default`),在其中搜索字段 `Bluestacks.Config.Path`,填入 `bluestacks.conf` 的完整路径。(注意斜杠要用转义 `\\`)<br>
|
||||
3. **先关闭** MAA,**然后**打开 `gui.json`,找到 `Configurations` 下的当前配置名字段(可在 设置-切换配置 中查看,默认为 `Default`),在其中搜索字段 `Bluestacks.Config.Path`,填入 `bluestacks.conf` 的完整路径。(注意斜杠要用转义 `\\`)
|
||||
|
||||
::: details 示例
|
||||
以 `C:\ProgramData\BlueStacks_nxt\bluestacks.conf` 为例
|
||||
@@ -177,15 +190,15 @@ MAA 现在会尝试从注册表中读取 `bluestacks.conf` 的存储位置,当
|
||||
|
||||
- 若使用了 `异形屏UI适配`,请将其调整为 0。
|
||||
- 若正在游玩非国服客户端,请先在 `设置` - `游戏设置` - `客户端类型` 中选择客户端版本。非国服部分功能可能并非完全适配,请参阅对应的外服使用文档。
|
||||
- 若正在进行自动肉鸽,请参阅 [文档](./详细介绍.md#一键长草:自动肉鸽),并在 `任务设置` - `自动肉鸽` - `肉鸽主题` 中正确选择主题。
|
||||
- 若正在进行自动肉鸽,请参阅 [文档](./详细介绍.md#一键长草:自动肉鸽),并在 `自动肉鸽` - `肉鸽主题` 中正确选择主题。
|
||||
- `Adb Input` 触控模式操作缓慢为正常情况,如需自动战斗等请尝试切换其他模式。
|
||||
|
||||
## 文件下载速度慢
|
||||
|
||||
请尝试使用 [MAA 下载站](https://ota.maa.plus/MaaAssistantArknights/MaaRelease/releases/download/) 下载。<br>
|
||||
请尝试使用 [MAA 下载站](https://ota.maa.plus/MaaAssistantArknights/MaaRelease/releases/download/) 下载。
|
||||
|
||||
我们的小水管带宽较低,且流量有限。虽然搭出来就是给大家用的,但也希望不要滥用,若 Github 或其他镜像站可正常下载,建议优先选择。
|
||||
|
||||
## 下载到一半提示“登陆”/“鉴权”
|
||||
|
||||
请使用 浏览器 / IDM / FDM 等正规下载器下载文件,**不要用傻逼迅雷!**
|
||||
请使用 浏览器 / IDM / FDM 等下载器下载文件,**不要用↑↓迅雷!**
|
||||
|
||||
@@ -8,13 +8,13 @@ icon: mingcute:android-fill
|
||||
::: info 注意
|
||||
1. 从 Android 10 开始,Minitouch 在 SELinux 为 `Enforcing` 模式时不再可用,请切换至其他触控模式,或将 SELinux **临时**切换为 `Permissive` 模式。
|
||||
2. 由于 Android 生态极为复杂,可在 MAA `设置` - `连接设置` 中尝试将 `连接配置` 修改为 `通用模式` 或 `兼容模式` 或 `第二分辨率` 或 `通用模式(屏蔽异常输出)`,直到某个模式可以正常使用。
|
||||
3. 由于 MAA 仅支持 `16:9` 比例的分辨率,所以非 `16:9` 或 `9:16` 屏幕比例的设备需要强制修改分辨率,这包含大多数现代设备。因此若被连接设备屏幕分辨率比例原生为 `16:9` 或 `9:16`,则可跳过 `更改分辨率` 部分。
|
||||
3. 由于 MAA 仅支持 `16:9` 比例的分辨率,所以非 `16:9` 或 `9:16` 屏幕比例的设备需要强制修改分辨率,这包含大多数现代设备。若被连接设备屏幕分辨率比例原生为 `16:9` 或 `9:16`,则可跳过 `更改分辨率` 部分。
|
||||
4. 请将设备导航方式切换为除 `全面屏手势` 以外的方式,如 `经典导航键` 等以避免误操作。
|
||||
5. 请将游戏内设置中的 `异形屏UI适配` 一项调整为 0 以避免任务出错。
|
||||
:::
|
||||
|
||||
::: tip
|
||||
典型的 `16:9` 比例的分辨率有 `3840*2160`(4K)、`2560*1440`(2K)、`1920*1080`(1080P)、`1280*720`(720P)。
|
||||
典型的 `16:9` 比例的分辨率有 `3840*2160` (4K)、`2560*1440` (2K)、`1920*1080` (1080P)、`1280*720` (720P)。
|
||||
:::
|
||||
|
||||
## 下载、运行 adb 调试工具并连接设备
|
||||
@@ -86,7 +86,7 @@ icon: mingcute:android-fill
|
||||
- 部分设计不规范的应用可能在还原分辨率后内容布局仍然错乱,一般重启对应应用或设备即可解决。
|
||||
|
||||
::: danger 注意
|
||||
强烈建议在**下次重启设备前**还原分辨率,否则因设备而定可能会导致不可预料的后果,~~包括但不限于布局混乱,触控错位,应用闪退,无法开机等~~。
|
||||
强烈建议在**下次重启设备前**还原分辨率,否则因设备而定可能会导致不可预料的后果,~~包括但不限于布局混乱,触控错位,应用闪退,无法解锁等~~。
|
||||
:::
|
||||
|
||||
## 自动化更改分辨率
|
||||
|
||||
@@ -33,7 +33,7 @@ icon: teenyicons:linux-alt-solid
|
||||
if asst.connect("/home/foo/Android/Sdk/platform-tools/adb", "模拟器的 adb 地址"):
|
||||
```
|
||||
|
||||
- 如果使用其他模拟器须先下载 `adb` : `$ sudo apt install adb` 后填写路径或利用 `PATH` 环境变量直接填写 `adb` 即可
|
||||
- 如果使用其他模拟器须先下载 `adb` : `$ sudo apt install adb` 后填写路径或利用 `PATH` 环境变量直接填写 `adb` 即可。
|
||||
|
||||
3. 模拟器 `adb` 路径获取
|
||||
|
||||
@@ -51,7 +51,7 @@ icon: teenyicons:linux-alt-solid
|
||||
if asst.connect("/home/foo/Android/Sdk/platform-tools/adb", "emulator-5554"):
|
||||
```
|
||||
|
||||
4. 这时候可以测试下: `$ python3 sample.py` ,如果返回 `连接成功` 则基本成功了
|
||||
4. 这时候可以测试下: `$ python3 sample.py` ,如果返回 `连接成功` 则基本成功了。
|
||||
|
||||
### 3. 任务配置
|
||||
|
||||
|
||||
@@ -15,7 +15,7 @@ icon: basil:apple-solid
|
||||
|
||||
试验性支持,遇到问题请多多提 issue,并在标题中提及 iOS。
|
||||
|
||||
注意:由于 `macOS` 本身机制的问题,将游戏窗口最小化、台前调度状态下切换到别的窗口、将窗口移动到别的桌面/屏幕之后,截图会出现问题,导致无法正确运行。请参见 👉🏻️[issue](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/4371#issuecomment-1527977512)
|
||||
注意:由于 `macOS` 本身机制的问题,将游戏窗口最小化、台前调度状态下切换到别的窗口、将窗口移动到别的桌面/屏幕之后,截图会出现问题,导致无法正确运行。相关 Issue [#4371](https://github.com/MaaAssistantArknights/MaaAssistantArknights/issues/4371#issuecomment-1527977512)
|
||||
|
||||
0. 要求:MAA 版本 v4.13.0-rc.1 以上
|
||||
|
||||
@@ -59,4 +59,4 @@ icon: basil:apple-solid
|
||||
|
||||
### ✅ [AVD](https://developer.android.com/studio/run/managing-avds)
|
||||
|
||||
支持。
|
||||
支持,但从 Android 10 开始,Minitouch 在 SELinux 为 `Enforcing` 模式时不再可用。请切换至其他触控模式,或将 SELinux **临时**切换为 `Permissive` 模式。
|
||||
|
||||
@@ -26,31 +26,15 @@ const shuffleArray = (array) => {
|
||||
const fullySupport = shuffleArray([
|
||||
`
|
||||
### ✅ [蓝叠模拟器 5](https://www.bluestacks.cn/)
|
||||
完美支持。需要在模拟器 \`设置\` - \`引擎设置\` 中打开 \`允许ADB连接\`
|
||||
完美支持。需要在模拟器 \`设置\` - \`引擎设置\` 中打开 \`允许ADB连接\`。
|
||||
`,
|
||||
`
|
||||
### ✅ [蓝叠模拟器 5 国际版](https://www.bluestacks.com/tw/index.html)(最稳定👍)
|
||||
|
||||
完美支持。需要在模拟器 \`设定\` - \`进阶\` 中打开 \`Android调试桥\`。
|
||||
|
||||
- 若网络环境较差可尝试下载 [离线安装包](https://support.bluestacks.com/hc/zh-tw/articles/4402611273485-BlueStacks-5-%E9%9B%A2%E7%B7%9A%E5%AE%89%E8%A3%9D%E7%A8%8B%E5%BC%8F);
|
||||
- 若 adb 端口号不断的无规律变动,每次启动都不相同,可能是因为您的电脑开启了 [Hyper-V](https://support.bluestacks.com/hc/zh-tw/articles/4415238471053-BlueStacks-5-%E6%94%AF%E6%8F%B4-Hyper-V-%E7%9A%84-Windows-10-%E5%92%8C-11-%E4%B8%8A%E7%9A%84%E9%9B%BB%E8%85%A6%E8%A6%8F%E6%A0%BC%E9%9C%80%E6%B1%82),
|
||||
MAA 现在会尝试自动读取蓝叠模拟器配置文件内的端口号,若该功能失效/你有多开需求/安装了多个模拟器核心,请参考 [常见问题](../%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98.html#蓝叠模拟器每次启动端口号都不一样-hyper-v) 做出修改。由于 Hyper-V 以管理员身份运行,如自动关闭模拟器、自动检测连接等不涉及 adb 的操作同样需要以管理员身份运行 MAA。
|
||||
`,
|
||||
`
|
||||
### ✅ [夜神模拟器](https://www.yeshen.com/)
|
||||
|
||||
完美支持。
|
||||
`,
|
||||
`
|
||||
### ✅ [夜神模拟器 安卓 9](https://www.yeshen.com/)
|
||||
|
||||
完美支持。
|
||||
`,
|
||||
`
|
||||
### ✅ [逍遥模拟器](https://www.xyaz.cn/)
|
||||
|
||||
完美支持,但测试较少。
|
||||
- 推荐下载 [离线安装包](https://support.bluestacks.com/hc/zh-tw/articles/4402611273485-BlueStacks-5-%E9%9B%A2%E7%B7%9A%E5%AE%89%E8%A3%9D%E7%A8%8B%E5%BC%8F),避免缓慢和捆绑安装;
|
||||
- 若 adb 端口号不断的无规律变动,每次启动都不相同,可能是因为您的电脑开启了 [Hyper-V](https://support.bluestacks.com/hc/zh-tw/articles/4415238471053-BlueStacks-5-%E6%94%AF%E6%8F%B4-Hyper-V-%E7%9A%84-Windows-10-%E5%92%8C-11-%E4%B8%8A%E7%9A%84%E9%9B%BB%E8%85%A6%E8%A6%8F%E6%A0%BC%E9%9C%80%E6%B1%82)。MAA 现在会尝试自动读取蓝叠模拟器配置文件内的端口号,若该功能失效/你有多开需求/安装了多个模拟器核心,请参考 [常见问题](../常见问题.html#蓝叠模拟器每次启动端口号都不一样-hyper-v) 做出修改。由于 Hyper-V 以管理员身份运行,如自动关闭模拟器、自动检测连接等不涉及 adb 的操作同样需要以管理员身份运行 MAA。
|
||||
`,
|
||||
`
|
||||
### ✅ [MuMu 模拟器 12](https://mumu.163.com/)(最流畅👍)
|
||||
@@ -58,22 +42,43 @@ const fullySupport = shuffleArray([
|
||||
完美支持。
|
||||
|
||||
- “完成后退出模拟器”功能可能偶现异常,如果遇到请向 MuMu 官方反馈;
|
||||
- 3.5.4 ~ 3.5.7 版本 MuMu 12 引入的“后台保活”功能会导致截图失败,推荐使用 3.6.4 版本;如您正在使用 3.5.4 ~ 3.5.7 版本的 MuMu 12,请确认 MuMu 12 设置-其他 中将“后台挂机时保活运行”功能关闭(详见[官方公告](https://mumu.163.com/help/20230802/35047_1102450.html));
|
||||
- 多开时需通过 MuMu 12 多开器的 ADB 按钮,查看对应实例的端口信息,将 MAA 设置-连接设置 的连接地址的端口号修改为对应的端口。
|
||||
- 3.5.4 ~ 3.5.7 版本 MuMu 12 的“后台保活”功能会导致截图失败,推荐使用更新后的版本;若您正在使用 3.5.4 ~ 3.5.7 版本的 MuMu 12,请确认 MuMu 12 设置 - 其他 中的“后台挂机时保活运行”功能已关闭(详见[官方公告](https://mumu.163.com/help/20230802/35047_1102450.html));
|
||||
- 多开时需通过 MuMu 12 多开器的 ADB 按钮查看对应实例的端口信息,将 MAA \`设置\` - \`连接设置\` 的连接地址的端口号修改为对应的端口。
|
||||
`,
|
||||
`
|
||||
### ✅ [雷电模拟器](https://www.ldmnq.com/)
|
||||
|
||||
完美支持。
|
||||
|
||||
- **雷电 9 推荐使用 9.0.57 及以上版本;雷电 5 推荐使用 5.0.67 及以上版本;**
|
||||
- 低于上述版本则需要在 MAA 设置 - 连接设置 中,进行 \`强制替换 ADB\`,才能使用 minitouch, maatouch 等高效的触控模式。
|
||||
- 雷电 9 推荐使用 9.0.57 及以上版本;雷电 5 推荐使用 5.0.67 及以上版本;
|
||||
- 低于上述版本则需要在 \`设置\` - \`连接设置\` 中运行 \`强制替换 ADB\`,才能使用 Minitouch, MaaTouch 等高效的触控模式;
|
||||
`,
|
||||
`
|
||||
### ✅ [夜神模拟器](https://www.yeshen.com/)
|
||||
|
||||
完美支持,但仅测试了 7 和 9。
|
||||
`,
|
||||
`
|
||||
### ✅ [逍遥模拟器](https://www.xyaz.cn/)
|
||||
|
||||
完美支持,但测试较少。
|
||||
`,
|
||||
])
|
||||
|
||||
const particallySupport = shuffleArray([
|
||||
`
|
||||
### ⚠️ [Win11 WSA](https://docs.microsoft.com/zh-cn/windows/android/wsa/)
|
||||
### ⚠️ [MuMu 模拟器 6](https://mumu.163.com/update/win/)
|
||||
|
||||
自 MAA v5.1.0 版本起放弃支持,官方已在 2023.8.15 停止维护。
|
||||
|
||||
- 不再支持自动检测连接,需使用通用连接配置,并手动配置 adb 路径和连接地址;
|
||||
- 需要在 \`设置\` - \`连接设置\` 中运行 \`强制替换 ADB\`,才能使用 Minitouch, MaaTouch 等高效的触控模式;
|
||||
- 需要使用管理员权限运行 MAA 才能使用“完成后退出模拟器”相关功能;
|
||||
- 不支持使用 MuMu 6 默认的几个奇葩分辨率,需要改成 \`1280x720\`,\`1920x1080\`,\`2560x1440\` 等 16:9 比例;
|
||||
- MuMu 6 多开使用的是同一个 adb 端口,所以无法支持多开的 MuMu 6。
|
||||
`,
|
||||
`
|
||||
### ⚠️ [适用于 Android™️ 的 Windows 子系统](https://docs.microsoft.com/zh-cn/windows/android/wsa/)
|
||||
|
||||
勉强支持。
|
||||
|
||||
|
||||
@@ -8,7 +8,8 @@ icon: ic:baseline-article
|
||||
|
||||
### 一键长草:刷理智
|
||||
|
||||
- 若关卡选择中没有你需要的关卡,请在 MAA 中选择 `当前/上次`,然后在游戏中手动定位关卡,确保画面停留在有 **开始按钮** 和 **代理指挥** 的关卡详情界面。
|
||||
- 若关卡选择中没有你需要的关卡,请在 MAA 中选择 `当前/上次`,然后在游戏中手动定位关卡。
|
||||
确保画面停留在 右上角有关卡名和剩余理智,右下角有代理指挥和开始行动 的关卡详情界面。
|
||||
- 若当前不处于此界面,则 `当前/上次` 会自动进入终端首页右下角“上次作战”的关卡。
|
||||
- 也可以在 `任务设置` - `刷理智` - `高级设置` 中启用 `手动输入关卡名` 手动输入关卡编号。目前支持导航的关卡有:
|
||||
- 全部主线关卡。可在关卡末尾添加 `-NORMAL` 或 `-HARD` 来切换标准或磨难关卡。
|
||||
@@ -24,16 +25,16 @@ icon: ic:baseline-article
|
||||

|
||||
:::
|
||||
|
||||
- 主界面上的 `吃理智`、`吃石头`、`指定次数`、`指定材料` 四个选项为**短路开关(或门)**,即达成四个选项中的任一条件,均会视为任务完成,停止刷理智。
|
||||
- 主界面上的 `吃理智`、`吃石头`、`指定次数`、`指定材料` 四个选项为短路开关(或门),即达成四个选项中的任一条件,均会视为任务完成,停止刷理智。
|
||||
其中:
|
||||
- `吃理智` 指定吃几瓶理智药(一次可能吃多瓶)。
|
||||
- `吃石头` 指定碎石多少次(每次 1 颗)。
|
||||
- `吃理智药` 指定补充几次理智(有可能吃多瓶药)。
|
||||
- `吃源石` 指定碎几颗石头(每次 1 颗)。
|
||||
- `指定次数` 指定刷多少次图(例如“刷 15 次后停止”)。
|
||||
- `指定材料` 指定刷多少个指定的材料(例如“获取 5 个固源岩后停止”)。
|
||||
|
||||
| 例 | 吃理智药 | 吃石头 | 指定次数 | 指定材料 | 结果 |
|
||||
| :-: | :------: | :----: | :------: | :--------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| A | 999 | 10 | 1 | x | 会尝试吃理智药和/或石头,直到刷满 **一次**,满足了 `指定次数:1` 的条件,即视为任务完成,停止刷理智;如果一开始理智药不够、石头不够、现有的理智也不够就会不刷图自动结束。 |
|
||||
| A | 999 | 10 | 1 | x | 会尝试吃理智药和/或石头,直到刷满 1 次,满足了 `指定次数:1` 的条件,即视为任务完成,停止刷理智;如果一开始理智药不够、石头不够、现有的理智也不够就会不刷图自动结束。 |
|
||||
| B | x | x | 100 | x | 会尝试刷满 100 次,但在当前可用理智全部刷完后(可能只刷了几次),由于满足了 `不吃理智药` 、 `不吃石头` 的条件,无理智可用,视为任务完成,停止刷理智。 |
|
||||
| C | 1 | x | 100 | x | 会尝试刷满 100 次,期间最多吃 1 次理智药,如果吃了一次理智药理智也刷完了,由于满足了 `吃理智药:1` 、 `不吃石头` 的条件,无理智可用,视为任务完成,停止刷理智。 |
|
||||
| D | 999 | x | 100 | 3 个固源岩 | 会尝试刷满 100 次,期间会吃 999 次理智药,但如果在这期间累计刷出了 3 个固源岩,由于满足了 `指定材料:3个固源岩` 的条件,视为任务完成,停止刷理智。 |
|
||||
@@ -41,14 +42,14 @@ icon: ic:baseline-article
|
||||
- `指定材料` 与 `关卡选择` 是两个互相独立的逻辑。
|
||||
- `指定材料` 只是以材料个数作为任务完成依据,并不会自动导航到相应关卡。
|
||||
- 支持自动勾选 `代理指挥`。
|
||||
- 支持自动识别并统计材料掉落,同时上传 [企鹅物流数据统计](https://penguin-stats.cn/)。支持自定义企鹅物流用户 ID。
|
||||
- 支持自动识别并统计材料掉落,同时上传 [企鹅物流数据统计](https://penguin-stats.cn/) 和 [一图流](https://ark.yituliu.cn/)。支持自定义企鹅物流用户 ID。
|
||||
- 支持掉线后或凌晨 4 点闪断后自动重连并继续任务。
|
||||
- 支持等级提升后继续任务。
|
||||
- 代理失败时会放弃本次行动并重新战斗。
|
||||
- 剿灭相关:
|
||||
- MAA 会通过终端首页右上角剿灭按钮进行跳转,请确认当期剿灭已解锁 `全权委托` 并持有足够数量的 “PRTS 剿灭代理卡”。
|
||||
- MAA 只会通过终端首页右上角剿灭按钮进行跳转,请确保当期剿灭已解锁 `全权委托` 并持有足够数量的 “PRTS 剿灭代理卡”。
|
||||
- 在当期剿灭刷新或重新安装明日方舟后,从剿灭 `开始战斗` 页面返回会自动展开 `情报汇总`,请提前关闭此页面以防止任务卡住。
|
||||
- 仅建议当期剿灭 **已“400 杀”** 的玩家使用 MAA 自动剿灭。
|
||||
- 仅建议当期剿灭已“400 杀”的玩家使用 MAA 自动剿灭。
|
||||
- 连战相关:
|
||||
- MAA 目前仅会按照用户设定的次数进行连战,尚未支持自动识别最大连战次数。
|
||||
- 若设置的次数过多但理智不足,MAA 会直接进行 `吃理智药` 或 `吃源石` 操作,并继续尝试连战。
|
||||
@@ -68,13 +69,13 @@ icon: ic:baseline-article
|
||||
- **自动公招 和 公招识别 是两个不同的功能!**
|
||||
- 自动公招支持使用 `加急许可`,全自动连续公招。请进入 `自动公招` - `任务设置` 中选择 `自动使用加急许可` ,并修改 `每次执行时最大招募次数` 。
|
||||
- 出 1、5、6 星都会弹出通知提示。
|
||||
- 公招刷新时自动将公招标签数据上传到 [企鹅物流数据统计](https://penguin-stats.cn/) 和 [材料一图流](https://yituliu.site/)。
|
||||
- 公招刷新时自动将公招标签数据上传到 [企鹅物流数据统计](https://penguin-stats.cn/) 和 [一图流](https://ark.yituliu.cn/)。
|
||||
|
||||
### 一键长草:基建换班
|
||||
|
||||
#### 换班策略
|
||||
|
||||
- 自动计算并选择 **单设施内的最优解**,支持所有通用类技能和特殊技能组合。
|
||||
- 自动计算并选择**单设施内的最优解**,支持所有通用类技能和特殊技能组合。
|
||||
- 支持识别经验书、赤金、源石碎片、芯片,分别使用相应的干员组合。
|
||||
|
||||
#### 基建工作心情阈值
|
||||
@@ -94,19 +95,19 @@ icon: ic:baseline-article
|
||||
|
||||
#### 自定义基建换班(测试)
|
||||
|
||||
- 一图流的大佬们帮忙写了一个 [排班生成器](https://yituliu.site/tools/maa),可参考 [文档](../协议文档/基建排班协议.md) 使用。
|
||||
- 在 MAA 文件夹下 `/resource/custom_infrast/` 中内置了几套**理论极限效率**的作业,可用作参考。由于其对干员及练度的需求极高,不推荐直接使用。
|
||||
- 一图流的大佬们帮忙写了一个 [排班生成器](https://ark.yituliu.cn/tools/schedule),可参考 [文档](../协议文档/基建排班协议.md) 使用。
|
||||
- MAA 文件夹下 `/resource/custom_infrast/` 中内置了几套理论极限效率的作业,可用作参考。由于其对干员及练度的需求极高,不推荐直接使用。
|
||||
|
||||
### 一键长草:获取信用及购物
|
||||
|
||||
- 会自动访问好友获取信用点。
|
||||
- 借助战赚信用:
|
||||
- MAA 会使用助战干员通关一次火蓝之心 `OF-1` 关卡,请确认该关卡已解锁,以免任务出错。
|
||||
- MAA 会使用助战干员通关一次火蓝之心 `OF-1` 关卡,请确认该关卡已解锁。
|
||||
- 关卡选择为 `当前/上次` 时不会执行借助战任务。
|
||||
|
||||
### 一键长草:自动肉鸽
|
||||
|
||||
- MAA 默认选择最新一期主题,可在 `自动肉鸽` - `任务设置` 中更改目标主题。
|
||||
- MAA 默认选择最新一期主题,可在 `自动肉鸽` - `肉鸽主题` 中更改目标主题。
|
||||
- 请在游戏内将对应肉鸽主题置顶在终端处。
|
||||
- 请提前手动结束**非目标主题**的探索。
|
||||
- 若 MAA 在难度选择界面卡住/反复进出,请手动选择难度再开始任务。
|
||||
@@ -115,13 +116,13 @@ icon: ic:baseline-article
|
||||
- 支持识别商店物品,优先购买更强力的收藏品。
|
||||
- 支持掉线后或凌晨 4 点闪断后自动重连并继续任务。
|
||||
- 战斗时长超过 5 分钟会自动撤退所有地面单位,超过 6 分钟会自动放弃当局战斗,避免互相刮痧耗时。
|
||||
- 如果任务出现问题卡住,会自动放弃当次探索并重试。
|
||||
- 如果任务出现问题,会自动放弃当次探索并重试。
|
||||
- 如果多次在同一个位置卡住,请提交 Issue 反馈,并附带日志和截图。
|
||||
|
||||
### 切换账号
|
||||
|
||||
- 仅支持切换至已登录的账号,使用登录名进行查找,保证输入内容在所有已登录账号唯一即可
|
||||
- 官服:`123****4567`,可输入 `123****4567`、`4567`、`123`、`3****4567`
|
||||
- 仅支持切换至已登录的账号,使用登录名进行查找,请保证输入内容在所有已登录账号唯一。
|
||||
- 官服:`123****8901`,可输入 `123****8901`、`123`、`8901`、`3****8`
|
||||
- B 服:`张三`,可输入 `张三`、`张`、`三`
|
||||
|
||||
### 自动战斗
|
||||
@@ -132,18 +133,22 @@ icon: ic:baseline-article
|
||||
|
||||
支持任意 `可编队关卡` 和 `保全派驻` 模式的自动战斗。
|
||||
|
||||
- 本功能需要在有 `开始行动` 按钮的编队选择界面开始运行。<br>之后在 MAA 左侧上部的框中 `导入本地 JSON 作业文件` 或 `填写作业站神秘代码` 即可导入作业。
|
||||
- 另外支持视频识别(α),拖入视频文件即可激活。<br>要求 16:9 画幅 720p 以上画质,无黑边、模拟器边框、异形屏适配等干扰因素。
|
||||
- 本功能需要在有 `开始行动` 按钮的编队选择界面开始运行。
|
||||
之后在 MAA 左侧上部的框中 `导入本地 JSON 作业文件` 或 `填写作业站神秘代码` 即可导入作业。
|
||||
- 另外支持视频识别(α),拖入视频文件即可激活。
|
||||
要求 16:9 画幅 720p 以上画质,无黑边、模拟器边框、异形屏适配等干扰因素。
|
||||
- `自动编队` 功能会**清空当前编队**并根据作业需要的干员自动完成编队。
|
||||
- 可根据个人需要(例如需要使用 `好友助战` 时)取消 `自动编队`,手动编队后开始。
|
||||
- 可根据任务需要为自动编队 `追加自定干员` 和 `补充低信赖干员`。
|
||||
- 对于【悖论模拟】关卡,必须关闭 `自动编队`,手动选择技能后,在有**开始模拟**按钮的界面开始自动战斗。
|
||||
- 对于【保全派驻】关卡,`自动编队` 无效,必须手动完成**初始**任务准备,直到在关卡详情有**开始部署**按钮的界面才能开始自动战斗。
|
||||
- 可设置自动战斗的 `循环次数`(例如在挂保全时)。
|
||||
- 可使用 `战斗列表` 功能为同一区域的关卡进行连续的自动战斗队列。
|
||||
- 导入作业后,确认下方列表关卡代号是否正确,之后添加该关卡(右键改为添加突袭模式)。<br>添加后可自行开关是否执行对应关卡的战斗。
|
||||
- 可设置 `循环次数`,例如保全。但 MAA 不会借干员,如需借干员请勿使用。
|
||||
- 可使用 `战斗列表` 功能进行同一区域关卡的自动连续战斗。
|
||||
- 战斗列表下方三个按钮从左到右依次为 `批量导入`、`添加关卡`、`清空关卡`。
|
||||
`添加关卡` 右键为添加突袭关卡,`清空关卡` 右键为清空未勾选关卡,
|
||||
- 导入作业后,战斗列表下方会出现关卡名,确认正确后再添加该关卡。列表中的关卡可以拖拽调整顺序,勾选是否执行。
|
||||
- 开启本功能后改为在**关卡所在的地图界面**开始自动战斗。在理智不足/战斗失败/非三星结算时将停止自动战斗队列。
|
||||
- 请确保列表中的关卡在同一区域(仅通过左右滑动地图界面可导航到)。
|
||||
- 请确保列表中的关卡在同一区域(只通过左右滑动地图界面就可以导航到)。
|
||||
- **请务必为优质作业点赞,以提高作业评分并激励作业制作者。**
|
||||
|
||||

|
||||
@@ -157,20 +162,18 @@ icon: ic:baseline-article
|
||||
- [PRTS.Map](https://map.ark-nights.com/areas),在设置中将 `坐标展示` 修改为 `MAA` 后使用。
|
||||
- 支持演习模式。
|
||||
- 建议在作业描述里填上你的署名(作者名)、参考的攻略视频链接、其他想说的等等。
|
||||
- 欢迎加入企鹅群 [1169188429](https://jq.qq.com/?_wv=1027&k=QZcGcJ9G) 与我们一起讨论作业制作等问题。
|
||||
- 欢迎加入企鹅群 [1169188429](https://jq.qq.com/?_wv=1027&k=QZcGcJ9G) 共同讨论作业制作等问题。
|
||||
|
||||
### 仓库识别(测试)
|
||||
|
||||
- 若自动跳转失败,请手动切换到仓库 `养成材料` 界面并**滑动到最左侧**后开始功能。
|
||||
- 目前仅支持导出到[企鹅物流刷图规划器](https://penguin-stats.cn/planner)、[明日方舟工具箱](https://arkn.lolicon.app/#/material)、[明日方舟 - 干员培养表](https://ark-nights.com/settings)。
|
||||
- 也许后面可能会用来做一些更实用的功能。(画饼
|
||||
- 如您是某个数据站的站长,也欢迎联系我们适配贵站的材料 JSON 协议。
|
||||
- 如您是某个数据站的站长,也欢迎联系我们适配贵站的材料 JSON 协议~
|
||||
|
||||
## 设置介绍
|
||||
|
||||
除了 `设置` 选项卡 ,Windows 版本的 MAA 里还有 `任务设置` ,点击 `一键长草` 的任务列表右侧的 `齿轮` ,就可以在一键长草界面里切换不同的任务设置啦~
|
||||
|
||||
要注意点击 `常规设置` `高级设置` 也会切换 `任务设置`哟~
|
||||
除了 `设置` 选项卡 ,Windows 版本的 MAA 里还有 `任务设置` ,点击 `一键长草` 任务列表右侧的 `齿轮` ,就可以在一键长草界面里切换不同的任务设置啦~
|
||||
|
||||
### 自定义连接
|
||||
|
||||
@@ -274,4 +277,4 @@ icon: ic:baseline-article
|
||||
- 底层算法纯 C++ 开发,并设计了多重缓存技术,最大限度降低 CPU 和内存占用。
|
||||
- 软件支持自动更新 ✿✿ ヽ(°▽°)ノ ✿ ,推荐非杠精的同学使用公测版,一般来说更新快且 bug 少。(什么 MIUI (╯‵□′)╯︵┻━┻
|
||||
- 如果新版本自动下载失败,可手动下载 OTA 压缩包后直接放到 MAA 目录下,会自动更新的。
|
||||
- 在 Windows 版本中,MAA 目录下 `config` 文件夹中的 `gui.json` 记录了所有设置,如果下载了新的完整包可以将此文件夹复制到新的 MAA 目录下。(如果复制后启动报错可尝试恢复 `bak` 备份文件或删除后重新设置)。
|
||||
- 在 Windows 版本中,MAA 目录下 `config` 文件夹中的 `gui.json` 记录了所有设置,如果下载了新的完整包可以将此文件夹复制到新的 MAA 目录下。
|
||||
|
||||
@@ -55,7 +55,7 @@ namespace asst
|
||||
RequestInfo penguin_report; // 企鹅物流汇报:
|
||||
// 每次到结算界面,汇报掉落数据至企鹅物流 https://penguin-stats.cn/
|
||||
DepotExportTemplate depot_export_template; // 仓库识别结果导出模板
|
||||
RequestInfo yituliu_report; // 一图流大数据汇报:目前只有公招功能,https://yituliu.site/maarecruitdata
|
||||
RequestInfo yituliu_report; // 一图流大数据汇报:目前只有公招功能,https://ark.yituliu.cn/survey/maarecruitdata
|
||||
DebugConf debug;
|
||||
};
|
||||
|
||||
|
||||
Reference in New Issue
Block a user