---

🎮 功能分类与说明

💪 清体力

同调者培养

• 🎯 指定同调者、技能、目标等级
• 🔄 自动使用体力进行培养（不使用体力药）

外勤作战

• 🗺️ 指定关卡名称
• ⚔️ 自动消耗体力进行作战（不使用体力药）

📅 日常/周常任务

• 🎁 领取好友赠礼
• 👍 俱乐部点赞与奖励领取
• ☕ 午后茶憩（支持多个角色）
  • 通过resource/image/edit/午后茶憩_茶憩角色*.png配置
  • 或直接选择排第一位的角色
  • 支持单次及6次喝茶，支持仅使用免费邀请函
  • 可解放双手反复喝茶提升角色默契值
• 🏰 白荆穹顶资源收取
• ⬆️ 烙痕升级（自动尝试升级低等级烙痕，限制烙痕最高升级等级）
• 🔄 周常拟合回归（支持队伍选择）

🎁 奖励与福利

奖励领取

• 📅 日常/周常任务奖励
• 🌿 叶脉联结奖励

福利系统

• 🛍️ 每日外勤赠礼购买
• 🎲 每日免费烙痕抽取
• 📬 邮箱物品签收

⚙️ 基础功能

• 🚀 开始唤醒（需提前登录账号）
• 🔚 关闭游戏

📝 注意事项

1. 茶憩功能需要确保：

   • 角色可以"再来一杯"
   • 所有茶憩对话已完成
   • 如需自定义，正确配置角色头像图片

2. 拟合回归注意：

   • 必须启用自动战斗
   • 1-4号位不能有支援角色 已支持

3. 详见下方的“使用说明”章节。

还有想要的功能？欢迎在 Issue 中提出建议或加 QQ 群 865686593 进行交流！请在 issue 标题中以 [功能建议] 开头。

注意：请勿在各种白荆回廊官方动态下提到本软件/MAA等字眼，谢谢！

下载及安装说明

下载地址

前往 Releases 页面 下载适合您设备的版本（建议下载latest版本）。

Windows 用户

Windows 用户可以通过以下简单步骤安装和使用：

1. 下载 MAAAE-win-x86_64-vXXX.zip。
2. 解压缩文件到任意位置。
3. 双击运行 MAAAE.exe 即可启动程序，享受便捷的图形化界面操作！

注意：

• 如果您的设备是 ARM 架构（极为罕见），请下载 MAAAE-win-aarch64-vXXX.zip。默认情况下，请优先选择 x86_64 版本。

macOS 用户

如果您使用的是 macOS，请根据您的设备处理器类型选择合适的版本：

• 使用 Intel 处理器，请下载 MAAAE-macos-x86_64-vXXX.zip。
• 使用 M1、M2 等 ARM 处理器，请下载 MAAAE-macos-aarch64-vXXX.zip。

Linux 用户我教

用 Linux 的大佬应该不需要我教

Linux 用户请根据您的设备处理器类型选择合适的版本并且根据 requirements.txt 安装 Python 和必要的依赖。

使用说明

使用前说明

在使用工具前完成以下工作：

1. 确保游戏可以在模拟器上流畅运行，没有严重的卡顿和延迟。

2. 完成所有游戏资源的下载，登录好账号，启用自动战斗。

3. 完成必要运行库的下载安装：（非必须，启动时将自动检测依赖是否安装）
   VC++运行时库 (vc_redist)
   .NET 10 SDK 或运行时

模拟器设置要求

1. 分辨率要求：使用 16:9 分辨率，推荐设置为 1280×720。
   经测试，2560×1440 分辨率下也能正常运行。 若出现识别问题，请优先调整分辨率为 1280×720 后重试。

2. ADB 调试：请确保已经打开模拟器的 ADB 调试选项。

3. 其它设置：请确保关闭后台挂机时保活运行。

4. 游戏图像设置：一般对运行没有影响。如果修改分辨率后识别问题仍然存在，请提 Issue。

程序运行注意事项

1. 任务执行顺序：

   • 请合理调整任务顺序，例如，建议将“领取奖励”相关的任务放在流程的最后。
   • 如果不确定任务执行顺序，请保持默认的执行顺序，并勾选您需要的任务。
   • 如希望使用不同配置多次执行同一任务，请在任务栏右上角通过“ + ”添加同名任务修改配置。

2. 茶憩任务特别说明（重要）：

   • 茶憩角色设置（图片素材准备）：

   • 1. 茶憩任务中，通过创建或修改头像图片的方式设置茶憩角色，任务“茶憩角色 1/2/3”分别对应的图片文件如下（数字编号前没有空格）：

        • resource/image/edit/午后茶憩_茶憩角色1.png
        • resource/image/edit/午后茶憩_茶憩角色2.png
        • resource/image/edit/午后茶憩_茶憩角色3.png
          请参考 resource/image/edit/午后茶憩_茶憩角色.png 创建或修改上述图片文件，文件名必须完全一致。

     2. 图片要求：

        • 使用 无损原图缩放到 720p 后裁剪茶憩角色选择页面的角色头像中心区域。
        • 若使用安卓模拟器，务必使用模拟器自带截图功能，不可直接对模拟器窗口截图。

     3. 推荐工具：
        除非您完全了解 MaaFramework 的图片处理机制，否则请使用以下推荐工具获取截图：

        • GUI 自带截图工具
          使用方式：
          • 点击 GUI 主界面左侧主页下方的“截图”按钮。
          • 在弹出的图片浏览器中截图并保存。
        • MFA ImageCropper
        • MFATools

     4. 头像截取要求：

        • 截取头像中心部分即可，不要包含头像框。

