Windsurf（Codeium 出品的 AI-first IDE）在国内技术圈早就不算新东西，但说实话，我观察了一圈身边用它的人，90% 都只干一件事——打开右侧 Cascade 面板，像用 ChatGPT 一样打字提问，然后复制粘贴。这相当于买了个多功能料理机，只拿来烧热水。Cascade 真正的威力藏在七道"暗门"里：规则文件、长期记忆、@上下文、内外联分工、图像输入、MCP 外脑、自动运行加回滚。这篇文章就把这七处逐一拆开，每处给操作步骤、预期效果和适用场景，看完你能立刻把同一个项目做得比别人快一截。
一个判断标准：如果你每次还要手动告诉 Cascade"我们用 TypeScript + Tailwind"，说明你还没用对——这些它本该自己记住。
.windsurfrules 是你和 AI 的"隐形合同"操作步骤：
1. 在项目根目录新建一个 .windsurfrules 文件（纯文本，无扩展名）。
2. 写入四块内容：技术栈（语言/框架/包管理器）、命名与目录规范、硬性禁止项（如"禁止使用 any"、"禁止直接修改 generated 目录"）、关键架构说明。
3. 还有全局规则：Settings → Rules，写在项目之外也生效，适合放个人编码风格（注释密度、提交信息格式）。
预期效果： Cascade 每次启动都会自动读取，相当于给所有对话预设了系统提示词。你再也不用在每条消息里重复"请用 pnpm"、"别用 class component"。
适用场景： 团队多人协作项目、有明确 code style 的工程、外包/接手陌生代码库。
中国用户常踩的坑： 很多人把规范写进 README.md 或 CONTRIBUTING.md，以为 Cascade 会读——它不一定读。规则要进 .windsurfrules 才是"硬约束"，进 markdown 只是"参考"。两者的优先级完全不同。
操作步骤：
1. Cascade 会自动记忆：你在对话里透露的偏好（"我习惯先写测试"）、项目事实（"部署在 Vercel"）都可能被它存下。
2. 主动喂记忆：直接对它说 记住：这个项目用 React Query 管理服务端状态，它会写入 Memory。
3. 管理记忆：在 Cascade 面板找到 Memories 入口（规则/记忆管理），可以查看、编辑、删除每一条。
预期效果： 跨会话保留上下文，新开对话不用重新交代背景。
适用场景： 长期维护的项目、个人长期使用的开发环境。
关键区分（信息差）： Rules 是你定的硬规则，Memories 是它自己学的软偏好。 这意味着——它也会记住你的坏习惯。如果你某次为了图快写了 // @ts-ignore，它可能以为你喜欢这么干。定期清理 Memories 列表，把误学的删掉，比让它"一直记着"重要得多。
@ 提一下，上下文精度直接拉满操作步骤：
在 Cascade 输入框敲 @，会弹出可引用对象，常用有：
| 触发符 | 引用对象 | 典型用途 |
|---|---|---|
@file / @folder |
具体文件/目录 | 锁定改动范围 |
@terminal |
终端最近输出 | 排查报错 |
@problems |
当前所有报错/警告 | 批量修 lint |
@web |
实时联网搜索 | 查最新 API |
@docs |
第三方文档 | 喂官方文档而非它的旧记忆 |
@code / @symbol |
代码符号 | 精确定位函数/类 |
预期效果： 喂精准上下文，既省 token 又答得准。
适用场景： 报错排查时 @terminal + @problems 一把梭；新版本 API 不确定时用 @docs 喂官方文档；只想改某个函数时用 @symbol。
中国用户常踩的坑： 直接打字"帮我修一下报错"，Cascade 得先花一轮去猜你在说哪个文件、哪个错误。给它 @terminal，它一步到位。
Cmd+I 内联 vs Cmd+L 面板——分场景才快操作步骤：
- Cmd+I（Win 为 Ctrl+I）：编辑器内联唤起 AI。选中文本后触发，适合单行/单函数级的小改：加注释、重命名、补 try-catch、改一个正则。
- Cmd+L：打开右侧 Cascade 面板。适合跨多文件的大改、需要跑命令、需要长上下文推理的任务。
预期效果： 选对入口，响应更快、更贴合任务粒度。
适用场景： 见下方决策图——这是这套七暗门里最容易立刻提速的一条。
flowchart TD
A[需要改代码] --> B{改动范围多大?}
B -->|单行/单函数/加注释/重构一个小块| C[Cmd+I 内联]
B -->|多文件/新功能/要跑命令| D[Cmd+L Cascade 面板]
C --> E{要不要看官方文档?}
E -->|要| F[加 @docs]
E -->|不用| G[直接改]
D --> H{改动跨度大?}
H -->|是, 多步连续| I[开 Auto-run + Checkpoint]
H -->|否| J[手动逐步确认]
I --> K[出错就 Restore 回滚]
J --> L[正常推进]
G --> M[完成]
F --> M
K --> M
L --> M
style C fill:#dbeafe
style D fill:#fef3c7
style I fill:#dcfce7
style K fill:#fee2e2
中国用户常踩的坑： 所有问题都丢进 Cascade 大面板。改一行括号也开 agent 跑一圈，又慢又容易动到不该动的文件。记住：小改内联，大改面板。
操作步骤：
1. 截一张 UI 设计稿（Figma、网页、App 截图），或手绘草图，甚至报错截图。
2. 在 Cascade 输入框直接 Cmd+V 粘贴。
3. 配合文字指令，如 按照这张图还原一个 React + Tailwind 组件，响应式。
预期效果： 图转代码、看图排错，免去用文字描述布局的失真。
适用场景： 前端还原设计稿、把竞品界面快速复刻为组件、把报错截图丢给它分析、白板草图转原型。
中国用户常踩的坑： 用文字描述"左边一个按钮右边一个输入框，中间有个红色的……"，又慢又走样。直接截图喂图，比打一百个字都准。
操作步骤：
1. 进入 Settings → Cascade → MCP Servers（或项目根目录放 .mcp.json）。
2. 添加 MCP（Model Context Protocol）服务器配置。MCP 是一个开放协议，可接的工具很多：数据库、Playwright 浏览器、Figma、GitHub、本地文件系统等。
3. 接好后，Cascade 可以直接调用这些外部能力。
预期效果： Cascade 能自己查数据库 schema、驱动浏览器跑 E2E、读 Figma 设计稿、查 GitHub issue。
适用场景：
- 联数据库：让它 先查 users 表结构再写查询，不用你手动复制 schema。
- 浏览器自动化：接 Playwright MCP，让它自己开浏览器点页面验证改动。
- 设计协作：接 Figma MCP，直接读设计稿图层信息。
中国用户常踩的坑： 不知道有 MCP，所有外部数据靠"复制粘贴进对话框"。一次两次可以，长期就是体力活。MCP 把 Cascade 从"只会读你代码"升级成"能操作外部世界"。
操作步骤：
1. Cascade 支持自动运行模式：让它连续改多个文件、自动跑命令，不必每步都点确认。
2. 每一轮对话会产生 Checkpoint（检查点）/ 可恢复状态。
3. 出错时用 Restore 回滚到上一个检查点。
预期效果： agent 连续干活提速，错了秒级回滚，不怕改崩。
适用场景： 大规模重构、连续多步任务（如"给所有 API 加错误处理"）、试验性探索。
关键心法（信息差）： 自动运行和检查点必须成对用。只开自动跑不开回滚，改崩了难恢复；只开回滚不敢自动跑，全程手动点确认，慢。正确姿势是 开 Auto-run + 每个里程碑前留一个 Checkpoint，错了就 Restore。动手大改前先 git commit 一道，是双保险。
七道暗门，本质上回答一个问题：别再让 Cascade 每次从零猜你的上下文。 规则和记忆负责"它本就该知道的"，@-mention 和图片负责"你这次要告诉它的"，MCP 负责外部世界，内联/面板/自动运行负责干活节奏。
| 维度 | 大多数人的用法（10%） | 七道暗门后的用法（90%） |
|---|---|---|
| 项目规范 | 每次口头重复技术栈 | .windsurfrules 自动注入 |
| 上下文延续 | 每次重新交代背景 | Memories 跨会话保留，定期清理 |
| 报错排查 | 打字描述错误 | @terminal + @problems 一把梭 |
| 改动粒度 | 全部丢进大面板 | Cmd+I 内联小改，Cmd+L 大改 |
| 设计还原 | 文字描述布局 | 截图直接粘贴转代码 |
| 外部数据 | 手动复制粘贴 | MCP 接数据库/浏览器/Figma |
| 大改风险 | 全程手动点 / 全开裸跑 | Auto-run + Checkpoint 成对用 |
.windsurfrules，写清技术栈和 3 条硬禁止项。@terminal 再提问，对比一下和直接打字的响应质量。Cmd+I，多文件大改走 Cmd+L。git commit，并在 Cascade 里每个里程碑留 Checkpoint。做到前 3 条，你已经超过身边 70% 的 Windsurf 用户；全做到，这套工作流可以直接搬到团队规范里。
本文由「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 等场景全覆盖。