Kugo Music Converter

酷狗 / 网易云加密音频批量转换工具，支持将 KGG、KGM、KGMA、VPR、NCM 等加密音频文件批量转换为 MP3、FLAC、WAV 格式。

---

下载安装

最新版本：v0.5.1

文件	平台	说明
Kugo-Music-Converter-v0.5.1-windows-amd64.zip	Windows x64	解压即用，内含 ffmpeg

系统要求：Windows 10 / 11（64 位），无需安装任何运行时环境。

Windows 7 不在支持范围内。

更多版本请前往 Releases 页面。

功能特性

• 拖拽上传与批量转换（支持文件夹递归解析）
• 全离线运行，无需联网（所有前端资源本地化）
• 全新 UI（Tailwind CSS + Inter 字体，纯色风格，深色模式）
• 并发转换（1 ~ 6 线程可调）
• SSE 流式实时进度与 ETA 预估
• 中途取消转换
• 音频试听（转换完成后直接播放）
• 目录扫描、文件名提取、CSV 导出
• 历史记录管理与日志导出
• KGG 数据库自动检测 / 手动选择 / 上传
• OGG CRC 容错转码（自动重试 + 原格式保底输出）
• 扩展音频格式检测（AAC / M4A / WMA / DFF）
• HEX 头部诊断（无法识别时输出前 16 字节）
• 更新检测后端代理（国内网络可用）

支持格式

输入格式	输出格式
.kgg .kgm .kgma .vpr .ncm	MP3 FLAC WAV 原格式（Copy）

默认单文件上限为 1 GiB；如需调整，可通过配置文件的 max_file_size 或环境变量 KGG_MAX_FILE_SIZE 指定字节数。浏览器单次上传总计上限为 2028 MiB，超过时请分批处理，或使用目录扫描将本地路径加入队列。

快速开始

1. 下载并解压压缩包
2. 双击 start.hta 启动（推荐），或双击 start.bat（备选）
3. 浏览器自动打开 http://localhost:8080

注意：转换依赖本地 HTTP 服务（localhost:8080）。请勿直接双击打开 public/index.html——那样页面无法连接本地后端，会出现 ERR_BACKEND_UNREACHABLE（"未连接到本地转换服务"）。文件解密与转码 全程在本机完成，不上传任何数据到互联网。

目录结构

Kugo-Music-Converter/
├── backend/bin/kugo-converter.exe   # 后端主程序
├── public/                          # 前端页面
│   ├── index.html
│   ├── app.js / style.css
│   ├── modules/                     # JS 模块（14 个）
│   └── vendor/                      # 本地化资源
│       ├── tailwind.min.css         # Tailwind CSS（预编译）
│       ├── lucide.min.js            # Lucide Icons
│       ├── gsap.min.js              # GSAP 动画库
│       └── fonts/inter-*.woff2      # Inter 字体
├── tools/ffmpeg.exe                 # 转码工具
├── output/                          # 默认输出目录
├── start.hta                        # 启动器（推荐）
├── start.bat                        # 启动器（备选）
└── COPYING                          # GPLv3 许可证

使用说明

KGG 文件转换

KGG（酷狗 Hi-Res）文件需要 KGMusicV3.db 中的密钥才能解密：

• 自动检测 -- 程序启动时自动搜索系统中的酷狗数据库
• 手动选择 -- 在页面中点击"选择 DB 文件"按钮
• 上传方式 -- 通过页面上传 DB 文件

如果新下载的歌曲解密失败，通常是密钥映射未包含最新条目。 请在酷狗客户端播放一次歌曲，然后重新加载最新的 KGMusicV3.db。

Windows 系统中 DB 文件常见路径：

%APPDATA%\KuGou8\KGMusicV3.db

常见问题

问题	解决方法
KGG 转换失败	确认 KGMusicV3.db 路径有效，或在酷狗客户端播放一次歌曲后重试
无法转码	确认 tools/ffmpeg.exe 存在且可执行
端口 8080 被占用	程序会自动尝试释放端口，若仍失败请手动关闭占用进程
页面无样式/图标	v0.4.0 已全部本地化，如仍异常请重新下载最新版
ERR_BACKEND_UNREACHABLE（未连接到本地转换服务）	未通过 start.hta/start.bat 启动，或直接打开了 public/index.html。请用启动器启动并从 http://localhost:8080 访问
ERR_STREAM_NO_COMPLETE（本地连接中断）	转换中后端被退出/崩溃/被安全软件拦截。检查本机安全软件、代理、进程稳定性后重试未完成文件
ERR_STREAM_DISCONNECTED（兼容旧码）	含义同上，过渡期保留；新版本已细分为上面两个错误码

说明：以上连接类错误均指本地服务链路（浏览器 ↔ localhost:8080）， 与互联网无关。仅"检查更新"功能会访问 GitHub，转换不依赖公网。

技术栈

层	技术
后端	Go 1.26, net/http, goroutine 并发
前端	Vanilla JS (ES Modules), Tailwind CSS, Lucide Icons, GSAP
解密	QMC2 (AES-CBC / MAP / RC4), KGM, NCM
转码	FFmpeg (外部进程调用)

从源码构建

请参阅 backend/README.md 了解构建步骤和 API 文档。

在 Windows PowerShell 中运行 ./build-release.ps1，可执行完整测试、构建 Windows amd64 后端，并生成经过内容和版本校验的发布 ZIP。

更新日志

详见 Releases 页面。

许可证

本项目基于 GNU General Public License v3.0 发布。