✨ 介绍

• 一个轻量级 AstrBot 插件，支持通过自然语言让 AI 自动为你在 QQ 中点播网易云音乐。
• 利用 LLM 工具调用能力，智能识别歌名与歌手，自动搜索并发送官方音乐卡片。
• 特别优化海外用户支持：可配置 HTTP/SOCKS 代理绕过地域限制。

⚠️ 注意：本插件仅在 QQ 平台生效（需配合 NapCat/QQNT 协议端），其他平台将返回友好提示。

⌨️ 使用说明

• 直接使用自然语言点歌，例如：
  • “我想听孙燕姿的绿光”
  • “我想听稻香”
• AI 会自动调用工具，搜索网易云音乐，并在 QQ 聊天中发送官方音乐卡片（带封面、播放按钮）。

🌍 海外用户必看

• 如果你部署在海外服务器，可能会遇到“找不到歌曲”或返回加密数据的问题。

• 解决方案：在插件配置中填写中国大陆的代理地址（HTTP 或 SOCKS）。

• 支持格式示例：

  • http://1.2.3.4:8080
  • http://user:pass@1.2.3.4:8080
  • socks5://1.2.3.4:1080

• 使用 SOCKS 代理需额外安装依赖：

pip install aiohttp-socks

📌 效果

📦 安装

• 推荐方式：在 AstrBot 的插件市场中搜索 astrbot_plugin_NetEaseCloud_Music，点击安装并等待完成。
• 手动安装：下载 ZIP 文件，在 AstrBot 管理界面中通过“本地压缩包”方式上传安装。

📝 版本变更履历

🔗 相关链接

• 机器人框架：AstrBot 官方文档
• 客户端使用：Napcat 官方文档

👥 贡献指南

• ⭐️  Star 这个项目！（点右上角的星星，感谢支持！）
• 🐞  提交 Issue 报告问题
• 🔧  提交 Pull Request 改进代码
• 🧠  提出新功能建议