---

🚀 新：Magnitude 处于行业领先水平，在 WebVoyager 上取得了 94% 的成绩！

Magnitude 利用视觉 AI，使您能够通过自然语言控制浏览器。

• 🧭 导航 - 能够识别并理解任何界面，从而规划操作步骤
• 🖱️ 交互 - 使用鼠标和键盘执行精确的操作
• 🔍 提取 - 智能地提取有用的结构化数据
• ✅ 验证 - 内置测试运行器，具备强大的视觉断言功能

您可以使用它来自动化网络任务、在没有 API 的情况下实现应用间的集成、提取数据、测试您的 Web 应用程序，或者将其作为构建您自己的浏览器代理的基础组件。

↕️ Magnitude 实际运行效果！ ↕️

// Magnitude 可以处理高层次的任务
await agent.act('创建一个任务', {
    // 可选地传递代理将在适当位置使用的数据
    data: {
        title: '使用 Magnitude',
        description: '运行 "npx create-magnitude-app" 并按照说明操作',
    },
});

// 它也可以处理低层次的操作
await agent.act('将“使用 Magnitude”拖动到进行中列的顶部');

// 根据 DOM 内容，结合提供的 zod 模式智能提取数据
const tasks = await agent.extract(
    '列出进行中的任务',
    z.array(z.object({
        title: z.string(),
        description: z.string(),
        // 代理可以提取现有数据或新的见解
        difficulty: z.number().describe('请评估难度，范围为 1 到 5')
    })),
);

开始使用

运行您的第一个浏览器自动化

npx create-magnitude-app

这将创建一个新的项目，并引导您完成 Magnitude 的设置步骤。同时还会生成一个示例脚本，您可以立即运行！

使用测试运行器

要在 现有 Web 应用中安装测试运行器，请运行：

npm i --save-dev magnitude-test && npx magnitude init

这将创建一个基本的测试目录 tests/magnitude，其中包含：

• magnitude.config.ts: Magnitude 测试配置文件
• example.mag.ts: 示例测试文件

有关如何运行测试以及如何集成到 CI/CD 中的信息，请参阅 此处。

[!注意] Magnitude 需要一个大型的 视觉基础 模型。我们推荐使用 Claude Sonnet 4 以获得最佳性能，但也兼容 Qwen-2.5VL 72B。更多信息请参阅 文档。

为什么选择 Magnitude？

❌ 问题 #1： 大多数浏览器代理会在页面元素周围绘制编号方框——由于现代网站结构复杂，这种方法难以泛化。

✅ 解决方案：视觉优先架构

• 基于视觉的 LLM 指定像素坐标
• 真正的泛化能力，不受 DOM 结构限制
• 面向未来的架构，适用于桌面应用、虚拟机等

❌ 问题 #2： 大多数浏览器代理采用“高层级提示 + 工具 = 直到完成”的模式——这种模式适合演示，但不适合生产环境。

✅ 解决方案：可控且可重复的自动化

• 灵活的抽象层级（细粒度操作与流程）
• 在代理和操作层面自定义动作和提示
• 通过原生缓存系统实现确定性运行 (正在进行中)

更多信息

有关如何更好地构建 Magnitude 自动化和测试用例的更多信息，请参阅我们的 文档。

联系方式

如果您是企业用户，并希望获得更多功能或支持，请随时通过 founders@magnitude.run 与我们联系，或在此 预约通话，讨论您的需求。

您也可以加入我们的 Discord 社区,获取帮助或提出建议！

Browser-Agent (Magnitude) 快速上手指南

Magnitude 是一款基于视觉 AI 的浏览器自动化工具，能够通过自然语言控制浏览器执行导航、交互、数据提取和验证任务。它采用“视觉优先”架构，不依赖 DOM 结构，适用于复杂现代网站及桌面应用自动化。

环境准备

• 系统要求：支持 Node.js 的操作系统（Windows / macOS / Linux）
• 前置依赖：
  • Node.js >= 18.x
  • npm 或 pnpm 包管理器
  • 一个支持视觉理解的 LLM 模型（推荐 Claude Sonnet 4，兼容 Qwen-2.5VL 72B）
• 网络建议：由于模型服务可能涉及海外 API，请确保网络通畅或配置合适的代理。

安装步骤

方式一：创建新项目（推荐新手）

运行以下命令创建一个新的 Magnitude 项目并跟随向导完成初始化：

npx create-magnitude-app

该命令会自动生成项目结构、配置文件及示例脚本，可直接运行体验。

方式二：在现有项目中集成测试功能

若你已在开发 Web 应用，希望加入自动化测试：

npm i --save-dev magnitude-test && npx magnitude init

执行后将生成 tests/magnitude 目录，包含：

• magnitude.config.ts：配置文件
• example.mag.ts：示例测试文件

💡 提示：目前暂无官方中国镜像源，如遇下载缓慢，可配置 npm 国内镜像（如淘宝镜像）加速依赖安装：

npm config set registry https://registry.npmmirror.com

基本使用

1. 执行高层任务（自然语言驱动）

await agent.act('Create a task', {
    data: {
        title: 'Use Magnitude',
        description: 'Run "npx create-magnitude-app" and follow the instructions',
    },
});

2. 执行底层操作（精确控制）

await agent.act('Drag "Use Magnitude" to the top of the in progress column');

3. 智能数据提取（结合 Zod schema）

const tasks = await agent.extract(
    'List in progress tasks',
    z.array(z.object({
        title: z.string(),
        description: z.string(),
        difficulty: z.number().describe('Rate the difficulty between 1-5')
    })),
);

4. 运行测试（集成 CI/CD）

在项目根目录执行：

npx magnitude test

详细测试运行与集成文档请参阅：https://docs.magnitude.run/core-concepts/running-tests

---

开始构建你的视觉驱动浏览器自动化流程吧！