快速开始
- 注册并登录 Web 版。
- 新建工作流,画布上已有一个「触发」节点,它是流程的起点。
- 拖出一个「动作」节点,选择连接器(比如钉钉),填好配置。
- 从触发节点连线到动作节点,保存。
- 点击运行,输入测试数据,在执行记录里查看每个节点的结果。
工作流编辑指南
工作流由三种节点组成:
- 触发:起点,每个工作流有且只有一个。运行时传入的数据就是它的输出。
- 条件:做一次判断,出边分为「是」和「否」两条,只走匹配的那条。
- 动作:调用一个连接器,比如发钉钉、发邮件、调接口。
保存时会检查:只有一个触发节点、连线两端都存在、没有形成环、条件的出边标了是/否、每个动作的必填项都已填写。有问题会逐条列出。
运行时从触发节点开始按连线往下走;任何一个节点失败,整次运行立即停止并标记为失败。
条件判断
条件由「左值、运算符、右值」三部分组成,左右两边可以填固定值,也可以填引用(见下一节)。
| 运算符 | 含义 | 示例 |
|---|---|---|
| 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 在钉钉群设置 → 智能群助手 → 添加机器人里获取。「测试连接」会真的往群里发一条测试消息。
- 必填
- 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」?
- 目标是内网或本机地址,出于安全被拦截。请使用公网可访问的地址。
- 能做循环吗?
- 暂不支持。工作流不能成环,保存时会提示。
- 可以定时自动运行吗?
- 定时触发即将推出,目前需要手动运行或通过接口触发。