# cloud_ai_pc

**Repository Path**: sky92archangel/cloud_ai_pc

## Basic Information

- **Project Name**: cloud_ai_pc
- **Description**: 文档级云上PC，
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-14
- **Last Updated**: 2026-04-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cloud PC

云端开发环境 - 一个基于 Web 的云端代码编辑和执行平台

## 项目简介

Cloud PC 是一个现代化的云端开发环境，支持：
- 用户注册和登录
- 云端文件管理（上传、下载、创建文件夹）
- 在线代码编辑（支持多种语言）
- 代码执行（Python）
- AI Agent 辅助编程

## 技术栈

### 后端
- **FastAPI** - 现代高性能 Web 框架
- **SQLAlchemy** - ORM
- **SQLite** - 轻量级数据库
- **Pydantic** - 数据验证

### 前端
- **React 18** - UI 框架
- **Vite** - 构建工具
- **Tailwind CSS** - 样式框架
- **Monaco Editor** - 代码编辑器
- **Zustand** - 状态管理
- **React Router** - 路由管理

## 项目结构

```
cloud_ai_pc/
├── src/
│   ├── backend/           # FastAPI 后端
│   │   ├── app/
│   │   │   ├── api/       # API 路由
│   │   │   ├── core/      # 核心配置
│   │   │   ├── models/    # 数据模型
│   │   │   ├── schemas/   # Pydantic 模型
│   │   │   ├── services/  # 业务逻辑
│   │   │   └── utils/     # 工具函数
│   │   ├── tests/         # 测试
│   │   └── requirements.txt
│   │
│   └── frontend/          # React 前端
│       ├── src/
│       │   ├── components/# 组件
│       │   ├── pages/     # 页面
│       │   ├── stores/    # 状态管理
│       │   ├── services/  # API 服务
│       │   └── utils/     # 工具函数
│       └── package.json
│
├── docs/                  # 文档
└── .gitignore
```

## 快速开始

### 前置要求

- Python 3.10+
- Node.js 18+
- npm 或 yarn

### 后端设置

```bash
cd src/backend

# 创建虚拟环境
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或
venv\Scripts\activate     # Windows

# 安装依赖
pip install -r requirements.txt

# 复制环境配置
cp .env.example .env

# 启动服务器
uvicorn app.main:app --reload
```

后端将在 http://localhost:8000 运行

API 文档：http://localhost:8000/docs

### 前端设置

```bash
cd src/frontend

# 安装依赖
npm install

# 启动开发服务器
npm run dev
```

前端将在 http://localhost:3000 运行

### Docker 部署（可选）

```bash
cd src/backend

# 使用 Docker Compose 启动
docker-compose up -d
```

## 功能特性

### 用户系统
- 用户注册/登录
- JWT 认证
- 密码加密存储

### 文件管理
- 文件树导航
- 文件上传（支持大文件分片上传）
- 文件夹创建
- 文件预览和编辑

### 代码编辑
- Monaco Editor 集成
- 语法高亮
- 多语言支持（Python, JavaScript, TypeScript 等）

### 代码执行
- Python 代码在线执行
- 实时输出流
- 执行结果展示

### AI Agent
- 基于 LangChain 的 AI 助手
- 自然语言处理
- 代码生成辅助

## API 端点

### 认证
- `POST /api/v1/auth/register` - 用户注册
- `POST /api/v1/auth/login` - 用户登录

### 文件
- `GET /api/v1/files/` - 获取文件列表
- `POST /api/v1/files/upload` - 上传文件
- `DELETE /api/v1/files/{id}` - 删除文件

### 执行
- `POST /api/v1/execute` - 执行代码

### Agent
- `POST /api/v1/agent/chat` - AI 对话

## 开发指南

### 运行测试

```bash
cd src/backend
pytest
```

### 代码规范

- 后端遵循 PEP 8
- 前端使用 ESLint + Prettier

## 许可证

MIT License