# Chess

**Repository Path**: ns2250225/Chess

## Basic Information

- **Project Name**: Chess
- **Description**: 中国象棋嘲讽版（每走一步都嘲讽你一次）
- **Primary Language**: JavaScript
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-19
- **Last Updated**: 2026-03-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 中国象棋 • 大师嘲讽版 (Chinese Chess • Master Taunt Edition)

## 📖 项目简介

这是一个基于 Web 技术构建的中国象棋对弈系统，内置了具有“嘲讽”功能的 AI 对手。不仅拥有完整的中国象棋规则实现，还特别加入了一个名为“大师”的 AI 人格，它会在对弈过程中根据局势对玩家进行幽默（或扎心）的嘲讽。

项目采用现代前端技术栈开发，界面简洁优雅，适配 PC 和移动端设备。

## ✨ 功能特性

- **完整的中国象棋规则**：支持所有标准走法、将军检测、绝杀判断。
- **智能 AI 对手**：
  - 集成 `xqwlight` 象棋引擎。
  - 运行于 Web Worker 中，计算不阻塞 UI 线程。
  - 支持开局库，提升开局阶段的应对能力。
- **大师嘲讽系统**：
  - AI 会根据当前局势（如将军、吃子、被吃、陷入劣势等）发送嘲讽语录。
  - 包含多种嘲讽风格，增加游戏趣味性。
- **多端适配设计**：
  - **PC 端**：采用 3:1 黄金比例布局，左侧大棋盘，右侧对弈记录与嘲讽信息。
  - **移动端**：精心优化的全屏棋盘体验，自动计算最佳比例，确保棋子清晰不拥挤。
- **丰富的游戏功能**：
  - **悔棋/重开**：随时重新开始或撤销操作。
  - **棋谱导入/导出**：支持导出对局 JSON 文件，方便复盘分享。
  - **复盘模式**：可以一步步回看之前的对局。
  - **辅助功能**：合法走法高亮提示、将军视觉警告。

## 🛠️ 技术栈

- **核心框架**：[Vue 3](https://vuejs.org/) (Composition API, `<script setup>`)
- **开发工具**：[Vite](https://vitejs.dev/) (极速冷启动与热更新)
- **语言**：[TypeScript](https://www.typescriptlang.org/) (全类型安全)
- **样式**：[Tailwind CSS](https://tailwindcss.com/) (实用主义 CSS 框架)
- **多线程**：Web Workers (用于 AI 引擎计算)

## 📂 项目结构

```
Chess/
├── web/                  # 前端项目主目录
│   ├── src/
│   │   ├── components/   # Vue 组件 (ChessBoard, GameLog 等)
│   │   ├── composables/  # 组合式函数 (useAI 等)
│   │   ├── engine/       # 象棋引擎核心代码 (Worker, Book 等)
│   │   ├── utils/        # 通用工具与游戏逻辑 (ChessLogic.ts)
│   │   ├── App.vue       # 根组件
│   │   └── main.ts       # 入口文件
│   └── index.html
├── ai.py                 # (可能存在的) Python 辅助脚本
└── README.md             # 项目说明文档
```

## 🚀 快速开始

### 前置要求
请确保您的环境中已安装 [Node.js](https://nodejs.org/) (推荐 v16+)。

### 安装依赖

```bash
cd web
npm install
```

### 启动开发服务器

```bash
npm run dev
```
启动后，访问控制台输出的本地地址（通常是 `http://localhost:5173`）即可开始游戏。

### 构建生产版本

```bash
npm run build
```
构建产物将输出到 `web/dist` 目录。

## 🎮 玩法说明

1.  **选择阵营**：进入游戏后，选择“执红先行”或“执黑后行”。
2.  **开始对弈**：点击棋子进行移动，红方先行。
3.  **应对嘲讽**：在右侧（或移动端底部）的消息栏中，留意“大师”的发言，不要被干扰心态！
4.  **复盘分析**：对局结束后，可以导出棋谱，或直接在界面上进行复盘。

## 📄 许可证

MIT License