docs: make Chinese README the default

README.md

@@ -1,31 +1,37 @@
+<!-- WEHUB_ZH_README -->
+> [!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 文件为准。
+
 <picture>
   <source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/2ccdb752-22fb-41c7-8948-857fc1ad7e24">
   <source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/774a46d5-27a0-490c-b7d0-e65fcbbfa358">
-  <img alt="Shows a black Browser Use Logo in light color mode and a white one in dark color mode." src="https://github.com/user-attachments/assets/2ccdb752-22fb-41c7-8948-857fc1ad7e24"  width="full">
+  <img alt="在浅色模式下显示黑色 Browser Use 标志，在深色模式下显示白色标志。" src="https://github.com/user-attachments/assets/2ccdb752-22fb-41c7-8948-857fc1ad7e24"  width="full">
 </picture>
 
 <div align="center">
     <picture>
     <source media="(prefers-color-scheme: light)" srcset="https://github.com/user-attachments/assets/9955dda9-ede3-4971-8ee0-91cbc3850125">
     <source media="(prefers-color-scheme: dark)" srcset="https://github.com/user-attachments/assets/6797d09b-8ac3-4cb9-ba07-b289e080765a">
-    <img alt="The AI browser agent." src="https://github.com/user-attachments/assets/9955dda9-ede3-4971-8ee0-91cbc3850125"  width="400">
+    <img alt="AI 浏览器智能体（agent）。" src="https://github.com/user-attachments/assets/9955dda9-ede3-4971-8ee0-91cbc3850125"  width="400">
     </picture>
 </div>
 
 <div align="center">
-<a href="https://cloud.browser-use.com?utm_source=github&utm_medium=readme-badge-downloads"><img src="https://media.browser-use.tools/badges/package" height="48" alt="Browser-Use Package Download Statistics"></a>
+<a href="https://cloud.browser-use.com?utm_source=github&utm_medium=readme-badge-downloads"><img src="https://media.browser-use.tools/badges/package" height="48" alt="Browser-Use 包下载统计"></a>
 </div>
 
 ---
 
 <div align="center">
-<a href="#what-can-browser-use-do"><img src="https://media.browser-use.tools/badges/demos" alt="Demos"></a>
+<a href="#what-can-browser-use-do"><img src="https://media.browser-use.tools/badges/demos" alt="演示"></a>
 <img width="16" height="1" alt="">
-<a href="https://docs.browser-use.com"><img src="https://media.browser-use.tools/badges/docs" alt="Docs"></a>
+<a href="https://docs.browser-use.com"><img src="https://media.browser-use.tools/badges/docs" alt="文档"></a>
 <img width="16" height="1" alt="">
-<a href="https://browser-use.com/posts"><img src="https://media.browser-use.tools/badges/blog" alt="Blog"></a>
+<a href="https://browser-use.com/posts"><img src="https://media.browser-use.tools/badges/blog" alt="博客"></a>
 <img width="16" height="1" alt="">
-<a href="https://browsermerch.com"><img src="https://media.browser-use.tools/badges/merch" alt="Merch"></a>
+<a href="https://browsermerch.com"><img src="https://media.browser-use.tools/badges/merch" alt="周边"></a>
 <img width="100" height="1" alt="">
 <a href="https://github.com/browser-use/browser-use"><img src="https://media.browser-use.tools/badges/github" alt="Github Stars"></a>
 <img width="4" height="1" alt="">
@@ -33,64 +39,64 @@
 <img width="4" height="1" alt="">
 <a href="https://link.browser-use.com/discord"><img src="https://media.browser-use.tools/badges/discord" alt="Discord"></a>
 <img width="4" height="1" alt="">
-<a href="https://cloud.browser-use.com?utm_source=github&utm_medium=readme-badge-cloud"><img src="https://media.browser-use.tools/badges/cloud" height="48" alt="Browser-Use Cloud"></a>
+<a href="https://cloud.browser-use.com?utm_source=github&utm_medium=readme-badge-cloud"><img src="https://media.browser-use.tools/badges/cloud" height="48" alt="Browser Use Cloud"></a>
 </div>
 
 </br>
 
-# 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)
 
 
 <br/>
 
-# 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.
+然后告诉你的智能体你想做什么。
 
 <br/>
 
-# 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)！
 
 <br/>
 
-# Open Source vs Cloud
+# 开源版 vs 云端版
 
 <picture>
   <source media="(prefers-color-scheme: light)" srcset="static/accuracy_by_model_light.png">
   <source media="(prefers-color-scheme: dark)" srcset="static/accuracy_by_model_dark.png">
-  <img alt="BU Bench V1 - LLM Success Rates" src="static/accuracy_by_model_light.png" width="100%">
+  <img alt="BU Bench V1 - LLM 成功率" src="static/accuracy_by_model_light.png" width="100%">
 </picture>
 
-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 等）
+- 持久化文件系统与记忆
 
 <br/>
 
-## Integrations, hosting, custom tools, MCP, and more on our [Docs ↗](https://docs.browser-use.com)
+## 集成、托管、自定义工具、MCP 等更多内容，请查看我们的[文档 ↗](https://docs.browser-use.com)
 
 <br/>
 
-# FAQ
+# 常见问题
 
 <details>
-<summary><b>Should I use the CLI vs. the Python library?</b></summary>
+<summary><b>我该用 CLI 还是 Python 库？</b></summary>
 
-**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 库。
 </details>
 
 <details>
-<summary><b>What's the best model to use?</b></summary>
+<summary><b>最好用什么模型？</b></summary>
 
-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 倍。
+</details>
 
-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).
 </details>
 
 <details>
