> ## 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.

# 网页与文档搜索

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

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 Settings 中启用网页搜索。你可以通过以下几种方式启用：

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>

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