Warp Drive 工作流

工作流是参数化的命令，你可以在 Warp Drive 中命名、保存和共享它们。定义带有默认值的参数，添加用于搜索的描述，并从命令面板或 Warp Drive 执行工作流，无需重新输入即可运行常用命令。

什么是工作流？

工作流是一个参数化的命令，你可以在 Warp 中为其命名并保存，同时添加描述和参数。工作流是可搜索的，并可从 命令面板 轻松访问，因此你无需切换上下文即可查找并执行它们。

如何保存和编辑工作流

你可以从 Warp 中的多个入口点创建新工作流

• 从 Warp Drive，选择 + > 新工作流
• 使用块操作，选择“保存为工作流”
• 从代理运行结果中，选择“保存为工作流”
• 从 命令面板，创建个人新工作流

以上任何一个入口点都会打开工作流编辑器，你可以在其中

• 为工作流命名
• 编辑命令及其参数（也称为参数）
• 添加有助于搜索的有意义描述（可选）
• 添加参数、参数描述和默认值（可选）

工作流保存/编辑面板。

使用参数

在工作流编辑器中，你可以通过“新参数”手动添加参数，或者在命令字段中输入双大括号（{{argument}}）。如果你在选中文字的状态下选择“新参数”，Warp 会将该文字用大括号括起来以创建参数。

创建有效参数有一些规则

• 参数名称只能包含字符 A-Za-z0-9、连字符 - 和下划线 _
• 参数的第一个字符不能是数字

参数有两种类型：文本或枚举。默认情况下，所有新参数均为文本类型。

枚举类型参数

枚举允许你为工作流参数指定预期的输入。当你将包含枚举的工作流插入输入编辑器时，系统会提示你填充参数的建议。在选择参数时，按下 SHIFT-TAB 可以打开建议菜单。

创建枚举类型参数

1. 导航到参数的“默认值”字段。
2. 选择“枚举”类型。
3. 点击“新建”创建新枚举，或从下拉菜单中选择现有枚举。
4. 如果选择了“新建”，你可以选择创建“静态”枚举或“动态”枚举。动态枚举与 Shell 命令相关联，通过解析该命令的输出结果来确定参数的有效值集。

使用别名

工作流别名允许你为常用的工作流创建个性化的快捷方式和自定义配置。这些别名为你使用和配置工作流提供了更强的灵活性。别名是个人账号专属的，不会与拥有该工作流的其他用户共享。如果启用了设置同步，它们将在登录同一账号的设备间同步。别名可以为每个 参数 设置默认值（非强制）。别名还可以关联 环境变量。

注意

工作流别名与 YAML 工作流 不兼容。它们只能用于在 Warp Drive 中创建的工作流。

编辑工作流

一旦创建了工作流，只要能够联网，你随时可以对其进行编辑。

Warp Drive 中工作流的编辑菜单。

AI 自动填充

工作流还可以选择使用 代理 自动生成标题、描述或参数。

• 创建或编辑工作流时，在编辑视图中你应该能看到自动填充选项。
• Warp 将根据你创建的工作流自动填充字段。

与团队协作编辑工作流

如果工作流与团队共享，所有团队成员都有权编辑该工作流，且更新将立即为所有成员同步。

如果当你尝试编辑工作流时，其他团队成员或在其他设备上的用户已对 Warp Drive 中的该工作流进行了更改，你将无法保存更改；你需要获取最新版本后再试。

如何执行工作流

你可以通过以下几种方式执行工作流

• 从 Warp Drive 中点击工作流
• 从 命令面板 中搜索想要执行的工作流，点击或选中后按回车
• 从 命令搜索 中搜索想要执行的工作流，点击或选中后按回车。
• 选择工作流后，可以使用 SHIFT-TAB 在参数间循环切换。

注意

当你创建两个或多个同名参数时，Warp 会自动在输入编辑器中选中这些参数并放置多个光标，以便它们同步更新。

此外，你可以在 设置 > 功能 中切换“显示全局工作流”来个性化命令搜索体验。禁用后，搜索将仅包含 YAML 和 Warp Drive 工作流。

在命令面板中搜索工作流。

这些选项会将工作流粘贴到你当前激活的终端输入中。工作流名称以及任何相关描述和参数将显示在对话框中，以便你了解如何使用该工作流。

从 Warp Drive 执行工作流。

在输入编辑器中运行命令之前，你可以根据需要调整参数（或命令本身）。

对 YAML 工作流的支持

Warp 将无限期支持 YAML 工作流，其中包括源自开源仓库的个人和社区工作流。

如果需要，你可以继续使用 命令搜索 或 命令面板 来访问你的 .yaml 文件工作流。但这些基于文件的工作流无法在 Warp Drive 中访问、组织或共享。

在 Warp Drive 中导入和导出工作流

请参阅我们的 Warp Drive 导入和导出 说明。