修复: ARCHITECTURE §5.4 df-ai虚构清理(ModelRouter删/AgentCoordinator标空壳)+§5.5 df-nodes 8→3节点+crate树注释+src-tauri/src路径树对齐

This commit is contained in:
2026-06-15 12:07:36 +08:00
parent 2ddd2940cc
commit c7a1d5665f

View File

@@ -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,12 +88,12 @@ devflow/
│ 注: df-task / df-traceability / df-evolve / df-stages / df-plugin
│ 5 个 crate 已移除2026-06-14 零引用清理,推翻原"保留骨架"取舍)
├── src/ # Tauri 主入口
├── src-tauri/ # Tauri 主入口 (Rust)
│ └── src/
│ ├── main.rs
│ ├── state.rs
│ └── commands/ # IPC 命令
├── frontend/ # Vue 3 前端
│ └── src/
├── src/ # Vue 3 前端
│ ├── views/ # 页面组件
│ ├── components/ # 业务组件
│ ├── stores/ # Pinia 状态
@@ -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)。
## 六、数据模型