国内AI编程圈的注意力几乎全压在Cursor和Claude Code上，但海外有另一款渗透率极高的AI IDE一直被低估——Windsurf（前身是Codeium，据公开报道，2025年经历收购风波后已归入Cognition旗下，产品仍在持续迭代）。它的Agent组件叫Cascade，设计思路和Cursor Composer、Claude Code都不一样：更强调“记忆、规则、流程”三件套。问题是，绝大多数人装上之后只会拿它当聊天框写代码，把最好的几个功能全浪费了。
这篇文章就做一件事：把Cascade里8个中文教程几乎没人写的“暗门”一次挖出来。每一个都有具体操作路径，今晚装上就能用。
说明：Windsurf迭代很快，文中的菜单路径以官方文档（docs.windsurf.com）最新版本为准；涉及价格、额度的部分不写死数字，请以官网实时页面为依据。
痛点：你在每个新会话里反复交代“我们项目用pnpm不用npm”“端口是3750”“部署脚本在scripts/deploy.sh”，说了几十遍。
操作： 1. 打开Cascade面板，找到历史会话旁的Memories区域（或在Settings里搜Memories）； 2. Cascade会根据对话自动沉淀Memory，比如“该项目使用pnpm”； 3. 关键动作是手动管理：错误的Memory直接删除——否则它会每次都把错误约定带回来；重要的约定点“Add Memory”手动写入； 4. 还有一种更隐蔽的用法：在对话里直接说"remember that ..."，Cascade会主动生成一条记忆。
效果：新会话开局不再“失忆”，尤其适合长周期项目。这是Cascade和Cursor最早的差异化设计，但很少有人去做“记忆清理”，结果就是记忆区塞满过时信息，反而污染上下文。
大多数人只知道往一个框里粘贴规则，其实Windsurf的Rules是两层结构：
.windsurf/rules/ 下的多个Markdown文件，可以每个文件单独设置激活模式：*.test.ts 生效。实操建议：把“项目架构约定”“提交规范”写成Always On；“性能审查清单”写成Manual，需要时@一下；测试文件的特殊规则用Glob绑定。规则要写祈使句、控制篇幅——规则越长，模型遵循率越低。
这是被埋得最深的功能。在 .windsurf/workflows/ 下建一个Markdown文件（如 fix-issue.md），写清楚步骤，之后在Cascade输入框里敲 /fix-issue 就能一键复跑整套流程，不用每次重新描述。
举例，一个修Bug工作流的骨架：
---
description: 修复issue的标准流程
---
1. 读取 issue 描述，复现问题
2. 定位相关文件，先给修复方案等确认
3. 修改代码并补测试
4. 运行 lint 和测试，全绿后总结改动
把“你的SOP”写进workflow，等于是给团队沉淀了一个可执行的Playbook。新同事克隆仓库，连规范带流程一起继承。
Cascade输入框处可以切换Plan模式和Write模式。Plan模式下只读不写，专门用来做调研和方案；确认方案后再切Write动手。
为什么重要：直接让Agent一头扎进去改代码，方向错了就是全量回滚重来，烧掉的是真金白银的积分。正确的节奏是：复杂任务先Plan，把“要动哪些文件、分几步”审一遍，再放行执行。小改动则直接Write，别过度仪式化。
Cascade支持一整套@提及：@file、@folder、@code、@web、@commit、@terminal等等。其中最值钱但最少人用的是 @docs：
场景：你用一个小众SDK，模型训练数据里根本没有它，或者在2024年后大改过API——把它文档喂进@docs，幻觉率断崖式下降。搭配@web（联网搜索）使用，效果更稳。
Windsurf支持MCP协议（Model Context Protocol）。在Settings → Cascade → MCP Servers里添加服务器，配置文件位于 ~/.codeium/windsurf/mcp_config.json（也可从社区市场的deeplink一键安装）。
接上之后Cascade的能力半径直接出圈：
提醒：MCP服务器是你本机运行的进程，只装可信来源，装完先看它申请了什么权限。
Windsurf的Tab补全背后是自研模型（SWE系列，据官方博客介绍主打速度）。但两个进阶用法很少有人讲：
三个收尾细节，组合起来是“安全网”：
flowchart LR
A["需求输入"] --> B["Rules 分层过滤"]
B --> C["Plan 模式出方案"]
C --> D["人工确认"]
D --> E["Write 模式执行"]
E --> F["@docs 查本地文档"]
E --> G["MCP 操作外部工具"]
E --> H["跑终端命令"]
H --> I{"执行策略"}
I -->|逐条确认| J["人工放行"]
I -->|自动档| K["直接执行"]
J --> L["Checkpoint 检查点"]
K --> L
L --> M["Tab 跳转审查改动"]
M --> N["Memories 沉淀经验"]
N --> A
注意最后一条闭环：执行经验沉淀回Memories，影响下一次任务。用出这个飞轮的人，Cascade会越用越懂你的项目；只用聊天框的人，每次都从零开始。
| 大多数人以为 | 实际上 |
|---|---|
| Windsurf是Cursor平替，随便用用 | 它的记忆/规则/工作流三件套是独立设计，值得专门配置 |
| 每个会话都要重新交代项目背景 | Memories自动沉淀+手动管理，一次交代终身有效 |
| 规则只能写一段粘贴进去 | 两层Rules+四种激活模式，按需注入才不污染上下文 |
| 重复任务每次重新描述 | .windsurf/workflows/ 固化成斜杠命令，一键复跑 |
| 小众库API全靠模型瞎猜 | @docs索引官方文档，幻觉率断崖下降 |
| Agent只能读写本地代码 | MCP接上后能开浏览器、读issue、看设计稿 |
| 改崩了手动撤销 | 检查点Restore一步回滚 |
今晚就能做完的五步：
.windsurf/rules/，放两条Always On的项目约定；一周后回来对比：同样的任务，配置前后的对话轮次和积分消耗会差出一个量级。
本文由「51学通信」技术团队出品。51学通信由通信行业18年老兵爱卫生（微信ID: gprshome201101）维护。 聚焦5G/6G核心网、3GPP标准、AI工具实战。知识星球「51学通信」提供深度技术答疑和行业洞察。
[!tip] 51学通信知识星球 星主：爱卫生（微信：gprshome201101）——公众号「51学通信」创办者，19 年通信行业运维与讲师经验，著有《GPRS网络信令实例详解》《EPC原理与实践》《5G核心网原理与实践》三本纸质书（各大电商平台有售）。 星球定位：深耕 5G 核心网、IMS、NFV/AI、云原生等 ICT 领域，主打运维岗位与信令分析。 当前规模：5200 篇主题 / 990 个回答，198 元/年。 加入福利：加入星球后请加爱卫生微信，拉您进知识星球年度陪伴与答疑群——不限量回复您的各种问题，另有群内分享。 AI 加持：51学通信知识星球已作为 skill 接入 WorkBuddy，使用 deepseek-4-flash 在海量星球帖子中精准找贴、找视频、找 FAQ 和案例，做总结、找文档和 PPT 等场景全覆盖。