> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Devin Desktop 常见问题解答

> 关于从 Windsurf 过渡到 Devin Desktop 的常见问题解答。

自 2026 年 6 月 2 日起，Windsurf 将更名为 Devin Desktop。本 FAQ 介绍了哪些内容会发生变化、哪些不会，以及这对你的团队意味着什么。

<div id="what-is-devin-desktop">
  ## 什么是 Devin Desktop？
</div>

Devin Desktop 是 Windsurf 的新名称。它仍然是同一个 IDE、同一个编辑器，功能也完全相同，只是**统一到了 Devin 品牌下**。如果你一直在使用 Windsurf 2.0，其实你已经在使用未来的 Devin Desktop 了。

Agent Command Center (Spaces、Kanban 视图、多 Agent 管理) 现在被放在了更突出的位置。经典的 Windsurf 体验 (编辑器、扩展、快捷键绑定、工作流程、LSPs) 依然保留，并且完全可用。不会移除任何内容。

<div id="when-is-this-happening">
  ## 这会在什么时候发生？
</div>

2026 年 6 月 2 日。Devin Desktop 将通过常规的 OTA 更新推送。你会提前收到体验即将变化的通知。

<div id="whats-changing">
  ## 有哪些变化？
</div>

Windsurf 将升级为 Devin Desktop，Agent Command Center 会成为主视图。完整的 Windsurf IDE 仍然可用，保留了你熟悉且喜爱的所有功能——你现有的工作和进度也都会原封不动地保留下来。正在进行的工作不会受到任何影响，简单上手后，你很快就会对这个界面感到熟悉。

<div id="why-is-this-happening">
  ## 为什么会这样？
</div>

我们正将所有产品统一到 Devin 品牌下：Devin Cloud、Devin Desktop、Devin CLI 和 Devin Review。我们相信，软件工程的未来在于管理与你并肩协作的 Agent 团队 (包括本地和云端) 。Devin Desktop 正是这一体系的指挥中心，我们预计开发者 90% 以上的时间都会在这里度过。

<div id="does-my-plan-or-pricing-change">
  ## 我的套餐或定价会变化吗？
</div>

不会。你当前的套餐会继续照常生效。定价不变。这适用于所有套餐类型，包括旧版 Windsurf Enterprise 套餐。

<div id="how-do-i-get-devin-desktop-on-the-teams-plan">
  ## 如何在 Teams 套餐中获取 Devin Desktop？
</div>

Devin Desktop 面向拥有全功能席位的用户开放。在 Teams 套餐中，添加一个全功能席位，即可解锁 Devin Desktop 以及每月 40 美元的用量，该用量可通用于所有 Devin 产品 (Devin Cloud、Devin Desktop、Devin CLI 和 Devin Review) 。

<div id="do-i-need-to-use-devin-to-use-devin-desktop">
  ## 使用 Devin Desktop 还需要使用 Devin 吗？
</div>

不需要——你可以继续将 Devin Desktop 与仅在本地运行的 Agent 一起使用。

<div id="do-i-need-to-upgrade-to-the-cognition-platform-plan-or-switch-my-billing-to-acus">
  ## 我需要升级到 Cognition Platform 套餐，还是将计费切换为 ACU？
</div>

不需要。Devin Desktop 开箱即用，适用于所有现有的 Windsurf 用户，包括原有的 Enterprise 客户。Devin Cloud 仍然是单独的 SKU。如果你对 Devin Cloud 感兴趣，请联系你的客户负责人。

<div id="what-happens-to-my-settings-and-configuration">
  ## 我的设置和配置会怎样？
</div>

你的所有 Windsurf 设置都会自动迁移到 Devin Desktop。Devin Local 也会继承你的 Windsurf 设置。如果你使用的是旧版 Windsurf 套餐，仍然可以通过 windsurf.com 管理你的设置。

<div id="will-i-lose-access-to-anything">
  ## 我会失去任何内容的访问权限吗？
</div>

