go-music-dl

# Go Music DL > ⭐ 如果这个项目正在帮你省时间，欢迎顺手点一个 Star。Star 越多，作者越能确认这个工具确实有人在用，也会更有动力优先修复失效站点、适配新站点和更新版本。

Go Music DL 是一个音乐搜索与下载工具，支持 **Web 界面**、**TUI 终端** 和 **桌面应用** 三种使用模式。除了单曲搜索与下载外，还支持 **歌单搜索 / 解析**、**歌单分类浏览**、**我的歌单**、**专辑搜索 / 解析**、整单 / 整专曲目查看与批量处理。你可以在浏览器试听，也可以在终端里批量下载，或使用原生桌面应用享受最佳体验。 ## 快速开始 ### 桌面应用 (推荐) 最简单的使用方式，下载即用： 1. 从 [Releases](https://github.com/guohuiyuan/go-music-dl/releases) 下载 `music-dl-desktop-rust.exe` 或 `music-dl-desktop-go.exe` 2. 解压，双击运行 3. 享受原生桌面体验！ 移动端下载说明：在 [Releases](https://github.com/guohuiyuan/go-music-dl/releases) 页面可直接下载 Android `music-dl_arm64-v8a.apk`（推荐）/ `music-dl_x86_64.apk` / `music-dl.apk`（无分片兼容包）。Android APK 已内置 `ffmpeg` 与 `ffprobe`，本地音乐探测、非 MP3 元数据内嵌和视频渲染无需在手机上额外安装 FFmpeg。iOS 会提供 `music-dl-ios-unsigned.ipa` 给用户自行签名；如果发布环境配置了证书，也会额外提供已签名的 `music-dl-ios.ipa`。 ### Web 模式 ```bash ./music-dl web ``` Web 服务默认挂载于 `/music` 路径下。如需通过反向代理挂载到二级目录，可使用 `--base-path` 参数： ```bash ./music-dl web --base-path /dl ``` 对应的 Nginx 反向代理示例： ```nginx location /dl/ { proxy_pass http://127.0.0.1:8080; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for; proxy_set_header X-Forwarded-Proto $scheme; } location = /dl { return 301 /dl/; } ``` Web 模式默认不要求登录即可搜索、播放、下载、浏览歌单 / 专辑和使用本地歌单等普通功能。只有进入右上角 **设置**、保存系统设置、管理平台 Cookie、通过扫码登录写入 Cookie 等系统配置操作需要管理员登录。 首次触发系统配置登录时，如果还没有管理员账号，启动终端会打印一次性初始化令牌。打开初始化页后填入该令牌，并设置用户名和至少 6 位密码即可创建管理员账号；之后点击设置或右上角登录按钮会进入登录流程。会话 Cookie 默认保留 7 天，右上角按钮会根据状态切换为登录 / 退出登录；退出后会回到首页，普通功能仍可继续使用。 桌面端和移动端 App 内嵌 Web 服务使用 `StartDesktop` 启动，仅监听本机 `127.0.0.1`，并默认关闭 Web 管理员登录流程，避免首次启动时因看不到终端初始化令牌而无法进入应用。 ### TUI 模式 ```bash ./music-dl -k "搜索关键词" ``` --- ## 主要功能 * **多模式支持**: Web 界面、TUI 终端、桌面应用 * **本地自制歌单**: 支持新建本地收藏夹，随时收藏、管理心仪歌曲，数据持久化不丢失 * **歌单分类浏览**: Web 端可按平台查看官方分类，进入分类后浏览推荐歌单并打开详情 * **我的歌单**: Web 端可读取已登录账号的个人歌单 / 收藏歌单，支持进入详情和批量处理 * **Cookie 扫码登录**: Web 设置面板支持扫码获取 Cookie，成功后自动保存到本地配置；汽水音乐扫码登录暂未调通，入口已临时隐藏 * **本地音乐管理**: Web 端可读取本地下载目录音乐，支持上传、添加到自制歌单、封面/歌词读取与删除；列表默认分页加载并缓存扫描与元数据，几千首本地音乐也能秒开 * **无损音乐支持**: 支持网易云、QQ 音乐、Bilibili 的 FLAC 无损音乐下载 * 多平台聚合搜索，支持单曲 / 歌单 / 专辑 * 试听、歌词、封面下载 * **歌词双格式支持**: 网易云、QQ 音乐、酷狗支持原文 / 译文 / 罗马音逐字 LRC 展示与卡拉 OK 式逐字高亮；其他渠道保持原文逐行歌词显示 * Range 探测：显示大小与码率 * 汽水音乐等加密音频解密 * 过滤需要付费的资源 * **桌面应用特性**: 原生窗口、自动服务启动、智能缓存管理 ## 歌单 / 专辑支持 * **Web**: 支持单曲、歌单、专辑三种搜索类型切换，可直接查看歌单 / 专辑曲目列表 * **链接解析**: 支持直接粘贴歌单链接或专辑链接，自动识别来源并进入详情 * **歌单分类**: Web 端提供“歌单分类”入口，可在不同平台之间切换分类来源，并按分类浏览歌单 * **我的歌单**: Web 端提供“我的歌单”入口，登录后可查看个人创建、收藏或喜欢的歌单 * **TUI**: 输入界面支持在单曲 / 歌单 / 专辑之间切换，适合整单 / 整专处理 * **详情跳转**: Web 歌曲列表支持从歌曲跳转到歌手搜索结果或对应专辑页 * **渠道同步**: 已同步 `music-lib` 中咪咕、Jamendo、JOOX、千千、汽水等歌单 / 专辑函数，JOOX 歌单支持 OpenJOOX 接口和网页数据兜底 ## 歌单分类与我的歌单 Web 首页的歌单入口旁提供 **歌单分类** 和 **我的歌单**： * **歌单分类**: 支持网易云、QQ、酷狗、酷我、咪咕、千千、JOOX、Apple Music。进入后可切换平台标签，选择分类并查看该分类下的歌单。 * **我的歌单**: 支持网易云、QQ、酷狗、汽水。需要先在 Web 右上角“设置”中配置对应平台 Cookie；QQ 支持“我喜欢的歌曲”和收藏歌单，汽水支持“喜欢的音乐”和导入歌单，均可在站内解析歌曲列表。 * **详情与导入**: 分类歌单和我的歌单都可进入详情页，歌曲列表支持播放、下载、批量操作，也可导入到本地自制歌单。 ## Cookie 与扫码登录 Web 右上角“设置”可管理各平台 Cookie。支持扫码登录的平台会在 Cookie 输入框右侧显示 **扫码** 按钮： * **支持平台**: 网易云音乐、QQ 音乐、酷狗音乐、Bilibili。 * **使用方式**: 点击对应平台“扫码”，用官方 App 扫码并确认登录；登录成功后 Cookie 会自动写入输入框并保存到本地。 * **汽水音乐**: 新版官方 PC passport 扫码流程依赖动态 `a_bogus` / `msToken` 风控签名，目前未调通，Web 端已临时隐藏扫码入口；需要汽水个人歌单或下载能力时请先手动配置 Cookie。 * **用途**: Cookie 可用于获取更完整的搜索 / 下载能力、读取“我的歌单”、访问部分需要登录态的高音质或个人数据。 * **存储位置**: Cookie 会保存到本地数据目录，不会上传到第三方服务；请勿把包含 Cookie 的配置文件公开分享。 ## 本地音乐 Web 端在“我的自制歌单”旁提供 **本地音乐** 入口，用于管理本地下载目录里的音频文件。下载目录来自 Web 右上角“设置”里的“本地下载目录”，默认是 `data/downloads`。Android 端建议把本地下载目录设置为 `/sdcard/Music`，便于系统音乐应用识别。 设置里的 **音乐文件名模板** 支持 `{name}`、`{artist}`、`{album}`、`{source}`、`{id}`、`{ext}`。未写 `{ext}` 时会自动追加扩展名；模板中的 `/` 或 `\` 可创建相对子目录。例如本地下载目录为 `/app/data`，模板为 `{artist}/{album}/{name} - {artist}.{ext}` 时，会保存到 `/app/data/歌手/专辑/歌名 - 歌手.flac` 这类路径。歌曲元数据本身包含的斜杠会被安全替换为 `_`，`..`、`.` 等路径穿越段会被忽略。 * **自动读取**: 打开本地音乐列表时会扫描下载目录，返回与普通歌曲列表一致的数据结构，来源标记为 `local`。 * **支持格式**: `mp3`、`flac`、`m4a`、`ogg`、`wav`、`wma`、`aac`。 * **上传音乐**: 可在弹窗中上传音频文件，文件会保存到下载目录；如文件名冲突，会自动追加序号。 * **信息补全**: 优先读取音频文件内的标题、歌手、专辑、时长、封面和歌词；缺失时会使用文件名、`Unknown` 等兜底信息。 * **耗时探测**: 时长、码率、标题、歌手、专辑等缺失信息会尽量通过 `ffprobe` 探测补齐；未安装 `ffprobe` 时仍可显示和添加，只是部分信息可能为空。 * **封面与歌词**: 封面优先读取音频内嵌图片，没有则查找同目录同名图片（`.jpg`、`.jpeg`、`.png`、`.webp`、`.bmp`、`.gif`）；歌词优先读取音频内嵌歌词，没有则查找同目录同名歌词文件（`.lrc`、`.txt`、`.lyric`）。 * **列表封面显示**: 本地音乐列表会直接返回内嵌封面的 `/local_music/cover` 地址；没有内嵌封面时再使用同名图片兜底。 * **作为搜索源**: 本地音乐已升级为一等搜索源 `local`，会出现在源勾选网格里（默认不勾选）。勾选后在**单曲搜索**里按关键词把匹配的本地歌曲与在线结果一起返回；切到**歌单搜索**并勾选 `local` 时，可按名称 / 描述 / 创建者搜索本地自建与导入歌单。搜索由内置 SQLite 索引表驱动，几千首本地音乐也能快速命中。 * **添加到歌单**: 在本地音乐弹窗选择目标自制歌单后，可把本地歌曲加入该歌单；支持**批量收藏**（本地音乐页选中多首后一次性加入目标歌单）。外部导入歌单 / 专辑不支持直接添加本地音乐。 * **删除**: 本地音乐列表、单曲搜索结果中的本地歌曲、以及本地歌单搜索结果都支持删除；本地歌曲为**硬删除**（移除下载目录里的实际文件并清除索引），删除前会二次确认。删除后该歌曲不再出现在搜索结果中。 * **歌单内失效与换源**: 删除被收藏过的本地歌曲后，自制歌单里的对应条目会保留并显示为失效，可在歌单详情页对其**换源**到在线音源恢复播放。 * **与其他源一致**: 本地歌曲卡片与其他来源基本相同，仅去掉“保存到本地目录”按钮（对已在本地的文件无意义），保留播放、收藏、歌词、封面、浏览器下载、（歌单内）换源等操作。 ### 本地音乐性能优化 结合后端缓存与前端分页，减少重复扫盘 / `ffprobe` / tag 解析的开销： * **列表分页加载**: 本地音乐页面按 “Web 每页条数” 设置分页，支持 `PgUp / PgDn` 快捷翻页与 URL `?page=` 状态保持，避免一次性渲染上千条。 * **扫描快照缓存**: `GET /api/local_music` 结果会缓存 10 秒；TTL 内反复访问直接返回快照，不重扫。 * **后台异步刷新**: 缓存过期会立即返回上次结果并启动后台异步重扫，页面顶部提示“正在后台刷新本地音乐列表，当前显示上次扫描结果”。 * **元数据缓存**: 每首歌的标题 / 歌手 / 专辑 / 封面 / 歌词 / 时长 / 码率按 `路径 + 文件大小 + 修改时间` 索引；命中后跳过 `ffprobe` 与 tag 解析，文件未变动时几乎零开销。 * **失效触发**: 上传、删除本地音乐后会立即作废快照缓存，下一次请求重新扫描。 * **强制刷新**: 调用 API 时传 `?refresh=1` 可绕过缓存进行整目录重扫。 * **搜索索引表**: 启动时在 `data/settings.db` 里异步建立本地音乐索引表（下载目录的索引：扫描时按文件 upsert、文件消失即清除该行），让“本地音乐作为搜索源”的关键词搜索免去逐次重扫与 `ffprobe`；搜索时仍对命中结果做存在性校验，已删除 / 移动的文件不会出现在结果中。 * **Android 读取修复**: 在 Android 端动态申请 `READ_MEDIA_AUDIO` / `READ_EXTERNAL_STORAGE` 权限，修复了 `/sdcard/Music` 下本地音乐无法读取的问题。 ## Web 下载模式与 FFmpeg Web 端“设置”里新增了 **下载时内嵌元数据（封面/歌词）** 开关： * **默认关闭（推荐）**：走流式下载，速度更快，并支持 `Range` 断点/拖动播放。 * **开启后**：下载时会尝试把封面、歌词写入音频文件（embed）。 > ⚠️ 开启内嵌元数据依赖 **FFmpeg**。未安装 FFmpeg 时，会自动跳过内嵌并返回原始音频。 可先验证 FFmpeg 是否可用： ```bash ffmpeg -version ``` 常见安装方式： * Windows: `winget install Gyan.FFmpeg` * macOS: `brew install ffmpeg` * Ubuntu/Debian: `sudo apt install ffmpeg` ## WebDAV 同步 Web 设置里新增了 **下载时同步到 WebDAV** 开关。开启并填写 WebDAV 地址、用户名、密码和远端目录后，点击“保存到本地目录”或“浏览器下载”时，会把音乐文件同时上传到 WebDAV。密码保存在服务端 `data/settings.db`，Web 设置接口不会回显密码。 仓库提供本地 Docker WebDAV 测试配置，使用 `127.0.0.1`，不需要域名： ```bash docker compose -f docker-compose.webdav.yml up -d ``` 测试地址为 `http://127.0.0.1:18081/dav`，用户名 `test`，密码 `123456`。上传目录会映射到本仓库的 `data/webdav`。 ### Docker / Release 包里的 FFmpeg 与 ffprobe `ffprobe` 属于 FFmpeg 工具集，主要用于本地音乐的时长、码率和标签探测；`ffmpeg` 主要用于非 MP3 音频的封面/歌词元数据写入。缺少它们不会影响程序启动，也不会阻塞本地音乐列表加载，只会降级相关增强能力。 * **Docker 镜像**: `Dockerfile` 已安装 Alpine 的 `ffmpeg` 包，并在构建时校验 `ffmpeg` 与 `ffprobe` 都可用；Docker / Compose 部署通常无需额外安装。 * **GitHub Release 的 Android APK**: `release.yml` 会在 APK 构建后下载 Android `arm` / `arm64` / `x86` / `x86_64` 的 `ffmpeg` 与 `ffprobe`，写入 APK 的 `assets/ffmpeg//`，再重新 `zipalign` 与签名。Android App 启动后会自动解压到应用私有目录并配置这些内置二进制路径。 * **GitHub Release 的 CLI / 桌面 / iOS 包**: 仍不内置 `ffmpeg/ffprobe`，也不要求 CI 打包机安装它们；如果需要本地音乐探测或非 MP3 元数据内嵌，请在运行机器上按上面的命令自行安装 FFmpeg。 * **Linux deb/rpm/AppImage**: 仍按外部系统工具处理，不强制声明硬依赖，避免在不同发行版上因为 FFmpeg 包源差异导致安装失败。 ## 新增改动（简要） * **播放自动缓存开关**：系统设置提供“播放时自动缓存本地音乐”，默认关闭，避免持续占用储存空间；需要时可手动开启。 * **本地音乐分页与同步优化**：本地音乐分页在切换每页条数或连续翻页时会保留最后一次请求并对短暂网络错误重试，避免直接显示 `Failed to fetch`；上传、删除、播放时本地缓存和后台扫描会自动同步 SQLite 索引，因此已移除界面的“刷新索引”按钮。重复检测弹窗删除歌曲后会同步刷新底部列表、总数和分页。 * **本地已有匹配更准确**：在线结果带有歌手信息时，“本地已有”必须同时匹配歌名和歌手；同名但不同歌手的歌曲不会再被标记为本地已有或错误改用本地文件播放。 * **播放器控件调整**：播放顺序 / 随机 / 单曲循环切换按钮改为封面上方的图标按钮，不再遮挡播放或暂停操作。 * **蓝牙切歌与媒体键**：Android app 蓝牙连接车机播放时，支持方向盘按键切歌（上一首 / 下一首 / 播放暂停）；既走系统媒体会话（AVRCP），也对车机经网页下发的媒体键（`MediaTrackNext` / `MediaTrackPrevious` / `MediaPlayPause`）做兜底处理。前台播放时生效。 * **Web 空格播放/暂停**：Web 端新增空格键快捷键切换播放 / 暂停；焦点在输入框或弹窗打开时不触发，避免误操作。 * **本地音乐升级为搜索源**：本地音乐成为一等搜索源 `local`（默认不勾选），单曲搜索可把本地结果与在线结果一起返回，歌单搜索可检索本地自建 / 导入歌单；由内置 SQLite 索引表驱动，几千首本地音乐也能快速命中。本地歌曲卡片与其他源一致，仅去掉“保存到本地目录”按钮。 * **批量收藏增强**：批量操作模式下可勾选多首任意来源歌曲，点“批量收藏”一次性加入目标自制歌单；本地音乐页也支持选中多首一次性收藏。 * **本地音乐删除增强**：单曲搜索结果、本地歌单搜索结果中的本地内容均可删除。本地歌曲改为硬删除（移除文件 + 清索引），删除被收藏过的本地歌后，自制歌单里的对应条目保留并显示为失效，可在歌单详情页换源到在线音源恢复播放。 * **Web 图片 / 歌词改为浏览器下载**：歌曲封面与歌词的下载按钮改为直接由浏览器下载，不再写入服务器本地下载目录。 * **TUI 内置试听**：TUI 单曲列表支持 `p` 播放、`s` 停止，基于系统 `ffplay` 后台播放，退出时自动停止。 * **Web 架构全面重构**：前端代码彻底模块化（拆分独立的 JS / CSS / HTML 模板），后端路由按业务域拆分（音乐查询、歌单管理、视频生成），大幅提升代码可维护性。 * **新增自制歌单功能**：Web 端支持本地收藏夹，用户可自由创建、编辑歌单，将不同平台的歌曲聚合收藏。 * **新增歌单分类与我的歌单**：Web 端支持官方分类浏览，也支持读取网易云、QQ、酷狗、汽水账号下的个人歌单 / 收藏歌单。 * **新增 Cookie 扫码登录**：设置面板支持网易云、QQ、酷狗、Bilibili 扫码登录，成功后自动保存 Cookie；汽水音乐新版扫码登录因动态 `a_bogus` / `msToken` 风控签名暂未调通，入口已临时隐藏。 * **新增本地音乐功能**：Web 端支持读取本地下载目录、上传音频、自动补全元信息、读取同名封面/歌词，并可添加到自制歌单。 * **本地音乐性能优化**：本地音乐列表支持分页加载、扫描快照与元数据缓存，过期后后台异步刷新不阻塞请求；上传 / 删除会自动作废缓存，Android 端修复了 `READ_MEDIA_AUDIO` 权限申请以读取 `/sdcard/Music`。 * **Android APK 内置 FFmpeg / ffprobe**：GitHub Actions 打包 Android APK 时会下载 4 个 ABI 的 `ffmpeg` / `ffprobe` 并注入 APK，App 启动时自动配置内置二进制路径。 * **本地音乐封面修复**：本地音乐列表扫描会读取音频内嵌封面并返回 `/local_music/cover` 地址，修复只有同名图片封面可显示、内嵌封面在列表里为空的问题。 * **Web 自动换源优化**：系统设置新增“自动选择无效音源并批量换源”开关，默认开启；音乐列表检测到无效音源后会自动选中并批量换源，已换源歌曲会取消选中，避免重复换源。 * **逐字歌词增强**：Web 首页、歌曲详情页与视频渲染统一支持网易云 / QQ 音乐 / 酷狗的原文、译文、罗马音逐字歌词；其他渠道继续使用原文逐行歌词。 * Web 试听按钮支持播放/停止切换，底部增加全局播放与音量控制栏。 * Web 单曲支持“换源”，按相似度优先、时长接近、可播放验证。 * 换源自动排除 soda 与 fivesing。 * Web 设置可开启/关闭“自动选择无效音源并批量换源”；默认开启，检测出无效音源后只自动处理当前无效项一次，换源成功后不会继续保留选中。 * TUI 增加 r 键批量换源，并显示换源进度。 * 增加“每日歌单推荐”，Web 和 TUI 都能看。 * 同步 `music-lib` 歌单 / 专辑渠道函数，补齐咪咕、Jamendo、JOOX、千千等歌单搜索、详情和链接解析映射。 * Web 端支持批量操作：全选、选择无效、批量下载、批量换源。 ## 快速开始 ### 桌面应用模式 桌面应用提供了原生窗口体验，无需打开浏览器即可使用。 #### 特性 * ️ 原生桌面窗口，无需浏览器 * 自动启动内置Web服务器 * 完整Web界面功能 * 单文件分发，绿色免安装 * ️ 自定义窗口图标 * 使用罕见端口(37777)，避免端口冲突 ### Docker 部署 本项目提供了多种 Docker 部署方式。当前默认通过 `./data` 目录挂载到容器内 `/home/appuser/data`，下载文件、配置与收藏数据都会持久化到该目录。 *注意：首次运行前必须先创建 `data` 目录（如 `mkdir -p data && chmod 777 data`），便于宿主机直接访问下载与配置数据。* #### 1. 生产环境部署（推荐） 项目包含 `docker-compose.yml` 文件，直接拉取云端预编译镜像，无需在本地构建： ```bash # 拉取最新镜像 docker compose pull # 后台启动服务 docker compose up -d --remove-orphans # 或一条命令拉取并启动 docker compose up -d --pull always --remove-orphans # 查看日志 docker compose logs -f # 停止服务 docker compose down ``` 浏览器访问 `http://localhost:8080`。 **说明：** * 自动拉取 `guohuiyuan/go-music-dl:latest` 镜像 * 支持后台运行和自动重启 * 默认使用 `./data` 本地目录做数据持久化，便于直接查看和备份 * 设置时区为亚洲上海 * 以非root用户(uid=1000)运行，提高安全性 #### 2. 开发环境部署（本地构建） 如果您修改了源码，希望在本地通过 Docker 重新构建并测试效果，请使用 `docker-compose.dev.yml`： ```bash # 强制在本地使用 Dockerfile 进行构建并启动 docker compose -f docker-compose.dev.yml up -d --build --remove-orphans ``` #### 3. 纯命令行模式 (docker run) 如果不使用 Compose，也可以直接通过命令行运行： ```bash docker run -d --name music-dl \ -p 8080:8080 \ -v $(pwd)/data:/home/appuser/data \ -e TZ=Asia/Shanghai \ --user 1000:1000 \ --restart unless-stopped \ guohuiyuan/go-music-dl:latest \ ./music-dl web --port 8080 --no-browser # Windows PowerShell docker run -d --name music-dl -p 8080:8080 -v ${PWD}/data:/home/appuser/data -e TZ=Asia/Shanghai --user 1000:1000 --restart unless-stopped guohuiyuan/go-music-dl:latest ./music-dl web --port 8080 --no-browser ``` 视频生成相关的“更换封面 / 更换音频 / 更换歌词 / 导出视频”按钮已迁移到 Web 设置中管理，默认关闭，可在网页右上角设置面板中开启。 ### CLI/TUI 模式 ```bash # 搜索 ./music-dl -k "周杰伦" ``` TUI 常用按键： * `↑/↓` 移动 * `空格` 选择 * `a` 全选/清空 * `r` 对勾选项换源 * `Enter` 下载 * `b` 返回 * `w` 每日推荐歌单 * `q` 退出 更多用法： ```bash # 查看帮助 ./music-dl -h # 指定搜索源 ./music-dl -k "周杰伦 晴天" -s qq,netease # 指定下载目录 ./music-dl -k "周杰伦" -o ./my_music # 下载时包含封面和歌词 ./music-dl -k "周杰伦" --cover --lyrics ``` ## GitHub Actions 自动构建 本项目已配置 GitHub Actions 工作流。当推送代码并打上版本标签（如 `v1.0.0`）时，会自动触发 `.github/workflows/docker.yml`，构建跨平台镜像（支持 amd64 和 arm64）并推送到 DockerHub。 ### Android APK 构建 项目支持通过 Gio 打包 Android APK，输出文件为仓库根目录下的三个 APK： * `music-dl_arm64-v8a.apk`（推荐，大多数 Android 设备） * `music-dl_x86_64.apk`（x86_64 设备/模拟器） * `music-dl.apk`（无分片兼容包，极个别设备无法使用分片包时再下载） 安装 Android APK 后，建议在 Web 右上角“设置”中把“本地下载目录”改为 `/sdcard/Music`，这样下载文件会直接进入系统音乐目录。 #### 1. 本地构建 APK（Windows） 前置条件： * Go 已安装并可用（建议 1.25+） * JDK（推荐 17） * Android SDK 已安装，默认路径 `C:\Android` * 可用的 NDK（脚本会自动尝试安装 `27.0.12077973`） 执行命令：