QMCDecode深度解析QMC格式转换的完整解码架构指南【免费下载链接】QMCDecodeQQ音乐QMC格式转换为普通格式(qmcflac转flacqmc0,qmc3转mp3, mflac,mflac0等转flac)仅支持macOS可自动识别到QQ音乐下载目录默认转换结果存储到~/Music/QMCConvertOutput,可自定义需要转换的文件和输出路径项目地址: https://gitcode.com/gh_mirrors/qm/QMCDecode某天你从QQ音乐客户端下载了一首歌却在文件夹里看到一个陌生的.qmcflac文件双击无法播放任何播放器都不认识它它就像被锁在了QQ音乐生态里。QMCDecode 正是为解决这一痛点而生的 macOS 端 QMC 格式转换工具它能把 qmcflac 转 flac、qmc0/qmc3 转 mp3、mflac/mflac0 转 flac 等十余种加密格式还原为普通音频面向有开发基础但不熟悉解密原理的技术人员和普通音乐用户本文将从架构设计到源码细节带你完整拆解这套解码引擎。一、为什么需要 QMC 格式转换先理解加密缓存这回事QQ音乐下载的本地歌曲通常以 QMC 家族扩展名存储qmcflac、qmc0、mflac、mgg 等它们本质上是加密后的音频文件文件头被改写、字节流被异或混淆只有 QQ音乐客户端能通过内置密钥还原。这意味着你买断下载的歌曲离开客户端就不可用。QMCDecode 的价值在于它把加密文件还原成标准 FLAC/MP3/OGG让你在任何播放器、任何设备上自由播放。工具是 macOS 专属基于 Cocoa 框架的 GUI 应用核心逻辑以 Swift 编写且采用了非常工程化的分层设计——解码核心与界面完全分离这一点对后续二次开发极为友好。 一句话定位QMCDecode 是一个加密格式还原器输入带 QMC 前缀的加密文件输出普通播放器可识别的标准音频。二、三分钟跑通从下载到完成首次 QMC 格式转换体验先行。先按下面步骤把工具跑起来再去看原理。获取源码并打开工程git clone https://gitcode.com/gh_mirrors/qm/QMCDecode cd QMCDecode open QMCDecode.xcodeproj在 Xcode 中选择 macOS 目标Cmd B编译Cmd R运行。应用启动后会自动扫描 QQ音乐 mac 客户端缓存目录~/Library/Containers/com.tencent.QQMusicMac/.../iQmc/把所有加密文件列进左侧表格。右侧显示默认输出目录~/Music/QMCConvertOutput/可通过按钮自定义点击Start即可批量转换。上图即应用主界面左侧为待转换文件列表展示路径与歌曲名右侧为输出目录与开始按钮界面极简一次点击完成批量处理。✅ 预期结果转换完成后弹出成功/失败数量提示输出目录下出现同名但扩展名已替换的标准音频文件可直接双击播放。三、核心技术原理拆解三个模块讲透解密链路QMCDecode 的解码链路可以概括为三步提取密钥 → 派生密钥 → 流式解密。对应源码中QMDecoder、QMCKeyDecoder、TeaCipher与QMCipher四个核心类。3.1 协议体系三种 QMC 加密算法各司其职QMCipher是一个协议定义了统一的解密入口qmDecrypt(data:offset:)三种实现对应不同的加密强度/// 解码器协议输入原始数据与起始偏移量返回解密后的数据 public protocol QMCipher { func qmDecrypt(data: Data, offset: Int) - Data init(originKey: [UInt8]) throws }算法实现典型格式解密方式复杂度QMStaticCipherqmc0 / qmc3 / bkcmp3固定密钥查表异或最低QMMapCipherqmcflac / qmflac / qmcogg密钥查表 循环移位中等QMRC4Ciphermflac / mflac0 / mggRC4 变体流密码 分段密钥最高以最直观的QMStaticCipher为例解密本质就是用密钥字节逐个异或但偏移量被映射到一个数学表达式上避免简单的固定异或/// 根据全局偏移量计算掩码字节先对 0x7FFF 取模防止越界再平方加 27 取低 8 位 public func getMask(offset: Int) - UInt8 { let temp offset 0x7FFF ? (offset % 0x7FFF) : offset let index (temp * temp 27) 0xFF return key[index] }QMMapCipher在此基础上多了一步循环移位rotateQMRC4Cipher则把文件切成首段 128 字节 每 5120 字节一段的分片结构每段用基于哈希的getSegmentKey派生独立子密钥安全级别最高。3.2 密钥机制TEA 算法派生出真正的解密密钥加密文件末尾藏着一段 Base64 编码的原始密钥但它不能直接用必须先经QMCKeyDecoder.deriveKey还原/// 由种子 106 生成 8 字节的 simpleKey再与 Base64 解码后的前 8 字节交错组成 16 字节 TEA 密钥 let simpleKey simpleMakeKey(seed: 106, length: 8) var teaKey UInt8 for index in 0..8 { teaKey[index 1] simpleKey[index] // 偶数位放 simpleKey teaKey[(index 1) 1] base64DecodedKey[index] // 奇数位放原始密钥前 8 字节 } // 用 TEA 密钥解密剩余数据CBC 模式再拼接回前 8 字节得到最终解密 key let subBuffer try decryptTencentTea(inBuffer: inBuffer, key: teaKey) let newKey base64DecodedKey[0...7] subBuffer其中simpleMakeKey用tan三角函数的浮点结果取整生成伪随机字节而decryptTencentTea内部调用TeaCipher32 轮 TEA 分组密码8 字节块、16 字节密钥完成 CBC 链式解密并严格校验 salt 长度与补零位任何一步不符都会抛出zeroCheckFailed等错误。3.3 主解码器密钥定位策略随客户端版本自适应QMDecoder是编排者它的searchKey()负责从文件尾部挖出原始密钥关键逻辑是根据文件末尾 4 字节的标识判断文件来源// 移动端下载的文件以 QTag 文本结尾 if String(bytes: lastFourBytes, encoding: .utf8) QTag { // 读 4 字节大端长度 → 计算真实音频大小 文件总长 - key长度 - 8 // 在真实音频结束位置读 key用逗号ASCII 44定位 key 的结束位置 } else { // PC/macOS 端末 4 字节是小端 key 长度 if keySize 0x300 { // 正常情况按长度读 key } else { // 老版本固定密钥直接用内置 privateKey256 构造 QMStaticCipher } }拿到派生 key 后setCipher根据 key 长度决定算法key 长度大于 300 用 RC4否则用映射加密这与不同版本 QQ音乐 的加密策略一一对应实现了对两代加密方案的兼容。四、实战场景演示完整跑通一次 qmcflac → flac 转换假设你有一个周杰伦-晴天.qmcflac约 35MB端到端过程如下第 1 步准备输入把文件放到任意目录或直接使用应用自动识别到的 QQ音乐 缓存目录。第 2 步启动转换运行应用在左侧确认周杰伦-晴天.qmcflac出现在列表点击Start。第 3 步内部执行链路与点击按钮等价的代码路径// 核心调用QMDecoder 负责完整解码一行即可驱动整个链路 let decoder try QMDecoder(originFilePath: inputPath, // 读取文件并自动 searchKey() outputDirectory: outputDir) try decoder.decryptAndWriteToFile() // 解密并原子写入输出文件第 4 步预期结果输出路径~/Music/QMCConvertOutput/周杰伦-晴天.flac应用弹出提示转换完成 成功: 1, 失败: 0file命令验证输出为真实 FLACfile 周杰伦-晴天.flac应显示FLAC audio bitstream data播放器可正常打开。⚠️ 提示由于解密只作用于真实音频区realAudioSize加密头与尾部 key 均被正确剥离输出文件大小应小于原始文件属正常现象。五、性能调优与进阶玩法榨干多核 CPUViewController.startConvert中的并发模型值得借鉴它按ProcessInfo().processorCount创建等量的DispatchQueue每个文件按index % coreCount分配到对应队列最大程度并行解码。相关参数可参考下表参数默认值建议值影响说明并发队列数CPU 物理核心数2~8视机型队列数核心数可吃满 CPU弱机型可下调避免风扇狂转输出目录~/Music/QMCConvertOutputSSD 目录写入速度直接影响大批量任务总耗时RC4 分段大小5120 字节固定决定 RC4 子密钥切换频率影响单文件吞吐缓冲区读取一次性读入真实音频区—内存占用随文件大小线性增长超大文件建议后续改造流式进阶玩法建议解码核心QMDecoder与 UI 完全解耦可直接在命令行工具或脚本中复用想支持新格式只需在Constants.swift的encryptExtDictionary注册扩展名→输出格式映射若需处理超大文件可将decryptAndWriteToFile的一次性读取改为InputStream分块读取降低内存峰值。六、常见问题与避坑指南6.1 转换后文件无法播放现象输出文件损坏或格式识别失败。排查① 确认原始文件完整大小与下载时一致② 检查扩展名是否在支持列表内见下方格式表③ 用hexdump查看输出文件头是否以 FLAC/ID3 标准魔数开头。解决重新下载原文件后重试确认 QQ音乐客户端版本与工具兼容。6.2 转出的 flac/mp3 没有歌曲标题和封面现象文件能播放但标签tag为空。原因部分来源文件的音频元数据本身缺失解码器只做字节还原不补全标签。解决使用 kid3 批量编辑标签选择输出目录 → 批量设置标题/艺术家/专辑 → 保存。6.3 批量转换时 CPU 占用过高、界面卡顿现象同时转换几十个文件时风扇狂转。原因应用按核心数队列数的设计主动跑满 CPU。解决减少单批文件数量分批执行或将输出目录放到 SSD 上减少 IO 等待如需长期后台批量处理可自行改造为qos更低的后台队列。6.4 支持的格式清单速查输入格式输出格式加密算法.qmcflac / .qmflac / .bkcflac.flac映射/静态加密.qmc0 / .qmc3 / .bkcmp3 / .tkm.mp3 / .m4a静态加密.qmc2 / .qmcogg / .mgg / .mgg1.oggRC4/映射加密.mflac / .mflac0 / .666c6163.flacRC4/静态加密.6d7033 / .6f6767 / .6d3461 / .776176对应标准格式静态加密七、总结与生态展望QMCDecode 用约 200 行核心逻辑就完成了密钥提取 → TEA 派生 → 分算法解密的完整链路架构上协议化、职责单一、UI 与核心分离是学习 Swift 加密工程与 macOS 应用开发的优质范例。它把加密文件困在客户端的问题变成了一个按钮搞定 QMC 格式转换的顺畅体验。展望未来值得探索的方向包括将QMDecoder封装为可复用的命令行工具qmdecode input形式增加流式分块读取以支撑超大文件与内存可控扩展更多格式与元数据自动修复以及将并发模型从 GCD 升级为 Swift Concurrency 的TaskGroup。核心解码器已在QMCDecode/目录下完全开源二次开发者可直接从QMDecoder.swift与QMCipher.swift入手欢迎 fork 后按自己的场景扩展格式映射表动手把这份能力用起来。【免费下载链接】QMCDecodeQQ音乐QMC格式转换为普通格式(qmcflac转flacqmc0,qmc3转mp3, mflac,mflac0等转flac)仅支持macOS可自动识别到QQ音乐下载目录默认转换结果存储到~/Music/QMCConvertOutput,可自定义需要转换的文件和输出路径项目地址: https://gitcode.com/gh_mirrors/qm/QMCDecode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 QMCDecode深度解析：QMC格式转换的完整解码架构指南
QMCDecode深度解析QMC格式转换的完整解码架构指南【免费下载链接】QMCDecodeQQ音乐QMC格式转换为普通格式(qmcflac转flacqmc0,qmc3转mp3, mflac,mflac0等转flac)仅支持macOS可自动识别到QQ音乐下载目录默认转换结果存储到~/Music/QMCConvertOutput,可自定义需要转换的文件和输出路径项目地址: https://gitcode.com/gh_mirrors/qm/QMCDecode某天你从QQ音乐客户端下载了一首歌却在文件夹里看到一个陌生的.qmcflac文件双击无法播放任何播放器都不认识它它就像被锁在了QQ音乐生态里。QMCDecode 正是为解决这一痛点而生的 macOS 端 QMC 格式转换工具它能把 qmcflac 转 flac、qmc0/qmc3 转 mp3、mflac/mflac0 转 flac 等十余种加密格式还原为普通音频面向有开发基础但不熟悉解密原理的技术人员和普通音乐用户本文将从架构设计到源码细节带你完整拆解这套解码引擎。一、为什么需要 QMC 格式转换先理解加密缓存这回事QQ音乐下载的本地歌曲通常以 QMC 家族扩展名存储qmcflac、qmc0、mflac、mgg 等它们本质上是加密后的音频文件文件头被改写、字节流被异或混淆只有 QQ音乐客户端能通过内置密钥还原。这意味着你买断下载的歌曲离开客户端就不可用。QMCDecode 的价值在于它把加密文件还原成标准 FLAC/MP3/OGG让你在任何播放器、任何设备上自由播放。工具是 macOS 专属基于 Cocoa 框架的 GUI 应用核心逻辑以 Swift 编写且采用了非常工程化的分层设计——解码核心与界面完全分离这一点对后续二次开发极为友好。 一句话定位QMCDecode 是一个加密格式还原器输入带 QMC 前缀的加密文件输出普通播放器可识别的标准音频。二、三分钟跑通从下载到完成首次 QMC 格式转换体验先行。先按下面步骤把工具跑起来再去看原理。获取源码并打开工程git clone https://gitcode.com/gh_mirrors/qm/QMCDecode cd QMCDecode open QMCDecode.xcodeproj在 Xcode 中选择 macOS 目标Cmd B编译Cmd R运行。应用启动后会自动扫描 QQ音乐 mac 客户端缓存目录~/Library/Containers/com.tencent.QQMusicMac/.../iQmc/把所有加密文件列进左侧表格。右侧显示默认输出目录~/Music/QMCConvertOutput/可通过按钮自定义点击Start即可批量转换。上图即应用主界面左侧为待转换文件列表展示路径与歌曲名右侧为输出目录与开始按钮界面极简一次点击完成批量处理。✅ 预期结果转换完成后弹出成功/失败数量提示输出目录下出现同名但扩展名已替换的标准音频文件可直接双击播放。三、核心技术原理拆解三个模块讲透解密链路QMCDecode 的解码链路可以概括为三步提取密钥 → 派生密钥 → 流式解密。对应源码中QMDecoder、QMCKeyDecoder、TeaCipher与QMCipher四个核心类。3.1 协议体系三种 QMC 加密算法各司其职QMCipher是一个协议定义了统一的解密入口qmDecrypt(data:offset:)三种实现对应不同的加密强度/// 解码器协议输入原始数据与起始偏移量返回解密后的数据 public protocol QMCipher { func qmDecrypt(data: Data, offset: Int) - Data init(originKey: [UInt8]) throws }算法实现典型格式解密方式复杂度QMStaticCipherqmc0 / qmc3 / bkcmp3固定密钥查表异或最低QMMapCipherqmcflac / qmflac / qmcogg密钥查表 循环移位中等QMRC4Ciphermflac / mflac0 / mggRC4 变体流密码 分段密钥最高以最直观的QMStaticCipher为例解密本质就是用密钥字节逐个异或但偏移量被映射到一个数学表达式上避免简单的固定异或/// 根据全局偏移量计算掩码字节先对 0x7FFF 取模防止越界再平方加 27 取低 8 位 public func getMask(offset: Int) - UInt8 { let temp offset 0x7FFF ? (offset % 0x7FFF) : offset let index (temp * temp 27) 0xFF return key[index] }QMMapCipher在此基础上多了一步循环移位rotateQMRC4Cipher则把文件切成首段 128 字节 每 5120 字节一段的分片结构每段用基于哈希的getSegmentKey派生独立子密钥安全级别最高。3.2 密钥机制TEA 算法派生出真正的解密密钥加密文件末尾藏着一段 Base64 编码的原始密钥但它不能直接用必须先经QMCKeyDecoder.deriveKey还原/// 由种子 106 生成 8 字节的 simpleKey再与 Base64 解码后的前 8 字节交错组成 16 字节 TEA 密钥 let simpleKey simpleMakeKey(seed: 106, length: 8) var teaKey UInt8 for index in 0..8 { teaKey[index 1] simpleKey[index] // 偶数位放 simpleKey teaKey[(index 1) 1] base64DecodedKey[index] // 奇数位放原始密钥前 8 字节 } // 用 TEA 密钥解密剩余数据CBC 模式再拼接回前 8 字节得到最终解密 key let subBuffer try decryptTencentTea(inBuffer: inBuffer, key: teaKey) let newKey base64DecodedKey[0...7] subBuffer其中simpleMakeKey用tan三角函数的浮点结果取整生成伪随机字节而decryptTencentTea内部调用TeaCipher32 轮 TEA 分组密码8 字节块、16 字节密钥完成 CBC 链式解密并严格校验 salt 长度与补零位任何一步不符都会抛出zeroCheckFailed等错误。3.3 主解码器密钥定位策略随客户端版本自适应QMDecoder是编排者它的searchKey()负责从文件尾部挖出原始密钥关键逻辑是根据文件末尾 4 字节的标识判断文件来源// 移动端下载的文件以 QTag 文本结尾 if String(bytes: lastFourBytes, encoding: .utf8) QTag { // 读 4 字节大端长度 → 计算真实音频大小 文件总长 - key长度 - 8 // 在真实音频结束位置读 key用逗号ASCII 44定位 key 的结束位置 } else { // PC/macOS 端末 4 字节是小端 key 长度 if keySize 0x300 { // 正常情况按长度读 key } else { // 老版本固定密钥直接用内置 privateKey256 构造 QMStaticCipher } }拿到派生 key 后setCipher根据 key 长度决定算法key 长度大于 300 用 RC4否则用映射加密这与不同版本 QQ音乐 的加密策略一一对应实现了对两代加密方案的兼容。四、实战场景演示完整跑通一次 qmcflac → flac 转换假设你有一个周杰伦-晴天.qmcflac约 35MB端到端过程如下第 1 步准备输入把文件放到任意目录或直接使用应用自动识别到的 QQ音乐 缓存目录。第 2 步启动转换运行应用在左侧确认周杰伦-晴天.qmcflac出现在列表点击Start。第 3 步内部执行链路与点击按钮等价的代码路径// 核心调用QMDecoder 负责完整解码一行即可驱动整个链路 let decoder try QMDecoder(originFilePath: inputPath, // 读取文件并自动 searchKey() outputDirectory: outputDir) try decoder.decryptAndWriteToFile() // 解密并原子写入输出文件第 4 步预期结果输出路径~/Music/QMCConvertOutput/周杰伦-晴天.flac应用弹出提示转换完成 成功: 1, 失败: 0file命令验证输出为真实 FLACfile 周杰伦-晴天.flac应显示FLAC audio bitstream data播放器可正常打开。⚠️ 提示由于解密只作用于真实音频区realAudioSize加密头与尾部 key 均被正确剥离输出文件大小应小于原始文件属正常现象。五、性能调优与进阶玩法榨干多核 CPUViewController.startConvert中的并发模型值得借鉴它按ProcessInfo().processorCount创建等量的DispatchQueue每个文件按index % coreCount分配到对应队列最大程度并行解码。相关参数可参考下表参数默认值建议值影响说明并发队列数CPU 物理核心数2~8视机型队列数核心数可吃满 CPU弱机型可下调避免风扇狂转输出目录~/Music/QMCConvertOutputSSD 目录写入速度直接影响大批量任务总耗时RC4 分段大小5120 字节固定决定 RC4 子密钥切换频率影响单文件吞吐缓冲区读取一次性读入真实音频区—内存占用随文件大小线性增长超大文件建议后续改造流式进阶玩法建议解码核心QMDecoder与 UI 完全解耦可直接在命令行工具或脚本中复用想支持新格式只需在Constants.swift的encryptExtDictionary注册扩展名→输出格式映射若需处理超大文件可将decryptAndWriteToFile的一次性读取改为InputStream分块读取降低内存峰值。六、常见问题与避坑指南6.1 转换后文件无法播放现象输出文件损坏或格式识别失败。排查① 确认原始文件完整大小与下载时一致② 检查扩展名是否在支持列表内见下方格式表③ 用hexdump查看输出文件头是否以 FLAC/ID3 标准魔数开头。解决重新下载原文件后重试确认 QQ音乐客户端版本与工具兼容。6.2 转出的 flac/mp3 没有歌曲标题和封面现象文件能播放但标签tag为空。原因部分来源文件的音频元数据本身缺失解码器只做字节还原不补全标签。解决使用 kid3 批量编辑标签选择输出目录 → 批量设置标题/艺术家/专辑 → 保存。6.3 批量转换时 CPU 占用过高、界面卡顿现象同时转换几十个文件时风扇狂转。原因应用按核心数队列数的设计主动跑满 CPU。解决减少单批文件数量分批执行或将输出目录放到 SSD 上减少 IO 等待如需长期后台批量处理可自行改造为qos更低的后台队列。6.4 支持的格式清单速查输入格式输出格式加密算法.qmcflac / .qmflac / .bkcflac.flac映射/静态加密.qmc0 / .qmc3 / .bkcmp3 / .tkm.mp3 / .m4a静态加密.qmc2 / .qmcogg / .mgg / .mgg1.oggRC4/映射加密.mflac / .mflac0 / .666c6163.flacRC4/静态加密.6d7033 / .6f6767 / .6d3461 / .776176对应标准格式静态加密七、总结与生态展望QMCDecode 用约 200 行核心逻辑就完成了密钥提取 → TEA 派生 → 分算法解密的完整链路架构上协议化、职责单一、UI 与核心分离是学习 Swift 加密工程与 macOS 应用开发的优质范例。它把加密文件困在客户端的问题变成了一个按钮搞定 QMC 格式转换的顺畅体验。展望未来值得探索的方向包括将QMDecoder封装为可复用的命令行工具qmdecode input形式增加流式分块读取以支撑超大文件与内存可控扩展更多格式与元数据自动修复以及将并发模型从 GCD 升级为 Swift Concurrency 的TaskGroup。核心解码器已在QMCDecode/目录下完全开源二次开发者可直接从QMDecoder.swift与QMCipher.swift入手欢迎 fork 后按自己的场景扩展格式映射表动手把这份能力用起来。【免费下载链接】QMCDecodeQQ音乐QMC格式转换为普通格式(qmcflac转flacqmc0,qmc3转mp3, mflac,mflac0等转flac)仅支持macOS可自动识别到QQ音乐下载目录默认转换结果存储到~/Music/QMCConvertOutput,可自定义需要转换的文件和输出路径项目地址: https://gitcode.com/gh_mirrors/qm/QMCDecode创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考