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调试权限较高，设备共享环境下需注意未授权访问风险