快速开始
本指南带你走完 Buildify 控制台的核心路径：添加工作节点 → 创建项目 → 新建并绘制流程 → 发布 → 查看运行状态。完成后即可在画布上编排「定时拉取 → 处理 → 判断 → 通知」类业务流。
登录入口：控制台
名词说明
控制台界面使用 工作节点（执行流程的运行环境）；部分介绍材料中也称 工作服务器，二者指同一概念。
前置准备
- Buildify 控制台 账号（微信扫码登录）
- 至少一台可接入 Buildify 的宿主机（用于注册工作节点）
- （可选）一个返回 JSON 的 HTTP 接口，用于后续示例节点测试
第 1 步：添加工作节点
工作节点是流程的实际运行环境。发布流程前，需先注册至少一个节点。
- 登录控制台，在左侧导航进入 工作节点
- 点击 创建工作节点，填写节点名称与说明
- 按引导在宿主机安装 Agent 并完成连通性检查，节点状态变为 已激活
节点激活后，可将流程部署到该环境运行，并在 运行状态 页查看执行情况。
第 2 步：创建项目
项目是流程、凭证与成员的归属单元，便于按业务线隔离管理。
- 左侧导航进入 我的项目
- 点击 创建项目，填写项目名称与描述
- 创建成功后进入项目详情页
第 3 步：新建流程
在项目内创建要编排的工作流。
- 进入项目后，默认打开 工作流程 Tab
- 点击 新建流程，填写流程名称（如「每日数据同步」）
- 创建完成后点击流程名称，进入流程详情
第 4 步：绘制流程
点击 编辑流程 进入可视化画布：左侧为节点面板，中间为画布，选中节点后右侧为配置面板。
示例：搭建 定时拉取 → HTTP 请求 → JS 处理 → IF 判断 → 发送通知：
节点配置要点
定时触发器
| 配置项 | 示例值 |
|---|---|
| Cron 表达式 | 0 0 8 * * ?（每天 8:00） |
| 时区 | Asia/Shanghai |
HTTP 请求
| 配置项 | 示例值 |
|---|---|
| 请求方法 | GET |
| 请求地址 | https://api.example.com/orders/today |
JS 函数（清洗数据）
javascript
const orders = msg.output.body.list || [];
return {
output: {
count: orders.length,
totalAmount: orders.reduce((sum, o) => sum + o.amount, 0),
},
};IF 条件：msg.output.count > 0 — 为真走通知分支，为假则结束。
通知节点：消息内容可用模板变量，例如：
今日订单同步完成：共 {{msg.output.count}} 单画布编辑过程中可随时 保存草稿；测试前需为本流程分配工作节点（见下一步发布）。
第 5 步：测试运行
在流程编辑器顶栏点击 测试：
- 定时触发器在测试模式下会立即触发一次
- 各节点实时显示执行状态与输入/输出
- 点击节点可查看完整消息，便于排查配置
常见问题
- 节点走失败分支：检查地址、凭证或参数
- 变量为空：核对模板变量路径，区分大小写
- 提示未分配工作节点：先完成第 6 步发布，或在测试中指定运行节点
第 6 步：发布流程
测试通过后，点击顶栏 发布流程：
- 选择要部署的 工作节点（可多选）
- 填写 发布说明（记录本次变更，便于回滚对照）
- 确认发布，系统会将可运行版本下发到所选节点
- SNAPSHOT 版本可反复覆盖，适合联调
- 正式版本发布后为不可覆盖，建议联调稳定后再升版
第 7 步：查看运行状态
返回流程详情，切换到 运行状态 Tab：
- 查看流程在各工作节点上的部署与运行状态
- 画布只读展示当前运行版本，节点带执行状态标识
- 点击节点可查看最近一次执行的输入/输出
发布为秒级生效；若需调整，回到编辑器修改后再次 发布流程，或在版本历史中回滚。
下一步
- 模板变量 — 在文本中引用
msg字段 - 软件市场 — 浏览并安装 Bundle
- Agent 开发 Bundle — 用 Agent 开发自定义节点
- SDK API 参考 — 节点 API 与发布规范
缺少对接节点时，可用 Agent + buildify-bundle-dev skill 生成 Bundle，发布后再回到画布编排。