music-player

搜索并播放音乐。从B站搜索歌曲、下载音频、用mpv播放器播放。支持缓存、队列、收藏、黑名单。当用户要求播放音乐、放歌、听歌时使用此skill。

install

source · Clone the upstream repo

git clone https://github.com/yu20103983/xiaolong-openclaw

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/yu20103983/xiaolong-openclaw "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/music-player" ~/.claude/skills/yu20103983-xiaolong-openclaw-music-player && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/yu20103983/xiaolong-openclaw "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/music-player" ~/.openclaw/skills/yu20103983-xiaolong-openclaw-music-player && rm -rf "$T"

manifest: skills/music-player/SKILL.md

source content

Music Player (mpv版)

搜索并播放音乐，从B站下载音频，使用mpv播放器播放。 mpv是命令行播放器，不弹窗、可精确控制进程。

依赖

yt-dlp:
```
pip install yt-dlp
```
mpv播放器: 已安装在
```
C:\Program Files\MPV Player\mpv.exe
```

使用方式

脚本路径：

skills/music-player/music_player.py

（相对于workspace）

基本播放

python skills/music-player/music_player.py play "歌曲名"
python skills/music-player/music_player.py play "歌手 歌名"
python skills/music-player/music_player.py stop
python skills/music-player/music_player.py status
python skills/music-player/music_player.py next

播放流程

用户说"播放xxx" →
```
play "xxx"
```
用户说"现在放的什么" →
```
status
```
用户说"停" →
```
stop
```
用户说"下一首" →
```
next
```
（需要队列中有歌）
用户说"不喜欢这首" →
```
status
```
获取歌名 →
```
dislike-song
```
→
```
stop
```
或
```
next
```

收藏管理

python skills/music-player/music_player.py fav-song "歌名" "歌手"
python skills/music-player/music_player.py unfav-song "歌名"
python skills/music-player/music_player.py fav-artist "歌手"
python skills/music-player/music_player.py unfav-artist "歌手"
python skills/music-player/music_player.py fav-list
python skills/music-player/music_player.py fav-play
python skills/music-player/music_player.py fav-play-artist "歌手"

播放队列

python skills/music-player/music_player.py queue-add "歌名" "歌手"
python skills/music-player/music_player.py queue-list
python skills/music-player/music_player.py queue-play [--wait]
python skills/music-player/music_player.py queue-clear
python skills/music-player/music_player.py queue-stop
python skills/music-player/music_player.py queue-skip

队列播放时自动跳过黑名单歌曲。

播放监控

python skills/music-player/music_player.py monitor-start
python skills/music-player/music_player.py monitor-stop

黑名单（不喜欢）

python skills/music-player/music_player.py dislike-song "歌名" "歌手"
python skills/music-player/music_player.py undislike-song "歌名"
python skills/music-player/music_player.py dislike-artist "歌手"
python skills/music-player/music_player.py undislike-artist "歌手"
python skills/music-player/music_player.py dislike-list

Python调用

import sys
sys.path.insert(0, "skills/music-player")
from music_player import (
    search_and_play, stop_playing, get_status, next_song,
    play_file, _is_player_running,
    fav_add_song, fav_remove_song, fav_list,
    fav_add_artist, fav_remove_artist,
    fav_play_random_song, fav_play_artist,
    is_disliked, dislike_song, dislike_artist, dislike_list,
    queue_add, queue_list, queue_play, queue_clear,
)

技术细节

播放器：mpv（
```
--no-video --really-quiet --no-terminal
```
）
mpv作为独立子进程运行，通过进程控制实现停止/状态检测
stop命令会terminate子进程 + taskkill确保清理
status通过检查mpv.exe进程判断是否在播放
音频缓存在
```
skills/music_cache/
```
，同一首歌不重复下载
收藏：
```
skills/music-player/favorites.json
```
黑名单：
```
skills/music-player/blacklist.json
```
队列：
```
skills/music-player/queue.json
```
播放状态：
```
skills/music-player/player_state.json
```
yt-dlp下载超时300秒