# 五子棋小游戏

**Repository Path**: he___e/wuziqi

## Basic Information

- **Project Name**: 五子棋小游戏
- **Description**: 这是一个结合古典水墨风格与现代编程技术的五子棋（Gomoku）游戏项目。项目分为前端和后端两部分，后端提供游戏逻辑和AI功能，前端负责用户界面和交互体验。
- **Primary Language**: Python
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-16
- **Last Updated**: 2026-05-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Vue, Pyhton, Flask

## README

# 五子棋游戏

这是一个结合古典水墨风格与现代编程技术的五子棋（Gomoku）游戏项目。项目分为前端和后端两部分，后端提供游戏逻辑和AI功能，前端负责用户界面和交互体验。

## 功能特点

- 支持人机对战模式
- 提供多种难度级别的AI对手（简单、中等、困难）
- 支持悔棋、重新开始、提示等功能
- 水墨风格的游戏界面，具有沉浸式的视觉体验
- 支持游戏状态保存与恢复

## 技术栈

- **后端**: Python + Flask
- **前端**: Vue.js + HTML5 + CSS3
- **AI算法**: 基于Minimax算法的AI决策系统，结合进攻与防守评估策略

## 后端模块说明

- `game_logic.py`: 实现五子棋核心逻辑，包括棋盘管理、胜负判断等
- `ai.py`: 提供AI决策功能，包含不同难度级别的AI策略
- `game_controller.py`: 管理游戏状态和用户交互逻辑
- `app.py`: 提供REST API接口供前端调用

## 前端模块说明

- 使用Vue.js框架构建响应式用户界面
- 包含多个组件如棋盘显示、按钮、动画效果等
- 使用CSS3实现水墨风格的视觉效果
- 提供游戏页面、主页、难度选择等视图

## 安装与运行

### 后端

1. 安装依赖: `pip install -r backend/requirement.txt`
2. 启动服务: `python backend/app.py`

### 前端

1. 进入前端目录: `cd frontend`
2. 安装依赖: `npm install`
3. 启动开发服务器: `npm run serve`

## API 接口说明

- `GET /api/state`: 获取当前游戏状态
- `POST /api/move`: 玩家落子
- `POST /api/ai_move`: 获取AI落子位置
- `POST /api/difficulty`: 设置AI难度
- `POST /api/game_mode`: 设置游戏模式（人机对战/双人对战）
- `POST /api/reset`: 重置游戏
- `POST /api/undo`: 悔棋
- `GET /api/hint`: 获取提示
- `POST /api/toggle_auto`: 切换自动模式
- `POST /api/new_game`: 开始新游戏

## 贡献指南

欢迎贡献代码和改进建议。请先阅读项目文档，了解代码风格和提交规范。

## 许可证

本项目采用 MIT 许可证。详情请查看 LICENSE 文件。