Windows ADB + MaaFramework OCR + 模板匹配

在模拟器上辅助 Garupa 操作的自动化工具

Dream Helper 通过 ADB 控制 Android 模拟器，辅助选曲与运行 Live。

获取免责声明

重要：本项目为非官方工具，与权利方/运营方无关。使用风险自负。

功能概览

自动连接模拟器并运行流程
自动演奏大量收集星星
Live Boost 自动恢复，冲击活动排名
支持 Free / Multi / Challenge Live
角色自动训练、剧情自动回收（获取更多星星）

系统: Windows
连接: ADB
推荐分辨率: 1280×720
模拟器: MuMu / LDPlayer

演示视频

查看 Dream Helper 的实际运行效果。

Free Live 自动周回

从选曲到完成的完整流程

Multi Live 自动参加

从匹配到结算的完整流程

※ 视频在实际游戏环境中录制。效果可能因环境而异。

功能

在 GUI 中设置并 Start/Stop。

自动运行（Live）

支持 Free Live / Multi Live / Challenge Live，可配置曲库并辅助周回。

筛选未 Full Combo 的曲目收集星星（Free Live）
限定从收藏曲目中选曲
Live Boost 不足时自动恢复（星星/饮料）

手动指定（Manual Play）

手动选择歌曲与难度并运行（例如 Stage Challenge）。

搜索并选择曲目
设置难度并运行

实用工具

自动化任务（如：购买歌曲、角色训练等）

已知限制

模拟器卡顿、微冻结或噪声可能导致时序偏移，使自动演奏不稳定。低配环境下成功率可能下降。

Multi Live 中，同名曲目（如：オレンジ、シルヴ・プレジデント）可能导致选曲失败，约 50% 概率失败。此外，Multi Live 难度目前固定为 EXPERT（如有需求可扩展）。

环境与推荐设置

必需

Windows
带 ADB 的 Android 模拟器
MuMu / LDPlayer（已测试）

游戏内推荐

速度：9.30
关闭 3D cut-in
动作模式：轻量
开启 FAST/SLOW 与 Perfect 显示
分辨率：1280×720

获取 / 安装

请将下面按钮替换成你的实际发布链接（GitHub Releases / BOOTH / 直链等）。

1) 下载

示例：发布 dream_helper.exe（Windows）。

下载（替换链接）

2) 设置模拟器

启用 ADB，设置 16:9 分辨率。

查看要求

3) 运行

在 UI 中选择模式/难度/Live 类型并开始。

FAQ

为什么经常失败？

模拟器卡顿、微小冻结或噪声会导致时序偏移。请检查分辨率与游戏设置，并根据需要调节延迟参数（如 Photogate）。

Multi Live 同名曲目导致失败

由于设计限制，同名曲目可能无法正确选择，约 50% 概率失败。（如：オレンジ、シルヴ・プレジデント）

会封号吗？安全吗？

自动化可能违反游戏服务条款，无法保证安全性。请自行承担风险。

不过，自 2025年10月发布以来，尚未收到任何封号报告。

免责声明

本项目为非官方工具，与权利方/运营方无关。
自动化可能违反服务条款，作者不对任何后果负责。
稳定性依赖环境（分辨率、UI 语言、性能、网络、设置）。