## 🎵 Music-Search 全能点歌插件指南 (music-search)

本插件允许用户在聊天群组中通过指令搜索歌曲，它会同时尝试从 Spotify、网易云音乐和 QQ 音乐获取结果。

### 💻 核心使用指令

* **指令**： music <歌名>

* **别名**： 点歌 <歌名>

### 💡 使用示例

#### 中文歌

* **用户发送**：点歌 这里的风景

* **逻辑**：机器人会并发搜索三个平台，并将所有找到的结果合并发送。

#### 英文歌

* **用户发送**：music never gonna give you up

* **逻辑**：结果包括 Spotify（封面+链接）、网易云（音乐卡片）、QQ音乐（音乐卡片）。

### 🛠️ 常见问题与排查

* **发送指令后没有任何反应？**

  检查 Koishi 控制台日志，确认是否有错误信息，或所有平台都没有搜索到结果。

* **Spotify 搜索报错？**

  请确保机器人的搭建者正确配置了 spotifyId 和 spotifySecret。

* **音乐卡片发不出来/是空白的？**

  这通常是聊天平台的限制。请联系机器人维护者在配置中开启 forceText（强制纯文本模式），机器人将改为发送文字链接。

* **网易云/QQ音乐搜索异常？**

  这两个平台默认使用公共接口，如果你有更稳定的需求，可建议维护者配置自建的 API 地址。