# lab

**Repository Path**: lab_6/lab

## Basic Information

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

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Lab - 实战教程与示例项目集合

本仓库包含两个独立的实战项目：

1. **Agent 开发实战** (`agent-lab/`) - 基于大语言模型的 Agent 开发教程
2. **Vue 3 与 React 19 对照学习** (`vue-react-lab/`) - 前端框架对比学习指南

---

## 1. Agent 开发实战 (agent-lab)

基于真实项目经验整理的 Agent 开发教程，包含从基础到生产的完整知识体系。

### 核心内容

| 模块 | 主题 | 关键知识点 |
|------|------|-----------|
| s1_no_loop.py | 基础认知 | 展示不带 Agent 循环时的典型局限性 |
| s2_tools.py | 工具定义 | 工具的 description 编写规范、参数格式示例 |
| s3_agent_loop.py | Agent 循环 | 单步/多步任务执行、错误自我修复 |
| s4_multi_tools.py | 多工具协作 | 沙盒安全、文件操作、工具组合使用 |
| s5_memory.py | 上下文管理 | 四种压缩策略、token 估算、外部记忆 |
| s6_react.py | ReAct 模式 | 规划与执行分离、自我批判机制 |
| s7_production.py | 生产级特性 | 权限控制、限额管理、注入防护、审计日志 |
| s8_rag.py | 检索增强 | 文档切分、BM25 检索、Agentic RAG |
| s9_multi_agent.py | 多Agent模式 | Router、Pipeline、并行汇总 |
| s10_project.py | 综合示例 | 持久记忆 + 知识库的完整助手实现 |

### 快速开始

```bash
cd agent-lab
pip install -r requirements.txt

# 运行单个演示模块
python s3_agent_loop.py

# 进入交互模式
python s3_agent_loop.py  # 某些模块支持交互模式
```

### 配套资源

- **AGENT_CHEATSHEET.md**: 开发速查表，包含常用模式和最佳实践
- **llm.py**: LLM 客户端封装，提供聊天、工具调用、流式输出等功能

---

## 2. Vue 3 与 React 19 对照学习 (vue-react-lab)

通过 Todo 应用对比学习 Vue 3 和 React 19 的语法差异与核心概念。

### 项目结构

```
vue-react-lab/
├── vue-todo/          # Vue 3 实现 (端口 5173)
│   ├── src/
│   │   ├── views/     # 页面组件
│   │   ├── components/# 可复用组件
│   │   ├── stores/    # Pinia 状态管理
│   │   └── router/    # Vue Router 配置
│   └── vite.config.js
│
├── react-todo/        # React 19 实现 (端口 5174)
│   ├── src/
│   │   ├── pages/     # 页面组件
│   │   ├── components/# 可复用组件
│   │   ├── contexts/  # React Context
│   │   └── hooks/     # 自定义 Hooks
│   └── vite.config.js
│
├── CHEATSHEHEET.md    # Vue → React 语法速查
└── README.md          # 学习指南
```

### 核心概念对照

| 功能 | Vue 3 | React 19 |
|------|-------|----------|
| 声明状态 | `ref` / `reactive` | `useState` |
| 修改状态 | 直接赋值 | `setState(newValue)` |
| 派生数据 | `computed` | `useMemo` |
| 副作用 | `watch` / `onMounted` | `useEffect` |
| 表单绑定 | `v-model` | 受控组件 |
| 列表渲染 | `v-for` | `map()` |
| 父子通信 | `props` + `emit` | props 回调 |
| 插槽 | `<slot>` | `children` prop |
| 跨层传递 | `provide` / `inject` | Context |
| 全局状态 | Pinia | Context + useReducer |

### 快速开始

```bash
cd vue-react-lab

# 安装依赖
cd vue-todo && npm install && cd ..
cd react-todo && npm install && cd ..

# 同时启动两个项目
# 终端 1: Vue 3
cd vue-todo && npm run dev

# 终端 2: React 19
cd react-todo && npm run dev
```

访问地址：
- Vue 3: http://localhost:5173
- React 19: http://localhost:5174

---

## 建议学习路径

### Agent 开发学习路径

1. **s1_no_loop.py** → 理解基础 LLM 的局限性
2. **s2_tools.py** → 掌握工具定义原则
3. **s3_agent_loop.py** → 理解 Agent 循环机制
4. **s4_multi_tools.py** → 学习工具协作与安全
5. **s5_memory.py** → 解决上下文膨胀问题
6. **s6_react.py** → 提升规划能力
7. **s7_production.py** → 生产环境必备特性
8. **s8_rag.py** / **s9_multi_agent.py** → 进阶主题

### 前端框架学习路径

1. 通读 **README.md** 了解整体差异
2. 对照 **CHEATSHEET.md** 边学边查
3. 同时运行两个 Todo 项目，对比实现
4. 重点关注模板语法、响应式、组件通信三部分

---

## 项目特色

### Agent Lab 特色

- ✅ 真实项目踩坑经验总结
- ✅ 每个模块都有独立演示 (`demo*_`)
- ✅ 支持交互模式，可自由探索
- ✅ 配套速查表，方便开发时快速查阅

### Vue-React Lab 特色

- ✅ 同一功能两框架对比实现
- ✅ 刻意埋入"真实项目才会遇到"的坑
- ✅ 覆盖大部分高频使用场景
- ✅ 代码检查已配置 (react-todo)

---

## 环境要求

- Python 3.10+ (agent-lab)
- Node.js 18+ (vue-react-lab)
- npm 或 pnpm

---

## 许可证

本项目仅供学习交流使用。