# python-learning

**Repository Path**: starry-sea-1412/python-learning

## Basic Information

- **Project Name**: python-learning
- **Description**: 交互式 Python 学习平台：课程、Playground、谜题、3D 知识星图与浏览器内 Python 运行时
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-06
- **Last Updated**: 2026-09-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Python, python3, React, nextjs

## README

# PyLearn · 交互式 Python 学习平台

[![CI](https://github.com/starry-sea-1412/python-learning/actions/workflows/ci.yml/badge.svg)](https://github.com/starry-sea-1412/python-learning/actions)
[![Gitee](https://img.shields.io/badge/Gitee-starry--sea--1412-red)](https://gitee.com/starry-sea-1412/python-learning)

![技术栈全景图](assets/tech-stack.png)

一个**完全在浏览器里运行**的 Python 学习平台:写代码、闯谜题、打代码对战、逛 3D 知识宇宙——不需要安装任何东西。

[English](#english) | 简体中文

## 📸 界面截图

| 首页 | 代码游乐场 | 课程目录 |
|------|-----------|----------|
| ![首页](assets/screenshots/01-home.png) | ![代码游乐场](assets/screenshots/02-playground.png) | ![课程](assets/screenshots/03-courses.png) |

## ✨ 核心特性

### 🐍 浏览器内 Python 运行时
- 基于 **Pyodide**(WebAssembly 版 Python),无需后端、无需安装
- **Playground**:即开即写的 Python 交互终端
- **可视化调试器**:单步执行、观察变量变化

### 📚 结构化课程
- 从变量、循环到函数与数据结构的系统课程路径
- 每课配可运行的代码示例,一键在 Playground 中打开练习

### 🧩 闯关与游戏化
- **Puzzle 谜题**:预测输出、修 Bug、填空补代码
- **代码对战 arena**:与题目赛跑,限时写出正确实现
- **密室逃脱(Escape Room)**:用 Python 知识解锁每一道门
- **成就系统**:学习行为全程追踪,勋章墙见证进度

### 🌌 3D 知识宇宙
- **知识星图(Star Map)**:Three.js 渲染的 Python 知识点星系,知识点之间的依赖关系一目了然
- **动画演示**:列表推导、倒排索引、搜索流程等概念逐帧动画

### 🔧 附加主题域
- **Linux 命令域**:常用命令速查与练习
- **Elasticsearch 域**:查询 DSL 可视化与 Playground
- **数据流水线(Pipeline)**:组合小工具理解数据处理流

## 🚀 快速开始

```bash
git clone https://gitee.com/starry-sea-1412/python-learning.git
cd python-learning
npm install
npm run dev
```

打开 http://localhost:3000 即可开始。生产构建:`npm run build && npm start`。

## 🛠 技术栈

| 层 | 技术 |
|----|------|
| 框架 | Next.js 16(App Router)+ React 19 + TypeScript |
| 样式 | Tailwind CSS 4 |
| 3D / 动画 | Three.js + React Three Fiber + Drei |
| Python 运行时 | Pyodide v0.25(WebAssembly) |
| 质量 | ESLint + tsc + GitHub Actions CI |

## 📁 目录速览

```
src/
├── app/            # 路由:playground / puzzle / battle / escape /
│                   #   starmap / universe / sandbox / linux / elasticsearch ...
├── components/     # PyodideRunner、可视化调试器、成就面板、各主题组件
├── lib/            # pyodide-engine(Python 运行时封装)等
└── data/           # 课程与题目数据
```

## 🤝 参与贡献

欢迎 Issue 与 PR:补充课程内容、新增谜题、改进沙盒体验都可以。提交前请确保 `npm run lint` 与 `npm run build` 通过(CI 会自动检查)。

## 📄 许可证

[MIT](LICENSE)

---

<a id="english"></a>
# PyLearn · Interactive Python Learning Platform

A Python learning platform that runs **entirely in your browser** — write code, solve puzzles, race in code battles, and explore a 3D knowledge universe. Nothing to install.

简体中文 | [English](#english)

## ✨ Highlights

- **In-browser Python runtime** — powered by Pyodide (WebAssembly Python), with an instant Playground and a step-through visual debugger.
- **Structured courses** — from variables and loops to functions and data structures; every example is runnable in one click.
- **Gamified practice** — output-prediction puzzles, timed code battles, an escape room unlocked by Python knowledge, and a full achievement system.
- **3D knowledge universe** — a Three.js star map of Python concepts and their dependencies, plus frame-by-frame concept animations (list comprehensions, inverted index, search flow).
- **Extra tracks** — Linux command practice, Elasticsearch query playground, and a data-pipeline builder.

## 🚀 Quick Start

```bash
git clone https://gitee.com/starry-sea-1412/python-learning.git
cd python-learning
npm install
npm run dev   # http://localhost:3000
```

## 🛠 Tech Stack

Next.js 16 (App Router) · React 19 · TypeScript · Tailwind CSS 4 · Three.js / React Three Fiber · Pyodide v0.25 · ESLint + GitHub Actions CI

## 📄 License

[MIT](LICENSE)