启用 Cascade 对 .gitignore 文件的访问权限
要让 Cascade 访问与你项目.gitignore 中规则匹配的文件,请打开 Devin Settings,然后进入 Devin Local → Configuration → Gitignore access。该选项默认处于关闭状态。要授予访问权限,请点击开关将其打开。
Agent diff 区域
当 Agent 编辑文件时,Devin Desktop 会显示 diff 区域——也就是编辑器中以内联高亮方式标出的区域,能准确显示具体改动内容,并为每个变更块提供接受和拒绝控件。所有 Agent 默认都会使用 diff 区域。 你可以在 Devin Settings → Editor → User interface → Agent diff zones 中关闭非 Cascade Agent 的 diff 区域。禁用后,非 Cascade Agent 的编辑会直接应用到文件,工具栏会显示一个简单的关闭按钮,而不是接受/拒绝控件。SSH 支持
VSCode 中常见的 SSH 支持由 Microsoft 提供并授权,因此我们专门为 Devin Desktop 实现了自己的版本。它确实要求你安装 OpenSSH,但除此之外几乎没有其他依赖,基本上会像你平时用的一样“开箱即用”。你可以在 命令面板 中通过Remote-SSH 访问 SSH,也可以通过左下角的 Open a Remote Window 按钮进入。
这个扩展在我们的内部开发中一直运行良好,但目前也有一些已知注意事项和 bug:
- 我们目前只支持通过 SSH 连接到基于 Linux 的远程主机。
-
常见的 Microsoft
Remote - SSH扩展 (以及 open-remote-ssh 扩展) 无法使用——请不要安装它们,因为它们会与我们的 SSH 支持冲突。 - 我们目前还不具备 Microsoft SSH 扩展的全部功能。现在主要支持最核心的功能:连接到主机。如果你有功能需求,欢迎告诉我们!
- 通过 SSH 连接后,如需访问远程主机上的 devcontainer,请使用 命令面板 (Ctrl/Cmd+Shift+P) 并选择以下选项之一:

- SSH agent 转发默认开启,并会使用 Devin Desktop 与该主机的最新连接。如果你遇到相关问题,请尝试重新加载窗口以刷新连接。
-
在 Windows 上,当系统提示你输入密码时,你会看到一些
cmd.exe窗口。这是正常现象——我们很快就会去掉它们。 -
如果你遇到问题,请先确认你可以在终端中使用常规
ssh连接到远程主机。如果问题仍然存在,请在提交 bug 报告时附上Output > Remote SSH (Devin)选项卡中的输出!
开发容器
Devin Desktop 在 Mac、Windows 和 Linux 上均支持开发容器,适用于本地和远程 (通过 SSH) 工作流程。 前提条件:- 本地:你的机器上必须安装 Docker,并且可在 Devin Desktop 终端中访问。
- 通过 SSH 远程:使用 Devin Desktop Remote-SSH 连接到远程主机。远程主机上必须安装 Docker,并且可从远程 shell 访问。你的项目应包含
devcontainer.json或等效配置。
Dev Containers: Open Folder in Container- 使用指定的
devcontainer.json打开新的工作区。
- 使用指定的
Dev Containers: Reopen in Container- 在由你的
devcontainer.json定义的新容器中重新打开当前工作区。
- 在由你的
Dev Containers: Attach to Running Container- 附加到现有的 Docker 容器,并将当前工作区连接到该容器。如果该容器不符合开发容器规范,Devin Desktop 会尽力检测远程用户和环境。
Dev Containers: Reopen Folder Locally- 连接到开发容器时,断开连接并在本地文件系统中重新打开工作区。
Dev Containers: Show Devin Desktop Dev Containers Log- 打开 开发容器 日志输出,以便排查问题。
Open a Remote Window 按钮时也会显示这些命令 (包括你通过 SSH 连接到远程主机时) 。
相关内容:
Remote Explorer: Focus on Dev Containers (Devin Desktop) View— 快速打开 开发容器 视图。
已知限制
Devin Desktop 目前不执行 Dev Container Specification 生命周期命令:onCreateCommandupdateContentCommandpostCreateCommandpostStartCommandpostAttachCommand
devcontainer.json 中定义) 和 feature 级生命周期命令 (在 devcontainer-feature.json 中定义) 。此外,也不会安装 Dotfiles。
可正常工作的内容:
- Feature
install.sh脚本 (这些脚本会在镜像构建时运行) - Feature
mounts(卷会在容器运行时挂载) - Feature
entrypoint字段 (每次容器启动时都会执行) - 其他所有在镜像构建时执行的操作 (Dockerfile、docker-compose、features)
变通方案:使用 Feature entrypoint 进行运行时设置
如果你正在编写一个需要在容器启动时运行设置的 Dev Container Feature (例如,根据挂载卷中的内容配置文件) ,请使用该 Feature 的entrypoint 字段,而不是生命周期命令。entrypoint 会在挂载完成后于每次容器启动时执行,并且完全自包含——使用你的 Feature 的用户无需修改他们的 devcontainer.json。
在你的 devcontainer-feature.json 中,声明 entrypoint:
install.sh 中 (会在镜像构建时运行) ,编写 entrypoint 脚本:
entrypoint 脚本应完成必要的设置后正常退出。不要在末尾加上
exec "$@"——CLI 自带的 entrypoint 脚本包装器会负责将控制权交给 container 命令。脚本应尽量保持精简,因为它会在 IDE 连接前同步执行。WSL (测试版)
自 1.1.0 版本起,Devin Desktop 开始以测试版形式支持 Windows Subsystem for Linux。你必须先在 Windows 设备上完成 WSL 的设置和配置。 你可以点击左下角的Open a Remote Window 按钮,或在命令面板中的 Remote-WSL 下访问 WSL。
Extension Marketplace
默认情况下,Devin Desktop 从 Open VSX 镜像下载扩展。若要使用其他 MCP Marketplace,请打开Devin Settings,进入 Extensions 部分,然后同时更新两个 MCP Marketplace URL:
Extensions 视图顶部 MCP Marketplace 提示信息中的 here 链接同样可以打开这些设置。你也可以直接在编辑器的
settings.json 中配置上述设置 ID。更改任一值后,请重启 Devin Desktop 以启用新的 MCP Marketplace。
Devin Desktop 插件
Devin Pyright
Devin Pyright
在扩展搜索栏中搜索 “Devin Pyright”,或粘贴
@id:codeium.windsurfPyright。
