# python-online-ide

**Repository Path**: pythonxueba/python-online-ide

## Basic Information

- **Project Name**: python-online-ide
- **Description**: 一个功能强大的Python在线编辑器，支持多文件编辑、AI辅助、实时运行和代码调试
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-22
- **Last Updated**: 2026-01-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Python Online IDE

一个功能强大的Python在线编辑器，支持多文件编辑、AI辅助、实时运行和代码调试。

## 功能特性

### 核心功能
- **多标签页编辑器** - 支持同时打开多个Python文件
- **实时代码运行** - 基于Flask后端，支持Python代码实时执行
- **AI辅助编程** - 集成NVIDIA NIM AI模型，提供代码补全、错误修复和智能问答
- **语法高亮** - 使用CodeMirror 6编辑器，支持Python语法高亮
- **智能格式化** - 自动格式化Python代码

### AI功能
- **AI Fix** - 一键修复代码错误
- **AI Chat** - 智能问答，提供编程帮助
- **代码补全** - 自动补全代码片段
- **多模型支持** - 支持GLM-4.7、Gemma-2、Llama-3等多种大语言模型

### 编辑器功能
- **撤销/重做** - 支持Ctrl+Z/Ctrl+Y快捷键
- **新建文件** - 快速创建新的Python文件
- **文件管理** - 支持关闭、切换多个文件
- **快捷键** - Ctrl+Enter运行代码，Ctrl+/切换注释

### 控制台
- **实时输出** - 流式显示代码执行结果
- **错误显示** - 清晰的错误提示和错误计数
- **ANSI颜色支持** - 支持colored terminal输出
- **日志管理** - 自动保存和加载执行日志

## 技术栈

### 前端
- **React 18** - 用户界面框架
- **CodeMirror 6** - 代码编辑器
- **Tailwind CSS** - UI样式框架
- **Lucide Icons** - 图标库
- **Marked.js** - Markdown渲染
- **highlight.js** - 代码高亮

### 后端
- **Flask 3.0** - Web框架
- **Python 3.12** - 运行环境
- **subprocess** - 进程管理
- **SSE** - 流式输出

### AI集成
- **NVIDIA NIM** - 大语言模型API
- **GLM-4.7** - 智谱AI模型
- **Gemma-2** - Google模型
- **Llama-3** - Meta模型

## 快速开始

### 环境要求
- Python 3.12+
- pip包管理器

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

### 运行项目
```bash
python app.py
```

访问 http://localhost:5000 即可使用。

## 项目结构

```
.
├── app.py                  # Flask后端主程序
├── templates/
│   └── index.html         # 前端页面（包含React代码）
├── requirements.txt        # Python依赖
├── .coze                  # 项目配置
└── README.md             # 项目文档
```

## 主要API端点

### 代码执行
- `POST /api/run` - 执行Python代码
- 支持流式输出（SSE）

### AI功能
- `POST /api/ai/fix` - AI修复错误
- `POST /api/ai/chat` - AI对话

## 使用说明

### 1. 编辑代码
- 点击编辑器区域开始编写Python代码
- 支持多标签页，可以同时编辑多个文件
- 使用快捷键提高效率：
  - `Ctrl+Enter` - 运行代码
  - `Ctrl+Z` - 撤销
  - `Ctrl+Y` - 重做
  - `Ctrl+/` - 切换注释

### 2. 运行代码
- 点击"Run"按钮或按`Ctrl+Enter`运行代码
- 切换到"Console"标签页查看输出
- 支持实时显示执行结果

### 3. AI辅助
- **AI Fix**: 当代码出错时，点击"AI Fix"按钮自动修复
- **AI Chat**: 在"AI"标签页中输入问题，获取AI帮助
- 支持Adopt和Run按钮快速应用AI生成的代码

### 4. 文件管理
- 点击工具栏的"+"按钮新建文件
- 点击文件标签上的"×"按钮关闭文件
- 所有文件自动保存到浏览器本地存储

## 配置说明

### AI配置
- 点击右上角设置按钮
- 输入NVIDIA NIM API密钥
- 选择AI模型（默认：google/gemma-2-27b-it）
- 配置会自动保存到浏览器

### 日志设置
- 支持自动滚动开关
- 日志自动保存到本地存储

## 浏览器兼容性

- Chrome 90+
- Firefox 88+
- Safari 14+
- Edge 90+

支持桌面和移动设备，提供优化的移动端体验。

## 注意事项

1. **API密钥安全** - AI API密钥仅保存在浏览器本地存储，不会上传到服务器
2. **代码执行** - 代码在服务器端沙箱环境中执行，确保安全
3. **数据持久化** - 编辑器内容和日志保存在浏览器，清除缓存会丢失数据

## 贡献指南

欢迎提交Issue和Pull Request！

## 许可证

MIT License

## 更新日志

### v1.0.0 (2024-01-21)
- 初始版本发布
- 支持多文件编辑
- 集成AI功能
- 优化移动端体验
- 修复键盘输入问题
- 优化日志显示

## 联系方式

- 作者：pythonxueba
- 项目地址：https://gitee.com/pythonxueba/python-online-ide

---

**Enjoy Coding! 🚀**