Workflows
事件驱动的自动化引擎。每个工作流都有一个触发器(应用事件或调度)和一系列共享上下文的步骤,这些步骤可以通过绑定相互引用,并通过重试、超时或 try/catch 对失败做出反应。
三种创建工作流的方式
模块以带三张卡片的欢迎页面打开。选择你的路径,你就会进入相应的流程。
Templates
8 个预制模板(CI/CD、自动部署、部署后备份、自动格式化、分支保护、错误时 AI…)。点击 "激活" 会创建一个具有新 UUID 的可编辑副本。
用 AI 生成
输入自然语言提示("当推送到 main 时,部署并通知"),助手会生成一个可编辑的工作流。使用你的 AI 账户(BYOK);如果调用失败,有本地启发式回退。
可视化编辑器
"我的 workflows" 中的 FAB "+" — 完整表单:名称、触发器、可拖动重新排序的步骤列表、每步骤的配置底部表单、可折叠的可靠性部分。
触发器 (10)
每个触发器都接受一个可选的过滤器(分支、文件扩展名、提供商…),在触发工作流之前缩小事件范围。
| Trigger | 触发时机… |
|---|---|
| Git push | 你将 commit 推送到一个分支(过滤器:分支) |
| Git commit | 你创建一个 commit(过滤器:分支) |
| File saved | 你在编辑器中保存文件(过滤器:扩展名) |
| App foregrounded | 你将应用切换回前台 |
| Terminal command finished | 终端命令完成(过滤器:模式) |
| Database query executed | 执行查询(过滤器:表名) |
| Deployment completed | 部署完成(过滤器:提供商) |
| Deployment failed | 部署失败(过滤器:提供商) |
| Error detected | 另一个工作流失败 — 用于链接错误响应 |
| Manual / Scheduled | 手动(按钮)或调度(间隔或 cron) |
动作步骤 (8)
每个动作步骤在应用中都有自己的表单,并产生一个后续步骤可以引用的结果。
Run command
运行任何终端命令
Notification
显示带标题和消息的通知
AI analyze
将代码或文本发送到 AI 助手并捕获响应
AI generate
从提示生成新代码
Git operation
Commit、push 或 pull(带可选的分支和消息)
Deploy
在活动托管提供商上触发部署
Database backup
运行活动数据库的备份
Open file
在编辑器中打开一个文件,带可选行号
控制流
除了平面序列之外,工作流还支持用于分支、迭代、并行化和处理错误的控制结构。
Conditional (if / else)
基于条件分支。运算符:等于、不等于、大于、小于、包含、为空。接受字面值和绑定。
Loop
使用每次迭代的别名迭代绑定集合。默认限制 100 次迭代。
Parallel
通过 join 策略(等所有、等第一个等)同时运行多个分支。
Wait
暂停执行可配置的时间。预设:1s、5s、30s、1m、5m。
Try / Catch
如果 try 块中的任何步骤失败,则跳转到 catch,错误消息绑定到可访问的变量。
When(轻量级条件)
每个动作步骤都可以携带一个 "when" — 如果表达式为假,则跳过该步骤,而不会将其包装在完整的 Conditional 中。
引擎执行所有六种类型的步骤。可视化编辑器目前支持:动作步骤、Wait 和 Conditional(一层嵌套)。Loop、Parallel 和 Try/Catch 在引擎中工作,但尚未在编辑器中提供。
步骤之间的绑定
任何表单字段都接受字面值或 `{{...}}` 语法的绑定来引用其他工作流变量。如果表达式无法解析,则返回空字符串 — 工作流容忍被条件分支跳过的步骤。
| 表达式 | 解析为 |
|---|---|
| {{var.<name>}} | 工作流范围的变量 |
| {{step.<id>.status}} | 步骤状态 (SUCCESS, FAILURE, SKIPPED, TIMED_OUT) |
| {{step.<id>.output}} | 完整的结果映射 |
| {{step.<id>.output.<field>}} | 结果的特定字段 |
| {{step.<id>.error}} | 如果失败,错误消息 |
| {{item.<alias>}} | Loop 内的当前值 |
| {{trigger.eventName}} | 触发工作流的事件名称 |
每个配置底部表单都包含带有语法的可见提示,以便从 UI 中发现绑定系统。
可靠性 — 重试、超时和退避
每个动作步骤都有一个可折叠的可靠性部分,有五个字段。如果一个步骤失败,它会以所选的等待策略重试,直到尝试次数用完。
Max attempts
在步骤标记为失败之前的尝试次数(1 = 无重试)
Backoff strategy
FIXED(恒定等待)、LINEAR(线性增长)或 EXPONENTIAL(每次尝试翻倍)
Initial delay
首次失败后等待,以毫秒为单位
Max delay
上限 — 等待时间永远不会超过此值
Timeout
如果超过 X 毫秒,则取消步骤。标记为 TIMED_OUT
如果带有超时的步骤位于 try / catch 块内,catch 会自动运行,错误消息可作为变量使用。
调度 — 间隔或 cron
任何具有手动触发器的工作流都可以附加一个或多个调度。它们在应用关闭后仍然存在,并在启动时自动重新调度。
间隔预设
- • 每 15 分钟
- • 每小时
- • 每 6 小时
由于操作系统限制,实际最小间隔为 15 分钟 — 任何更小的值都会被限制为此。
Cron 预设 + 自定义表达式
- •
0 9 * * *— 每天 9:00 - •
0 9 * * 1— 周一 9:00 - • 自定义 5 字段表达式
接受通配符 (*)、列表 (1,3,5)、范围 (1-5) 和步骤 (*/2)。在你输入时,应用会实时显示下一次触发日期,或警告表达式无效。
执行历史
每次执行都会持久化每个步骤结果的完整快照。它在崩溃和应用关闭后仍然存在。
- •每个工作流的最新优先时间线,带状态图标和颜色
- •每次运行的详细信息:逐步显示持续时间、以等宽字体渲染的输出以及任何错误消息
- •步骤状态:SUCCESS(绿)、FAILURE(红)、SKIPPED(灰)、TIMED_OUT(橙)、RUNNING(蓝)
- •自动保留:每个工作流最多 100 次运行 + 30 天上限
编辑器中的 "▶ 立即测试" 按钮运行工作流,而不会持久化运行或发出事件 — 有助于在设计时迭代而不污染历史记录。副作用(命令、通知、AI 提示)会执行:这是一个真实的测试,而不是干预览。
AI 生成器
你粘贴一个像 "当推送到 main 时,部署并通知" 的提示,应用会生成一个具有检测到的触发器 + 动作 + 过滤器的工作流,准备保存和启用。BYOK 模型:使用你活动的 AI 提供商(Gemini、OpenAI、Claude…)。
如果提供商调用失败(没有 token、没有网络、JSON 无效),应用会自动回退到本地启发式解析器,该解析器识别关键字("push"、"deploy"、"test"、"notify"、"backup"、"ai"、"format"…)并生成一个基本的工作流。回退是静默的 — 你总是会得到一个预览。
Workflows 作为 AI agent 工具
你在编辑器中标记为 "Available to AI agent" 的任何工作流都会自动作为 AI 聊天中的工具暴露。代理决定何时调用它并传递参数,这些参数作为变量到达工作流(`{{var.<key>}}`)。
只有启用并勾选该选项的工作流才会被暴露。模型看到的描述是你在 "AI tool description" 字段中写的(如果为空,则是常规描述)。代理调用像任何手动运行一样保留在历史记录中。
内置模板 (8)
在其中任何一个上点击 "激活" 都会创建一个具有新 UUID 的可编辑副本。如果你已经有该模板的活动副本,则按钮被禁用以避免重复。
| 模板 | Trigger | 动作 |
|---|---|---|
| CI/CD pipeline | Git push | npm test → deploy → 通知 |
| Auto-deploy on push | Git push (main 分支) | deploy → 通知 |
| DB backup on deploy | Deployment completed | 备份 → 通知 |
| AI on error | Error detected | 通知 → AI 分析 |
| Auto-format | File saved | prettier --write . |
| Auto-commit | File saved | git add -A && git commit |
| Branch protect | Git push (main 分支) | npm test → 关卡通知 |
| Test on commit | Git commit | npm test → 通知 |
你也可以从 Marketplace 安装工作流 — 它们作为 "我的 workflows" 中的常规副本出现。
Free vs Pro
| 功能 | Free | Pro |
|---|---|---|
| 可视化编辑器、控制流、绑定、重试、超时 | ✅ | ✅ |
| 手动执行 + "立即测试" 按钮 | ✅ | ✅ |
| 8 个内置模板 | ✅ | ✅ |
| 执行历史(100 次运行 / 30 天) | ✅ | ✅ |
| AI 生成器(使用你自己的 BYOK 账户) | ✅ | ✅ |
| 自动触发器(push、commit、文件保存、部署…) | — | ✅ |
| 间隔和 cron 调度 | — | ✅ |
| Workflows 作为 AI agent 工具 | — | ✅ |
模块统计
10
触发器类型
8
动作类型
6
控制流步骤
8
内置模板
5
调度预设
100
运行 / 工作流
30
天数保留
下一步
配置