# 3d chess game

**Repository Path**: wangming123456/3d-chess-game

## Basic Information

- **Project Name**: 3d chess game
- **Description**: 3d版中国象棋，支持使用glm4.7作为ai对手
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-21
- **Last Updated**: 2026-02-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 中国象棋 3D

基于 Three.js 的 3D 中国象棋游戏，使用 Vue 3 作为前端框架，AI 对手使用 GLM-4.7 API。

## 技术栈

- Vue 3 + Vite
- Three.js (3D 渲染)
- GLM-4.7 API (AI 对手)
- TypeScript

## 安装依赖

```bash
npm install
```

## 运行项目

```bash
npm run dev
```

游戏将在 http://localhost:3000 启动。

## 构建项目

```bash
npm run build
```

## 功能特性

- 3D 棋盘和棋子渲染
- 可旋转视角（鼠标拖动）
- 鼠标点击选择和移动棋子
- 完整的中国象棋规则实现
- AI 对手（使用 GLM-4.7 API）
- 悔棋功能
- 胜负判定

## 操作说明

1. 点击己方棋子选中
2. 点击高亮位置移动棋子
3. 拖动鼠标旋转视角
4. 滚动鼠标缩放视角

## AI 配置

要使用 AI 对手，需要配置 GLM-4.7 API Key：

1. 在页面输入框中输入你的 GLM-4.7 API Key
2. 确保"启用 AI 对手"选项已勾选
3. 开始游戏，AI 将执黑方与你对弈

## 项目结构

```
src/
├── main.ts              # 入口文件
├── App.vue              # 主组件
├── components/
│   └── ChessBoard.vue   # 棋盘 3D 组件
├── game/
│   ├── types.ts         # 类型定义
│   ├── rules.ts         # 象棋规则引擎
│   ├── board.ts         # 棋盘状态管理
│   └── ai.ts            # AI 对手 (GLM-4.7)
└── config/
    └── api.ts           # API 配置
```