Chromecast With Google Tv

核心功能

该Skill是一个基于ADB（Android Debug Bridge）的命令行工具，用于远程控制Chromecast with Google TV（4K版）设备。主要功能包括：

• 设备状态检测：通过./run status查看ADB连接状态
• 视频播放控制：支持播放/暂停/恢复操作
• 多平台内容投屏：
• YouTube：直接通过视频ID或URL启动YouTube TV应用
• Tubi TV：通过HTTPS URL启动Tubi应用
• 其他流媒体（Hulu、Max、Disney+等）：使用全局搜索回退机制，需指定应用名、季数和集数

技术实现特点

该Skill采用纯Python标准库编写，无需pip依赖，通过uv运行以规避系统包限制。核心依赖四个外部工具：

• adb：Android平台工具，用于设备通信
• scrcpy：屏幕镜像工具，用于全局搜索自动化操作
• yt-api：Go编写的YouTube API CLI，用于视频ID解析
• uv：Python项目运行器

智能设备发现机制

支持多级设备选择策略：
1. 命令行显式指定IP和端口
2. 环境变量CHROMECAST_HOST/CHROMECAST_PORT覆盖
3. 本地缓存.last_device.json自动复用
4. ADB mDNS服务自动发现（首结果）

重要安全设计：明确禁止端口扫描，仅连接指定端口，避免与Google ADB端口轮换机制冲突。

显著优点

1. 零Python依赖：仅使用标准库，部署极度轻量
2. 灵活的设备管理：多级回退机制，从显式配置到自动发现
3. 多平台覆盖：原生支持YouTube/Tubi，通过scrcpy自动化扩展至主流流媒体
4. 非破坏性设计：本地缓存机制，不修改系统配置
5. 交互式故障恢复：ADB连接失败时提示用户输入新端口并自动更新缓存

潜在局限性与风险

1. 环境依赖复杂：需同时安装adb、scrcpy、uv、yt-api四个独立工具链
2. 平台限制：当前仅支持macOS和Linux（Darwin/Linux），Windows未明确支持
3. Google TV Streamer兼容性未知：文档明确标注对新设备支持状态不确定
4. 全局搜索稳定性：依赖scrcpy的UI自动化，受界面变化影响较大
5. Hulu特殊处理缺失：未实现Hulu账户选择逻辑
6. 网络依赖：yt-api解析和Tubi URL搜索均需外网连接

适用人群

• 熟悉命令行和ADB操作的进阶用户
• 希望自动化电视控制的家庭影院爱好者
• 需要集成Google TV到Home Assistant等自动化平台的开发者
• 愿意接受手动工具链安装配置的技术用户

安全评估

该Skill本质上是ADB命令的封装层，安全风险主要源于ADB本身：

• 需开启设备的ADB调试模式，增加攻击面
• 网络传输虽可加密，但ADB认证机制较弱
• 无端口扫描行为降低了网络层风险
• 建议仅在可信内网环境使用，避免公网暴露5555端口

核心用法

Chromecast with Google TV Skill 是一个基于ADB协议的本地设备控制工具，旨在让用户通过命令行界面直接操控Chromecast with Google TV（支持Chromecast 4K，Google TV Streamer兼容性未验证）。该Skill的核心功能围绕影音内容投播展开：用户可通过play子命令播放YouTube视频（支持视频ID、URL或标题搜索）、Tubi流媒体内容，或通过全局搜索回退机制在其他流媒体应用（如Hulu、Max、Disney+）中定位并播放特定剧集。设备连接支持多种方式——显式指定IP和端口、环境变量配置、本地缓存自动恢复，以及ADB mDNS服务自动发现。此外，Skill提供pause和resume媒体控制命令，以及status设备状态查询功能。

显著优点

纯本地架构，隐私优先：Skill完全运行在本地网络环境，通过ADB与设备进行TCP通信，无需云端授权或账户绑定。YouTube视频ID解析虽依赖外部yt-api工具，但可通过本地CLI代理完成，最大程度减少数据外泄风险。

零依赖轻量化实现：Skill仅使用Python标准库开发，不依赖任何pip第三方包，通过uv运行时环境规避系统包管理冲突，部署简洁且维护成本低。

智能设备发现与缓存机制：支持mDNS自动发现局域网内ADB设备，同时缓存最后一次成功连接的设备信息（存储于.last_device.json），在多次使用中实现无缝重连，兼顾便利性与可控性。

多平台流媒体生态兼容：不仅原生支持YouTube和Tubi，还通过scrcpy辅助的UI自动化方案，实现对Hulu、Max、Disney+等第三方应用的剧集级精准定位（需指定季/集参数），扩展了设备的实用性边界。

潜在缺点与局限性

外部工具链依赖繁重：Skill正常运行依赖adb、scrcpy、uv、yt-api四个独立CLI工具，且yt-api为Go语言编写的第三方社区项目（由nerveband维护），用户需自行评估其可信度和长期维护状态。工具链的任何环节缺失或版本不兼容都将导致功能失效。

全局搜索回退的脆弱性：非YouTube/Tubi内容的播放依赖scrcpy驱动的UI自动化流程（模拟点击Series Overview界面、选择季集、确认打开应用），该方案对Google TV界面更新敏感，存在因UI布局变更导致脚本失效的风险。此外，Hulu等平台的多用户配置选择未被处理，可能阻碍内容正常加载。

网络环境限制性：ADB连接要求设备与主机处于同一局域网，且需手动开启Chromecast的开发者选项和ADB调试模式，对非技术用户构成一定门槛。

适合的目标群体

该Skill最适合技术型智能家居用户和本地影音自动化爱好者。具体包括：具备基本命令行操作能力的开发者或工程师；希望在本地网络环境内构建无云端依赖的媒体播放工作流的隐私敏感用户；以及需要将Chromecast with Google TV集成到家庭自动化系统（如Home Assistant配合命令行调用）的高级玩家。对于追求开箱即用、图形化界面的普通消费者，该工具的复杂性可能构成使用障碍。

常规使用风险

性能与稳定性风险：全局搜索回退流程依赖scrcpy屏幕镜像和UI自动化，执行延迟受设备响应速度和网络质量影响，可能出现超时或元素定位失败。建议仅在稳定的局域网环境下使用。

依赖项维护风险：yt-api作为个人开发者维护的Go模块，存在更新滞后或弃用的可能性。若Google YouTube Data API发生变更，可能导致视频ID解析功能失效。建议用户关注该工具的社区动态。

ADB连接安全风险：虽然Skill本身不执行端口扫描，但ADB协议在开放端口（默认5555）上通信时若缺乏网络隔离，可能存在未授权访问风险。建议用户确保家庭网络边界安全，避免将ADB端口暴露于公网。

配置持久化风险：设备连接信息缓存于本地JSON文件，虽便于使用但可能在多用户共享主机场景下造成连接目标混淆，建议定期清理或显式指定设备参数。