refactor(core): 完成 v0.3.2 Cargo features 拆分基础设施
- 定义 16 个 features + 4 个快捷组合，default = ["full"] 保持向后兼容 - 12 个重型依赖 optional 化（tokio/reqwest/rusqlite 等） - 全模块 #[cfg(feature)] 门控注入（llm/tools/memory/agent/engine） - 将 LlmProvider trait 及关联类型移出 provider 模块归属 llm（ADR-1） - 为 session.rs bundle() 方法添加 engine feature 门控 - 更新 12 个内部文件 + 4 个示例文件的 import 路径 - 向后兼容：provider.rs 保留 pub use 重导出老路径
This commit is contained in:
徐涛
+18
-18
@@ -1,10 +1,12 @@
|
||||
# AG Core Roadmap — v0.3.2
|
||||
|
||||
**状态**：⏳ 全部待实施
|
||||
**状态**：✅ Phase 20-25 已交付（Step 1 合并实施）；⏳ Phase 26-27 待实施
|
||||
|
||||
> 本文件聚焦 **v0.3.2 版本** 的规划与交付（Phase 20–27）。
|
||||
> 返回总入口：[`roadmap.md`](./roadmap.md)
|
||||
|
||||
> **进度更新（2026-07-19）**：Step 1 合并完成 Phase 20（Cargo.toml features 定义 + 依赖 optional 化）+ Phase 21-25 的全部 cfg 门控（因编译阻塞提前）。验证矩阵 14 条编译命令全部通过，`cargo test -F full` 427 passed。实施方案见 [`docs/26-step1-phase20-cargo-features-implementation.md`](./26-step1-phase20-cargo-features-implementation.md)。下一步：Phase 26（CI 测试矩阵）+ Phase 27（文档更新）。
|
||||
|
||||
## v0.3.2 愿景
|
||||
|
||||
通过 Cargo features 拆分，让下游按需选择模块，跳过不需要的编译单元和重型依赖。
|
||||
@@ -77,8 +79,8 @@
|
||||
|
||||
| Step | Phase | 内容 | 验证方式 | 预估行数 |
|
||||
|------|-------|------|---------|---------|
|
||||
| **Step 1** | Phase 20 | Cargo.toml features 定义 + 依赖 optional 化 | `cargo build --no-default-features` + `cargo build --features "full"` | ~40 |
|
||||
| **Step 2** | Phase 21–25 | 全模块 cfg 门控注入（按依赖顺序批量操作） | 逐个 feature 组合增量编译验证 | ~180 |
|
||||
| **Step 1** ✅ | Phase 20-25 | Cargo.toml features 定义 + 依赖 optional 化 + 全模块 cfg 门控（合并实施） | 14 条编译验证全通过 + `cargo test -F full` 427 passed | ~100 |
|
||||
| **Step 2** | （已合并至 Step 1） | — | — | — |
|
||||
| **Step 3** | Phase 26 | 测试矩阵验证 + 修复 cfg 遗漏 | 7 种组合全部测试通过 | ~10 |
|
||||
| **Step 4** | Phase 27 | README + 示例标注 + 总入口同步 | review 通过 | ~100 |
|
||||
|
||||
@@ -103,7 +105,7 @@
|
||||
**依赖**：无（Cargo.toml 独立改造）
|
||||
**优先级**：P0
|
||||
**预估规模**：约 40 行
|
||||
**状态**：⏳ 待实施
|
||||
**状态**：✅ 已交付（2026-07-19）— features 定义 + 依赖 optional 化 + tokio features 拆细（含 `rt-multi-thread` 修正）
|
||||
|
||||
---
|
||||
|
||||
@@ -121,7 +123,7 @@
|
||||
**依赖**：Phase 20（需 feature 定义就绪）
|
||||
**优先级**：P0
|
||||
**预估规模**：约 30 行
|
||||
**状态**：⏳ 待实施
|
||||
**状态**：✅ 已交付（2026-07-19，Step 1 合并）— `src/lib.rs` 全部 `pub mod` + `pub use Document` 门控完成
|
||||
|
||||
---
|
||||
|
||||
@@ -142,7 +144,7 @@
|
||||
**依赖**：Phase 20 + Phase 21
|
||||
**优先级**：P0
|
||||
**预估规模**：约 80 行（中复杂度，cycle.rs 门控需精确隔离）
|
||||
**状态**：⏳ 待实施
|
||||
**状态**：✅ 已交付（2026-07-19，Step 1 合并）— `src/llm.rs` 子模块按 llm-types/llm/provider 三类门控；`cycle.rs` 中 `ToolRegistry` import + `submit_with_tools` / `submit_with_tools_stream` / `run_tool_loop` 加 `#[cfg(feature = "tools")]`（Phase 22.7 提前）
|
||||
|
||||
---
|
||||
|
||||
@@ -159,7 +161,7 @@
|
||||
**依赖**：Phase 20 + Phase 21
|
||||
**优先级**：P0
|
||||
**预估规模**：约 20 行
|
||||
**状态**：⏳ 待实施
|
||||
**状态**：✅ 已交付（2026-07-19，Step 1 合并）— `src/tools.rs` 中 `pub mod mcp` + `pub use mcp::*` 加 `#[cfg(feature = "tools-mcp")]`
|
||||
|
||||
---
|
||||
|
||||
@@ -177,7 +179,7 @@
|
||||
**依赖**：Phase 20 + Phase 21
|
||||
**优先级**：P0
|
||||
**预估规模**：约 30 行
|
||||
**状态**：⏳ 待实施
|
||||
**状态**：✅ 部分交付（2026-07-19，Step 1 合并）— Phase 24.3（`sqlite_store` 模块门控）+ Phase 24.4（`pub use SqliteStore` 门控）已完成；Phase 24.1（memory 模块 pub use）由 `src/lib.rs` 的 `#[cfg(feature = "memory")]` 覆盖；Phase 24.2（vector_store 中 Embedding 引用隔离）待 Phase 26 验证时按需补充
|
||||
|
||||
---
|
||||
|
||||
@@ -194,7 +196,7 @@
|
||||
**依赖**：Phase 20-24（全链路依赖就绪后操作）
|
||||
**优先级**：P0
|
||||
**预估规模**：约 20 行
|
||||
**状态**：⏳ 待实施
|
||||
**状态**：✅ 部分交付（2026-07-19，Step 1 合并）— Phase 25.3（`src/lib.rs` 中 agent/engine 模块声明 cfg）已完成；Phase 25.1/25.2（agent/engine 内部子模块条件导出）由 `src/lib.rs` 顶层门控覆盖；`src/agent/session.rs` 中 engine 相关 import + `to_snapshot` / `from_snapshot` / `restore_memory` / `has_pending_memory_restore` + `pending_memory_restore` 字段加 `#[cfg(feature = "engine")]`（阻塞 B3 修复）
|
||||
|
||||
---
|
||||
|
||||
@@ -290,21 +292,19 @@ graph TD
|
||||
classDef pending fill:#fbbf24,stroke:#d97706,color:#1a1a1a
|
||||
classDef provider fill:#93c5fd,stroke:#2563eb,color:#1a1a1a
|
||||
class P_OPENAI,P_ANTHROPIC,P_DEEPSEEK,P_QWEN,P_OLLAMA provider
|
||||
class FULL pending
|
||||
class ENGINE,AGENT,LLM,TOOLS,TOOLS_MCP,MEMORY,MEMORY_SQLITE,PROMPT,LLM_TYPES,DOCUMENT pending
|
||||
class LIGHT,CHAT,MULTI pending
|
||||
class FULL,ENGINE,AGENT,LLM,TOOLS,TOOLS_MCP,MEMORY,MEMORY_SQLITE,PROMPT,LLM_TYPES,DOCUMENT,LIGHT,CHAT,MULTI done
|
||||
```
|
||||
|
||||
## 关键里程碑
|
||||
|
||||
| 里程碑 | Phase 完成条件 | 可验证指标 | 状态 |
|
||||
|--------|---------------|-----------|------|
|
||||
| **M16** | Phase 20 | `cargo build --no-default-features` 成功；`cargo build --features "full"` 与原行为一致 | ⏳ |
|
||||
| **M17** | Phase 21 | 三种零依赖模块各自独立编译通过 | ⏳ |
|
||||
| **M18** | Phase 22 | 5 个 provider 各自单独编译；cycle.rs 无 tools 时编译通过 | ⏳ |
|
||||
| **M19** | Phase 23 | tools 不含 mcp 编译通过；加 tools-mcp 引入 McpClient | ⏳ |
|
||||
| **M20** | Phase 24 | memory 不含 llm/sqlite 编译通过；加 memory-sqlite 引入 SqliteStore | ⏳ |
|
||||
| **M21** | Phase 25 | agent + engine 全链路门控编译通过 | ⏳ |
|
||||
| **M16** | Phase 20 | `cargo build --no-default-features` 成功；`cargo build --features "full"` 与原行为一致 | ✅ 2026-07-19 |
|
||||
| **M17** | Phase 21 | 三种零依赖模块各自独立编译通过 | ✅ 2026-07-19（Step 1 合并） |
|
||||
| **M18** | Phase 22 | 5 个 provider 各自单独编译；cycle.rs 无 tools 时编译通过 | ✅ 2026-07-19（Step 1 合并） |
|
||||
| **M19** | Phase 23 | tools 不含 mcp 编译通过；加 tools-mcp 引入 McpClient | ✅ 2026-07-19（Step 1 合并） |
|
||||
| **M20** | Phase 24 | memory 不含 llm/sqlite 编译通过；加 memory-sqlite 引入 SqliteStore | ✅ 2026-07-19（Step 1 合并） |
|
||||
| **M21** | Phase 25 | agent + engine 全链路门控编译通过 | ✅ 2026-07-19（Step 1 合并） |
|
||||
| **M22** | Phase 26 | 7 种 CI 组合全部编译 + 测试通过；clippy --all-features 0 警告 | ⏳ |
|
||||
| **M23** | Phase 27 | 文档 review 通过 | ⏳ |
|
||||
|
||||
|
||||
Reference in New Issue
Block a user