mirror of
https://github.com/MaaAssistantArknights/MaaAssistantArknights.git
synced 2026-07-19 02:23:01 +08:00
666b0076d1
### 更新功能
1. 增加`RoguelikeMode::CLP_PDS = 5`作为萨米肉鸽刷隐藏坍缩范式的模式，可且仅可用于萨米肉鸽。
在此模式下，将在每次回到关卡选择界面时检查坍缩状态，同时会优先使用带有`_collapse`后缀的战斗部署方案，也会使用特有的不期而遇和购物设置。
2. 肉鸽任务新增以下参数：
- `check_collapsal_paradigms`：是否检查坍缩范式，若`mode = 5`则默认为`true`，否则为`false`。
- `double_check_collapsal_paradigms`：是否增加对坍缩范式的检查频率，若`mode =
5`则默认为`true`，否则为`false`。
- `expected_collapsal_paradigms`：需要刷的坍缩范式，若`mode = 5`则默认为两组隐藏坍缩范式。
- `use_foldartal`：是否使用密文板，若`mode = 5`则默认为`false`，否则为`true`。
### 机制介绍
本插件将以两种不同的手段检查坍缩范式：
- 在选关界面点击屏幕中上方展开坍缩状态栏（以下称`Panel Check`）；
- 观察屏幕右侧是否有坍缩范式通知（以下称`Banner Check`）。
获取坍缩值的方法多种多样，本插件考虑到了以下情况：
1. 战斗后因非完美战斗而使坍缩值增加，进行`Banner Check`。
2. 战斗后因获得收藏品而使坍缩值变动，进行`Banner Check`。
3. 在不期而遇等（MAA中失与得等节点也会触发不期而遇插件）节点中使坍缩值变动，进行`Banner Check`。
4. 再诡异行商节点中因购买收藏品而使坍缩值变动，进行`Banner Check`。
5. 因使用密文版而使坍缩值减少，进行`Banner Check`。
6. 因进入新的一层而使坍缩值增加，进行`Panel Check`。
7. 若进行`Banner
Check`时发现坍缩范式消退，因不知道会不会一次性消退两层（即便会也概率极低），会在下一次回到选关洁面的时候额外触发一次`Panel
Check`。
8. 在`double_check_collapsal_paradigms =
true`的情况下，每次回到选关界面的时候都会额外触发一次`Panel
Check`以验证是否之前有漏、多记录坍缩范式，并以回调信息的形式传回Debug信息。
**注意事项**
1.
为了防止错过坍缩范式通知，会适当sleep，若检测到屏幕下方有`正在提交反馈至神经`的提示的话会额外sleep。所以开启检查坍缩范式的功能后整体流程会变得拖沓一些（目前在我本人可接受范围内）。
2.
在`RoguelikeMode::CLP_PDS`模式下，获得不需要的坍缩范式会直接重开，遇到需要的坍缩范式则会停止任务。理论上可能在不期而遇事件中获得了不需要的坍缩范式，但因为右上角没有退出按钮而没有及时重开。但我目前没有观察到这样的情形，故没有做处理。不放心的话请设置`double_check_collapsal_paradigms
= true`，等回到选关界面后再检查一遍已获得的坍缩范式。
3.
无论如何，强烈推荐开启`double_check_collapsal_paradigms`。慢点就慢点，求稳才是关键。在我本人测试的过程中，遇到过一两次遗漏`Banner
Check`的情况（截图错过了右上角通知），幸好在额外触发的`Panel
Check`中补上了。怀疑是系统卡顿或网络延迟所致（我在澳大利亚用着MBP2017开着MUMU+MAA刷官服，时间长了后模拟器本身就偶尔会卡住）。
### 回调信息
当`check_collapsal_paradigms == true`时会输出类似于下方的回调信息：
```C++
callback(AsstMsg::SubTaskExtraInfo, json::object {
{ "what", "RoguelikeCollapsalParadigms" },
{ "details", json::object {
{ "cur", "目空一些" },
{ "deepen_or_weaken", 1 },
{ "prev", "睁眼瞎" }
} }
});
```
其中`deepen_or_weaken = 1`代表坍缩范式从`prev`加深至`cur`，若`deepen_or_weaken =
-1`则代表坍缩范式消退。
偶尔也会有测试信息以`deepen_or_weaken = 0`被传回，主要用于我自己测试用。
### 任务设置范例
以下是我的测试用任务设置：
```Python
asst.append_task('Roguelike', {
'theme': 'Sami',
'mode': 5,
'investment_enabled': False,
'squad': '远程战术分队',
'roles': '稳扎稳打',
'core_char': '维什戴尔',
# 'expected_collapsal_paradigms': ['趋同性消耗'],
# 'check_collapsal_paradigms': True, # 在mode = 5时默认为True
double_check_collapsal_paradigms': True, # 建议打开，以防万一错过了什么
# 'use_foldartal': False # 在mode = 5时默认为False
})
```
建议在难度10刷隐藏坍缩，我只做了第一层的漏怪作业且以`维什戴尔`为战斗核心。
### To-Do(s)
- [ ] 补充相关文档 （要不就把上述文字作为文档吧？）
### Need Help
- [ ] 外服适配
- [ ] UI适配
---
小孩子不懂事乱写的代码，请各位多指教。
MaaAssistantArknights
简体中文 | 繁體中文 | English | 日本語 | 한국어
MAA 的意思是 MAA Assistant Arknights
一款明日方舟游戏小助手
基于图像识别技术，一键完成全部日常任务！
绝赞更新中 ✿✿ヽ(°▽°)ノ✿
亮点功能
- 刷理智，掉落识别及上传 企鹅物流，一图流；
- 智能基建换班，自动计算干员效率，单设施内最优解；同时也支持 自定义排班；
- 自动公招，可选使用加急许可，一次全部刷完！公招数据自动上传 企鹅物流，一图流；
- 支持手动识别公招界面，方便对高星公招做出选择
（你的这个高姿回费出的是推王呢还是推王呢）； - 支持识别干员列表，统计已有和未有干员及潜能，并在公招识别显示；
- 支持识别养成材料，并导出至 企鹅物流刷图规划、明日方舟工具箱、ARK-NIGHTS 干员培养表；
- 访问好友、收取信用及购物、领取日常奖励等，一键全日常自动长草；
- 肉鸽全自动刷源石锭和等级，自动烧水和凹直升，智能识别干员及练度；
- 选择作业 JSON 文件，自动抄作业， 视频演示；
- 支持 C, Python, Java, Rust, Golang, Java HTTP, Rust HTTP 等多种接口，方便集成调用，自定义你的 MAA！
话不多说，看图！
下载地址
使用说明
基本说明
常见问题
- 软件一打开就闪退；
- 连接错误、不知道 adb 路径怎么填写；
- 连接成功了，但没反应；
- 如何连接自定义端口；
- 下载速度慢，且镜像站无法打开网页；
- 下载到一半提示“登陆”/“鉴权”；
- 连接正常，任务开始了，但是没反应。
请参阅 常见问题
外服支持
目前国际服（美服）、日服、韩服、繁中服的绝大部分功能均已支持。但由于外服用户较少及项目人手不足，很多功能并没有进行全面的测试，所以请自行体验。
若您遇到了 Bug，或对某个功能有强需求，欢迎在 Issues 和 讨论区 催更；或加入我们一起建设 MAA！请参阅 外服适配教程
CLI支持
MAA 支持命令行界面（CLI）操作，支持 Linux，macOS 和 Windows，可用于自动化脚本或在无图形界面的服务器上使用。请参阅 CLI 使用指南
加入我们
主要关联项目
目前项目组非常缺前端大佬，若您有相关经验，欢迎加入我们！
- 全新框架：MaaFramework
- 全新 GUI：MaaX
- 作业站 前端：maa-copilot-frontend
- 作业站 后端：MaaBackendCenter
- 官网：前端
- 深度学习：MaaAI
多语言 (i18n)
MAA 支持多国语言，并使用 Weblate 进行本地化管理。如果您通晓多门语言，欢迎前往 MAA Weblate 帮助我们进行翻译。
MAA 以中文（简体）为第一语言，翻译词条均以中文（简体）为准。
Windows
-
下载预构建的第三方库
python maadeps-download.py -
使用 Visual Studio 2022 打开
MAA.sln，右键MaaWpfGui，设为启动项目 -
VS 上方配置选择
RelWithDebInfox64（如果编译 Release 包 或 ARM 平台，请忽略这步） -
右键
MaaWpfGui- 属性 - 调试 - 启用本地调试（这样就能把断点挂到 C++ Core 那边了） -
（可选）若准备提交 PR，建议启用 clang-format 支持
Linux | macOS
请参阅 Linux 编译教程
API
- C 接口：集成示例
- Python 接口：集成示例
- Golang 接口：集成示例
- Dart 接口
- Java 接口：集成示例
- Java HTTP 接口
- Rust 接口：HTTP 接口
- TypeScript 接口
- Woolang 接口：集成示例
- 集成文档
- 回调消息协议
- 任务流程协议
- 自动抄作业协议
外服适配
请参阅 外服适配教程，对于国服已支持的功能，绝大部分的外服适配工作仅需要截图 + 简单的 JSON 修改即可。
想参与开发，但不太会用 GitHub?
Issue bot
请参阅 Issue bot 使用方法
致谢
开源库
- 图像识别库：opencv
文字识别库：chineseocr_lite- 文字识别库：PaddleOCR
- 深度学习部署库：FastDeploy
- 机器学习加速器：onnxruntime
关卡掉落识别：企鹅物流识别- 地图格子识别：Arknights-Tile-Pos
- C++ JSON库：meojson
- C++ 运算符解析器：calculator
C++ base64编解码：cpp-base64- C++ 解压压缩库：zlib
- C++ Gzip封装：gzip-hpp
- 安卓触控事件器：minitouch
- 安卓触控事件器：MaaTouch
- WPF MVVM框架：Stylet
- WPF控件库：HandyControl -> HandyControls
- C# 日志：Serilog
- C# JSON库：Newtonsoft.Json & System.Text.Json
下载器：aria2
数据源
公开招募数据：明日方舟工具箱干员及基建数据：PRTS Wiki- 关卡数据：企鹅物流数据统计
- 游戏数据及资源：明日方舟客户端素材
游戏数据：《明日方舟》游戏数据
贡献/参与者
感谢所有参与到开发/测试中的朋友们，是大家的帮助让 MAA 越来越好！ (*´▽｀)ノノ
声明
- 本软件使用 GNU Affero General Public License v3.0 only 开源。
- 本软件 logo 并非使用 AGPL 3.0 协议开源，耗毛、vie 两位画师及软件全体开发者保留所有权利。不得以 AGPL 3.0 协议已授权为由在未经授权的情况下使用本软件 logo，不得在未经授权的情况下将本软件 logo 用于任何用途。
- 本软件开源、免费，仅供学习交流使用。若您遇到商家使用本软件进行代练并收费，可能由于设备或时间等原因，产生的任何问题及后果与本软件无关。
广告
用户交流 QQ 群：MAA 使用 & 粥游交流 QQ 群
用户交流 TG 群：Telegram 群
自动战斗 JSON 作业分享：prts.plus 或 抄作业.com
Bilibili 直播间：直播间 每晚直播敲代码，近期很长一段时间应该都是在写本软件~
技术群（舟无关、禁水）：内卷地狱！(QQ 群)
开发者群：QQ 群
如果觉得软件对你有帮助，帮忙点个 Star 吧！~（网页最上方右上角的小星星），这就是对我们最大的支持了！