SuperAPI AI 工具集

install-apple-tv-app

部署与运维

查看项目

更新于 10-15 23:58

技能介绍

用途:通过 atvloadly 把 tvOS 源码项目或已有 IPA 构建并侧载到指定 Apple TV。

主要能力与流程:先确认输入,包括源码项目路径或 IPA 路径、atvloadly URL(来自用户或 ATVLOADLY_URL,缺失需询问,不得硬编码私有主机或 IP)、atvloadly 主机控制方、精确的 Apple TV 名称;公共 URL 优先 HTTPS,仅在用户确认的可信局域网使用 HTTP,拒绝含凭据的 URL。所有 Apple 凭据不得出现在命令、文件、日志、截图或回复中。

源码项目:先阅读 AGENTS.md、README、构建文档、项目文件与 CI 配置;检查 git status 并保留所有已有修改与未跟踪文件;确认 tvOS 目标、Bundle Identifier、最低 tvOS 版本、支持架构、依赖与签名要求;按项目文档安装依赖并构建,优先 Release 归档/导出;运行相关测试与构建检查,修复根因,不得删除功能或跳过必要检查;定位生成的 .ipa 并保留绝对路径。已有 IPA 则跳过构建,直接进入验证。

只读预检:运行技能目录下的脚本:python3 <skill-directory>/scripts/preflight.py --base-url "${ATVLOADLY_URL:-<user-provided-url>}" --device-name "<exact-Apple-TV-name>" --ipa "<absolute-path-to-ipa>" --json。要求全部检查通过,记录 atvloadly 版本、服务状态、选中的已配对 Apple TV ID、RPPairing 连接、IP、端口、IPA 应用名、Bundle Identifier、最低 tvOS 版本、大小与 SHA-256。脚本仅执行 GET 请求,不上传或改变状态。

Web UI 安装:仅使用 chrome-use 操作实时 Web UI,不可用则按其自愈说明处理,不切换其他浏览器工具;用 chrome-use skills get core --full 加载当前浏览器工作流;打开解析后的 atvloadly URL;每次交互前重新快照,只用最新快照的 refs,不复用旧 refs 或猜测选择器;选择预检确认的精确配对 Apple TV,打开其安装页并选择已验证的 IPA;开始安装前再次核对可见设备名与 IPA 路径/名称同预检的 Bundle Identifier 和 SHA-256;Apple ID 选择、密码输入、2FA 或开发者账号选择须停下由用户处理,绝不在聊天中索取、输入、读取或暴露凭据;用户确认完成后重新快照再开始或继续安装;捕获不含密钥的终端安装结果与相关日志。

完成验证:区分证据层——构建(测试/检查通过且生成 tvOS IPA)、上传(atvloadly 接受已验证 IPA)、安装(atvloadly 报告精确配对设备安装完成)、物理设备(该 Apple TV 出现应用图标、成功启动、渲染首屏并通过最小核心功能冒烟测试)。不得仅凭 HTTP 响应、浏览器页面、上传结果或安装日志声称物理设备成功;无法远程观察时请用户执行或确认电视端步骤;明确报告未完成与失败的层级。

限制:资料未提供 atvloadly 的部署方式、收费、支持平台范围等细节。