MAAAE，迁移自 MaaAshEchoes 项目（包括大部分代码和资源）。
本README基于 MaaAshEchoes README 修改而来，可能存在疏漏，请在issue中指出。
基于 MaaFramework 的 白荆回廊 小助手。图像技术 + 模拟控制，解放双手！
本项目使用 MFAAvalonia 作为 GUI 界面！
（全平台测试中，支持Windows 10+、Linux (X11/Wayland)、macOS 10.15+）
- 🎯 指定同调者、技能、目标等级
- 🔄 自动使用体力进行培养（不使用体力药）
- 🗺️ 指定关卡名称
- ⚔️ 自动消耗体力进行作战（不使用体力药）
- 🎁 领取好友赠礼
- 👍 俱乐部点赞与奖励领取
- ☕ 午后茶憩（支持多个角色）
- 通过
resource/image/edit/午后茶憩_茶憩角色*.png配置 - 或直接选择排第一位的角色
- 支持单次及6次喝茶，支持仅使用免费邀请函
- 可解放双手反复喝茶提升角色默契值
- 通过
- 🏰 白荆穹顶资源收取
- ⬆️ 烙痕升级（自动尝试升级低等级烙痕，限制烙痕最高升级等级）
- 🔄 周常拟合回归（支持队伍选择）
- 📅 日常/周常任务奖励
- 🌿 叶脉联结奖励
- 🛍️ 每日外勤赠礼购买
- 🎲 每日免费烙痕抽取
- 📬 邮箱物品签收
- 🚀 开始唤醒（需提前登录账号）
- 🔚 关闭游戏
-
茶憩功能需要确保：
- 角色可以"再来一杯"
- 所有茶憩对话已完成
- 如需自定义，正确配置角色头像图片
-
拟合回归注意：
- 必须启用自动战斗
1-4号位不能有支援角色已支持
-
详见下方的“使用说明”章节。
还有想要的功能？欢迎在 Issue 中提出建议或加 QQ 群 865686593 进行交流！请在 issue 标题中以 [功能建议] 开头。
注意：请勿在各种白荆回廊官方动态下提到本软件/MAA等字眼，谢谢！
前往 Releases 页面 下载适合您设备的版本（建议下载latest版本）。
Windows 用户可以通过以下简单步骤安装和使用：
- 下载
MAAAE-win-x86_64-vXXX.zip。 - 解压缩文件到任意位置。
- 双击运行
MAAAE.exe即可启动程序，享受便捷的图形化界面操作！
注意：
- 如果您的设备是 ARM 架构（极为罕见），请下载
MAAAE-win-aarch64-vXXX.zip。默认情况下，请优先选择 x86_64 版本。
如果您使用的是 macOS，请根据您的设备处理器类型选择合适的版本：
- 使用 Intel 处理器，请下载
MAAAE-macos-x86_64-vXXX.zip。 - 使用 M1、M2 等 ARM 处理器，请下载
MAAAE-macos-aarch64-vXXX.zip。
用 Linux 的大佬应该不需要我教
Linux 用户请根据您的设备处理器类型选择合适的版本并且根据 requirements.txt 安装 Python 和必要的依赖。
在使用工具前完成以下工作：
-
确保游戏可以在模拟器上流畅运行，没有严重的卡顿和延迟。
-
完成所有游戏资源的下载，登录好账号，启用自动战斗。
-
完成必要运行库的下载安装：（非必须，启动时将自动检测依赖是否安装）
VC++运行时库 (vc_redist)
.NET 10 SDK 或运行时
-
分辨率要求：使用 16:9 分辨率，推荐设置为 1280×720。
经测试，2560×1440 分辨率下也能正常运行。 若出现识别问题，请优先调整分辨率为 1280×720 后重试。 -
ADB 调试：请确保已经打开模拟器的 ADB 调试选项。
-
其它设置：请确保关闭后台挂机时保活运行。
-
游戏图像设置：一般对运行没有影响。如果修改分辨率后识别问题仍然存在，请提 Issue。
-
任务执行顺序：
- 请合理调整任务顺序，例如，建议将“领取奖励”相关的任务放在流程的最后。
- 如果不确定任务执行顺序，请保持默认的执行顺序，并勾选您需要的任务。
- 如希望使用不同配置多次执行同一任务，请在任务栏右上角通过“ + ”添加同名任务修改配置。
-
茶憩任务特别说明（重要）：
- 茶憩角色设置（图片素材准备）：
-
-
茶憩任务中，通过创建或修改头像图片的方式设置茶憩角色，任务“茶憩角色 1/2/3”分别对应的图片文件如下（数字编号前没有空格）：
resource/image/edit/午后茶憩_茶憩角色1.pngresource/image/edit/午后茶憩_茶憩角色2.pngresource/image/edit/午后茶憩_茶憩角色3.png
请参考resource/image/edit/午后茶憩_茶憩角色.png创建或修改上述图片文件，文件名必须完全一致。
-
图片要求：
- 使用 无损原图缩放到 720p 后裁剪茶憩角色选择页面的角色头像中心区域。
- 若使用安卓模拟器，务必使用模拟器自带截图功能，不可直接对模拟器窗口截图。
-
推荐工具：
除非您完全了解 MaaFramework 的图片处理机制，否则请使用以下推荐工具获取截图：- GUI 自带截图工具
使用方式：- 点击 GUI 主界面左侧主页下方的“截图”按钮。
- 在弹出的图片浏览器中截图并保存。
- MFA ImageCropper
- MFATools
- GUI 自带截图工具
-
头像截取要求：
- 截取头像中心部分即可，不要包含头像框。
-
MFAAvalonia 支持自动更新及手动更新资源，使用【设置】→【软件更新】→检查资源/资源更新/自动更新资源即可。（已禁用单独更新框架及 GUI 版本以避免兼容性问题。）
若右下角弹窗报错，请依次检查尝试以下内容：
- 请将更新源设置为 github 而非 mirror。
- 检查网络连接是否正常，是否可以访问 GitHub。
- 尝试使用 github 的 token 进行更新，具体方法请参考 token 栏的链接说明。
请尝试使用 GUI 进行更新，步骤与 Windows 一致。 若失败，请重新下载最新版本并解压缩到原目录，覆盖原有文件即可。
Windows 用户可以通过在 GUI 高级设置中，选择“定时执行”进行设置实现定时运行。
macOS 用户可以使用 launchd 或 cron 来定时运行 MaaPiCli。相关方法请自行搜索。
Linux 用户可以使用 cron 来定时运行 MaaPiCli。相关方法请自行搜索。
原因：缺少必要的运行时库。
解决方法：请安装以下运行时库后重试：
原因：图片素材设置错误。
解决方法：请确保按照“茶憩任务特别说明”中的要求设置角色图片素材，确保文件名正确（数字编号前没有空格），并使用推荐工具进行截图。
原因：可能是任务设置选择了“只能使用免费邀请次数”但免费茶憩邀请次数已用完，或角色没有“再来一杯”选项，或仍存在未完成的茶憩对话。
解决方法：请检查任务设置，确保已经为角色设置好了茶憩配方，即已经在设备上完成过至少一次茶憩，能够正常弹出“再来一杯”按钮，且所有茶憩对话已经完成。
原因：一般是因为分辨率或图片素材不符合要求。
解决方法：确保模拟器分辨率设置为 16:9（推荐 1280×720）。
请附上以下信息提交 Issue，或加 QQ 群 865686593 提问：
- 日志文件：位于
debug/maa.log，也可以使用 GUI 设置中的“导出日志”功能获取。 - 截图：请包含任务出错时的界面截图和问题描述。
问题：如果在一些特殊界面启动小助手，任务可能无法正常执行（无法正常返回主界面）。
解决方法：请手动返回主界面后重试。
问题：烙痕升级任务可能无法正确识别等级最低的烙痕，并且无法自动处理需要突破的烙痕。
解决方法：等待后续版本修复，临时方案是确保有足够的已突破烙痕进行升级。
计划添加对常驻活动的日常清理功能，加入对决重演的自动完成等。
计划通过同步wiki数据，增加同调者最高好感度及纪念函茶憩方案，并且删除用户手动截图的步骤改为选择名称。
- GUI 交互优化：将“作战关卡”和“培养同调者”等选项从预设列表改为手动输入/选择，更加灵活。
- MFA 及 MFAA 版本指定：包体使用指定的 MFA 和 MFAA 版本，提升稳定性。
- 代码结构优化：重构了部分 Python 脚本结构。
- 工作流更新：优化了 GitHub Actions 自动构建流程。
如果在使用过程中遇到问题，欢迎提交 Issue，或加入 QQ 群 865686593 进行反馈。
反馈时请尽量提供以下信息：
- 日志文件（在GUI中导出或在文件夹中自行查找）。
- 问题发生时的模拟器界面截图。
- 简要描述问题出现的情况。
- 本软件代码基于 MIT License 开源，仅供学习和交流使用（不包括本项目logo及默认图片资源，其版权属于上海烛龙-白荆回廊）。
- 本项目基于 MaaFramework 构建，开发者对框架功能进行了进一步扩展。
- 使用须知：
- 本软件仅通过游戏提供的用户界面与游戏程序进行交互，不会读取或修改游戏的文件或代码。
- 任何因使用本软件产生的问题或后果均与本软件及开发者团队无关。
- 任何商家利用本软件提供代练等商业服务所产生的任何问题或后果，与本软件及开发者团队无关。
下载并使用本软件即表示您已阅读并同意上述声明。
- MaaFramework 开发文档：快速上手指南。
- Pipeline 流水线协议：任务编排机制的详细说明。
- 更多文档请参考 MaaFramework 主仓库。
本项目由 MaaFramework 强力驱动！
本项目使用 MFAAvalonia 作为 GUI 界面！
本项目的大部分基础建立在 MaaAshEchoes 上
感谢以下的 MaaAshEchoes 开发者：
以及本项目开发者：
闲聊/反馈/交流/开发群 QQ 群：865686593