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

# 网页与文档搜索

> 使用 @web 和 @docs 提及、URL 解析以及来自网页的实时上下文，在 Cascade 中直接搜索网页和文档。

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

我们的网页工具经过设计，只获取高效使用你的额度所需的必要信息。

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

为帮助你更好地了解 Web Search 的工作原理，我们录制了一段短视频，介绍关键概念和最佳实践。

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

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

最快入门的方法是在编辑器右下角的 Windsurf 设置中启用网页搜索。你可以通过以下方式启用：

1. 提出一个很可能需要联网的问题（例如：“React 最新版本有哪些更新？”）。
2. 使用 `@web` 进行文档搜索。
3. 使用 `@docs` 在我们能够高质量读取的一组文档中进行查询。
4. 在消息中粘贴一个 URL。

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

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

<Frame style={{ border: "none", background: "none" }}>
  <img src="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/cascade/cascade-search-web.png?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=b525aef8bc3d129ee5a6d93d10c2cb06" width="1150" height="530" data-path="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/codeium/qJj_RRojefb93yIg/assets/windsurf/cascade/cascade-parse-url.png?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=9963f9eadcca6c5e8152cae398999e00" width="1158" height="538" data-path="assets/windsurf/cascade/cascade-parse-url.png" />
</Frame>

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