DevFlow/docs/03-模块文档/df-nodes-节点集合.md

df-nodes 节点集合

创建: 2026-06-10 | 状态: 初稿

---

概述

df-nodes 提供 DevFlow 工作流引擎的 8 种内置节点。所有节点实现 df-workflow 的 Node trait。

当前状态

所有 8 种节点 Schema 已定义完整，execute() 方法均为空实现。

节点清单

节点	功能	阻塞	实现状态
AINode	调用 LLM，流式输出，工具调用	否	骨架
ScriptNode	Shell/脚本执行	否	骨架
DockerNode	Docker 容器操作	否	骨架
GitNode	Git 操作 (libgit2)	否	骨架
HumanNode	人工审批/确认	是	骨架
NotifyNode	通知 (桌面/飞书/Webhook)	否	骨架
HTTPNode	HTTP 请求	否	骨架
SubflowNode	嵌套子工作流	否	骨架

实现优先级

Phase 1 阶段优先实现：

1. ScriptNode — 依赖 df-execute 的 Shell 执行器 (已可用)
2. HumanNode — 阻塞节点，工作流审批需要

Phase 2 实现：

3. AINode — 依赖 df-ai Provider 实现

Phase 4 实现：

4. DockerNode — 依赖 bollard crate
5. GitNode — 依赖 libgit2
6. HTTPNode — HTTP 客户端
7. NotifyNode — 通知渠道对接
8. SubflowNode — 嵌套工作流引擎

依赖关系

df-core
  ← df-workflow (Node trait)
    ← df-nodes
      ← df-ai (AINode)
      ← df-execute (ScriptNode)

文件结构

crates/df-nodes/src/
├── lib.rs        — 模块入口，注册所有节点
├── ai_node.rs    — AI 节点
├── script_node.rs — 脚本节点
├── docker_node.rs — Docker 节点
├── git_node.rs   — Git 节点
├── human_node.rs — 人工审批节点
├── notify_node.rs — 通知节点
├── http_node.rs  — HTTP 节点
└── subflow_node.rs — 子工作流节点

相关文档

• df-workflow 工作流引擎