歌曲下载助手

v1.0.0 私下分发使用版

供最终用户使用的 Windows x64 便携包位于 dist/SongsDownloader-v1.0.0-Windows-x64.zip。
完整解压后双击 启动工具.cmd，无需安装 Node.js 或 npm；仍需本机 Edge/Chrome、网络和夸克账号。
包内 使用手册.html 提供功能介绍、使用流程、故障排查及迁移说明。
此版本不上传公开仓库；运行脚本仍在包中，不是代码加密方案。请只转发原始 ZIP，不要分享使用后的 .data。

以下安装步骤用于本项目开发目录，不适用于自带运行环境的便携包。

这是一个完全本地运行的工具：它使用可见的 Edge/Chrome 自动完成歌曲海搜索、歌词下载、夸克分享页文件选择和目录整理。工具不需要大模型，也不需要歌曲海或夸克 API；夸克登录由你在专用浏览器中亲自完成，程序只复用该浏览器的本地登录态。

安装与启动

Windows 10/11，并已安装 Microsoft Edge 或 Google Chrome：

1. 双击 安装依赖.bat（只需首次运行）。
2. 双击 启动工具.bat。
3. 页面打开后选择保存目录，点击“打开夸克登录”并完成登录。
4. 每行输入一首歌，建议使用 歌名 | 歌手 格式。
5. 搜索、确认版本并开始下载。

也可以在 PowerShell 中运行：

npm.cmd install
npm.cmd start

默认管理页面是 http://127.0.0.1:3210。关闭启动工具的命令窗口即可停止服务。

文件结构

下载结果如下：

保存目录/
└── 海阔天空 - Beyond/
    ├── 海阔天空 - Beyond.mp3
    └── 海阔天空 - Beyond.lrc

音频格式的选择顺序是：MP3、FLAC、WAV、M4A、APE、AAC、OGG。浏览器资料位于 .data/browser-profile；删除这个目录会清除专用浏览器的夸克登录态。

批量任务触发歌曲海“请求过快，请等 N 秒后再试”时，工具会读取实际倒计时，等待结束后自动点击“确定”并继续当前请求；正常请求之间也会主动留出短暂间隔以降低限流概率。

已知限制

• 夸克出现验证码、风控确认或下载权限提示时，需要你在可见浏览器中手动处理，再回到管理页面继续任务。
• 网站调整页面结构后，src/automation.js 中的页面选择器可能需要同步更新。
• 请只下载你有权获取与保存的内容，并遵守相关网站条款和当地法律。