music-helper（音乐帮手）

🎵 Music Helper - 音乐助手

触发规则

关键词：

• 推荐歌曲、歌单推荐、听什么歌
• 网易云、QQ 音乐、酷狗
• 歌词、这首歌叫什么
• 歌手、专辑、MV

场景：

• 用户想听歌但不知道选什么
• 用户查询某首歌的信息
• 用户需要歌词
• 用户想找类似风格的音乐

功能描述

核心功能

1. 音乐推荐

- 根据心情推荐（开心/难过/放松/运动） - 根据场景推荐（学习/工作/睡眠/运动） - 根据风格推荐（流行/摇滚/民谣/电子/古典） - 根据语种推荐（华语/欧美/日韩/粤语）

1. 音乐搜索

- 歌曲搜索（歌名/歌词片段） - 歌手搜索 - 专辑搜索 - MV 搜索

1. 歌词获取

- 实时歌词查询 - 歌词翻译（中英/中日） - 歌词海报生成

1. 歌单管理

- 创建个人歌单 - 收藏喜欢的歌曲 - 每日推荐

推荐维度

• 🎵 风格：流行、摇滚、民谣、电子、嘻哈、R&B、古典、爵士
• 😊 心情：开心、难过、放松、兴奋、治愈、emo
• 🎯 场景：学习、工作、睡眠、运动、通勤、派对
• 🌍 语种：华语、欧美、日韩、粤语、泰语
• 📅 年代：2020s、2010s、经典老歌

权限需求

• [x] 网络访问（音乐平台 API）
• [x] 文件读写（歌单存储）
• [ ] 外部 API（网易云/QQ 音乐）

数据源

• 网易云音乐（主）
• QQ 音乐（备用）
• 酷狗音乐（备用）
• 歌词网（歌词）

示例对话

用户：推荐几首好听的歌
助手：你想听什么风格的？流行、摇滚、民谣还是电子？或者告诉我你现在的心情/场景~

用户：学习的时候听什么
助手：推荐这 5 首适合学习的纯音乐：
1. 《Summer》- 久石让 ⭐4.9 - 轻快治愈
2. 《雨的印记》- 李闰珉 ⭐4.8 - 安静钢琴
3. 《卡农》- 帕赫贝尔 ⭐4.9 - 经典古典
4. 《风居住的街道》- 矶村由纪子 ⭐4.8 - 二胡钢琴
5. 《神秘园之歌》- Secret Garden ⭐4.7 - 新世纪音乐

用户：查一下《晴天》的歌词
助手：《晴天》- 周杰伦
📀 专辑：《叶惠美》(2003)
⭐ 评分：9.8

故事的小黄花 从出生那年就飘着
童年的荡秋千 随记忆一直晃到现在
...

用户：推荐类似周杰伦的歌
助手：基于周杰伦的 R&B/中国风风格，推荐：
1. 林俊杰 - 《江南》《不为谁而作的歌》
2. 王力宏 - 《花田错》《大城小爱》
3. 陶喆 - 《爱很简单》《小镇姑娘》
4. 方大同 - 《Love Song》《特别的人》

数据存储

// ~/.openclaw/workspace/music-helper/favorites.json
{
  "favorite_songs": [
    {
      "title": "晴天",
      "artist": "周杰伦",
      "added_date": "2026-03-16",
      "play_count": 42
    }
  ],
  "playlists": [
    {
      "name": "学习专用",
      "songs": ["Summer", "雨的印记", "卡农"]
    }
  ]
}

待办事项

• [ ] 实现网易云音乐 API 对接
• [ ] 实现歌词爬取
• [ ] 创建歌单存储
• [ ] 添加推荐算法
• [ ] 测试搜索准确性

版本： 1.0.0 创建日期： 2026-03-16 作者： 小鬼 👻