NeurFlow 工作流引擎
IDE 化编排与调试
NeurFlow 是 Neurova 的可视化工作流引擎，将工作流从"配置文件"升级为"可视化 IDE"——设计、调试、发布、回滚全生命周期覆盖。
核心能力
| 能力 | 说明 | 状态 |
|---|---|---|
| 可视化画布 | 拖拽式节点编排（开始/结束/任务/条件/并行/子流程） | 已实现 |
| 调试走查器 | 外挂式 Mock 引擎，单步/跳过执行，局部变量查看 | 已实现 |
| 版本快照与回滚 | 内容指纹 + 保留 status + 回滚入史 | 已实现 |
| 触发器系统 | Cron 定时 + Webhook 入站（HMAC-SHA256 + token bucket） | 已实现 |
| 子工作流 Subflow | 嵌套深度 ≤ 5 + 防环检测 | 已实现 |
| Agent 编译 | 工作流 → AgentManifest（纯函数 + deps 注入） | 已实现 |
| 安全审计 | Webhook 投递审计记录、历史回溯 | 已实现 |
工作流节点类型
[开始] → [任务A] → [条件判断] ─┬─ 是 → [任务B] → [子流程] → [结束]
│
└─ 否 → [任务C] → [结束]调试 IDE 特性
- 断点设置：在任意节点暂停执行
- Mock 值注入：跳过实际执行，返回预设值测试下游
- 版本抽屉：历史版本对比与回滚
- 触发器配置抽屉：Cron 表达式 / Webhook 签名配置
- 执行轨迹：每次运行的完整节点级记录
可视化画布搭建
NeurFlow 提供可视化工作流画布，拖拽节点即可搭建完整的工作流，无需编写代码。
1. 进入画布
- 登录 NeurUI 后，进入 协作 → NeurFlow → 工作流 页面
- 点击「新建工作流」创建空画布，或从模板库选择预置模板
2. 拖拽搭建
| 操作 | 说明 |
|---|---|
| 拖入节点 | 从左侧节点面板拖拽开始/结束/任务/条件/并行/子流程节点到画布 |
| 连线 | 从节点右侧端口拖出连线，连接到下一节点 |
| 平移画布 | 按住空格 + 拖动，或滚轮上下/shift+滚轮左右 |
| 框选 | 拖动空白区域框选多个节点，批量移动/删除 |
| 复制粘贴 | 选中节点 Ctrl+C / Ctrl+D 复制，Ctrl+V 粘贴（可选复制子节点） |
| 小地图 | 画布右下角小地图，点击可快速跳转视图 |
| 全屏 | 点击全屏按钮进入专注模式 |
3. 配置节点
- 任务节点：选择技能/工具，填写参数（LLM 提示词可引用上下文变量）
- 条件节点：配置分支条件（如 {status} == success），条件表达式支持引用节点输出
- 子流程节点：选择已有工作流作为子流程，嵌套深度 ≤ 5 + 防环检测
- 区块（SubBlocks）：折叠/展开节点组，条件表达式控制分组显隐
4. 自然语言设计器
除了拖拽，还可以直接用自然语言描述工作流，CanvasNLDesigner 会自动解析生成画布：
用户输入 → 意图识别 → 知识库检索 → 生成回答 → 审核 → 输出5. 调试运行
- 断点：右键节点设置断点，运行到断点暂停
- Mock 引擎：预设节点返回值，跳过实际执行测试下游
- 单步/跳过：逐节点执行查看变量，或跳过后继续
- 执行轨迹：运行后查看完整节点级时间线（输入/输出/耗时）
6. 发布与版本
- 点击「发布」将工作流编译为 AgentManifest 供 Agent 调用
- 版本抽屉：查看历史版本、对比差异、一键回滚
- 触发器配置抽屉：绑定 Cron 定时 / Webhook（HMAC 签名）入站
使用
# API 端点
GET /api/v1/neurflow/workflows # 工作流列表
POST /api/v1/neurflow/workflows # 创建工作流
POST /api/v1/neurflow/workflows/{id}/run # 执行工作流
POST /api/v1/neurflow/triggers # 创建触发器（Cron/Webhook）