功能概览

详细说明请查看 功能说明。当前 README 以 v1.4.9 更新公告与任务配置为准。

自动培育

[!IMPORTANT] 自动培育仍处于测试阶段。一次完整培育通常约 30min，可能产生大量日志，也可能因弹窗、识别样本不足或游戏 UI 变化而卡住。

当前自动培育支持：

• 初 难度：REGULAR、PRO、MASTER
• NIA 难度：PRO、MASTER
• 指定偶像卡、自动选择偶像、跳过选择偶像
• 培育次数设置、手动输入次数、无限循环
• 使用体力药、使用道具、自动回忆、关注租借
• 中断后通过“跳过准备阶段”继续培育
• 卡片选择优先级：建议卡 > 活动卡、活动卡 > 建议卡、无
• 考试失败自动重试（初/NIA 均支持）
• 试镜难度降低（NIA）：可选择降低一档或两档
• 跟随老师的建议
• NIA 事件、试镜挑战（自动降档）、指导事件等自动选择逻辑
• 事件保底选择机制：无法匹配优先事件时自动回退到可用选项

后续计划

• 初 LEGEND 培育适配
• 更多语言补充
• 更多自动培育样本覆盖

版本适配

注意事项

[!NOTE]
项目主要在 Windows 与 MuMu 模拟器 12 上开发和测试。其他系统或模拟器若出现问题，请参考 提问与反馈指南 并优先保存 debug\maa.log 附带截图反馈。

1. 推荐使用 MuMu 模拟器 12，模拟器支持情况请查看 MaaFramework 官方文档。
2. 推荐分辨率为 1280x720 (240DPI)；其他 16:9 分辨率和 DMM 端未做完整覆盖测试。
3. 使用 DMM 版时，需要以管理员身份启动程序。
4. 自动培育使用 YOLOv11 深度学习模型进行识别，请确保设备支持并启用 GPU 加速。
5. 培育前建议在游戏设置中开启所有跳过对话和弹窗选项，并勾选常见弹窗的“次回以降表示しない”。
6. 本项目仅用于学习交流，请勿用于商业用途。
7. 本项目仅提供自动化脚本，不提供任何游戏资源。

使用说明

Windows

解压后运行 MaaGakumasu.exe 即可。压缩包已自带 Python 3.12.9 环境，无需额外安装。

首次启动会自动安装相关依赖。如果无法运行，请先安装 Visual C++ 可再发行程序包 和 .NET 桌面运行时 10，然后重启电脑。

Windows 10 或 11 用户也可以使用 winget 安装运行库：

winget install Microsoft.VCRedist.2015+.x64 Microsoft.DotNet.DesktopRuntime.10

macOS

压缩包已自带 Python 3.12.9 环境。解压后，在文件夹内打开终端并执行：

chmod a+x MFAAvalonia
chmod a+x python/bin/python3
./MFAAvalonia

若启动失败并提示缺少运行库，请按提示安装 .NET 运行库。若系统提示“Apple 无法检查其是否包含恶意软件”，请在“系统设置”中的“隐私与安全性”里选择“仍要打开”。由于文件较多，可能需要重复确认。

Linux

Linux 版本提供基础包体，但当前主要测试仍集中在 Windows。遇到问题请携带日志反馈。

开发相关

MaaGakumasu 基于 MaaFramework 开发，采用 JSON + 自定义逻辑扩展 模式。开发前建议先阅读：

• 功能说明
• 开发相关
• 提问与反馈指南
• MaaFramework 文档

YOLOv11 训练

YOLOv11 主要用于自动培育识别。模型训练参考 MaaNeuralNetworkCookbook，数据集标注使用 Roboflow。

[!NOTE] 早期用于上课、冲刺选项识别的 button 数据集已废弃；相关按钮识别已改为普通模板匹配，不再使用 YOLOv11。

欢迎参与标注或提供样本，具体说明请查看 开发相关。

Mirror 酱

自 2025/11/08 起，MaaGakumasu 已全面支持 Mirror 酱，在其他地方购买的 CDK 同样可以在此使用。

Mirror 酱是第三方应用分发平台，用于简化开源应用更新。用户付费使用，收益与开发者共享，Mirror 酱本身也是开源项目。

CDK 购买入口：Mirror 酱官网

免责声明

本软件开源、免费，仅供学习交流使用。若您遇到商家使用本软件进行代练并收费，可能是分发、设备或时间等费用，产生的费用、问题及后果与本软件无关。

在使用过程中，MaaGakumasu 可能存在任何意想不到的问题，因 MaaGakumasu 自身漏洞、文本理解有歧义、异常操作导致的账号问题等开发组不承担任何责任，请在确保在阅读完用户手册、自行尝试运行效果后谨慎使用！

Star History

鸣谢

本项目由 MaaFramework 强力驱动！ UI 由 MFAAvalonia 大力支持！

感谢以下开发者对本项目作出的贡献:

Join us

• MaaGakumasu 交流群 QQ 群：799823681
• MaaFramework 开发交流 QQ 群: 595990173