Devin Desktop安装、使用方法详细全解

Devin Desktop 安装、使用方法详细全解

数据来源：官方文档 (docs.devin.ai)、windsurf.com 官方定价页、Verdent Guides、DataCamp、DEV Community 等

一、重要通知：品牌变更

Windsurf 已正式重新品牌化为 Devin Desktop。 Codeium 公司（现 Cognition AI）将 Windsurf IDE 更名为 Devin Desktop。以下变化：

• 官方域名从 windsurf.com 迁移至 devin.ai
• 官方文档从 docs.windsurf.com 重定向至 docs.devin.ai
• IDE 应用名称从 “Windsurf” 变为 “Devin Desktop”
• 但核心功能（Cascade 智能体、Tab 自动补全等）保持不变
• JetBrains/VS Code 插件仍称为 “Windsurf Plugins”

本文章同时使用 “Windsurf” 和 “Devin Desktop” 两个名称指代同一产品。

二、项目概述

核心理念：Devin Desktop不是"IDE + AI 助手"的拼凑，而是从底层设计的 AI 原生 IDE。AI 不是附加功能，而是编辑器的核心。Cascade 智能体具有深度代码库理解能力，可自主执行多文件编辑、代码推理、重构和终端命令。

三、核心功能特性

3.1 Cascade — AI 智能体

Cascade 是 Windsurf 的核心 AI 助手，支持 Code 和 Chat 两种模式：

打开方式：

• 快捷键 Cmd/Ctrl+L（macOS / Windows/Linux）
• 点击编辑器右上角 Cascade 图标
• 编辑器或终端中选中的文本会自动包含在 Cascade 上下文中

Code 模式：专注于代码生成和编辑，可自主执行多文件修改、运行测试、调用工具
Chat 模式：专注于对话和解释，适合问答、代码审查、架构讨论

关键能力：

• 工具调用（Tool Calling）：Cascade 可调用文件读写、终端命令、搜索等工具。输入 /continue 或使用 “Auto-Continue” 按钮让智能体继续执行
• 多文件编辑：一次性修改多个文件，理解跨文件依赖
• 实时感知（Real-time awareness）：自动感知当前编辑器状态、选中的代码、打开的文件
• 命名检查点与回滚：在关键步骤设置检查点，可随时回滚到之前状态
• 语音输入：支持语音输入指令
• Linter 集成：自动检测 lint 错误，可一键 “Auto-fix” 或 disable
• 问题发送到 Cascade：右键错误信息 → “Send to Cascade” 或 “Explain and Fix”
• 同时运行多个 Cascade：支持同时打开多个 Cascade 会话
• 分享对话：通过 “Share Conversation” 分享 Cascade 对话链接
• @ 引用历史对话：使用 @-mention 引用之前的 Cascade 对话

3.2 Tab 自动补全

• 打字时的行内代码建议（类似 GitHub Copilot Tab）
• 所有计划（包括免费）均为无限制
• 不消耗任何配额
• 按 Tab 键接受建议

3.3 Command 模式（行内编辑）

• 快捷键 Cmd/Ctrl+I
• 直接在编辑器中启动 AI 行内编辑
• 选中文本后使用，可对选中的代码进行 AI 编辑
• 无限制使用（Pro 及以上）

3.4 Code Lenses

• 代码上方的智能操作提示
• 一键生成测试、解释代码、创建文档等

3.5 增强的终端（Terminal）

• AI 集成的终端体验
• 可在终端中与 Cascade 交互
• 终端输出自动包含在 AI 上下文中

3.6 浏览器预览（Browser Previews）

• 在 IDE 内直接预览 Web 应用
• 支持实时预览开发中的前端项目

3.7 AI Commit Messages

• 自动生成 Git 提交信息
• 基于实际代码变更生成有意义的 commit message

3.8 DeepWiki

• 自动为项目生成文档/wiki
• AI 理解代码库结构并生成技术文档

3.9 Codemaps

• 代码库的可视化地图
• 直观展示项目结构和文件关系

3.10 Vibe and Replace

• 选择代码区域后，用自然语言描述替换需求
• AI 自动生成替换代码

3.11 上下文感知（Context Awareness）

• 代码库索引：自动索引整个项目代码库
• @ 提及语法：在 Cascade 中使用 @ 引用文件、文件夹、符号
• 代码库理解：Cascade 自动理解项目结构、依赖关系和代码模式

