Argent 简介:AI Agent 一键掌控 iOS 与 Android 应用的神器,5分钟看懂它能做什么
【免费下载链接】argentAn agentic toolkit to control, debug, and profile iOS and Android apps. Made by Software Mansion.项目地址: https://gitcode.com/gh_mirrors/arg/argent
Argent 是 Software Mansion 出品的 agentic 工具包(AI Agent 应用调试神器),它让你的 AI 助手直接控制 iOS 模拟器、Android 模拟器与真机、电视设备以及 Electron/Chromium 桌面应用——点按按钮、录制性能分析、复现 Bug,全程不用离开命令行。下面用 5 分钟带你看懂它能做什么、怎么用。
什么是 Argent?AI Agent 驱动的移动应用调试工具
传统移动开发里,测试、调试、性能分析需要在 IDE、模拟器、各种 Profiler 之间来回切换。Argent 的思路是把这些能力打包成一组工具,通过 MCP 服务器 接入你的 AI 编程助手(Claude Code、Cursor 等),让AI Agent 成为你的手:
- 🖐️Interact:点按、滑动、手势、输入文字、按硬件键;电视上按 D-pad;桌面用鼠标键盘
- 🔁Flows:把一条操作路径录一次,之后确定性地回放成复现场景或冒烟测试
- 📐Visual regression:基线截图与实时截图做 diff,支持 OCR 与字体感知
- ⚡Profiling:Hermes、React DevTools、Xcode Instruments、Perfetto,定位渲染、CPU 热点与卡顿
- 🔍Debugging:日志、网络请求(fetch 与原生)、JS 求值、原生与 React 视图树
- ⚛️React Native:开箱即用,构建、启动、迭代无需额外配置
装好之后,直接问助手一句话即可:"What can Argent do?",它会列出当前工作区的所有工具。
支持哪些平台?iOS、Android、电视与桌面一网打尽
| 平台 | 目标设备 | 交互方式 |
|---|---|---|
| iOS | 模拟器、真机 iPhone | 触摸 / 手势 |
| Android | 模拟器(AVD)、adb 连接的物理设备 | 触摸 / 手势 |
| TV | Apple TV(tvOS)、Android TV / Google TV、Amazon Fire TV(Vega) | D-pad / 遥控器 |
| 桌面 & Web | Electron 与 Chromium 应用(含 React Native Web / Expo Web) | 鼠标 / 键盘 |
几个值得注意的细节:
- 📱真机 iPhone可通过 USB 线直接驱动;Android 真机通过 adb 接入,交互模型与模拟器完全一致
- 🪄折叠屏模拟器:可操控 iPhone Duo 的合拢、半开、展开状态
- 📺TV 设备: Argent 会读取当前焦点元素,再用遥控器方向键移动光标并确认选择
完整的平台清单见 supported-platforms.mdx。
一键安装:Argent 安装教程只需一条命令
前提条件很简单:Node.js 20.12+;iOS/tvOS 需要 macOS 和 Xcode;Android 需要adb在PATH中,外加 Android Emulator 包。
然后在你的项目根目录执行安装向导:
npx @swmansion/argent@latest init向导会自动完成三件事:全局安装@swmansion/argent、检测你的编辑器并注册 MCP 服务器、把 skills 与 agent 定义复制到工作区。pnpm 用户可用pnpm dlx @swmansion/argent@latest init替代。
团队协作用--local模式,把配置提交进仓库,队友npm install即得相同环境。详细步骤见 installation.mdx 与 getting-started.mdx。
核心能力上手:AI Agent 如何替你测试 App
与 App 交互:让 AI Agent 替你"点点点"
告诉助手"帮我走完注册流程,告诉我哪里断了",它会先通过无障碍树/组件树做发现,拿到真实坐标(而不是从截图猜坐标),再逐屏点按、滑动、输入。整个过程你能在终端里看到每一步。更多细节见 interacting-with-apps.mdx。
录制与回放 Flows:把操作变成可重复的测试
一条 flow 是"录一次、回放无数次"的交互序列:AI Agent 录制时边操作边记录,每步带标签;回放时若某步失败立即停止并报告。flow 以 YAML 文件存在项目的.argent/flows/目录,是纯文本,可以提交进仓库、在 PR 中评审。它甚至不绑定设备,同一份 flow 可跑在不同模拟器上;argent flow run还能在 CI 中无 Agent 直接回放。
文档详见 flows.mdx。
性能 Profiling:快速定位卡顿、CPU 热点与内存泄漏
一次分析会话分四步:启动 Profiler → 操作 App → 停止并落盘 → Agent 分析数据并产出 Markdown 报告。Argent 内置 React Profiler(Hermes + React DevTools,看组件渲染与提交)和 Native Profiler(iOS 走 Xcode Instruments、Android 走 Perfetto,看原生 CPU、UI 卡顿与内存增长),两者可同时运行并生成对齐的联合报告——哪个 React commit 引发了哪次卡顿,一目了然。
详见 profiling.mdx。
调试与网络抓包:日志、请求、JS 求值一站搞定
调试能力覆盖应用日志、fetch与原生网络流量、JS 运行时求值,以及原生与 React 视图树的可视化检查,方便你边调试边让 Agent 解释"这个请求为什么 500"。
详见 debugging.mdx 与 network.mdx。
进阶亮点:Argent Lens 设计评审窗口
Argent Lens 是一个设计评审窗口:你让 Agent"重新设计这个头部",它会在真实 App 中渲染多个候选方案并截图,在 Lens 窗口里与设备实时画面并排展示。你挑选方案、写评论,Agent 再把选中的变体应用到源码。该功能目前处于开发中,需开启argent-lens标志且仅支持 macOS,介绍见 lens.mdx。
常见问题
- 需要付费吗?Argent 开源,源码采用 Apache License 2.0(部分平台专有二进制仅限项目内使用,见 LICENSE.txt)。
- 隐私如何?遥测默认开启但可退出,执行
argent telemetry disable即可,说明见 Telemetry.md。 - 源码在哪看?CLI 入口在 index.ts,工具集合位于 packages/argent-mcp/,完整工具参考见 tools.mdx。
总结
Argent 把"控制设备、调试、性能分析、可视化回归"这些原本分散的环节统一交给 AI Agent,一条npx @swmansion/argent@latest init就能装好。无论你测 iOS、Android、电视还是桌面应用,都值得花 5 分钟试一次——从 getting-started.mdx 开始,让 AI 替你点点点吧 🚀
【免费下载链接】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),仅供参考