# 春天音乐解码 使用说明

## 软件说明

春天音乐解码是一款本地音乐格式转换工具，用来把部分酷狗音乐、QQ 音乐文件转换成常见音频格式，优先输出 MP3。

本工具为纯免费分享，不收费、不售卖、不提供付费服务。请只转换你自己合法获得、仅供个人使用的音乐文件。

## 推荐安装方式

1. 下载压缩包后，先完整解压，不要直接在压缩包里运行
2. 打开解压后的文件夹
3. 直接双击 `春天音乐解码.vbs` 即可打开工具
4. 如果想创建桌面快捷方式，再双击 `创建桌面快捷方式.vbs`，会弹出提示并自动创建
5. 安装完成后，桌面会出现 `春天音乐解码` 快捷方式
6. 以后可以双击桌面快捷方式使用

如果你不想创建桌面快捷方式，也可以直接双击 `run.bat` 启动。

解压后可以放在任意文件夹使用。请保留整个文件夹结构，不要只把某一个文件单独拿出来运行，否则可能找不到主程序或组件。

## 使用步骤

1. 打开 `春天音乐解码`
2. 如果要批量转换整个目录，点击 `选择文件夹`
3. 如果想看到具体歌曲文件，点击 `选择音乐文件`
4. 选择输出文件夹；不选择时，默认输出到输入目录下的 `MP3_Output`
5. MP3 码率建议保持 `320`
6. 点击 `一键转换`
7. 转换完成后，到输出文件夹查看结果

原始音乐文件不会被删除。

## MP3 码率怎么选

- `320 kbps`：推荐，音质较好，文件较大
- `192 kbps`：比较均衡，文件较小
- `128 kbps`：文件更小，但音质会明显下降

不确定时，直接选择 `320`。

## 支持格式

酷狗音乐：

- `.kgg`
- `.kgm`
- `.kgma`
- `.vpr`

QQ 音乐：

- `.qmc0`
- `.qmc2`
- `.qmc3`
- `.qmcflac`
- `.qmcogg`
- `.mflac`
- `.mflac0`
- `.mgg`
- `.mgg0`
- `.mgg1`

普通音频：

- `.ogg`
- `.flac`
- `.wav`
- `.m4a`
- `.aac`

工具会优先输出 MP3。如果暂时不能转成 MP3，会尽量输出 OGG、FLAC 等通用格式。

## 常见问题

### 选择文件夹时看不到音乐文件

这是 Windows 文件夹选择窗口的正常表现。它只显示文件夹，不显示歌曲。

想直接看到歌曲文件，请点击工具里的 `选择音乐文件`。

### 第一次运行为什么要准备组件

转换 MP3 需要 `ffmpeg`，解码酷狗和 QQ 音乐文件也需要对应组件。工具会把组件保存到 `tools` 目录，成功后以后不会重复下载。

### 提示下载包损坏或不是 zip

一般是网络中断导致文件没下载完整。新版工具会自动删除损坏包并重新下载。

### KGG 转换失败

`.kgg` 通常需要本机酷狗数据库。请先用酷狗客户端播放一次该歌曲，再重新转换。

### QQ 的 mflac/mgg 转换失败

部分 QQ 音乐文件需要本机 QQ 音乐登录状态或文件内置密钥。如果日志提示缺少密钥，请先确认 QQ 音乐客户端能正常播放该歌曲。

## 免费声明

本工具仅供学习和个人文件格式转换使用，纯免费分享。

任何人不得把本工具改名收费、捆绑广告、诱导付费或用于商业售卖。

如果有疑问，请联系作者 Telegram：`@cqdfc`