Skip to main content
Devin 支持将 Windows 用作构建和会话平台。默认情况下,Windows 环境与 Linux 一样使用 bash shell (Git Bash) ,因此大多数蓝图命令无需修改即可在这两个平台上运行。蓝图也可以在 PowerShell 中执行 Windows 设置步骤。
Windows 支持目前仅面向有限用户开放。如果你有兴趣试用 Devin 的 Windows 支持,请联系我们了解更多信息并获取访问权限。

工作原理

Windows 支持与 Linux 一样,基于同一套声明式配置系统。关键区别在于蓝图中的 runs-on 字段,它会告诉 Devin 在哪个平台上构建和运行。通过可选的 shell 字段,可以让 Windows 块在 Windows PowerShell (而非 Git Bash) 中执行其 run 步骤。 由于两个平台默认都使用 bash,你可以在 Linux 和 Windows 上编写相同的 shell 命令。主要区别在于文件系统结构以及可用的包管理器:

Windows 蓝图编写

单平台蓝图

如果你的代码仓库仅针对 Windows,请在顶层使用 runs-on: windows:

多平台蓝图

要同时在 Linux 和 Windows 上构建同一个代码仓库,请将每个平台分别写成独立的 YAML 文档,并用 --- 分隔。每个文档都声明自己的 runs-on 标签。有关这种格式的更多背景信息,请参阅蓝图指南中的 多文档 YAML 提示框。
每个文档都会为对应平台生成单独的快照构建。会话会从该平台专用的快照启动。
顶层 YAML 必须是映射,而不能是序列。如果把上面的示例写成单个列表 (- runs-on: default / - runs-on: windows) ,后端会拒绝,并返回 Invalid YAML: each YAML document must be a mapping, not a sequence; use '---' to separate multiple blocks。请使用上面所示的 --- 分隔符。

runs-on 字段

runs-on 字段对应于你账户中已注册的一项机器配置: 你可以将 runs-on 指定为字符串或列表:
当一个块列出多个平台时,构建系统会使用相同的命令,为每个平台创建一个快照。
列表语法会在列表中的每个平台上运行完全相同的命令。只有在命令确实支持跨平台时才应使用它 (例如 npm install、uv sync) 。对于平台专用命令 (例如 Linux 上的 apt-get 或 Windows 上的 choco) ,请改用多文档格式——每个平台对应一个文档,并使用 --- 分隔。

shell 字段

在 Windows 上,块中的 run 步骤默认在 Git Bash 中执行。如需改用原生 PowerShell cmdlet、语法和 Windows 路径来编写设置步骤,请将可选的顶层字段 shell 设置为 powershell:
该设置以块为单位生效。在多平台蓝图中,只需在 runs-on: windows 文档中设置 shell: powershell,Linux 文档即可继续使用 bash。该设置仅影响构建步骤;Windows 会话的默认 shell 仍为 Git Bash。有关可用取值、secrets 和环境变量如何传递给 PowerShell 步骤,以及错误处理方式,请参阅蓝图参考中的 shell。

用量和成本

与同等的 Linux 会话相比,Windows 会话消耗的用量 (ACU 或配额) 大约高出 9%。有关用量如何计量的详细信息,请参阅用量。

Windows 会话的行为

Shell

Windows 会话默认使用 Git Bash 作为 shell,也就是 Linux 上使用的同一种 bash shell。除非某个块设置了 shell: powershell,否则蓝图中的 run 步骤也会在 Git Bash 中执行,因此标准 bash 语法在两个平台上都通用:

路径

Git Bash 使用 POSIX 风格的路径 (/c/...,而不是 C:\...) :
而 shell: powershell 块中的步骤则使用原生 Windows 路径:

Secrets

在会话期间,可通过标准 bash 语法 ($SECRET_NAME) 以环境变量的形式使用 Secrets:

文件附件

在 Windows 上,上传的文件会保存到 /c/Users/Administrator/.files/,而不是 /home/ubuntu/.files/。

Computer Use

Computer Use 在 Windows 会话中已获全面支持。Devin 可使用带有 Chrome、鼠标和键盘访问权限的 Windows 桌面环境,因此既能测试 Web 应用,也能测试 Windows 原生桌面应用程序 (例如 WPF 和 WinForms 应用) ,并记录测试会话。

适用于 Windows 的蓝图提示

安装工具

使用 choco (Chocolatey) 或直接下载脚本:

常见模式

.NET 项目:
Visual Studio / C++ 项目: