一句话总结
从”刚装完 Windsurf”到”agent 跑出一个我敢提的多文件小 diff”，30 分钟线性路径。装 Devin Desktop（Windsurf 在 2026 年 6 月 2 日改成的名字）、登录、等索引跑完、写一份 .devin/rules/ 文件，然后跑一个范围很紧的 agent 任务，收一个干净、审过的 diff。新人最容易犯的错是开口就让它做大重构，diff 一炸就放弃——别这么干。
你上次听说 Windsurf 之后，有件事变了
Windsurf 在 2025 年 12 月被 Cognition（做 Devin 的那家）收购，2026 年 6 月 2 日编辑器改名为 Devin Desktop。还是那个基于 VS Code 的 IDE，快捷键、扩展、LSP 全保留，跟你原来的 Windsurf 配置完全向后兼容，已装的版本会自动 OTA 升级。本文有两处命名要先讲清楚：
- 桌面 app 现在装出来叫 Devin（macOS 上是
Devin.app）。老版本还显示”Windsurf”。 - 那个一直叫 Cascade 的 agent 面板，正在被 Devin Local 取代——用 Rust 从头重写，Cognition 称 token 效率高约 30%，还加了子 agent。旧版 Cascade 保留到 2026 年 7 月 1 日。本文里”Cascade / Devin Local”指的是同一个 agent。
下面所有步骤在最新的 Devin Desktop 和老的 Windsurf 安装上都能用。
核心概念
- Cascade / Devin Local：agent 模式——多步、多文件，授权时还能跑 shell 命令和测试。
- Write / Chat / agent 三角：三种交互模式。Write 是行内补全，Chat 是对话问答，agent（Cascade / Devin Local）才负责多文件改动。
- Rules：钉住的项目上下文文件，agent 当 system prompt 用。截至 2026 年 6 月，放在
.devin/rules/（首选）或AGENTS.md；旧的.windsurfrules和.windsurf/rules/仍然能加载。 - Codemaps：给代码库画的 AI 标注地图——入口、数据流、每个节点的说明。让 agent 动手前，先用它给陌生仓库定个位很有用。
这篇适合谁看
已经用过一个 AI 编程工具（Copilot、Cursor、Claude Code）、想要第二个对照——或者觉得 Cursor Composer 在计划上不够果断、想试更紧的 agent 循环。会用 VS Code 快捷键。完全没用过 AI IDE 的，先走Cursor 新手 30 分钟跑通完整工作流，知道”agent diff”长啥样再来评估 Windsurf，会轻松很多。
它要多少钱（截至 2026 年 6 月）
Windsurf/Devin Desktop 已经从旧的积分制改成每日/每周自动刷新的配额制。Pro 在 2026 年 3 月从 15 美元涨到 20 美元，跟 Cursor Pro 持平。
| 档位 | 价格（美元/月） | 包含什么 |
|---|---|---|
| Free | 0 | 轻量 agent 配额、模型有限、Tab 和行内编辑无限 |
| Pro | 20 | 满配额、前沿模型（Claude Sonnet 4.6 / Opus 4.7、GPT-5.5、Gemini 3.1 Pro）、SWE-1.6 免费、云端 agent |
| Max | 200 | Pro 全部 + 显著更高的每日/每周配额 |
| Team | 80 起 + 每席 40 | Pro 功能 + 管理后台、统一账单、优先支持 |
| Enterprise | 定制 | SSO、专属部署、客户经理 |
Cognition 自家的 SWE 系列模型（SWE-1.5、SWE-1.6 及 mini 版）不消耗配额——只有调前沿模型才扣额度。免费档够跑本文这一个首次任务。
什么时候适合用
Cursor agent 在”该不该动手”上犹豫的时候，或者你想换个新工具 A/B 一下当前流程的时候。Windsurf 在范围明确的多文件改动上特别合身：把一个模式套到 5 个文件、加一个端点带测试、跑一次机械式迁移。和 Cursor 比社区小、扩展少，和 Claude Code 比长时间 shell 终端会话弱。
开始前准备
- 本地切一份真项目——别用
hello-world。agent 的价值只在真上下文里看得出来。 main的测试和 lint 都过。Cascade 会放大仓库当前状态，包括烂的。- 一个 Devin/Windsurf 账号（免费档够第一次跑；20 美元/月的 Pro 解锁前沿模型和更大配额）。
- 提前选好一个小目标：在 3 个文件里改一个函数名、给一个模块加测试、把一个组件迁到新模式。别选”现代化整个仓库”。
具体步骤
- 下载安装并启动。 去官网下。新装的是 Devin Desktop；原来有 Windsurf 的会自动 OTA 升级。第一次启动会问要不要导入 VS Code 设置和扩展——接受，省 20 分钟。
- 登录。 用 Devin/Windsurf 账号登录（账号在厂商网站上管理）。面板没弹出来的话，开命令面板（
Cmd/Ctrl+Shift+P）搜”Sign In”。状态栏看到账号就行。 - 打开项目文件夹，等索引跑完。 状态栏看进度。索引没完不要开 agent，会引一堆不存在的文件路径。想先快速看清陌生仓库，可以先开一张 Codemap 扫一眼入口。
- 写一份 rules 文件。 仓库根建
.devin/rules/project.md（或者保留现有的.windsurfrules——两者都加载）：
# agent 项目规则
- 语言：TypeScript，strict 模式开。
- 测试命令：`pnpm test`。改完必须跑。
- Lint 命令：`pnpm lint`。lint 错没修不算完。
- 不要碰 `src/generated/`——是代码生成的。
- 优先 named export。新文件不要 default export。
- React 组件，测试同目录命名 `Component.test.tsx`。- 打开 agent 面板（右侧，或
Cmd/Ctrl+L）。选模型。截至 2026 年 6 月的合理默认：通用代码用 Claude Sonnet 4.6，快速机械活用 SWE-1.6（不扣配额），要对架构做深推理用 Claude Opus 4.7 或 GPT-5.5，懒得选就用 Adaptive 让路由器挑。打一段紧的 prompt：
计划把 src/ 里的 getUser 改名为 fetchUserProfile。
列出要动的文件和要改的测试。
先别动代码。- 看计划，把错的推回去。 拒掉超范围的文件、指出漏改的测试。然后说：
按计划执行，一次一个文件，每个文件后跑测试。 - 看着 diff 跟着改。按文件 accept 或 reject。测试都过、diff 跟计划对得上，就 commit。
一段”逼它说实话”的 prompt
存成可复用的 agent 片段（或一个 Workflow），任何非琐碎会话第一句就贴：
你在这个仓库里干活。动手前：
1. 读 .devin/rules/ 里的规则，列出和本任务相关的。
2. 列出要改的文件，每个一句话讲为什么。
3. 列出不会动的文件，并说为什么。
4. 说你要跑哪个测试命令、什么时候跑。
然后等我说"开始"。我没说之前不要写代码。
不要碰 src/generated/ 和 vendor/。
任何一步连失败两次，停下来问——不要循环。Windsurf 第一次会话的后悔，大多来自 agent 跳过了计划那一拍。逼它先出计划，是性价比最高的一个习惯。
完成后检查
- diff 和你批准的计划一致。超出的就是范围漂移——拒掉重提。
- 每个文件后测试都过，不是攒到最后才跑。agent 一次性批量改、最后才挂的话没法二分定位。
- rules 文件已经 commit，队友能继承约束。
- agent 对话里引的是真的 symbol 和文件。引到幻觉就是索引没跑完——重 index 再来。
- 模型和任务匹配：通用代码 Sonnet 4.6、架构推理 Opus 4.7 / GPT-5.5、模板活 SWE-1.6。
怎么复用这套流程
- 上面那段计划 prompt 存成 agent 片段或一个 Workflow。所有非琐碎会话第一句就贴。
- 把 rules 文件当活的记忆。agent 同一种错犯两次，就加一条禁止规则。你也可以直接让 Cascade 把一条持久规则写进
.devin/rules/。 - 列一份”必须钉住”的文件清单——核心类型、主配置、测试启动文件。可能动到它们的 prompt 开头就提到。
- 一次会话成功了，把 agent 最后的总结复制进 PR 描述。当 PR 模板基本能用。
容易踩的坑
- 索引没完就开 agent。 引一堆假路径，第一天就丢信心。
- 觉得”项目简单”就跳过 rules 文件。 哪怕 10 行也能明显拉高产出。
- “把这个模块现代化一下”。 你会拿到 40 文件 diff、没法看。给它一个具名小步。
- 把 agent 当 Cursor Composer 用。 形似，但 Windsurf 对计划提交得更狠——你的 prompt 范围要更紧。
- 每个任务都用前沿模型。 Opus 4.7、GPT-5.5 在模板活上是浪费（也慢）——换 SWE-1.6 或 Sonnet 4.6，而且 SWE-1.6 还不扣配额。
- diff 不看就全收。 再好的 agent 也会顺手改一个你不想动的文件。
FAQ
- Windsurf 还叫 Windsurf 吗？: 2026 年 6 月 2 日起编辑器正式改名 Devin Desktop（Windsurf 被 Cognition 收购）。还是同一个基于 VS Code 的 IDE，你原来的配置完全兼容；老版本升级前还显示 Windsurf 这个名字。
- Windsurf 比 Cursor 好吗？: 权衡不同。机械式多文件，Windsurf agent 循环更紧，而且调 SWE-1.6 免费；社区、扩展、rules 生态 Cursor 赢。两家 Pro 都是 20 美元/月——各试一周再决定。
- 能离线用吗？: 不能。agent 走远端模型。行内补全有一点本地启发，但 Cascade / Devin Local 必须联网。
- 能用自己的 API key 吗？: 可以，BYO-key（BYOK）设置。绕过自带配额，但要自付模型钱。
- 改着改着上一轮编辑被回滚？: agent 偶尔会重读文件、覆盖未保存内容。继续对话前先 save，或者用按文件 accept 的流程。