Chromecast With Google Tv

核心用法

本技能是一个基于ADB的CLI工具，用于控制Chromecast with Google TV（含4K版）及潜在兼容的Android TV设备。核心功能包括：

设备配对与连接

• 首次使用需通过pair子命令完成无线ADB配对（需开启开发者选项+无线调试）
• 支持IP:PORT直连、环境变量覆盖(CHROMECAST_HOST/CHROMECAST_PORT)、本地缓存(.last_device.json)及mDNS自动发现四层连接策略

内容投屏

• YouTube: 直接解析video ID或URL，通过adb shell am start启动指定包名(com.google.android.youtube.tv)
• Tubi: 接受canonical HTTPS URL，通过VIEW intent直达应用
• 其他流媒体: 采用scrcpy驱动的全局搜索回退机制，模拟用户操作完成"搜索→选季→选集→确认打开应用"流程（需指定--app、--season、--episode）

播放控制

• 基础媒体键控制：play/pause/resume通过ADB发送媒体事件
• 设备状态查询：status子命令展示ADB设备列表

显著优点

1. 零Python依赖: 仅使用标准库，通过uv运行规避PEP 668系统包限制，部署极轻量
2. 多源内容聚合: 原生支持YouTube(video ID/URL/query)、Tubi(URL)，其他Hulu/Max/Disney+等通过通用搜索回退兼容
3. 智能连接管理: 四层连接策略（CLI参数→环境变量→本地缓存→mDNS发现）兼顾灵活性与便捷性
4. 安全设计: 明确声明不进行端口扫描，仅连接指定/缓存端口，避免ADB端口轮换冲突

潜在缺点与局限性

• 首次配置门槛高: 需手动开启Chromecast开发者选项、无线调试，并完成ADB配对流程，非技术用户友好度低
• Google TV Streamer兼容性未验证: 文档明确标注对新硬件支持"unknown"
• 回退机制脆弱: 非YouTube/Tubi内容依赖scrcpy模拟UI操作，若Google TV界面更新可能导致选择器失效
• Hulu特殊处理缺失: 未处理Hulu profile选择弹窗，特定场景可能中断
• 网络环境敏感: 无线ADB对网络稳定性要求高，重启设备或调试开关切换后需重新配对
• 单设备局限: mDNS发现仅使用首个结果，多Chromecast环境需显式指定IP

适合人群

• 技术用户/开发者：熟悉ADB、环境变量配置及命令行操作
• 智能家居自动化爱好者：可将CLI集成至Home Assistant等自动化流程
• 跨平台内容消费者：需要在Mac/Linux主机上统一控制多平台流媒体播放

常规风险

| 风险类别 | 说明 |

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

| **无线ADB暴露** | 启用无线调试后，局域网内其他设备理论上可尝试ADB连接（建议配对码使用后及时关闭调试或限制网络隔离） |

| **UI自动化脆弱性** | `scrcpy`回退依赖屏幕坐标/文字匹配，系统更新或应用改版可能导致自动化失效 |

| **凭证缓存安全** | `.last_device.json`存储上次连接信息，多用户共享主机存在信息泄露风险 |

| **网络依赖** | 无线ADB连接质量直接影响响应，高延迟网络可能导致`scrcpy`操作超时 |

| **第三方工具链** | 依赖`yt-api`(Go)、`scrcpy`(C)、`adb`等外部二进制，需自行维护工具链安全更新 |

核心用法

该 Skill 是一个命令行工具，通过 Android Debug Bridge (ADB) 协议与 Chromecast/Google TV 设备建立无线连接，实现媒体内容的远程投屏与控制。用户需先完成一次性设备配对：在 Google TV 上启用开发者选项和无线调试后，使用 pair 子命令完成配对。后续操作包括 status 查看设备状态、play 播放指定内容、pause/resume 控制播放状态。

内容播放支持三种模式：YouTube 视频直接通过视频 ID 或 URL 启动；Tubi 内容通过 HTTPS URL 调用；其他流媒体平台（Hulu、Max、Disney+ 等）则采用全局搜索回退机制，利用 scrcpy 进行 UI 自动化操作，自动完成季集选择和应用跳转。设备连接支持命令行参数、环境变量（CHROMECAST_HOST/PORT）或本地缓存（.last_device.json）三种方式，并内置 mDNS 服务发现作为最终 fallback。

显著优点

极简依赖架构：仅使用 Python 标准库，通过 uv 运行规避 PEP 668 系统包限制，无需虚拟环境或 pip 安装，部署极为轻量。

多平台内容聚合：统一接口覆盖 YouTube、Tubi 及主流流媒体平台，消除用户在不同应用间切换的摩擦，尤其适合跨平台剧集追看场景。

智能连接管理：自动缓存最后成功连接的设备信息，支持 mDNS 自动发现，大幅降低重复配置成本。交互式故障恢复机制可在连接被拒时引导用户更换端口或重新配对。

安全设计意识：无敏感信息硬编码，输入验证充分，外部工具调用均经过参数转义，符合 GDPR 数据最小化原则。

潜在缺点与局限性

前置配置门槛高：首次使用需开启 Google TV 开发者模式、启用无线调试、完成 ADB 配对，对非技术用户存在明显学习曲线。无线调试端口可能随系统重启或设置变更而旋转，需要手动维护。

外部工具链依赖：功能依赖 adb、scrcpy、uv、yt-api 四个独立工具，任一工具缺失或版本不兼容都会导致功能失效。其中 yt-api 为个人开发者提供的非官方 YouTube 工具，存在供应链风险。

平台覆盖受限：明确仅支持 Chromecast with Google TV（第 4 代及 Chromecast 4K），Google TV Streamer 支持状态未知。macOS 和 Linux 双平台支持，Windows 用户需自行适配。

UI 自动化脆弱性：全局搜索回退机制依赖 scrcpy 进行屏幕操控，对界面布局变化敏感，Hulu 等平台配置文件选择等复杂场景未予处理，长期维护成本较高。

适合的目标群体

• 技术型家庭用户：熟悉命令行操作、愿意投入时间完成初始配置的智能家居爱好者
• 跨平台追剧人群：同时在 YouTube、Tubi、Hulu、Max 等多平台订阅内容，希望统一控制入口的用户
• 自动化集成需求者：希望将电视投屏纳入 Home Assistant、脚本工作流或定时任务的进阶用户
• 开发者与极客：需要研究 ADB 协议、Google TV 自动化或构建相关工具的技术人员

使用风险

网络安全风险：ADB 无线调试以明文传输命令，建议在可信家庭网络内使用，避免公共 Wi-Fi 环境。无线调试长期开启可能扩大设备攻击面。

外部工具供应链风险：yt-api 作为第三方非官方工具，其更新节奏、API 稳定性及长期维护存在不确定性，建议关注上游安全公告。

连接稳定性风险：无线调试端口旋转、路由器配置变更、设备休眠均可能导致连接中断，需保留手动排查和重新配对的能力。

数据隐私风险：设备连接信息缓存于本地 .last_device.json，虽非敏感数据，但仍建议设置适当文件权限（0600）防止本地其他用户读取。