用途:帮助智能体审查或构建跨 tvOS、Android TV、Fire TV 与 Vega OS 的 React Native TV 界面,适用于审计 TV 应用、修复焦点或 D-pad 问题,以及搭建泳道、Hero 横幅、抽屉、标签页、模态框、焦点陷阱、搜索与登录等常见组件。
主要能力:参考资料覆盖焦点管理、布局模式、字体与对比度、输入处理及 Vega 特有注意事项,可按需选取相关文件而非全部阅读。
使用方式:先确认运行时——package.json 中 react-native-tvos 对应 tvOS 与 Android TV,@amazon-devices/react-native-kepler 对应 Vega,monorepo 可能按包分别配置;若无 Platform.isTV 且依赖中无 TV 运行时,则该技能不适用。Vega 的 API 细节以 Amazon 官方文档为准,本技能只覆盖跨运行时的非显而易见问题。静态辅助脚本可运行 node references/scripts/audit.js src,对焦点、输入、布局、字体四部分做 grep 式检查,可用 --only / --skip 选择部分,零依赖,发现问题时退出码为 1;它只是辅助,不能替代完整审查。
适用场景:焦点与 D-pad 导航、初始焦点错误、焦点意外跳转、模态或浮层焦点泄漏、返回键未恢复焦点、程序化移动焦点、跨平台差异;构建抽屉、标签页、模态框、卡片、行、泳道、Hero、安全区与宽高比;字体、颜色对比、HDR 与环境光;遥控器模型、TextInput、搜索、登录、语音与二维码认证。
限制:需要真实电视在观看距离下验证的项目(过扫描裁切、环境光下焦点指示可见性、动画手感、HDR 下对比度、10 英尺可读性)智能体无法完成,应作为待办事项交由人工核验,不得声称已完成。输出代码或修复建议时需说明目标运行时、非通用 API 的平台可用性,并链接相关参考章节。