mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-20 02:55:38 +08:00
269 lines
12 KiB
Markdown
269 lines
12 KiB
Markdown
# MeoAssistance
|
||
|
||
<div>
|
||
<img alt="C++" src="https://img.shields.io/badge/c++-17-%2300599C?logo=cplusplus">
|
||
<img alt="VS" src="https://img.shields.io/badge/VisualStudio-19-%235C2D91?logo=visualstudio">
|
||
</div>
|
||
<div>
|
||
<img alt="platform" src="https://img.shields.io/badge/platform-Windows%2064bit-%230078D6?logo=windows">
|
||
</div>
|
||
<div>
|
||
<img alt="license" src="https://img.shields.io/github/license/MistEO/MeoAssistance-Arknights">
|
||
<img alt="commit" src="https://img.shields.io/github/commit-activity/m/MistEO/MeoAssistance-Arknights?color=%23ff69b4">
|
||
<img alt="stars" src="https://img.shields.io/github/stars/MistEO/MeoAssistance-Arknights?style=social">
|
||
</div>
|
||
<br>
|
||
|
||
A game assistance for Arknights
|
||
|
||
一款明日方舟的游戏助手，自动刷理智、智能基建换班、公招识别，纯图像识别，全图形化界面，兼容模拟器和安卓设备，开罐即食，绝赞开发中！✿✿ヽ(°▽°)ノ✿
|
||
<br>
|
||
|
||
|
||
|
||
## 下载地址
|
||
|
||
[稳定版](https://github.com/MistEO/MeoAssistance/releases/latest)
|
||
[测试版](https://github.com/MistEO/MeoAssistance/releases)
|
||
|
||
## 功能介绍
|
||
|
||
- **全自动基建换班（新功能！）**
|
||
- 自动识别干员技能，自动计算设施内最优解并换班！
|
||
- 支持如`巫恋组`、`温蒂组`等等所有单设施内组合
|
||
- 自动识别干员心情并入驻宿舍
|
||
- 可设置自动使用无人机给制造站/贸易站加速
|
||
- 可识别赤金、经验书，分别使用不同的干员组合
|
||
- `迷迭香`等跨设施体系正在开发中！
|
||
- 详细换班功能介绍见[基建换班说明](#基建换班)
|
||
- 自动刷理智
|
||
- 支持刷完自动上传[企鹅物流数据统计](https://penguin-stats.cn/)
|
||
- 界面支持统计掉落数量
|
||
- 可设置是否吃完理智药及数量
|
||
- 可设置是否吃石头及数量
|
||
- 可设置刷的次数（用来刷剿灭啥的）
|
||
- 可设置刷完自动关机
|
||
- 支持剿灭模式
|
||
- 支持打完升级了的情况
|
||
- 支持代理失败的情况，会自动放弃本次行动
|
||
- 支持刷完自动截图
|
||
- 支持掉线后重连，继续刷上次的图
|
||
- 支持凌晨4点更新后重连，继续刷上次的图
|
||
- 公开招募识别
|
||
- 自动识别当前招募页所有Tags
|
||
- 自动计算可能出的干员组合并显示
|
||
- 自动帮你点击最优解Tags
|
||
- 自动帮你点击时间9小时
|
||
- 出5、6星干员弹窗提示
|
||
- 最新版本已支持夏活新增的`煌`、`灰喉`等干员
|
||
- 不会帮你点击确定按钮！！！请自行检查软件选择的是否正确，若出现识别错误，遗漏了高星干员，作者概不负责哦__(:з」∠)_
|
||
- 自动访问好友
|
||
- 访问完了还会贴心的帮你点进信用商店~
|
||
- 可设置访问完自动买信用商店的材料
|
||
- 其他优势
|
||
- 所有点击操作，都是点击按钮内随机位置，并模拟泊松分布（按钮偏中间位置点的概率大，越往旁边点到的概率越小）
|
||
- 刷理智及访问好友的点击操作，支持设置随机延时，没有封号风险~
|
||
- 底层算法纯C++开发，并设计了多重的缓存技术，最大限度降低CPU和内存占用
|
||
- 模拟器窗口可以被遮挡、可以最小化、甚至可以老板键隐藏！即使全屏看视频、玩游戏，也完全不影响软件运行
|
||
- 软件支持自动更新✿✿ヽ(°▽°)ノ✿
|
||
- 支持多款主流模拟器
|
||
- 兼容安卓手机（USB调试、无线调试）
|
||
- 兼容非16:9分辨率：包括宽屏、方屏，也兼容在游戏设置中的异形屏适配（基建换班功能除外，正在适配中）。但仍推荐使用16:9分辨率
|
||
- 自适应分辨率及屏幕缩放
|
||
- 未来更多功能见[Todo](#Todo)
|
||
|
||
### 模拟器支持
|
||
|
||
#### 蓝叠模拟器
|
||
|
||
完美支持。需要在模拟器`设置`-`引擎设置`中打开`允许ADB连接`
|
||
|
||
#### 蓝叠模拟器国际版
|
||
|
||
完美支持。需要在模拟器`设定`-`进阶`中打开`Android调试桥`
|
||
|
||
#### 夜神模拟器
|
||
|
||
完美支持
|
||
|
||
#### MuMu模拟器
|
||
|
||
完美支持
|
||
|
||
#### 雷电模拟器
|
||
|
||
勉强支持，雷电总有莫名其妙的问题，可以试试看，不保证能用（
|
||
|
||
#### 逍遥模拟器
|
||
|
||
支持
|
||
|
||
#### 腾讯手游助手
|
||
|
||
不支持，新版本的腾讯好像也是自研引擎了，没开放ADB端口。但是测试是能响应Win32 Api的，有需求再做
|
||
|
||
#### MuMu手游助手（星云引擎）
|
||
|
||
不支持，星云引擎这个版本不支持adb控制，甚至不响应Win32 Api鼠标消息，无解_(:з」∠)_
|
||
|
||
#### 其他模拟器
|
||
|
||
若有其他需要，欢迎给我提[ISSUE](https://github.com/MistEO/MeoAssistance/issues)，会根据情况尽量适配~
|
||
|
||
#### 安卓手机/平板
|
||
|
||
部分功能支持，正在开发中……
|
||
需要下载[谷歌官方ADB](https://dl.google.com/android/repository/platform-tools-latest-windows.zip)，将`platform-tools`文件夹解压到`MeoAsstGui.exe`的同级目录
|
||
|
||
## 使用说明
|
||
|
||
### 基本说明
|
||
|
||
1. 根据上面模拟器支持情况，进行对应的`ADB`相关操作
|
||
2. 解压压缩包，到**没有中文或特殊符号**的文件夹路径
|
||
3. 第一次运行软件，**请使用管理员权限**打开`MeoAsstGui.exe`。运行过一次后，后续不再需要管理员权限（之后的版本会尝试完全去掉管理员权限）
|
||
4. 运行期间，模拟器窗口可以最小化，全屏玩游戏、看视频等，完全不影响
|
||
|
||
### 刷理智
|
||
|
||
1. 明日方舟打开**蓝色开始行动按钮**的界面
|
||
2. 根据你的需要勾选"吃理智药"和"吃石头"
|
||
3. 点击"开始刷理智"，开始后上面的选项也可以随时修改
|
||
4. 刷完了会自动停止的
|
||
|
||
### 基建换班
|
||
|
||
1. 明日方舟处于主界面，或刚进入基建的界面（基建界面没有进行过缩放、干员排序调整等）
|
||
2. 根据你的需要勾选左侧需要进行换班的设施（也可以拖动调整换班顺序）；设置换班模式、无人机、心情阈值等
|
||
3. 点击开始换班，开始执行后上述设置不可修改
|
||
|
||
#### 换班策略
|
||
|
||
自动计算并选择单设施内的最优解，支持所有通用类技能和特殊技能组合（但并非跨设施的最优解，如`迷迭香`这类跨设施间联动的体系，暂不支持）
|
||
|
||
#### 温和换班模式
|
||
|
||
会对干员人数不满的设施进行换班，计算单设施内最优解，尽量不破坏原有的干员组合；即若设施内干员是满的，则不对该设施进行换班
|
||
|
||
#### 激进换班模式
|
||
|
||
会对每一个设施进行换班，计算单设施内最优解，但不会将其他设施中的干员替换过来；即按工作状态排序，仅选择前面的干员
|
||
|
||
#### 偏激换班模式
|
||
|
||
会对每一个设施进行换班，计算全局的单设施内最优解，为追求更高效率，会将其他设施内的干员也替换过来；即按技能排序，计算所有拥有该设施技能的干员效率，无论他在不在其他地方工作（放心，辅助不会傻到把某个干员在几个设施之间来回倒腾的_(:з」∠)_
|
||
|
||
#### 宿舍入驻心情阈值
|
||
|
||
计算心情进度条的百分比；心情小于该阈值的干员，无论如何也不上班（不管上面的模式你选择了哪一种），直接进驻宿舍
|
||
|
||
### 公开招募识别
|
||
|
||
1. 明日方舟打开公开招募，有Tag选择的界面
|
||
2. 软件勾选你需要的选项，点击"开始识别"
|
||
3. 请检查识别结果是否正确，自行判断是否确定开始招募
|
||
|
||
再次强调，本软件仅会帮你选择最优Tags和时间，不会帮你点击确定按钮！！！请自行检查软件选择的是否正确，若出现识别错误，遗漏了高星干员，作者概不负责哦__(:з」∠)_
|
||
|
||
### 访问好友
|
||
|
||
1. 明日方舟处于任意界面均可，会自动帮你点过去
|
||
2. 根据需要勾选`信用商店随缘买`，点击"访问好友"
|
||
3. 达到10次上限，或者所有可访问的好友都访问完了，就会自动停的
|
||
4. 然后会贴心的帮你跳转到信用商店，顺便收了当天信用~
|
||
5. 信用商店随缘买，就是从左到右依次买，但不会买`碳`和`家具零件`
|
||
|
||
### 连接自定义模拟器端口，或安卓手机/平板
|
||
|
||
1. 下载[ADB程序](https://dl.google.com/android/repository/platform-tools-latest-windows.zip)，将`platform-tools`文件夹解压到`MeoAsstGui.exe`的同级目录
|
||
2. 使用USB有线连接安卓手机和电脑
|
||
3. 请在手机`设置`-`开发者选项`中打开`USB调试`、`USB调试（安全设置）`两个选项。具体操作方式不同品牌手机各不相同，请自行百度查询
|
||
4. 请手动修改`resource\config.json`文件中：
|
||
1. `options`.`connectType`字段值为`1`
|
||
2. `emulator`.`Custom`.`adb`.`addresses`字段填写为要连接的地址，请注意这是个数组，会以此尝试所有的（若不填写，或`addresses`中所有的都没连上，则会使用`adb devices`自动查找）
|
||
|
||
目前非16:9分辨率下，刷理智、访问好友、公招识别已初步可用，基建功能暂不可用，后期将逐步优化。但仍推荐使用16:9分辨率，经过的测试验证最多，也最稳定。
|
||
|
||
### 设置操作延时
|
||
|
||
刷理智、访问好友时，每次点击之前，均随机延时一定的时间，降低封号风险
|
||
该功能默认是关闭的，需要的话请手动打开：请手动修改`resource\config.json`文件中，`options`.`controlDelayRange`字段的值，格式为`[最小延时, 最大延时]`，单位为毫秒，例如想设置3~5秒的随机延时，即设置为`[ 3000, 5000]` 即可。文件保存后请重新打开程序。
|
||
|
||
|
||
|
||
## Todo
|
||
|
||
- [ ] 彻底去掉管理员权限
|
||
- [x] 支持设置吃理智药数量
|
||
- [x] 信用商店`看着买`功能
|
||
- [x] 支持所有主流模拟器
|
||
- [x] adb连接逻辑重构
|
||
- [ ] 任务队列功能
|
||
- [ ] 常用关卡选关
|
||
- [ ] 自动收任务功能
|
||
- [x] 基建智能换班功能
|
||
- [x] 图形化界面
|
||
- [x] 干员技能识别
|
||
- [x] 干员识别准确率提高到100%
|
||
- [x] 宿舍心情识别及入驻
|
||
- [x] 制造站、贸易站智能换班
|
||
- [x] 发电站、办公室换班
|
||
- [x] 使用无人机
|
||
- [ ] 控制中枢智能换班
|
||
- [x] 会客室智能换班
|
||
- [x] 会客室智能线索交流
|
||
- [ ] 支持`迷迭香`等复杂基建体系
|
||
- [x] `激进换班模式`
|
||
- [ ] 自定义换班（手动修改配置文件）
|
||
- [ ] 使用GPU进行识别的版本
|
||
- [x] 关卡掉落识别
|
||
- [x] 企鹅物流上传
|
||
- [x] 关卡掉落显示到界面上，并统计
|
||
- [ ] 指定刷某种材料xx个
|
||
- [ ] `config`中部分选项做成图形化界面
|
||
- [x] 图形化界面部分控件状态保存
|
||
- [x] 支持掉线重连，继续刷理智
|
||
- [x] 支持凌晨4点更新后重连，继续刷理智
|
||
- [x] 支持连安卓手机
|
||
- [ ] 进一步的异形屏支持
|
||
- [x] 后台自动更新
|
||
- [x] 忽略当前版本更新
|
||
- [ ] 提供log接口，以及界面log
|
||
- [ ] 更换OCR库，提高公开招募识别率
|
||
- [ ] 终极目标！全自动长草机！！！
|
||
|
||
## 致谢
|
||
|
||
### 开源库
|
||
|
||
- 图像识别库：[opencv](https://github.com/opencv/opencv.git)
|
||
- 文字识别库：[chineseocr_lite](https://github.com/DayBreak-u/chineseocr_lite.git)
|
||
- 关卡掉落识别：[企鹅物流识别](https://github.com/KumoSiunaus/penguin-stats-recognize-v3)
|
||
- C++ JSON库：[meojson](https://github.com/MistEO/meojson.git)
|
||
- C++ 运算符解析器：[calculator](https://github.com/kimwalisch/calculator)
|
||
- WPF MVVW框架：[Stylet](https://github.com/canton7/Stylet)
|
||
- WPF控件库：[HandyControl](https://github.com/HandyOrg/HandyControl)
|
||
- C# JSON库: [Newtonsoft.Json](https://github.com/JamesNK/Newtonsoft.Json)
|
||
|
||
### 数据源
|
||
|
||
- 公开招募数据：[明日方舟工具箱](https://www.bigfun.cn/tools/aktools/hr)
|
||
- 干员及基建数据：[PRTS明日方舟中文WIKI](http://prts.wiki/)
|
||
- 关卡数据：[企鹅物流数据统计](https://penguin-stats.cn/)
|
||
|
||
### 贡献/参与者
|
||
|
||
- 非常感谢 [tcyh035](https://github.com/tcyh035) 帮忙设计重构图形界面
|
||
- 非常感谢 [GengGode](https://github.com/GengGode) 和 [DbgDebug](https://github.com/DbgDebug) 提供图像算法思路并协助验证
|
||
- 非常感谢 [LoveLoliii](https://github.com/LoveLoliii) 提供公开招募算法及数据、部分功能逻辑思路
|
||
- 感谢[AAH](https://github.com/ninthDevilHAUNSTER/ArknightsAutoHelper)的大佬们协助提供部分图像、操作思路
|
||
- 感谢参与软件测试、提bug的小伙伴们~
|
||
- ~~感谢[B站直播间](https://live.bilibili.com/2808861)的小伙伴们陪我弹幕吹水~~
|
||
|
||
## 广告
|
||
|
||
[B站直播间](https://live.bilibili.com/2808861)：每晚直播敲代码，近期很长一段时间应该都是在写本助手软件
|
||
[QQ群](https://jq.qq.com/?_wv=1027&k=ypbzXcA2)：欢迎加入~
|
||
|
||
另：作者前端苦手，寻大佬帮忙一起写界面，继续现在的WPF也行，用electron或者别的重写也行，球球了QAQ
|