本地Chromecast智能投屏控制器

基于ADB的本地Chromecast控制工具，支持YouTube/Tubi投屏与播放控制，需用户手动启用开发者模式配对，适合局域网内媒体自动化管理。

基本信息

• 技能名称?chromecast-with-google-tv
• 中文名称?本地Chromecast智能投屏控制器
• 作者?antgly
• 分类?效率
• 版本?v1.2.0
• 标签?automation, content-media, development-engineering, productivity

使用方法

使用说明
核心用法
本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调试权限较高，设备共享环境下需注意未授权访问风险