不会。Windsurf IDE、你的扩展、你的工作流程以及其他所有内容都还在。你的套餐、定价和访问权限保持不变。变化的只有名称和品牌标识。

有关新的 [Devin Local](/zh/desktop/devin-local) Agent 如何处理记忆、工作流程等功能的详细信息，请参阅其[限制](/zh/desktop/devin-local#limitations)。

<div id="are-my-windsurf-rules-still-supported-what-about-devin-rules">
  ## 我现有的 Windsurf 规则还受支持吗？Devin 规则呢？
</div>

是的。Devin Desktop 会继续读取你现有的所有 Windsurf 规则，并新增对新的 `.devin/` 对应格式的支持。你当前已有的内容都不需要改动。

这两种规则格式可以并行使用：

* \*\*单文件规则：\*\*工作区根目录中的旧版 `.windsurfrules` 文件仍会被读取。 (没有对应的单文件 `.devinrules` 格式——新规则请使用下面的目录格式。)
* **目录规则：**位于 `rules/` 目录下的各个 `.md` 规则文件。首选位置是 `.devin/rules/`，并且**优先级更高**；`.windsurf/rules/` 则作为向后兼容的回退选项保留。

此外，Devin Desktop 还会读取 `AGENTS.md` / `agents.md` 文件中的规则，并可将 `.cursor/rules` (`.mdc`) 导入到 `.devin/rules/` 中。基于目录的规则支持在其 frontmatter 中设置激活触发条件 (始终生效、模型决策、基于 glob 和手动) ，因此规则可以应用于每个请求、仅在模型判断其相关时应用、仅对匹配 glob 的文件应用，或仅在手动调用时应用。

Enterprise admins 还可以在整个系统范围内部署规则；请参阅下方的 [系统级配置](#system-level-configuration-admin-managed-per-machine)。

<div id="what-is-devin-local">
  ## 什么是 Devin Local？
</div>

[Devin Local](/zh/desktop/devin-local) 是 Devin Desktop 中推出的一种新本地 Agent。它比 Cascade 更高效，支持子 Agent，并采用与 Devin CLI 相同的架构。Devin Local 会沿用你现有的 Windsurf 设置。

<div id="what-happens-to-cascade">
  ## Cascade 会发生什么变化？
</div>

本地 Agent 也将统一纳入 Devin 品牌，并更名为 [Devin Local](/zh/desktop/devin-local)。它配备了改进的 harness、最高可提升 30% 的令牌效率、子 Agent 支持以及沙盒化能力。现有的 Cascade Agent 在整个 7 月期间仍可使用。

Enterprise 客户应与其账户团队合作，完成向 Devin Local 的过渡。

<div id="will-my-pricing-change-when-switching-to-devin-local">
  ## 切换到 Devin Local 后，我的定价会变吗？
</div>

不会。Windsurf 中的 Devin Local 或 Devin Desktop 采用与 Cascade 完全相同的定价模式：如果你目前使用的是基于提示的积分，切换后仍将继续沿用该模式。

<div id="what-about-windsurf-jetbrains">
  ## 那 Windsurf JetBrains 呢？
</div>

Windsurf JetBrains 插件不受此次变更影响，仍会按预期正常运行 (名称也会保持不变) 。

<div id="what-happened-to-the-surf-command-how-do-i-open-a-file-from-the-terminal">
  ## `surf` 命令发生了什么变化？如何从终端打开文件？
</div>

`surt` shell 命令已由 `devin-desktop` 命令替代。要安装它，请在 Devin Desktop 中打开命令面板，然后运行 **Shell Command: Install 'devin-desktop' command in PATH**。之后，你就可以像以前使用 `surf` 一样，从终端打开文件或文件夹：

```bash theme={null}
devin-desktop path/to/file
devin-desktop .
```

为保持向后兼容，旧版 `surf` (以及 `windsurf`) 命令仍会安装在 `~/.codeium/windsurf/bin/` 中。如果你有依赖 `surf` 的脚本，或者已经习惯使用 `surf`，可以通过将它设为新命令的别名来继续使用：

```bash theme={null}
alias surf="devin-desktop"
```

<div id="what-happens-with-previous-windsurf-releases">
  ## 之前的 Windsurf 版本会如何处理？
</div>

一般来说，除最新版本外，我们都将其他版本视为已弃用，不过我们会尽力保持兼容性，避免影响旧版本。这与 Microsoft 的 VSCode 采用的是相同的模式。你仍然可以继续下载之前的 Windsurf 版本，但我们并不建议这样做。

<div id="can-our-admins-test-this-before-the-rollout">
  ## 我们的管理员可以在 rollout 之前进行测试吗？
</div>

可以。我们很乐意在 6 月 2 日前一周将早期 build 提供给你们的管理员，以便他们在 org-wide rollout 之前，提前在你们的环境中验证这项变更。请联系你的账户团队进行协调。

<div id="will-we-need-to-update-our-network-allowlist">
  ## 我们是否需要更新网络允许列表？
</div>

无需进行任何网络变更。

对于通过 devinenterprise.com 登录的 **Cognition Platform** 用户，所有身份验证和设置都将在 Devin 网站上统一管理。

对于 **Legacy Windsurf Enterprises**，原则上无需做任何更改。更新和二进制文件仍将存储在 [`codeiumdata.com`](http://codeiumdata.com)，登录也仍将在 `windsurf.com/enterprise` 上进行。唯一的变化是，**面向用户的网站内容** (变更日志和文档) 将迁移到 Devin 子域名 (`docs.devin.ai`) 。如果你希望你的团队继续访问变更日志和文档，请将 `docs.devin.ai` 或 [`docs.devinenterprise.com`](http://docs.devinenterprise.com) 添加到你的允许列表中 (如果你使用通配符规则，则添加 `.devin.ai` / `.devinenterprise.com`) 。

<div id="what-is-the-full-list-of-hostnames-we-should-allow">
  ## 我们应允许哪些 hostname？完整列表是什么？
</div>

上线前无需更改白名单。

如果你希望提前将相关域名加入白名单，以下是相关 hostname：

**对于所有客户，Devin Desktop 需要以下域名 (后端域名) ：**

* `.codeiumdata.com`
* `update.windsurf.com`
* `.windsurf.com`
* `.codeium.com`
* `.googleapis.com` (身份验证)
* `apis.google.com` (身份验证)
* `static.devin.ai`

**Cognition Platform 客户还需要以下域名 (后端域名) ：**

* `app.devin.ai` (webapp、session URL 和资源下载)
* `api.devin.ai` (API 后端和 ACP 实时 WebSocket)

如果你使用通配符规则，`.devin.ai` 可同时涵盖这两者。使用 `devinenterprise.com` 域名的 Cognition Platform 客户应将对应的主机名 (或 `.devinenterprise.com`) 加入白名单。

**用户可访问的域名 (变更日志、文档和支持) ：**

* `docs.devin.ai` 或 `docs.devinenterprise.com` (2026 年 6 月 2 日后用于访问变更日志和文档)
* `decagon.ai` (支持)

<div id="what-hostnames-does-the-desktop-application-use-for-automatic-updates">
  ## 桌面应用程序自动更新会使用哪些主机名？
</div>

桌面应用程序会自动检查并下载 OTA (空中更新) 更新。更新系统使用两类请求：

1. \*\*更新检查 API：\*\*应用程序会定期联系更新服务器，查看是否有新版本可用。
   1. **部分用户会禁用此功能**
2. \*\*二进制下载：\*\*发现更新后，应用程序会从 CDN 下载新的安装程序或压缩包。

以下相关主机名由**所有客户**使用 (包括 Legacy Windsurf 和 Cognition Platform) ：

* `update.windsurf.com` — 更新检查 API
* `windsurf-stable.codeiumdata.com` — stable 和 next 通道的二进制下载

如果你的防火墙或代理规则基于域名，请确保这些主机名可通过 443 端口 (HTTPS) 访问。阻止它们将导致应用程序无法检测或安装更新。

<div id="what-hostnames-are-used-for-remote-development-ssh-dev-containers">
  ## 远程开发 (SSH、Dev Containers) 会使用哪些主机名？
</div>

通过 SSH 或 Dev Containers 连接到远程机器时，桌面应用会将 Remote Extension Host (REH) 和 CLI 二进制文件下载到远程机器。**所有客户** (包括 Legacy Windsurf 和 Cognition Platform) 都需要使用以下主机名：

* `windsurf-stable.codeiumdata.com` — REH 和 CLI 归档包 (stable/next 通道)
* `windsurf-nightly.codeiumdata.com` — REH 和 CLI 归档包 (insiders 通道)

远程机器必须能够通过 443 端口访问这些主机名。如果你的远程服务器位于企业代理之后，或处于隔离网络中，请确保这些域名可访问，或者手动预先部署 REH 软件包。

<div id="will-the-app-name-change-affect-our-device-management-mdm-policies">
  ## 应用名称变更会影响我们的设备管理 (MDM) 策略吗？
</div>

会——这是 IT 和端点安全团队最需要关注的一项。桌面应用名称将从 **Windsurf** 更改为 **Devin** (在 macOS 上显示为 `Devin.app`，在 Windows 上显示为 `Devin.exe`，在 Linux 上显示为 `Devin` / `devin`) 。许多组织会使用集中式设备管理 (MDM / 端点管理) 策略，标记或阻止任何未经明确批准的应用，因此，如果某项策略目前只允许“Windsurf”，那么在 6 月 2 日更新后，更名后的应用可能会被标记或阻止。

**需要操作：** 请在 2026 年 6 月 2 日之前，将 **Devin** 添加到你的设备管理 / 端点管理策略允许列表中，并与你的端点安全团队确认更名后的应用已获批准。请务必确保这条信息传达给实际负责这些策略的团队——在许多企业中，这个团队与负责 IDE rollout 的团队是分开的。

<div id="what-local-file-paths-does-the-application-read-from-and-write-to">
  ## 应用程序会读取和写入哪些本地文件路径？
</div>

在过渡期间，Devin Desktop 会同时从 legacy (Windsurf/Codeium) 路径和新 (Devin) 路径读取数据，并将新数据写入 Devin 路径。负责管理端点策略、文件完整性监控或数据防泄漏规则的 Enterprise admins 应注意以下目录。

Devin Desktop 首次运行时，会将 legacy 路径中的所有数据复制到新路径中。

<div id="per-user-ide-data-settings-extensions-workspaces">
  ### 用户级 IDE 数据 (设置、扩展、工作区)
</div>

这是从 VS Code 派生而来的用户数据目录。如果新路径存在，我们会从该路径读取：

| 操作系统    | 旧版路径 (读取)                                 | 新路径 (读取 + 写入)                          |
| ------- | ----------------------------------------- | -------------------------------------- |
| macOS   | `~/Library/Application Support/Windsurf/` | `~/Library/Application Support/Devin/` |
| Windows | `%APPDATA%\Windsurf\`                     | `%APPDATA%\Devin\`                     |
| Linux   | `~/.config/Windsurf/`                     | `~/.config/Devin/`                     |

包含：`User/settings.json`、`User/keybindings.json`、`User/snippets/`、`globalStorage/`、`Workspaces/`、`argv.json`

<div id="per-user-extensions-directory">
  ### 用户级扩展目录
</div>

扩展存储在根据产品名称生成的隐藏文件夹中。旧版路径将继续保持只读：

| 旧版路径 (读取)                 | 新路径 (读取 + 写入)          |
| ------------------------- | ---------------------- |
| `~/.windsurf/extensions/` | `~/.devin/extensions/` |

<div id="per-user-configuration-directory">
  ### 用户级配置目录
</div>

主要的用户级配置目录用于存储用户设置、MCP 配置、全局技能和工作流程：

| 目的        | 路径                                      |
| --------- | --------------------------------------- |
| 用户设置      | `~/.codeium/user_settings.pb`           |
| MCP 配置    | `~/.codeium/mcp_config.json`            |
| 全局工作流程    | `~/.codeium/windsurf/global_workflows/` |
| 全局技能      | `~/.codeium/windsurf/skills/`           |
| CLI 二进制文件 | `~/.codeium/windsurf/bin/`              |

<Note>此版本不会更改 `~/.codeium/` 的目录结构。这些路径保持不变。</Note>

<div id="system-level-configuration-admin-managed-per-machine">
  ### 系统级配置 (由管理员管理，按机器分别设置)
</div>

Enterprise admins可以在以下目录中部署系统范围内的规则、工作流程和技能：

| OS      | 旧版路径 (读取)                                | 新路径 (读取 + 写入)                         |
| ------- | ---------------------------------------- | ------------------------------------- |
| macOS   | `/Library/Application Support/Windsurf/` | `/Library/Application Support/Devin/` |
| Windows | `C:\ProgramData\Windsurf\`               | `C:\ProgramData\Devin\`               |
| Linux   | `/etc/windsurf/`                         | `/etc/devin/`                         |

包含以下子目录：`rules/`、`workflows/`、`skills/`

<div id="cli-shell-command-binaries">
  ### CLI / Shell 命令可执行文件
</div>

| 操作系统          | 路径                          | 可执行文件名称                                      |
| ------------- | --------------------------- | -------------------------------------------- |
| macOS / Linux | `~/.codeium/windsurf/bin/`  | `devin-desktop`、`surf` (旧版) 、`windsurf` (旧版) |
| macOS / Linux | `~/.local/bin/`             | `devin`                                      |
| Windows       | `%LOCALAPPDATA%\devin\bin\` | `devin.exe`                                  |

<div id="workspace-level-directories-inside-repositories">
  ### 工作区级目录 (位于代码仓库内)
</div>

该应用已支持将 `.devin/` 作为主要工作区目录，并会出于向后兼容而回退到 `.windsurf/`。对于这些目录，无需管理员采取任何操作：

| 旧版 (读取、回退)                           | 新版 (读取 + 写入，首选)                            | 内容             |
| ------------------------------------ | ------------------------------------------ | -------------- |
| `.windsurfrules` (根目录文件)             | `.devin/rules/` (目录)                       | 项目规则 (旧版单文件格式) |
| `.windsurf/rules/`                   | `.devin/rules/`                            | 项目规则           |
| `.windsurf/workflows/`               | `.devin/workflows/`                        | 工作流程           |
| `.windsurf/skills/`                  | `.devin/skills/`                           | 技能             |
| `.windsurf/plans/`                   | `.devin/plans/`                            | Plans          |
| `.codeiumignore` / `.windsurfignore` | `.codeiumignore` (不变)  / `.windsurfignore` | 忽略规则           |

<div id="what-should-endpoint-security-dlp-policies-allow">
  ## 端点安全 / DLP 策略应放行哪些内容？
</div>

如果你的组织使用端点安全工具来限制应用程序可读取或写入的目录，请确保为 Devin Desktop 应用放行以下路径：

* **macOS:** `~/Library/Application Support/Devin/`, `~/.devin/`, `~/.codeium/`, `~/.windsurf/`, `~/.local/bin/devin`
* **Windows:** `%APPDATA%\Devin\`, `%LOCALAPPDATA%\devin\`, `~\.codeium\`, `~\.windsurf\`
* **Linux:** `~/.config/Devin/`, `~/.devin/`, `~/.codeium/`, `~/.windsurf/`, `/etc/devin/`, `~/.local/bin/devin`

该应用还会使用系统临时目录 (`$TMPDIR` / `%TEMP%`) 存储临时数据。

<div id="what-hostnames-does-devin-cli-use-for-updates">
  ## Devin CLI 更新使用哪些主机名？
</div>

Devin CLI 有自己独立的更新机制，与桌面应用分开。此变更不会对 Devin CLI 造成任何影响。

<div id="i-have-more-questions-who-should-i-contact">
  ## 我还有其他问题。该联系谁？
</div>

请联系你的客户团队或客户支持。