From 004d784e49397eece04b380d12d35524fdda1cb4 Mon Sep 17 00:00:00 2001 From: wehub-resource-sync Date: Mon, 13 Jul 2026 09:51:01 +0000 Subject: [PATCH] docs: make Chinese README the default --- README.md | 185 ++++++++++++++++++++++++++++-------------------------- 1 file changed, 96 insertions(+), 89 deletions(-) diff --git a/README.md b/README.md index d154fd3..b29f3ac 100644 --- a/README.md +++ b/README.md @@ -1,31 +1,37 @@ + +> [!NOTE] +> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。 +> [English](./README.en.md) · [原始项目](https://github.com/browser-use/browser-use) · [上游 README](https://github.com/browser-use/browser-use/blob/HEAD/README.md) +> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。 + - Shows a black Browser Use Logo in light color mode and a white one in dark color mode. + 在浅色模式下显示黑色 Browser Use 标志，在深色模式下显示白色标志。
- The AI browser agent. + AI 浏览器智能体（agent）。
-Browser-Use Package Download Statistics +Browser-Use 包下载统计
---
-Demos +演示 -Docs +文档 -Blog +博客 -Merch +周边 Github Stars @@ -33,64 +39,64 @@ Discord -Browser-Use Cloud +Browser Use Cloud

-# What can Browser Use do? +# Browser Use 能做什么？ -Browser Use lets an AI agent use a web browser the same way you do — it opens pages, clicks buttons, types, and fills in forms. You describe the task, and it completes it. For example, you can have it: +Browser Use 让 AI 智能体（agent）像你一样使用网页浏览器——打开页面、点击按钮、输入文字、填写表单。你描述任务，它就能完成。例如，你可以让它： -### 📋 Fill Forms -#### Task: "Fill in this job application with my resume and information." +### 📋 填写表单 +#### 任务："用我的简历和信息填写这份工作申请。" ![Job Application Demo](https://github.com/user-attachments/assets/57865ee6-6004-49d5-b2c2-6dff39ec2ba9) -[Example code ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/apply_to_job.py) +[示例代码 ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/apply_to_job.py) -### 🍎 Shop for Groceries -#### Task: "Put this list of items into my instacart." +### 🍎 购买日用品 +#### 任务："把这份物品清单加入我的 instacart。" https://github.com/user-attachments/assets/a6813fa7-4a7c-40a6-b4aa-382bf88b1850 -[Example code ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/buy_groceries.py) +[示例代码 ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/buy_groceries.py) -### 💻 Be Your Personal Assistant -#### Task: "Help me find parts for a custom PC." +### 💻 做你的个人助理 +#### 任务："帮我找组装定制 PC 的零件。" https://github.com/user-attachments/assets/ac34f75c-057a-43ef-ad06-5b2c9d42bf06 -[Example code ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/pcpartpicker.py) +[示例代码 ↗](https://github.com/browser-use/browser-use/blob/main/examples/use-cases/pcpartpicker.py)
-# Quickstart +# 快速入门 -If you want to use Browser Use in your agent (Claude Code, Codex, Cursor, Hermes, OpenClaw, etc.), paste this prompt, and it sets everything up itself: +如果你想在智能体（Claude Code、Codex、Cursor、Hermes、OpenClaw 等）中使用 Browser Use，粘贴这段提示词，它会自动完成所有设置： ```text Install or upgrade browser-use to the latest stable version with uv using Python 3.12, run `browser-use skill install` to register the skill, and connect it to my browser. If setup or connection fails, follow https://github.com/browser-use/browser-harness/blob/main/install.md. ``` -Then tell your agent what you want done. +然后告诉你的智能体你想做什么。
-# Python library: the easiest way to automate the web +# Python 库：自动化网页的最简方式 -Want to automate the web at scale, from your own code, and with any LLM? Use the Python library: +想在自己的代码里、配合任意大语言模型（LLM）、大规模自动化网页操作？请使用 Python 库： -**1. Install Browser Use (Python >= 3.11):** +**1. 安装 Browser Use（Python >= 3.11）：** ```bash uv add browser-use # or: pip install browser-use ``` -**2. Add your LLM API key to `.env`**. Get one from [Browser Use Cloud](https://cloud.browser-use.com/new-api-key?utm_source=github&utm_medium=readme-quickstart-api-key), or bring your own provider key: +**2. 将你的 LLM API 密钥添加到 `.env`**。可从 [Browser Use Cloud](https://cloud.browser-use.com/new-api-key?utm_source=github&utm_medium=readme-quickstart-api-key), 获取，或使用你自己的服务商密钥： ```bash # .env @@ -99,7 +105,7 @@ BROWSER_USE_API_KEY=your-key # ANTHROPIC_API_KEY=your-key ``` -**3. Run your first agent:** +**3. 运行你的第一个智能体：** ```python import asyncio @@ -120,70 +126,71 @@ if __name__ == "__main__": asyncio.run(main()) ``` -Check out the [library docs](https://docs.browser-use.com/open-source/introduction) and the [cloud docs](https://docs.cloud.browser-use.com?utm_source=github&utm_medium=readme-cloud-docs) for more! +更多内容请参阅[库文档](https://docs.browser-use.com/open-source/introduction) 和[云端文档](https://docs.cloud.browser-use.com?utm_source=github&utm_medium=readme-cloud-docs)！
-# Open Source vs Cloud +# 开源版 vs 云端版 - BU Bench V1 - LLM Success Rates + BU Bench V1 - LLM 成功率 -We benchmark Browser Use across 100 real-world browser tasks. Full benchmark is open source: **[browser-use/benchmark](https://github.com/browser-use/benchmark)**. +我们在 100 个真实浏览器任务上对 Browser Use 进行基准测试。完整基准测试已开源：**[browser-use/benchmark](https://github.com/browser-use/benchmark)**. -Browser Use is also **#1 on the [Odysseys leaderboard](https://odysseysbench.com/leaderboard)** with an 87.4% average, ahead of computer-use agents from OpenAI, Anthropic, Google, and Microsoft. Odysseys measures the agent's performance on 200 long-horizon web tasks. +Browser Use 在 **[Odysseys 排行榜](https://odysseysbench.com/leaderboard)** 上也位列 **#1**，平均得分 87.4%，领先于 OpenAI、Anthropic、Google 和 Microsoft 的 computer-use 智能体。Odysseys 会衡量智能体在 200 个长周期网页任务上的表现。 -**Use the Open-Source Agent** -- Free, and runs on your own machine -- Deep code-level integration and control: pick your LLM, customize the agent's behavior -- We recommend pairing it with our [cloud browsers](https://docs.browser-use.com/open-source/customize/browser/remote) for leading stealth, proxy rotation, and scaling +**使用开源智能体** +- 免费，可在本机运行 +- 深度代码级集成与控制：自选 LLM、自定义智能体行为 +- 建议搭配我们的[云端浏览器](https://docs.browser-use.com/open-source/customize/browser/remote)，以获得领先的隐身能力、代理轮换和弹性扩展 -**Use the [Fully-Hosted Cloud Agent](https://cloud.browser-use.com?utm_source=github&utm_medium=readme-hosted-agent) (recommended)** -- Much more powerful agent for complex tasks (see plot above) -- Easiest way to start and scale -- Best stealth with proxy rotation and captcha solving -- 1000+ integrations (Gmail, Slack, Notion, and more) -- Persistent filesystem and memory +**使用[全托管云端智能体](https://cloud.browser-use.com?utm_source=github&utm_medium=readme-hosted-agent)（推荐）** +- 应对复杂任务的智能体能力更强（见上图） +- 上手和扩展最简单的方式 +- 最佳隐身能力，支持代理轮换与验证码（captcha）破解 +- 1000+ 集成（Gmail、Slack、Notion 等） +- 持久化文件系统与记忆
-## Integrations, hosting, custom tools, MCP, and more on our [Docs ↗](https://docs.browser-use.com) +## 集成、托管、自定义工具、MCP 等更多内容，请查看我们的[文档 ↗](https://docs.browser-use.com)
-# FAQ +# 常见问题
-Should I use the CLI vs. the Python library? +我该用 CLI 还是 Python 库？ -**Use the CLI** if you already have an agent (Claude Code, Codex, Cursor, Hermes, OpenClaw, etc.) that you want to complete browser tasks for you. The agent installs the skill once (see [Quickstart](#quickstart)) and can then control the browser. Examples: -- "Upload this video to YouTube" -- "Compare these three laptops and give me a table with prices" -- "Fill in this job application with my resume" +**使用 CLI**：如果你已有智能体（Claude Code、Codex、Cursor、Hermes、OpenClaw 等），想让它帮你完成浏览器任务。智能体只需安装一次技能（见[快速入门](#quickstart)），之后即可控制浏览器。示例： +- "把这个视频上传到 YouTube" +- "对比这三台笔记本电脑，给我一张带价格的表格" +- "用我的简历填写这份工作申请" -**Use the Python library** when you are building software that automates the web. Examples: -- Run many tasks on a schedule or in parallel (scraping, monitoring, QA) -- Embed a browser agent into your own product -- Custom tools, custom system prompts, structured output, fine-grained browser control +**使用 Python 库**：当你要构建自动化网页的软件时。示例： +- 按计划或并行运行大量任务（抓取、监控、QA） +- 将浏览器智能体嵌入你自己的产品 +- 自定义工具、自定义系统提示词、结构化输出、细粒度浏览器控制 -Rule of thumb: one-off tasks through an agent → CLI. Repeatable automation in code → Python library. +经验法则：通过智能体做一次性任务 → CLI；在代码中做可重复自动化 → Python 库。
-What's the best model to use? +最好用什么模型？ -We optimized **ChatBrowserUse()** specifically for browser automation tasks. On avg it completes tasks 3-5x faster than other models with SOTA accuracy. +我们专门针对浏览器自动化任务优化了 **ChatBrowserUse()**。平均而言，它在达到 SOTA 准确率的同时，完成任务的速度比其他模型快 3-5 倍。 +
-For pricing and other LLM providers, see our [supported models documentation](https://docs.browser-use.com/supported-models). +关于定价及其他 LLM 提供商，请参阅我们的[支持的模型文档](https://docs.browser-use.com/supported-models).
-Can I use Claude / GPT / Gemini through ChatBrowserUse? +能否通过 ChatBrowserUse 使用 Claude / GPT / Gemini？ -Yes. `ChatBrowserUse` accepts provider-prefixed model ids, so a single `BROWSER_USE_API_KEY` reaches all of them — no separate OpenAI/Anthropic/Google keys required: +可以。`ChatBrowserUse` 接受带提供商前缀的 model id，因此单个 `BROWSER_USE_API_KEY` 即可访问全部模型——无需单独的 OpenAI/Anthropic/Google 密钥： ```python from browser_use import Agent, ChatBrowserUse @@ -192,23 +199,23 @@ llm = ChatBrowserUse(model='anthropic/claude-sonnet-4-6') # or 'openai/gpt-5.5' agent = Agent(task='...', llm=llm) ``` -For the best speed and cost we still recommend the default `bu-*` models. +为获得最佳速度与成本，我们仍推荐使用默认的 `bu-*` 模型。
-Should I use the Browser Use system prompt with the open-source preview model? +使用开源预览模型时，是否应使用 Browser Use 系统提示词（system prompt）？ -Yes. If you use `ChatBrowserUse(model='browser-use/bu-30b-a3b-preview')` with a normal `Agent(...)`, Browser Use still sends its default agent system prompt for you. +是的。若将 `ChatBrowserUse(model='browser-use/bu-30b-a3b-preview')` 与普通的 `Agent(...)` 搭配使用，Browser Use 仍会为你发送其默认的 agent 系统提示词。 -You do **not** need to add a separate custom "Browser Use system message" just because you switched to the open-source preview model. Only use `extend_system_message` or `override_system_message` when you intentionally want to customize the default behavior for your task. +切换到开源预览模型后，你**无需**额外添加自定义的「Browser Use 系统消息」。仅当你有意针对任务自定义默认行为时，才使用 `extend_system_message` 或 `override_system_message`。 -If you want the best default speed/accuracy, we still recommend the newer hosted `bu-*` models. If you want the open-source preview model, the setup stays the same apart from the `model=` value. +若追求默认情况下的最佳速度/准确度，我们仍推荐使用较新的托管 `bu-*` 模型。若使用开源预览模型，除 `model=` 取值外，配置方式保持不变。
-Can I use custom tools with the agent? +能否为 agent 使用自定义工具？ -Yes! You can add custom tools to extend the agent's capabilities: +可以！你可以添加自定义工具以扩展 agent 的能力： ```python from browser_use import Tools @@ -230,52 +237,52 @@ agent = Agent(
-Can I use this for free? +可以免费使用吗？ -Yes! Browser-Use is open source and free to use. You only need to choose an LLM provider (like OpenAI, Google, ChatBrowserUse, or run local models with Ollama). +可以！Browser-Use 是开源的，可免费使用。你只需选择 LLM 提供商（如 OpenAI、Google、ChatBrowserUse，或通过 Ollama 在本地运行模型）。
-Terms of Service +服务条款 -This open-source library is licensed under the MIT License. For Browser Use services & data policy, see our [Terms of Service](https://browser-use.com/legal/terms-of-service) and [Privacy Policy](https://browser-use.com/privacy/). +本开源库采用 MIT License 许可。有关 Browser Use 服务与数据政策，请参阅我们的[服务条款](https://browser-use.com/legal/terms-of-service) 和[隐私政策](https://browser-use.com/privacy/).
-How do I handle authentication? +如何处理身份验证？ -Check out our authentication examples: -- [Using real browser profiles](https://github.com/browser-use/browser-use/blob/main/examples/browser/real_browser.py) - Reuse your existing Chrome profile with saved logins -- If you want to use temporary accounts with inbox, choose AgentMail -- To sync your auth profile with the remote browser, run `curl -fsSL https://browser-use.com/profile.sh | BROWSER_USE_API_KEY=XXXX sh` (replace XXXX with your API key) +请参阅我们的身份验证示例： +- [使用真实浏览器配置文件](https://github.com/browser-use/browser-use/blob/main/examples/browser/real_browser.py) - 复用已保存登录信息的现有 Chrome 配置文件 +- 若需使用带收件箱的临时账号，可选择 AgentMail +- 要将身份验证配置文件同步到远程浏览器，请运行 `curl -fsSL https://browser-use.com/profile.sh | BROWSER_USE_API_KEY=XXXX sh`（将 XXXX 替换为你的 API key） -These examples show how to maintain sessions and handle authentication seamlessly. +这些示例展示了如何无缝维护会话并处理身份验证。
-How do I solve CAPTCHAs? +如何解决 CAPTCHA？ -For CAPTCHA handling, you need better browser fingerprinting and proxies. Use [Browser Use Cloud](https://cloud.browser-use.com?utm_source=github&utm_medium=readme-faq-captcha) which provides stealth browsers designed to avoid detection and CAPTCHA challenges. +处理 CAPTCHA 需要更好的浏览器指纹与代理。请使用 [Browser Use Cloud](https://cloud.browser-use.com?utm_source=github&utm_medium=readme-faq-captcha)，它提供专为规避检测与 CAPTCHA 挑战而设计的隐身浏览器。
-How do I go into production? +如何投入生产环境？ -Chrome can consume a lot of memory, and running many agents in parallel can be tricky to manage. +Chrome 会占用大量内存，并行运行多个 agent 的管理也可能较为棘手。 -For production use cases, use our [Browser Use Cloud API](https://cloud.browser-use.com?utm_source=github&utm_medium=readme-faq-production) which handles: -- Scalable browser infrastructure -- Memory management -- Proxy rotation -- Stealth browser fingerprinting -- High-performance parallel execution +生产场景请使用我们的 [Browser Use Cloud API](https://cloud.browser-use.com?utm_source=github&utm_medium=readme-faq-production)，它提供： +- 可扩展的浏览器基础设施 +- 内存管理 +- 代理轮换 +- 隐身浏览器指纹 +- 高性能并行执行

-## Citation +## 引用 -If you use Browser Use in your research or project, please cite: +若在你的研究或项目中使用了 Browser Use，请引用： ```bibtex @software{browser_use2024, @@ -291,7 +298,7 @@ If you use Browser Use in your research or project, please cite:
-**Tell your computer what to do, and it gets it done.** +**告诉电脑做什么，它就能帮你完成。**