docs(roadmap): 更新 Phase 0 状态标记为已完成
This commit is contained in:
+26
-19
@@ -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)
|
||||
3. **Phase 2 方案启动**:启动 `specs/tool-call-loop.md` 设计(含 PermissionChecker)
|
||||
|
||||
**已完成阶段**:
|
||||
- ✅ Phase 0 Foundation — 全部交付物已完成
|
||||
Reference in New Issue
Block a user