system-v 全量重写项目文档

从 0 到 1 完整重写 agno Python AI agent framework 为 Rust

项目规模

维度	agno (Python)	system-v (Rust)	完成度
代码量	303,196 行	3,902 行	~1.3%
顶级模块	34 个	4 个 crate	11.8%
模型提供商	42 个	0 个	0%
工具集成	141 个	0 个	0%
向量数据库	18 个	1 个	5.6%
存储后端	13 个	0 个	0%

文档结构

docs/
├── README.md                          # 本文件 — 项目总览
├── agno-analysis/                     # agno 源码分析
│   ├── overview.md                    # agno 整体架构
│   ├── agent.md                       # Agent 系统深度分析
│   ├── models.md                      # 42 个模型提供商分析
│   ├── tools.md                       # 141 个工具系统分析
│   ├── knowledge.md                   # 知识系统分析
│   ├── orchestration.md               # 编排系统分析（Team/Workflow）
│   ├── persistence.md                 # 持久化系统分析
│   ├── scheduler.md                   # 调度系统分析
│   ├── server.md                      # API 服务器分析
│   └── extensions.md                  # 扩展系统分析
├── plans/                             # 项目看板（按模块拆分）
│   ├── README.md                      # 看板总览和进度
│   ├── phase-01-foundation.md         # 基础设施（已完成）
│   ├── phase-02-common-types.md       # 通用类型与基础设施
│   ├── phase-03-agent.md              # Agent 核心
│   ├── phase-04-models.md             # 42 个模型提供商
│   ├── phase-05-tools.md              # 141 个工具系统
│   ├── phase-06-knowledge.md          # 知识系统
│   ├── phase-07-orchestration.md      # 编排系统
│   ├── phase-08-persistence.md        # 持久化系统
│   ├── phase-09-scheduler.md          # 调度系统
│   ├── phase-10-extensions.md         # 扩展系统
│   ├── phase-11-server.md             # API 服务器
│   ├── phase-12-utils.md              # 50+ 工具库模块
│   ├── phase-13-integrations.md       # 平台集成
│   └── phase-14-polish.md             # 发布准备
└── gap-analysis.md                    # 差距分析

优先级分层

优先级	Phase	内容	状态
P0	1-3	基础设施 + 通用类型 + Agent 核心	Phase 1 完成
P1	4-6	模型 + 工具 + 知识	待开始
P2	7-9	编排 + 持久化 + 调度	待开始
P3	10-13	扩展 + 服务器 + 工具库 + 集成	待开始
P4	14	发布准备	待开始

依赖关系

Phase 1 (基础设施)
  └─→ Phase 2 (通用类型)
       └─→ Phase 3 (Agent 核心)
            ├─→ Phase 4 (模型提供商)
            ├─→ Phase 5 (工具系统)
            └─→ Phase 6 (知识系统)
                 └─→ Phase 7 (编排系统)
                      ├─→ Phase 8 (持久化系统)
                      ├─→ Phase 9 (调度系统)
                      └─→ Phase 10 (扩展系统)
                           └─→ Phase 11 (API 服务器)
                                ├─→ Phase 12 (工具库)
                                └─→ Phase 13 (平台集成)
                                     └─→ Phase 14 (发布准备)

技术栈

• 语言: Rust (edition 2021)
• 异步运行时: tokio
• LLM 抽象层: rig-core (vendored)
• Web 框架: axum (计划)
• 序列化: serde + serde_json
• 构建: Cargo workspace (4 crates)
• 测试: 内置 test framework + 89 个测试

快速开始

# 构建
cargo build --workspace

# 测试
cargo test --workspace

# 代码检查
cargo clippy --workspace

# 运行示例
cargo run --example basic_agent -p system-v-core