Windsurf Cascade 功能详解

Cascade 是 Windsurf 的核心 AI 代理助手，它超越了简单的代码补全，能够像一名真正的队友一样，在你的编辑器中执行复杂的开发任务。

#1. 什么是 Cascade？

Cascade 是一个“代理式”（Agentic）AI 界面。与传统的 AI 聊天窗口不同，它具有：

• 文件读写权：直接修改你的源码。
• 终端操作权：运行安装、构建、测试命令。
• 全局上下文：自动搜索并引用项目中相关的函数定义和类型。

#2. 核心工作模式

#A. 对话模式 (Chat)

就像在浏览器中使用 ChatGPT 一样，你可以询问关于代码的问题。

"解释这个接口的设计模式是什么？"

#B. 编辑模式 (Edit)

你可以指挥 Cascade 修改代码。

"将这个页面重构为响应式布局，并在移动端隐藏侧边栏。"

#C. 代理模式 (Agent) - 最强大！

你可以给出一个高层次的目标，Cascade 会拆解步骤并执行。

"在这个项目中集成 Stripe 支付，创建一个新的 API 路由并编写前端测试用例。" Cascade 会自动创建路由文件、更新 package.json、运行 npm install 并测试结果。

#3. 关键交互技巧

#使用 @ 符号手动提供上下文

虽然 Cascade 会自动感知上下文，但你可以显式指定：

• @Files：引用特定的文件。
• @Code：引用特定的函数或类。
• @Terminal：将最近的报错信息发送给 AI。

#快捷键

• Cmd + L (Mac) / Ctrl + L (Win)：快速调出右侧 Cascade 侧边栏。

#4. 真实案例演示

任务：给项目添加黑暗模式切换。

1. 输入 Prompt：使用 Tailwind CSS 为整个应用添加深色模式支持，并添加一个切换开关。
2. Cascade 执行：
   • 检查 tailwind.config.js 确保配置了 darkMode: 'class'。
   • 在 App.tsx 中注入状态管理逻辑。
   • 创建一个新的 ThemeToggle 组件并导出。
   • 在 Header 中插入该组件。
3. 你只需要：在 Cascade 建议的每一行改动旁点击 "Accept" 即可。

#5. 安全与可控

• 变更对比 (Diff)：所有 Cascade 的代码修改都会以 Diff 形式展示，你可以逐行审核。
• 撤销支持：如果 AI 的改动不符合预期，可以一键 Undo。

---

小贴士：Cascade 擅长处理“脏活累活”，比如编写测试用例、写注释或进行重复性的样式调整，释放你的精力去处理核心架构设计。