项目简介Unlock Music 是一个开源的音乐文件解锁工具，可以在浏览器中直接解锁各大音乐平台的加密音乐文件。该项目基于 MIT 协议开源，主要用于学习和技术研究目的。
主要特性支持的加密格式Unlock Music 支持解锁以下主流音乐平台的加密文件：
QQ 音乐系列.qmc0 / .qmc2 / .qmc3 - QQ 音乐旧版加密格式.qmcflac / .qmcogg - QQ 音乐无损格式.tkm - QQ 音乐特殊格式.tm0 / .tm2 / .tm3 / .tm6 - QQ 音乐 Tm 格式.mflac / .mgg / .mflac0 / .mgg1 / .mggl - QQ 音乐新格式.bkcmp3 / .bkcflac - Moo 音乐格式.ofl_en - QQ 音乐海外版 JOOX Music 其他平台.ncm - 网易云音乐.xm - 虾米音乐.kwm - 酷我音乐.kgm / .vpr - 酷狗音乐.x2m / .x3m - 喜马拉雅（Android）.mg3d - 咪咕音乐核心功能✅ 纯浏览器端解锁 - 所有处理在本地完成，无需上传文件 ✅ 拖放操作 - 支持直接拖拽文件到页面 ✅ 批量处理 - 一次性解锁多个文件 ✅ 多线程加速 - 利用 Web Worker 提升处理速度 ✅ 元信息编辑 - 支持写入和编辑歌曲标题、艺术家、专辑等信息 ✅ 专辑封面 - 自动获取或手动添加专辑封面 ✅ PWA 支持 - 可作为渐进式 Web 应用离线使用 ✅ 多种命名方式 - 支持多种文件命名格式（艺术家-歌曲名、歌曲名-艺术家等）
快速开始方法一：在线使用（推荐）访问在线版本：unlock-music 或官方站点无需安装，直接使用方法二：下载本地使用步骤 1：下载预构建版本从以下渠道获取最新版本：
GitHub ReleasesCI 自动构建 - 可在 UM-Packages 下载⚠️ 重要提示：本地使用请下载 legacy 版本（modern 版本只能通过 HTTP(S) 协议访问）
步骤 2：解压并运行下载后解压 ZIP 文件找到 index.html 文件双击打开即可使用（或通过本地 Web 服务器运行） 注意：请勿直接运行源代码，必须先构建
详细使用教程基础操作1. 上传文件有两种方式上传加密文件：
方式 A：拖拽上传
直接将加密的音乐文件拖拽到页面中央的上传区域支持一次拖拽多个文件方式 B：点击选择
点击上传区域的"点击选择"按钮在弹出的文件选择器中选择文件2. 等待解锁文件上传后会自动开始解锁页面底部会显示进度条：已完成数 / 总数解锁成功会显示通知提示3. 查看结果解锁完成后，在页面下方的表格中可以看到：
列名说明封面专辑封面图片歌曲歌曲标题歌手艺术家名称专辑专辑名称操作播放、下载、编辑、删除按钮4. 下载文件单个下载：点击表格中对应歌曲的 下载按钮
批量下载：点击页面顶部的"下载全部"按钮
高级功能 编辑元信息如果自动识别的信息不准确，可以手动编辑：
点击歌曲行的 ✏️ 编辑按钮在弹出的对话框中可以修改：
歌曲标题艺术家专辑名称专辑艺术家风格/类型专辑封面（支持上传自定义图片）点击"确定"保存修改 文件命名设置在页面顶部可以选择下载文件的命名格式：
歌手-歌曲名（默认）：周杰伦 - 稻香.mp3歌曲名：稻香.mp3歌曲名-歌手：稻香 - 周杰伦.mp3同源文件名：保持原始文件名 立即保存模式对于大批量文件解锁：
勾选"立即保存"选项解锁后的文件会立即下载，不在浏览器中保留可以防止处理大量文件时内存不足⚙️ 解密设定某些格式需要额外配置：
点击"解密设定"按钮根据需要填写相关参数（如 JOOX UUID）保存设置后再进行解锁 播放功能点击歌曲行的 ▶️ 播放按钮可以直接在浏览器中试听解锁后的音乐。
️ 管理文件删除单个：点击歌曲行的 ️ 删除按钮清除全部：点击页面顶部的"清除全部"按钮 自行构建环境要求JavaScript 部分Node.js v16.x 或更高版本npm 包管理器WASM 部分（可选）Linux 操作系统Python 3构建步骤1. 克隆仓库
git clone https://github.com/ipid/unlock-music.git
cd unlock-music
2. 安装依赖
npm ci
3. 构建项目开发模式（带热重载）：
npm run serve
生产构建：
npm run build
构建完成后，产物位于 dist 目录。
4. 构建浏览器扩展（可选）
npm run make-extension
5. 构建 WASM 模块（可选）
./scripts/build-wasm.sh
⚠️ 注意事项安全与隐私本地处理：所有解锁操作均在浏览器本地完成，不会上传文件到服务器网络请求：仅在获取专辑封面和歌曲信息时需要联网文件安全：建议在 HTTPS 环境下使用以获得最佳安全性使用建议大批量转换：建议使用 CLI 版本浏览器兼容性：推荐使用现代浏览器（Chrome、Edge、Firefox）HTTPS 环境：在 HTTPS 下可启用 Web Worker 多线程加速文件格式：确保上传的是支持的加密格式法律声明本工具仅用于学习和技术研究目的请确保您对音乐文件拥有合法使用权请勿用于商业用途或侵犯版权修改和再分发时请遵循 MIT 许可协议故障排除常见问题Q: 解锁失败怎么办？
A:
确认文件格式是否在支持列表中检查文件是否损坏某些格式（如 JOOX）需要在"解密设定"中配置参数查看浏览器控制台是否有错误信息Q: 为什么没有专辑封面？
A:
自动获取封面需要联网可以手动编辑添加自定义封面图片部分歌曲可能没有可用的封面信息Q: 批量处理速度慢？
A:
在 HTTPS 环境下使用可启用多线程加速使用"立即保存"模式避免内存占用大批量建议使用 CLI 版本Q: 下载的文件在哪里？
A: 文件会下载到浏览器默认下载目录，可在浏览器设置中查看和修改。