Skip to content

🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev

70.7 KB
Raw Blame
{% set translations = {
  "<p>This class is returned by all engines as a way to unify the response type between different libraries.</p>": "<p>所有引擎都返回此类,用于统一不同库的响应类型。</p>",
  "<p>HTTP status code.</p>": "<p>HTTP 状态码。</p>",
  "<p>HTTP status message.</p>": "<p>HTTP 状态消息。</p>",
  "<p>Response cookies.</p>": "<p>响应中的 Cookie。</p>",
  "<p>Response headers.</p>": "<p>响应头。</p>",
  "<p>Request headers sent with the request.</p>": "<p>随请求发送的请求头。</p>",
  "<p>List of redirect responses, if any.</p>": "<p>重定向响应列表,如果有的话。</p>",
  "<p>Metadata dictionary (e.g., proxy used).</p>": "<p>元数据字典,例如使用的代理。</p>",
  "<p>Associated spider Request object (set by crawler, in the spiders framework).</p>": "<p>关联的 Spider Request 对象,由 Spider 框架中的爬虫设置。</p>",
  "<p>The main class that works as a wrapper for the HTML input data. Using this class, you can search for elements\nwith expressions in CSS, XPath, or with simply text. Check the docs for more info.</p>": "<p>封装输入 HTML 数据的主要类。可以用 CSS、XPath 表达式或简单文本查找元素。更多信息请查看文档。</p>",
  "<p>Here we try to extend module <code>lxml.html.HtmlElement</code> while maintaining a simpler interface, We are not\ninheriting from the <code>lxml.html.HtmlElement</code> because it's not pickleable, which makes a lot of reference jobs\nnot possible. You can test it here and see code explodes with <code>AssertionError: invalid Element proxy at...</code>.\nIt's an old issue with lxml, see <code>this entry &lt;https://bugs.launchpad.net/lxml/+bug/736708&gt;</code></p>": "<p>此类扩展了 <code>lxml.html.HtmlElement</code> 的功能,同时提供更简单的接口。它不继承 <code>lxml.html.HtmlElement</code>,因为该类型无法通过 pickle 序列化,会使许多依赖引用的操作无法完成。尝试这样做会出现 <code>AssertionError: invalid Element proxy at...</code>。这是 lxml 的一个老问题,详见 <code>this entry &lt;https://bugs.launchpad.net/lxml/+bug/736708&gt;</code>。</p>",
  "<p>HTML content as either string or bytes.</p>": "<p>字符串或 bytes 形式的 HTML 内容。</p>",
  "<p>It allows storing a URL with the HTML data for retrieving later.</p>": "<p>允许将 URL 与 HTML 数据一起保存,供以后读取。</p>",
  "<p>The encoding type that will be used in HTML parsing, default is <code>UTF-8</code></p>": "<p>解析 HTML 时使用的编码,默认为 <code>UTF-8</code>。</p>",
  "<p>Enabled by default, should always be enabled when parsing large HTML documents. This controls\nthe libxml2 feature that forbids parsing certain large documents to protect from possible memory exhaustion.</p>": "<p>默认启用,解析大型 HTML 文档时应始终启用。它控制 libxml2 的一项功能,该功能会禁止解析某些大型文档,以避免内存耗尽。</p>",
  "<p>Used internally to pass etree objects instead of text/body arguments, it takes the highest priority.\nDon't use it unless you know what you are doing!</p>": "<p>内部用于传入 etree 对象,代替文本或响应体参数,优先级最高。只有了解其影响时才应使用。</p>",
  "<p>While parsing the HTML body, drop comments or not. Disabled by default for obvious reasons</p>": "<p>解析 HTML 时是否保留注释,默认关闭。</p>",
  "<p>Globally turn off the adaptive feature in all functions, this argument takes higher\npriority over all adaptive related arguments/functions in the class.</p>": "<p>在所有方法中全局关闭自适应功能。此参数的优先级高于类中所有与自适应有关的参数和方法。</p>",
  "<p>The storage class to be passed for adaptive functionalities, see <code>Docs</code> for more info.</p>": "<p>自适应功能使用的存储类。更多信息请查看 <code>Docs</code>。</p>",
  "<p>A dictionary of <code>argument-&gt;value</code> pairs to be passed for the storage class.\nIf empty, default values will be used.</p>": "<p>传给存储类的 <code>argument-&gt;value</code> 键值对字典。为空时使用默认值。</p>",
  "<p>Return the raw body of the current <code>Selector</code> without any processing. Useful for binary and non-HTML requests.</p>": "<p>返回当前 <code>Selector</code> 未经处理的原始响应体,适用于二进制和非 HTML 内容。</p>",
  "<p>Return the raw body of the response as bytes.</p>": "<p>以 bytes 形式返回响应的原始响应体。</p>",
  "<p>Generate a CSS selector for the current element</p>": "<p>为当前元素生成 CSS 选择器。</p>",
  "<p>A string of the generated selector.</p>": "<p>包含所生成选择器的字符串。</p>",
  "<p>Generate a complete CSS selector for the current element</p>": "<p>为当前元素生成完整的 CSS 选择器。</p>",
  "<p>Generate an XPath selector for the current element</p>": "<p>为当前元素生成 XPath 选择器。</p>",
  "<p>Generate a complete XPath selector for the current element</p>": "<p>为当前元素生成完整的 XPath 选择器。</p>",
  "<p>Get the tag name of the element</p>": "<p>获取元素的标签名。</p>",
  "<p>Get text content of the element</p>": "<p>获取元素的文本内容。</p>",
  "<p>Get attributes of the element</p>": "<p>获取元素的属性。</p>",
  "<p>Return the inner HTML code of the element</p>": "<p>返回元素内部的 HTML 代码。</p>",
  "<p>Return the direct parent of the element or <code>None</code> otherwise</p>": "<p>返回元素的直接父元素,如果没有则返回 <code>None</code>。</p>",
  "<p>Return all elements under the current element in the DOM tree</p>": "<p>返回 DOM 树中当前元素下方的所有元素。</p>",
  "<p>Return the children elements of the current element or empty list otherwise</p>": "<p>返回当前元素的子元素,如果没有则返回空列表。</p>",
  "<p>Return other children of the current element's parent or empty list otherwise</p>": "<p>返回当前元素的父元素下的其他子元素,如果没有则返回空列表。</p>",
  "<p>Returns a list of type <code>Selectors</code> that contains the path leading to the current element from the root.</p>": "<p>返回 <code>Selectors</code> 类型的列表,包含从根节点到当前元素的路径。</p>",
  "<p>Returns the next element of the current element in the children of the parent or <code>None</code> otherwise.</p>": "<p>返回同一父元素下,当前元素之后的下一个元素,如果没有则返回 <code>None</code>。</p>",
  "<p>Returns the previous element of the current element in the children of the parent or <code>None</code> otherwise.</p>": "<p>返回同一父元素下,当前元素之前的上一个元素,如果没有则返回 <code>None</code>。</p>",
  "<p>Convert the response content to clean Markdown.</p>": "<p>将响应内容转换为干净的 Markdown。</p>",
  "<p>Scripts, styles, and hidden/prompt-injection content are always removed before conversion, which is\nthe same cleaning the MCP server does. Requires the \"markdownify\" package (<code>pip install \"scrapling[rag]\"</code>).</p>": "<p>转换前会始终移除脚本、样式、隐藏内容和提示词注入内容,与 MCP 服务器使用的清理方式相同。需要安装 \"markdownify\" 包(<code>pip install \"scrapling[rag]\"</code>)。</p>",
  "<p>CSS selector to convert only the matching elements. All matches are concatenated.</p>": "<p>用于限定转换范围的 CSS 选择器。只转换匹配的元素,并合并所有结果。</p>",
  "<p>Convert only the content inside the <code>&lt;body&gt;</code> tag.</p>": "<p>只转换 <code>&lt;body&gt;</code> 标签内的内容。</p>",
  "<p>Create a Request to follow a URL.</p>": "<p>创建一个 Request 来跟随 URL。</p>",
  "<p>This is a helper method for spiders to easily follow links found in pages.</p>": "<p>这是一个辅助方法,方便 Spider 跟随页面中的链接。</p>",
  "<p><strong>IMPORTANT</strong>: The below arguments if left empty, the corresponding value from the previous request will be used. The only exception is <code>dont_filter</code>.</p>": "<p><strong>重要</strong>:下列参数如果留空,会使用前一个请求的对应值。唯一例外是 <code>dont_filter</code>。</p>",
  "<p>The session kwargs of the previous request are inherited as well, except <code>method</code>, <code>params</code>, <code>data</code>, <code>json</code>, <code>files</code>, and <code>multipart</code>, so a followed link is a plain GET unless you pass them again.</p>": "<p>前一个请求的会话参数也会继承,但不包括 <code>method</code>、<code>params</code>、<code>data</code>、<code>json</code>、<code>files</code> 和 <code>multipart</code>。因此,除非再次传入这些参数,否则跟随链接时会发送普通 GET 请求。</p>",
  "<p>The URL to follow (can be relative, will be joined with current URL)</p>": "<p>要跟随的 URL。可以是相对 URL,会与当前 URL 合并。</p>",
  "<p>The session id to use</p>": "<p>要使用的会话 ID。</p>",
  "<p>Spider callback method to use</p>": "<p>要使用的 Spider 回调方法。</p>",
  "<p>The priority number to use, the higher the number, the higher priority to be processed first.</p>": "<p>优先级数值,值越大,越先处理。</p>",
  "<p>If this request has been done before, disable the filter to allow it again.</p>": "<p>关闭过滤,让已经发送过的请求也能再次执行。</p>",
  "<p>Additional meta data to included in the request</p>": "<p>要加入请求的额外元数据。</p>",
  "<p>Enabled by default, set the current response url as referer for the new request url.</p>": "<p>默认启用,将当前响应的 URL 设为新请求的 Referer。</p>",
  "<p>Additional Request arguments</p>": "<p>额外的 Request 参数。</p>",
  "<p>Request object ready to be yielded</p>": "<p>可以通过 yield 产出的 Request 对象。</p>",
  "<p>Get all child strings of this element, concatenated using the given separator.</p>": "<p>获取此元素下的所有字符串,并用指定分隔符连接。</p>",
  "<p>Strings will be concatenated using this separator.</p>": "<p>连接字符串时使用的分隔符。</p>",
  "<p>If True, strings will be stripped before being concatenated.</p>": "<p>为 True 时,先去除各字符串两端的空白,再连接。</p>",
  "<p>A tuple of all tag names you want to ignore</p>": "<p>包含所有要忽略的标签名的元组。</p>",
  "<p>If enabled, elements with text-content that is empty or only whitespaces will be ignored</p>": "<p>启用后,忽略文本为空或只包含空白的元素。</p>",
  "<p>A TextHandler</p>": "<p>一个 TextHandler。</p>",
  "<p>Join this Selector's url with a relative url to form an absolute full URL.</p>": "<p>将此 Selector 的 URL 与相对 URL 合并,生成完整的绝对 URL。</p>",
  "<p>Return a prettified version of the element's inner html-code</p>": "<p>返回格式化后更易读的元素内部 HTML 代码。</p>",
  "<p>Check if the element has a specific class</p>": "<p>检查元素是否包含指定的 class。</p>",
  "<p>The class name to check for</p>": "<p>要检查的 class 名称。</p>",
  "<p>True if element has class with that name otherwise False</p>": "<p>元素包含该名称的 class 时返回 True,否则返回 False。</p>",
  "<p>Return a generator that loops over all ancestors of the element, starting with the element's parent.</p>": "<p>返回一个生成器,从父元素开始遍历当前元素的所有祖先元素。</p>",
  "<p>Loop over all ancestors of the element till one match the passed function</p>": "<p>遍历元素的所有祖先,直到某个祖先满足传入函数的条件。</p>",
  "<p>A function that takes each ancestor as an argument and returns True/False</p>": "<p>接收每个祖先元素作为参数,并返回 True 或 False 的函数。</p>",
  "<p>The first ancestor that match the function or <code>None</code> otherwise.</p>": "<p>第一个满足函数条件的祖先元素,如果没有则返回 <code>None</code>。</p>",
  "<p>Serialize this element to a string.\nFor text nodes, returns the text value. For HTML elements, returns the outer HTML.</p>": "<p>将此元素序列化为字符串。文本节点返回文本值,HTML 元素返回外层 HTML。</p>",
  "<p>Return a single-element list containing this element's serialized string.</p>": "<p>返回仅含一个元素的列表,其中是当前元素序列化后的字符串。</p>",
  "<p>This function will search again for the element in the page tree, used automatically on page structure change</p>": "<p>在页面树中重新查找元素,页面结构变化时会自动使用。</p>",
  "<p>The element we want to relocate in the tree</p>": "<p>要在树中重新定位的元素。</p>",
  "<p>The minimum percentage to accept and not going lower than that. Be aware that the percentage\ncalculation depends solely on the page structure, so don't play with this number unless you must know\nwhat you are doing!</p>": "<p>可接受的最低匹配百分比。百分比的计算只依赖页面结构,请仅在了解其影响时修改此值。</p>",
  "<p>If True, the return result will be converted to <code>Selectors</code> object</p>": "<p>为 True 时,将返回结果转换为 <code>Selectors</code> 对象。</p>",
  "<p>List of pure HTML elements that got the highest matching score or 'Selectors' object</p>": "<p>匹配分数最高的原始 HTML 元素列表,或 'Selectors' 对象。</p>",
  "<p>Search the current tree with CSS3 selectors</p>": "<p>使用 CSS3 选择器搜索当前树。</p>",
  "<p><strong>Important:\nIt's recommended to use the identifier argument if you plan to use a different selector later\nand want to relocate the same element(s)</strong></p>": "<p><strong>重要:如果以后打算使用其他选择器,并希望重新定位相同元素,建议使用 identifier 参数。</strong></p>",
  "<p>The CSS3 selector to be used.</p>": "<p>要使用的 CSS3 选择器。</p>",
  "<p>Enabled will make the function try to relocate the element if it was 'saved' before</p>": "<p>启用后,如果元素之前已保存,函数会尝试重新定位它。</p>",
  "<p>A string that will be used to save/retrieve element's data in adaptive,\notherwise the selector will be used.</p>": "<p>用于保存和读取自适应元素数据的字符串。未指定时使用选择器。</p>",
  "<p>Automatically save new elements for <code>adaptive</code> later</p>": "<p>自动保存新元素,供之后的 <code>adaptive</code> 功能使用。</p>",
  "<p>The minimum percentage to accept while <code>adaptive</code> is working and not going lower than that.\nBe aware that the percentage calculation depends solely on the page structure, so don't play with this\nnumber unless you must know what you are doing!</p>": "<p><code>adaptive</code> 工作时可接受的最低匹配百分比。百分比的计算只依赖页面结构,请仅在了解其影响时修改此值。</p>",
  "<p><code>Selectors</code> class.</p>": "<p><code>Selectors</code> 类。</p>",
  "<p>Search the current tree with XPath selectors</p>": "<p>使用 XPath 选择器搜索当前树。</p>",
  "<p>Note: <strong>Additional keyword arguments will be passed as XPath variables in the XPath expression!</strong></p>": "<p>注意:<strong>额外的关键字参数会作为 XPath 变量传入 XPath 表达式!</strong></p>",
  "<p>The XPath selector to be used.</p>": "<p>要使用的 XPath 选择器。</p>",
  "<p>Find elements by filters of your creations for ease.</p>": "<p>通过自己定义的过滤条件查找元素。</p>",
  "<p>Tag name(s), iterable of tag names, regex patterns, function, or a dictionary of elements' attributes. Leave empty for selecting all.</p>": "<p>标签名、多个标签名、标签名的可迭代对象、正则表达式、函数,或元素属性字典。留空表示选择全部。</p>",
  "<p>The attributes you want to filter elements based on it.</p>": "<p>用于过滤元素的属性。</p>",
  "<p>The <code>Selectors</code> object of the elements or empty list</p>": "<p>包含元素的 <code>Selectors</code> 对象,或空列表。</p>",
  "<p>Find elements by filters of your creations for ease, then return the first result. Otherwise return <code>None</code>.</p>": "<p>通过自己定义的过滤条件查找元素,并返回第一个结果。如果没有则返回 <code>None</code>。</p>",
  "<p>The <code>Selector</code> object of the element or <code>None</code> if the result didn't match</p>": "<p>元素的 <code>Selector</code> 对象;如果没有匹配结果,则返回 <code>None</code>。</p>",
  "<p>Saves the element's unique properties to the storage for retrieval and relocation later</p>": "<p>将元素的独特属性保存到存储中,供之后读取和重新定位。</p>",
  "<p>The element itself that we want to save to storage, it can be a <code>Selector</code> or pure <code>HtmlElement</code></p>": "<p>要保存的元素本身,可以是 <code>Selector</code> 或原始 <code>HtmlElement</code>。</p>",
  "<p>This is the identifier that will be used to retrieve the element later from the storage. See\nthe docs for more info.</p>": "<p>以后从存储中读取元素时使用的标识。更多信息请查看文档。</p>",
  "<p>Using the identifier, we search the storage and return the unique properties of the element</p>": "<p>根据标识搜索存储,并返回元素的独特属性。</p>",
  "<p>This is the identifier that will be used to retrieve the element from the storage. See\nthe docs for more info.</p>": "<p>从存储中读取元素时使用的标识。更多信息请查看文档。</p>",
  "<p>A dictionary of the unique properties</p>": "<p>包含独特属性的字典。</p>",
  "<p>Return JSON response if the response is jsonable otherwise throws error</p>": "<p>如果响应可以解析为 JSON,则返回解析结果,否则抛出错误。</p>",
  "<p>Apply the given regex to the current text and return a list of strings with the matches.</p>": "<p>对当前文本应用给定的正则表达式,并返回包含匹配字符串的列表。</p>",
  "<p>Can be either a compiled regular expression or a string.</p>": "<p>可以是编译后的正则表达式,也可以是字符串。</p>",
  "<p>If enabled character entity references are replaced by their corresponding character</p>": "<p>启用后,将字符实体引用替换为对应字符。</p>",
  "<p>if enabled, this will ignore all whitespaces and consecutive spaces while matching</p>": "<p>启用后,匹配时会忽略所有空白及连续空格。</p>",
  "<p>if disabled, the function will set the regex to ignore the letters case while compiling it</p>": "<p>关闭后,编译正则表达式时会忽略大小写。</p>",
  "<p>Apply the given regex to text and return the first match if found, otherwise return the default value.</p>": "<p>对文本应用给定的正则表达式,并返回第一个匹配结果。如果没有,则返回默认值。</p>",
  "<p>The default value to be returned if there is no match</p>": "<p>没有匹配结果时返回的默认值。</p>",
  "<p>\n                  <span class=\"doc-param-default\">\n                    <b>DEFAULT:</b>\n                      <code>None</code>\n                  </span>\n              </p>": "<p>\n                  <span class=\"doc-param-default\">\n                    <b>默认值:</b>\n                      <code>None</code>\n                  </span>\n              </p>",
  "<p>if enabled character entity references are replaced by their corresponding character</p>": "<p>启用后,将字符实体引用替换为对应字符。</p>",
  "<p>Find elements that are in the same tree depth in the page with the same tag name and same parent tag etc...\nthen return the ones that match the current element attributes with a percentage higher than the input threshold.</p>": "<p>查找页面树中深度相同、标签名相同、父元素标签名相同等条件一致的元素,然后返回与当前元素的属性匹配度高于指定阈值的元素。</p>",
  "<p>This function is inspired by AutoScraper and made for cases where you, for example, found a product div inside\na products-list container and want to find other products using that element as a starting point EXCEPT\nthis function works in any case without depending on the element type.</p>": "<p>此函数受 AutoScraper 启发。例如,在商品列表容器中找到一个商品 div 后,可以以它为起点查找其他商品。不过,此函数不限于这种场景,也不依赖元素类型。</p>",
  "<p>The percentage to use while comparing element attributes.\nNote: Elements found before attributes matching/comparison will be sharing the same depth, same tag name,\nsame parent tag name, and same grand parent tag name. So they are 99% likely to be correct unless you are\nextremely unlucky, then attributes matching comes into play, so don't play with this number unless\nyou are getting the results you don't want.\nAlso, if the current element doesn't have attributes and the similar element as well, then it's a 100% match.</p>": "<p>比较元素属性时使用的百分比。注意:在比较属性前,找到的元素已经具有相同深度、相同标签名,以及相同的父元素和祖父元素标签名。因此,除非特别不巧,它们有 99% 的可能已经正确。之后才会比较属性,所以只有结果不符合预期时才应调整此值。如果当前元素和相似元素都没有属性,则视为 100% 匹配。</p>",
  "<p>Attribute names passed will be ignored while matching the attributes in the last step.\nThe default value is to ignore <code>href</code> and <code>src</code> as URLs can change a lot between elements, so it's unreliable</p>": "<p>在最后一步比较属性时,忽略指定的属性名。默认忽略 <code>href</code> 和 <code>src</code>,因为不同元素的 URL 可能相差很大,不适合用于判断。</p>",
  "<p>If True, element text content will be taken into calculation while matching.\nNot recommended to use in normal cases, but it depends.</p>": "<p>为 True 时,将元素文本内容也纳入匹配计算。通常不建议启用,但可以根据情况选择。</p>",
  "<p>A <code>Selectors</code> container of <code>Selector</code> objects or empty list</p>": "<p>一个 <code>Selectors</code> 容器,包含 <code>Selector</code> 对象,或为空列表。</p>",
  "<p>Find elements that its text content fully/partially matches input.</p>": "<p>查找文本内容与输入完全或部分匹配的元素。</p>",
  "<p>Text query to match</p>": "<p>要匹配的查询文本。</p>",
  "<p>Returns the first element that matches conditions, enabled by default</p>": "<p>返回第一个符合条件的元素,默认启用。</p>",
  "<p>If enabled, the function returns elements that contain the input text</p>": "<p>启用后,返回包含输入文本的元素。</p>",
  "<p>if enabled, the letters case will be taken into consideration</p>": "<p>启用后区分大小写。</p>",
  "<p>Find elements that its text content matches the input regex pattern.</p>": "<p>查找文本匹配指定正则表达式的元素。</p>",
  "<p>Regex query/pattern to match</p>": "<p>用于匹配的正则表达式。</p>",
  "<p>Return the first element that matches conditions; enabled by default.</p>": "<p>只返回第一个满足条件的元素,默认开启。</p>",
  "<p>If enabled, the letters case will be taken into consideration in the regex.</p>": "<p>启用后,正则表达式区分大小写。</p>",
  "<p>If enabled, this will ignore all whitespaces and consecutive spaces while matching.</p>": "<p>启用后,匹配时忽略所有空白字符和连续空格。</p>",
  "<p>A basic <code>Fetcher</code> class type that can only do basic GET, POST, PUT, and DELETE HTTP requests based on <code>curl_cffi</code>.</p>": "<p>基础 <code>Fetcher</code> 类,通过 <code>curl_cffi</code> 发送 GET、POST、PUT 和 DELETE HTTP 请求。</p>",
  "<p>Set multiple arguments for the parser at once globally</p>": "<p>一次设置多个全局解析参数。</p>",
  "<p>The keywords can be any arguments of the following: huge_tree, keep_comments, adaptive, storage, storage_args, adaptive_domain</p>": "<p>支持的参数有 huge_tree、keep_comments、adaptive、storage、storage_args 和 adaptive_domain。</p>",
  "<p>\n                  <span class=\"doc-param-default\">\n                    <b>DEFAULT:</b>\n                      <code>{}</code>\n                  </span>\n              </p>": "<p>\n                  <span class=\"doc-param-default\">\n                    <b>默认值:</b>\n                      <code>{}</code>\n                  </span>\n              </p>",
  "<p>A <code>Fetcher</code> class type which is a completely stealthy built on top of Chromium.</p>": "<p>基于 Chromium、提供完整隐身功能的 <code>Fetcher</code> 类。</p>",
  "<p>It works as real browsers passing almost all online tests/protections with many customization options.</p>": "<p>像真实浏览器一样运行,通过几乎所有在线测试和防护,并提供多种自定义选项。</p>",
  "<p>Opens up a browser and do your request based on your chosen options below.</p>": "<p>打开浏览器,按下面选择的选项发送请求。</p>",
  "<p>Target url.</p>": "<p>目标 URL。</p>",
  "<p>Run the browser in headless/hidden (default), or headful/visible mode.</p>": "<p>以无头模式运行,不显示窗口,这是默认设置;也可以显示浏览器窗口。</p>",
  "<p>Drop requests for unnecessary resources for a speed boost.\nRequests dropped are of type <code>font</code>, <code>image</code>, <code>media</code>, <code>beacon</code>, <code>object</code>, <code>imageset</code>, <code>texttrack</code>, <code>websocket</code>, <code>csp_report</code>, and <code>stylesheet</code>.</p>": "<p>阻止不必要的资源请求以提高速度。类型包括 <code>font</code>、<code>image</code>、<code>media</code>、<code>beacon</code>、<code>object</code>、<code>imageset</code>、<code>texttrack</code>、<code>websocket</code>、<code>csp_report</code> 和 <code>stylesheet</code>。</p>",
  "<p>A set of domain names to block requests to. Subdomains are also matched (e.g., <code>\"example.com\"</code> blocks <code>\"sub.example.com\"</code> too).</p>": "<p>要阻止请求的域名集合,也会匹配子域名。例如,<code>\"example.com\"</code> 也会阻止 <code>\"sub.example.com\"</code>。</p>",
  "<p>Block requests to ~3,500 known ad/tracking domains. Can be combined with <code>blocked_domains</code>.</p>": "<p>阻止向约 3,500 个已知广告或跟踪域名发送请求,可与 <code>blocked_domains</code> 结合使用。</p>",
  "<p>Route DNS queries through Cloudflare's DNS-over-HTTPS to prevent DNS leaks when using proxies.</p>": "<p>通过 Cloudflare 的 DNS-over-HTTPS 发送 DNS 查询,避免使用代理时发生 DNS 泄露。</p>",
  "<p>Pass a useragent string to be used. Otherwise the fetcher will generate a real Useragent of the same browser and use it.</p>": "<p>指定 User-Agent 字符串。未指定时,Fetcher 会生成并使用相同浏览器的真实 User-Agent。</p>",
  "<p>Set cookies for the next request.</p>": "<p>为下一次请求设置 Cookie。</p>",
  "<p>Wait for the page until there are no network connections for at least 500 ms.</p>": "<p>等待页面至少连续 500 ms 没有网络连接。</p>",
  "<p>The timeout in milliseconds that is used in all operations and waits through the page. The default is 30,000</p>": "<p>页面所有操作和等待的超时时间,单位为毫秒,默认为 30,000。</p>",
  "<p>The time (milliseconds) the fetcher will wait after everything finishes before closing the page and returning the <code>Response</code> object.</p>": "<p>所有步骤完成后,在关闭页面并返回 <code>Response</code> 对象前额外等待的时间,单位为毫秒。</p>",
  "<p>Added for automation. A function that takes the <code>page</code> object, runs after navigation, and does the automation you need.</p>": "<p>用于自动化的函数,接收 <code>page</code> 对象,在导航后执行所需操作。</p>",
  "<p>A function that takes the <code>page</code> object, runs before navigation. Use it to register event listeners or routes that must be set up before the page loads.</p>": "<p>接收 <code>page</code> 对象并在导航前执行的函数。用于注册必须在页面加载前准备好的事件监听器或路由。</p>",
  "<p>Wait for a specific CSS selector to be in a specific state.</p>": "<p>等待指定 CSS 选择器达到指定状态。</p>",
  "<p>An absolute path to a JavaScript file to be executed on page creation for all pages in this session.</p>": "<p>JavaScript 文件的绝对路径,在此会话中的每个页面创建时执行。</p>",
  "<p>Specify user locale, for example, <code>en-GB</code>, <code>de-DE</code>, etc. Locale will affect navigator.language value, Accept-Language request header value as well as number and date formatting\nrules. Defaults to the system default locale.</p>": "<p>区域设置,例如 <code>en-GB</code>、<code>de-DE</code>。影响 navigator.language、请求头 Accept-Language,以及数字和日期格式。默认使用系统区域设置。</p>",
  "<p>Changes the timezone of the browser. Defaults to the system timezone.</p>": "<p>修改浏览器时区,默认使用系统时区。</p>",
  "<p>The state to wait for the selector given with <code>wait_selector</code>. The default state is <code>attached</code>.</p>": "<p>等待 <code>wait_selector</code> 指定的元素达到这个状态。默认为 <code>attached</code>。</p>",
  "<p>Solves all types of the Cloudflare's Turnstile/Interstitial challenges before returning the response to you.</p>": "<p>返回响应前,处理所有类型的 Cloudflare Turnstile 和 Interstitial 挑战。</p>",
  "<p>If you have a Chrome browser installed on your device, enable this, and the Fetcher will launch an instance of your browser and use it.</p>": "<p>如果设备上已安装 Chrome,启用此选项后,Fetcher 会启动并使用它。</p>",
  "<p>Add random noise to canvas operations to prevent fingerprinting.</p>": "<p>为 Canvas 操作添加随机噪声,防止指纹识别。</p>",
  "<p>Forces WebRTC to respect proxy settings to prevent local IP address leak.</p>": "<p>强制 WebRTC 遵守代理设置,避免泄露本地 IP 地址。</p>",
  "<p>Enabled by default. Disabling it disables WebGL and WebGL 2.0 support entirely. Disabling WebGL is not recommended as many WAFs now check if WebGL is enabled.</p>": "<p>默认开启。关闭后会完全禁用 WebGL 和 WebGL 2.0。不建议关闭,因为很多 WAF 会检查 WebGL 是否启用。</p>",
  "<p>Enabled by default, wait for all JavaScript on page(s) to fully load and execute.</p>": "<p>等待页面上的所有 JavaScript 加载并执行,默认开启。</p>",
  "<p>Include open Shadow DOM content in the response HTML. Defaults to False.</p>": "<p>将开放的 Shadow DOM 内容加入响应 HTML,默认为 False。</p>",
  "<p>Instead of launching a new browser instance, connect to this CDP URL to control real browsers through CDP.</p>": "<p>连接此 CDP URL 来控制已有浏览器,而不是启动新实例。</p>",
  "<p>Enabled by default, Scrapling will set a Google referer header.</p>": "<p>默认开启,Scrapling 会设置 Google referer 请求头。</p>",
  "<p>A dictionary of extra headers to add to the request. <em>The referer set by <code>google_search</code> takes priority over the referer set here if used together.</em></p>": "<p>要添加到请求中的额外请求头字典。<em>同时使用时,<code>google_search</code> 设置的 referer 优先于这里的值。</em></p>",
  "<p>The proxy to be used with requests, it can be a string or a dictionary with the keys 'server', 'username', and 'password' only.</p>": "<p>请求使用的代理,可以是字符串,或仅包含 'server'、'username'、'password' 的字典。</p>",
  "<p>Path to a User Data Directory, which stores browser session data like cookies and local storage. The default is to create a temporary directory.</p>": "<p>用户数据目录的路径,用于保存 Cookie、本地存储等浏览器会话数据。默认创建临时目录。</p>",
  "<p>A list of additional browser flags to pass to the browser on launch.</p>": "<p>启动浏览器时传入的额外参数列表。</p>",
  "<p>The arguments that will be passed in the end while creating the final Selector's class.</p>": "<p>创建最终 Selector 对象时传入的参数。</p>",
  "<p>Additional arguments to be passed to Playwright's context as additional settings, and it takes higher priority than Scrapling's settings.</p>": "<p>传给 Playwright 上下文的额外设置,优先级高于 Scrapling 设置。</p>",
  "<p>A <code>Response</code> object.</p>": "<p>一个 <code>Response</code> 对象。</p>",
  "<p>A factory context manager that provides configured Fetcher sessions.</p>": "<p>创建已配置 Fetcher 会话的上下文管理器。</p>",
  "<p>When this manager is used in a 'with' or 'async with' block,\nit yields a new session configured with the manager's defaults.\nA single instance of this manager should ideally be used for one active\nsession at a time (or sequentially). Re-entering a context with the\nsame manager instance while a session is already active is disallowed.</p>": "<p>在 'with' 或 'async with' 代码块中使用时,这个管理器会提供一个采用默认配置的新会话。建议每个管理器实例同时只用于一个活动会话,或按顺序创建多个会话。已有会话运行时,不允许用同一个实例再次进入上下文。</p>",
  "<p>Browser version to impersonate. Can be a single browser string or a list of browser strings for random selection. (Default: latest available Chrome version)</p>": "<p>要模拟的浏览器版本。可以是单个浏览器字符串,或用于随机选择的字符串列表。默认使用最新可用的 Chrome 版本。</p>",
  "<p>Whether to use HTTP3. Defaults to False. It might be problematic if used it with <code>impersonate</code>.</p>": "<p>是否使用 HTTP3,默认为 False。与 <code>impersonate</code> 同时使用可能出现问题。</p>",
  "<p>If enabled (default), it creates and adds real browser headers. It also sets a Google referer header.</p>": "<p>生成并添加真实浏览器请求头,包括 Google referer,默认开启。</p>",
  "<p>Dict of proxies to use. Format: {\"http\": proxy_url, \"https\": proxy_url}.</p>": "<p>要使用的代理字典,格式为 {\"http\": proxy_url, \"https\": proxy_url}。</p>",
  "<p>Proxy URL to use. Format: \"http://username:password@localhost:8030\".\nCannot be used together with the <code>proxies</code> parameter.</p>": "<p>要使用的代理 URL,格式为 \"http://username:password@localhost:8030\"。不能与 <code>proxies</code> 参数同时使用。</p>",
  "<p>HTTP basic auth for proxy, tuple of (username, password).</p>": "<p>代理的 HTTP Basic 认证,格式为 (username, password) 元组。</p>",
  "<p>Number of seconds to wait before timing out.</p>": "<p>超时前等待的秒数。</p>",
  "<p>Headers to include in the session with every request.</p>": "<p>会话中每次请求都会发送的请求头。</p>",
  "<p>Number of retry attempts. Defaults to 3.</p>": "<p>重试次数,默认为 3。</p>",
  "<p>Number of seconds to wait between retry attempts. Defaults to 1 second.</p>": "<p>重试之间的等待秒数,默认为 1 秒。</p>",
  "<p>Whether to follow redirects. Defaults to \"safe\", which follows redirects but rejects those targeting internal/private IPs (SSRF protection). Pass True to follow all redirects without restriction.</p>": "<p>是否跟随重定向。默认为 \"safe\",跟随重定向但拒绝指向内部或私有 IP 的目标,以防范 SSRF。传入 True 可不受限制地跟随所有重定向。</p>",
  "<p>Maximum number of redirects. Default 30, use -1 for unlimited.</p>": "<p>最大重定向次数,默认为 30,设为 -1 表示不限制。</p>",
  "<p>Whether to verify HTTPS certificates. Defaults to True.</p>": "<p>是否验证 HTTPS 证书,默认为 True。</p>",
  "<p>Tuple of (cert, key) filenames for the client certificate.</p>": "<p>客户端证书和密钥的文件名元组,格式为 (cert, key)。</p>",
  "<p>Arguments passed when creating the final Selector class.</p>": "<p>创建最终 Selector 对象时传入的参数。</p>",
  "<p>A ProxyRotator instance for automatic proxy rotation.</p>": "<p>用于自动轮换代理的 ProxyRotator 实例。</p>",
  "<p>Creates and returns a new synchronous Fetcher Session</p>": "<p>创建并返回新的同步 Fetcher 会话。</p>",
  "<p>Creates and returns a new asynchronous Session.</p>": "<p>创建并返回新的异步会话。</p>",
  "<p>A Stealthy Browser session manager with page pooling.</p>": "<p>使用页面池的隐身浏览器会话管理器。</p>",
  "<p>A Browser session manager with page pooling, it's using a persistent browser Context by default with a temporary user profile directory.</p>": "<p>使用页面池的浏览器会话管理器。默认使用持久浏览器上下文和临时用户配置目录。</p>",
  "<p>Save completed browser requests and responses. Failed or unfinished requests are omitted. Defaults to False.</p>": "<p>保存已完成的浏览器请求和响应。失败或尚未完成的请求会被省略,默认为 False。</p>",
  "<p>Maximum retained requests per session. Defaults to 1000; older entries are removed.</p>": "<p>每个会话最多保留的请求数,默认为 1,000,旧条目会被移除。</p>",
  "<p>Save cookies, local storage and IndexedDB to a Playwright-compatible JSON file.</p>": "<p>将 Cookie、本地存储和 IndexedDB 保存到与 Playwright 兼容的 JSON 文件。</p>",
  "<p>Requires a started session without proxy rotation. Does not save sessionStorage.</p>": "<p>需要已启动且未启用代理轮换的会话。不保存 sessionStorage。</p>",
  "<p>Replace cookies, local storage and IndexedDB from a Playwright-compatible JSON file.</p>": "<p>使用与 Playwright 兼容的 JSON 文件替换 Cookie、本地存储和 IndexedDB。</p>",
  "<p>Requires a started session without proxy rotation. Fetch or reload pages to use the restored login.</p>": "<p>需要已启动且未启用代理轮换的会话。获取或重新加载页面后,才能使用恢复的登录状态。</p>",
  "<p>Close every open tab in the session's pool. The next request opens a fresh tab.</p>": "<p>关闭会话池中的所有标签页。下一次请求会打开新的标签页。</p>",
  "<p>Close all resources</p>": "<p>关闭所有资源。</p>",
  "<p>Get statistics about the current page pool</p>": "<p>获取当前页面池的统计信息。</p>",
  "<p>Create a browser for this instance and context.</p>": "<p>为此实例及上下文创建浏览器。</p>",
  "<p>Opens up the browser and do your request based on your chosen options.</p>": "<p>打开浏览器,按所选选项发送请求。</p>",
  "<p>The Target url.</p>": "<p>目标 URL。</p>",
  "<p>Static proxy to override rotator and session proxy. A new browser context will be created and used with it.</p>": "<p>覆盖代理轮换器和会话代理的固定代理。会为它创建并使用新的浏览器上下文。</p>",
  "<p>An async Stealthy Browser session manager with page pooling.</p>": "<p>使用页面池的异步隐身浏览器会话管理器。</p>",
  "<p>A thread-safe proxy rotator with pluggable rotation strategies.</p>": "<p>线程安全的代理轮换器,支持替换轮换策略。</p>",
  "<p>Supports:\n- Cyclic rotation (default)\n- Custom rotation strategies via callable\n- Both string URLs and Playwright-style dict proxies</p>": "<p>支持默认的循环轮换、通过可调用对象实现的自定义策略,以及 URL 字符串或 Playwright 格式的代理字典。</p>",
  "<p>Initialize the proxy rotator.</p>": "<p>初始化代理轮换器。</p>",
  "<p>List of proxy URLs or Playwright-style proxy dicts.\n- String format: \"http://proxy1:8080\" or \"http://user:pass@proxy:8080\"\n- Dict format: {\"server\": \"http://proxy:8080\", \"username\": \"user\", \"password\": \"pass\"}</p>": "<p>代理 URL 或 Playwright 格式的代理字典列表。字符串格式:\"http://proxy1:8080\" 或 \"http://user:pass@proxy:8080\"。字典格式:{\"server\": \"http://proxy:8080\", \"username\": \"user\", \"password\": \"pass\"}。</p>",
  "<p>Rotation strategy function. Takes (proxies, current_index) and returns (proxy, next_index). Defaults to cyclic_rotation.</p>": "<p>轮换策略函数,接收 (proxies, current_index),返回 (proxy, next_index),默认为 cyclic_rotation。</p>",
  "<p>Get a copy of all configured proxies.</p>": "<p>获取所有已配置代理的副本。</p>",
  "<p>Get the next proxy according to the rotation strategy.</p>": "<p>根据轮换策略获取下一个代理。</p>",
  "<p>Return the total number of configured proxies.</p>": "<p>返回已配置代理的总数。</p>",
  "<p>Extends standard Python string by adding more functionality</p>": "<p>扩展标准 Python 字符串,提供更多功能。</p>",
  "<p>Return a sorted version of the string</p>": "<p>返回排序后的字符串。</p>",
  "<p>Return a new version of the string after removing all white spaces and consecutive spaces</p>": "<p>移除所有空白字符和连续空格,返回新的字符串。</p>",
  "<p>Return JSON response if the response is jsonable otherwise throw error</p>": "<p>将响应解析为 JSON,无法解析时抛出错误。</p>",
  "<p>If enabled, this will ignore all whitespaces and consecutive spaces while matching</p>": "<p>启用后,匹配时忽略所有空白字符和连续空格。</p>",
  "<p>If disabled, function will set the regex to ignore the letters-case while compiling it</p>": "<p>关闭后,编译正则表达式时忽略大小写。</p>",
  "<p>Used to quickly check if this regex matches or not without any operations on the results</p>": "<p>快速检查正则表达式是否匹配,不对结果进行其他处理。</p>",
  "<p>The :class:<code>TextHandlers</code> class is a subclass of the builtin <code>List</code> class, which provides a few additional methods.</p>": "<p>:class:<code>TextHandlers</code> 继承内置的 <code>List</code> 类,并提供一些额外方法。</p>",
  "<p>Call the <code>.re()</code> method for each element in this list and return\ntheir results flattened as TextHandlers.</p>": "<p>对列表中每个元素调用 <code>.re()</code>,将结果展平后作为 TextHandlers 返回,不包含嵌套列表。</p>",
  "<p>if disabled, the function will set the regex to ignore the letters-case while compiling it</p>": "<p>关闭后,编译正则表达式时忽略大小写。</p>",
  "<p>Call the <code>.re_first()</code> method for each element in this list and return\nthe first result or the default value otherwise.</p>": "<p>对列表中每个元素调用 <code>.re_first()</code>,返回第一个匹配结果,没有匹配时返回默认值。</p>",
  "<p>Returns the first item of the current list</p>": "<p>返回当前列表的第一个元素。</p>",
  "<p>the default value to return if the current list is empty</p>": "<p>当前列表为空时返回的默认值。</p>",
  "<p>A read-only mapping to use instead of the standard dictionary for the speed boost, but at the same time I use it to add more functionalities.\nIf the standard dictionary is needed, convert this class to a dictionary with the <code>dict</code> function</p>": "<p>用于替代标准字典的只读映射,速度更快,并提供额外功能。如需普通字典,可以使用 <code>dict</code> 函数转换。</p>",
  "<p>Convert current attributes to JSON bytes if the attributes are JSON serializable otherwise throws error</p>": "<p>将当前属性转换为 JSON 字节,如果属性无法序列化为 JSON,则抛出错误。</p>",
  "<p>Acts like the standard dictionary <code>.get()</code> method</p>": "<p>与标准字典的 <code>.get()</code> 方法相同。</p>",
  "<p>Search current attributes by values and return a dictionary of each matching item</p>": "<p>按值搜索当前属性,并为每个匹配项返回一个字典。</p>",
  "<p>The keyword to search for in the attribute values</p>": "<p>要在属性值中查找的文本。</p>",
  "<p>If True, the function will search if keyword in each value instead of perfect match</p>": "<p>为 True 时,检查每个值是否包含指定文本,而不是要求完全匹配。</p>",
  "<p>Request's response information structure.</p>": "<p>保存请求响应信息的数据结构。</p>",
  "<p><code>browser_network_requests</code> returns <code>NetworkRequestsModel</code> with <code>requests</code>, <code>next_cursor</code>, <code>has_more</code>, and <code>dropped_count</code>. Each <code>NetworkRequestInfo</code> contains <code>id</code>, <code>url</code>, <code>method</code>, <code>resource_type</code>, and <code>status</code>. Pass <code>next_cursor</code> as <code>after_id</code> to continue; <code>has_more</code> indicates more current matches.</p>": "<p><code>browser_network_requests</code> 返回 <code>NetworkRequestsModel</code>,包含 <code>requests</code>、<code>next_cursor</code>、<code>has_more</code> 和 <code>dropped_count</code>。每个 <code>NetworkRequestInfo</code> 包含 <code>id</code>、<code>url</code>、<code>method</code>、<code>resource_type</code> 和 <code>status</code>。将 <code>next_cursor</code> 作为 <code>after_id</code> 传入即可继续读取。<code>has_more</code> 表示当前还有更多匹配项。</p>",
  "<p><code>browser_network_request</code> returns <code>NetworkRequestModel</code> with <code>request_id</code>, <code>part</code>, <code>data</code>, and <code>note</code>. Summaries and headers are objects; the full saved body text is returned as a string, including JSON response text. <code>note</code> explains missing body data or partial headers.</p>": "<p><code>browser_network_request</code> 返回 <code>NetworkRequestModel</code>,包含 <code>request_id</code>、<code>part</code>、<code>data</code> 和 <code>note</code>。摘要和头信息以对象返回;保存的完整响应体文本以字符串返回,JSON 响应也一样。<code>note</code> 说明响应体缺失或头信息不完整的情况。</p>",
  "<p>Summary of a recorded browser request.</p>": "<p>已记录浏览器请求的摘要。</p>",
  "<p>Recorded request summaries and pagination details.</p>": "<p>已记录请求的摘要及分页信息。</p>",
  "<p>One complete saved request part, with an optional note.</p>": "<p>已保存请求中某一部分的完整内容,以及可选说明。</p>",
  "<p>Model classes for session management:</p>": "<p>用于会话管理的模型类:</p>",
  "<p>Information about an open browser session.</p>": "<p>已打开的浏览器会话信息。</p>",
  "<p>Response returned when a new session is created.</p>": "<p>创建新会话时返回的响应。</p>",
  "<p>Response returned when a session is closed.</p>": "<p>关闭会话时返回的响应。</p>",
  "<p>The main MCP server class that provides all web scraping tools:</p>": "<p>提供所有网页抓取工具的 MCP 服务器主类:</p>",
  "<p><strong><code>browser_fetch_once</code></strong>: Fetch one URL through a stealthy browser with JavaScript rendering and Cloudflare handling, then close the browser. Use a persistent session for later actions or network history.</p>": "<p><strong><code>browser_fetch_once</code></strong>:通过隐身浏览器获取一个 URL,支持 JavaScript 渲染和 Cloudflare 验证,随后关闭浏览器。如需后续操作或网络历史记录,请使用持久会话。</p>",
  "<p><strong><code>browser_extract</code></strong>: Read the current page or one element as an AI snapshot, HTML, Markdown, or text without reloading it. Keep results from forms and page actions. Snapshots include element roles, names, references, positions, and sizes; regex search returns matching lines with nearby context and parent nodes.</p>": "<p><strong><code>browser_extract</code></strong>:无需重新加载,即可以 AI 快照、HTML、Markdown 或文本形式读取当前页面或某个元素,并保留表单和页面操作的结果。快照包含元素的角色、名称、引用、位置和大小;正则表达式搜索会返回匹配的行、附近的上下文和父节点。</p>",
  "<p><strong><code>browser_actions</code></strong>: Chain mouse moves, hovers, clicks, scrolling, field filling, keyboard shortcuts, dialog replies, and waits in one call. Accept or dismiss alerts and confirmations, or enter text in prompts. Fill a search box, submit it, wait for results, and open a result without a separate call for each step.</p>": "<p><strong><code>browser_actions</code></strong>:在一次调用中连续执行鼠标移动、悬停、点击、滚动、字段填写、键盘快捷键、对话框响应和等待。可以接受或关闭提示框与确认框,也可以在输入对话框中填写文本。填写搜索框、提交、等待结果并打开某个结果,无需为每一步单独调用。</p>",
  "<p>Moves and clicks target selectors, snapshot references, or coordinates; element targets wait and scroll into view. Supports movement in multiple steps, left, right, and middle clicks, double-clicks, and scrolling nested panels.</p>": "<p>移动和点击操作可以通过选择器、快照引用或坐标指定目标;目标为元素时,会等待元素并将其滚动到可见区域。支持分多步移动、左键、右键和中键点击、双击,以及在嵌套面板内滚动。</p>",
  "<p>Target fields anywhere on the page through selectors or snapshot references. Fill text, check or uncheck boxes, select radio buttons, and choose one or more native dropdown options by label. Replace or clear text, or type at the current caret. Keyboard shortcuts use the current focus. Slow mode adds random pauses between typed characters and all actions.</p>": "<p>通过选择器或快照引用定位页面任意位置的字段。可以填写文本、勾选或取消勾选复选框、选择单选按钮,以及按标签选择一个或多个原生下拉选项。可以替换或清空文本,也可以在当前光标位置输入。键盘快捷键作用于当前焦点。慢速模式会在输入字符之间和各项操作之间加入随机暂停。</p>",
  "<p>Wait for content or loading overlays through selectors or snapshot references, wait for page load events or settled network activity, or add a fixed pause before continuing.</p>": "<p>通过选择器或快照引用等待内容或加载遮罩,等待页面加载事件或网络活动稳定,也可以在继续前暂停指定时间。</p>",
  "<p><strong><code>browser_evaluate</code></strong>: Run JavaScript on the current page to extract custom data, calculate results, read application state, or update page content. Supports asynchronous scripts and returns their results as JSON.</p>": "<p><strong><code>browser_evaluate</code></strong>:在当前页面运行 JavaScript,以提取自定义数据、计算结果、读取应用状态或更新页面内容。支持异步脚本,并以 JSON 返回结果。</p>",
  "<p>Create a Scrapling MCP server.</p>": "<p>创建 Scrapling MCP 服务器。</p>",
  "<p>Optional global Chromium-compatible browser executable path for browser tools.\nIf omitted, the SCRAPLING_EXECUTABLE_PATH environment variable is used when set.</p>": "<p>为浏览器工具设置兼容 Chromium 的浏览器可执行文件路径,作为全局默认值。此项可选。如未指定,则使用已设置的 SCRAPLING_EXECUTABLE_PATH 环境变量。</p>",
  "<p>Optional shared token that clients must send as <code>Authorization: Bearer &lt;token&gt;</code>.\nIf omitted, the SCRAPLING_MCP_AUTH_TOKEN environment variable is used when set. It only applies\nto the streamable-http transport.</p>": "<p>可选的共享 token,客户端必须通过 <code>Authorization: Bearer &lt;token&gt;</code> 发送。如未指定,则使用已设置的 SCRAPLING_MCP_AUTH_TOKEN 环境变量。仅适用于 streamable-http 传输方式。</p>",
  "<p>Open a reusable stealthy browser session. Pass per-request options to <code>browser_fetch</code>.</p>": "<p>打开可复用的隐身浏览器会话。请求级选项请传给 <code>browser_fetch</code>。</p>",
  "<p>Save browser cookies, local storage and IndexedDB as Playwright-compatible JSON. Excludes sessionStorage.</p>": "<p>将浏览器 Cookie、本地存储 和 IndexedDB 保存为兼容 Playwright 的 JSON。不包含 sessionStorage。</p>",
  "<p>Replace browser cookies, local storage and IndexedDB from a Playwright-compatible JSON file.</p>": "<p>用兼容 Playwright 的 JSON 文件中的数据替换浏览器 Cookie、本地存储 和 IndexedDB。</p>",
  "<p>Leaves sessionStorage and open tabs unchanged. Fetch or reload pages to use the restored login.</p>": "<p>不更改 sessionStorage 和已打开的标签页。获取或重新加载页面后,才能使用恢复的登录状态。</p>",
  "<p>Open a reusable HTTP session for <code>session_make_request</code>, keeping cookies, connections, and request settings.</p>": "<p>打开供 <code>session_make_request</code> 使用的可复用 HTTP 会话,保留 Cookie、连接和请求设置。</p>",
  "<p>Close a session and free its resources.</p>": "<p>关闭会话并释放其资源。</p>",
  "<p>List registered sessions, their status, and effective settings.</p>": "<p>列出已注册的会话、它们的状态和实际生效的设置。</p>",
  "<p>List completed requests across page changes, with IDs and pagination. Recording starts when the browser session opens.</p>": "<p>列出跨页面切换保留的已完成请求,包含 ID 并支持分页。浏览器会话打开后就开始记录。</p>",
  "<p>Read a complete saved request part without resending it, with structured data and availability notes.</p>": "<p>完整读取已保存请求的某一部分,无需重新发送请求,并返回结构化数据和可用性说明。</p>",
  "<p>Read the current page or one element as snapshot, HTML, Markdown, or text without navigating.\nReturn plain text; snapshot search keeps refs, ancestor paths and three lines of nearby context.</p>": "<p>无需导航,即可以快照、HTML、Markdown 或文本形式读取当前页面或某个元素。返回纯文本;快照搜索会保留引用、祖先路径和附近三行上下文。</p>",
  "<p>Run mouse, field, key, dialog, and wait actions in order; return plain text without a snapshot.\nStop on the first error, identifying its action; partial effects remain. No retries.\nElement mouse targets auto-wait and scroll into view; coordinates and wheel do not wait for navigation or scrolling.\nCancelled/timed-out clicks attempt button release. Load waits observe the current document, not future navigation.</p>": "<p>按顺序执行鼠标、字段、按键、对话框和等待操作;返回纯文本,不附带快照。遇到第一个错误时停止,并指出出错的操作;已产生的效果会保留,不会重试。鼠标操作以元素为目标时,会自动等待并将其滚动到可见区域;坐标和滚轮操作不会等待导航或滚动完成。点击被取消或超时时,会尝试释放鼠标按键。加载等待只观察当前文档,不会等待后续导航。</p>",
  "<p>Run JavaScript on the current page, await promises, and return JSON text without a snapshot.\nReturn JSON-compatible values; null/undefined become null. Script effects are not undone on failure.\nCancellation stops waiting, but may not stop the script.</p>": "<p>在当前页面运行 JavaScript,等待 Promise 完成,并返回 JSON 文本,不附带快照。脚本应返回兼容 JSON 的值;null/undefined 会变为 null。失败时不会撤销脚本已产生的效果。取消操作会停止等待,但可能不会停止脚本。</p>",
  "<p>Capture the current page or one element without navigating; return the image and current URL.\nElement capture waits and scrolls into view. Use browser_actions for other waits before capture.</p>": "<p>无需导航,即可截取当前页面或某个元素;返回图片和当前 URL。截取元素时,会等待元素并将其滚动到可见区域。截图前如需其他等待,请使用 browser_actions。</p>",
  "<p>Make an HTTP request without JavaScript. Suitable for low-to-mid protection.</p>": "<p>发送不执行 JavaScript 的 HTTP 请求。适用于防护程度低到中等的网站。</p>",
  "<p>Fetch a page with a stealth browser and JavaScript rendering.</p>": "<p>通过隐身浏览器获取页面,并执行 JavaScript 渲染。</p>",
  "<p>Fetch a URL in an open stealthy browser session. Options apply only to this request.</p>": "<p>通过已打开的隐身浏览器会话获取一个 URL。选项仅对本次请求生效。</p>",
  "<p>Make an HTTP request using the session's cookies, connections, impersonation, and proxy. Options apply to this request.</p>": "<p>使用会话的 Cookie、连接、浏览器模拟和代理发送 HTTP 请求。选项对本次请求生效。</p>",
  "<p>Serve the MCP server.</p>": "<p>启动 MCP 服务器。</p>",
  "<p>Serve over the streamable-http transport instead of stdio.</p>": "<p>使用 streamable-http 传输方式提供服务,替代 stdio。</p>",
  "<p>The host to bind to when <code>http</code> is enabled.</p>": "<p>启用 <code>http</code> 时绑定的主机地址。</p>",
  "<p>The port to bind to when <code>http</code> is enabled.</p>": "<p>启用 <code>http</code> 时绑定的端口。</p>",
  "<p>Host names to accept, which turns on DNS-rebinding protection.</p>": "<p>允许的主机名,设置后会启用 DNS 重绑定防护。</p>",
  "<p>Start the streamable-http transport without a token. The transport\nrequires authentication by default, so this is the explicit opt-out.</p>": "<p>不使用 token 启动 streamable-http。该传输方式默认要求身份验证,此选项用于明确关闭身份验证。</p>",
  "<p>The <code>Selectors</code> class is a subclass of the builtin <code>List</code> class, which provides a few additional methods.</p>": "<p><code>Selectors</code> 类是内置 <code>List</code> 类的子类,提供了一些额外方法。</p>",
  "<p>Returns the first Selector item of the current list or <code>None</code> if the list is empty</p>": "<p>返回当前列表中的第一个 Selector 元素;列表为空时返回 <code>None</code>。</p>",
  "<p>Returns the last Selector item of the current list or <code>None</code> if the list is empty</p>": "<p>返回当前列表中的最后一个 Selector 元素;列表为空时返回 <code>None</code>。</p>",
  "<p>Returns the length of the current list</p>": "<p>返回当前列表的长度。</p>",
  "<p>Call the <code>.xpath()</code> method for each element in this list and return\ntheir results as another <code>Selectors</code> class.</p>": "<p>对列表中的每个元素调用 <code>.xpath()</code> 方法,并将结果作为另一个 <code>Selectors</code> 对象返回。</p>",
  "<p>A string that will be used to retrieve element's data in adaptive,\notherwise the selector will be used.</p>": "<p>用于在自适应模式中检索元素数据的字符串;未指定时使用选择器。</p>",
  "<p>Call the <code>.css()</code> method for each element in this list and return\ntheir results flattened as another <code>Selectors</code> class.</p>": "<p>对列表中的每个元素调用 <code>.css()</code> 方法,将结果合并为一个 <code>Selectors</code> 对象并返回。</p>",
  "<p>Call the <code>.re()</code> method for each element in this list and return\ntheir results flattened as List of TextHandler.</p>": "<p>对列表中的每个元素调用 <code>.re()</code> 方法,将结果合并为一个包含 TextHandler 的 List 并返回。</p>",
  "<p>if disabled, function will set the regex to ignore the letters case while compiling it</p>": "<p>禁用后,函数会在编译正则表达式时设置忽略字母大小写。</p>",
  "<p>Loop over all current elements and return the first element that matches the passed function</p>": "<p>遍历当前所有元素,并返回第一个符合传入函数条件的元素。</p>",
  "<p>A function that takes each element as an argument and returns True/False</p>": "<p>接收每个元素作为参数并返回 True/False 的函数。</p>",
  "<p>The first element that match the function or <code>None</code> otherwise.</p>": "<p>返回第一个符合函数条件的元素;没有匹配时返回 <code>None</code>。</p>",
  "<p>Filter current elements based on the passed function</p>": "<p>根据传入的函数筛选当前元素。</p>",
  "<p>The new <code>Selectors</code> object or empty list otherwise.</p>": "<p>返回新的 <code>Selectors</code> 对象;没有匹配时返回空列表。</p>",
  "<p>Returns the serialized string of the first element, or <code>default</code> if empty.</p>": "<p>返回第一个元素序列化后的字符串;列表为空时返回 <code>default</code>。</p>",
  "<p>Serialize all elements and return as a TextHandlers list.</p>": "<p>序列化所有元素,并以 TextHandlers 列表返回。</p>",
  "<p>An abstract base class for creating web spiders.</p>": "<p>用于创建网页 Spider 的抽象基类。</p>",
  "<p>Check the documentation website for more information.</p>": "<p>更多信息请查看文档网站。</p>",
  "<p>Initialize the spider.</p>": "<p>初始化 Spider。</p>",
  "<p>Directory for checkpoint files. If provided, enables pause/resume.</p>": "<p>检查点文件目录。指定后即可暂停和恢复。</p>",
  "<p>Seconds between periodic checkpoint saves (default 5 minutes).</p>": "<p>定期保存检查点的间隔,单位为秒(默认 5 分钟)。</p>",
  "<p>Access current crawl stats (works during streaming).</p>": "<p>访问当前抓取的统计数据(流式模式下也可使用)。</p>",
  "<p>Generate initial requests to start the crawl.</p>": "<p>生成开始抓取所需的初始请求。</p>",
  "<p>By default, this generates Request objects for each URL in <code>start_urls</code>\nusing the session manager's default session and <code>parse()</code> as callback.</p>": "<p>默认会为 <code>start_urls</code> 中的每个 URL 生成 Request 对象,使用会话管理器的默认会话,并以 <code>parse()</code> 作为回调。</p>",
  "<p>Override this method for more control over initial requests\n(e.g., to add custom headers, use different callbacks, etc.)</p>": "<p>重写此方法可以更灵活地控制初始请求,例如添加自定义请求头、使用不同的回调等。</p>",
  "<p>Default callback for processing responses</p>": "<p>处理响应的默认回调。</p>",
  "<p>Called before crawling starts. Override for setup logic.</p>": "<p>抓取开始前调用。可以重写以执行初始化逻辑。</p>",
  "<p>It's enabled if the spider is resuming from a checkpoint, left for the user to use.</p>": "<p>Spider 从检查点恢复时,此值为启用状态,可按需使用。</p>",
  "<p>Called after crawling finishes. Override for cleanup logic.</p>": "<p>抓取结束后调用。可以重写以执行清理逻辑。</p>",
  "<p>Handle request errors for all spider requests.</p>": "<p>处理 Spider 所有请求中的错误。</p>",
  "<p>Override for custom error handling.</p>": "<p>重写以自定义错误处理。</p>",
  "<p>A hook to be overridden by users to do some processing on scraped items, return <code>None</code> to drop the item silently.</p>": "<p>可重写此钩子以处理抓取的数据项;返回 <code>None</code> 会静默丢弃该数据项。</p>",
  "<p>Check if the response is blocked. Users should override this for custom detection logic.</p>": "<p>检查响应是否被封锁。可以重写以自定义检测逻辑。</p>",
  "<p>Users should override this to prepare the blocked request before retrying, if needed.</p>": "<p>如需在重试前处理被封锁的请求,可以重写此方法。</p>",
  "<p>String representation of the spider.</p>": "<p>Spider 的字符串表示。</p>",
  "<p>Configure sessions for this spider.</p>": "<p>配置此 Spider 的会话。</p>",
  "<p>Override this method to add custom sessions.\nThe default implementation creates a FetcherSession session.</p>": "<p>重写此方法以添加自定义会话。默认实现会创建一个 FetcherSession 会话。</p>",
  "<p>The first session added becomes the default for <code>start_requests()</code> unless specified otherwise.</p>": "<p>除非另行指定,添加的第一个会话会成为 <code>start_requests()</code> 的默认会话。</p>",
  "<p>SessionManager to configure</p>": "<p>要配置的 SessionManager。</p>",
  "<p>Request graceful shutdown of the crawling process.</p>": "<p>请求有序停止抓取过程。</p>",
  "<p>Run the spider and return results.</p>": "<p>运行 Spider 并返回结果。</p>",
  "<p>This is the main entry point for running a spider.\nHandles async execution internally via anyio.</p>": "<p>这是运行 Spider 的主要入口,内部通过 anyio 处理异步执行。</p>",
  "<p>Pressing Ctrl+C will initiate graceful shutdown (waits for active tasks to complete).\nPressing Ctrl+C a second time will force immediate stop.</p>": "<p>按 Ctrl+C 会开始有序停止,等待正在运行的任务完成。再次按 Ctrl+C 会立即强制停止。</p>",
  "<p>If crawldir is set, a checkpoint will also be saved on graceful shutdown,\nallowing you to resume the crawl later by running the spider again.</p>": "<p>设置了 crawldir 时,有序停止还会保存检查点。以后再次运行 Spider 即可恢复抓取。</p>",
  "<p>Whether to use the faster uvloop/winloop event loop implementation, if available.</p>": "<p>是否在可用时使用速度更快的 uvloop/winloop 事件循环实现。</p>",
  "<p>Asyncio backend options to be used with <code>anyio.run</code></p>": "<p>传给 <code>anyio.run</code> 的 Asyncio 后端选项。</p>",
  "<p>Stream items as they're scraped. Ideal for long-running spiders or building applications on top of the spiders.</p>": "<p>以流式方式输出抓取到的数据项。适合长时间运行的 Spider,或基于 Spider 构建应用。</p>",
  "<p>Must be called from an async context. Yields items one by one as they are scraped.\nAccess <code>spider.stats</code> during iteration for real-time statistics.</p>": "<p>必须在异步上下文中调用。数据项抓取完成后会逐个产出。迭代时可以通过 <code>spider.stats</code> 访问实时统计数据。</p>",
  "<p>Note: SIGINT handling for pause/resume is not available in stream mode.</p>": "<p>注意:流式模式不支持通过 SIGINT 处理暂停和恢复。</p>",
  "<p>Create a copy of this request.</p>": "<p>创建此请求的副本。</p>",
  "<p>Generate a unique fingerprint for deduplication.</p>": "<p>生成用于去重的唯一指纹。</p>",
  "<p>Caches the result in self._fp after first computation.</p>": "<p>首次计算后,将结果缓存到 self._fp。</p>",
  "<p>Compare requests by priority</p>": "<p>按优先级比较请求。</p>",
  "<p>Requests are equal if they have the same fingerprint.</p>": "<p>指纹相同的请求视为相等。</p>",
  "<p>Prepare state for pickling - store callback as name string for pickle compatibility.</p>": "<p>准备 pickle 序列化所需的状态,将回调名称保存为字符串,以兼容 pickle。</p>",
  "<p>Restore state from pickle - callback restored later via _restore_callback().</p>": "<p>从 pickle 恢复状态,回调稍后通过 _restore_callback() 恢复。</p>",
  "<p>Complete result from a spider run.</p>": "<p>一次 Spider 运行的完整结果。</p>",
  "<p>True if the crawl completed normally (not paused).</p>": "<p>抓取正常完成(未暂停)时为 True。</p>",
  "<p>Statistics for a crawl run.</p>": "<p>一次抓取运行的统计数据。</p>",
  "<p>A list of scraped items with export capabilities.</p>": "<p>支持导出的抓取数据项列表。</p>",
  "<p>Export items to a JSON file.</p>": "<p>将数据项导出到 JSON 文件。</p>",
  "<p>Path to the output file</p>": "<p>输出文件的路径。</p>",
  "<p>Pretty-print with 2-space indentation (slightly slower)</p>": "<p>使用 2 个空格缩进格式化输出(稍慢)。</p>",
  "<p>Export items as JSON Lines (one JSON object per line).</p>": "<p>将数据项导出为 JSON Lines,每行一个 JSON 对象。</p>",
  "<p>Export items to a CSV file.</p>": "<p>将数据项导出到 CSV 文件。</p>",
  "<p>Items that don't share the same keys are still written, with the missing cells left empty, and any value\nthat isn't a scalar (a nested dictionary or a list) is written as JSON.</p>": "<p>键不完全相同的数据项仍会写入文件,缺失的单元格会留空,非标量值(嵌套字典或列表)会以 JSON 写入。</p>",
  "<p>The columns to write, defaulting to every key found in the items, in the order they appeared</p>": "<p>要写入的列,默认包括数据项中的所有键,按首次出现的顺序排列。</p>",
  "<p>The character separating the columns</p>": "<p>列分隔符。</p>",
  "<p>Export items to an XML file.</p>": "<p>将数据项导出到 XML 文件。</p>",
  "<p>Each item becomes an element whose children are named after the item's keys. Keys that aren't valid XML\nnames are rewritten and keep the original in a <code>name</code> attribute, and any value that isn't a scalar\n(a nested dictionary or a list) is written as JSON.</p>": "<p>每个数据项会变成一个元素,其子元素以数据项的键命名。不符合 XML 名称规则的键会被改写,原始名称保存在 <code>name</code> 属性中。非标量值(嵌套字典或列表)会以 JSON 写入。</p>",
  "<p>The name of the element wrapping all the items</p>": "<p>包含所有数据项的元素名称。</p>",
  "<p>The name of the element wrapping every item</p>": "<p>包含单个数据项的元素名称。</p>",
  "<p>Pretty-print the file instead of writing it on a single line</p>": "<p>格式化文件,便于阅读,而不是将内容全部写在一行。</p>",
  "<p>Manages pre-configured session instances.</p>": "<p>管理预先配置好的会话实例。</p>",
  "<p>Register a session instance.</p>": "<p>注册会话实例。</p>",
  "<p>Name to reference this session in requests</p>": "<p>在请求中引用此会话的名称。</p>",
  "<p>Your pre-configured session instance</p>": "<p>预先配置好的会话实例。</p>",
  "<p>If True, this becomes the default session</p>": "<p>为 True 时,将此会话设为默认会话。</p>",
  "<p>If True, the session will be started only when a request uses its ID.</p>": "<p>为 True 时,仅在请求使用此会话 ID 时启动会话。</p>",
  "<p>Removes a session.</p>": "<p>移除会话。</p>",
  "<p>ID of session to remove</p>": "<p>要移除的会话 ID。</p>",
  "<p>Remove and returns a session.</p>": "<p>移除并返回会话。</p>",
  "<p>Start all sessions that aren't already alive.</p>": "<p>启动所有尚未运行的会话。</p>",
  "<p>Close all registered sessions.</p>": "<p>关闭所有已注册的会话。</p>",
  "<p>Check if a session ID is registered.</p>": "<p>检查会话 ID 是否已注册。</p>",
  "<p>Number of registered sessions.</p>": "<p>已注册的会话数量。</p>"
} %}
{% macro translate(value) %}
  {% set result = namespace(html=value | replace("Bases:", "基类:")) %}
  {% for source, target in translations.items() %}
    {% set result.html = result.html | replace(source, target | safe) %}
  {% endfor %}
  {{ result.html | safe }}
{% endmacro %}