# GN

**Repository Path**: umb/gn

## Basic Information

- **Project Name**: GN
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-25
- **Last Updated**: 2026-06-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GenericAgent Rust 实现 — 学习方案总览

> 本目录包含完整的 Rust 实现 GenericAgent 学习方案

---

## 文件说明

| 文件 | 内容 | 用途 |
|------|------|------|
| `learning-plan.md` | 完整学习方案 | 了解整体架构和学习路线 |
| `module-details.md` | 各模块详细说明 | 深入理解每个模块的实现 |
| `weekly-plan.md` | 按周学习计划 | 安排学习进度 |
| `cargo-toml-reference.md` | Cargo.toml 参考 | 项目依赖配置 |
| `faq.md` | 常见问题与解决方案 | Python → Rust 迁移指南 |
| `mvp-guide.md` | 最小可运行版本指南 | 快速上手，2-3 周出成果 |

---

## 快速开始

### 1. 了解项目（第 1 天）
阅读 `learning-plan.md`，了解：
- GenericAgent 是什么
- 核心架构（9 个工具 + Agent Loop）
- Rust 实现的整体规划

### 2. 制定计划（第 2 天）
阅读 `weekly-plan.md`，根据自己的时间制定计划：
- 每天能投入多少时间？
- 希望多久看到成果？
- 重点关注哪些功能？

### 3. 快速上手（第 3-7 天）
按照 `mvp-guide.md` 实现最小可运行版本：
- 搭建 Rust 环境
- 实现核心类型
- 实现文件操作工具
- 接入 Claude API
- 完成 CLI 交互

### 4. 深入学习（第 2 周起）
参考 `module-details.md` 逐个模块深入：
- 每个模块的 Python 原代码分析
- Rust 实现思路和代码示例
- 关键设计决策

### 5. 遇到问题
查阅 `faq.md`：
- Python → Rust 类型映射
- 常见错误和解决方案
- 最佳实践

### 6. 配置项目
参考 `cargo-toml-reference.md`：
- 了解需要的依赖
- 配置 Cargo.toml

---

## 学习路径推荐

### 路径 A：快速出成果（推荐初学者）
1. 阅读 `learning-plan.md`（了解架构）
2. 阅读 `mvp-guide.md`（快速上手）
3. 按 `mvp-guide.md` 实现 MVP
4. 参考 `module-details.md` 逐步扩展功能

### 路径 B：系统学习（推荐有 Rust 基础者）
1. 阅读 `learning-plan.md`（了解架构）
2. 阅读 `module-details.md`（深入每个模块）
3. 按 `weekly-plan.md` 安排进度
4. 参考 `faq.md` 解决迁移问题

### 路径 C：按需查阅（推荐已有项目经验者）
- 需要了解整体架构 → `learning-plan.md`
- 需要实现具体模块 → `module-details.md`
- 遇到 Rust 问题 → `faq.md`
- 需要配置依赖 → `cargo-toml-reference.md`

---

## 项目结构预览

```
generic-agent-rs/           # Rust 实现目标结构
├── Cargo.toml
├── src/
│   ├── main.rs              # CLI 入口
│   ├── lib.rs               # 库入口
│   ├── agent_loop.rs        # 核心循环 (~100行)
│   ├── agent.rs             # Agent 主类
│   ├── types.rs             # 共享类型
│   ├── error.rs             # 错误类型
│   ├── tools/               # 9个原子工具
│   │   ├── mod.rs
│   │   ├── code_run.rs
│   │   ├── file_ops.rs
│   │   ├── web_tools.rs
│   │   └── memory_tools.rs
│   ├── llm/                 # LLM 客户端
│   │   ├── mod.rs
│   │   ├── claude.rs
│   │   ├── openai.rs
│   │   └── mixin.rs
│   ├── webdriver.rs         # TMWebDriver
│   ├── simphtml.rs          # HTML 简化
│   ├── memory/              # 记忆系统
│   ├── frontends/           # 前端界面
│   ├── reflect/             # 反射模式
│   └── plugins/             # 插件系统
└── tests/
```

---

## 时间估算

| 阶段 | 内容 | 时间 | 参考文档 |
|------|------|------|---------|
| 准备 | Rust 基础学习 | 1-2 周 | `weekly-plan.md` 阶段 0 |
| MVP | 最小可运行版本 | 1-2 周 | `mvp-guide.md` |
| 核心 | Agent Loop + 工具 | 2-3 周 | `module-details.md` 第1-2章 |
| LLM | 多模型支持 | 2-3 周 | `module-details.md` 第3章 |
| Web | 浏览器控制 | 2-3 周 | `module-details.md` 第4章 |
| 记忆 | 分层记忆 | 2-3 周 | `module-details.md` 第5章 |
| 前端 | CLI + TUI | 2-3 周 | `module-details.md` 第6章 |
| 高级 | 反射 + 插件 | 2-3 周 | `module-details.md` 第7-8章 |
| 收尾 | 测试 + 文档 | 2-3 周 | `weekly-plan.md` 阶段 9 |
| **总计** | | **约 20-30 周** | |

---

## 重要提示

1. **不要试图一次实现所有功能** — 按 MVP → 核心 → 扩展的顺序来
2. **先理解 Python 原版再写 Rust** — 不要边看边写
3. **测试驱动** — 每实现一个功能就写测试
4. **及时记录** — 遇到问题记录到笔记中
5. **善用社区** — Rust 社区很友好，遇到问题多搜索

---

## 联系方式

- GenericAgent 原项目：https://github.com/lsdefine/GenericAgent
- 技术报告：https://arxiv.org/abs/2604.17091
- 教程：https://datawhalechina.github.io/hello-generic-agent/

---

> 祝学习愉快！Rust 的学习曲线较陡，但一旦掌握，你将获得极高的性能和安全性。