chromecast-with-google-tv

核心用法

本Skill是一个面向Chromecast with Google TV设备的ADB控制CLI工具，通过Python标准库实现与电视盒子的本地通信。用户需先在设备端启用开发者选项和无线调试，完成首次配对后即可通过命令行实现：YouTube视频直投（支持ID/URL/标题搜索）、Tubi剧集播放、第三方应用（Hulu/Max/Disney+等）的全局搜索回退播放，以及基础的播放/暂停/恢复控制。设备连接支持CLI参数、环境变量、本地缓存和mDNS自动发现四种方式，优先使用显式配置确保连接稳定性。

显著优点

1. 零Python依赖：纯标准库实现，通过uv运行规避PEP 668系统包限制，部署轻量
2. 多源内容聚合：原生支持YouTube（含标题转ID解析）和Tubi，其他平台通过Google TV全局搜索+UI自动化（scrcpy）实现扩展
3. 智能设备管理：自动缓存最后成功连接的设备信息，支持mDNS服务发现降低配置成本
4. 安全设计：无端口扫描行为，仅连接用户显式指定的端口，避免与Google ADB端口轮换机制冲突
5. 输入验证完善：YouTube ID正则校验、端口范围限制（1-65535）、IP格式检查等边界防护

潜在缺点与局限性

• 硬件门槛高：必须手动开启Chromecast开发者选项，对普通用户技术门槛较高
• 生态封闭性：YouTube/Tubi外的平台依赖全局搜索回退，需精确指定季/集参数，且Hulu等平台不支持自动选择用户配置
• 网络限制：仅支持局域网内控制，无法跨网络远程操作
• 外部工具链重：依赖adb、scrcpy、yt-api、uv四个独立二进制工具，安装维护成本较高
• 平台支持存疑：文档明确标注Google TV Streamer支持状态未知，Chromecast 4K为验证目标设备

适合的目标群体

• 智能家居自动化爱好者，希望将电视控制集成到脚本工作流
• 技术型用户，熟悉ADB调试和命令行操作
• 本地媒体中心搭建者，需要程序化控制Chromecast播放行为
• 开发者测试场景，需自动化验证TV端应用行为

使用风险

• 连接稳定性：无线调试端口可能因设备重启或设置变更而失效，需重新配对
• 依赖版本冲突：yt-api等工具若来源非官方渠道可能存在供应链风险
• UI自动化脆弱性：全局搜索回退依赖scrcpy模拟按键，Google TV界面更新可能导致脚本失效
• 权限管理：adb调试权限较高，设备共享环境下需注意未授权访问风险

核心用法

该Skill是一个CLI工具，通过ADB（Android Debug Bridge）协议与Chromecast with Google TV设备进行本地通信，实现视频投屏和媒体控制功能。

主要功能模块：

1. 设备配对 (pair)：首次使用时需开启Chromecast的开发者选项和无线调试，通过配对码完成ADB无线配对
2. 状态检查 (status)：显示ADB设备连接状态
3. 内容播放 (play)：支持三种播放模式：

4. 播放控制 (pause/resume)：发送系统级媒体控制命令

• YouTube：直接解析视频ID或URL，通过ADB intent启动YouTube TV版应用
• Tubi：通过HTTPS URL发送VIEW intent
• 全局搜索回退：针对Hulu、Max、Disney+等应用，使用scrcpy进行UI自动化操作

设备发现机制：优先使用显式参数或环境变量，其次读取.last_device.json缓存，最后通过mDNS自动发现局域网内设备。

显著优点

• 零依赖安全架构：纯Python标准库实现，无第三方pip包，供应链攻击面为零
• 本地化设计：所有通信通过本地ADB工具代理，无外发网络请求，隐私风险极低
• 多源内容支持：覆盖YouTube、Tubi及主流流媒体平台，通过UI自动化解决非标准API限制
• 智能缓存策略：自动保存最后成功连接的设备信息，平衡便利性与可控性
• 环境变量灵活配置：支持CHROMECAST_HOST/CHROMECAST_PORT覆盖，便于自动化脚本集成

潜在缺点与局限性

• 外部工具依赖：需预先安装adb、scrcpy、uv、yt-api四个二进制工具，安装流程较复杂
• 首次配置门槛高：需手动开启Chromecast开发者模式、无线调试，对非技术用户不友好
• UI自动化脆弱性：全局搜索回退依赖scrcpy进行屏幕操作，若Google TV界面更新可能导致流程中断
• Hulu特殊限制：明确不处理Hulu的profile选择逻辑，可能卡在登录后界面
• 端口动态性问题：ADB无线调试端口可能变化，需手动重新配对或更新配置
• Google TV Streamer兼容性未知：文档明确标注对新设备支持状态未验证

适合人群

• 技术型用户：熟悉ADB、命令行操作，有智能家居自动化需求
• 本地隐私优先者：拒绝云服务和外部API，希望所有控制流留在局域网内
• 多平台内容消费者：常跨YouTube、Tubi及Hulu/Max/Disney+观看内容，厌倦多遥控器切换
• 开发者/极客：希望将Chromecast集成到自定义工作流或脚本中

常规风险

• ADB安全风险：开启无线调试会降低设备安全边界，建议仅在可信局域网使用，不用时关闭开发者选项
• 工具链供应链风险：yt-api为第三方Go工具，建议审查其源代码后再使用
• 网络环境依赖：mDNS发现和设备通信均依赖稳定局域网，跨VLAN或复杂网络拓扑可能失效
• 缓存文件残留：.last_device.json存储设备IP/端口，虽无敏感信息，但在共享环境中建议定期清理