# wzq

**Repository Path**: mx-seu/wzq

## Basic Information

- **Project Name**: wzq
- **Description**: 五子棋游戏   大作业
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-06
- **Last Updated**: 2025-09-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# wzq 项目说明

这是一个基于 Qt 开发的双人或人机对战五子棋游戏项目，支持本地人机对战和玩家对战模式，使用 C++ 编写，界面通过 Qt 实现。

## 主要功能

- 支持玩家对战（PvP）和玩家对 AI（PvAI）模式。
- 提供图形化界面，支持鼠标操作进行游戏。
- 包含游戏胜负判断逻辑。
- 支持 AI 自动落子功能。

## 项目结构

- `GameModel.cpp/h`：游戏核心逻辑，包括游戏开始、落子、胜负判断、AI 决策等。
- `MainWindow.cpp/h`：主窗口逻辑，包括界面绘制、鼠标事件处理、游戏初始化等。
- `main.cpp`：程序入口。
- `mainwindow.ui`：Qt 主窗口界面布局文件。
- `wzq_demo.pro`：Qt 项目配置文件。

## 核心类说明

### GameModel 类
负责游戏核心逻辑，包括：
- `startGame()`：初始化游戏。
- `actionByPerson()`：处理玩家落子。
- `isWin()`：判断当前落子是否获胜。
- `actionByAI()`：AI 落子逻辑。

### MainWindow 类
负责界面和交互逻辑，包括：
- 按钮点击事件（开始 PvP 或 PvAI 模式）。
- 鼠标事件处理（落子）。
- 绘图事件（绘制棋盘和棋子）。
- 游戏初始化和重置。

## 使用说明

1. 使用 Qt Creator 打开 `wzq_demo.pro` 文件。
2. 构建并运行项目。
3. 在游戏界面中选择“玩家对战”或“人机对战”开始游戏。

## 开发环境

- 操作系统：Windows / Linux / macOS
- 开发工具：Qt Creator
- 编程语言：C++
- 依赖库：Qt5 或 Qt6 相关模块（如 QtGui、QtWidgets）

## 贡献指南

欢迎提交 Issue 和 Pull Request，帮助改进游戏逻辑、界面设计或 AI 算法。

## 许可证

本项目采用 MIT License，请参阅 LICENSE 文件获取详细信息。