diff --git a/docs/roadmap.md b/docs/roadmap.md index 51b267c..506f762 100644 --- a/docs/roadmap.md +++ b/docs/roadmap.md @@ -1,13 +1,13 @@ # AG Core Roadmap > 定稿日期:2026-05-11 -> 最后更新:2026-06-07(Phase 2 完成) +> 最后更新:2026-06-09(Phase 3 完成) ## 愿景 AG Core 定位为构建 AI 智能体的底层工具箱,通过模块化、可插拔的架构,提供大模型调用、提示词工程、工具系统、记忆检索四大核心能力,支持快速组合出符合业务需求的智能体应用。 -**当前状态**:Phase 0 基础设施已全部完成,Phase 1 提示词工程已全部完成,Phase 2 工具系统已全部完成,等待 Phase 3 启动。 +**当前状态**:Phase 0 基础设施已全部完成,Phase 1 提示词工程已全部完成,Phase 2 工具系统已全部完成,Phase 3 记忆系统已全部完成,等待 Phase 4 启动。 --- @@ -18,7 +18,7 @@ AG Core 定位为构建 AI 智能体的底层工具箱,通过模块化、可 | LLM 调用周期 | ✅ 完整 | `specs/llm-call-lifecycle.md` | P0 | | 提示词工程 | ✅ 完整 | `docs/4-prompt-engineering.md` | P1 | | 工具系统 + 权限 | ✅ 完整 | `docs/5-tool-system.md` | P1 | -| 记忆检索 | ❌ 缺失 | — | P2 | +| 记忆检索 | ✅ 完整 | `docs/6-memory-system.md` | P2 | | Agent 运行时 | ❌ 缺失 | — | P2 | | 生命周期钩子 | ✅ 完整 | `docs/3-phase0-remaining.md` | P0(LLM Cycle 扩展) | | Provider 注册发现 | ✅ 完整 | `docs/3-phase0-remaining.md` | P0(Provider 接口扩展) | @@ -102,18 +102,22 @@ AG Core 定位为构建 AI 智能体的底层工具箱,通过模块化、可 **目标**:提供对话记忆的存储、检索与管理能力。 **交付物**: -1. `memory.rs` + `memory/` 模块 -2. `MemoryStore` trait — 记忆存储抽象(可插拔后端) -3. `VectorStore` — 向量存储实现(支持 embedding 检索) -4. `ConversationMemory` — 对话记忆管理(sliding window / 全量) -5. `MemoryRetriever` — 记忆检索器(similarity search) -6. `specs/memory-system.md` — 方案文档 +1. ✅ `memory.rs` + `memory/` 模块(store / conversation / knowledge / retriever / error / types) +2. ✅ `MemoryStore` trait + `InMemoryStore` — 记忆存储抽象(可插拔后端)+ 默认实现 +3. ✅ `ConversationMemory` — 对话记忆管理(sliding window / 全量),复用 `llm::compact` +4. ✅ `KnowledgeStore` — 知识页面存储(具体 struct,非 trait,基于 MemoryStore) +5. ✅ `MemoryRetriever` — 记忆检索器(TextOverlap Dice 系数评分,单通道) +6. ✅ `docs/6-memory-system.md` — 方案设计文档 +7. ✅ `docs/note-knowledge-graph-design.md` — KnowledgeGraph 等 Phase 4 备用设计 +8. ✅ `EvictionPolicy` — 支持 None / Ttl / Capacity 三种淘汰策略 -**依赖**:Phase 0(LLM 调用可能用于 embedding 生成) +**依赖**:Phase 0(llm::compact 复用)、Cargo.toml 新增 `time` 依赖 **优先级**:Could Have -**预估规模**:约 700 行代码 +**预估规模**:约 700 行代码(实际约 1242 行,含测试) + +**状态**:✅ Phase 3 全部交付物已完成 --- @@ -143,7 +147,7 @@ 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"]:::done - P3["Phase 3: Memory System
MemoryStore
VectorStore
ConversationMemory"]:::pending + P3["Phase 3: Memory System
MemoryStore
ConversationMemory
KnowledgeStore"]:::done P4["Phase 4: Agent Runtime
ConversationAgent
TaskAgent"]:::pending P1 --> P0 @@ -182,10 +186,11 @@ graph BT ## 下一步行动 -1. **Phase 3 方案启动**:启动 `docs/6-memory-system.md` 设计 -2. **Phase 2 已就绪**:工具系统已交付,可为 Phase 3/4 提供工具调用能力 +1. **Phase 4 方案启动**:启动 Agent Runtime 设计(依赖 Phase 0/1/2/3,整合所有模块) +2. **Phase 3 备用设计就绪**:`docs/note-knowledge-graph-design.md` 记录了 KnowledgeGraph、高级评分、RecallBased 淘汰等设计,Phase 4 可直接参考 **已完成阶段**: - ✅ Phase 0 Foundation — 全部交付物已完成 - ✅ Phase 1 Prompt Engineering — 全部交付物已完成 - ✅ Phase 2 Tool System — 全部交付物已完成 +- ✅ Phase 3 Memory System — 全部交付物已完成