-<summary><b>Can I use Claude / GPT / Gemini through ChatBrowserUse?</b></summary>
+<summary><b>能否通过 ChatBrowserUse 使用 Claude / GPT / Gemini？</b></summary>
 
-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-*` 模型。
 </details>
 
 <details>
-<summary><b>Should I use the Browser Use system prompt with the open-source preview model?</b></summary>
+<summary><b>使用开源预览模型时，是否应使用 Browser Use 系统提示词（system prompt）？</b></summary>
 
-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=` 取值外，配置方式保持不变。
 </details>
 
 <details>
-<summary><b>Can I use custom tools with the agent?</b></summary>
+<summary><b>能否为 agent 使用自定义工具？</b></summary>
 
-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(
 </details>
 
 <details>
-<summary><b>Can I use this for free?</b></summary>
+<summary><b>可以免费使用吗？</b></summary>
 
-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 在本地运行模型）。
 </details>
 
 <details>
-<summary><b>Terms of Service</b></summary>
+<summary><b>服务条款</b></summary>
 
-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/).
 </details>
 
 <details>
-<summary><b>How do I handle authentication?</b></summary>
+<summary><b>如何处理身份验证？</b></summary>
 
-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.
+这些示例展示了如何无缝维护会话并处理身份验证。
 </details>
 
 <details>
-<summary><b>How do I solve CAPTCHAs?</b></summary>
+<summary><b>如何解决 CAPTCHA？</b></summary>
 
-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 挑战而设计的隐身浏览器。
 </details>
 
 <details>
-<summary><b>How do I go into production?</b></summary>
+<summary><b>如何投入生产环境？</b></summary>
 
-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)，它提供：
+- 可扩展的浏览器基础设施
+- 内存管理
+- 代理轮换
+- 隐身浏览器指纹
+- 高性能并行执行
 </details>
 
 <br/>
 
-## 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:
 
 <div align="center">
 
-**Tell your computer what to do, and it gets it done.**
+**告诉电脑做什么，它就能帮你完成。**
 
 <img src="https://github.com/user-attachments/assets/06fa3078-8461-4560-b434-445510c1766f" width="400"/>