From 692bff5751925782ccda5b9f7109bbc297faa48d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=BE=90=E6=B6=9B?= Date: Sun, 7 Jun 2026 10:57:20 +0800 Subject: [PATCH] =?UTF-8?q?feat(docs):=20=E6=9B=B4=E6=96=B0=E8=B7=AF?= =?UTF-8?q?=E7=BA=BF=E5=9B=BE=20Phase=202=20=E5=B7=A5=E5=85=B7=E7=B3=BB?= =?UTF-8?q?=E7=BB=9F=E5=AE=8C=E6=88=90=E7=8A=B6=E6=80=81?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 将所有 Phase 2 待办项标记为已完成，更新当前状态和下一步行动 --- docs/roadmap.md | 33 ++++++++++++++++++--------------- 1 file changed, 18 insertions(+), 15 deletions(-) diff --git a/docs/roadmap.md b/docs/roadmap.md index 4f38e88..51b267c 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -1,13 +1,13 @@ # AG Core Roadmap > 定稿日期：2026-05-11 -> 最后更新：2026-06-02（Phase 1 完成） +> 最后更新：2026-06-07（Phase 2 完成） ## 愿景 AG Core 定位为构建 AI 智能体的底层工具箱，通过模块化、可插拔的架构，提供大模型调用、提示词工程、工具系统、记忆检索四大核心能力，支持快速组合出符合业务需求的智能体应用。 -**当前状态**：Phase 0 基础设施已全部完成，Phase 1 提示词工程已全部完成，等待 Phase 2 启动。 +**当前状态**：Phase 0 基础设施已全部完成，Phase 1 提示词工程已全部完成，Phase 2 工具系统已全部完成，等待 Phase 3 启动。 --- @@ -17,7 +17,7 @@ AG Core 定位为构建 AI 智能体的底层工具箱，通过模块化、可 |---------|---------|---------|-----------| | LLM 调用周期 | ✅ 完整 | `specs/llm-call-lifecycle.md` | P0 | | 提示词工程 | ✅ 完整 | `docs/4-prompt-engineering.md` | P1 | -| 工具系统 + 权限 | ❌ 缺失 | — | P1 | +| 工具系统 + 权限 | ✅ 完整 | `docs/5-tool-system.md` | P1 | | 记忆检索 | ❌ 缺失 | — | P2 | | Agent 运行时 | ❌ 缺失 | — | P2 | | 生命周期钩子 | ✅ 完整 | `docs/3-phase0-remaining.md` | P0（LLM Cycle 扩展） | @@ -78,19 +78,22 @@ AG Core 定位为构建 AI 智能体的底层工具箱，通过模块化、可 **目标**：实现 MCP 协议集成与自定义工具注册、调用、权限控制。 **交付物**： -1. `tools.rs` + `tools/` 模块 -2. `ToolRegistry` — 工具注册表（注册、发现、调用） -3. `BaseTool` trait — 工具抽象接口 -4. `McpClient` — MCP 协议客户端 -5. `PermissionChecker` — 工具执行权限检查（读/写/删除/网络等） -6. `specs/tool-call-loop.md` — Tool 自动执行循环设计 -7. 扩展 `llm/cycle.rs` 支持自动 tool 循环（参考 OpenHarness `run_query()`） +1. ✅ `tools.rs` + `tools/` 模块（base/registry/permission/mcp/error） +2. ✅ `ToolRegistry` — 工具注册表（注册、发现、调用、并行执行、超时控制） +3. ✅ `BaseTool` trait — 工具抽象接口（含 ToolContext 执行上下文） +4. ✅ `McpClient` — MCP 协议客户端（stdio transport，StreamableHttp 预留） +5. ✅ `PermissionChecker` — 工具执行权限检查（白名单/黑名单/自定义权限） +6. ✅ `docs/5-tool-system.md` — 方案设计文档 +7. ✅ 扩展 `llm/cycle.rs` 支持自动 tool 循环（`submit_with_tools()` + `submit_request()` + `maybe_compact()`） +8. ✅ `ToolError` — 结构化错误体系（含 `is_recoverable()` 分类） **依赖**：Phase 0（LlmProvider 接口传递 tool definitions）、Phase 1（提示词可能需要注入工具描述） **优先级**：Should Have -**预估规模**：约 900 行代码 +**预估规模**：约 900 行代码（实际约 1500 行） + +**状态**：✅ Phase 2 全部交付物已完成 --- @@ -139,7 +142,7 @@ AG Core 定位为构建 AI 智能体的底层工具箱，通过模块化、可 graph BT P0["Phase 0: Foundation
LLM Cycle
ProviderRegistry
HookExecutor
StreamEvents
Auto-compaction"]:::done P1["Phase 1: Prompt Engineering
PromptTemplate
PromptComposer"]:::done - P2["Phase 2: Tool System
Tool Registry
PermissionChecker
MCP Client"]:::pending + P2["Phase 2: Tool System
Tool Registry
PermissionChecker
MCP Client"]:::done P3["Phase 3: Memory System
MemoryStore
VectorStore
ConversationMemory"]:::pending P4["Phase 4: Agent Runtime
ConversationAgent
TaskAgent"]:::pending @@ -179,10 +182,10 @@ graph BT ## 下一步行动 -1. **Phase 2 方案启动**：启动 `docs/5-tool-call-loop.md` 设计（含 PermissionChecker） -2. **Phase 3 方案启动**：启动 `docs/6-memory-system.md` 设计 -3. **依赖就绪**：Phase 1 已交付，Phase 2 依赖的提示词能力已就位 +1. **Phase 3 方案启动**：启动 `docs/6-memory-system.md` 设计 +2. **Phase 2 已就绪**：工具系统已交付，可为 Phase 3/4 提供工具调用能力 **已完成阶段**： - ✅ Phase 0 Foundation — 全部交付物已完成 - ✅ Phase 1 Prompt Engineering — 全部交付物已完成 +- ✅ Phase 2 Tool System — 全部交付物已完成