# aipark

**Repository Path**: soaiprogram/aipark

## Basic Information

- **Project Name**: aipark
- **Description**: No description available
- **Primary Language**: NodeJS
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-27
- **Last Updated**: 2026-05-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# AIpark

AIpark - 智能游戏平台，提供数独、象棋、五子棋、英语学习等多种游戏和学习功能，支持H5和响应式设计。

## 项目结构

```
├── frontend/          # 前端代码（React + Vite）
├── backend/           # 后端代码（Node.js + Express）
└── 指令记录/          # 需求文档
```

## 功能特性

- 🎮 数独游戏（20个关卡，难度渐进）
- ♟️ 象棋游戏（20个关卡，难度渐进）
- 📚 英语学习（20个关卡，难度渐进）
- 📱 响应式设计（支持PC和移动端）
- 🎨 高科技感UI界面

## 🚀 快速开始

### 方式一：保姆级教程（新手推荐）

**👉 请查看 [保姆级运行教程.md](./保姆级运行教程.md) 获取最详细的运行步骤，每个步骤都有详细说明和必要性解释**

### 方式二：查看快速指南

**👉 请查看 [本地运行指南.md](./本地运行指南.md) 获取完整的运行步骤和问题解决方案**

### 方式三：快速启动

#### 1. 安装依赖

打开两个命令行窗口：

**窗口1 - 后端依赖：**
```bash
cd backend
npm install
```

**窗口2 - 前端依赖：**
```bash
cd frontend
npm install
```

#### 2. 启动服务

**窗口1 - 启动后端（端口3001）：**
```bash
cd backend
npm run dev
```
看到 `服务器运行在 http://localhost:3001` 表示成功 ✅

**窗口2 - 启动前端（端口3002）：**
```bash
cd frontend
npm run dev
```
看到 `Local: http://localhost:3002/` 表示成功 ✅

#### 3. 打开浏览器

访问：**http://localhost:3002** 🎮

> 💡 **提示**：如果 npm install 很慢，项目已配置国内镜像源，会自动加速下载

## 项目特性

### 已实现功能

✅ **用户系统**
- 自动生成唯一用户ID
- 本地存储用户标识

✅ **游戏进度管理**
- 自动保存每个游戏的进度
- 支持重置游戏进度
- 支持两种模式：标准模式（固定20关）和AI生成模式

✅ **AI关卡生成**
- 完成20关后可以生成新的10关
- 每次生成都是新的挑战
- 支持无限扩展关卡

✅ **三个游戏模块**
- 数独游戏（20个基础关卡 + AI生成）
- 象棋游戏（20个基础关卡 + AI生成）
- 英语学习（20个基础关卡 + AI生成）

✅ **响应式设计**
- 支持PC端和移动端
- 现代化UI设计
- 高科技感界面

## 技术栈

- 前端：React 18 + Vite + TypeScript + TailwindCSS
- 后端：Node.js + Express + TypeScript