Argent TV(Apple TV + Android TV + Fire TV)用于控制和检查电视应用。关键点:电视是焦点驱动而非触摸驱动,所有交互都用 describe + tv-remote + keyboard,禁用 gesture-* 与坐标点击。操作前先用 describe 找到当前光标(聚焦元素)和目标,不要从截图猜测焦点;Vega 上若无 [focused] 项,可将 [selected] 视为光标。udid 取自 list-devices,可为 Apple TV 模拟器 UDID 或 Android TV / Vega 序列号,同一套工具自动分派到三个平台。
导航循环:describe 找光标与目标(返回聚焦元素和全部可聚焦元素);tv-remote 用一枚按键或整条路径移动焦点,如 {button:["down","right","select"]},按键含 up/down/left/right、select、back、menu、home、playPause 及媒体键 rewind/fastForward/next/previous/volumeUp/volumeDown/mute,支持 repeat;再 describe 确认,未命中则重复。keyboard 向聚焦输入框输入文本,一次调用只带 text 或 key。另有 launch-app / restart-app / reinstall-app(bundleId 来自应用清单,Vega 的 reinstall-app 取 .vpkg 路径)和 screenshot(Apple TV 走 xcrun simctl io,Android TV / Vega 走 adb / screencap)。
平台差异:Apple TV 模拟器首次 describe / tv-remote 会自动启动 AX + HID 守护进程,媒体传输与音量键被拒绝;Android TV 上部分 react-native-tvos 页面用 RN 自带焦点引擎,describe 可能为零,需盲驾加截图确认;Fire TV(Vega)用 boot-device {vvdImage} 启动,空 describe 树先 restart-app,输入被忽略则启用开发者模式 vsm developer-mode enable。
常见问题:启动后短暂空焦点是启动画面,等待约 2-3 秒重试;把手机/平板 udid 传给 tv-remote 会报平台错误。Fast Refresh 需 Debug 构建加 Metro(固定 8081)。Vega 的 JS 调试在 Debug 构建加 Metro 下可用 debugger-connect、debugger-status、debugger-evaluate、debugger-log-registry、view-network-logs 及请求详情;因 Vega 基于 RN 0.72 旧版 Hermes 检查器,debugger-component-tree、debugger-inspect-element、debugger-reload-metro 与 react-profiler-* / profiler-* 不支持,isNewDebugger 为 false,projectRoot 为空。