📦 Music Player for Windows — Windows音乐播放器
v1.1.0在 Windows 上聚合多家音乐 API，实现搜索、高品质下载、ID3 元数据写入与本地播放的一站式音乐工具。
0· 98·3 当前·3 累计
by @freebook8下载技能包
最后更新
2026/3/24
安全扫描
OpenClaw
安全
high confidence该技能的代码和说明与其声明功能（搜索、下载、嵌入元数据、本地播放）基本一致，仅存在轻微不一致和对第三方 API 的依赖；整个包内未发现隐蔽数据外泄或与功能无关的权限请求。
评估建议
该技能似乎确实如其所述：通过公开 API 搜索音乐、下载 MP3、嵌入 ID3 标签并在默认播放器中打开。安装或运行前请注意：1）在隔离环境（VM）中审查并运行脚本，因为它们会从外部服务器下载内容。2）确认所用第三方 API 端点（music-api.caorushizi.cn、api.uomg.com）值得信赖；这些端点必须接收请求且可能记录日志。3）下载音乐时请注意版权/法律问题——代码未强制验证许可。4）文档提到安装 python-pptx，但代码中未使用，可省略该依赖。5）PUBLISH_GUIDE 建议执行 'clawhub login'——切勿向陌生服务粘贴凭据；仅向您信任的平台进行身份验证。如需更高保障，请向作者索取源码仓库或在沙箱中运行安全审查后再授予网络或文件系统访问权限。...详细分析 ▾
✓ 用途与能力
名称/描述（音乐搜索、下载、元数据、Windows 播放）与包含的 Python 脚本（搜索/下载变体、元数据嵌入、play_music）一致。对音乐 API（网易云/go-music-api/UOMG）的网络访问已存在且与声明功能相符。
ℹ 指令范围
SKILL.md 仅指示预期操作（安装 Python 库、运行提供的脚本）。未尝试读取无关系统文件或请求机密。范围轻微异常：推荐安装“python-pptx”但代码未引用；PUBLISH_GUIDE 记录运行“clawhub login”（用户输入凭据）但未自动登录。默认下载路径使用管理员工作区路径，这是实现选择而非窃取机密行为。
✓ 安装机制
没有下载任意可执行文件或压缩包的安装脚本；整个包以 Python 源码脚本和文档形式交付。依赖为常规 Python 包（requests、mutagen）。未发现远程安装 URL、URL 缩短器或解压步骤。
✓ 凭证需求
技能未声明所需环境变量或凭据。代码亦未访问环境变量或其他凭据。它对公开音乐 API 进行网络调用，这与功能相称。注意：对第三方 API 端点（如 music-api.caorushizi.cn、api.uomg.com）的依赖意味着请求将发往外部服务器——属预期行为，但需验证其可信度。
✓ 持久化与权限
always:false，安装时未更改其他技能或系统级设置。技能将下载的 MP3 文件写入本地工作区路径（下载器预期行为），未持久化高权限或更改其他技能配置。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.1.02026/3/24
新增 go-music-api 支持，提升音质，修复 Windows 兼容性
● 可疑
安装命令
点击复制官方npx clawhub@latest install music-player
镜像加速npx clawhub@latest install music-player --registry https://cn.longxiaskill.com
技能文档
音乐播放技能
支持 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 源：
- 网易云音乐 – 基础源，稳定可靠
- 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
- ✅ 基础搜索和下载功能
- ✅ 本地播放支持