一键批量解密酷狗、网易云、酷我、QQ 音乐的加密音频，转换为 MP3 / FLAC / WAV
解密和转码全部在你的电脑上完成，音频文件不会发送到网络；新版 MFLAC/MGG 每个转换批次会连接 QQ 音乐兼容端点取钥
支持把酷狗 KGG / KGM / KGMA / VPR、网易云 NCM、酷我 KWM、QQ 音乐 MFLAC / MGG 以及传统 QMC 系列转换为 MP3、FLAC、WAV 或原始音频格式。
- 顶级骨干直连 + BGP 多线中转：精选电信 CN2 GIA、联通 9929、移动 CMI 优质链路，全网智能容灾分流
- 海外专业团队运营：多节点物理冗余架构，自动化健康巡检，持久稳定不跑路
- 超值优惠套餐：100GB 流量仅需 9.9 元，超低门槛畅享企业级网络
- 全天候抗晚高峰：千兆大带宽接入，极低延迟与零丢包，4K/8K 视频与大型项目秒速拉取
- AI 与全球流媒体全解锁：原生支持 ChatGPT、Claude、Cursor、GitHub Copilot 及 Netflix、Disney+ 等全生态
- 亲民高性价比套餐：灵活流量配置，支持多端订阅（Clash / Sing-box / Karing / Surge）
👉 官网直达：https://www.freedomport.cc
| 版本 | 状态 | 使用方式 |
|---|---|---|
| v0.5.1 | 历史版本 | 解压 ZIP，使用 start.hta 或 start.bat |
| v0.6.0 | 历史稳定版 | 安装器或便携 EXE |
| v0.6.1 | 当前稳定版：新增 QQ 音乐 MFLAC/MGG | 安装器（推荐）或便携 EXE |
v0.6.0 与 v0.6.1 均保持未签名，并为每个正式 EXE 和安装器提供 SHA-256；v0.6.1 不接入 SignPath Foundation。
当前已发布稳定版本：v0.6.1
| 文件 | 平台 | 说明 |
|---|---|---|
| Kugo-Music-Converter-v0.6.1-windows-amd64-setup.exe | Windows x64 | 标准安装器，推荐大多数用户 |
| Kugo-Music-Converter-v0.6.1-windows-amd64.exe | Windows x64 | 标准便携版，使用系统 WebView2 |
| Kugo-Music-Converter-v0.6.1-windows-amd64-webview2-setup.exe | Windows x64 | 内置 WebView2 安装器，体积较大 |
| Kugo-Music-Converter-v0.6.1-windows-amd64-webview2.exe | Windows x64 | 内置 WebView2 便携版，体积较大 |
更多已发布版本请前往 GitHub Releases。
在 v0.6.0 桌面版基础上：
- 新增 QQ 音乐新版
.mflac/.mgg（musicex）解密；旧式内嵌 ekey 文件继续离线转换； - 修复混合批次隔离：KGG 数据库失败不再拖垮整批，QQ 音乐未登录或网络不可用时只影响对应文件；
- 修复“查找本机音乐”对 QQ 音乐的发现与归类：优先识别
VipSongsDownload，排除未完成缓存； - 优化大批量 KGG 解密性能，减少 MAP 计算与 RC4 临时分配；MP3 输出明确使用
libmp3lame； - 应用内更新优先从官方 GitHub Release 下载，直连失败时尝试备用转发，两条路径均强制校验 SHA-256。
v0.6.0 是从浏览器本地服务工具到桌面单 EXE 应用的重大升级。
v0.5.1：
start.hta / start.bat → 本地 HTTP 服务 → localhost:8080 → 浏览器界面
v0.6.0：
双击 Kugo-Music-Converter-v0.6.0.exe → 桌面窗口
桌面版不再需要 HTA、BAT、浏览器或本地转换端口。
- 使用 Wails v2 构建 Windows 桌面窗口；
- HTML、CSS、JavaScript 和 Go 后端编译进同一个 EXE；
- FFmpeg 压缩后嵌入 EXE；
- 首次启动自动解压并校验 SHA-256；
- 后续启动复用
%LOCALAPPDATA%中的已验证缓存； - 用户不需要安装 Go、Node.js、Wails 或 FFmpeg。
文件与队列
- 原生多文件选择、目录递归扫描、文件和文件夹拖放；
- 队列行选中、双击试听、右键上下文菜单、单项移除和全部清空；
- 键盘快捷键：
Ctrl+O选择文件、Enter开始转换、Esc取消、Delete移除选中项； - 查找本机音乐：读取酷狗自定义下载配置并检测酷狗 / 网易云 / 酷我 / QQ 音乐常见下载目录；QQ 音乐会优先扫描 Windows“音乐”已知文件夹下的
VipSongsDownload，兼容“音乐”目录重定向；结果按软件分组显示真实品牌图标，支持分组全选、整行点选、结果区折叠（不遍历全盘、不修改源文件，也不把 QQdownloadproxyNew临时缓存当成完成下载）。
原生桌面体验
- 实时进度、当前阶段、当前文件和 ETA，进度同步到 Windows 任务栏图标；
- 转换完成或失败时任务栏闪烁并发送 Windows 通知（窗口不在前台时）；
- 转换进行中关闭窗口会弹出原生退出确认；
- 单实例运行，重复启动会激活已有窗口；
- 原生取消确认，取消不删除已生成的成功文件；
- 显式自动更新：官方安装器下载 + SHA-256 配套校验；
- 应用运行时缓存统计和确认清理（仅移除旧 FFmpeg、旧内嵌 WebView2 和更新临时文件）。
界面
- 首次启动显示开源声明弹窗（免费开源、谨防第三方付费倒卖），确认后不再弹出；
- 顶栏提供 GitHub 项目入口图标；
- 宽屏/全屏时页面完全铺开填满窗口，普通窗口保持紧凑双栏，适配系统缩放与高分屏；
- 设置面板吸顶、开始转换按钮固定可见，无需滚动；
- 跟随 Windows 系统深浅色主题，也可在顶栏手动切换并记住选择；
- 完整键盘焦点、状态播报和错误提示。
转换与管理
- MP3、FLAC、WAV、Copy 输出，MP3 音质和并发数选择；
- 设置自动保存和恢复；
- KGG 数据库自动检测、手动选择和重新检测；
- 成功结果试听、定位和打开输出目录；
- 失败详情、单项重试、全部重试和 CSV 导出；
- 最近 50 次转换历史；
- 多目录高级扫描、复制名称/路径和 CSV；
- 页面诊断记录和 LOG 导出；
- 更新摘要、忽略指定版本和 GitHub Releases 跳转。
| v0.5.1 | v0.6.0 |
|---|---|
| 浏览器页面 | Wails 桌面窗口 |
| HTTP multipart 文件上传 | 本地绝对路径选择 |
| SSE 转换进度 | Wails Events |
localhost:8080 |
进程内 JavaScript ↔ Go 绑定 |
外置 tools/ffmpeg.exe |
内嵌、校验并缓存的 FFmpeg |
| 多文件发布目录 | 单个桌面 EXE |
- KGG、KGM、KGMA、VPR、NCM、KWM、MFLAC、MGG 和传统 QMC 批量解密；
- MP3、FLAC、WAV 转码；
- 保持原格式的 Copy 模式；
- 并发转换；
- 实时进度与 ETA；
- 中途取消；
- OGG CRC 容错转码；
- 转码失败时的结构化错误和降级处理；
- AAC、M4A、WMA、DFF 等原始格式检测；
- 无法识别格式时输出 HEX 头部诊断。
- 自研 QMC2 MAP / RC4 解密；
- ekey V1 / V2 与 TEA-CBC；
KGMusicV3.db内存解密；- 数据库首页完整性校验；
- 数据库解密结果按路径、大小和修改时间缓存；
- 支持
KGG_DB_MASTER_KEY环境变量覆盖 master key。
- 文件/目录拖放；
- 队列和失败恢复；
- 音频试听；
- 输出文件定位；
- 目录扫描；
- CSV 和诊断日志导出；
- 本机历史记录；
- GitHub Release 更新检测。
| 输入格式 | 来源 | 是否需要数据库 |
|---|---|---|
.kgg |
酷狗 Hi-Res | 需要 KGMusicV3.db |
.kgm |
酷狗 | 不需要 |
.kgma |
酷狗 | 不需要 |
.vpr |
酷狗 VIP | 不需要 |
.ncm |
网易云音乐 | 不需要 |
.kwm |
酷我音乐 | 不需要 |
.mflac/.mgg |
QQ 音乐（QMC2） | 旧式内嵌 ekey 文件离线解密；musicex 新版文件每个转换批次需要已登录 QQ 音乐 PC 客户端和网络 |
.qmc0/.qmc2/.qmc3/.qmc4/.qmc6/.qmc8 |
QQ 音乐（传统 QMC） | 不需要 |
.qmcflac/.qmcogg/.tkm |
QQ 音乐（传统 QMC） | 不需要 |
| 输出格式 | 说明 |
|---|---|
| MP3 | VBR 音质可选 |
| FLAC | 无损 |
| WAV | 无压缩 PCM |
| Copy | 保持解密后的原始音频格式 |
- Windows 10 / 11；
- 64 位处理器和操作系统；
- Windows 7 不在支持范围内；
- 标准版需要 Microsoft Edge WebView2 Runtime，Windows 10/11 与新版 Microsoft Edge 通常已经包含；
- 内置 WebView2 版携带 Microsoft Fixed Version Runtime，适合无法安装运行时的受管控环境，但下载体积和首次启动缓存明显更大；
- v0.6.0 起的当前正式构建均强制内嵌 FFmpeg。
- 下载并解压 v0.5.1 ZIP；
- 双击
start.hta启动，或使用start.bat； - 等待浏览器打开
http://localhost:8080； - 拖入文件或选择目录；
- 设置输出格式和目录后开始转换。
v0.5.1 依赖本地 HTTP 服务。请勿直接打开
public/index.html，否则页面无法连接后端。
- Go 1.26.6；
- Wails CLI v2.14.0；
- Windows WebView2 Runtime；
- NSIS 3（用于生成按用户安装器）。
cd backend
wails build -trimpath -o Kugo-Music-Converter-v0.6.1-dev.exe该构建不嵌入 FFmpeg，只适合界面和绑定开发。
./build-release.ps1脚本会获取并校验固定版本的 FFmpeg 与 WebView2 载荷，运行完整测试，分别生成标准版和内置 WebView2 版，并校验 PE 元数据、体积差异和未签名状态。输出位于：
dist/release/Kugo-Music-Converter-v0.6.1-windows-amd64.exe
dist/release/Kugo-Music-Converter-v0.6.1-windows-amd64-webview2.exe
dist/release/Kugo-Music-Converter-v0.6.1-windows-amd64-setup.exe
dist/release/Kugo-Music-Converter-v0.6.1-windows-amd64-webview2-setup.exe
两个便携 EXE 和两个按用户安装器均内嵌 FFmpeg；安装器默认写入 %LOCALAPPDATA%\Programs\Kugo Music Converter，不要求管理员权限。内置 WebView2 变体还携带 Fixed Runtime 151.0.4129.93，因此体积显著更大。当前 v0.6.1 发布链保持未签名并要求各资产 SHA-256；本版本不接入 SignPath Foundation，详见 SIGNING.md。
cd backend
node --check frontend/src/main.js
go test ./...
go test -tags "runtimebundle,release" ./...
go vet ./...KGG 文件需要酷狗客户端的 KGMusicV3.db。常见路径：
%APPDATA%\KuGou8\KGMusicV3.db
程序会自动检测，也支持手动选择和重新检测。
如果新下载的 KGG 文件解密失败，通常是数据库尚未包含最新歌曲密钥。请先在酷狗客户端播放一次歌曲，再重新加载最新数据库。
旧式、文件尾部内嵌 ekey 的 .mflac/.mgg 可直接离线解密。新版 musicex 文件不再携带 ekey：转换时需要启动 QQ 音乐 PC 客户端，并登录下载该文件且仍具备资源权限的账号。程序读取当前用户 QQ 音乐 SetCookie.dat/_SetCookie.dat 中明确的 authst 字段；文件中没有可用字段时，以查询和内存读取权限扫描同用户 QQMusic.exe/qmbrowser.exe 的可读内存。随后使用文件尾部的 media_mid 和资源名向 QQ 音乐运营的 u.y.qq.com 未公开兼容端点请求 ekey。音频内容、本地路径、历史和日志不会发送，登录会话与 ekey 不写入配置、历史或日志。
部分新版 MFLAC 的 raw 解密流在已声明时长结束后带一个残缺 FLAC 包。Copy 模式会使用内嵌 FFmpeg 严格校验；检测到该模式时自动无损重建 FLAC 并再次严格复验。MGG Copy 保持原始 OGG。
QQ 音乐未运行、未登录、会话过期、账号无资源权限或网络不可用时，仅对应的新版 MFLAC/MGG 项失败，同批次其他格式继续转换。
- 音频解密和转码在本机完成；
- 音频文件不会发送到云端；
- 只有无内嵌 ekey 的新版 MFLAC/MGG 会连接 QQ 音乐运营的未公开兼容端点，发送当前 QQ 音乐会话、账号标识、
media_mid和资源文件名以取得该资源的 ekey； - QQ 音乐会话和 ekey 只在本次转换的 Go 后端内存中使用，不进入 WebView、本机历史、配置、CSV 或诊断日志；
- 桌面版转换进程不监听 TCP 端口；
- v0.5.1 只监听本机
localhost； - 检查更新会访问 GitHub Release API 或预设镜像；只有用户确认自动更新后，程序才会从官方 GitHub Release 下载安装器和 SHA-256。
| 问题 | 处理方式 |
|---|---|
| MFLAC/MGG 转换提示未登录或会话过期 | 启动 QQ 音乐 PC 客户端并登录下载该文件的账号；新版 musicex 文件每个转换批次都需要联网取钥 |
| MFLAC/MGG 提示账号无权取得密钥 | 确认当前账号仍具备该资源权限，必要时在 QQ 音乐客户端重新下载文件 |
| KGG 转换失败 | 检查 KGMusicV3.db，在酷狗客户端播放歌曲后重新检测 |
| 桌面版提示运行时未就绪 | 确认使用带 runtimebundle 的正式构建，而不是开发构建 |
| 标准版无法显示窗口 | 安装 Microsoft Edge WebView2 Runtime，或改用内置 WebView2 版 |
| 内置 WebView2 版第一次启动较慢 | EXE 约 339 MiB，首次启动需解压约 661 MiB 的 Fixed Runtime 缓存，后续会复用 |
| 桌面版第一次启动稍慢 | 首次启动需要解压和校验内嵌 FFmpeg |
| Windows 显示“未知发布者” | 当前正式资产按发布策略未签名；仅从本仓库 Releases 下载并核对 SHA-256 |
| 桌面版设置或历史消失 | WebView 本机应用数据被清理后，设置和历史会重置 |
| v0.5.1 页面无法连接后端 | 必须通过 start.hta 或 start.bat 启动完整链路 |
| Windows 7 无法运行 | v0.6.x 不支持 Windows 7 |
Kugo-Music-Converter-Modpacks/
├── backend/
│ ├── main.go # Wails 桌面入口、单实例和关窗拦截
│ ├── app.go # 原生选择器、启动状态和运行时
│ ├── app_conversion.go # 桌面转换任务和事件
│ ├── app_features.go # 扫描、导出、试听和更新
│ ├── app_update.go # 官方 Release 下载、SHA-256 校验和安装器启动
│ ├── app_cache.go # 应用运行时缓存统计与安全清理
│ ├── app_music_discovery.go # 查找本机音乐的分组、去重和受限扫描
│ ├── app_windows_integration.go # 任务栏进度、完成通知、单实例（Windows）
│ ├── frontend/src/ # 桌面前端（含内联图标精灵和 Inter 字体）
│ ├── internal/runtimebundle/ # FFmpeg 嵌入和缓存
│ ├── internal/webview2bundle/ # Fixed WebView2 嵌入、解压、权限和缓存
│ └── cmd/server/ # 迁移期保留的 v0.5.x HTTP 入口
├── public/ # 迁移期保留的 v0.5.x 浏览器前端
├── test-clean-install.ps1 # 干净测试机安装、自检、卸载门禁
├── test-sample-coverage.ps1 # 真实样本覆盖清点与转换回归门禁
├── start.hta / start.bat # 迁移期保留的 v0.5.x 启动器
├── build-release.ps1 # 标准版 / 内置 WebView2 版构建与门禁
├── verify-release.ps1 # PE 元数据、Authenticode、时间戳与哈希验证
├── SIGNING.md # v0.6.0 / v0.6.1 未签名决策
├── SIGNING-POLICY.md # 未启用的未来签名政策草案
├── PRIVACY.md / SECURITY.md # 隐私和安全报告政策
├── THIRD-PARTY-NOTICES.md # 第三方组件与许可证说明
├── FFMPEG-SOURCE.md # 内嵌 FFmpeg 来源、配置和对应源代码
├── WEBVIEW2-SOURCE.md # 内置 WebView2 版本、哈希和官方来源
└── COPYING
v0.6.1 是当前公开稳定版，已完成 MFLAC/MGG、QQ 音乐发现与归类修复、性能优化、更新下载兜底、四资产构建和两种安装器无残留验收。
本项目基于 GNU General Public License v3.0 发布。第三方组件、内嵌 FFmpeg 与 WebView2 来源见 THIRD-PARTY-NOTICES.md、FFMPEG-SOURCE.md 与 WEBVIEW2-SOURCE.md。隐私、安全和当前未签名状态见 PRIVACY.md、SECURITY.md 与 SIGNING.md。