chore(i18n): refresh zh-CN translations

2026-04-29 19:35:37 +00:00 · 2026-04-29 19:35:37 +00:00 · 792ed72de8
commit 792ed72de8
parent ff365284c7
1 changed files with 57 additions and 49 deletions
--- a/docs/zh-CN/tools/web-fetch.md
+++ b/docs/zh-CN/tools/web-fetch.md
@ -1,29 +1,29 @@
 ---
 read_when:
-    - 你想要获取一个 URL 并提取可读内容
-    - 你需要配置 `web_fetch` 或其 Firecrawl 回退机制
-    - 你想了解 `web_fetch` 的限制和缓存机制
+    - 你想获取一个 URL 并提取可读内容
+    - 你需要配置 web_fetch 或其 Firecrawl 回退方案
+    - 你想了解 web_fetch 的限制和缓存
 sidebarTitle: Web Fetch
-summary: '`web_fetch` 工具——带有可读内容提取功能的 HTTP 获取工具'
-title: Web 获取
+summary: web_fetch 工具 -- 带可读内容提取的 HTTP 获取
+title: 网页获取
 x-i18n:
-    generated_at: "2026-04-24T02:52:01Z"
-    model: gpt-5.4
+    generated_at: "2026-04-29T19:35:13Z"
+    model: gpt-5.5
    provider: openai
-    source_hash: 56113bf358194d364a61f0e3f52b8f8437afc55565ab8dda5b5069671bc35735
+    source_hash: 430ff19fe477cff22bb88bc69f1fdd53185cb61c935f2b64481e98b2e5f4aff9
    source_path: tools/web-fetch.md
-    workflow: 15
+    workflow: 16
 ---

-`web_fetch` 工具会执行普通的 HTTP GET，并提取可读内容
-（将 HTML 转为 markdown 或文本）。它**不会**执行 JavaScript。
+`web_fetch` 工具执行普通的 HTTP GET，并提取可读内容
+（HTML 转为 markdown 或文本）。它**不会**执行 JavaScript。

-对于重度依赖 JS 的网站或受登录保护的页面，请改用
+对于大量依赖 JS 的站点或受登录保护的页面，请改用
 [Web Browser](/zh-CN/tools/browser)。

 ## 快速开始