更新方式

Windows 用户

MFAAvalonia 支持自动更新及手动更新资源，使用【设置】→【软件更新】→检查资源/资源更新/自动更新资源即可。（已禁用单独更新框架及 GUI 版本以避免兼容性问题。）

若右下角弹窗报错，请依次检查尝试以下内容：

1. 请将更新源设置为 github 而非 mirror。
2. 检查网络连接是否正常，是否可以访问 GitHub。
3. 尝试使用 github 的 token 进行更新，具体方法请参考 token 栏的链接说明。

macOS/Linux 用户

请尝试使用 GUI 进行更新，步骤与 Windows 一致。 若失败，请重新下载最新版本并解压缩到原目录，覆盖原有文件即可。

定时运行

Windows 用户

Windows 用户可以通过在 GUI 高级设置中，选择“定时执行”进行设置实现定时运行。

macOS 用户

macOS 用户可以使用 launchd 或 cron 来定时运行 MaaPiCli。相关方法请自行搜索。

Linux 用户

Linux 用户可以使用 cron 来定时运行 MaaPiCli。相关方法请自行搜索。

常见问题

1. 程序启动时报“应用程序错误”或无法运行

原因：缺少必要的运行时库。
解决方法：请安装以下运行时库后重试：

• VC++运行时库 (vc_redist)
• .NET 10 SDK 或运行时

2. 茶憩任务运行异常，无法正确选择想要的角色

原因：图片素材设置错误。
解决方法：请确保按照“茶憩任务特别说明”中的要求设置角色图片素材，确保文件名正确（数字编号前没有空格），并使用推荐工具进行截图。

3. 茶憩任务运行异常，无法正常开始或结束茶憩

原因：可能是任务设置选择了“只能使用免费邀请次数”但免费茶憩邀请次数已用完，或角色没有“再来一杯”选项，或仍存在未完成的茶憩对话。
解决方法：请检查任务设置，确保已经为角色设置好了茶憩配方，即已经在设备上完成过至少一次茶憩，能够正常弹出“再来一杯”按钮，且所有茶憩对话已经完成。

4. 识别错误或程序无法正确执行任务

原因：一般是因为分辨率或图片素材不符合要求。
解决方法：确保模拟器分辨率设置为 16:9（推荐 1280×720）。

5. 无法找到问题的解决方案

请附上以下信息提交 Issue，或加 QQ 群 865686593 提问：

• 日志文件：位于 debug/maa.log，也可以使用 GUI 设置中的“导出日志”功能获取。
• 截图：请包含任务出错时的界面截图和问题描述。

已知问题

1. 特定界面启动任务问题

问题：如果在一些特殊界面启动小助手，任务可能无法正常执行（无法正常返回主界面）。
解决方法：请手动返回主界面后重试。

2. 烙痕升级链问题

问题：烙痕升级任务可能无法正确识别等级最低的烙痕，并且无法自动处理需要突破的烙痕。
解决方法：等待后续版本修复，临时方案是确保有足够的已突破烙痕进行升级。

未来规划

1. 常驻活动的日常清理

计划添加对常驻活动的日常清理功能，加入对决重演的自动完成等。

2. 增加自动茶憩方案

计划通过同步wiki数据，增加同调者最高好感度及纪念函茶憩方案，并且删除用户手动截图的步骤改为选择名称。

📅 更新日志

v0.0.7

• GUI 交互优化：将“作战关卡”和“培养同调者”等选项从预设列表改为手动输入/选择，更加灵活。
• MFA 及 MFAA 版本指定：包体使用指定的 MFA 和 MFAA 版本，提升稳定性。
• 代码结构优化：重构了部分 Python 脚本结构。
• 工作流更新：优化了 GitHub Actions 自动构建流程。

反馈

问题反馈

如果在使用过程中遇到问题，欢迎提交 Issue，或加入 QQ 群 865686593 进行反馈。

反馈时请尽量提供以下信息：

• 日志文件（在GUI中导出或在文件夹中自行查找）。
• 问题发生时的模拟器界面截图。
• 简要描述问题出现的情况。

软件声明

• 本软件代码基于 MIT License 开源，仅供学习和交流使用（不包括本项目logo及默认图片资源，其版权属于上海烛龙-白荆回廊）。
• 本项目基于 MaaFramework 构建，开发者对框架功能进行了进一步扩展。
• 使用须知：
  • 本软件仅通过游戏提供的用户界面与游戏程序进行交互，不会读取或修改游戏的文件或代码。
  • 任何因使用本软件产生的问题或后果均与本软件及开发者团队无关。
  • 任何商家利用本软件提供代练等商业服务所产生的任何问题或后果，与本软件及开发者团队无关。

下载并使用本软件即表示您已阅读并同意上述声明。

开发者相关

开发文档

• MaaFramework 开发文档：快速上手指南。
• Pipeline 流水线协议：任务编排机制的详细说明。
• 更多文档请参考 MaaFramework 主仓库。

鸣谢

本项目由 MaaFramework 强力驱动！

本项目使用 MFAAvalonia 作为 GUI 界面！

本项目的大部分基础建立在 MaaAshEchoes 上

感谢以下的 MaaAshEchoes 开发者：

以及本项目开发者：

Join us

闲聊/反馈/交流/开发群 QQ 群：865686593