# torres-ide

**Repository Path**: torres_c/torres-ide

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-25
- **Last Updated**: 2025-11-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Torres IDE - 在线Python编译器

一个现代化的在线Python编译器，支持实时代码执行和结果输出。

## 功能特性

- 🎨 现代化UI设计，深色主题
- ✏️ Monaco编辑器（VS Code同款）
- ⚡ 实时代码执行
- 🔒 安全的沙箱执行环境
- ⏱️ 5秒执行超时保护
- 📊 实时输出显示

## 技术栈

- **前端**: React + Monaco Editor
- **后端**: Node.js + Express
- **执行环境**: Python 3
- **容器化**: Docker

## 快速开始

### 本地开发

#### 1. 安装依赖

```bash
# 后端
cd backend
npm install

# 前端
cd ../frontend
npm install
```

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

```bash
cd backend
npm run dev
```

后端将运行在 `http://localhost:5000`

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

在新的终端窗口：

```bash
cd frontend
npm start
```

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

### Docker部署

```bash
docker-compose up --build
```

访问 `http://localhost:3000`

## 项目结构

```
torres-ide/
├── backend/
│   ├── server.js          # Express服务器
│   ├── executor.js        # Python执行器
│   ├── package.json
│   ├── .env
│   └── Dockerfile
├── frontend/
│   ├── src/
│   │   ├── App.js         # 主应用组件
│   │   ├── App.css        # 样式
│   │   └── index.js
│   ├── public/
│   │   └── index.html
│   ├── package.json
│   └── Dockerfile
├── docker-compose.yml
└── README.md
```

## API文档

### 执行Python代码

**请求:**
```
POST /api/execute
Content-Type: application/json

{
  "code": "print('Hello, World!')"
}
```

**响应:**
```json
{
  "success": true,
  "output": "Hello, World!\n",
  "error": ""
}
```

### 健康检查

```
GET /api/health
```

## 配置

### 后端环境变量 (.env)

```
PORT=5000
NODE_ENV=development
```

### 前端环境变量

```
REACT_APP_API_URL=http://localhost:5000
```

## 安全特性

- ⏱️ 5秒执行超时
- 📏 10KB输出限制
- 🔒 临时文件自动清理
- 🛡️ 错误隔离

## 扩展功能建议

- [ ] 代码保存/加载功能
- [ ] 代码分享链接
- [ ] 执行历史记录
- [ ] 多语言支持（JavaScript、Java等）
- [ ] 代码格式化
- [ ] 主题切换
- [ ] 用户认证系统

## 故障排除

### 后端无法连接

确保后端服务正在运行：
```bash
curl http://localhost:5000/api/health
```

### Python不可用

确保系统已安装Python 3：
```bash
python3 --version
```

## 许可证

MIT