MaaGakumasu

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

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

功能列表

• 目前已实现

• 启动游戏

• 领取活动费

• 竞赛挑战

  • 指定挑战
  • 自动选择

• 社团互动

  • 自动/指定 请求

• 安排工作

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

• 商店购买

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

• 领取邮箱礼物

• 领取任务奖励

• 自动培育(测试阶段)

  • 初 REGULAR/PRO/MASTER 难度
  • 指定SSR偶像
  • 自动选择
  • 中断继续

详细内容见 功能说明

• 等待实现

• 支持Kuyo版汉化

• 强化支援卡

• …………

注意事项

Note

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

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

使用说明

Windows

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

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

解压后运行 MFAAvalonia.exe 即可。

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

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

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

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

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

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

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

MacOS

• 若使用 Intel 处理器，请下载 MaaGakumasu-macos-x86_64-vXXX.zip

• 若使用 M1, M2 等 arm 处理器，请下载 MaaGakumasu-macos-aarch64-vXXX.zip

• 解压缩之后，右击文件夹，点击“新建位于文件夹位置的终端窗口”

• 在终端窗口内逐行输入以下指令

  chmod a+x MaaGakumasu
  ./MaaGakumasu
  

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

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

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

Linux

Linux大佬自有办法

开发相关

• 等待完善

深度学习YOLOv11训练相关

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

模型训练参考MFW官方文档

数据集标注使用 roboflow 网站

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

Important

cards 集 目前405张样本，均已标注完成。基本满足当前需求

button 集 目前仅28张样本，均已标注完成。目前未能完全满足当前需求，部分场景下识别率较低。

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

详细内容见 开发相关

免责声明

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

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

Star History

鸣谢

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

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

Join us

• MaaGakumasu 交流群 QQ 群：还没建立
• MaaFramework 开发交流 QQ 群: 595990173

Footnotes

1. 因MaaFramework框架限制，购买指定物品需要手动修改config.jsonc文件 ↩ ↩²