> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 网页和文档搜索

> 启用 Cascade，使用 @web 和 @docs 提及实时搜索网页并读取文档页面，以获取最新上下文。

Cascade 现在可以智能解析并分块处理网页和文档，为模型提供实时上下文。理解这项功能的关键在于：Cascade 会像人一样浏览互联网。

我们的网页工具经过专门设计，只会获取必要的信息，从而更高效地使用你的额度。

<div id="overview">
  ## 概览
</div>

为了帮助你更好地了解 网页搜索 的工作原理，我们录制了一段简短的视频，介绍其核心概念和最佳实践。

<iframe width="560" height="315" src="https://www.youtube.com/embed/moIySJ4d0UY" title="YouTube 视频播放器" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />

<div id="quick-start">
  ### 快速开始
</div>

最快的上手方式，是在编辑器右下角的 Windsurf Settings 中启用网页搜索。你可以通过以下几种方式启用它：

1. 问一个很可能需要联网才能回答的问题 (例如：“React 最新版本有哪些新内容？”) 。
2. 使用 `@web` 强制进行文档搜索。
3. 使用 `@docs` 在一组我们确信能够高质量读取的文档中进行查询。
4. 将 URL 粘贴到你的消息中。

<div id="search-the-web">
  ## 搜索网页
</div>

Cascade 可以判断，用户的某些请求可能需要进行实时网页搜索，才能提供最佳回答。在这种情况下，Cascade 会执行网页搜索并将结果提供给用户。这一过程既可以自动进行，也可以通过 `@web` 手动触发。

<Note>
  **启用网页搜索** Admin 设置用于控制 Cascade 是否可以在公共互联网上执行网页搜索。它不会影响 Cascade 读取特定 URL 的能力 (请参阅下方的[阅读页面](#reading-pages)) ，因为该操作是在用户设备本地执行的。
</Note>

<Frame style={{ border: "none", background: "none" }}>
  <img src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/cascade-search-web.png?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=17c1d1634a01f0c499e860191a70b8d5" width="1150" height="530" data-path="desktop/assets/windsurf/cascade/cascade-search-web.png" />
</Frame>

<div id="reading-pages">
  ## 阅读页面
</div>

Cascade 可以读取单个页面，例如文档、博客文章和 GitHub 文件。页面读取完全在你的设备上、你的网络内进行，因此如果你使用了 VPN，一般不会有任何问题。

页面内容可能来自网页搜索结果、根据对话内容推断，或来自你直接粘贴到消息中的 URL。

我们会将页面拆分成多个片段，这和人类阅读页面的方式非常相似：面对较长的页面时，我们会先快速浏览到目标部分，再细读相关内容。Cascade 的工作方式也是如此。

<Frame style={{ border: "none", background: "none" }}>
  <img src="https://mintcdn.com/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/cascade-parse-url.png?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=ed31a5af82c0db89c4b88b77e2d8a017" width="1158" height="538" data-path="desktop/assets/windsurf/cascade/cascade-parse-url.png" />
</Frame>

需要注意的是，并非所有页面都可以被解析。我们正在持续改进网站读取的质量。如果有你希望我们更好支持的特定网站，欢迎提交功能请求！