3.12 Memories & Rules（记忆与规则）

• Memories：持久化的 AI 记忆，记住你的偏好和项目习惯
• Rules：项目级别的规则文件，自定义 AI 行为
• 支持全局规则和项目特定规则

3.13 AGENTS.md

• 项目根目录的 AGENTS.md 文件
• 定义项目的 AI agent 行为准则和开发规范
• Cascade 会自动读取并遵循这些规则

3.14 Workflows（工作流）

• 自动化重复的开发轨迹
• 定义可复用的 AI 工作流模板
• 适合标准化的开发任务

3.15 MCP 集成（Model Context Protocol）

• 支持连接 MCP 服务器扩展 AI 能力
• 可连接数据库、API、外部工具等
• 配置在 Settings 中通过 mcpServers 添加

3.16 App Deploys（应用部署）

• 一键部署应用
• 集成主流云平台部署

3.17 Web 和 Docs 搜索

• Cascade 可搜索网络和文档
• 帮助查找 API 文档、示例代码和解决方案

3.18 Skills（技能）

• 预设的 AI 技能包
• 针对特定任务类型优化 AI 行为

3.19 Arena Mode（竞技场模式）

• 多模型竞赛模式
• 同时让多个模型处理同一任务，比较结果

3.20 Worktrees（工作树）

• Git worktree 集成
• 在多个分支间快速切换和并行开发

3.21 Adaptive（自适应）

• AI 根据你的编码风格和偏好自适应
• 越用越贴合个人需求

3.22 Quick Review（快速审查）

• 一键 AI 代码审查
• 快速发现潜在问题和改进建议

3.23 Cascade Hooks

• 自定义 Cascade 行为钩子
• 在特定事件触发时执行自定义操作

四、安装步骤

4.1 系统要求

4.2 下载安装

步骤 1：下载

访问 https://windsurf.com/editor 或 https://devin.ai ，选择对应平台下载：

• Mac：DMG 安装包
• Windows：EXE 安装程序
• Linux：AppImage / DEB 包

步骤 2：运行安装程序

• Windows：双击运行 .exe 安装程序，按提示完成安装
• Mac：双击 .dmg，将应用拖入 Applications 文件夹
• Linux：解压 AppImage 并赋予执行权限，或直接安装 .deb 包

步骤 3：首次启动 — 选择设置流程

启动后看到三个选项：

建议：如果正在使用 VS Code 或 Cursor，选择对应导入选项可以保留你的开发习惯。

步骤 4：选择编辑器主题

选择你偏好的编辑器颜色主题（亮色/暗色等）。

步骤 5：注册 / 登录

• 使用邮箱注册免费账户
• 支持 OAuth 登录
• 如果自动登录遇到问题，选择 “Having Trouble?”，手动输入验证代码

步骤 6：开始使用

安装完成！现在可以：

• 使用 Cmd/Ctrl+Shift+P 打开命令面板
• 使用 Cmd/Ctrl+L 打开 Cascade
• 使用 Cmd/Ctrl+I 打开 Command 模式

4.3 导入 VS Code 配置（补操作）

如果首次启动忘记导入：

4.4 扩展管理

• 兼容 VS Code 扩展市场
• 部分扩展可能存在兼容性问题
• 推荐使用官方 “Recommended Extensions” 列表中的扩展

4.5 更新

• 点击 Profile 图标下拉菜单 → “Check for Updates”
• 或 Cmd/Ctrl+Shift+P → “Check for Updates”

4.6 卸载

4.7 自定义图标（Beta）

支持自定义应用图标，可在设置中调整。

4.8 Next 版本

提供 “Devin Desktop Next” 预览版本，可通过官网下载体验最新功能。

五、使用方法详解

5.1 键盘快捷键

5.2 Cascade 使用流程

基本交互：

高级技巧：

Cascade Code 模式：

• 专注代码生成和修改
• 可自动执行文件读写、终端命令
• 适合功能开发、重构、bug 修复

Cascade Chat 模式：

• 专注对话和讨论
• 适合代码审查、架构讨论、学习新库

5.3 Command 模式（行内编辑）

5.4 @ 引用语法

在 Cascade 中可以使用 @ 引用：

• @文件名 — 引用特定文件
• @文件夹 — 引用整个文件夹
• @符号 — 引用代码符号（函数、类等）
• @之前的对话 — 引用历史 Cascade 对话
• @终端输出 — 引用终端输出

5.5 上下文管理

上下文来源：

• 当前打开的文件
• 选中的代码
• 终端输出
• 代码库索引（自动）
• @ 引用
• .codeiumignore 排除的文件

.codeiumignore：

• 在项目根目录创建 .codeiumignore 文件
• 语法类似 .gitignore
• 排除不需要 AI 索引的文件和目录
• 也可设置全局 .codeiumignore（位于 ~/.codeium/ 目录下）

5.6 项目规则配置

AGENTS.md：
在项目根目录创建 AGENTS.md 文件，定义：

• 编码风格和规范
• 测试要求
• 项目特定约定
• AI 应该遵循的规则

Cascade 会自动读取并遵循这些规则。

5.7 模型选择

可用模型：

选择建议：

• 日常开发：SWE-1 或 SWE-1.5（性价比最高）
• 轻量任务：SWE-1-mini（最省配额）
• 复杂推理：Claude Sonnet 4.6 或 GPT-5（消耗更多配额）
• 配额紧张时：使用免费模型（体验降级但可用）

注意：第三方模型按 token 计费，在大型代码库上的单次对话可能消耗 8%+ 的每周配额。SWE-1 系列按固定费率/消息计费，更可预测。

5.8 MCP 服务器配置

在 Settings 中添加 MCP 服务器：

{
"mcpServers": {
"your-server-name": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-xxx"],
"env": {
"API_KEY": "your-api-key"
}
}
}
}

配置后，Cascade 自动获得连接数据库、API 等外部工具的能力。

5.9 高级配置

• SSH 支持：支持 SSH 远程开发
• Dev Containers：支持开发容器
• WSL：支持 Windows Subsystem for Linux
• 扩展市场设置：可自定义扩展来源
• Diff Zones：自定义代码差异显示区域
• Gitignore 访问：Cascade 可访问 .gitignore
• 代理配置：支持自定义代理设置
• 自定义图标：支持自定义应用图标（Beta）

六、定价与计划

2026年3月起，Windsurf 从"积分制"改为"配额制"。以下是最新定价。

6.1 计划总览

6.2 配额机制详解

核心变化：配额 ≠ 积分

• 旧系统（2026年3月前）：月度积分池（如 500 credits），可随时花光
• 新系统：日配额 + 周配额，刷新机制限制集中使用

你不能在一天内花光整月配额——每日/每周刷新上限控制了你可以在任何时间窗口内的使用量。

Tab 补全：永远免费，不消耗配额
Cascade：使用高级模型的消息消耗配额（按消息计费，非按动作）
失败操作：不消耗配额（如文件未保存导致写入失败）

6.3 各计划详解

Free（免费版）：

• 轻量配额，支持体验 Cascade
• 用完配额后可降级到免费模型
• 预算 3-5 次有意义的 Cascade 会话
• 适合评估工具

Pro（$20/月）：

• 标准配额 + 日/周刷新
• 所有高级模型（SWE-1、SWE-1.5、Claude Sonnet 4.6、GPT-5、Gemini 3.1 Pro）
• 无限 Tab 补全 + 无限 Command 行内编辑
• 超额使用按 API 价格计费
• 学生优惠：50%+ 折扣（需 .edu 邮箱），约 $7-8/月
• 新用户 2 周免费试用

Max（$200/月）：

• 大量配额，适合重度使用
• 适合每天数小时 Cascade、使用前沿模型、大型代码库
• 定位对标 Cursor Ultra ($200/月)

Teams（$40/用户/月）：

• 每用户独立配额
• 集中计费 + 管理分析 + 优先支持
• 额外购买配额可团队共享
• 最多 200 个席位
• 访问控制（Access Control）为附加功能（+$10/用户/月）

Enterprise（$60/用户/月）：

• 每用户配额为 Teams 的两倍
• RBAC + SSO + SCIM（包含在内）
• 更长的模型上下文窗口
• 最高优先级支持
• 混合部署（即将推出）

6.4 超额与附加

• 附加配额：$10 = 250 单位（Pro），$40 = 1,000 共享单位（Teams/Enterprise）
• 不过期：附加配额不随账单周期过期
• 自动充值：设置阈值（约剩 15 credits 时触发）和月度上限（Pro 默认 $50，Teams 默认 $160）
• 取消订阅后附加配额冻结（不消失，但需重新订阅才能使用）

6.5 竞品对比

