首页 › tips-tricks › 别只拿Windsurf补全：八道暗门

别只拿Windsurf当补全：Cascade八道没人教的暗门

国内很多人把 Windsurf 当成"免费版的 Cursor"或者"一个更聪明的 Tab 补全",装上就用,用完就忘。但这个工具在 2025 年被 OpenAI 以约 30 亿美元收走之后,已经长成一套自研模型 + 三套记忆系统 + 多面协同的工程流水线。LogRocket 的 2026 年 2 月 AI 开发工具榜里,Windsurf 排在第一,压过 Cursor 和 Copilot。问题在于:90% 的国内用户只用到了它 10% 的功能。

这篇情报要给你的信息差很具体——Windsurf 里那八道藏在菜单第二层、官方文档里写着但没人翻译、Reddit 上零散提到但没成体系的暗门。每一条都能立刻上手,而且大多能帮你省 credit、省上下文、省重复解释。

暗门一:一句话手动喂记忆,Cascade 永久记住,而且不花一分钱

绝大多数人不知道 Cascade 的 Memories 不只是自动生成,你可以主动灌输。在任意对话里直接说:

remember that 我们的后端用的是 FastAPI 0.110,所有接口必须返回统一 ResponseModel

或者:

create a memory of /legacy 那批接口是 8 年前的老代码,不遵循 REST 约定,绝对不能动它的返回结构

Cascade 会确认记忆已创建。下次相关对话它会自动检索——你不用每次重新解释。

关键信息差在三个数字: - 不消耗 credit。Memories 的存取是纯文本文件,免费。 - 存储路径:~/.codeium/windsurf/memories/,按 workspace 隔离。你切到后端仓库,前端的记忆不会串味儿。 - 它是个人化的,队友开同一个仓库看不到你的记忆。

审计也简单,问一句 what do you know about this codebase? 或 show me your memories for this workspace,它会把记住的全吐出来。建议每季度清理一次过时记忆——它不会自动过期。

暗门二:三套记忆系统别用错——这是最大的坑

Windsurf 的 Cascade 其实有三套并行的记忆机制,90% 的人只用一套然后抱怨"它总是忘事"。错配是翻车的根源:

系统 谁写 进 Git 给团队 自动生成
Memories Cascade ❌ ❌ ✅
Rules(.windsurf/rules/) 你 ✅ ✅ ❌
AGENTS.md 你 ✅ ✅ ❌(零配置)

最常见的错误:把团队编码规范塞进自动 Memories。Memories 是概率性的,不保证每次都检索到,而且只存在你本地。团队规范必须进 Rules,因为它要进 Git、要全队共享、要确定性生效。

flowchart TD
    A[一段上下文] --> B{需要团队共享?}
    B -->|是| C{需要进版本控制?}
    C -->|是| D[放进 Rules 或 AGENTS.md]
    B -->|否,是个人的| E{够正式吗?}
    E -->|太碎/太个人| F[手动 Memory: remember that...]
    D --> G{需要不同激活模式?}
    G -->|是,按文件类型/手动| H[.windsurf/rules/ + YAML]
    G -->|否,越简单越好| I[AGENTS.md 扔目录里]
    style D fill:#2d6a4f,color:#fff
    style F fill:#7b2cbf,color:#fff

记住一句话:影响代码正确性的东西,绝不能交给自动 Memories,必须写成 Rule。

暗门三:AGENTS.md——零配置、目录级、还能跨工具

这是 Windsurf 里门槛最低但最被低估的一个。做法极其简单:在任意目录扔一个叫 AGENTS.md 的文件,写几段话,没有任何 frontmatter、没有配置,Cascade 就自动把它当成该目录及子目录的 always-on 规则。

它特别适合 monorepo(不同包有不同规范)、遗留目录、有合规要求的目录。而且这条是国内信息差里最值钱的一条:AGENTS.md 在 Claude Code 里也认。如果你在 Windsurf 和 Claude Code 之间反复横跳,把 AGENTS.md 当主上下文层、再用各 IDE 专属 Rules 补充,是最省心的方案。

暗门四:.windsurf/rules/ 的四种激活模式 + XML 标签

还在用项目根目录一个巨大的 .windsurfrules?那是老格式。新格式是 .windsurf/rules/ 目录下拆成多个 .md 文件,每个文件用 YAML frontmatter 声明激活模式:

---
trigger: glob
pattern: "src/**/*.test.ts"
---
# 测试规范
- 用 vitest,不用 jest
- mock 掉所有外部 API
- 每个公共函数至少 3 个边界用例

四种激活模式是真正的高阶操作:

模式 什么时候用
always_on TypeScript 规范、命名约定这种永远生效的
glob(pattern: "src/**/*.test.ts") 只在改测试文件时生效,平时不占上下文
model_decision 让 AI 自己判断这段规则该不该用(有些场景有用、有些是噪音)
manual 只有你 @ 提到才激活的特殊规则

最大的坑是把所有规则都设成 always_on,结果 Cascade 上下文窗口被塞满。正确做法:通用规范 always_on,测试规范 glob,迁移手册 manual。再用 XML 标签分组(<tech_stack>、<naming_conventions>、<do_not>),Cascade 检索更准。单文件上限 12000 字符,全局规则 6000 字符——超了会被截断,而且截断方式不可预测。

暗门五:模型分层薅免费额度——credit 是这么算的

很多人不知道 Windsurf 的 credit 系统里,chat 和补全可以完全不花钱。它自研的 SWE-1 模型族是分层的:

模型 用途 速度 是否花 credit
SWE-1-mini Tab 补全 极快 免费
SWE-1-lite 日常 chat、改注释、解释代码 快 无限免费
SWE-1 / 1.5 / 1.6 Cascade 多文件 agent、复杂重构 中 花 credit

