music-search - SKILL.md Agent Skill

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 准确