核心功能
FlowFi API 技能是一套面向 DeFi 自动化工作流的完整后端集成方案，涵盖六大核心模块：
1. 身份认证与智能账户
- JWT 认证：所有受保护端点需
Authorization: Bearer <token> - 长效 API Token：通过
/auth/bearer-token生成 60 秒至 1 年的自定义过期令牌 - 智能账户管理：
GET /smart-accounts获取用户账户，作为工作流挂载载体
2. AI 驱动工作流引擎
- 自然语言生成：
POST /ai/generate-workflow将描述（如"ETH 跌破 2000 时发 Telegram 通知"）转为可执行工作流 - 智能编辑建议：
GET /ai/workflow/:id/suggestions提供 4 条优化建议 - 对话式编辑：
POST /ai/workflow/:id/prompt支持"添加 10 秒延迟"等自然语言修改
3. 工作流生命周期管理
| 状态转换 | 端点 | 说明 |
|---------|------|------|
| draft → active | `POST /workflows/:id/deploy` | 激活调度执行 |
| active/paused → draft | `POST /workflows/:id/undeploy` | 停止并允许编辑 |
| active ↔ paused | pause/resume | 临时启停 |
| active/paused → ended | `POST /workflows/:id/stop` | 终止运行（可重新部署）|
| 任意状态 | `DELETE /workflows/:id` | 永久删除 |
4. 执行监控与实时推送
- REST 执行控制：
POST /executions/workflows/:id/start手动触发；GET /executions/:id/events查看节点级日志 - WebSocket 实时订阅：
/workflow-status命名空间支持subscribe:execution/workflow/simulation，推送执行状态、节点完成、工作流变更等事件
5. 价格服务（免认证）
GET /price?symbol=ETH单代币 USD 价格GET /price/prices批量获取 BNB/ETH 价格
6. 模板生态
- 公开浏览：
GET /templates支持分类、搜索、价格筛选 - 一键克隆：
POST /templates/:id/clone基于模板快速创建草稿工作流
显著优势
- 零代码 DeFi 自动化：自然语言生成完整工作流，降低技术门槛
- 状态机严谨性：draft/active/paused/ended/archived 五态模型确保操作安全
- 实时可观测性：WebSocket 推送替代轮询，毫秒级状态同步
- 灵活部署模式：支持计划任务（schedule-trigger）、价格监控（blockchain-monitor）、即时触发（instant）
- 模块化节点体系：涵盖触发器、预言机、DeFi 操作、逻辑控制、AI、通知等 10+ 类别
潜在局限与风险
| 风险类别 | 具体说明 |
|---------|---------|
| **编辑锁定机制** | 工作流必须先 undeploy 才能编辑，高频变更场景下可能产生额外状态切换开销 |
| **AI 生成可靠性** | 自然语言到节点配置的转换依赖 LLM，复杂逻辑可能出现节点连接错误或参数缺失，需人工审核 |
| **链上执行风险** | DeFi 节点（swap、liquidity）涉及真实资产操作，测试环境验证不足可能导致资金损失 |
| **WebSocket 稳定性** | 长连接断线后需客户端实现重连与状态恢复机制 |
| **价格数据延迟** | CoinMarketCap 缓存数据，极端行情下可能存在分钟级滞后 |
适用人群
- DeFi 交易员：设置价格预警、自动止损、gas 优化执行
- 资管协议开发者：集成智能账户与工作流编排能力
- 自动化工程师：构建链上-链下混合工作流
- 产品团队：快速克隆模板并二次开发
安全建议
- 生产环境使用短时效 Bearer Token 并启用撤销机制 (
/auth/bearer-token/revoke) - 工作流部署前通过
GET /templates/:id预览完整节点结构 - 高价值操作节点添加人工审批或延迟步骤
- 监控
execution:status事件及时处理失败状态