安装 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 的导入格式，在手机上点开就能直接导入，推荐优先选它。
- .zip —— 通用压缩包，任何系统都能解压，适合先在电脑上整理再传到手机。
- .tar.gz —— 同样是通用压缩包，体积通常更小，适合命令行环境或批量归档。
带 BGA 的谱面会额外打包一段背景动画视频（pv.mp4）。它只影响游玩时的背景演出，不影响判定，但体积往往是谱面本身的好几倍；批量下载时可以关掉「包含背景视频」来省流量。
站内提供多条下载线路。若当前线路速度不理想，可在设置面板里切换默认线路，或临时改用其他镜像。
导入谱面
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 导入教程 — 含视频演示
常见故障
- 下载卡住不动 / 速度极慢怎么办？
- 多半是当前下载线路到你所在网络的链路不通畅。打开右上角设置面板，在「下载」里重新测速并切换到延迟更低的线路，然后重新开始任务。下载中断的任务可以在下载托盘里点重试，已完成的文件不会重复下载。
- 压缩包打不开 / 提示文件损坏？
- 先确认文件是否下载完整——中途断线得到的半截文件无法解压，删掉重下即可。iOS 自带的解压功能对部分 .tar.gz 支持不佳，建议改下 .zip，或者用支持该格式的解压工具。
- 导入后 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 群组 — 国际玩家与站点动态