\r \r

🎵 Music Helper - 音乐助手\r

\r

触发规则\r

\r 关键词：\r

• 推荐歌曲、歌单推荐、听什么歌\r
• 网易云、QQ 音乐、酷狗\r
• 歌词、这首歌叫什么\r
• 歌手、专辑、MV\r \r 场景：\r
• 用户想听歌但不知道选什么\r
• 用户查询某首歌的信息\r
• 用户需要歌词\r
• 用户想找类似风格的音乐\r \r

功能描述\r

\r

核心功能\r

\r

1. 音乐推荐\r
   • 根据心情推荐（开心/难过/放松/运动）\r
   • 根据场景推荐（学习/工作/睡眠/运动）\r
   • 根据风格推荐（流行/摇滚/民谣/电子/古典）\r
   • 根据语种推荐（华语/欧美/日韩/粤语）\r \r
2. 音乐搜索\r
   • 歌曲搜索（歌名/歌词片段）\r
   • 歌手搜索\r
   • 专辑搜索\r
   • MV 搜索\r \r
3. 歌词获取\r
   • 实时歌词查询\r
   • 歌词翻译（中英/中日）\r
   • 歌词海报生成\r \r
4. 歌单管理\r
   • 创建个人歌单\r
   • 收藏喜欢的歌曲\r
   • 每日推荐\r \r

推荐维度\r

\r

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

权限需求\r

\r

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

数据源\r

\r

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

示例对话\r

\r

用户：推荐几首好听的歌\r
助手：你想听什么风格的？流行、摇滚、民谣还是电子？或者告诉我你现在的心情/场景~\r
\r
用户：学习的时候听什么\r
助手：推荐这 5 首适合学习的纯音乐：\r
1. 《Summer》- 久石让 ⭐4.9 - 轻快治愈\r
2. 《雨的印记》- 李闰珉 ⭐4.8 - 安静钢琴\r
3. 《卡农》- 帕赫贝尔 ⭐4.9 - 经典古典\r
4. 《风居住的街道》- 矶村由纪子 ⭐4.8 - 二胡钢琴\r
5. 《神秘园之歌》- Secret Garden ⭐4.7 - 新世纪音乐\r
\r
用户：查一下《晴天》的歌词\r
助手：《晴天》- 周杰伦\r
📀 专辑：《叶惠美》(2003)\r
⭐ 评分：9.8\r
\r
故事的小黄花 从出生那年就飘着\r
童年的荡秋千 随记忆一直晃到现在\r
...\r
\r
用户：推荐类似周杰伦的歌\r
助手：基于周杰伦的 R&B/中国风风格，推荐：\r
1. 林俊杰 - 《江南》《不为谁而作的歌》\r
2. 王力宏 - 《花田错》《大城小爱》\r
3. 陶喆 - 《爱很简单》《小镇姑娘》\r
4. 方大同 - 《Love Song》《特别的人》\r
```\r
\r
## 数据存储\r
\r
```json\r
// ~/.openclaw/workspace/music-helper/favorites.json\r
{\r
  "favorite_songs": [\r
    {\r
      "title": "晴天",\r
      "artist": "周杰伦",\r
      "added_date": "2026-03-16",\r
      "play_count": 42\r
    }\r
  ],\r
  "playlists": [\r
    {\r
      "name": "学习专用",\r
      "songs": ["Summer", "雨的印记", "卡农"]\r
    }\r
  ]\r
}\r
```\r
\r
## 待办事项\r
\r
- [ ] 实现网易云音乐 API 对接\r
- [ ] 实现歌词爬取\r
- [ ] 创建歌单存储\r
- [ ] 添加推荐算法\r
- [ ] 测试搜索准确性\r
\r
---\r
\r
**版本：** 1.0.0\r
**创建日期：** 2026-03-16\r
**作者：** 小鬼 👻\r