SuperAPI AI 工具集

yt-music

通用与其它

查看项目

更新于 10-16 06:21

技能介绍

用途:通过自然语言操作 YouTube Music,完成搜索、浏览个人库、管理播放列表、查看歌词与排行榜、评分以及控制播放。

主要能力:helper.py 负责搜索、库、播放列表、歌词、评分和账户;player.py 负责播放客户端与守护进程管理;player_daemon.py 是持久 Playwright 浏览器守护进程。运行时状态保存在 ./.yt-music/,播放使用 ./.yt-music/playwright-profile 专用浏览器配置。

使用方式:从技能根目录运行脚本。搜索示例:uv run --with yt-musicapi python scripts/helper.py search "<query>" --type songs --limit 5。播放前可启动守护进程:uv run --with playwright python scripts/player.py daemon-start,再用 open <videoId>、play、pause、next、prev、status、volume、seek 等命令控制。多步骤流程应路由到 Workflows/Setup.md、PlayDiscover.md、BuildPlaylist.md、DiagnoseAuth.md、RunTests.md。

认证:访问库、播放列表、账户、上传或完整播放前需先运行 auth check。缺失时需用户提供完整 Cookie 请求头或 cookies JSON 文件路径,再执行 auth setup。

限制:Cookie 会静默过期;首次守护进程启动可能因自动播放策略被阻止,需在窗口内手动点击一次播放;崩溃后可能需删除 SingletonLock;playlist add-playlist 需源播放列表所有权或访问权限;get_album 需 browse ID;charts --country ZZ 表示全球;related 可能为空。缺失事实暂未提供。