| name | music-search |
| description | 搜索和播放音乐 / Search & play music. 当用户想要：(1) 随机点一首歌/随机推荐一首歌/帮我放首歌 (2) 搜索某首歌曲/点播指定歌曲/播放某个歌手的歌 (3) 获取歌曲播放链接或封面 (4) 在网易云/酷狗/酷我/汽水/QQ音乐等平台查找音乐时使用。Use when user wants to: randomly recommend or play a song, search for a song by name/artist, play specific music, get play URL or cover image from NetEase/KuGou/KuWo/QiShui/QQ Music. |
| metadata | {"requires":{"bins":["python3"],"env":[]},"emoji":"🎵"} |
Music Search Skill
搜索并在微信播放音乐的技能。
支持平台
| 平台 | 标识符 | 说明 |
|---|
| 网易云音乐 | netease | 曲库丰富，最稳定（首选） |
| 酷狗音乐 | kugou | 流行/主流歌曲丰富 |
| 酷我音乐 | kuwo | 冷门歌曲备选 |
| 汽水音乐 | qishui | 字节跳动旗下 |
| QQ音乐 | qq | 腾讯曲库 |
⚠️ 核心规则（必须严格遵守）
你的职责只有一件事：调用脚本获取音乐数据，然后原样透传 JSON 字段。
- ❌ 绝对禁止：自己生成或拼接任何 XML 代码
- ❌ 绝对禁止：输出
MUSIC_CARD: 前缀的内容
- ❌ 绝对禁止：从记忆中"回忆" XML 结构
- ✅ 只允许：输出
MUSIC_PLAY:{json} 格式
XML 由系统底层代码负责构建，你不需要也不应该处理 XML。
执行流程（严格遵循）
第一步：调用脚本获取音乐数据
随机点歌（用户说"随机点一首/帮我放首歌/随机推荐"）：
python3 "/root/dow-ipad-859/workspace/skills/music-search/scripts/search_music.py" random netease
搜索歌曲列表（用户想先看搜索结果再选）：
python3 "/root/dow-ipad-859/workspace/skills/music-search/scripts/search_music.py" search netease "歌曲名"
获取指定歌曲详情（用户已知歌名，或从搜索列表中选择）：
python3 "/root/dow-ipad-859/workspace/skills/music-search/scripts/search_music.py" detail netease "歌曲名" 1
若网易云失败，依次尝试：kugou → kuwo → qishui → qq
第二步：输出 MUSIC_PLAY 格式（仅此格式，不得更改）
脚本会返回如下 JSON：
{"ok": true, "title": "歌曲名", "singer": "歌手", "music_url": "http://...", "thumb_url": "https://...", "platform": "netease", "source": "网易云音乐"}
你的任务：将脚本返回的 JSON 原样填入下面格式并输出：
MUSIC_PLAY:{"title":"<title的值>","singer":"<singer的值>","music_url":"<music_url的值>","thumb_url":"<thumb_url的值>","platform":"<platform的值>","source":"<source的值>"}
规则：
- 直接从脚本输出取值填入，不得修改任何字段内容
- 不要添加任何说明文字（如"正在为你播放..."）
- 不要用 markdown 代码块包裹
MUSIC_PLAY: 后直接跟 JSON，不允许换行
第三步（仅搜索列表时）：用户选择后播放
如果用户使用了 search 命令获得歌曲列表，展示结果后让用户选择序号，再执行：
python3 "/root/dow-ipad-859/workspace/skills/music-search/scripts/search_music.py" detail netease "歌曲名" <用户选择的序号>
然后同样输出 MUSIC_PLAY:{json} 格式。
完整示例
随机点歌
用户输入：随机点一首歌
- 执行脚本：
python3 "/root/dow-ipad-859/workspace/skills/music-search/scripts/search_music.py" random netease
- 脚本返回：
{"ok": true, "title": "晴天", "singer": "周杰伦", "music_url": "http://music.163.com/song/media/outer/url?id=186001", "thumb_url": "https://p2.music.126.net/xxx.jpg", "platform": "netease", "source": "网易云音乐"}
- 你只需输出（不要有其他文字）：
MUSIC_PLAY:{"title":"晴天","singer":"周杰伦","music_url":"http://music.163.com/song/media/outer/url?id=186001","thumb_url":"https://p2.music.126.net/xxx.jpg","platform":"netease","source":"网易云音乐"}
搜索指定歌曲
用户输入：帮我搜索周杰伦的七里香
- 执行搜索：
python3 "/root/dow-ipad-859/workspace/skills/music-search/scripts/search_music.py" search netease "七里香"
-
展示搜索结果列表给用户，等待用户选择编号
-
用户选择后执行详情：
python3 "/root/dow-ipad-859/workspace/skills/music-search/scripts/search_music.py" detail netease "七里香" 1
- 输出
MUSIC_PLAY:{json} 格式
错误处理
| 情况 | 处理方式 |
|---|
脚本返回 {"error": ...} | 切换平台重试（netease → kugou → kuwo） |
脚本返回的 JSON 缺少 ok:true | 视为失败，切换平台 |
| 所有平台均失败 | 告知用户"暂时无法获取音乐，请稍后再试" |
技术说明
为什么使用 MUSIC_PLAY:{json} 而不是直接输出 XML？
- LLM 不适合生成精确的 XML（标签容易拼错、遗漏或变形）
- XML 由系统底层
_build_music_xml() 函数用代码模板生成，确保 100% 格式正确
- LLM 只需提取 5 个简单字段，出错概率极低
- 即使从记忆中生成（未调用脚本），简单 JSON 也远比 XML 准确
