melody-harvest 1.0.0

package/README.md

@@ -0,0 +1,97 @@
+# MelodyHarvest
+
+[![NPM Version](https://img.shields.io/npm/v/melody-harvest.svg)](https://www.npmjs.com/package/melody-harvest)
+[![Node Version](https://img.shields.io/node/v/melody-harvest.svg)](https://nodejs.org/)
+[![License: GPL v2](https://img.shields.io/badge/License-GPL%20v2-blue.svg)](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)
+[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)]()
+
+**🎵 一个强大的全平台音乐搜索与下载CLI工具，让你的音乐收藏无处不在！**
+
+> 🌟 从四大主流音乐平台一键搜索和下载高品质音乐，构建属于你的个人音乐图书馆
+
+## ✨ 核心特性
+
+### 🎯 全平台支持
+- **咪咕音乐** - 海量正版音乐资源
+- **酷狗音乐** - 热门流行歌曲全覆盖  
+- **QQ音乐** - 独家版权歌曲获取
+- **网易云音乐** - 高品质音乐与独立音乐人作品
+
+### 🚀 智能搜索
+- **精准搜索** - 按歌曲名、歌手名快速定位
+- **全网搜索** - 一次性搜索所有平台，对比选择
+- **批量下载** - 支持多首歌曲同时下载
+- **历史记录** - 完整的下载日志管理
+
+### 💫 精美界面
+- **绚丽的CLI界面** - 渐变色标题、动态加载动画
+- **进度条显示** - 实时下载进度和速度
+- **交互式操作** - 简单直观的命令行交互
+
+## 📦 安装
+
+```bash
+# 使用 npm 全局安装
+npm install -g melody-harvest
+
+# 或使用 yarn
+yarn global add melody-harvest
+```
+
+## 🎮 使用方法
+
+### 启动程序
+
+```bash
+melody-harvest
+# 或
+npx melody-harvest
+```
+
+### 基本操作
+
+```
+🔍 输入搜索关键词 (如: 周杰伦 晴天)
+🌐 选择搜索平台 (咪咕/酷狗/QQ/网易云/全网)
+📋 选择要下载的歌曲
+⬇️ 确认下载
+```
+
+### 功能说明
+
+- **搜索歌曲**: 直接输入歌曲名或歌手名
+- **平台切换**: 选择不同音乐平台搜索
+- **批量下载**: 输入多个序号同时下载多首歌曲
+- **查看历史**: 查看已下载的歌曲记录
+
+## 🔧 命令行参数
+
+```bash
+melody-harvest --help    # 显示帮助信息
+melody-harvest --version # 显示版本号
+```
+
+## 📂 输出目录
+
+默认下载目录: `./downloads`
+
+## 🐛 故障排除
+
+**常见问题解决方案：**
+
+- 🔄 **下载失败**：检查网络连接或尝试其他平台
+- 🔤 **文件名问题**：程序会自动处理特殊字符
+- 🔍 **搜索无结果**：尝试使用更精确的关键词
+- ⏱️ **连接超时**：网络环境不佳，可重试
+
+## 🤝 贡献
+
+欢迎提交 Issue 和 Pull Request！
+
+## 📄 许可证
+
+本项目采用 GPL-2.0 许可证开源。
+
+## 🙏 致谢
+
+感谢所有为开源社区做出贡献的人们！

package/babel.config.json

@@ -0,0 +1,9 @@
+{
+  "presets": [
+    ["@babel/preset-env", {
+      "targets": {
+        "node": "14"
+      }
+    }]
+  ]
+}

package/bin/melody-harvest.js

@@ -0,0 +1,207 @@
+#!/usr/bin/env node
+
+const chalk = require('chalk');
+const figlet = require('figlet');
+const gradient = require('gradient-string');
+const inquirer = require('inquirer');
+const { MusicDownloader } = require('../src/downloader');
+const { createInterface } = require('readline');
+
+const musicDownloader = new MusicDownloader();
+
+async function showWelcome() {
+  console.clear();
+  console.log(
+    gradient.teen(
+      figlet.textSync('MelodyHarvest', {
+        font: 'Big',
+        horizontalLayout: 'default',
+        verticalLayout: 'default'
+      })
+    )
+  );
+  console.log(chalk.cyan('\n    🎵 全平台音乐搜索与下载利器'));
+  console.log(chalk.gray('    =====================================\n'));
+}
+
+async function searchMusic(query, platform = null) {
+  const platforms = {
+    'migu': '咪咕音乐',
+    'kugou': '酷狗音乐',
+    'qq': 'QQ音乐',
+    'cloud': '网易云',
+    'all': '全网搜索'
+  };
+
+  if (platform && platform !== 'all') {
+    return await musicDownloader.search(query, platform);
+  }
+
+  const results = await musicDownloader.searchAll(query);
+  return results;
+}
+
+async function downloadMusic(songs, platform) {
+  for (const song of songs) {
+    await musicDownloader.download(song, platform);
+  }
+}
+
+async function showHistory() {
+  const history = musicDownloader.getHistory();
+  if (history.length === 0) {
+    console.log(chalk.yellow('\n📭 暂无下载记录'));
+    return;
+  }
+
+  console.log(chalk.cyan('\n📜 下载历史：\n'));
+  history.forEach((item, index) => {
+    console.log(
+      chalk.white(`${index + 1}. `) +
+      chalk.green(item.title) + 
+      chalk.gray(' - ') + 
+      chalk.yellow(item.artist) +
+      chalk.gray(' [') + 
+      chalk.blue(item.platform) + 
+      chalk.gray(']')
+    );
+  });
+}
+
+async function main() {
+  await showWelcome();
+
+  const questions = [
+    {
+      type: 'input',
+      name: 'search',
+      message: chalk.cyan('🔍 请输入搜索关键词 (如: 周杰伦 晴天)'),
+      validate: (input) => input.trim() !== '' || '请输入搜索内容'
+    }
+  ];
+
+  const answers = await inquirer.prompt(questions);
+  const query = answers.search.trim();
+
+  const platformQuestions = [
+    {
+      type: 'list',
+      name: 'platform',
+      message: chalk.cyan('🌐 选择搜索平台'),
+      choices: [
+        { name: '🎵 咪咕音乐', value: 'migu' },
+        { name: '🎤 酷狗音乐', value: 'kugou' },
+        { name: '🎼 QQ音乐', value: 'qq' },
+        { name: '☁️ 网易云音乐', value: 'cloud' },
+        { name: '🌈 全网搜索 (所有平台)', value: 'all' },
+        { name: '🔙 返回', value: 'back' }
+      ]
+    }
+  ];
+
+  const platformAnswer = await inquirer.prompt(platformQuestions);
+  
+  if (platformAnswer.platform === 'back') {
+    return main();
+  }
+
+  const results = await searchMusic(query, platformAnswer.platform);
+  
+  if (!results || results.length === 0) {
+    console.log(chalk.red('\n❌ 未找到相关歌曲，请尝试其他关键词'));
+    return main();
+  }
+
+  console.log(chalk.cyan('\n📋 搜索结果：\n'));
+  results.forEach((song, index) => {
+    const platformEmoji = {
+      'migu': '🎵',
+      'kugou': '🎤',
+      'qq': '🎼',
+      'cloud': '☁️'
+    };
+    console.log(
+      chalk.white(`${index.toString().padStart(2, '0')}. `) +
+      chalk.green(song.title) +
+      chalk.gray(' - ') +
+      chalk.yellow(song.artist) +
+      chalk.gray(' [') +
+      chalk.blue(song.album || '未知专辑') +
+      chalk.gray(']')
+    );
+  });
+
+  const downloadQuestions = [
+    {
+      type: 'input',
+      name: 'indices',
+      message: chalk.cyan('⬇️ 输入要下载的歌曲序号 (多个用空格分隔，如: 1 3 5)'),
+      validate: (input) => {
+        if (!input.trim()) return '请输入序号';
+        const indices = input.trim().split(/\s+/).map(i => parseInt(i));
+        if (indices.some(i => isNaN(i) || i < 1 || i > results.length)) {
+          return `请输入 1-${results.length} 之间的有效序号`;
+        }
+        return true;
+      }
+    },
+    {
+      type: 'confirm',
+      name: 'confirmDownload',
+      message: chalk.cyan('✨ 确定开始下载吗？'),
+      default: true
+    }
+  ];
+
+  const downloadAnswers = await inquirer.prompt(downloadQuestions);
+  
+  if (!downloadAnswers.confirmDownload) {
+    console.log(chalk.gray('\n⏸️ 已取消下载'));
+    return main();
+  }
+
+  const indices = downloadAnswers.indices.trim().split(/\s+/).map(i => parseInt(i) - 1);
+  const songsToDownload = indices.map(i => results[i]).filter(song => song);
+
+  console.log(chalk.cyan('\n🚀 开始下载...\n'));
+  await downloadMusic(songsToDownload, platformAnswer.platform);
+
+  console.log(chalk.green('\n✅ 下载完成！'));
+  
+  const continueQuestions = [
+    {
+      type: 'list',
+      name: 'action',
+      message: chalk.cyan('\n🎮 选择操作'),
+      choices: [
+        { name: '🔍 继续搜索', value: 'search' },
+        { name: '📜 查看历史', value: 'history' },
+        { name: '👋 退出程序', value: 'exit' }
+      ]
+    }
+  ];
+
+  const actionAnswer = await inquirer.prompt(continueQuestions);
+  
+  switch (actionAnswer.action) {
+    case 'search':
+      return main();
+    case 'history':
+      await showHistory();
+      return main();
+    case 'exit':
+      console.log(chalk.cyan('\n👋 感谢使用 MelodyHarvest，再见！\n'));
+      process.exit(0);
+  }
+}
+
+process.on('uncaughtException', (error) => {
+  console.error(chalk.red('\n❌ 程序发生错误:'), error.message);
+  process.exit(1);
+});
+
+process.on('unhandledRejection', (reason, promise) => {
+  console.error(chalk.red('\n❌ 未处理的Promise错误:'), reason);
+});
+
+main();

package/dist/downloader.js

@@ -0,0 +1,293 @@
+"use strict";
+
+const axios = require('axios');
+const fs = require('fs');
+const path = require('path');
+const {
+  promisify
+} = require('util');
+const figlet = require('figlet');
+const gradient = require('gradient-string');
+const ora = require('ora');
+const cliProgress = require('cli-progress');
+const writeFileAsync = promisify(fs.writeFile);
+const mkdirAsync = promisify(fs.mkdir);
+class MusicDownloader {
+  constructor() {
+    this.history = [];
+    this.downloadPath = path.join(process.cwd(), 'downloads');
+    this.ensureDownloadDir();
+  }
+  async ensureDownloadDir() {
+    try {
+      await mkdirAsync(this.downloadPath, {
+        recursive: true
+      });
+    } catch (error) {
+      if (error.code !== 'EEXIST') {
+        console.error('创建下载目录失败:', error.message);
+      }
+    }
+  }
+  async search(query, platform = 'all') {
+    const platformMap = {
+      'migu': () => this.searchMigu(query),
+      'kugou': () => this.searchKugou(query),
+      'qq': () => this.searchQQ(query),
+      'cloud': () => this.searchNetease(query),
+      'all': () => this.searchAll(query)
+    };
+    const searchFn = platformMap[platform];
+    if (!searchFn) {
+      throw new Error(`不支持的平台: ${platform}`);
+    }
+    return await searchFn();
+  }
+  async searchMigu(query) {
+    const spinner = ora({
+      text: '🎵 正在搜索咪咕音乐...',
+      spinner: 'dots'
+    }).start();
+    try {
+      const response = await axios.get('https://music.migu.cn/v3/api/search/search', {
+        params: {
+          keyword: query,
+          page: 1,
+          limit: 20
+        },
+        timeout: 10000
+      });
+      spinner.succeed('咪咕音乐搜索完成');
+      if (response.data && response.data.data) {
+        return response.data.data.map(song => ({
+          id: song.id,
+          title: song.title || song.songName,
+          artist: song.artist || song.singerName,
+          album: song.album || song.albumName,
+          duration: song.duration || song.time,
+          url: song.url || song.playUrl,
+          platform: '咪咕音乐',
+          platformCode: 'migu'
+        }));
+      }
+      return [];
+    } catch (error) {
+      spinner.fail('咪咕音乐搜索失败');
+      console.error('搜索错误:', error.message);
+      return [];
+    }
+  }
+  async searchKugou(query) {
+    const spinner = ora({
+      text: '🎤 正在搜索酷狗音乐...',
+      spinner: 'dots'
+    }).start();
+    try {
+      const response = await axios.get('https://searchproxy.kugou.com/search', {
+        params: {
+          keyword: query,
+          page: 1,
+          limit: 20,
+          client: 'mse'
+        },
+        timeout: 10000,
+        headers: {
+          'Referer': 'https://www.kugou.com/'
+        }
+      });
+      spinner.succeed('酷狗音乐搜索完成');
+      if (response.data && response.data.data) {
+        return response.data.data.map(song => ({
+          id: song.FileHash || song.id,
+          title: song.SongName || song.fileName,
+          artist: song.SingerName || song.singer,
+          album: song.AlbumName || song.album,
+          duration: song.Duration || song.time,
+          url: song.FileHash ? `https://www.kugou.com/song/#${song.FileHash}` : song.play_url,
+          platform: '酷狗音乐',
+          platformCode: 'kugou'
+        }));
+      }
+      return [];
+    } catch (error) {
+      spinner.fail('酷狗音乐搜索失败');
+      console.error('搜索错误:', error.message);
+      return [];
+    }
+  }
+  async searchQQ(query) {
+    const spinner = ora({
+      text: '🎼 正在搜索QQ音乐...',
+      spinner: 'dots'
+    }).start();
+    try {
+      const response = await axios.get('https://c.y.qq.com/soso/fcgi-bin/client_search_cp', {
+        params: {
+          ct: 24,
+          qqmusic_ver: 1001,
+          remoteplace: 'txt.yqq.top',
+          searchid: Math.floor(Math.random() * 1000000),
+          t: 0,
+          flag: 1,
+          sem: 1,
+          aggr: 1,
+          n: 20,
+          w: query,
+          lr: 0,
+          lossless: 1
+        },
+        timeout: 10000,
+        headers: {
+          'Referer': 'https://y.qq.com/'
+        }
+      });
+      spinner.succeed('QQ音乐搜索完成');
+      if (response.data && response.data.message) {
+        const data = JSON.parse(response.data.message.data);
+        if (data.song && data.song.list) {
+          return data.song.list.map(song => ({
+            id: song.songmid,
+            title: song.songname,
+            artist: song.singer[0] ? song.singer[0].name : '未知',
+            album: song.albumname,
+            duration: song.interval,
+            url: `https://y.qq.com/#/song/${song.songmid}`,
+            platform: 'QQ音乐',
+            platformCode: 'qq'
+          }));
+        }
+      }
+      return [];
+    } catch (error) {
+      spinner.fail('QQ音乐搜索失败');
+      console.error('搜索错误:', error.message);
+      return [];
+    }
+  }
+  async searchNetease(query) {
+    const spinner = ora({
+      text: '☁️ 正在搜索网易云音乐...',
+      spinner: 'dots'
+    }).start();
+    try {
+      const response = await axios.post('https://music.163.com/api/search/get/web', {
+        s: query,
+        type: 1,
+        limit: 20,
+        offset: 0
+      }, {
+        timeout: 10000,
+        headers: {
+          'Referer': 'https://music.163.com/',
+          'Content-Type': 'application/x-www-form-urlencoded'
+        }
+      });
+      spinner.succeed('网易云音乐搜索完成');
+      if (response.data && response.data.result && response.data.result.songs) {
+        return response.data.result.songs.map(song => ({
+          id: song.id,
+          title: song.name,
+          artist: song.artists[0] ? song.artists[0].name : '未知',
+          album: song.album ? song.album.name : '未知专辑',
+          duration: song.duration,
+          url: `https://music.163.com/#/song?id=${song.id}`,
+          platform: '网易云音乐',
+          platformCode: 'cloud'
+        }));
+      }
+      return [];
+    } catch (error) {
+      spinner.fail('网易云音乐搜索失败');
+      console.error('搜索错误:', error.message);
+      return [];
+    }
+  }
+  async searchAll(query) {
+    const spinner = ora({
+      text: '🌈 正在全网搜索...',
+      spinner: 'dots'
+    }).start();
+    try {
+      const [migu, kugou, qq, cloud] = await Promise.allSettled([this.searchMigu(query), this.searchKugou(query), this.searchQQ(query), this.searchNetease(query)]);
+      const results = [];
+      if (migu.status === 'fulfilled') results.push(...migu.value);
+      if (kugou.status === 'fulfilled') results.push(...kugou.value);
+      if (qq.status === 'fulfilled') results.push(...qq.value);
+      if (cloud.status === 'fulfilled') results.push(...cloud.value);
+      spinner.succeed(`全网搜索完成，共找到 ${results.length} 首歌曲`);
+      return results;
+    } catch (error) {
+      spinner.fail('全网搜索失败');
+      console.error('搜索错误:', error.message);
+      return [];
+    }
+  }
+  async download(song, platform) {
+    const fileName = this.sanitizeFileName(`${song.artist} - ${song.title}`);
+    const filePath = path.join(this.downloadPath, `${fileName}.mp3`);
+    const progressBar = new cliProgress.SingleBar({
+      format: `⬇️ ${chalk.cyan(fileName)} | ${chalk.green('{bar}')} {percentage}% | {speed}`,
+      barCompleteChar: '█',
+      barIncompleteChar: '░',
+      fps: 10,
+      stream: process.stdout,
+      position: 'center',
+      schedule: function (schedule) {
+        return schedule;
+      }
+    });
+    progressBar.start(100, 0);
+    try {
+      const response = await axios({
+        method: 'get',
+        url: song.url,
+        responseType: 'stream',
+        timeout: 60000,
+        onDownloadProgress: progressEvent => {
+          const percent = Math.round(progressEvent.loaded * 100 / (progressEvent.total || progressEvent.loaded));
+          progressBar.update(percent);
+        }
+      });
+      const totalLength = parseInt(response.headers['content-length'] || '0', 10);
+      const writer = fs.createWriteStream(filePath);
+      response.data.on('data', chunk => {
+        progressBar.update(Math.min(99, Math.round(writer.bytesWritten * 100 / (totalLength || writer.bytesWritten))));
+      });
+      response.data.pipe(writer);
+      await new Promise((resolve, reject) => {
+        writer.on('finish', resolve);
+        writer.on('error', reject);
+      });
+      progressBar.stop();
+      this.history.push({
+        title: song.title,
+        artist: song.artist,
+        album: song.album,
+        platform: song.platform,
+        filePath: filePath,
+        downloadDate: new Date().toISOString()
+      });
+      console.log(chalk.green(`\n✅ 下载成功: ${song.artist} - ${song.title}`));
+      console.log(chalk.gray(`   📁 保存至: ${filePath}`));
+      return filePath;
+    } catch (error) {
+      progressBar.stop();
+      console.error(chalk.red(`\n❌ 下载失败: ${song.title}`));
+      console.error(chalk.gray(`   错误信息: ${error.message}`));
+      throw error;
+    }
+  }
+  sanitizeFileName(fileName) {
+    return fileName.replace(/[<>:"/\\|?*]/g, '-').replace(/\s+/g, ' ').trim().slice(0, 200);
+  }
+  getHistory() {
+    return this.history;
+  }
+  clearHistory() {
+    this.history = [];
+    console.log(chalk.cyan('\n🗑️ 下载历史已清空'));
+  }
+}
+module.exports = {
+  MusicDownloader
+};

package/dist/index.js

@@ -0,0 +1,9 @@
+"use strict";
+
+const {
+  MusicDownloader
+} = require('./downloader');
+module.exports = {
+  MusicDownloader,
+  default: MusicDownloader
+};

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "melody-harvest",
+  "version": "1.0.0",
+  "description": "🎵 一个强大的全平台音乐搜索与下载CLI工具 - 支持咪咕、酷狗、QQ音乐、网易云",
+  "main": "dist/index.js",
+  "bin": {
+    "melody-harvest": "./bin/melody-harvest.js"
+  },
+  "scripts": {
+    "build": "babel src --out-dir dist",
+    "dev": "node bin/melody-harvest.js",
+    "start": "node bin/melody-harvest.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "music",
+    "download",
+    "cli",
+    "migu",
+    "kugou",
+    "qq-music",
+    "netease",
+    "music-downloader"
+  ],
+  "author": "MelodyHarvest",
+  "license": "GPL-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/httpspycharmhelpers/MelodyHarvest.git"
+  },
+  "bugs": {
+    "url": "https://github.com/httpspycharmhelpers/MelodyHarvest/issues"
+  },
+  "homepage": "https://github.com/httpspycharmhelpers/MelodyHarvest#readme",
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "dependencies": {
+    "axios": "^1.6.2",
+    "chalk": "^4.1.2",
+    "chalk-animation": "^2.0.3",
+    "cli-progress": "^3.12.0",
+    "cli-spinners": "^2.9.2",
+    "figlet": "^1.7.0",
+    "gradient-string": "^2.0.2",
+    "inquirer": "^9.2.12",
+    "ora": "^8.0.1"
+  },
+  "devDependencies": {
+    "@babel/cli": "^7.28.6",
+    "@babel/core": "^7.29.0",
+    "@babel/preset-env": "^7.29.0"
+  }
+}

package/src/downloader.js

@@ -0,0 +1,338 @@
+const axios = require('axios');
+const fs = require('fs');
+const path = require('path');
+const { promisify } = require('util');
+const figlet = require('figlet');
+const gradient = require('gradient-string');
+const ora = require('ora');
+const cliProgress = require('cli-progress');
+
+const writeFileAsync = promisify(fs.writeFile);
+const mkdirAsync = promisify(fs.mkdir);
+
+class MusicDownloader {
+  constructor() {
+    this.history = [];
+    this.downloadPath = path.join(process.cwd(), 'downloads');
+    this.ensureDownloadDir();
+  }
+
+  async ensureDownloadDir() {
+    try {
+      await mkdirAsync(this.downloadPath, { recursive: true });
+    } catch (error) {
+      if (error.code !== 'EEXIST') {
+        console.error('创建下载目录失败:', error.message);
+      }
+    }
+  }
+
+  async search(query, platform = 'all') {
+    const platformMap = {
+      'migu': () => this.searchMigu(query),
+      'kugou': () => this.searchKugou(query),
+      'qq': () => this.searchQQ(query),
+      'cloud': () => this.searchNetease(query),
+      'all': () => this.searchAll(query)
+    };
+
+    const searchFn = platformMap[platform];
+    if (!searchFn) {
+      throw new Error(`不支持的平台: ${platform}`);
+    }
+
+    return await searchFn();
+  }
+
+  async searchMigu(query) {
+    const spinner = ora({
+      text: '🎵 正在搜索咪咕音乐...',
+      spinner: 'dots'
+    }).start();
+
+    try {
+      const response = await axios.get('https://music.migu.cn/v3/api/search/search', {
+        params: {
+          keyword: query,
+          page: 1,
+          limit: 20
+        },
+        timeout: 10000
+      });
+
+      spinner.succeed('咪咕音乐搜索完成');
+
+      if (response.data && response.data.data) {
+        return response.data.data.map(song => ({
+          id: song.id,
+          title: song.title || song.songName,
+          artist: song.artist || song.singerName,
+          album: song.album || song.albumName,
+          duration: song.duration || song.time,
+          url: song.url || song.playUrl,
+          platform: '咪咕音乐',
+          platformCode: 'migu'
+        }));
+      }
+      return [];
+    } catch (error) {
+      spinner.fail('咪咕音乐搜索失败');
+      console.error('搜索错误:', error.message);
+      return [];
+    }
+  }
+
+  async searchKugou(query) {
+    const spinner = ora({
+      text: '🎤 正在搜索酷狗音乐...',
+      spinner: 'dots'
+    }).start();
+
+    try {
+      const response = await axios.get('https://searchproxy.kugou.com/search', {
+        params: {
+          keyword: query,
+          page: 1,
+          limit: 20,
+          client: 'mse'
+        },
+        timeout: 10000,
+        headers: {
+          'Referer': 'https://www.kugou.com/'
+        }
+      });
+
+      spinner.succeed('酷狗音乐搜索完成');
+
+      if (response.data && response.data.data) {
+        return response.data.data.map(song => ({
+          id: song.FileHash || song.id,
+          title: song.SongName || song.fileName,
+          artist: song.SingerName || song.singer,
+          album: song.AlbumName || song.album,
+          duration: song.Duration || song.time,
+          url: song.FileHash ? `https://www.kugou.com/song/#${song.FileHash}` : song.play_url,
+          platform: '酷狗音乐',
+          platformCode: 'kugou'
+        }));
+      }
+      return [];
+    } catch (error) {
+      spinner.fail('酷狗音乐搜索失败');
+      console.error('搜索错误:', error.message);
+      return [];
+    }
+  }
+
+  async searchQQ(query) {
+    const spinner = ora({
+      text: '🎼 正在搜索QQ音乐...',
+      spinner: 'dots'
+    }).start();
+
+    try {
+      const response = await axios.get('https://c.y.qq.com/soso/fcgi-bin/client_search_cp', {
+        params: {
+          ct: 24,
+          qqmusic_ver: 1001,
+          remoteplace: 'txt.yqq.top',
+          searchid: Math.floor(Math.random() * 1000000),
+          t: 0,
+          flag: 1,
+          sem: 1,
+          aggr: 1,
+          n: 20,
+          w: query,
+          lr: 0,
+          lossless: 1
+        },
+        timeout: 10000,
+        headers: {
+          'Referer': 'https://y.qq.com/'
+        }
+      });
+
+      spinner.succeed('QQ音乐搜索完成');
+
+      if (response.data && response.data.message) {
+        const data = JSON.parse(response.data.message.data);
+        if (data.song && data.song.list) {
+          return data.song.list.map(song => ({
+            id: song.songmid,
+            title: song.songname,
+            artist: song.singer[0] ? song.singer[0].name : '未知',
+            album: song.albumname,
+            duration: song.interval,
+            url: `https://y.qq.com/#/song/${song.songmid}`,
+            platform: 'QQ音乐',
+            platformCode: 'qq'
+          }));
+        }
+      }
+      return [];
+    } catch (error) {
+      spinner.fail('QQ音乐搜索失败');
+      console.error('搜索错误:', error.message);
+      return [];
+    }
+  }
+
+  async searchNetease(query) {
+    const spinner = ora({
+      text: '☁️ 正在搜索网易云音乐...',
+      spinner: 'dots'
+    }).start();
+
+    try {
+      const response = await axios.post('https://music.163.com/api/search/get/web', {
+        s: query,
+        type: 1,
+        limit: 20,
+        offset: 0
+      }, {
+        timeout: 10000,
+        headers: {
+          'Referer': 'https://music.163.com/',
+          'Content-Type': 'application/x-www-form-urlencoded'
+        }
+      });
+
+      spinner.succeed('网易云音乐搜索完成');
+
+      if (response.data && response.data.result && response.data.result.songs) {
+        return response.data.result.songs.map(song => ({
+          id: song.id,
+          title: song.name,
+          artist: song.artists[0] ? song.artists[0].name : '未知',
+          album: song.album ? song.album.name : '未知专辑',
+          duration: song.duration,
+          url: `https://music.163.com/#/song?id=${song.id}`,
+          platform: '网易云音乐',
+          platformCode: 'cloud'
+        }));
+      }
+      return [];
+    } catch (error) {
+      spinner.fail('网易云音乐搜索失败');
+      console.error('搜索错误:', error.message);
+      return [];
+    }
+  }
+
+  async searchAll(query) {
+    const spinner = ora({
+      text: '🌈 正在全网搜索...',
+      spinner: 'dots'
+    }).start();
+
+    try {
+      const [migu, kugou, qq, cloud] = await Promise.allSettled([
+        this.searchMigu(query),
+        this.searchKugou(query),
+        this.searchQQ(query),
+        this.searchNetease(query)
+      ]);
+
+      const results = [];
+      if (migu.status === 'fulfilled') results.push(...migu.value);
+      if (kugou.status === 'fulfilled') results.push(...kugou.value);
+      if (qq.status === 'fulfilled') results.push(...qq.value);
+      if (cloud.status === 'fulfilled') results.push(...cloud.value);
+
+      spinner.succeed(`全网搜索完成，共找到 ${results.length} 首歌曲`);
+
+      return results;
+    } catch (error) {
+      spinner.fail('全网搜索失败');
+      console.error('搜索错误:', error.message);
+      return [];
+    }
+  }
+
+  async download(song, platform) {
+    const fileName = this.sanitizeFileName(`${song.artist} - ${song.title}`);
+    const filePath = path.join(this.downloadPath, `${fileName}.mp3`);
+
+    const progressBar = new cliProgress.SingleBar({
+      format: `⬇️ ${chalk.cyan(fileName)} | ${chalk.green('{bar}')} {percentage}% | {speed}`,
+      barCompleteChar: '█',
+      barIncompleteChar: '░',
+      fps: 10,
+      stream: process.stdout,
+      position: 'center',
+      schedule: function(schedule) {
+        return schedule;
+      }
+    });
+
+    progressBar.start(100, 0);
+
+    try {
+      const response = await axios({
+        method: 'get',
+        url: song.url,
+        responseType: 'stream',
+        timeout: 60000,
+        onDownloadProgress: (progressEvent) => {
+          const percent = Math.round((progressEvent.loaded * 100) / (progressEvent.total || progressEvent.loaded));
+          progressBar.update(percent);
+        }
+      });
+
+      const totalLength = parseInt(response.headers['content-length'] || '0', 10);
+      
+      const writer = fs.createWriteStream(filePath);
+      
+      response.data.on('data', (chunk) => {
+        progressBar.update(Math.min(99, Math.round((writer.bytesWritten * 100) / (totalLength || writer.bytesWritten))));
+      });
+
+      response.data.pipe(writer);
+
+      await new Promise((resolve, reject) => {
+        writer.on('finish', resolve);
+        writer.on('error', reject);
+      });
+
+      progressBar.stop();
+
+      this.history.push({
+        title: song.title,
+        artist: song.artist,
+        album: song.album,
+        platform: song.platform,
+        filePath: filePath,
+        downloadDate: new Date().toISOString()
+      });
+
+      console.log(chalk.green(`\n✅ 下载成功: ${song.artist} - ${song.title}`));
+      console.log(chalk.gray(`   📁 保存至: ${filePath}`));
+
+      return filePath;
+    } catch (error) {
+      progressBar.stop();
+      console.error(chalk.red(`\n❌ 下载失败: ${song.title}`));
+      console.error(chalk.gray(`   错误信息: ${error.message}`));
+      throw error;
+    }
+  }
+
+  sanitizeFileName(fileName) {
+    return fileName
+      .replace(/[<>:"/\\|?*]/g, '-')
+      .replace(/\s+/g, ' ')
+      .trim()
+      .slice(0, 200);
+  }
+
+  getHistory() {
+    return this.history;
+  }
+
+  clearHistory() {
+    this.history = [];
+    console.log(chalk.cyan('\n🗑️ 下载历史已清空'));
+  }
+}
+
+module.exports = { MusicDownloader };

package/src/index.js

@@ -0,0 +1,6 @@
+const { MusicDownloader } = require('./downloader');
+
+module.exports = {
+  MusicDownloader,
+  default: MusicDownloader
+};