> ## 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 概览

> Cascade 将智能代理式 AI 编码能力带到 JetBrains，支持 Write/Chat 模式、语音输入、工具访问、turbo 模式以及实时协作。

Windsurf 的 Cascade 将最优秀的智能代理式编码带到 JetBrains 套件。

要打开 Cascade，请按 `Cmd/Ctrl+L`，或点击 Cascade 图标。

<div id="model-selection">
  # 模型选择
</div>

在 Cascade 对话输入框下方的菜单中选择你需要的 AI 模型。点击下方以查看可用模型的完整列表，以及它们在不同方案与价格中的可用性。

<Card title="Models" icon="robot" href="/zh/windsurf/models" horizontal={true}>
  Windsurf 中的模型可用性。
</Card>

<div id="writechat-modes">
  # Write/Chat 模式
</div>

Cascade 提供两种模式：**Write** 和 **Chat**。

在 Write 模式下，Cascade 可以在你的代码库中创建并修改代码；而 Chat 模式则更适合就你的代码库或通用编码原则进行提问与解答。

<video autoPlay muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/codeium/d8O4q6w3H2CjrirL/assets/jetbrains-cascade-modes.mp4?fit=max&auto=format&n=d8O4q6w3H2CjrirL&q=85&s=dab1edae206eabdc1a675462866b1ad6" data-path="assets/jetbrains-cascade-modes.mp4" />

<div id="queued-messages">
  # 已排队的消息
</div>

在等待 Cascade 完成当前任务时，你可以将新消息加入队列，任务完成后将按顺序执行。

要向队列添加消息，只需在 Cascade 工作时输入你的消息并按下 `Enter`。

* **立即发送**：在空白文本框中再次按下 Enter 可立即发送。
* **删除**：在发送前将任意消息从队列中移除

<div id="access-to-tools">
  # 访问工具
</div>

Cascade 具备多种工具可用，例如 Search、Analyze、[Web Search](/zh/windsurf/cascade/web-search) 和 [terminal](/zh/windsurf/terminal)。

它可以识别你正在使用哪些包和工具、哪些需要安装，甚至可以替你安装。只需向 Cascade 询问如何运行你的项目，然后按下 Accept 即可。

<Note>Cascade 每次提示最多可进行 25 次工具调用。如果执行过程中断，只需输入 `continue`，Cascade 将从中断处继续。每次 `continue` 都将计为新的提示。</Note>

<div id="voice-input">
  # 语音输入
</div>

使用语音输入，用你的声音与 Cascade 进行交互。当前版本支持将语音实时转写为文本。

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/cascade/voice-mode.mp4?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=b6881ef11385d4f05fa151e0808a9e78" data-path="assets/windsurf/cascade/voice-mode.mp4" />

<div id="revert-to-previous-steps">
  # 回退到先前步骤
</div>

如有需要，你可以回退 Cascade 所做的更改。将鼠标悬停在原始提示上，点击右侧的回退箭头，或直接在目录中选择回退。这样会将所有代码改动恢复到该步骤时你的代码库状态。

<Warning>回退操作目前不可撤销，请谨慎！</Warning>

<video autoPlay controls muted loop playsInline className="w-full aspect-video" src="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/cascade/cascade-revert.mp4?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=fe494383062acfc1efe07b23c03607a2" data-path="assets/windsurf/cascade/cascade-revert.mp4" />

<div id="auto-execution-modes">
  # 自动执行模式
</div>

Cascade 在 JetBrains 中支持三种命令自动执行级别：**Off**、**Auto** 和 **Turbo**。你可以在 Windsurf 设置面板中选择你偏好的级别。

| Level     | Description                          |
| --------- | ------------------------------------ |
| **Off**   | 从不自动执行终端命令，允许列表中的命令除外。               |
| **Auto**  | AI 模型会根据安全评估决定是否自动执行命令。仅适用于高级 AI 模型。 |
| **Turbo** | 始终自动执行终端命令和浏览器控制操作，拒绝列表中的命令除外。       |

<Note>对于 Teams 和 Enterprise 用户，管理员可以设置自动执行级别的最大上限。用户可以选择不超过该上限的任意级别，但不能超出该上限。</Note>

<Frame>
  <img style={{ maxHeight: "500px" }} src="https://mintcdn.com/codeium/qJj_RRojefb93yIg/assets/windsurf/cascade/cascade-turbo-mode.png?fit=max&auto=format&n=qJj_RRojefb93yIg&q=85&s=8860ea8311000ae2cc440cef26560620" width="680" height="60" data-path="assets/windsurf/cascade/cascade-turbo-mode.png" />
</Frame>

有关自动执行级别以及允许/拒绝列表的更多详情，请参阅[终端文档](/zh/windsurf/terminal#auto-executed-cascade-commands)。

<div id="real-time-collaboration">
  # 实时协作
</div>

Cascade 的一项独特能力是它能感知你正在进行的操作。

你不必再在提示中额外提供之前操作的上下文，Cascade 已经心知肚明。

试着在代码编辑器中手动做一个修改，然后让 Cascade “继续我的工作”！

<div id="ignoring-files">
  # 忽略文件
</div>

如果你希望 Cascade 忽略某些文件，可以在工作区根目录的 `.codeiumignore` 中添加相应条目。这样将阻止 Cascade 查看、编辑或在指定路径内创建文件。你可以使用与 `.gitignore` 类似的格式来声明文件路径。

<div id="global-codeiumignore">
  ## 全局 .codeiumignore
</div>

对于管理多个代码仓库的 Enterprise 客户，您可以在 `~/.codeium/` 文件夹中放置一个全局 `.codeiumignore` 文件，从而在所有仓库中统一执行忽略规则。此全局配置将应用于您系统上的所有 Windsurf 工作区，并与各仓库中的 `.codeiumignore` 文件叠加生效。