software-mansion/argent

Argent – AI 驱动的移动、电视和桌面应用控制

它是什么

• 一个命令行工具，让 AI 助手（例如 ChatGPT、Claude）直接与 iOS 模拟器、Android 模拟器/设备、Apple/Android/Fire TV 以及 Electron/Chromium 应用交互。
• 它弥合了自然语言指令与 UI 操作（如点击、滑动、输入、硬件按键以及鼠标/键盘输入）之间的差距。

主要功能

领域	Argent 的作用
交互	模拟点击、滑动、手势、输入、电视上的 D-pad 导航，以及桌面应用上的鼠标/键盘事件。
端到端测试	录制一次 UI 操作序列，并确定性重放以进行 bug 复现或冒烟测试。
视觉回归	捕获截图基线，然后与实时捕获进行 OCR 和字体感知的差异比较。
性能分析	接入 Hermes、React DevTools、Xcode Instruments、Perfetto，以显示渲染时间、CPU 热点和卡顿。
调试	流式传输日志、拦截网络流量（XMLHttpRequest、axios、fetch、Expo）、在应用中评估 JS，并检查原生/React 组件树。
React Native 支持	无需额外配置即可构建、启动和迭代 RN 应用。

如何使用

# 在项目中初始化工具（npm 或 pnpm）
npx @swmansion/argent@latest init   # pnpm: pnpm dlx @swmansion/argent@latest init

安装后，您可以向 AI 助手发出类似命令：

• “在 iPhone 模拟器上点击登录按钮。”
• “录制一条重现此崩溃的路径。”
• “显示主屏幕的视觉差异。” 助手会将自然语言请求转换为适当的 CLI 调用，Argent 在目标设备上执行。

文档与隐私

• 完整文档托管在 docs.swmansion.com/argent，涵盖安装、支持的平台、CLI 参考和编辑器集成。
• 遥测可选择退出（argent telemetry disable）。简短的隐私声明解释了收集哪些数据。

许可证模式

• 源代码采用 Apache-2.0 许可证。
• 平台特定的二进制文件（simulator-server、ax-service、.dylib 文件）是 Software Mansion 的专有财产，只能在 Argent 内使用。禁止重新分发或逆向工程这些二进制文件。

幕后团队

• 由 Software Mansion 开发，这是一家长期存在的机构，也是 React Native 的核心贡献者。他们还提供咨询和定制开发服务。

谁可能受益

• 构建需要操作移动或电视 UI 的 AI 驱动助手的团队。
• 希望使用单一 CLI 在 iOS、Android 和桌面端录制和重放 UI 流程的 QA 工程师。
• 寻找可通过编程方式驱动的集成性能分析、视觉回归和调试工具的开发者。

---

所有信息均直接取自仓库的 README。