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

> Cascade 将 AI 智能体编程能力带到 JetBrains，提供 Write/Chat 模式、语音输入、工具访问、Turbo 模式和实时协作。

Windsurf 的 Cascade 将先进的 AI 智能体编程体验带到 JetBrains 系列中。

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

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

在 Cascade 对话输入框下方的选择菜单中，选择你想要的模型。点击下方可查看可用模型的完整说明，以及它们在不同套餐和价格下的可用情况。

<Card title="模型" icon="robot" href="/zh/desktop/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/cognitionai/-PTA3zzo2bR9Qfc8/desktop/assets/jetbrains-cascade-modes.mp4?fit=max&auto=format&n=-PTA3zzo2bR9Qfc8&q=85&s=f425567536dbd2c522dfb717e3cce226" data-path="desktop/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/desktop/cascade/web-search) 和[终端](/zh/desktop/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/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/voice-mode.mp4?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=99e3fdda91ed54226237e7d4714d55e4" data-path="desktop/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/cognitionai/hxeMffzXgF_RWx-U/desktop/assets/windsurf/cascade/cascade-revert.mp4?fit=max&auto=format&n=hxeMffzXgF_RWx-U&q=85&s=2c8998de7ae41d52f7e201968b7d0fa2" data-path="desktop/assets/windsurf/cascade/cascade-revert.mp4" />

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

Cascade 在 JetBrains 中支持三种命令自动执行级别：**关闭**、**自动** 和 **Turbo**。你可以在 Windsurf Settings 面板中选择所需的级别。

| 级别        | 说明                              |
| --------- | ------------------------------- |
| **关闭**    | 从不自动执行终端命令，但允许列表中的命令除外。         |
| **自动**    | 模型会根据安全评估决定是否自动执行命令。仅高级模型支持此功能。 |
| **Turbo** | 始终自动执行终端命令和浏览器控件，但拒绝列表中的命令除外。   |

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

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

如需详细了解自动执行级别以及允许/拒绝列表，请参阅[终端文档](/zh/desktop/terminal#auto-executed-cascade-commands)。

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

Cascade 的一项独特能力是，它能够感知你当前的实时操作。

你不一定还需要结合之前操作的 context 来提供提示，因为 Cascade 已经了解这些信息。

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

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

如果你希望 Cascade 忽略某些文件，可以将这些文件添加到工作区根目录下的 `.codeiumignore` 中。这样一来，Cascade 就无法查看、编辑或创建位于指定路径中的文件。你可以按照类似 `.gitignore` 的格式来声明这些文件路径。

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

对于管理多个代码仓库的 Enterprise 客户，你可以将全局 `.codeiumignore` 文件放在 `~/.codeium/` 文件夹中，以便在所有代码仓库中统一实施忽略规则。此全局配置会应用于你系统上的所有 Windsurf 工作区，并与任何代码仓库专属的 `.codeiumignore` 文件同时生效。