答疑目录

• QQ 音乐
• 酷我音乐
• 酷狗音乐
• 其它问题

QQ 音乐

解锁失败

重复下载同一首的歌曲不重复扣下载配额，但是同一首歌的两个版本会重复扣下载配额，请仔细分辨。

部分平台获取的加密文件未包含密钥。选择你下载文件时使用的客户端来查看说明。

酷我音乐

解锁失败

• 尝试用下载音乐的设备播放一次看看，如果官方客户端都无法播放，那解锁肯定会失败哦。

• 日前，仅手机客户端下载的「至臻全景声」及「至臻母带」音质的音乐文件采用新版加密。

  其他音质目前不需要提取密钥。

  PC平台暂未推出使用新版加密的音质。

  安卓用户提取密钥需要 root 权限，或注入文件提供器。

  注意：已知部分第三方修改版会破坏密钥写入功能，导致无法提取密钥。

  注意：项目组不提倡使用、也不提供第三方修改版。使用前请自行评估风险。

  导入密钥可以参考下面的步骤：

  1. 点击顶部的「设置」
  2. 设定区域选择「KWMv2 密钥」
  3. 按下「添加一条密钥」按钮右侧的
  4. 选择 「 从文件导入密钥…」

  5. 选择你的客户端平台来查看密钥提取说明：

     安卓iOSWindows

     你需要超级管理员 (root)访问权限来访问安卓应用的私有数据。

     ⚠️ 请注意，获取管理员权限通常意味着你的安卓设备将失去保修资格。

     在安卓手机端操作

     1. 启动具有 root 特权的文件浏览器

     2. 访问 /data/data/cn.kuwo.player/files/mmkv/ 目录。

     3. 将文件 cn.kuwo.player.mmkv.defaultconfig 复制到浏览器可访问的目录。
        （例如下载目录）

     4. 提交该数据库文件。

     在 PC 端操作（ADB / PowerShell）

     1. 确保 adb 命令可用。

        💡 如果没有，可以使用 Scoop 安装 。

     2. 启动终端并进入 PowerShell 7 环境。

     3. 将安卓设备连接到电脑，并允许调试。

     4. 粘贴执行下述代码。若设备提示「超级用户请求」请允许：

        try {
          $gz_b64 = adb shell su -c "cat '/data/data/cn.kuwo.player/files/mmkv/cn.kuwo.player.mmkv.defaultconfig' | gzip | base64" | Out-String
          $bStream = New-Object System.IO.MemoryStream(,[System.Convert]::FromBase64String($gz_b64))
          $decoded = New-Object System.IO.Compression.GzipStream($bStream, [System.IO.Compression.CompressionMode]::Decompress)
          $outFile = New-Object System.IO.FileStream("${PWD}\cn.kuwo.player.mmkv.defaultconfig", [System.IO.FileMode]::Create, [System.IO.FileAccess]::Write)
          $decoded.CopyTo($outFile)
        } catch {
          Write-Host "遇到错误:"
          Write-Host $_
        } finally {
          if ($outFile -ne $null) { $outFile.Dispose() }
          if ($decoded -ne $null) { $decoded.Dispose() }
          if ($bStream -ne $null) { $bStream.Dispose() }
        }
        

     5. 提交当前目录下的 cn.kuwo.player.mmkv.defaultconfig 文件。

     在 Linux / Mac 系统下操作（ADB / Shell）

     1. 确保 adb 命令可用。

     2. 将安卓设备连接到电脑，并允许调试。

     3. 粘贴执行下述代码。若设备提示「超级用户请求」请允许：

        adb shell su -c "cat '/data/data/cn.kuwo.player/files/mmkv/cn.kuwo.player.mmkv.defaultconfig' | gzip | base64" \
            | base64 -d | gzip -d >'cn.kuwo.player.mmkv.defaultconfig'
        

     4. 提交当前目录下的 cn.kuwo.player.mmkv.defaultconfig 文件。

酷狗音乐

解锁失败

