diff --git a/ARCHITECTURE.md b/ARCHITECTURE.md index bd05ec9..53b96d3 100644 --- a/ARCHITECTURE.md +++ b/ARCHITECTURE.md @@ -79,8 +79,8 @@ devflow/ ├── crates/ │ ├── df-core/ # 核心类型、错误、常量、事件 │ ├── df-workflow/ # 工作流 DAG 引擎 (核心) -│ ├── df-nodes/ # 内置节点集合 (AI/Script/Docker/Git/Human/HTTP/Subflow) -│ ├── df-ai/ # AI 编排层 (Multi-Provider/Router/Coordinator) +│ ├── df-nodes/ # 内置节点集合 (AI/Script/Human) +│ ├── df-ai/ # AI 编排层 (Multi-Provider/Coordinator) │ ├── df-execute/ # 执行运行时 (Shell) │ ├── df-storage/ # 存储层 (SQLite) │ ├── df-ideas/ # 想法池引擎 (捕捉/评估/评分/晋升) @@ -88,16 +88,16 @@ devflow/ │ │ 注: df-task / df-traceability / df-evolve / df-stages / df-plugin │ 5 个 crate 已移除(2026-06-14 零引用清理,推翻原"保留骨架"取舍) -├── src/ # Tauri 主入口 -│ ├── main.rs -│ ├── state.rs -│ └── commands/ # IPC 命令 -├── frontend/ # Vue 3 前端 +├── src-tauri/ # Tauri 主入口 (Rust) │ └── src/ -│ ├── views/ # 页面组件 -│ ├── components/ # 业务组件 -│ ├── stores/ # Pinia 状态 -│ └── composables/ # 组合式函数 +│ ├── main.rs +│ ├── state.rs +│ └── commands/ # IPC 命令 +├── src/ # Vue 3 前端 +│ ├── views/ # 页面组件 +│ ├── components/ # 业务组件 +│ ├── stores/ # Pinia 状态 +│ └── composables/ # 组合式函数 ├── templates/ # 工作流模板 (YAML) └── plugins/ # 外部插件目录 ``` @@ -240,24 +240,22 @@ pub struct Decision { ### 5.4 AI Orchestrator (df-ai) -- **LlmProvider trait**:统一接口,各模型实现 -- **ModelRouter**:按任务类型路由到最优模型 + 降级链 -- **AgentCoordinator**:多 Agent 协作(Planner/Coder/Reviewer/Fixer) -- **ContextManager**:Token 预算管理 -- **ToolRegistry**:工具注册(供 Agent 调用) +- **LlmProvider trait**:统一接口,各模型实现(`provider.rs`) +- **AgentCoordinator**:多 Agent 协作(Planner/Coder/Reviewer/Fixer)— ⚠️ 骨架空壳(`coordinator.rs`,仅单元结构体 + 日志,未实现实际协调) +- **ContextManager**:Token 预算管理(`context.rs`,完整实现) +- **ToolRegistry**:工具注册(`ai_tools.rs`,供 Agent 调用) + +> 注:历史文档曾列 `ModelRouter`(按任务路由 + 降级链),实际已删(R-PD-7),模型选择由调用方在 `LlmProvider` 实现间直接指定。 ### 5.5 内置节点 (df-nodes) -| 节点 | 功能 | -|------|------| -| AINode | 调用 LLM,支持流式输出、工具调用 | -| ScriptNode | Shell/脚本执行 | -| DockerNode | Docker 容器操作 | -| GitNode | Git 操作 (libgit2) | -| HumanNode | 人工审批/确认 (阻塞) | -| NotifyNode | 通知 (桌面/飞书/Webhook) | -| HTTPNode | HTTP 请求 | -| SubflowNode | 嵌套子工作流 | +| 节点 | 功能 | 状态 | +|------|------|------| +| AINode | 调用 LLM,支持流式输出、工具调用 | ✅ | +| ScriptNode | Shell/脚本执行 | ✅ | +| HumanNode | 人工审批/确认 (阻塞) | ✅ | + +> 注:历史文档曾列 Docker/Git/Notify/HTTP/Subflow 5 节点,均未实现(`crates/df-nodes/src/` 仅 ai_node / script_node / human_node 3 文件)。详见 [df-nodes 模块文档](docs/03-模块文档/df-nodes-节点集合-2026-06-12.md)。 ## 六、数据模型