跳转到主要内容

Documentation Index

Fetch the complete documentation index at: https://docs.bubench.lexmount.io/llms.txt

Use this file to discover all available pages before exploring further.

Lexmount 提供基于云的浏览器实例，用于运行浏览器自动化任务。支持会话保持、登录态管理和大规模并行执行。

​
服务地址

Lexmount 提供两个生产环境，按评测实际运行所在地区选择：
环境管理后台API base URL
生产（国内）browser.lexmount.cnhttps://api.lexmount.cn
生产（国外）browser.lexmount.comhttps://api.lexmount.com
API base URL 可选 —— SDK 默认使用国内地址。在 .env 中配置 LEXMOUNT_BASE_URL，或在 config.yaml 中设置 lexmount_base_url 即可覆盖默认值（国外用户建议切换到 .com）。

​
前置条件

1

获取 API Key

到 Lexmount 管理后台注册账号（国内用 browser.lexmount.cn，国外用 browser.lexmount.com），申请 API Key。
2

获取 Project ID

在同一后台创建项目，获取 Project ID。

​
配置

在 .env 中添加凭证： 
LEXMOUNT_API_KEY=your_api_key
LEXMOUNT_PROJECT_ID=your_project_id
先复制示例配置（cp config.example.yaml config.yaml），再在根目录 config.yaml 中为对应 Agent 配置云浏览器： 
# config.yaml
agents:
  browser-use:
    browser:
      browser_id: lexmount
      lexmount_browser_mode: normal   # normal | light
      lexmount_api_key: $LEXMOUNT_API_KEY
      lexmount_project_id: $LEXMOUNT_PROJECT_ID

​
登录态管理（Login Contexts）

对于需要登录的任务，使用 bubench login 子命令在 Lexmount 上创建持久化 Context 并保存登录态。评测运行时会根据任务的 target_website 自动 fork 该 Context，一次登录可供多次并发评测复用。

​
Step 1: 创建登录态

# 小红书
bubench login add xiaohongshu

# 淘宝
bubench login add taobao

# 自定义 URL（未内置的站点）
bubench login add my_site --website https://example.com/login
执行后终端会输出 Inspect URL。在本地浏览器打开该 URL，完成登录后回到终端按 Enter 保存 Cookie 到 Context。
内置近百个常见站点（电商、社交、视频、办公协作等）。运行 bubench login add help 可查看全部站点清单，或编辑 browseruse_bench/browsers/login_sites.yaml 追加新站点。

​
Step 2: 登录流程

1

运行命令

bubench login add <site> 会创建 Context → 打开远程会话 → 打印 Inspect URL
2

在浏览器中登录

复制终端输出的 Inspect URL，在本地浏览器打开，远程 Chrome 页面已自动跳转到目标站点
3

确认保存

登录完成后，回到终端按 Enter。脚本会关闭会话，Cookie 自动持久化到 Context
登录态记录保存在 browser_data/login_contexts/index.json。

​
Step 3: 其他命令

# 查看所有已保存的登录态
bubench login list

# 删除本地映射（保留远端 Context）
bubench login remove xiaohongshu

# 同时删除远端 Lexmount Context
bubench login remove xiaohongshu --delete-remote

​
运行需要登录的任务

只要任务的 login_required: true 且 target_website 能解析到已登录站点，运行时会自动挂载对应 Context，无需额外参数：
1

确保已登录

bubench login list 查看目标站点是否已在列表中
2

使用 Normal 模式

# config.yaml
agents:
  browser-use:
    browser:
      browser_id: lexmount
      lexmount_browser_mode: normal
3

运行任务

bubench run \
  --agent browser-use \
  --data LexBench-Browser \
  --mode first_n --count 5

​
优势

无需本地浏览器

在服务器环境运行，无需安装 Chrome

会话持久化

登录状态跨任务保持，无需重复登录

并行执行

支持多个浏览器实例并行运行

稳定可靠

云端隔离环境，避免本地资源冲突

​
注意事项

  • 云浏览器会产生费用，请合理使用
  • Normal 模式的会话有过期时间，请定期检查登录状态
  • 不要在公开环境暴露 API Key