核心用法
my-play-music-from-yt 是一项基于 Playwright CLI 浏览器自动化 的音乐播放技能，通过在本地启动可见浏览器（--headed）并连接 YouTube 实现以下功能：
| 功能 | 说明 |
|------|------|
| **单曲播放** | 指定歌名+艺人，自动搜索并播放官方 MV 或音频版本 |
| **艺人歌单** | 搜索艺人名，优先选择 YouTube 自动生成的「Mix」歌单实现连续播放 |
| **情绪/场景音乐** | 支持「放松冥想音乐」「60 年代华语老歌」等描述性查询 |
| **播放控制** | 暂停、继续、下一首、上一首、跳过广告、静音、全屏 |
| **语音纠错** | 自动处理语音识别转写错误（如「楊成林」→「楊丞琳」） |
技术实现要点
- 命名会话：固定使用
-s=music_player保持状态 - 持久化配置：
--persistent保存登录态，避免每次重登 - 快照-引用-操作：严格遵循
snapshot → ref(e123) → click/fill模式，禁止 CSS/XPath 猜测 - 后台运行：开始播放后不阻塞，用户可继续对话
---
显著优点
1. 零 API 依赖：不依赖 YouTube Data API 或音乐平台会员，完全免费
2. 曲库覆盖极广：YouTube 音乐库远超任何单一流媒体平台
3. 自动广告跳过：内置广告检测与跳过逻辑，Premium 用户可无广告
4. 跨语言支持：原生支持中文、英文、日文等多语言搜索
5. 持久登录态：一次登录后长期有效，支持个性化推荐歌单
---
潜在缺点与局限性
| 问题 | 说明 |
|------|------|
| **需本地运行 Playwright** | 依赖 `playwright-cli` 二进制文件，无法纯云端部署 |
| **macOS 权限门槛** | 首次使用需用户手动授权「屏幕录制」「自动化」「辅助功能」 |
| **浏览器资源占用** | 需持续运行 Chromium/Firefox 进程，内存占用 300-800MB |
| **广告不可避免** | 非 Premium 用户需等待或手动跳过广告，体验打折 |
| **UI 变更风险** | YouTube 前端更新可能导致选择器失效，需维护快照逻辑 |
| **无音频流直取** | 无法提取纯音频 URL，必须通过浏览器播放 |
---
适合人群
- 本地 AI 助手用户：使用 OpenClaw 等框架，具备本地命令执行环境
- YouTube Premium 订阅者：可获得近似 Spotify 的无广告体验
- 多语言音乐爱好者：需要中文、日文、小众曲库的用户
- 隐私敏感用户：不愿绑定 Spotify/Apple Music 账号，偏好匿名播放
---
常规风险
- Google 账号安全：建议仅登录非主账号，或保持匿名使用
- 自动化检测：长期高频操作可能触发 YouTube 反 bot 机制，建议间隔 5 秒以上操作
- 会话泄漏：持久化浏览器数据存储于本地磁盘，共享设备需注意隐私清理
- 版权合规：个人使用合法，公开分发或商业用途需遵守当地版权法规