From 618fccd08abecf802f0a75fc434d443205b15d52 Mon Sep 17 00:00:00 2001 From: MistEO Date: Sun, 9 Jan 2022 21:31:33 +0800 Subject: [PATCH] =?UTF-8?q?docs.=E6=9B=B4=E6=96=B0=E6=96=87=E6=A1=A3?= =?UTF-8?q?=E5=AF=B9=E5=A4=9C=E7=A5=9E=E7=9A=84=E6=8F=8F=E8=BF=B0=EF=BC=8C?= =?UTF-8?q?=E4=BF=AE=E6=94=B9=E4=B8=80=E7=82=B9=E6=96=87=E6=A1=A3=E6=A0=BC?= =?UTF-8?q?=E5=BC=8F?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 38 +++++++++++++++++++------------------- docs/模拟器支持.md | 32 ++++++++++++++++++++------------ 2 files changed, 39 insertions(+), 31 deletions(-) diff --git a/README.md b/README.md index e778d7d63d..4f69e3638f 100644 --- a/README.md +++ b/README.md @@ -24,7 +24,7 @@ A Game Assistant for Arknights 纯图像识别，非内存挂！全图形化界面，开罐即食！ -并提供了 [接口](#接口) 供自行 DIY~ 绝赞更新中！✿✿ヽ(°▽°)ノ✿ +并提供了 [API](#API) 供自行 DIY~ 绝赞更新中！✿✿ヽ(°▽°)ノ✿ @@ -55,16 +55,16 @@ A Game Assistant for Arknights 1. 请根据 [模拟器支持情况](docs/模拟器支持.md)，进行对应的操作。 2. 解压压缩包，到 **没有中文或特殊符号** 的文件夹路径。 3. 第一次运行软件，**请使用管理员权限** 打开 `MeoAsstGui.exe`。运行过一次后，后续不再需要管理员权限。 -4. 开始运行后，除`自动关机`外，所有设置均不可再修改。 +4. 开始运行后，除 `自动关机` 外，所有设置均不可再修改。 目前仅对 `16:9` 分辨率支持较好，其他分辨率勉强可用，但可能会有奇奇怪怪的问题，正在进一步适配中_(:з」∠)_ ### 刷理智 -- 若选项中没有你需要的关卡，请手动进入游戏 **蓝色开始按钮** 界面，并选择`当前关卡`。 -- 主界面上的`吃理智`、`吃石头`、`指定次数`三个选项为短路开关，即三个选项中的任一条件达到，均会视为任务完成，停止刷理智。 - - 举例1：设置`吃理智药`:`999`、`吃石头`:`10`、`指定次数`:`1`。则在刷完**一次**后，由于满足了`指定次数`:`1`的条件，视为任务完成，停止刷理智。 - - 举例2：不勾选`吃理智药`、不勾选`吃石头`，设置`指定次数`:`100`。则在当前可用理智全部刷完后（可能只刷了几次），由于满足了`不吃理智药`、`不吃石头`的条件，视为任务完成，停止刷理智。 +- 若选项中没有你需要的关卡，请手动进入游戏 **蓝色开始按钮** 界面，并选择 `当前关卡`。 +- 主界面上的 `吃理智`、`吃石头`、`指定次数` 三个选项为短路开关，即三个选项中的任一条件达到，均会视为任务完成，停止刷理智。 + - 举例1：设置 `吃理智药` : `999`、`吃石头` : `10`、`指定次数` : `1`。则在刷完 **一次** 后，由于满足了 `指定次数`:`1` 的条件，视为任务完成，停止刷理智。 + - 举例2：不勾选 `吃理智药`、不勾选 `吃石头`，设置 `指定次数` : `100`。则在当前可用理智全部刷完后（可能只刷了几次），由于满足了 `不吃理智药`、`不吃石头` 的条件，视为任务完成，停止刷理智。 - 其他优势 - 刷完自动上传 [企鹅物流数据统计](https://penguin-stats.cn/) - 可自定义企鹅物流 ID @@ -87,27 +87,27 @@ A Game Assistant for Arknights #### 特殊说明 -- 基建换班目前均为单设施最优解，但非跨设施的全局最优解。例如：`巫恋+龙舌兰`、`红云+稀音`等这类单设施内的组合，都是可以正常识别并使用的；`迷迭香`、`红松骑士团`这类多个设施间联动的体系，暂不支持使用。 +- 基建换班目前均为单设施最优解，但非跨设施的全局最优解。例如：`巫恋+龙舌兰`、`红云+稀音` 等这类单设施内的组合，都是可以正常识别并使用的；`迷迭香`、`红松骑士团` 这类多个设施间联动的体系，暂不支持使用。 - 会客室仅缺一个线索时，会选择对应流派的干员；否则会选择通用干员。 -- 会客室仅当自有线索满时，才会送出线索，并且只送三个。有需要的同学可自行修改`resource\tasks.json`中`SelectClue`.`maxTimes`字段，自定义送出个数。 -- 控制中枢策略太过复杂，目前只考虑`阿米娅`、`诗怀雅`、`凯尔希`、`彩虹小队`及其他心情 +0.05 的干员，后续逐步优化。 +- 会客室仅当自有线索满时，才会送出线索，并且只送三个。有需要的同学可自行修改 `resource/tasks.json` 中 `SelectClue` - `maxTimes` 字段，自定义送出个数。 +- 控制中枢策略太过复杂，目前只考虑 `阿米娅`、`诗怀雅`、`凯尔希`、`彩虹小队` 及其他心情 +0.05 的干员，后续逐步优化。 ### 信用商店随缘买 -从左到右依次买，但不会买`碳`和`家具零件`。有需要的同学可自行修改`resource\tasks.json`中`CreditShop-NotToBuy`.`text`字段，自定义不买的物品。后续版本会尝试开放界面选项 +从左到右依次买，但不会买 `碳` 和 `家具零件` 。有需要的同学可自行修改 `resource/tasks.json` 中 `CreditShop-NotToBuy` - `text` 字段，自定义不买的物品。后续版本会尝试开放界面选项 ### 公开招募识别 - 自动公招和公招识别是两个独立的功能！ -- 自动公招支持使用`加急许可`，全自动连续公招！请进入设置中选择~ +- 自动公招支持使用 `加急许可`，全自动连续公招！请进入设置中选择~ - 出 5、6 星都会有弹窗提示 ### 其他乱七八糟的说明 - 主界面上要执行的任务，是可以拖动改变顺序的。同样设置中基建换班的顺序，也是可以拖动改变的。 - 新的活动关卡刚上线的时候可能无法正常识别，一般一两天内软件会自动 OTA 更新资源，更新后即可正常识别。 -- 活动关卡掉落识别到的`未知材料`，一般就是活动商店的票据。 -- `resource\config.json`中有一些自定义选项，可以尝试根据自己的需要进行修改。 +- 活动关卡掉落识别到的 `未知材料`，一般就是活动商店的票据。 +- `resource/config.json` 中有一些自定义选项，可以尝试根据自己的需要进行修改。 - 所有点击操作，都是点击按钮内随机位置，并模拟泊松分布（按钮偏中间位置点的概率大，越往旁边点到的概率越小）。 - 底层算法纯 C++ 开发，并设计了多重的缓存技术，最大限度降低 CPU 和内存占用。 - 软件支持自动更新✿✿ヽ(°▽°)ノ✿ 推荐非杠精的同学使用测试版，一般来说更新快且 bug 少（什么 MIUI (╯‵□′)╯︵┻━┻ @@ -121,7 +121,7 @@ A Game Assistant for Arknights 请尝试安装 [Visual C++ Redistributable](https://docs.microsoft.com/zh-CN/cpp/windows/latest-supported-vc-redist?view=msvc-160#visual-studio-2015-2017-2019-and-2022)、[.NET Framework 4.8](https://dotnet.microsoft.com/download/dotnet-framework/net48) 后重新运行本软件。 - 可能性 2: CPU 指令集不支持。 项目使用 `PaddleOCR` 对游戏部分界面进行识别。`PaddleOCR` 用到了较新发布的 CPU 才支持的 `AVX` 指令集，而一些较老的 CPU 可能并不支持该指令集。 - 您可以尝试下载 [NoAVX](3rdparty/ppocr_noavx.zip) 版本的 `PaddleOCR`, 解压后替换本软件中同名的文件。这是对于使用不支持 AVX 指令集的 CPU 的用户的性能降低的替代方案，如非必要，请不要使用。 + 您可以尝试下载 [NoAVX](3rdparty/ppocr_noavx.zip) 版本的 `PaddleOCR`, 解压后替换本软件中同名的文件。这是对于使用不支持 `AVX` 指令集的 CPU 的用户的性能降低的替代方案，如非必要，请不要使用。 （具体可以下载 [CPU-Z](https://www.cpuid.com/softwares/cpu-z.html)，查看“指令集”中有无 `AVX` 这一项来判断） - 若上述均没有效果，请提 issue。 @@ -131,12 +131,12 @@ A Game Assistant for Arknights - 方法 1: 使用 [自定义连接](#自定义连接) 的方式连接模拟器 - 方法 2: 换模拟器，推荐 [蓝叠国际版](https://www.bluestacks.com/download.html) -- 方法 3: _根本解决方法_ 编辑`resource/config.json`，修改（最好是新增）模拟器窗口句柄名，并修改对应的 adb 设置。若您修改后可以提 PR 给我，我会感激不尽的_(:з」∠)_ +- 方法 3: _根本解决方法_ 编辑 `resource/config.json`, 修改（最好是新增）模拟器窗口句柄名，并修改对应的 adb 设置。若您修改后可以提 PR 给我，我会感激不尽的_(:з」∠)_ ### 自定义连接 -- 下载 [ADB](https://dl.google.com/android/repository/platform-tools-latest-windows.zip) ，将`platform-tools`文件夹解压到`MeoAsstGui.exe`的同级目录 -- 进入软件`设置`-`连接设置`，填写自定义地址（需要填写IP+端口，例如`127.0.0.1:5555`） +- 下载 [adb](https://dl.google.com/android/repository/platform-tools-latest-windows.zip) ，将 `platform-tools` 文件夹解压到 `MeoAsstGui.exe` 的同级目录 +- 进入软件 `设置` - `连接设置`，填写自定义 adb 地址（需要填写 IP + 端口，例如 `127.0.0.1:5555` ） ## 致谢 @@ -178,13 +178,13 @@ A Game Assistant for Arknights ### Windows -直接使用 Visual 2019 或以上版本打开`MeoAssistantArknights.sln`即可，所有环境都是配置好的 +直接使用 Visual 2019 或以上版本打开 `MeoAssistantArknights.sln` 即可，所有环境都是配置好的 ### Linux | macOS 请参考 [Linux 编译教程](docs/Linux编译教程.md) -### 接口 +### API - [C 接口](https://github.com/MistEO/MeoAssistantArknights/blob/dev/include/AsstCaller.h) - [Python 接口](https://github.com/MistEO/MeoAssistantArknights/wiki/Python-%E6%8E%A5%E5%8F%A3) diff --git a/docs/模拟器支持.md b/docs/模拟器支持.md index 66f5b43182..c88bb87c5b 100644 --- a/docs/模拟器支持.md +++ b/docs/模拟器支持.md @@ -2,34 +2,42 @@ ## 蓝叠模拟器 -完美支持。需要在模拟器`设置`-`引擎设置`中打开`允许ADB连接` +完美支持。需要在模拟器 `设置` - `引擎设置` 中打开 `允许ADB连接` ## 蓝叠模拟器国际版 -完美支持。需要在模拟器`设定`-`进阶`中打开`Android调试桥` +完美支持。需要在模拟器 `设定` - `进阶` 中打开 `Android调试桥` ## 蓝叠模拟器 Hyper-V 版本 支持 -1. 在模拟器`设定`-`进阶`中打开`Android调试桥` -2. 下载 [ADB](https://dl.google.com/android/repository/platform-tools-latest-windows.zip) ，将`platform-tools`文件夹解压到`MeoAsstGui.exe`的同级目录 -3. 在软件`设置`-`连接设置`中填写蓝叠安装目录下`bluestacks.conf`文件的完整路径 +1. 在模拟器 `设定` - `进阶` 中打开 `Android调试桥` +2. 下载 [adb](https://dl.google.com/android/repository/platform-tools-latest-windows.zip) ，将 `platform-tools` 文件夹解压到 `MeoAsstGui.exe` 的同级目录 +3. 在软件 `设置` - `连接设置` 中填写蓝叠安装目录下 `bluestacks.conf` 文件的完整路径 ## 夜神模拟器 完美支持 +## 夜神模拟器 安卓 9 + +支持。但可能存在一直识别出错的问题 + +- 请手动修改 `resource/config.json` 文件中 `"Nox"` - `"adb"` + 1. `"screencap"` 字段值为 `"[Adb] -s [Address] exec-out screencap -p"` + 2. `"screencapGzip"` 字段值为 `false` + ## MuMu 模拟器 -支持，但是可能会 +支持。但是可能会 - 一直连接出错：暂时不知道是什么原因，可尝试使用自定义连接 - 卡在主界面无法识别，过一会提示任务出错：和 MuMu 的渲染方式有关，推荐换模拟器（ ## MuMu 手游助手（星云引擎） -不支持。星云引擎这个版本不支持 ADB 控制，甚至不响应 Win32 Api 鼠标消息，无解_(:з」∠)_ +不支持。没开放 adb 端口 ## MuMu 模拟器 安卓 9 @@ -45,15 +53,15 @@ ## 腾讯手游助手 -不支持。没开放 ADB 端口 +不支持。没开放 adb 端口 ## Win11 WSA -不支持，WSA 目前没有实现 AOSP screencap 需要的接口，无法进行截图。等微软支持后会尝试适配 +不支持。WSA 目前没有实现 AOSP screencap 需要的接口，无法进行截图。等微软支持后会尝试适配 ## 自定义连接 -1. 下载 [ADB](https://dl.google.com/android/repository/platform-tools-latest-windows.zip) ，将`platform-tools`文件夹解压到`MeoAsstGui.exe`的同级目录 -2. 进入软件`设置`-`连接设置`，填写自定义地址（需要填写IP+端口，例如`127.0.0.1:5555`） +1. 下载 [adb](https://dl.google.com/android/repository/platform-tools-latest-windows.zip) ，将 `platform-tools` 文件夹解压到 `MeoAsstGui.exe` 的同级目录 +2. 进入软件 `设置` - `连接设置`，填写自定义 adb 地址（需要填写 IP + 端口，例如 `127.0.0.1:5555` ） -**注意 :** 若是使用手机，在非`16:9`分辨率下，部分功能不稳定（但也凑合能用），尤其是基建，几乎是不可用状态，正在进一步适配中。推荐使用`16:9`分辨率，经过的测试验证最多，也最稳定。 +**注意 :** 若是使用手机，在非 `16:9` 分辨率下，部分功能不稳定（但也凑合能用），尤其是基建，几乎是不可用状态，正在进一步适配中。推荐使用 `16:9` 分辨率，经过的测试验证最多，也最稳定。