> ## 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 是 Windsurf 的主动式 AI 助手，支持 Code/Chat 模式、工具调用、语音输入、检查点、实时感知以及与 linter 的集成。
Windsurf 的 Cascade 将人与 AI 的协作提升到全新水平。
要打开 Cascade，按下 `Cmd/Ctrl+L`，或点击 Windsurf 窗口右上角的 Cascade 图标。编辑器或终端中选中的任何文本都会自动包含在内。
### 功能快速链接
搜索网页以为 Cascade 的建议提供参考信息。
记忆和规则有助于自定义行为。
MCP (模型上下文协议，Model Context Protocol) 服务器可扩展代理的能力。
进阶版终端体验。
将重复性流程实现自动化。
一键部署应用。
# 模型选择
在 Cascade 对话输入框下方的菜单中选择你需要的 AI 模型。点击下方可查看所有可用模型的完整列表，以及它们在不同套餐与定价下的可用性。
Windsurf 中的模型可用性。
# Cascade Code / Cascade Chat
Cascade 提供两种主要模式：**Code** 和 **Chat**。
Code 模式允许 Cascade 创建并修改你的代码库；Chat 模式则针对与你的代码库相关的问题或通用编码原则进行了优化。
在 Chat 模式下，Cascade 可能会提出新的代码方案，供你接受并插入。
# 计划与待办清单
Cascade 具备内置的规划功能，可提升长时任务的执行效果。
在后台，一个专门的规划代理会持续细化长期计划，而你选择的 AI 模型则根据该计划专注执行短期步骤。
Cascade 会在对话中创建待办清单，用于跟踪复杂任务的进度。若需调整计划，只需让 Cascade 更新待办清单即可。
在对话过程中，随着获取到新的信息 (例如 [Memory](/zh/windsurf/cascade/memories)) ，Cascade 也可能自动更新计划。
# 已排队的消息
在等待 Cascade 完成当前任务时，你可以将新消息加入队列，待任务完成后按顺序执行。
要将消息添加到队列，只需在 Cascade 运行时输入你的消息并按下 `Enter`。
* **立即发送**：在空文本框中再次按 Enter 即可立即发送。
* **删除**：在发送前从队列中移除任意消息
# 工具调用
Cascade 拥有多种工具可用，例如 Search、Analyze、[Web Search](/zh/windsurf/cascade/web-search)、[MCP](/zh/windsurf/cascade/mcp) 和 [terminal](/zh/windsurf/terminal)。
它可以识别你正在使用哪些软件包和工具、哪些需要安装，甚至还能替你完成安装。只需询问 Cascade 如何运行你的项目，然后点击 Accept。
Cascade 每次提示最多可发起 20 次工具调用。如果执行轨迹中断，只需点击 `continue` 按钮，Cascade 会从上次停下的位置继续。不过，由于工具调用产生成本，每次 `continue` 都会计作新的提示额度。
你可以配置 `Auto-Continue`，当达到限制时让 Cascade 自动继续响应。继续操作将消耗与你所使用的 AI 模型相对应的提示额度。
# 语音输入
使用语音输入，以语音方式与 Cascade 进行交互。目前它支持将你的语音转写为文本。
# 命名检查点与回退
你可以回退由 Cascade 所做的更改。只需将鼠标悬停在原始提示上，点击右侧的回退箭头，或直接从目录中回退。这样会将所有代码更改恢复到你的代码库在目标步骤时的状态。
回退目前不可撤销，请谨慎操作！
你也可以在对话中为项目的当前状态创建一个命名快照/检查点，方便你随时跳转并回退到该状态。
# 实时感知
Windsurf 与 Cascade 的一项独特能力是能了解你正在进行的操作，无需再为之前的操作提供额外上下文。
只需对 Cascade 说“Continue”即可。
# 将问题发送到 Cascade
当你的代码在编辑器底部的 “Problems” 面板中出现问题时，只需点击 `Send to Cascade` 按钮，即可将这些问题以 @ 提及的形式发送到 Cascade 面板。
# 解释并修复
在编辑器中遇到错误时，只需选中该错误并点击 `Explain and Fix`，即可由 Cascade 为你自动修复。
# 忽略文件
如果你希望 Cascade 忽略某些文件，可以在工作区根目录的 `.codeiumignore` 中添加相应条目。这样将阻止 Cascade 在指定路径内查看、编辑或创建文件。你可以使用与 `.gitignore` 类似的格式来声明文件路径。
## 全局 .codeiumignore
对于管理多个代码库的 Enterprise 客户，您可以在 `~/.codeium/` 文件夹中放置一个全局 `.codeiumignore` 文件，以在所有代码库中统一强制执行忽略规则。该全局配置将适用于您系统上的所有 Windsurf 工作区，并会与任何代码库特定的 `.codeiumignore` 文件叠加生效。
# Linter 集成
Cascade 可以自动修复其生成代码中的 lint 错误。此功能默认开启；你也可以在工具调用中点击 `Auto-fix`，再点击 `disable` 将其关闭。此类编辑不会消耗任何额度。
当 Cascade 为修复其自身引入并自动检测到的 lint 而进行编辑时，
该编辑可能会被视为免额度收费。这样做是因为
修复 lint 错误会增加 Cascade 的工具调用次数。
# 共享你的对话
此功能目前仅向 Teams 和 Enterprise 客户开放。
你可以在 Cascade 面板右上角点击“...”更多选项，然后选择“Share Conversation”，将你的 Cascade 交互记录分享给团队。
# 使用 @ 提及先前的对话
你也可以在当前对话中通过 `@-mention` 引用先前的对话。
当你这样做时，Cascade 会检索最相关且有用的信息，例如对话摘要、检查点，以及你所查询的对话特定片段。通常不会检索整段对话，以免占用过多上下文窗口容量。
# 并行运行的 Cascade
用户可以同时运行多个 Cascade。您可以使用 Cascade 面板左上角的下拉菜单在它们之间切换。
如果两个 Cascade 同时编辑同一文件，可能会发生竞态，且有时第二次编辑会失败。
如果预计两个 Cascade 会编辑相似的文件，您应考虑使用 [worktrees](./worktrees) 将它们隔离开来。