安装并配置插件后，使用下述命令搜索和下载音乐：
\r\n下载音乐 [keywords](不推荐) 星之阁API，需要加群申请API Key，且API Key可能存在失效风险。支持QQ音乐和网易云音乐，速度较慢，稳定性一般。
\r\n酷狗音乐 [keywords](不推荐) 星之阁-酷狗API，需要加群申请API Key，且API Key可能存在失效风险。仅支持酷狗音乐，速度较慢，稳定性一般。
\r\n歌曲搜索 [keywords](比较推荐) music.gdstudio.xyz 网站，无需API Key，但需要 puppeteer 服务支持进行网页爬取，速度还行。默认使用网易云音乐搜索，支持多平台选择。
\r\n网易点歌 [歌曲名称/歌曲ID](比较推荐) api.injahow.cn 网站，API请求快速且稳定，无需 puppeteer 服务，推荐QQ官方机器人使用此后端，但是VIP歌曲只能听45秒。仅支持网易云音乐，可以通过歌曲名称或歌曲ID进行搜索。
\r\n音乐搜索器 [keywords](推荐) dev.iw233.cn 网站，无需API Key，但需要 puppeteer 服务支持进行网页爬取，速度较慢。支持网易云音乐搜索。
\r\n龙珠搜索 [keywords](一般推荐) www.hhlqilongzhu.cn 网站的点歌API，江苏的确可能访问性较差（江苏反诈）。支持网易云音乐平台搜索。
\r\n可以修改对应指令的返回字段表中的 下载链接 对应的 字段发送类型 字段，\r\n\r\n把 text 更改为 audio 就是返回 语音，\r\n\r\n改为 video 就是返回 视频消息，\r\n\r\n改为 file 就是返回 群文件。
⚠️需要注意的是，当配置返回格式为音频/视频的时候，请自行检查是否安装了 silk、ffmpeg 等服务。
⚠️如果你选择了 file 类型，请确保平台支持！目前仅实测了 onebot 平台的部分协议端支持！
-n 1 直接返回内容在使用命令时，可以通过添加 -n 1 选项直接返回指定序号的歌曲内容。这对于快速获取特定歌曲非常有用。
例如，使用以下命令可以直接获取第一首歌曲的详细信息：
\r\n歌曲搜索 -n 1 蔚蓝档案music.gdstudio.xyz的服务，请确保puppeteer服务可用\r\n\r\n---\r\n| 后端推荐度 | 名称 | 备注 |\r\n| :--------: | :-------------------------------: | :---: |\r\n| **ⅰ** | \\`music.gdstudio.xyz\\` (歌曲搜索) | 较高 |\r\n| **ⅱ** | \\`dev.iw233.cn\\` (音乐搜索器) | 中等 |\r\n| *......* | 其他 | 中等 |\r\n| **ⅳ** | \\`星之阁API\\` (下载音乐/酷狗音乐) | 较低 |\r\n\r\n---\r\n\r\n目前基本QQ音乐都死翘翘了 （腾讯太小气了\r\n\r\n\r\n---\r\n\r\n\r\n## 免责声明\r\n\r\n1. **数据来源**：\r\n - 本插件调用了第三方网站（如 `music.gdstudio.xyz`）的接口来获取音乐资源。插件开发者不对这些第三方网站的内容、合法性或安全性负责。\r\n - 用户在使用本插件时，应自行承担因使用第三方服务而产生的任何风险。\r\n\r\n2. **版权声明**：\r\n - 本插件提供的音乐资源可能受版权保护。用户应确保在使用这些资源时遵守相关法律法规。\r\n - 插件开发者不鼓励或支持任何侵犯版权的行为。用户应仅下载和使用已获得合法授权的音乐资源。\r\n\r\n3. **插件用途**：\r\n - 本插件仅供学习和研究使用，禁止用于任何商业用途。\r\n - 插件开发者不对用户因使用本插件而产生的任何法律问题负责。\r\n\r\n4. **服务稳定性**：\r\n - 由于依赖第三方服务，插件的功能可能会因第三方服务的变更或不可用而受到影响。\r\n - 插件开发者不保证插件的持续可用性或稳定性。\r\n\r\n5. **用户责任**：\r\n - 用户在使用本插件时，应遵守相关法律法规和平台规定。\r\n - 如因用户不当使用本插件而导致任何问题，插件开发者不承担任何责任。\r\n\r\n---\r\n\r\n\r\n\r\n\r\n### 更新日志\r\n\r\n- **1.7.23**：\r\n - 添加`网易点歌`的最大时长限制\r\n - 支持qq官方平台机器人发送下载链接\r\n\r\n- **1.7.20**：\r\n - 优化`generateResponse`调用方法\r\n - 修复command5的无下载链接的歌曲导致的无限等待\r\n - 新增合并转发模式 仅支持onebot平台\r\n - 优化项目说明\r\n\r\n- **1.7.17**：\r\n - 感谢`https://github.com/Onimaimai/nonebot-plugin-voicemusic/issues/10`提及的的API捏\r\n - 感谢`www.byfuns.top`\r\n - 新增网易点歌的直链获取后端。再也不是黑胶只能30秒啦~\r\n\r\n- **1.7.16**：\r\n - 取消龙珠点歌的QQ音乐API调用\r\n - 优化command8的传参和本地化使用\r\n - 修改readme内容\r\n\r\n- **1.7.15**：\r\n - 优化部分配置项说明\r\n - 整理优化结构\r\n - 声明支持多份配置\r\n - 为保持配置项统一稳定和简洁，暂不支持在同一个配置里 同时选择多个后端 注册多个指令\r\n - 修复`music.gdstudio.xyz`平台多弹窗的提示问题\r\n - 完善指令说明\r\n - 优化所有指令的具体实现\r\n - 通测确保正常\r\n - 取消字段的.hidden()\r\n - 优化说明内容\r\n\r\n- **1.7.14**：\r\n - 优化command6的请求逻辑\r\n - 使用更加稳定的网易云官方API\r\n - 优化封面返回清晰度\r\n - 仍然使用原来的后端作为语音后端\r\n - 优化使用说明\r\n - 优化本地化对指令的描述\r\n - 优化项目说明内容，新增对file类型的提示\r\n\r\n- **1.7.13**：\r\n - 优化command5等待逻辑\r\n - 修复command5QQ平台无限等待的bug\r\n - 完善匹配`没有找到相关的歌曲，请尝试更换关键词或平台。`的情况\r\n\r\n- **1.7.12**：\r\n - 优化之后感觉`music.gdstudio.xyz`最好用\r\n - 修改默认后端\r\n - 优化说明内容\r\n - 优化`music.gdstudio.xyz`监听\r\n - 优化等待时机\r\n - 优化匹配内容\r\n - 优化返回\r\n - ...\r\n\r\n- **1.7.9**：\r\n - 优化`music.gdstudio.xyz`的点歌逻辑\r\n - 改为网络监听而不是操作元素\r\n - 优化说明内容\r\n - 优化`music.gdstudio.xyz`菜单渲染逻辑\r\n - 修改`formatSongList`优化参数+1，允许自定义结束ID\r\n - 优化超时定时器的设置\r\n - 交互逻辑放到page.on的外面\r\n\r\n- **1.7.7**：\r\n - 增加龙珠API\r\n - 修复音质指定的bug\r\n - 修复中间件解析的command8的网易云卡片解析id比预期-10\r\n - 完善说明\r\n - 修改部分，忘了\r\n\r\n- **1.7.2**：\r\n - 优化配置项结构\r\n - 修改网易云ID点歌，改为搜索点歌\r\n - 优化配置项说明内容\r\n - 完善说明内容\r\n - 新增【选择使用的后端】\r\n - 优化command6对-n选项的支持\r\n\r\n- **1.6.15**：\r\n - 兼容QQ音乐新格式的卡片\r\n - 加强判断，优化小黑盒卡片判断\r\n - 修复网易云ID点歌的include报错\r\n - 修复【歌曲搜索】网页因为经验条的报错\r\n - 取消部分日志输出，改为调试模式输出\r\n\r\n- **1.6.10**：\r\n - 修复 command7 的数据持续监听逻辑问题（不关闭puppeteer）\r\n - 定位temp删不掉的问题（发现是onebot协议端 发不出去 retcode200，但是资源占用）\r\n\r\n- **1.6.9**：\r\n - 新增`音乐搜索器`点歌，支持酷狗+网易云（江苏好像不好访问，会江苏反诈）\r\n - 优化temp删除逻辑\r\n - 优化中间件解析，新增command6 的解析功能\r\n - 修复父级指令消失\r\n\r\n\r\n- **1.6.7**：\r\n - 优化temp删除逻辑\r\n - 按照指令层级注册指令\r\n\r\n- **1.6.6**：\r\n - 换key不能解决用完的问题，需要用户自己去申请\r\n - 新增网易云ID单曲点歌——command6\r\n - 新增file返回类型，支持temp保存，和定时删除\r\n - 修复 command5 截图元素获取不到大小的问题\r\n - 修复部分说明内容\r\n - 完善配置项类型选择的说明\r\n\r\n- **1.6.2**：\r\n - 更换APIKEY\r\n - 修复中间件监听解析对于command5的支持\r\n\r\n- **1.6.1**：本地化支持\r\n- **1.6.0**：新增对第三方网站 `music.gdstudio.xyz` 的支持，优化用户体验。\r\n- **1.5.10**：往期更新。","readmeFilename":"readme.md"}