安装 AstroDX
AstroDX 是社区开发的 maimai 风格模拟器，本站只提供谱面，不分发应用本体。两个平台的下载渠道不同，请按你的设备选择。
- iOS / iPadOS：直接在 App Store 搜索并安装 AstroDX，官方推荐的稳定版本。（早期需要 TestFlight 或侧载 IPA 的说法已经过时。）
- Android：从 GitHub Releases 下载最新的 APK 安装，系统提示「允许安装未知来源应用」时手动放行即可。
装好之后、导入谱面之前，务必先把游戏完整启动一次——AstroDX 要在首次启动时初始化自己的文件目录，跳过这一步会导致后面导入的谱面无处安放。首次启动时曲库是空的，这是正常的。
- App Store — iOS / iPadOS 稳定版（官方推荐）
- GitHub Releases — Android APK，最新版本
- AstroDX Wiki — 官方文档，本页内容以它为准
在本站找谱与下载
曲库页支持按曲名、曲师、别名（罗马音也可以）搜索，也能按版本、曲风、定数、BPM 和资源状态筛选。找到想要的谱面后，点开详情页即可下载。
下载按钮旁的菜单可以选择打包格式，三种格式装的是同一批文件，区别只在压缩容器：
- .adx —— 推荐的 AstroDX 导入格式。Android 用「打开方式 / 分享」交给 AstroDX；iOS 移到 AstroDX 文件夹本身，再重新打开游戏。无需解压。
- .zip —— 通用压缩包，任何系统都能解压，适合先在电脑上整理再传到手机。
- .tar.gz —— 适合命令行环境或归档，不能仅改成 .adx 后直接导入。要导入游戏，请重新选择 .adx 格式下载。
带 BGA 的谱面会额外打包一段背景动画视频（pv.mp4）。它只影响背景演出，不影响判定；关闭「包含 BGA 视频」可以减少下载体积。手机上单首资源仍然很大时，建议关闭 BGA 或改用电脑下载。
- 手机批量下载会拆成独立的小批次。保持页面打开，等待本批打包完成后，逐个点击「保存文件」。
- 在浏览器的下载记录中确认本批每个文件已下载完成；若没有文件或还需重试，先点「再次保存」，不要确认释放。
- 确认保存后，点「已确认保存，继续下载」释放本批缓存并开始下一批；最后一批点「确认保存并释放缓存」。每个分包都要分别保存和导入，释放后仍可按保留的导入引导操作。
只有尚未移除任务或释放缓存时，刷新页面后才能从保留的已下载数据重新打包。释放后不能再次保存同一份缓存；整组选曲下载完成后，可从下载托盘的「最近下载」重新下载。整组未完成时，先完成剩余批次，或重新选曲下载。
站内提供多条下载线路。若当前线路速度不理想，可在设置面板里切换默认线路，或临时改用其他镜像。
导入谱面
AstroDX 认的是 .adx 文件——本质上就是一个把曲目文件夹整个装进去的 zip，只是把扩展名改成了 .adx。本站下载的 .adx 已经打好，直接用即可；如果你拿到的是 .zip，把扩展名改成 .adx 就行（改不了扩展名时，改成「文件名.adx.zip」同样有效）。
- iOS / iPadOS：打开「文件」App，把 .adx 移动到带 AstroDX 应用图标的 AstroDX 文件夹里。注意是这个文件夹本身，不要放进它下面的 levels 或 collections。
- Android：在文件管理器里点一下 .adx，在「打开方式」里选择 AstroDX；如果列表里没有 AstroDX，就长按文件选择「分享」，再在分享菜单里选 AstroDX。
- 在电脑上下载时：不用解压，把 .adx 原样传到手机即可——Mac 用 AirDrop，Windows / Linux 可以用 LocalSend（官方 Wiki 推荐）、数据线或网盘，然后按上面对应平台的步骤操作。
接着打开 AstroDX，会看到一条导入进度条；进度条走完进入选曲界面，新谱面就在列表里了。iOS 上是下次启动游戏时自动整理，Android 上是选完「用 AstroDX 打开」后立即开始。
AstroDX 文件夹下面的 levels 与 collections 是游戏自己管理的：levels 放谱面文件，collections 放合集信息（每个合集一份 manifest.json）。想手动编辑合集可以看官方 Wiki，但日常导入完全不需要碰它们。
- 视频教程 · 谱面导入 — B 站实录，跟着做一遍最快
- Wiki · iOS / iPadOS 导入教程 — 官方分步说明
- Wiki · Android 导入教程 — 含视频演示
常见故障
- 下载卡住不动 / 速度极慢怎么办？
- 多半是当前下载线路到你所在网络的链路不通畅。打开右上角设置面板，在「下载」里重新测速并切换到延迟更低的线路，然后重新开始任务。下载中断的任务可以在下载托盘里点重试，已完成的文件不会重复下载。
- 手机批量下载停在保存阶段，下一批不开始？
- 这是等待你确认本批保存的阶段。先逐个保存，在浏览器下载记录中确认文件已下载完成，再点「已确认保存，继续下载」；最后一批点「确认保存并释放缓存」。释放后不能直接再次保存；整组完成后可从下载托盘的「最近下载」重新下载，未完成时先完成剩余批次，或重新选曲。下载期间保持页面打开。
- 显示已发起保存，但手机里找不到文件 / 下载成 .bin？
- 「已发起保存」只表示浏览器收到保存请求，不代表文件已经落盘。先检查浏览器下载记录，完成后再到「文件」App 或文件管理器查找。缓存尚未释放时可点「再次保存」；若变成 .bin，先重试保存或改用 .zip 下载，再按导入步骤改名，勿直接把 .bin 改成 .adx。缓存已释放时，整组完成后从下载托盘的「最近下载」重新下载；未完成时先完成剩余批次，或重新选曲。
- 压缩包打不开 / 提示文件损坏？
- 先在浏览器下载记录中确认保存是否完成。缓存尚未释放时，优先点「再次保存」；仍然损坏或缓存已释放，再重新下载。.adx 无需手动解压；.zip 可改成 .adx 或「文件名.adx.zip」再导入；.tar.gz 不能仅改后缀直接导入，要玩谱面请重新下载 .adx，要解压归档请用支持 TAR.GZ 的工具。
- 导入后 AstroDX 里看不到这首谱面？
- 最常见的原因是把压缩包直接丢进了 levels 文件夹——官方 Wiki 专门把这条列为已知错误。正确做法是把 .adx 放到 AstroDX 文件夹本身（iOS），或用「打开方式 / 分享」交给 AstroDX（Android），由游戏自己解包。另外确认安装好之后已经完整启动过一次游戏，否则目录还没初始化；仍然看不到就重启一次应用。
- 文件管理器里没有「打开方式」或「分享」（Android）？
- 换一个文件管理器即可，官方 Wiki 推荐 ZArchiver 或 Android SAF。另外如果遇到 IOException: Permission denied，通常是文件管理器以高权限改写过谱面文件，导致 AstroDX 读不了，改用上述方式重新导入即可。
- iOS 上改不了文件扩展名？
- 在「文件」App 里打开右上角更多菜单（三个点）→ 显示选项，勾选「显示所有文件扩展名」，然后长按文件重命名。实在改不了就把名字写成「文件名.adx.zip」，AstroDX 同样认。
- 游戏里没有声音，或者封面是空白的？
- 说明曲目文件夹里缺少 track.mp3 或 bg.png。部分上游谱面本来就没有附带音频或封面，谱面详情页顶部的资源标签会标明；如果详情页显示有、下载后却没有，请重新下载一次完整压缩包。
还是没解决？欢迎带上谱面名称和具体现象来找我们：
- GitHub Issues — 本站的问题反馈与功能建议
- AstroDX 应用 Issues — 游戏本体的 Bug 请提到上游仓库
- QQ 交流群 — 国内玩家主要交流群
- Telegram 群组 — 国际玩家与站点动态