finalrun.app • 文档 • 博客 • 云设备候补名单 • 加入 Slack 社区
finalrun-agent 是一个 AI 驱动的 CLI 工具,可使用自然语言测试您的 Android 和 iOS 应用。您用纯英文在 YAML 中编写测试,FinalRun 会在模拟器或仿真器上启动您的应用,使用 AI 模型(Gemini、GPT 或 Claude)查看屏幕并执行每个步骤——点击、滑动、输入——然后生成包含视频和设备日志的通过/失败报告。
macOS / Linux
curl -fsSL https://raw.githubusercontent.com/final-run/finalrun-agent/main/scripts/install.sh | bash
Windows (PowerShell)
irm https://raw.githubusercontent.com/final-run/finalrun-agent/main/scripts/install.ps1 | iex
iOS 本地测试需要 macOS(xcodebuild)。在 Windows 上,iOS 请使用 finalrun cloud——Android 可本地运行。CI 标志、环境变量覆盖和构件列表位于最新发布说明中。
FinalRun 提供了技能,让您的 AI 编码代理能够生成测试、验证工作区并运行测试——全部在聊天中完成。
/finalrun-generate-test 技能会读取您应用的源代码,推断应用身份,并生成完整的测试规格,包括设置、步骤和预期状态——按功能文件夹组织。
示例:
/finalrun-generate-test 为认证功能生成测试——覆盖使用有效凭据登录、使用错误密码登录以及注销
代理将:
.finalrun/config.yaml 和 .finalrun/env/ 中的环境绑定.finalrun/tests/auth/ 下生成 YAML 规格,并在 .finalrun/suites/ 下生成测试套件finalrun check 以验证一切/finalrun-generate-test 技能在测试生成后会验证并运行测试。
示例:
/finalrun-use-cli 在 Android 上运行认证测试
/finalrun-test-and-fix 技能编排完整的 生成 → 运行 → 诊断 → 修复 循环。它通过 finalrun-generate-test 编写测试,通过 finalrun-use-cli 运行测试,在失败时读取 CLI 产物(result.json、actions/、截图、device.log),判断错误是来自应用代码还是测试,应用最窄的修复,然后重新运行直到测试通过。
示例:
/finalrun-test-and-fix 验证并修复 Android 上结账功能的端到端测试
将以下**内容**添加到您的 AGENTS.md 中,以自动触发 FinalRun,这样您就不必每次都明确要求代理生成和运行测试。这还能让您的代理在开发过程中出现任何错误时修复问题。
FinalRun 使用您自己的 AI 提供商的 API 密钥来运行测试。
echo "GOOGLE_API_KEY=your-key-here" > .env
| 提供商 | 环境变量 |
|---|---|
google/... | GOOGLE_API_KEY |
openai/... | OPENAI_API_KEY |
anthropic/... | ANTHROPIC_API_KEY |
测试运行会消耗您配置的提供商的 API 令牌——适用标准的 API 计费。
finalrun test smoke.yaml --platform android --model google/gemini-3-flash-preview
finalrun suite auth_smoke.yaml --platform android --model google/gemini-3-flash-preview
完整文档:docs.finalrun.app
--app 标志和按环境覆盖参见 CONTRIBUTING.md 了解单仓库结构、构建命令和贡献者指南。