Unfour

Flow:创建并运行本地 Runbook

Flow 把已保存的工作区资源组合成可重复执行的本地 runbook。Flow 属于免费开源核心能力,即使使用 Pro 也保留在本地。

准备工作区资源

保存并验证将要使用的 API 请求、SSH Task 与连接、Database 连接。从测试环境开始,先选择一组预期结果明确的小范围检查。

在 Canvas 中定义 Runbook

  1. 在选定工作区打开 Flow,创建新定义。
  2. 命名 runbook,声明 string、number、boolean 或 JSON 类型输入。将敏感输入标为 secret,不要保存秘密默认值。
  3. 添加引用已保存资源的 API、SSH Task 或 Database 步骤。明确选择 SSH 连接,核对 Database 目录与 Schema。
  4. 用 Condition 根据比较结果分支;用 Wait Until 按指定间隔重复 API 或只读 Database 检查,并设置超时及成功、失败条件。
  5. 保存定义,运行前解决验证错误。

输入与前序步骤结果可传给后续步骤。文本替换不会自动转义 SQL 或 Shell 命令,应使用可信值并复核实际操作。

选择环境并复核运行

  1. 打开运行对话框,填写必需的带类型输入。
  2. 为本次运行选择环境。不选环境时只使用工作区变量,Flow 不会隐式继承桌面当前环境。
  3. 在确认界面核对 Flow、工作区、环境、输入与可能产生的操作,再启动运行。
  4. 检查步骤结果与进度;打开 History 查看结果、Wait Until 尝试或以往运行。
  5. 需要时取消运行,再检查已完成操作的影响;取消不会回滚这些影响。

步骤串行执行,遇到第一个错误便停止后续步骤;普通动作不会隐式重试。Wait Until 只在超时范围内执行你定义的检查与重试策略。

通过 MCP 管理和执行同一个 Flow

为 Codex 或 Cursor 配置本地 Unfour MCP Server。Flow 工具共用桌面定义、资源和历史:unfour.flow.list、get、save、delete、run、cancel_run、list_runs 与 get_run。MCP 历史列表支持 limit 与 cursor。

本地范围与 V1 限制

  • Flow 定义与运行历史保留在本地,不参与 Cloud Sync 或工作区导入导出;Pro 不改变此边界。
  • Flow 是免费核心模块,不是通用工作流或自主排障平台。
  • Flow V1 不支持保存的 API 请求脚本与 multipart 请求体;Wait Until API 探测仅允许 GET/HEAD,Database 探测必须只读。
  • V1 不提供定时调度、Webhook 触发、并行步骤、子 Flow 或 LLM/Agent 节点。
  • 向 MCP 客户端发送结果前需复核,任意日志和 SQL 结果仍可能含有机密文本。