Music Player Skill - Windows 音乐播放技能#

支持 Windows 系统的音乐搜索、下载和播放技能。基于 go-music-api 和多个音乐源。

功能特性#

• 🔍 多源搜索 - 支持网易云音乐等多个 API 源
• 📥 高清下载 - 自动获取最佳音质版本
• 🎧 本地播放 - 调用 Windows 默认播放器
• 📝 元数据嵌入 - 支持 ID3 标签（歌名、歌手、专辑、封面）
• 🎵 批量下载 - 支持下载多个版本

快速开始#

1. 安装依赖#

bash

pip install requests mutagen python-pptx

2. 搜索并下载音乐#

bash

# 基础下载
python download.py "歌曲名" "保存路径.mp3"

# 使用 go-music-api 源（推荐，音质更好）
python download_go_api.py

# 下载多个版本
python download_versions.py

3. 播放音乐#

bash

python play_music.py "歌曲路径.mp3"

4. 嵌入元数据#

bash

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：下载刘德华的《中国人》#

bash

python download_go_api.py "刘德华 中国人" "C:\\music\\刘德华 - 中国人.mp3"

示例 2：下载 Enya 的《One by One》#

bash

python download.py "One by One Enya" "C:\\music\\Enya_One_by_One.mp3"

示例 3：播放下载的音乐#

bash

python play_music.py "C:\\music\\Enya_One_by_One.mp3"

API 源#

技能支持以下音乐 API 源：

1. 网易云音乐 - 基础源，稳定可靠
2. go-music-api - 开源项目，音质更好
3. UOMG API - 备用源

输出目录#

默认下载到： C:\Users\Administrator\.openclaw\workspace\music\

注意事项#

• ⚠️ 需要 Python 3.7+
• ⚠️ 需要网络连接来搜索和下载音乐
• ⚠️ 下载的音乐仅供个人学习使用
• ⚠️ 部分 API 可能需要代理访问

故障排除#

下载失败#

1. 检查网络连接
2. 尝试切换 API 源（使用 download_go_api.py）
3. 检查歌曲名称是否正确

无法播放#

1. 检查文件是否完整（文件大小 > 1MB）
2. 尝试使用其他播放器打开
3. 重新下载其他版本

元数据嵌入失败#

1. 确保安装了 mutagen： pip install mutagen
2. 检查文件路径是否正确
3. 确保 MP3 文件未被占用

更新日志#

v1.1.0 (2026-03-24)#

• ✅ 添加 go-music-api 支持
• ✅ 优化音质选择
• ✅ 添加多版本下载
• ✅ 改进错误处理

v1.0.0 (2026-03-24)#

• ✅ 初始版本发布
• ✅ 支持网易云音乐 API
• ✅ 基础搜索和下载功能
• ✅ 本地播放支持

许可证#

本技能仅供学习交流使用，请勿用于商业用途。

支持#

如有问题，请提交 Issue 或联系作者。