关键变化：Windsurf 此前 $15 Pro 的价格优势已消失，现在与 Cursor Pro 同价。Windsurf 的核心优势是 SWE-1 原生的代码库理解和 Cascade 智能体架构。

七、典型应用场景

7.1 新功能开发

• 打开 Cascade，描述功能需求
• AI 自动生成多文件代码
• 自动运行测试验证
• 设置检查点，分阶段提交

7.2 代码重构

• 选中要重构的代码区域
• Cascade 分析依赖关系
• 安全重构，自动更新相关引用
• 回滚检查点恢复

7.3 Bug 修复

• 右键错误信息 → “Send to Cascade”
• AI 分析问题根因
• 自动生成修复代码
• 运行测试确认

7.4 代码审查

• 使用 “Quick Review” 快速审查
• AI 识别潜在问题、代码异味、安全漏洞
• 提供改进建议

7.5 文档生成

• 使用 DeepWiki 自动生成项目文档
• 使用 Command 模式为函数添加文档字符串
• AI Commit Messages 自动生成提交信息

7.6 快速原型

• 自然语言描述应用需求
• Cascade 生成完整项目骨架
• 浏览器预览实时查看
• 迭代优化

八、安全性与隐私

• 代码不用于训练：Windsurf 明确表示用户代码不会用于训练其模型
• Enterprise SSO/SCIM：企业级身份验证和访问控制
• RBAC：基于角色的访问控制（Enterprise）
• 混合部署：受监管行业可混合部署（即将推出）
• 代码索引本地进行：代码库索引在本地执行
• 访问控制：可配置哪些数据可被 AI 访问

九、常见问题 FAQ

Q: Windsurf 和 Devin Desktop 是同一个产品吗？

A: 是的。Codeium/Windsurf 已重新品牌化为 Devin Desktop，功能完全一致。

Q: 免费版的 Cascade 能用吗？

A: 可以，但有配额限制。用完免费配额后可降级到免费模型（体验降级）。

Q: Tab 补全消耗配额吗？

A: 不消耗。所有计划的 Tab 补全都是无限制的。

Q: Pro 计划够用吗？

A: 取决于你使用的模型。SWE-1/SWE-1-mini 通常足够日常使用；Claude Sonnet 4.6 等前沿模型消耗更快，单次重度会话可能消耗 8%+ 周配额。

Q: 有学生优惠吗？

A: 有。使用 .edu 邮箱可获 50%+ 折扣，约 $7-8/月。

Q: 兼容哪些 VS Code 扩展？

A: 大多数 VS Code 扩展兼容，但部分扩展可能存在兼容性问题。建议使用官方推荐扩展列表。

Q: SWE-1 和第三方模型有什么区别？

A: SWE-1 是 Windsurf 自有模型，按固定费率/消息计费，成本更可预测；第三方模型按 token 计费，在大型代码库上更贵。

Q: 附加配额会过期吗？

A: 不会。附加配额不随账单周期过期，可累积使用。

十、学习资源

十一、总结与建议

优势

• AI 原生设计：不是"IDE + AI"的拼凑，AI 深度融入编辑器
• Cascade 智能体：强大的多文件编辑和自主执行能力
• SWE-1 系列模型：原生模型，代码理解能力强，成本可预测
• 免费计划实用：Tab 补全无限制，Cascade 可体验
• 学生优惠：大幅折扣，适合学生开发者
• VS Code 生态兼容：兼容 VS Code 扩展市场
• 多模型支持：可选择自有模型或前沿第三方模型
• MCP 集成：可扩展连接外部工具
• 检查点和回滚：安全的 AI 代码修改

劣势

• 品牌频繁变更：从 Codeium → Windsurf → Devin Desktop，用户需适应
• 配额限制：新的日/周配额机制不如旧积分系统灵活
• 价格优势消失：$20 Pro 与 Cursor 同价，差异化竞争力下降
• 生态成熟度：与 Cursor 相比，社区和生态仍在成长
• 独立 IDE：不是 VS Code 插件，需单独安装

推荐人群

• 适合：寻求 AI 原生 IDE 体验的开发者、想从传统 IDE 升级的团队、学生开发者
• 观望：深度依赖 VS Code/JetBrains 插件生态、已深度使用 Cursor 的开发者
• 不适合：仅需简单代码补全的轻度用户（GitHub Copilot $10/月可能更划算）

入门建议