wyy-qqmusic-download

项目概述

这是一款对标 Creamplayer 的桌面音乐下载器，采用 Electron 与 TypeScript 单语言实现，支持 QQ 音乐与网易云两个平台的搜索、歌单浏览与登录后下载。它会在下载时自动内嵌封面与中日对照歌词，标签规格面向 foobar2000 与 Musicolet，并附带 QQ 音乐加密文件解密能力。

一个把搜索、歌单、下载、标签与解密整合到一起的桌面音乐工具。

主要功能

• 双平台搜索：QQ 音乐与网易云，支持歌曲／专辑双 tab、关键词搜索与单曲、歌单、专辑链接导入
• 歌单浏览：登录后可在左侧导航查看我喜欢的音乐、自建歌单与收藏的歌单
• 多档下载：支持无损、APE、320k、128k、m4a 等档位，拿不到时自动降级并在下载列表提示原因
• 下载队列：并发数可调、下载侧限速、原子写与直链过期自动重取，失败行可一键重试
• 歌词与标签：按时间戳合并中文译文生成中日对照，封面与歌词内嵌，兼容 foobar2000 与 Musicolet
• 缓存与解密：列表页内存缓存秒开并后台增量校验更新；导入 QQ 音乐加密文件还原为 flac、ogg 或 mp3 并补齐封面、歌词与标签

适用人群

• 本地曲库用户：需要把歌曲下载到本地、在 foobar2000 或 Musicolet 中播放的用户
• 格式还原用户：想把 QQ 音乐加密缓存还原为通用音频格式的用户
• 歌词收藏者：需要中日对照歌词与规范标签的音乐收藏者

快速上手

1. 安装依赖：执行 npm install，使用 npm run dev 启动开发运行
2. 搜索歌曲：在搜索框输入歌名或歌手，或粘贴单曲、歌单、专辑链接导入
3. 登录拿歌单：登录 QQ 音乐或网易云后，从左侧导航进入我喜欢的音乐、自建歌单与收藏歌单
4. 下载歌曲：勾选歌曲后点击窗口底部下载栏的下载选中，在我的下载中查看进度与结果
5. 打包安装包：需要 Windows 安装包时执行 npm run dist

核心优势

• 降级更合理：按曲目实际登记的档位决定降级顺序，拿不到的档位不再导致整首失败
• 失败可读：拿不到直链时区分权益不足与服务端未提供直链，并提示凭证是否过期、是否需要重新登录
• 播放器友好：封面与歌词内嵌并写入双帧或双键，常见播放器都能直接显示歌词
• 隐私可控：登录凭证仅存本机，请求直连服务，下载管线限速以降低触发风控的概率

系统要求

项目	要求
操作系统	Windows（npm run dist 打包 Windows 安装包）
应用形态	桌面端 Electron 应用
构建环境	Node.js 与 npm

注意事项

• 能播不代表能下：播放与下载是两套权益，部分曲目服务端不提供下载直链，此时失败属正常情况
• 风控限制：下载管线限速 1 请求每秒，浏览请求不限速但依赖缓存窗口，短时间连点多个歌单可能触发频控
• 匿名下载受限：QQ 匿名下载已被服务端收紧，免费歌也需登录态；网易云无损需登录且具备账号权益
• 登录会过期：已登录不等于会话有效，凭证过期时下载会失败并提示重新登录
• 使用边界：仅供个人下载已获授权的歌曲与解密本人缓存文件，禁止绕过付费、传播与商业使用