# FunSchool

**Repository Path**: lsy_admin/fun-school

## Basic Information

- **Project Name**: FunSchool
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 趣味学堂 🎮

> 一款为小学二年级学生设计的网页学习游戏，帮助小朋友在游戏中快乐学习数学、拼音和汉字书写。

## ✨ 功能介绍

### 🔢 数学大冒险

加减乘除练习，寓教于乐。

- **加法**：100 以内加法，低难度题目配合 🍎🍌 水果可视化辅助理解
- **减法**：100 以内减法
- **乘法**：九九乘法表练习
- 每轮 10 题，四选一作答
- 答题进度跟踪，星级评分（1~3 星）

### 🔤 拼音小达人

声母、韵母、整体认读音节学习与拼读练习。

- **认读学习**：点击拼音卡片听发音，查看对应例字
- **拼音测验**：看汉字选拼音，10 题一轮
- **连连看**：将词语拼音与汉字进行匹配配对
- 使用浏览器 Web Speech API 朗读发音

### ✏️ 写字小能手

汉字笔顺动画演示与描红练习。

- 基于 [HanziWriter](https://hanziwriter.org) 库实现笔顺动画
- **笔顺演示**：观看每个字的书写顺序动画
- **描红练习**：在田字格中按笔顺描写，系统自动判定正确性
- 收录 20 个二年级常见汉字（春、树、花、草、河、山、水……）
- 点击可听汉字发音

### 🗺️ 综合大闯关

将数学、拼音、汉字整合为关卡式冒险游戏。

- 4 个递进关卡：数学入门 → 进阶挑战 → 高手通关 → 终极大师
- 每关包含数学、拼音、汉字混合题目
- 通关解锁下一关，获得星级奖励
- 通关进度本地保存

## 🌟 特色

| 特色 | 说明 |
|------|------|
| 卡通可爱风 | 明亮色彩、圆角设计、🐼 小熊猫吉祥物 |
| 动画反馈 | 答对 🎉 庆祝、答错抖动提示、星星弹出动画 |
| 星星奖励 | 答题获得星星，累计保存在本地，不会丢失 |
| 语音朗读 | 拼音和汉字均支持点击发音 |
| 响应式设计 | 支持电脑、平板、手机触屏操作 |

## 🚀 快速开始

### 方式一：直接打开

双击 `index.html` 文件，在浏览器中打开即可。

> ⚠️ 推荐使用 Chrome 或 Edge 浏览器，语音朗读功能需要浏览器支持 Web Speech API。

### 方式二：本地服务器（推荐）

使用本地服务器可获得最佳体验：

```bash
# 进入项目目录
cd 趣味学堂

# 使用 Node.js 启动本地服务器
npx http-server -p 8080

# 在浏览器中打开
# http://localhost:8080
```

### 方式三：Python 服务器

```bash
cd 趣味学堂
python -m http.server 8080
```

## 📁 项目结构

```
趣味学堂/
├── index.html              # 主页面
├── css/
│   └── style.css           # 卡通风格样式
├── js/
│   ├── data.js             # 学习数据（拼音/汉字/闯关题目）
│   ├── storage.js          # 星星进度本地存储
│   ├── app.js              # 主控制器（页面切换/奖励系统）
│   ├── math-game.js        # 数学模块
│   ├── pinyin-game.js      # 拼音模块
│   ├── writing-game.js     # 写字模块
│   └── adventure-game.js   # 综合闯关模块
└── README.md               # 项目说明（本文件）
```

## 🛠️ 技术栈

- **HTML5 / CSS3 / JavaScript**：纯前端实现，无需后端
- [HanziWriter](https://hanziwriter.org) 3.5：汉字笔顺动画与描红
- [Google Fonts](https://fonts.google.com)：ZCOOL KuaiLe、Ma Shan Zheng 中文字体
- **Web Speech API**：浏览器原生语音朗读
- **localStorage**：本地进度存储

## 📖 使用说明

1. 打开游戏后，首页显示四个学习模块，点击任意卡片进入
2. 右上角 🏠 按钮可随时返回首页
3. 顶部 ⭐ 显示累计星星总数
4. 每个模块完成练习后会弹出星级评价弹窗
5. 进度自动保存，关闭浏览器后再次打开不会丢失

## 🎯 适用对象

- 小学一、二年级学生
- 需要巩固数学计算、拼音认读、汉字书写的小朋友

## 📝 自定义内容

### 添加更多汉字

编辑 `js/data.js` 中的 `WRITING_CHARS` 数组：

```javascript
{ char: '新字', pinyin: 'xīn zì', meaning: '释义' },
```

### 添加闯关题目

编辑 `js/data.js` 中的 `ADVENTURE_LEVELS` 数组，按格式添加题目：

```javascript
{ type: 'math', question: '5 + 3 = ?', answer: 8, options: [6, 7, 8, 9] },
{ type: 'pinyin', question: '"妈妈" 的拼音是？', answer: 'mā ma', options: ['mā ma', 'bà ba', 'dà xiàng', 'lǎo shī'] },
```

### 修改拼音学习内容

编辑 `js/data.js` 中的 `PINYIN_DATA` 和 `PINYIN_MATCH` 数组。

## 📄 许可

本项目仅供学习和教育用途，可自由使用和修改。