可用于本地双人进行中国象棋对战,体验完整象棋规则。该项目实现七种棋子走法,支持将军、将死、困毙判定,通过Unicode符号绘制棋盘,红方棋子ANSI红色高亮,提供坐标标注。【此简介由AI生成】
Access rate limit exceeded. Please log in to continue.
中国象棋 (Xiangqi)
基于仓颉编程语言 (Cangjie) 开发的命令行中国象棋对弈程序,支持完整的象棋规则,适合本地双人对战。
目录
功能特性
棋子走法
完整实现了七种棋子的走法规则:
| 棋子 | 说明 |
|---|---|
| 帅/将 | 九宫格内一步直行,四方向移动 |
| 仕/士 | 九宫格内一步斜行 |
| 相/象 | 田字对角移动,受阻于"塞象眼" |
| 马 | 日字对角移动,受阻于"蹩马脚" |
| 车 | 直线任意距离移动 |
| 炮 | 直线移动,翻山吃子(需隔一枚棋子) |
| 兵/卒 | 未过河只能前进,过河后可左右移动(不能后退) |
规则判定
- 将军检测 — 实时检测己方将/帅是否处于被攻击状态,包括飞将规则(将帅同列且无遮挡)
- 将死判定 — 被将军且无任何走法可以应将
- 困毙判定 — 未被将军但无合法走法可走,视为输棋
- 走法合法性 — 自动过滤走后己方仍被将军的非法走法
棋盘显示
- 棋盘使用 Unicode 符号绘制,包含楚河汉界分隔线
- 红方棋子以 ANSI 红色高亮显示
- 行号 0~9 + 列号 a~i 坐标标注
游戏界面示例
a b c d e f g h i
0 车 马 象 士 將 士 象 马 车
1 + + + + + + + + +
2 + 砲 + + + + + 砲 +
3 卒 + 卒 + 卒 + 卒 + 卒
4 + + + + + + + + +
────── 楚河 漢界 ──────
5 + + + + + + + + +
6 兵 + 兵 + 兵 + 兵 + 兵
7 + 炮 + + + + + 炮 +
8 + + + + + + + + +
9 車 馬 相 仕 帥 仕 相 馬 車
紅方 走棋,輸入移動(例如 a0a1):
环境要求
- 仓颉编译器 (cjc) >= 1.0.5
- 仓颉包管理器 (cjpm)
快速开始
# 克隆仓库
git clone https://gitcode.com/ZUT_Cangjie/T_zy_428.git
cd T_zy_428
# 编译并运行
cjpm run
游戏规则
胜负条件
- 将死 — 一方被将军且无法应将,对方获胜
- 困毙 — 一方无子可动(所有棋子均无合法走法),对方获胜
特殊规则
- 飞将 — 将帅不可在同列且无棋子遮挡,否则视为被将军
- 九宫 — 将/帅和仕/士的活动范围限定在己方九宫格内
- 己方半场 — 相/象不可过河
- 塞象眼 — 相/象移动路径的田字中心有棋子时不能移动
- 蹩马脚 — 马移动路径的日字邻点有棋子时不能移动
- 炮架 — 炮吃子时,目标前必须恰好有一枚棋子作为炮架
操作说明
走法输入格式
使用 4 个字符表示一步棋,格式为:起始列 起始行 目标列 目标行
列: a b c d e f g h i (从左至右)
行: 0 1 2 3 4 5 6 7 8 9 (从上至下,黑方底线为 0,红方底线为 9)
示例
| 输入 | 含义 |
|---|---|
b2e2 |
黑炮从 b2 移至 e2(平炮) |
a0a1 |
黑车从 a0 前进至 a1 |
b7e7 |
红炮从 b7 移至 e7 |
c6c5 |
红兵从 c6 前进至 c5 |
对局流程
- 程序启动后显示初始棋盘
- 红方执先手,输入走法后回车确认
- 程序自动判定走法合法性,不合法则提示重新输入
- 每次走棋后自动检测将军、将死、困毙状态
- 一方获胜后程序结束
项目结构
src/
├── main.cj # 主程序:游戏主循环、棋盘渲染、输入解析
├── types.cj # 类型定义:Side 阵营、PieceType 棋子种类、Piece/PiecePosition 结构体
├── board.cj # 棋盘模块:Board 类、棋子初始化、移动、查询、拷贝
└── engine.cj # 引擎模块:走法生成、将军检测、合法性判定、将死/困毙判定
设计概述
走法验证流程
用户输入 → parseMove() 解析坐标
→ isLegalMove() 验证
├── 检查是否为己方棋子
├── 生成伪合法走法(仅棋子规则)
├── 模拟走子后的棋盘局面
└── 检查己方将帅是否仍被将军
→ 通过则执行,否则提示重新输入
核心类型
Side— 枚举类型,Red/Black,标记红方与黑方PieceType— 枚举类型,表示KingAdvisorElephantHorseRookCannonPawn七种棋子Piece— 结构体,包含pieceType和side两个字段Position— 结构体,表示棋盘上的行列位置,提供isValid()方法校验越界Board— 类,封装 10×9 二维棋盘,提供棋子增删查改及局面拷贝
许可
MIT License
Introduction
可用于本地双人进行中国象棋对战,体验完整象棋规则。该项目实现七种棋子走法,支持将军、将死、困毙判定,通过Unicode符号绘制棋盘,红方棋子ANSI红色高亮,提供坐标标注。【此简介由AI生成】
Customize your domain