# ChineseChess

**Repository Path**: jesson-deng/chinese-chess

## Basic Information

- **Project Name**: ChineseChess
- **Description**: 中国象棋 Python 源码，技术支持 wx: coder-jesson
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

技术支持 vx: coder-jesson

# 中国象棋游戏

基于Pygame开发的功能完整的中国象棋游戏，支持人人对战和人机对战。

## 功能特性

- ✅ 完整的中国象棋规则实现
- ✅ 图形化界面（Pygame）
- ✅ 人人对战模式
- ✅ 人机对战（AI支持简单、中等、困难三种难度）
- ✅ 悔棋功能
- ✅ 游戏保存与加载
- ✅ 移动提示
- ✅ 将军检测

## 安装依赖

```bash
pip install -r requirements.txt
```

## 运行游戏

```bash
python main.py
```

## 项目结构

```
ChineseChess/
├── main.py                    # 程序入口
├── core/                      # 核心逻辑
│   ├── board.py              # 棋盘类
│   ├── piece.py              # 棋子类
│   ├── move.py               # 移动类
│   ├── game.py               # 游戏控制
│   └── rules.py              # 规则引擎
├── ai/                       # AI模块
│   ├── evaluator.py          # 评估函数
│   └── search.py             # 搜索算法
├── gui/                      # 图形界面
│   ├── window.py             # 主窗口
│   ├── board_renderer.py     # 棋盘渲染
│   └── piece_renderer.py     # 棋子渲染
└── utils/                    # 工具模块
    ├── config.py             # 配置
    └── recorder.py           # 棋谱记录
```

## 操作说明

- **选择棋子**：鼠标左键点击
- **移动棋子**：点击目标位置
- **悔棋**：按U键
- **重新开始**：按R键
- **退出**：按ESC键或关闭窗口

## 技术实现

### 核心算法

- **移动生成**：基于规则的合法移动生成
- **AI搜索**：Minimax + Alpha-Beta剪枝
- **评估函数**：子力价值 + 位置价值 + 机动性

### 难度等级

- **简单**：搜索深度2层
- **中等**：搜索深度4层
- **困难**：搜索深度6层 + 移动排序优化

## 开发计划

详见 [设计文档.md](设计文档.md)

## 许可证

MIT License