• 酷狗现在对部分用户推送了 kgg 加密格式（安卓、Windows 客户端）。

  根据平台不同，你需要提取密钥数据库。

  安卓用户提取密钥需要 root 权限，或注入文件提供器。

  导入密钥可以参考下面的步骤：

  1. 点击顶部的「设置」
  2. 设定区域选择「酷狗密钥」
  3. 按下「添加一条密钥」按钮右侧的
  4. 选择 「 从文件导入密钥…」

  5. 选择你的客户端平台来查看密钥提取说明：

     安卓Windows

     你需要超级管理员 (root)访问权限来访问安卓应用的私有数据。

     ⚠️ 请注意，获取管理员权限通常意味着你的安卓设备将失去保修资格。

     在安卓手机端操作

     1. 启动具有 root 特权的文件浏览器

     2. 访问 /data/data/com.kugou.android/files/mmkv/ 目录。

     3. 将文件 mggkey_multi_process 复制到浏览器可访问的目录。
        （例如下载目录）

     4. 提交该数据库文件。

     在 PC 端操作（ADB / PowerShell）

     1. 确保 adb 命令可用。

        💡 如果没有，可以使用 Scoop 安装 。

     2. 启动终端并进入 PowerShell 7 环境。

     3. 将安卓设备连接到电脑，并允许调试。

     4. 粘贴执行下述代码。若设备提示「超级用户请求」请允许：

        try {
          $gz_b64 = adb shell su -c "cat '/data/data/com.kugou.android/files/mmkv/mggkey_multi_process' | gzip | base64" | Out-String
          $bStream = New-Object System.IO.MemoryStream(,[System.Convert]::FromBase64String($gz_b64))
          $decoded = New-Object System.IO.Compression.GzipStream($bStream, [System.IO.Compression.CompressionMode]::Decompress)
          $outFile = New-Object System.IO.FileStream("${PWD}\mggkey_multi_process", [System.IO.FileMode]::Create, [System.IO.FileAccess]::Write)
          $decoded.CopyTo($outFile)
        } catch {
          Write-Host "遇到错误:"
          Write-Host $_
        } finally {
          if ($outFile -ne $null) { $outFile.Dispose() }
          if ($decoded -ne $null) { $decoded.Dispose() }
          if ($bStream -ne $null) { $bStream.Dispose() }
        }
        

     5. 提交当前目录下的 mggkey_multi_process 文件。

     在 Linux / Mac 系统下操作（ADB / Shell）

     1. 确保 adb 命令可用。

     2. 将安卓设备连接到电脑，并允许调试。

     3. 粘贴执行下述代码。若设备提示「超级用户请求」请允许：

        adb shell su -c "cat '/data/data/com.kugou.android/files/mmkv/mggkey_multi_process' | gzip | base64" \
            | base64 -d | gzip -d >'mggkey_multi_process'
        

     4. 提交当前目录下的 mggkey_multi_process 文件。

其它问题

解密后没有封面等信息

该项目进行解密处理。如果加密前的资源没有内嵌元信息或封面，解密的文件也没有。

请使用第三方工具进行编辑或管理元信息。

批量下载

暂时没有实现，不过你可以在 #34 - [UI] 全部下载功能 以及 #43 - 批量下载 追踪该问题。

安卓: 浏览器支持说明

⚠️ 手机端浏览器支持有限，请使用最新版本的 Chrome 或 Firefox 官方浏览器。

已知有问题的浏览器：

• Via 浏览器
• 夸克浏览器
• UC 浏览器

可能会遇到的问题包括：

• 网页白屏
• 无法下载解密后内容
• 下载的文件名错误

安卓: root 相关说明

对安卓设备获取 root 特权通常会破坏系统的完整性并导致部分功能无法使用。 例如部分厂商的安卓设备会在解锁后丧失保修资格，或导致无法使用 NFC 移动支付功能等限制。

如果希望不破坏系统完整性，你可以考虑使用模拟器。

目前常见的带有 root 特权支持的的安卓模拟器方案，分别是雷电模拟器（※ 官方版有内置广告）和微软在 Windows 11 开始支援的适用于 Android™ 的 Windows 子系统 (WSA) (Windows Subsystem for Android)。

• WSA 可以参考 MagiskOnWSALocal 的说明操作。

• 雷电模拟器可以在「模拟器设置」 → 「其他设置」中启用 root 特权。

  

相关项目

• um-react-electron：利用 Electron 框架打包的本地版，提供适用于 Windows、Linux 和 Mac 平台的可执行文件。

  • GitHub 下载

• um-react-wry: 使用 WRY 框架封装的 Win64 单文件（需要安装 Edge WebView2 运行时，Win10+ 操作系统自带）

  • 仓库下载 | 寻找文件名为 um-react-win64- 开头的附件

有更多问题？

欢迎进入 Telegram “音乐解锁-交流” 交流群 一起探讨。