🎧 多平台点歌
插件名称： astrbot_plugin_music
当前版本： v2.1.3
高性能多平台点歌插件，支持 AI 自动点歌、音乐卡片、语音、文件、文本链接、歌词和热评。
🚀 快速开始
使用默认平台点歌
@bot 点歌 晴天
指定平台点歌
@bot 网易点歌 晴天
@bot QQ点歌 晴天
查询歌词
@bot 查歌词 晴天
⌨️ 命令速查
| 命令 | 说明 |
|---|---|
@bot 点歌 歌名 | 使用管理员设置的默认平台点歌 |
@bot 平台名点歌 歌名 | 指定音乐平台点歌 |
@bot 点歌 歌名 序号 | 直接选择搜索结果中的指定序号 |
@bot 查歌词 歌名 | 查询并发送歌词 |
@bot 歌曲列表序号 模式 | 播放歌单中的歌曲，并指定发送模式 |
发送模式可以使用中文名称：
卡片
语音
文件
文本
也可以使用数字：
1
2
3
4
🎼 支持的平台
仓库 README 列出的平台包括：
- 网易云音乐；
- 网易云 NodeJS 版，命令可使用
网易点歌或nj点歌； - QQ 音乐；
- 酷狗音乐；
- 酷我音乐；
- 百度音乐；
- 咪咕音乐；
- 荔枝 FM；
- 蜻蜓 FM；
- 喜马拉雅；
- 5sing 原创；
- 5sing 翻唱；
- 全民 K 歌。
实际可用平台由管理员启用的播放器和外部接口决定。
示例
@bot 酷狗点歌 海阔天空
@bot 咪咕点歌 夜曲
🔎 搜索与选歌模式
管理员可以设置三种选歌方式：
| 模式 | 用户看到的效果 |
|---|---|
| 文本列表 | bot 发送歌曲列表，等待用户输入序号 |
| 图片列表 | bot 将搜索结果渲染为图片 |
| 自动选择 | 直接选择搜索结果中的第一首 |
因此，同一个 @bot 点歌 歌名 命令在不同 bot 或群聊中，返回方式可能不同。
📤 发送方式与自动降级
插件支持四种发送方式，并可以按照管理员设置的顺序自动降级：
| 模式 | 说明 |
|---|---|
| 卡片 | 音乐卡片；仓库说明中标注仅 QQ + 网易云可用 |
| 语音 | 以语音消息发送 |
| 文件 | 以音乐文件发送 |
| 文本 | 发送歌曲播放链接 |
例如首选音乐卡片发送失败时，插件可以继续尝试语音、文件或文本链接。
📝 歌词、热评与歌单
管理员可以开启：
- 歌曲发送后附加热评；
- 发送歌词图片；
- 用户独立歌单；
- 选歌等待超时；
- 缓存清理和网络代理。
仓库 README 当前没有列出用户独立歌单的专用命令，因此歌单操作请以 bot 实际返回的帮助或管理员设置为准。
🤖 AI 自动点歌
插件提供 LLM Tool。用户可以直接用自然语言表达需求：
@bot 我想听周杰伦的《晴天》
模型在支持工具调用时，可以自动选择音乐并播放。是否成功取决于模型能力、管理员配置和音源可用性。
⚠️ 使用注意
- 不同音源的搜索结果、版权和地区限制可能不同。
- 所有平台并不一定同时可用，以管理员启用情况为准。
- 音乐卡片、语音或文件发送失败时，系统可能自动切换为其他形式。
- 选择歌曲时请在等待超时前回复序号。
- 部分歌曲可能只有文本链接，无法下载或发送完整音频。
- 网易云 NodeJS 音源依赖外部接口，接口失效时需要管理员更换服务。
- 搜索结果和发送效果由第三方平台提供的数据决定，插件不能保证所有歌曲均可播放。
❓ 常见问题
Q：为什么 @bot 点歌 歌名 直接播放了第一首，没有让我选择？
管理员将选歌模式设置为了“自动选择”。
Q：为什么别人看到的是图片列表，我看到的是文本？
选歌模式由插件配置决定，管理员可能已经切换了展示方式。
Q：为什么音乐卡片发送失败后变成了语音或链接？
插件启用了自动降级。当前平台或音源不支持首选发送方式时，会尝试下一个模式。
Q：为什么指定平台命令没有反应？
对应播放器可能没有启用，或该平台接口当前不可用。
Q：怎样只要歌词？
发送：
@bot 查歌词 歌名
📎 项目信息
- 显示名称：点歌插件
- 当前版本：v2.1.3
- 作者：Zhalslar
- 开源协议：MIT
- 项目地址：https://github.com/Zhalslar/astrbot_plugin_music
