Class MusicPlugin

music/music.ts:1786–2361

    }

    const ffmpegInstalled = await DependencyManager.checkFfmpeg();
    if (!ffmpegInstalled) {
      console.warn("[music] ffmpeg 未安装，音频转换功能受限");
    }

    MusicPlugin.initialized = true;
  }

  public name = "music";
  public description: string;
  public cmdHandlers: Record<string, (msg: Api.Message) => Promise<void>>;

  constructor() {
    super();
    this.description = `🎵 <b>音乐下载助手</b>

<b>使用方法：</b>
<code>${commandName} 周杰伦 晴天</code> - 搜索下载
<code>${commandName} https://...</code> - 链接下载

<b>配置管理：</b>
<code>${commandName} config</code> - 查看当前配置
<code>${commandName} set cookie [值]</code> - 设置YouTube Cookie
<code>${commandName} set proxy [地址]</code> - 设置代理服务器
<code>${commandName} set api_key [密钥]</code> - 设置Gemini API Key
<code>${commandName} set base_url [地址]</code> - 设置Gemini Base URL
<code>${commandName} set model [模型]</code> - 设置Gemini模型
<code>${commandName} set quality [音质]</code> - 自定义音频质量 (如: 320k / 192k / 0..10)
<code>${commandName} clear</code> - 清理临时文件

<b>配置说明：</b>
• <code>cookie</code> - 绕过地区限制，提升下载成功率
• <code>proxy</code> - 网络代理地址 (如: socks5://127.0.0.1:1080)
• <code>quality</code> - 音质：支持 <code>320k/256k/192k/128k</code> 等比特率，或 <code>0..10</code> (VBR，数字越小越好)

<b>解决YouTube访问问题：</b>

🚀 <b>方案1 - WARP+ (推荐)：</b>
<pre>wget -N https://gitlab.com/fscarmen/warp/-/raw/main/menu.sh && bash menu.sh e</pre>

🔧 <b>方案2 - WireProxy：</b>
<pre># 安装 WireProxy
wget -N https://gitlab.com/fscarmen/warp/-/raw/main/menu.sh && bash menu.sh w

# 配置代理（WireProxy 默认端口 40000）
${commandName} set proxy socks5://127.0.0.1:40000</pre>

💡 <i>直接输入歌名即可快速搜索下载</i>`;

    this.downloader = new Downloader();
    this.downloader.cleanCache().catch(() => {});

    // 注册命令处理器
    this.cmdHandlers = {
      music: this.execute.bind(this),
    };
  }