ChessGame - 棋类对战插件

August 7, 2026 · View on GitHub

一个非常nice的插件 如插件不能用请加我的qq1271558001 宣传一下自己群701380759

简介

网页版五子棋与中国象棋对战插件,直接在群内生成对局链接,双方在浏览器中对弈,支持 AI 实时局势分析。 目前最新支持ai对战

特性

  • 五子棋 / 中国象棋两种模式
  • 网页棋盘,点击落子,无需安装额外客户端
  • 悔棋、认输功能
  • AI 实时局势分析(白热化阶段自动触发)
  • AI 战况总结祝贺

安装

# 进入 Yunzai 根目录
cd Yunzai-Bot

# 安装依赖
pnpm install express yaml

# 克隆插件
git clone --depth=1 https://github.com/QWEfcxzz/ChessGame.git ./plugins/ChessGame

# 重启 Bot

依赖

依赖版本说明
express^5.xWeb 服务
yaml^2.xYAML 配置解析
node-fetch^3.xAI API 请求

命令

命令说明
#五子棋 @对手发起五子棋对战
#象棋 @对手发起中国象棋对战
#chess帮助查看帮助

配置

编辑 plugins/ChessGame/config/config.yaml

port: 2333                # 网页服务端口
baseUrl: ""               # 外网访问地址,留空自动获取
enableAi: true            # 是否开启AI解说
aiApi: "https://api.openai.com/v1/chat/completions"  # OpenAI兼容API地址
apiKey: ""                # API Key
model: "gpt-3.5-turbo"    # 模型名称

AI 分析触发条件

AI 分析仅在白热化阶段自动触发,避免频繁打扰:

  • 中国象棋:走棋 ≥ 12 步 或 有棋子被吃
  • 五子棋:走棋 ≥ 10 步

使用

  1. 在群内发送 #五子棋 @对手#象棋 @对手
  2. 双方点击机器人发送的链接进入网页棋盘
  3. 点击己方棋子选中,再点击合法落点走棋
  4. 进入白热化阶段后,AI 自动分析局势并发送到群内
  5. 游戏结束,AI 发送祝贺/安慰语