MAEA，基于全新架构的 白荆回廊 小助手。图像技术 + 模拟控制，解放双手！
本项目在 https://github.com/moulai/MaaAshEchoes 基础上进行修改维护，感谢@moulai 大佬
本项目由 MaaFramework 强力驱动！
本项目使用 https://github.com/SweetSmellFox/MFAAvalonia 作为 GUI 界面！
- 🎯 指定同调者、技能、目标等级
- 🔄 自动使用体力进行培养（不使用体力药）
- 🗺️ 指定关卡名称
- ⚔️ 自动消耗体力进行作战（不使用体力药）
-
🎁 领取好友赠礼
-
👍 俱乐部点赞与奖励领取
-
☕ 午后茶憩（支持多个角色）
- 通过
resource/image/edit/午后茶憩_茶憩角色*.png配置 - 或直接选择排第一位的角色
- 通过
-
🏰 白荆穹顶资源收取
-
⬆️ 烙痕升级（自动尝试升级低等级烙痕）（需要维护）
-
🎪 活动日常任务（随版本更新）（需要维护）
-
🔄 周常拟合回归（支持队伍选择）
-
🔄 新增周常联合训练场（支持难度选择）
- 🎯 使用置顶刻印配置（可能需要维护）
- 🔄 支持自动刷新支援烙痕
- 📋 使用上次编组基点
- 🔀 支持选择路线分支
- 💡 自动点亮推荐技能
- 📅 日常/周常任务奖励
- 🌿 叶脉联结奖励
- 🛍️ 每日外勤赠礼购买
- 🎲 每日免费烙痕抽取
- 📬 邮箱物品签收
- 🚀 开始唤醒（需提前登录账号）
- 🔚 关闭游戏
-
使用前安装好了必要的运行库：
-
茶憩功能需要确保：
- 角色可以"再来一杯"
- 所有茶憩对话已完成
- 如需自定义，正确配置角色头像图片
-
拟合回归注意：
- 必须启用自动战斗
- 1-4号位不能有支援角色
-
漫巡功能使用前：
- 请先调整好全自动选项
- 设置合适的最大深度
注意：请勿在各种白荆回廊官方动态下提到本软件/MAA等字眼，谢谢！
前往 Releases 页面 下载适合您设备的版本。
Windows 用户可以通过以下简单步骤安装和使用：
- 下载
MAEA-win-x86_64-vXXX.zip。 - 解压缩文件到任意位置。
- 双击运行
MAEA.exe即可启动程序，享受便捷的图形化界面操作！
注意：
- 如果您的设备是 ARM 架构（极为罕见），请下载
MAEA-win-aarch64-vXXX.zip，解压后运行 MaaPiCli.exe 即可。默认情况下，请优先选择 x86_64 版本。
如果您使用的是 macOS，请根据您的设备处理器类型选择合适的版本：
- 使用 Intel 处理器，请下载
MAEA-macos-x86_64-vXXX.zip。 - 使用 M1、M2 等 ARM 处理器，请下载
MAEA-macos-aarch64-vXXX.zip。
用 Linux 的大佬应该不需要我教
若运行时遇到错误提示，例如 “应用程序错误”，可能是缺少运行库。请安装以下组件：
在使用工具前完成以下工作：
-
确保游戏可以在模拟器上流畅运行，没有严重的卡顿和延迟。
-
完成所有游戏资源的下载，登录好账号，启用自动战斗。
-
完成必要运行库的下载安装：
VC++运行时库 (vc_redist)
.NET 8 SDK 或运行时
-
分辨率要求：使用 16:9 分辨率，推荐设置为 1280×720。
若出现识别问题，请优先调整分辨率为 1280×720 后重试。 -
ADB 调试：请确保已经打开模拟器的 ADB 调试选项。
-
其它设置：请确保关闭后台挂机时保活运行。
- 任务执行顺序：
-
请合理调整任务顺序，例如，建议将“领取奖励”相关的任务放在流程的最后。
-
如果不确定任务执行顺序，请保持默认的执行顺序，并勾选您需要的任务。
详细说明：
-
茶憩任务中，通过创建或修改头像图片的方式设置茶憩角色，任务“茶憩角色 1/2/3”分别对应的图片文件如下（数字编号前没有空格）：
resource/image/edit/午后茶憩_茶憩角色1.pngresource/image/edit/午后茶憩_茶憩角色2.pngresource/image/edit/午后茶憩_茶憩角色3.png
请参考resource/image/edit/午后茶憩_茶憩角色.png创建或修改上述图片文件，文件名必须完全一致。
-
图片要求：
- 使用 无损原图缩放到 720p 后裁剪茶憩角色选择页面的角色头像中心区域。
- 若使用安卓模拟器，务必使用模拟器自带截图功能，不可直接对模拟器窗口截图。
-
推荐工具：
除非您完全了解 MaaFramework 的图片处理机制，否则请使用以下推荐工具获取截图：- GUI 自带截图工具
使用方式：- 点击 GUI 主界面任务列表上方的“编辑任务”按钮（一个灰色的编辑图标）。
- 如果找不到 GUI 中的“编辑任务”按钮，请先将
config/config.json中的EnableEdit设置为true。 - 在任务编辑器右上角点击“裁剪图片”按钮（一个灰色的图片图标）。
- 在弹出的图片浏览器中截图并保存。
- MFA ImageCropper
- MFATools
- GUI 自带截图工具
-
头像截取要求：
- 截取头像中心部分即可，不要包含头像框。
-
-
直接运行程序目录中的 updater.exe 即可自动更新。
(https://github.com/SweetSmellFox/MFAAvalonia) 支持自动更新及手动更新资源，使用【设置】→【软件更新】→检查资源/资源更新/自动更新资源即可。注意，这里“软件更新”指的是 MFAWPF 这个 GUI 的更新，不是 MAEA 的更新。“资源更新”才是 MAEA 的更新。
请重新下载最新版本并解压缩到原目录，覆盖原有文件即可。
原因：缺少必要的运行时库。
解决方法：请安装以下运行时库后重试：
原因：图片素材设置错误。
解决方法：请确保按照“茶憩任务特别说明”中的要求设置角色图片素材，确保文件名正确（数字编号前没有空格），并使用推荐工具进行截图。
原因：可能是任务设置选择了“只能使用免费邀请次数”但免费茶憩邀请次数已用完，或角色没有“再来一杯”选项，或仍存在未完成的茶憩对话。
解决方法：请检查任务设置，确保已经为角色设置好了茶憩配方，即已经在设备上完成过至少一次茶憩，能够正常弹出“再来一杯”按钮，且所有茶憩对话已经完成。
原因：一般是因为分辨率或图片素材不符合要求。
解决方法：确保模拟器分辨率设置为 16:9（推荐 1280×720）。
问题：如果在一些特殊界面启动小助手，任务可能无法正常执行（无法正常返回主界面）。
解决方法：请手动返回主界面后重试。
如果在使用过程中遇到问题，欢迎提交 Issue
反馈时请尽量提供以下信息：
- 日志文件（位于
debug/maa.log）。 - 问题发生时的模拟器界面截图。
- 简要描述问题出现的情况。
- 本软件免费开源，仅供学习和交流使用。
- 本项目基于 MaaFramework 构建。
- 使用须知：
- 本软件仅通过游戏提供的用户界面与游戏程序进行交互，不会读取或修改游戏的文件或代码。
- 任何因使用本软件产生的问题或后果均与本软件及开发者团队无关。
- 任何商家利用本软件提供代练等商业服务所产生的任何问题或后果，与本软件及开发者团队无关。
下载并使用本软件即表示您已阅读并同意上述声明。
- MaaFramework 开发文档：快速上手指南。
- Pipeline 流水线协议：任务编排机制的详细说明。
- 更多文档请参考 MaaFramework 主仓库。
完成开发后，上传您的代码并发布版本。
```bash
# 配置 git 信息（仅第一次需要，后续不用再配置）
git config user.name "您的 GitHub 昵称"
git config user.email "您的 GitHub 邮箱"
# 提交修改
git add .
git commit -m "XX 新功能"
git push origin HEAD -u
```
发布您的版本
需要**先**修改仓库设置 `Settings` - `Actions` - `General` - `Read and write permissions` - `Save`
```bash
# CI 检测到 tag 会自动进行发版
git tag v1.0.0
git push origin v1.0.0
```
本项目由 MaaFramework 强力驱动！
本项目使用 MFAA 作为 GUI 界面！