my-play-music-from-yt

核心用法

my-play-music-from-yt 是一款通过浏览器自动化实现 YouTube 音乐播放的 Skill。它采用 snapshot → ref → action 的精确交互模式，使用 playwright-cli 控制可见浏览器完成搜索、播放、控制全流程。用户可通过自然语言指令播放特定歌曲、艺术家歌单、流派音乐或情绪歌单，同时支持播放控制（暂停、继续、下一首、跳过广告等）。该 Skill 特别设计了语音转录纠错机制，无需用户确认即可自动处理可能的听写错误。

显著优点

1. 交互可靠性高：摒弃脆弱的 CSS/XPath 选择器，采用基于快照的 ref 定位，大幅降低页面结构变化导致的失效风险
2. 透明可控：默认使用 --headed 可见模式，所有浏览器操作对用户可见，配合 --persistent 持久化配置实现登录状态保留
3. 完善的容错机制：涵盖 session 冻结恢复、广告处理循环（最多4次迭代）、视频不可用回退、页面空白重载等 10 余种边缘场景
4. 智能搜索策略：根据用户意图（特定歌曲/艺术家/流派/年代）自动构建最优查询，优先选择 Mix、长时长歌单等连续播放内容
5. 语音纠错能力：利用 YouTube 内置自动纠错处理 ASR 转录错误，减少交互摩擦

潜在缺点与局限性

1. 平台依赖限制：需安装 playwright-cli 外部依赖，且 MacOS 需手动授权屏幕录制、自动化、辅助功能三项系统权限
2. GUI 环境要求：必须运行在带图形界面的环境，无法部署于无头服务器
3. 服务条款风险：浏览器自动化可能触及 YouTube 服务条款边界，不适合高频批量操作
4. 广告处理延迟：非跳过广告需等待 5 秒轮询，连续广告场景下用户体验存在中断
5. 区域内容差异：YouTube 地区限制可能导致部分搜索结果不可用

适合的目标群体

• 桌面端用户寻求语音/文本驱动的便捷音乐播放体验
• 需要跨会话保留 YouTube 登录状态（Premium 免广告等）的个人用户
• 对浏览器自动化透明度有要求、希望看到操作过程的安全敏感型用户
• 中文/多语言音乐爱好者（支持原语言搜索优化）

使用风险

• 性能风险：浏览器进程占用内存较高，长时后台运行可能影响系统资源
• 依赖风险：playwright-cli 版本更新可能引入行为变更，建议锁定版本
• 数据残留风险：持久化 profile 存储登录凭证，共享设备需定期执行 delete-data 清理
• 合规风险：需自行评估与 YouTube ToS 的兼容性，避免商业或高频自动化场景

核心用法

my-play-music-from-yt 是一款基于 Playwright 浏览器自动化的 YouTube 音乐播放 Skill。用户可通过自然语言指令实现：单曲点播、艺人歌单播放、流派/ mood 音乐搜索，以及完整的播放控制（暂停、继续、下一首、跳过广告等）。

工作流程：建立命名会话 (-s=music_player) → 快照获取页面元素 → 基于 ref 的精准交互 → 后台持续播放。核心依赖 playwright-cli 工具，所有操作强制使用 --headed 可视模式，确保透明可控。

显著优点

1. 功能覆盖全面：支持从特定歌曲、艺人合集到情绪流派（如"relaxing spa music"）的多种搜索模式，内置语音转写错误自动纠正逻辑，无需用户反复确认。

2. 交互模式稳健：采用"快照→ref→动作"的严格模式，拒绝 CSS/XPath 猜测，配合强制 snapshot 前置步骤，显著降低页面变动导致的失败率。

3. 会话持久化：--persistent 标志保存浏览器 profile（cookies、登录状态），跨会话免重复登录，同时提供 delete-data 清理机制。

4. 广告处理自动化：内置广告检测循环，支持跳过按钮点击、非跳过广告等待（5秒轮询）、连续多广告识别，提升使用体验。

潜在缺点与局限性

• 平台依赖性强：YouTube 页面结构变更可能导致元素 ref 失效，需维护者持续更新选择器逻辑。
• 网络与隐私暴露：搜索查询和播放行为直接发送至 YouTube/Google，受平台服务条款与广告体系约束；无法规避 YouTube Premium 弹窗以外的商业化内容。
• 本地资源占用：持久化浏览器 profile 占用磁盘空间，且需要用户授权 macOS 屏幕录制/自动化权限（Windows/Linux 无此限制）。
• 非 headless 限制：强制可视模式意味着无法在无 GUI 环境（如纯服务器）运行。

适合人群

• 偏好自然语言控制音乐播放的桌面用户
• 需要播放 YouTube 独家内容（现场版、MV、用户上传）的听众
• 能接受可视化浏览器自动化、对隐私敏感度适中的用户

常规风险

| 风险类型 | 说明 |

|---------|------|

| 隐私数据外流 | 搜索关键词、播放记录由 YouTube/Google 收集 |

| 广告内容暴露 | 可能遇到视频前插/插播广告（可自动跳过） |

| 持久化数据残留 | 浏览器 profile 本地存储，需手动 `delete-data` 清理 |

| 外部服务依赖 | YouTube 宕机或地域限制将直接影响功能 |