# knowledge-devolop-agent

**Repository Path**: guchenglin/knowledge-devolop-agent

## Basic Information

- **Project Name**: knowledge-devolop-agent
- **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-01-12
- **Last Updated**: 2026-01-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CourseFlow SuperAgent

AI驱动的智能课程制作助手，使用大语言模型（LLM）自动生成课程内容。

## 项目概述

CourseFlow 是一个基于 AI 的课程制作平台，通过对话式交互帮助用户快速创建高质量的课程内容。

### 核心功能

- **智能模式**：Plan模式、AskMe模式（MVP阶段）
- **超级提示词代理**：需求澄清对话流程
- **MCP工具集**：文档处理、内容生成、大纲生成
- **对话式界面**：自然语言交互，实时反馈

## 技术栈

### 前端
- React 18+ + TypeScript
- Vite (构建工具)
- Tailwind CSS + shadcn/ui
- Zustand + React Query
- React Router v6

### 后端
- FastAPI (Python 3.11+)
- PostgreSQL + SQLAlchemy (异步)
- Redis
- OpenAI API
- Celery (异步任务)

## 项目结构

```
.
├── frontend/          # 前端应用
│   ├── src/
│   │   ├── components/   # 组件
│   │   ├── pages/        # 页面
│   │   ├── stores/       # 状态管理
│   │   ├── services/     # API服务
│   │   └── types/        # 类型定义
│   └── package.json
├── backend/           # 后端应用
│   ├── app/
│   │   ├── api/          # API路由
│   │   ├── domain/       # 领域层
│   │   ├── application/  # 应用层
│   │   ├── infrastructure/ # 基础设施层
│   │   └── core/         # 核心配置
│   └── requirements.txt
└── docker-compose.yml
```

## 快速开始

### 前置要求

- Node.js 18+
- Python 3.11+
- Docker & Docker Compose
- PostgreSQL 15+ (或使用Docker)
- Redis 7+ (或使用Docker)

### 安装步骤

#### 1. 克隆项目

```bash
git clone <repository-url>
cd knowledge-devolop-agent
```

#### 2. 启动数据库和Redis

```bash
cd backend
docker-compose up -d
```

#### 3. 配置后端

```bash
cd backend
cp .env.example .env
# 编辑 .env 文件，配置数据库和API密钥
```

#### 4. 安装后端依赖

```bash
cd backend
pip install -r requirements.txt
```

#### 5. 运行数据库迁移

```bash
cd backend
alembic upgrade head
```

#### 6. 启动后端服务

```bash
cd backend
uvicorn app.main:app --reload
```

后端API将在 http://localhost:8000 启动

#### 7. 安装前端依赖

```bash
cd frontend
npm install
```

#### 8. 启动前端服务

```bash
cd frontend
npm run dev
```

前端应用将在 http://localhost:3000 启动

## 开发指南

### 前端开发

详细说明见 [frontend/README.md](./frontend/README.md)

### 后端开发

详细说明见 [backend/README.md](./backend/README.md)

### 架构设计

本项目遵循 Clean Architecture 分层架构：

- **Domain Layer**: 业务实体和业务逻辑
- **Application Layer**: 用例和服务
- **Infrastructure Layer**: 外部服务实现
- **Presentation Layer**: API路由和DTO

## 环境变量

### 后端环境变量

见 `backend/.env.example`

主要配置项：
- `DATABASE_URL`: PostgreSQL连接字符串
  - 开发环境：`postgresql+asyncpg://postgres:postgres@localhost:5432/courseflow`
  - Docker环境：`postgresql+asyncpg://postgres:postgres@postgres:5432/courseflow`
- `REDIS_URL`: Redis连接字符串
- `OPENAI_API_KEY`: OpenAI API密钥
- `SECRET_KEY`: JWT密钥

### 数据库连接诊断

如果遇到数据不一致问题，可以使用以下工具诊断：

1. **诊断脚本**：
   ```powershell
   # Windows
   .\scripts\diagnose_database.ps1
   
   # Linux/Mac
   ./scripts/diagnose_database.sh
   ```

2. **诊断接口**：
   ```bash
   # 检查后端实际连接的数据库
   curl http://localhost:8001/api/diagnosis/database
   ```

详细说明见 [数据库访问指南](./docs/DATABASE_ACCESS.md) 和 [数据源统一配置指南](./docs/DATABASE_SOURCE_UNIFICATION.md)

## 测试

### 前端测试

```bash
cd frontend
npm run test
```

### 后端测试

```bash
cd backend
pytest
```

## 部署

### Docker部署

```bash
docker-compose up -d
```

### 生产环境配置

1. 更新环境变量
2. 配置Nginx反向代理
3. 设置SSL证书
4. 配置数据库备份

## 贡献指南

1. Fork 项目
2. 创建功能分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启 Pull Request

## 许可证

[添加许可证信息]

## 联系方式

[添加联系方式]