Argent Flows 完全指南录制一次操作确定性回放成可复现 Bug 与冒烟测试【免费下载链接】argentAn agentic toolkit to control, debug, and profile iOS and Android apps. Made by Software Mansion.项目地址: https://gitcode.com/gh_mirrors/arg/argentArgent Flows 是开源项目 ArgentSoftware Mansion 出品的 iOS / Android 应用代理工具包的核心特性你只需让 AI Agent录制一次App 操作路径之后就能确定性回放任意多次——同一份步骤序列每次都走完全相同的路径。它把手动复现 Bug、冒烟测试、两个版本对比这类重复劳动变成了可提交、可评审、可在 CI 里跑的文件。为什么需要 Argent Flows传统 UI 测试脚本脆弱、难写、难维护纯手动复现又无法保证路径一致。Flows 的解法是录制修复后重新 profiling需要两次走完全相同的路径在相同页面上对比两个构建版本的差异每个分支用同样的步骤检查回归问题你曾带 Agent 手工走完一条很长的路径想把它保存下来一个 Flow 就是「对 App 的一次交互序列」的录制。Agent 录制一次之后 Agent 或 CI 任务想回放多少次就回放多少次。三步录制从一句话指令到可回放的 Flow 文件你不需要手写测试代码。用一句自然语言描述路径即可例如把从启动页到结算汇总页的路径录制为名为 checkout 的 Flow。录制过程中Agent 会边操作边录制——每一步都真机执行Agent 看到结果后才记下这一步在步骤之间添加标签echo——说明这一步做什么、期望到达哪个页面回放报告因此可读写入 YAML 文件——最后一个步骤完成后Flow 保存到项目的.argent/flows/name.yaml关键设计Argent 让点击具备可移植性。被点元素有稳定文本或 ID 时录制的是元素而非坐标回放时在屏幕上重新定位没有稳定标识时才会录制坐标并给出警告。因此同一份 Flow 可以换一台模拟器、一个模拟器镜像继续跑文件里不保存任何设备标识。录制逻辑的源码入口在 flow-start-recording.ts、flow-add-step.ts、flow-finish-recording.ts。Flow 文件长什么样两种形态Flow 是纯文本 YAML可以提交到仓库、在 PR 里逐行评审、也可以手工编辑某一步。最小结构如下steps: - launch: com.example.app - await: { visible: { id: home-screen } } - await: { idle: true }形态第一个 App 步骤起始状态端到端 FlowlaunchArgent 从零启动 App片段Fragment其他任意步骤通过executionPrerequisite声明起始状态如设置页已打开除了点击和输入步骤还支持等待元素、等待画面稳定idle、断言条件、截图基线对比snapshot、嵌套执行另一个 Flowrun、运行本地脚本script、**平台条件分支when**等覆盖视觉回归与数据准备场景。完整字段与选择器语法见官方文档 Flow YAML 参考概念说明见 Flows 功能文档。两种回放方式AI Agent 或 CLI方式一让 Agent 跑。直接说运行 checkout flow告诉我哪一步失败。Agent 按顺序在已连接设备上回放每一步某步失败时 Argent 会停止 Flow把后续步骤标记为跳过最后给 Agent 一份逐步结果报告。方式二argent flow命令无需 Agent。这是 CI 的关键入口argent flow run checkout # 按名称运行 argent flow run .argent/flows # 运行目录下所有 Flow argent flow run checkout --platform ios --json命令逐步打印结果并以退出码表示成败天然适配 CI 作业。--json输出结构化报告--output dir可导出失败基线、当前图与差异图供归档目录运行结束时还会输出Failed flows汇总并附上可单独重跑该失败 Flow 的命令。命令参数详解在 CLI 参考执行器实现见 flow-run.ts。把 Flow 变成 CI 冒烟测试一条典型的冒烟流水线就是开发者用 Agent 录制「登录 → 浏览 → 下单」主路径Flow 文件随代码提交每个分支的 CI 中启动模拟器执行argent flow run dir --recursive --json退出码非零即构建失败--json报告直接对接 CI 产物结合snapshot步骤还可以做视觉回归--update-baselines从已知良好状态写入基线之后每次运行自动对比超差即失败。配合 profiling 场景你还能运行 search flow 的同时 profile App应用修复后再跑一遍保证前后数据可比。常见限制与避坑清单 ⚠️一次只在一台已启动的设备上回放多台设备在线时需在指令中指明物理 iPhone 永远不会被自动选择坐标型点击怕布局变化给元素加稳定文本或 ID 后重新录制该步Flow 不清空 App 数据会创建数据的步骤每次回放都会再创建一次——建议以launch或状态恢复步骤开头回放需要与录制相同的 UI 树读取能力读不到 UI 树时坐标步骤会盲发点击并告警而稳定标识步骤会直接失败Chromium / Electron 应用的launch步骤需要手工写入 Flow 文件小结Argent Flows 的价值在于「一次录制无限回放」的确定性步骤是文件、路径可评审、回放可进 CI。它和 Argent 的调试Lens、网络检查、性能分析等能力组合后发现问题 → 录制路径 → 修复 → 同路径验证形成了完整的闭环。更多资料功能概念文档features/flows.mdx文件与命令参考reference/flow-yaml.mdx录制/回放工具源码packages/tool-server/src/tools/flows/【免费下载链接】argentAn agentic toolkit to control, debug, and profile iOS and Android apps. Made by Software Mansion.项目地址: https://gitcode.com/gh_mirrors/arg/argent创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考