也就是说:日常问答用 SWE-1-lite 一分不花,只有让 Cascade 自主跑多文件任务才烧 credit。 credit 数学是这样的: - 一次中等 Cascade 跑(10–15 步、改 2–3 个文件):约 1–3 credit - 一次复杂 Cascade(30–50 步、实现完整功能):约 5–10 credit - 活跃开发者每天 2–3 次 agent 任务:约 5–15 credit/天

免费版每月 25 credit,Pro 版 $15/月给 500 credit。按上面的算法,每天 2–3 次 Cascade 一个月用 150–450 credit,Pro 完全够用。对比:Cursor $20、Claude Pro $20、Copilot $10–19。Windsurf Pro 是同档里最便宜的 agent 方案。

而 SWE-1.5 这个模型本身也不容小觑:SWE-Bench Verified 跑到 40.08%(追平 Claude Sonnet 4.5 的精度),吞吐 950 token/秒——是 Sonnet 4.5(约 73 token/秒)的 13 倍。原来 agent 跑 4 分钟的活,现在 20 秒内能跑一轮。SWE-1.6 又在更硬的 SWE-Bench Pro 上再涨 10%+。而且 GPT-5.1 和 GPT-5.1-Codex 已经接入 Windsurf——这是 OpenAI 收购后红利兑现的直接证据。

暗门六:@-mention 精确投喂上下文

Cascade 会自动理解项目,但你主动 @ 它会更准。这些引用符号是国内用户基本不用的:

@file:src/services/user.ts        # 锁定某个文件
@folder:src/components/            # 给一整个目录
@dependencies                      # 自动读 package.json 依赖
@git                               # 只看 git 改动和历史
@tests                             # 拉测试文件进上下文
@web                               # 联网搜外部资料

配合快捷键更顺手:Cmd/Ctrl+I 开 AI chat,Cmd/Ctrl+K 在光标处内联改,Cmd+Shift+I 跨整个 codebase 操作,Alt+C 切换补全开关,Tab 接受建议。最高效的写法是: @git 把这批改动里所有没写测试的函数补上测试,一次把范围、依据、任务全说清,远比"帮我写测试"这种模糊指令省 credit。

暗门七:Ctrl+I 终端内联对话 + 多面协同

这条针对调试场景。终端里报了个看不懂的错,别去问 Google——Ctrl+I 直接在终端里开内联 AI 对话,把错误贴进去,Cascade 解释、给修复、还能直接帮你改。改完结果就在同一个面板,一键接受。

更狠的是 flow awareness(流式感知):Cascade 的 Cascade 引擎横跨编辑器、内置终端、浏览器预览三个面。它能三角定位——把浏览器 console 里的运行时错误、TypeScript 文件的某一行、测试里的失败断言关联起来,这是只有文件上下文的普通 LLM 做不到的。而且它能在长任务里保持目标一致(50–100 步不跑偏),你中途关掉 IDE,重开它能重建任务状态——记得哪些文件改过、哪些测试在重构前是过的、断在哪里。

暗门八:Workflows 把重复流程固化成斜杠命令

如果你每周都要做"给新接口写测试 + 改文档 + 更新 changelog"这种固定流程,别每次手敲。把它存进 .windsurf/workflows/,以后用斜杠命令调用:/code-review、/write-tests、/security。更进一步还有 Skills(放在 .windsurf/skills/),能链式调用 Cascade、跑 shell 命令、产出结构化输出,等于给 Cascade 录制了一整套可复用 SOP。再配合一个兜底习惯:复杂 Cascade 操作前先 git commit,跑飞了直接 git revert 重来,不用在对话里反复 undo。

信息差总结:你知道的 vs 别人不知道的

维度 大多数人以为 实际信息差
记忆 Cascade 自动记,随缘 能手动"remember that"灌输,免费、可审计
记忆系统 只有一套 Memories / Rules / AGENTS.md 三套,各司其职
规则文件 一个 .windsurfrules 塞到底 .windsurf/rules/ 拆分 + 四种激活模式
AGENTS.md 没听说过 零配置、目录级、Claude Code 也认
模型 一用就烧钱 SWE-1-lite chat 永久免费,credit 只花在 agent 上
定价 比 Cursor 贵 Pro $15 是同档最便宜(Cursor $20)
跨面调试 编辑器和终端各查各的 flow awareness 三角定位,关机重开不丢状态
流程 每次手敲 Workflows/Skills 固化成斜杠命令

行动指南(今天就能做)

  1. 5 分钟立省:在项目根目录建一个 AGENTS.md,写三段——项目用途、技术栈、一两个非显然的架构决定,git commit。这是性价比最高的第一步。
  2. 手动喂一条记忆:找一句你每次都要重复解释的上下文(比如"我们用 pnpm 不用 npm"),对 Cascade 说 remember that ...,然后问 what do you know about this codebase? 验证。
  3. 拆规则文件:把旧的 .windsurfrules 拆进 .windsurf/rules/,通用规范设 always_on,测试规范设 glob,迁移手册设 manual。
  4. 省 credit 模型分层:日常问答锁死 SWE-1-lite(免费),只把 SWE-1.5/1.6 留给真正的多文件 Cascade 任务。
  5. 录一个 Workflow:把你最高频的重复流程(比如"给新函数补 vitest 测试")存成斜杠命令。
  6. 风险提示:OpenAI 收购后,Windsurf 里的 Claude / Gemini 接入有可能被边缘化。团队级选型建议先小范围 pilot 30 天再决定,别一次性全员上。

参考来源

本文由「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 等场景全覆盖。

51学通信知识星球海报-扫码加入

📎 本分类最新文章