MaaGakumasu

基于全新架构的 学園アイドルマスター(学マス) 小助手。图像技术 + 模拟控制 + 深度学习，解放双手！
由 MaaFramework 强力驱动！

✨ 如果喜欢 MaaGakumasu，欢迎在项目右上角点亮 Star 支持 ✨

功能列表

• 目前已实现

• 启动游戏

• 领取活动费

• 竞赛挑战

  • 指定挑战
  • 自动选择
  • 无编队时自动编队

• 社团互动

  • 自动/指定 请求

• 安排工作

  • 领取奖励
  • 自动/指定 选择偶像
  • 指定时长

• 商店购买

  • 扭蛋购买
  • 金币购买
  • 自动免费刷新
  • AP购买

• 领取邮箱礼物

• 领取任务奖励

• 领取每周免费礼包

• 自动培育(测试阶段)

  • 初 REGULAR/PRO/MASTER 难度
  • 指定SSR偶像
  • 自动选择
  • 使用体力药
  • 出牌偏好(仅限活动牌)
  • 中断继续

• 支持从Mirror酱更新

• 插件版汉化

• DMM版适配

• i18n适配(已支持繁体，更多语言等待补充……)

详细内容见 功能说明

• 等待实现
• 支援卡库存识别
• NIA 适配
• 初 LEGEND 培育适配
• …………

版本适配情况

	模拟器	DMM
原版日语	已适配，已完全测试	已适配，未经过完全测试
插件版汉化	已适配，已通过测试	已适配，未测试

注意事项

Note

大部分测试都是在 Windows 系统上测试的，因此其他操作系统若有运行问题，请提 Issues 或加群讨论。
开发是基于 MuMu12 模拟器测试的，因此推荐使用 MuMu12 运行游戏。 其他模拟器若出现问题，请第一时间把脚本根目录下debug\maa.log 文件保存并截图进行反馈。

1. 默认用户的操作系统为 Windows 系统，其他平台未经测试
2. 推荐使用MuMu模拟器12运行游戏，模拟器支持情况请查看官方文档。
3. 模拟器分辨率建议设置为1280*720(240DPI)，其他16:9分辨率未经过详细测试，DMM端同理。
4. DMM版本需要以管理员身份启动程序，插件版汉化已支持，并未完全测试。
5. 本项目部分功能使用了 深度学习Yolov11 模型进行识别，请确保电脑有显卡且开启GPU加速。
6. 本项目仅用于学习交流，请勿用于商业用途，否则后果自负。
7. 本项目仅提供脚本，不提供任何游戏资源，如需要游戏资源，请自行购买。

使用说明

Windows

• 对于绝大部分用户，请下载 MaaGakumasu-win-x86_64-vXXX.zip
• 若确定自己的电脑是 arm 架构，请下载 MaaGakumasu-win-aarch64-vXXX.zip

请注意！Windows 的电脑几乎全都是 x86_64 的，可能占 99.999%，除非你非常确定自己是 arm，否则别下这个！

解压后运行 MaaGakumasu.exe 即可。

压缩包已自带Python 3.12.9环境，无需额外安装。

首次启动，将会自动安装相关依赖

如果无法运行则按照如下的方案尝试解决:

MAA 本家提供的解决方案 ⬇️

请安装 Visual C++ 可再发行程序包 和 .NET 桌面运行时 10 并 重新启动计算机 。

推荐使用 Windows 10 或 11 的用户使用 winget 工具进行安装，只需在终端中运行以下命令。

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

MacOS

• 若使用 Intel 处理器，请下载 MaaGakumasu-macos-x86_64-vXXX.zip
• 若使用 M1, M2 等 arm 处理器，请下载 MaaGakumasu-macos-aarch64-vXXX.zip
• 压缩包已自带 Python 3.12.9 环境，无需额外安装。
• 解压缩之后，右击文件夹，点击"新建位于文件夹位置的终端窗口"
• 在终端窗口内逐行输入以下指令

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

注：需要安装.NET 运行库（使用上面的命令启动失败时会直接返回下载地址）

• Mac 可能会提示：因为 Apple 无法检查其是否包含恶意软件

此时进入选择 设置 - 隐私与安全性，下方出现"已阻止…"点击 仍要打开。 多重复以上步骤，因为有很多文件会被检查。

Linux

Linux大佬自有办法

开发相关

• 等待完善

深度学习YOLOv11训练相关

主要用于 自动培育 相关功能

模型训练参考MFW官方文档

数据集标注使用 roboflow 网站

• cards 集用于识别出牌
• button 集用于识别上课/冲刺选项

Important

cards 集 目前902份样本，均已标注完成，对多卡重叠的情况进行了额外强化训练。

button 集 目前131份样本，均已标注完成。基本满足当前需求。

若您有兴趣参与标注或者提供样本，欢迎联系开发组。

详细内容见 开发相关

Mirror酱相关

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

Mirror酱是一个第三方应用分发平台，让开源应用的更新更简单。

用户付费使用，收益与开发者共享。此外，Mirror酱本身也是开源的。

CDK 购买连接: 官网

免责声明

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

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

Star History

鸣谢

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

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

Join us

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