基于ADB的本地Chromecast控制工具，支持YouTube/Tubi投屏与播放控制，需用户手动启用开发者模式配对，适合局域网内媒体自动化管理。
说明：
## 核心用法
本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调试权限较高，设备共享环境下需注意未授权访问风险
