# PyCChess 中国象棋程序（单机版） 和 Harmless 中国象棋 UCCI 引擎

2021-2-15 更新

程序命令： 以普通用户，运行 pycchess 即可。

## 1. 简介

- PyCChess 中国象棋程序

- 自带的中国象棋 UCCI 引擎 Harmless (中文名：无害)

程序版本：0.1, 2011-2015

----

程序作者：timebug (2011-2015)

源码地址（GitHub/Gitee/OSCHINA/豆瓣）：

 https://github.com/timebug/harmless (in English, 2012-2015)
 https://gitee.com/mirrors/harmless (in English, 2015)
 https://www.oschina.net/p/harmless (in Simplified Chinese, 2015)

写了一个Linux下的中国象棋引擎
 . 
 Author: timebug (2012-02-03)
 .
 Source: https://www.douban.com/group/topic/27206675/ (豆瓣)
 .
 引擎取名为”无害“，最终目标是“基本无害”，旨在帮助象棋新手重新找回自信(笑)，
 目前基本框架已经完成，但正如其名，棋力还是很差。在普通机子上，限定每步6秒
 时间的情况下，平均搜索深度在5-8层左右。核心搜索主要采用的是极小窗口搜索，
 并结合了哈希表技术和历史启发；评估函数则相对实现得比较简单，只考虑了棋子
 本身的价值和棋子间的灵活度，虽不靠谱，但基本能用。
 .
 写完已经有一段时间了，由于身边能帮我测试的人有限，所以冒昧发到这里来，
 如果有朋友对此感兴趣，不妨可以拿去玩玩，有任何问题，欢迎前去项目主页吐槽
 反馈。
 .
 引擎部分完全用C语言实现，支持部分UCCI通信协议，并附带了一个简单的图形
 界面，由Python实现。当然，所有代码都是开放的，引擎部分暂时也未采用任何
 协议，且代码风格还算干净，所以，大家可以拿去放心使用随意修改，完全不用
 为此负任何责任。:-)
 .
  * 项目地址：https://github.com/timebug/harmless

----

DEB 打包人：Careone (2021.2.15)

(注：暂只编译/打包 amd64 平台的程序的 DEB 包)

DEB 包下载地址（城通网盘）：

- 文件名: pycchess_0.1-1_amd64.deb

- 文件大小: 0.6 M

- https://306t.com/d/30646948-42482335-40c3a2

  （访问密码：6859）

## 2. 打包 DEB 的起因

打包人：Careone

个人作为一个中国象棋爱好者，因机缘巧合，无意中接触到 PyCChess 中国象棋程序，以及其自带的
 UCCI 中国象棋引擎。惊叹之余，觉得这么优秀的本土游戏程序，不应该被埋没、遗忘或荒废。

于是根据程序作者公开的程序源码，编译了 amd64 平台的 Linux 运行程序。
经过调试、图片微调，适当增补了一些文件。运行正常。

为表示对程序作者的敬意和尊重，主程序图标，采用了程序作者主页的图案（一个黑白色调的、类似俄罗斯方块游戏界面的图标）。

#### 注：调整的图片

1. image/select.png (用于标示走动的棋子)

2. image/done.png (用于标示某个棋子，走子之前所在的位置)

3. image/over.png (用于标示“输棋”后的“将/帅”棋子)

## 3. PyCChess 中国象棋程序

一、已实现的功能

- 人机对战。

- 按 [空格键] 重新开始新的棋局。

二、不支持的功能

- 不支持 [悔棋] 操作。

- 无法调节棋力难度。

- 不支持联网对局。

- 不能显示走棋文字（如“炮二平五”）。

- 无法保存、读取走棋记录（不支持主流的中国象棋棋谱文件）。

## 4. DEB 包的适配和其它技术细节

4.1 主程序和游戏图片（如棋子、棋盘）、游戏走棋声音，位于以下目录：

  - usr/local/share/pycchess/ (游戏主目录)

  - usr/local/share/pycchess/cchess.py (主程序)

  - usr/local/share/pycchess/*.py (附加程序)

  - usr/local/share/pycchess/image/*.png (棋子、棋盘图片)

  - usr/local/share/pycchess/sounds/*.WAV (音效文件)

4.2 用户启动 pycchess 程序时，会在当前用户目录下，

自动创建游戏目录 ~/.pycchess/

并创建相关游戏数据的符号链接到这个目录下。

  走棋时，程序会在 harmless 引擎程序所在的目录，

  自动生成一个 harmless.log 文件，用于记录引擎输出。

  （如果 harmless 程序所在目录无法创建或修改 harmless.log 文件，

则主程序 PyCChess 在走完第一个回合后，会报错并退出游戏、自动关闭程序。）

## 5. XBoard 调用 harmless 引擎的测试结果

经测试，暂无法在 XBoard 程序中，正常调用 harmless 中国象棋引擎（UCCI 协议）。

- 测试环境：Debian 10.8 amd64, XBoard 4.9.1

- 调用指令：xboard @xq -fcp maxqi -scp harmless

- 中国象棋引擎文件位置：/usr/local/games/harmless

- 报错内容：严重错误：写入第二个象棋程序时出错：断开的管道

- 附、增补的 XBoard 相关图标/引擎配置文件：

  - usr/share/games/harmless/harmless.rc

  - usr/share/games/plugins/logos/harmless.png

  - usr/share/games/plugins/xboard/harmless.eng

## 6. XBoard 调用 UCCI 协议中国象棋引擎的指令参考

- 用法1:

  xboard -variant xiangqi -fcp maxqi -scp "uci2wb -x harmless"

- 用法2:

  xboard @xq -fcp maxqi -scp "uci2wb -x harmless"

- 用法3:

  xboard @xq -fcp maxqi -scp {uci2wb -x harmless}

- 用法4:

  xboard @xq -uxiAdapter {uci2wb -%variant "%scp" "%sd"} -fcp maxqi -scp harmless -sUCCI