名称： ytmusic-librarian
描述： 通过 ytmusicapi 管理 YouTube Music 曲库、播放列表及音乐发现。

YTMusic 曲库管理器

本技能使用 ytmusicapi Python 库与 YouTube Music 进行交互。

前置条件

• Python 3.x
• ytmusicapi 包：pip install ytmusicapi
• 技能文件夹中需包含认证文件（oauth.json 或 browser.json）。

设置步骤

1. 安装库：
   bash pip install ytmusicapi

2. 生成认证文件（“cURL 握手”方法）：
   - 打开 Microsoft Edge 并访问 music.youtube.com（确保已登录）。
   - 按 F12 打开开发者工具，切换到 网络（Network） 标签页。
   - 在页面点击 个人头像 -> 媒体库（Library）。
   - 在网络请求列表中查找名为 browse 的请求。
   - 右键点击 browse 请求 -> 复制 -> 复制为 cURL（bash）。
   - 将复制的 cURL 命令粘贴到技能文件夹中的 headers.txt 文件内。
   - 运行以下 Python 代码片段生成 browser.json：
   python from ytmusicapi.auth.browser import setup_browser with open('headers.txt', 'r') as f: setup_browser('browser.json', f.read())
   - 确保 browser.json 位于技能文件夹中。

3. 验证配置：
   bash python -c "from ytmusicapi import YTMusic; yt = YTMusic('browser.json'); print(yt.get_library_songs(limit=1))"

工作流程

曲库管理

• 列出歌曲/专辑：yt.get_library_songs()、yt.get_library_albums()
• 添加/移除：yt.rate_song(videoId, 'LIKE')、yt.edit_song_library_status(feedbackToken)

播放列表管理

• 创建：yt.create_playlist(title, description)
• 添加曲目：yt.add_playlist_items(playlistId, [videoIds])
• 移除曲目：yt.remove_playlist_items(playlistId, [videoIds])

元数据与发现

• 获取歌词：yt.get_lyrics(browseId)
• 获取相关推荐：yt.get_watch_playlist(videoId) -> related