docs(roadmap): 更新 Phase 0 状态标记为已完成

This commit is contained in:
徐涛
2026-06-02 09:00:46 +08:00
parent 32f3edaf19
commit ea1e5c7f7e
+25 -18
View File
@@ -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 |
| 生命周期钩子 | ❌ 缺失 | — | P0LLM Cycle 扩展) |
| Provider 注册发现 | ❌ 缺失 | — | P0Provider 接口扩展) |
| 流式事件系统 | ❌ 缺失 | — | P0(流式接口前置) |
| 生命周期钩子 | ✅ 完整 | `docs/3-phase0-remaining.md` | P0LLM Cycle 扩展) |
| Provider 注册发现 | ✅ 完整 | `docs/3-phase0-remaining.md` | P0Provider 接口扩展) |
| 流式事件系统 | ✅ 完整 | `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,避免边实现边设计
@@ -177,3 +181,6 @@ 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
**已完成阶段**
- ✅ Phase 0 Foundation — 全部交付物已完成