-`web_fetch` **默认启用**——无需任何配置。智能体可以
+`web_fetch` **默认启用** -- 不需要配置。智能体可以
 立即调用它：

 ```javascript
@ -33,15 +33,15 @@ await web_fetch({ url: "https://example.com/article" });
 ## 工具参数

 <ParamField path="url" type="string" required>
-要获取的 URL。仅支持 `http(s)`。
+要获取的 URL。仅限 `http(s)`。
 </ParamField>

 <ParamField path="extractMode" type="'markdown' | 'text'" default="markdown">
-提取主体内容后的输出格式。
+主内容提取后的输出格式。
 </ParamField>

 <ParamField path="maxChars" type="number">
-将输出截断为最多这么多字符。
+将输出截断到这个字符数。
 </ParamField>

 ## 工作原理
@ -49,14 +49,14 @@ await web_fetch({ url: "https://example.com/article" });
 <Steps>
  <Step title="获取">
    发送带有类似 Chrome 的 User-Agent 和 `Accept-Language`
-    标头的 HTTP GET 请求。会阻止私有/内部主机名，并在重定向后再次检查。
+    标头的 HTTP GET。阻止私有/内部主机名，并重新检查重定向。
  </Step>
  <Step title="提取">
-    对 HTML 响应运行 Readability（主体内容提取）。
+    在 HTML 响应上运行 Readability（主内容提取）。
  </Step>
  <Step title="回退（可选）">
-    如果 Readability 失败，且已配置 Firecrawl，则会通过
-    Firecrawl API 以 bot-circumvention 模式重试。
+    如果 Readability 失败且已配置 Firecrawl，则通过启用机器人规避模式的
+    Firecrawl API 重试。
  </Step>
  <Step title="缓存">
    结果会缓存 15 分钟（可配置），以减少对同一 URL 的重复
@ -71,16 +71,20 @@ await web_fetch({ url: "https://example.com/article" });
  tools: {
    web: {
      fetch: {
-        enabled: true, // 默认值：true
-        provider: "firecrawl", // 可选；省略则自动检测
-        maxChars: 50000, // 输出字符数上限
-        maxCharsCap: 50000, // maxChars 参数的硬上限
-        maxResponseBytes: 2000000, // 截断前的最大下载大小
+        enabled: true, // default: true
+        provider: "firecrawl", // optional; omit for auto-detect
+        maxChars: 50000, // max output chars
+        maxCharsCap: 50000, // hard cap for maxChars param
+        maxResponseBytes: 2000000, // max download size before truncation
        timeoutSeconds: 30,
        cacheTtlMinutes: 15,
        maxRedirects: 3,
-        readability: true, // 使用 Readability 提取
-        userAgent: "Mozilla/5.0 ...", // 覆盖 User-Agent
+        readability: true, // use Readability extraction
+        userAgent: "Mozilla/5.0 ...", // override User-Agent
+        ssrfPolicy: {
+          allowRfc2544BenchmarkRange: true, // opt-in for trusted fake-IP proxies using 198.18.0.0/15
+          allowIpv6UniqueLocalRange: true, // opt-in for trusted fake-IP proxies using fc00::/7
+        },
      },
    },
  },
@ -90,14 +94,14 @@ await web_fetch({ url: "https://example.com/article" });
 ## Firecrawl 回退

 如果 Readability 提取失败，`web_fetch` 可以回退到
-[Firecrawl](/zh-CN/tools/firecrawl)，以实现 bot-circumvention 和更好的提取效果：
+[Firecrawl](/zh-CN/tools/firecrawl)，用于机器人规避和更好的提取效果：

 ```json5
 {
  tools: {
    web: {
      fetch: {
-        provider: "firecrawl", // 可选；省略则根据可用凭证自动检测
+        provider: "firecrawl", // optional; omit for auto-detect from available credentials
      },
    },
  },
@ -107,10 +111,10 @@ await web_fetch({ url: "https://example.com/article" });
        enabled: true,
        config: {
          webFetch: {
-            apiKey: "fc-...", // 如果已设置 FIRECRAWL_API_KEY，则为可选
+            apiKey: "fc-...", // optional if FIRECRAWL_API_KEY is set
            baseUrl: "https://api.firecrawl.dev",
            onlyMainContent: true,
-            maxAgeMs: 86400000, // 缓存时长（1 天）
+            maxAgeMs: 86400000, // cache duration (1 day)
            timeoutSeconds: 60,
          },
        },
@ -124,47 +128,51 @@ await web_fetch({ url: "https://example.com/article" });
 旧版 `tools.web.fetch.firecrawl.*` 配置会由 `openclaw doctor --fix` 自动迁移。

 <Note>
-  如果已启用 Firecrawl，且其 SecretRef 未解析，同时也没有
+  如果 Firecrawl 已启用，且其 SecretRef 未解析，也没有
  `FIRECRAWL_API_KEY` 环境变量回退，Gateway 网关启动会快速失败。
 </Note>

 <Note>
-  Firecrawl 的 `baseUrl` 覆盖受到严格限制：必须使用 `https://`，并且
+  Firecrawl `baseUrl` 覆盖受到锁定：它们必须使用 `https://`，并且
  必须是官方 Firecrawl 主机（`api.firecrawl.dev`）。
 </Note>

 当前运行时行为：

- `tools.web.fetch.provider` 会显式选择获取回退提供商。
- 如果省略 `provider`，OpenClaw 会从可用凭证中自动检测第一个可用的 web-fetch
-  提供商。目前内置的提供商是 Firecrawl。
- 如果禁用了 Readability，`web_fetch` 会直接跳到所选
-  提供商回退。如果没有可用提供商，它会以封闭失败的方式结束。
+- `tools.web.fetch.provider` 显式选择获取回退提供商。
+- 如果省略 `provider`，OpenClaw 会从可用凭证中自动检测第一个就绪的网页获取
+  提供商。目前内置提供商是 Firecrawl。
+- 如果禁用 Readability，`web_fetch` 会直接跳到选定的
+  提供商回退。如果没有可用提供商，它会失败关闭。

-## 限制与安全性
+## 限制与安全

- `maxChars` 会被限制到 `tools.web.fetch.maxCharsCap`
- 在解析前，响应体会受 `maxResponseBytes` 限制；过大的
-  响应会被截断，并附带警告
+- `maxChars` 会被限制在 `tools.web.fetch.maxCharsCap`
+- 响应正文会在解析前被限制在 `maxResponseBytes`；超大的
+  响应会被截断并给出警告
 - 私有/内部主机名会被阻止
+- `tools.web.fetch.ssrfPolicy.allowRfc2544BenchmarkRange` 和
+  `tools.web.fetch.ssrfPolicy.allowIpv6UniqueLocalRange` 是面向
+  受信任的 fake-IP 代理栈的狭窄选择启用项；除非你的代理拥有
+  这些合成范围并强制执行自己的目标策略，否则请保持未设置
 - 重定向会被检查，并受 `maxRedirects` 限制
- `web_fetch` 采用尽力而为模式——某些网站需要使用 [Web Browser](/zh-CN/tools/browser)
+- `web_fetch` 是尽力而为 -- 某些站点需要 [Web Browser](/zh-CN/tools/browser)

-## 工具配置档
+## 工具配置文件

-如果你使用工具配置档或 allowlist，请添加 `web_fetch` 或 `group:web`：
+如果你使用工具配置文件或允许列表，请添加 `web_fetch` 或 `group:web`：

 ```json5
 {
  tools: {
    allow: ["web_fetch"],
-    // 或：allow: ["group:web"]  （包含 web_fetch、web_search 和 x_search）
+    // or: allow: ["group:web"]  (includes web_fetch, web_search, and x_search)
  },
 }
 ```

 ## 相关内容

- [Web Search](/zh-CN/tools/web) —— 使用多个提供商搜索网页
- [Web Browser](/zh-CN/tools/browser) —— 用于重度依赖 JS 网站的完整浏览器自动化
- [Firecrawl](/zh-CN/tools/firecrawl) —— Firecrawl 搜索和抓取工具
+- [Web Search](/zh-CN/tools/web) -- 使用多个提供商搜索网络
+- [Web Browser](/zh-CN/tools/browser) -- 用于大量依赖 JS 的站点的完整浏览器自动化
+- [Firecrawl](/zh-CN/tools/firecrawl) -- Firecrawl 搜索和抓取工具