# GA

**Repository Path**: umb/ga

## Basic Information

- **Project Name**: GA
- **Description**: GenericAgent 是一个极简、可自我进化的自主 Agent 框架。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-22
- **Last Updated**: 2026-05-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# GenericAgent Rust (ga_rs)

GenericAgent 的 Rust 复刻版本，遵循超内核设计哲学。

## 快速开始

```bash
# 设置 API Key
export OPENAI_API_KEY="your-key-here"

# 构建并运行
cargo run "创建一个 Rust 的 Hello World 程序"

# 使用 TUI 界面
cargo run -- --tui "分析当前目录结构"
```

## 文档索引

- [入门指南](docs/getting-started.md) - 完整的使用教程和开发指南
- [设计方案](.claude/plans/plan-genericagent-rust-redesign.md) - 详细的设计架构说明

## 项目结构

```
ga_rs/
├── Cargo.toml
├── assets/
│   ├── tools_schema.json    # 工具定义
│   └── sys_prompt.txt       # 系统提示词
├── memory/                  # L0-L4 记忆目录
│   ├── global_mem.txt       # L0: Meta SOP
│   ├── global_mem_insight.txt # L1: Global Insight
│   ├── global_facts.txt     # L2: Global Facts
│   ├── *.md / *.py / *.rs   # L3: Skills
│   └── L4_raw_sessions/     # L4: 原始会话历史
└── src/
    ├── main.rs              # 入口
    ├── agentmain.rs         # 装配与启动
    ├── agent_loop.rs        # 极薄的主循环
    ├── ga.rs                # 大内核（所有工具实现）
    ├── handler.rs           # Handler 结构体
    ├── llm.rs               # LLM 流式交互
    ├── memory.rs            # L0-L4 文件协议
    ├── plugin.rs            # 插件系统
    ├── tm_webdriver.rs      # 浏览器控制
    ├── types.rs             # 共享类型
    └── frontends/mod.rs     # CLI/TUI 前端
```

## 设计哲学

1. **极少核心文件** — 不是多层架构，而是 3-4 个核心文件
2. **单中心控制流** — `Handler` 集中所有工具能力
3. **动态分发优先** — `match` 而非 trait 抽象
4. **文件系统即知识** — memory 保持 L0-L4 目录协议

## 使用方法

### 设置环境变量

```bash
# 必需
export OPENAI_API_KEY="your-key-here"
# 或
export ANTHROPIC_API_KEY="your-key-here"

# 可选
export LLM_BASE_URL="https://api.openai.com/v1"
export LLM_MODEL="gpt-4"
```

### 运行

```bash
cd ga_rs
cargo run "你的任务描述"
```

## 可用工具

- `code_run` — 执行代码（python, rust, bash）
- `file_read` — 读取文件
- `file_write` — 写入文件
- `file_patch` — 补丁修改文件
- `ask_user` — 询问用户
- `update_working_checkpoint` — 更新工作检查点
- `web_scan` — 扫描网页
- `web_execute_js` — 在浏览器执行 JavaScript
- `bad_json` — 处理解析失败的 JSON

## 开发计划

- [x] P0: MVP 骨架（核心闭环）
- [x] P1: 浏览器与 Schema
- [x] P2: 插件与前端

## 参考

- 设计方案详见 `.claude/plans/plan-genericagent-rust-redesign.md`