跳到正文

文档

从第一个工作流到每个连接器的配置细节。

快速开始

  1. 注册并登录 Web 版。
  2. 新建工作流,画布上已有一个「触发」节点,它是流程的起点。
  3. 拖出一个「动作」节点,选择连接器(比如钉钉),填好配置。
  4. 从触发节点连线到动作节点,保存。
  5. 点击运行,输入测试数据,在执行记录里查看每个节点的结果。

工作流编辑指南

工作流由三种节点组成:

  • 触发:起点,每个工作流有且只有一个。运行时传入的数据就是它的输出。
  • 条件:做一次判断,出边分为「是」和「否」两条,只走匹配的那条。
  • 动作:调用一个连接器,比如发钉钉、发邮件、调接口。

保存时会检查:只有一个触发节点、连线两端都存在、没有形成环、条件的出边标了是/否、每个动作的必填项都已填写。有问题会逐条列出。

运行时从触发节点开始按连线往下走;任何一个节点失败,整次运行立即停止并标记为失败。

条件判断

条件由「左值、运算符、右值」三部分组成,左右两边可以填固定值,也可以填引用(见下一节)。

运算符含义示例
eq / ne等于 / 不等于$.input.status eq "paid"
gt / gte大于 / 大于等于$.input.amount gt 1000
lt / lte小于 / 小于等于$.input.stock lt 10
in左边在右边列表里$.input.city in ["北京", "上海"]
contains左边包含右边$.input.tags contains "VIP"
exists字段存在且不为空$.input.coupon exists

引用的字段不存在时,exists 为「否」,其它运算符也按「否」处理。

节点间传值

在条件或动作配置里,以 $ 开头的值会被替换成运行时的数据:

$.input.amount          运行时传入数据的 amount 字段
$.query.data.0.name     节点 query 输出中 data 列表第 1 项的 name
$.notify.status         节点 notify 输出的 status

整个字段值恰好是一个引用时才会替换,不支持在一段文字中间插入引用。邮件的主题和正文另外支持 {{变量}} 模板。

连接器配置

HTTP

必填
url
可选
method(默认 GET)、headers、body、query_params、auth_type(none / basic / bearer)、timeout、retries

body 为空时,发送上游节点的输出。只能访问公网地址。

钉钉

必填
webhook_url
可选
msg_type(text / markdown / link / card)、message、at_mobiles、at_all

webhook_url 在钉钉群设置 → 智能群助手 → 添加机器人里获取。「测试连接」会真的往群里发一条测试消息。

Email

必填
smtp_server、sender_email、sender_password、to
可选
smtp_port(默认 587)、use_tls、cc、bcc、subject、body、format(text / html / markdown)

subject 和 body 支持 {{变量}},变量取自上游节点输出。QQ / 163 邮箱请填授权码而不是登录密码。

SQLite

必填
database_path、sql
可选
params、operation(select / insert / update / delete / execute)、return_type(默认 dict)、timeout

database_path 只填文件名(如 orders.db),文件自动存放在你的专属数据目录里。SQL 用 ? 占位,值放 params。

Webhook

必填
webhook_url
可选
secret_key、verify_signature、event_types、retry_count、timeout

填了 secret_key 时,请求头带 X-Webhook-Signature(HMAC-SHA256),接收方可据此验签。

安全限制:HTTP、钉钉、邮件、Webhook 只能连接公网地址(127.0.0.1、10.x、192.168.x 等内网地址会被拒绝);SQLite 只能访问你自己的数据目录。

API 文档即将推出

开放 API 与接口参考正在整理,将随 Pro 方案一同开放。

常见问题

为什么我的 HTTP 节点报「not a public address」?
目标是内网或本机地址,出于安全被拦截。请使用公网可访问的地址。
能做循环吗?
暂不支持。工作流不能成环,保存时会提示。
可以定时自动运行吗?
定时触发即将推出,目前需要手动运行或通过接口触发。