Jev Ultrafast 是 Browser Use 团队开源的轻量级浏览器代理。它能在真实网页上以极低成本和极高速度完成任务——例如在约7秒内搜索苏黎世到伦敦的航班，成本仅约0.0039美元。本教程将带你理解其核心原理，并手把手教你本地运行它。
一、核心原理：为什么它这么快？传统浏览器代理常依赖截图 + 视觉模型，每步需要多次网络往返和复杂推理，速度慢、成本高。Jev Ultrafast 采用完全不同的思路：
动态索引动作空间每一步都对当前页面做一次原子 DOM 快照，提取所有可见可交互控件，生成带编号的元素表。例如： [1] button Change ticket type Round trip [2] combobox Where from? San Francisco [3] combobox Where to? empty [4] textbox Departure empty单次请求完成两个决策把元素表和自然语言目标一起发给 TypeSafe 的 Jev 模型。模型在一次请求中同时输出：操作类型（CLICK、TYPE_TEXT、SELECT、SCROLL_UP/DOWN、WAIT、DONE、BLOCKED）对应操作的目标元素索引这是投机式设计：操作和目标并行决策，只执行匹配的那一个，大幅减少往返次数。按需调用小模型生成文本只有当操作是 TYPE_TEXT 时，才调用一个小型文本模型生成输入内容（如城市名）。其他操作直接执行，不需要大模型参与。安全执行 + 快速等待使用真实的 DOM 节点执行动作，执行前会校验页面是否过期、元素是否被遮挡。输入后会短暂等待建议列表出现（最长约200ms），然后立即进入下一循环。整个循环可概括为：页面 → 索引元素表 → 操作+目标 → 执行 → 重新观测，直到模型选择 DONE 并独立验证结果。
二、本地安装与运行环境要求
Python 环境 + uvChrome 浏览器（支持远程调试）TypeSafe API Key 和文本模型 API Key（OpenRouter 等）安装步骤
git clone https://github.com/browser-use/jev-ultrafast.git
cd jev-ultrafast
uv sync
cp .env.example .env编辑 .env 文件，填入：
TYPESAFE_API_KEYTEXT_MODEL_API_KEY（示例配置使用 OpenRouter）启动本地演示：
uv run jev打开浏览器访问 http://127.0.0.1:8766，点击 Start demo → Run automatically。页面右侧会显示编号元素、操作概率、目标概率和执行记录。你也可以选择“Choose next”手动逐步确认。
如果 Chrome 连接有问题，可运行：
uv run browser-harness --doctor三、代码中直接使用最简单的调用方式：
from jev_ultrafast import Agent

with Agent(
"https://www.google.com/travel/flights?hl=en",
"Find one-way flights from Zurich to London on September 20, 2026, "
"for one adult in economy. Stop when matching flight options are visible.",
) as agent:
for state in agent.run():
print(state["elapsed_ms"], state["status"])运行命令：
uv run --env-file .env python your_script.py官方还提供了示例脚本：
uv run --env-file .env python examples/flights.py --keep-open你也可以换其他任务，比如打开维基百科指定文章：
uv run --env-file .env python examples/run.py \
--url https://en.wikipedia.org/wiki/Main_Page \
--goal 'Find and open the Wikipedia article about Gödel’s incompleteness theorems.'四、关键设计亮点与使用建议无站点特定脚本：策略完全通用，同一套逻辑可适配不同网站。不依赖截图：默认循环只使用结构化 DOM 状态，速度更快、成本更低。结果需独立验证：模型选择 DONE 后，系统会额外检查实际页面状态（城市、日期、航班列表是否正确）。当前限制：暂不支持 Shadow DOM、iframe、Canvas、文件上传、嵌套滚动等复杂场景。适合中等复杂度的表单和导航任务。性能参考（官方测量）：同一任务中位时间从约9.45秒降至7.09秒（提升约25%），浏览器协议调用从1092次降至101次。
五、总结Jev Ultrafast 把“理解页面”和“决定动作”解耦：用索引化的 DOM 状态替代视觉理解，用专用决策模型替代通用大模型的每步推理，只在真正需要输入文字时才调用文本模型。这种设计让浏览器代理真正进入了“秒级响应、分钱级成本”的实用阶段。
按照本教程操作，你很快就能在本地跑通演示，并尝试自己的任务目标。项目地址：https://github.com/browser-use/jev-ultrafast
试玩后如果有问题或想扩展功能，欢迎直接查看源码中的 agent.py、snapshot.js 和 model.py，代码量不大，非常适合学习和二次开发。