核心用法
play-music 技能利用 playwright-cli 驱动可见浏览器,直接在 YouTube 上完成音乐搜索与播放。用户可通过自然语言指令实现四大类操作:(1) 播放特定歌曲(如 "Money Money Money by ABBA");(2) 播放某位艺术家的歌曲合集或混音;(3) 按风格或情绪播放音乐(如 "relaxing spa music");(4) 控制播放——暂停、恢复、下一首、跳过广告、切歌、关闭播放器。
技能采用命名会话模式(-s=music_player)保持浏览器后台运行,播放开始后立即释放控制权,不阻塞其他任务。搜索策略智能:特定歌曲用 "Artist + Title",艺术家用纯名称触发 YouTube "Mix",风格/年代用描述词加 "playlist"。针对语音输入错误,技能依赖 YouTube 自动纠错,无需用户二次确认。
关键流程:检查/创建会话 → 截图定位搜索框 → 填入关键词 → 截图选结果 → 处理广告(最多4轮检测,支持多语言跳过按钮) → 确认播放。广告处理是核心环节,需识别 "Skip" / "略過" 等变体,并注意 YouTube 常连播两则广告。
显著优点
1. 零配置门槛:无需 YouTube API 密钥、OAuth 或账号登录,即开即用。
2. 真实浏览器环境:规避反爬虫机制,播放稳定性高于纯 API 方案。
3. 智能容错:自动处理语音转录错误、Cookie 弹窗、Premium 试用提示、视频失效等边缘场景。
4. 后台独立运行:会话持久化,用户可随时关闭终端而不中断音乐。
5. 多语言支持:针对华语用户优化,支持繁简体及年代/风格描述。
潜在缺点与局限性
1. 依赖外部二进制:需预装 playwright-cli,且浏览器占用内存显著(Chromium 实例)。
2. 广告不可完全消除:非 Premium 用户仍需手动跳过或等待广告,体验偶发中断。
3. 界面耦合脆弱:YouTube DOM 变更可能导致元素识别失效,需维护 youtube-guide.md 参考文档。
4. 网络与地域限制:受 YouTube 区域版权限制,部分歌曲可能无法播放。
5. 无播放队列可视化:相比原生音乐 App,用户无法直观查看待播列表。
适合人群
- 语音助手用户:希望通过自然语言快速点歌,容忍偶尔的广告中断。
- 轻量音乐需求者:不想安装 Spotify/Apple Music,或临时播放特定 YouTube 资源。
- 多语言音乐爱好者:常搜索华语、日语等非英语曲目,依赖 YouTube 纠错能力。
常规风险
- 隐私暴露:浏览器会话可能保留 Cookie 和登录状态,共享环境需注意隔离。
- 资源占用:长时间后台运行消耗 CPU/内存,建议任务结束后执行
close清理。 - 自动化检测:虽使用真实浏览器,但高频操作仍有极低概率触发 YouTube 临时限速。