From ea1e5c7f7ed1777a16fce7c032978971357e208e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=BE=90=E6=B6=9B?= Date: Tue, 2 Jun 2026 09:00:46 +0800 Subject: [PATCH] =?UTF-8?q?docs(roadmap):=20=E6=9B=B4=E6=96=B0=20Phase=200?= =?UTF-8?q?=20=E7=8A=B6=E6=80=81=E6=A0=87=E8=AE=B0=E4=B8=BA=E5=B7=B2?= =?UTF-8?q?=E5=AE=8C=E6=88=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/roadmap.md | 45 ++++++++++++++++++++++++++------------------- 1 file changed, 26 insertions(+), 19 deletions(-) diff --git a/docs/roadmap.md b/docs/roadmap.md index c350a64..c7fd52f 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -1,12 +1,13 @@ # AG Core Roadmap > 定稿日期：2026-05-11 +> 最后更新：2026-06-02 ## 愿景 AG Core 定位为构建 AI 智能体的底层工具箱，通过模块化、可插拔的架构，提供大模型调用、提示词工程、工具系统、记忆检索四大核心能力，支持快速组合出符合业务需求的智能体应用。 -**当前状态**：代码为空壳，specs 目录有 1 份方案（LLM 调用周期）。 +**当前状态**：Phase 0 基础设施已全部完成，等待 Phase 1 启动。 --- @@ -19,9 +20,9 @@ AG Core 定位为构建 AI 智能体的底层工具箱，通过模块化、可 | 工具系统 + 权限 | ❌ 缺失 | — | P1 | | 记忆检索 | ❌ 缺失 | — | P2 | | Agent 运行时 | ❌ 缺失 | — | P2 | -| 生命周期钩子 | ❌ 缺失 | — | P0（LLM Cycle 扩展） | -| Provider 注册发现 | ❌ 缺失 | — | P0（Provider 接口扩展） | -| 流式事件系统 | ❌ 缺失 | — | P0（流式接口前置） | +| 生命周期钩子 | ✅ 完整 | `docs/3-phase0-remaining.md` | P0（LLM Cycle 扩展） | +| Provider 注册发现 | ✅ 完整 | `docs/3-phase0-remaining.md` | P0（Provider 接口扩展） | +| 流式事件系统 | ✅ 完整 | `docs/3-phase0-remaining.md` | P0（流式接口前置） | --- @@ -32,15 +33,15 @@ AG Core 定位为构建 AI 智能体的底层工具箱，通过模块化、可 **目标**：实现 LLM 调用周期的核心功能，作为所有上层模块的基础。 **交付物**： -1. `llm/types.rs` — 核心数据类型（Message, ContentBlock, ChatRequest/Response, ToolDefinition, StopReason） -2. `llm/error.rs` — 错误体系（LlmError 枚举，可重试/不可重试判断） -3. `llm/provider.rs` + `llm/provider/openai.rs` — Provider 接口 + OpenAI 兼容实现 -4. `llm/provider/registry.rs` — ProviderRegistry（多 Provider 注册发现） -5. `llm/cycle.rs` + `llm/cycle/{retry,usage}.rs` — 生命周期引擎（重试策略 + 用量追踪） -6. `llm/hooks.rs` — HookExecutor 接口（生命周期钩子） -7. `llm/stream.rs` — StreamEvents 流式事件系统（AssistantTextDelta, ToolExecutionStarted 等） -8. `llm/compact.rs` — Auto-compaction（上下文自动压缩） -9. `Cargo.toml` — 添加依赖（tokio, reqwest, serde, thiserror, async-trait, tracing） +1. ✅ `llm/types.rs` — 核心数据类型（Message, ContentBlock, ChatRequest/Response, ToolDefinition, StopReason） +2. ✅ `llm/error.rs` — 错误体系（LlmError 枚举，可重试/不可重试判断） +3. ✅ `llm/provider.rs` + `llm/provider/openai.rs` — Provider 接口 + OpenAI 兼容实现 +4. ✅ `llm/provider/registry.rs` — ProviderRegistry（多 Provider 注册发现） +5. ✅ `llm/cycle.rs` + `llm/cycle/{retry,usage}.rs` — 生命周期引擎（重试策略 + 用量追踪） +6. ✅ `llm/hooks.rs` — HookExecutor 接口（生命周期钩子） +7. ✅ `llm/stream.rs` — StreamEvents 流式事件系统（AssistantTextDelta, ToolExecutionStarted 等） +8. ✅ `llm/compact.rs` — Auto-compaction（上下文自动压缩） +9. ✅ `Cargo.toml` — 添加依赖（tokio, reqwest, serde, thiserror, async-trait, tracing） **依赖**：无 @@ -48,6 +49,8 @@ AG Core 定位为构建 AI 智能体的底层工具箱，通过模块化、可 **预估规模**：约 1000 行核心代码 +**状态**：✅ Phase 0 全部交付物已完成 + --- ### Phase 1 — Prompt Engineering（提示词工程） @@ -155,17 +158,18 @@ AG Core 定位为构建 AI 智能体的底层工具箱，通过模块化、可 ## 扩展计划（v0.2+） -> 以下功能已在 Phase 0 中实现，流式接口为后续增量优化。 +> 以下功能在 Phase 0 中已实现基础能力，后续可增量优化。 -| 扩展项 | 所在模块 | 说明 | 优先级 | -|-------|---------|------|--------| -| Prompt Optimizer | `prompt` | 提示词自动优化 | P3 | +| 扩展项 | 所在模块 | 说明 | 优先级 | 状态 | +|-------|---------|------|--------|------| +| Prompt Optimizer | `prompt` | 提示词自动优化 | P3 | 待实现 | +| 流式接口优化 | `llm/stream` | 流式响应解析与事件化 | P0 | ✅ 已完成基础实现 | --- ## 风险与建议 -1. **Phase 0 尚未实现**：项目代码是空壳，建议优先完成 LLM 调用周期，避免后续模块依赖不存在的底层 +1. **Phase 0 已完成**：LLM 调用周期基础设施已全部实现，可以支撑后续模块开发 2. **并行可能性**：Phase 0 和 Phase 1 可并行开展（无相互依赖），可加速早期交付 3. **MCP 协议复杂性**：MCP 涉及协议握手、session 管理、长期连接，建议预留充足时间调研协议细节 4. **Scope 蔓延风险**：当前 specs 只有 1 份文档，建议每个模块上线前都产出对应 spec，避免边实现边设计 @@ -176,4 +180,7 @@ AG Core 定位为构建 AI 智能体的底层工具箱，通过模块化、可 1. **Phase 0 方案评审**：对齐 LLM 模块设计（`specs/llm-call-lifecycle.md` 已在 2026-05-11 更新） 2. **Phase 1 方案启动**：启动 `specs/prompt-design.md` 设计 -3. **Phase 2 方案启动**：启动 `specs/tool-call-loop.md` 设计（含 PermissionChecker） \ No newline at end of file +3. **Phase 2 方案启动**：启动 `specs/tool-call-loop.md` 设计（含 PermissionChecker） + +**已完成阶段**： +- ✅ Phase 0 Foundation — 全部交付物已完成 \ No newline at end of file