Music Player Skill - Windows 音乐播放技能
支持 Windows 系统的音乐搜索、下载和播放技能。基于 go-music-api 和多个音乐源。
功能特性
- 🔍 多源搜索 - 支持网易云音乐等多个 API 源
- 📥 高清下载 - 自动获取最佳音质版本
- 🎧 本地播放 - 调用 Windows 默认播放器
- 📝 元数据嵌入 - 支持 ID3 标签（歌名、歌手、专辑、封面）
- 🎵 批量下载 - 支持下载多个版本
快速开始
1. 安装依赖
pip install requests mutagen python-pptx2. 搜索并下载音乐
# 基础下载
python download.py "歌曲名" "保存路径.mp3"
# 使用 go-music-api 源（推荐，音质更好）
python download_go_api.py
# 下载多个版本
python download_versions.py3. 播放音乐
python play_music.py "歌曲路径.mp3"4. 嵌入元数据
python embed_metadata.py "歌曲.mp3" "歌名" "歌手" "专辑" "封面.jpg"文件说明
| 文件 | 说明 |
|---|---|
download.py | 基础下载脚本（网易云 API） |
download_go_api.py | 使用 go-music-api 源（推荐） |
download_versions.py | 下载多个版本 |
search_and_download.py | 搜索并下载（旧版） |
play_music.py | 播放本地音乐 |
embed_metadata.py | 嵌入 ID3 元数据 |
SKILL.md | 技能说明文档 |
使用示例
示例 1：下载刘德华的《中国人》
python download_go_api.py "刘德华 中国人" "C:\\music\\刘德华 - 中国人.mp3"示例 2：下载 Enya 的《One by One》
python download.py "One by One Enya" "C:\\music\\Enya_One_by_One.mp3"示例 3：播放下载的音乐
python play_music.py "C:\\music\\Enya_One_by_One.mp3"API 源
技能支持以下音乐 API 源：
- 网易云音乐 - 基础源，稳定可靠
- go-music-api - 开源项目，音质更好
- UOMG API - 备用源
输出目录
默认下载到：C:\Users\Administrator\.openclaw\workspace\music\
注意事项
- ⚠️ 需要 Python 3.7+
- ⚠️ 需要网络连接来搜索和下载音乐
- ⚠️ 下载的音乐仅供个人学习使用
- ⚠️ 部分 API 可能需要代理访问
故障排除
下载失败
- 检查网络连接
- 尝试切换 API 源（使用
download_go_api.py） - 检查歌曲名称是否正确
无法播放
- 检查文件是否完整（文件大小 > 1MB）
- 尝试使用其他播放器打开
- 重新下载其他版本
元数据嵌入失败
- 确保安装了 mutagen：
pip install mutagen - 检查文件路径是否正确
- 确保 MP3 文件未被占用
更新日志
v1.1.0 (2026-03-24)
- ✅ 添加 go-music-api 支持
- ✅ 优化音质选择
- ✅ 添加多版本下载
- ✅ 改进错误处理
v1.0.0 (2026-03-24)
- ✅ 初始版本发布
- ✅ 支持网易云音乐 API
- ✅ 基础搜索和下载功能
- ✅ 本地播放支持
许可证
本技能仅供学习交流使用，请勿用于商业用途。
支持
如有问题，请提交 Issue 或联系作者。