Warning
由于上游仓库 MiraiGo-Template 已长久无人维护,本项目计划使用新的框架重构。请查阅 yukichan-bot,本项目终止维护。
本来想起名为「MiraiGoChess」的,意为 Mirai 框架 + Go 语言 + 国际象棋,但是社区内有一个项目 MiraiGoChess 已经用了这个名字,所以咱就叫 「MiraiChess」了。
Note
目前的代码非常屎,仅供参考,不要学。
因为刚开始功能比较少就偷懒了,后面加了好多功能,懒得重构就越写越屎了。能跑就行了要什么可扩展性
这个项目的功能已经很完善了,后续也不会有大功能更新,已经没必要花时间重构。 如果您愿意花时间重构这个项目,欢迎 pr。
使用 MiraiGo-Template 实现的国际象棋机器人。
I assume that most of the users of this repo are Chinese, so there will be no English support for README and documents. If you need, post a issue.
如果你希望以模块化的方式将本 bot 集成到已有项目中,可以使用如下仓库:
准备如下环境:
- Linux 服务器 (笔记本啥的也可以,关键要有 Linux 环境)
- python
安装 python 库 python-chess:
pip install python-chess
安装 python 库 pgn2gif
Warning
这个库不可以通过 pip 安装,必须 clone 源码后手动安装
git clone https://github.com/dn1z/pgn2gif.git
cd pgn2gif
sudo python setup.py install
解压 release:
mkdir -p /opt/MiraiChess
tar -xzvf MiraiChess-linux-amd64-v1.9.0.tar.gz -C /opt/MiraiChess
cd /opt/MiraiChess
按需适当修改 ./config
下配置文件(默认配置可以直接运行):
vim ./config/application.yaml
vim ./config/chess.go
运行启动脚本,下载依赖并确保机器人正常运行(必需至少运行一次启动脚本):
./start.sh
机器人运行无误后,可以安装 service 文件:
cp ./mirai-chess.service /etc/systemd/system/mirai-chess.service
启动机器人:
systemctl start mirai-chess.service
开机自启:
systemctl enable mirai-chess.service
下载解压 release 后直接执行 update.sh
即可。
- 关闭服务
- 替换新的可执行文件
- 替换 README 文件
- 重启服务
更新脚本不会修改配置文件,当有功能更新时请注意手动更改配置文件。
请不要依赖这个脚本,如果遇到问题请备份配置文件后重新安装。
Warning
如果你打算手动编译,请在 release 下载一份最新稳定代码,不要直接使用 master 分支。
环境依赖:
编译可执行文件:
make build
发布 release:
make release
测试运行:
make run
每个群内同时只能存在一盘对局,如果有多盘对局同时进行的需求可以 fork 之后自己改。
本项目主要是希望提供一个在群内下棋的环境,重要的是大家一起围观、交流和讨论棋局,而不是单纯实现对局。太多的对局同时进行不仅会导致群消息过多炸群,而且也不利于交流。如果只是需要下棋,chess.com 的邀请链接完全可以创建无限的棋局。绝对不是开发者懒得写
如果服务器网络环境被风控,在本地执行后将生成的 device.json
及 session.token
上传至服务器即可。
可以尝试换个帐号,腾讯的风控很玄学的,本项目也没有什么好的办法。
以下是个人总结的一些玄学方法:
- 尽量不要使用刚注册的小号
- 帐号要实名并绑定手机号
- 开启设备锁、人脸识别等安全工具
- 不要频繁切换登录 IP
- 帐号多加点好友和群
本项目只建议使用 Linux 服务器运行本项目,如果你一定要使用 Windows,请按照下面的方法安装使用:
将本项目 clone 之后,在项目路径下执行如下指令:
go build -o bin/device.exe cmd/device/device.go
go build -o bin/bot.exe cmd/bot/bot.go
注意,编译本项目需要安装配置 Go 和 MinGW
在 config/chess.yaml
文件中修改 inkscape 可执行文件路径为安装路径。
在项目路径下执行 device.exe
.\bin\device.exe
.\bin\bot.exe
您的发行版无法运行 AppImage 封装的 Inkscape,常见于 Ubuntu。一般地,使用下面的指令安装 libfuse2
即可。(仅 Ubuntu)
sudo add-apt-repository universe
sudo apt install libfuse2
有任何疑问请参考 https://github.com/AppImage/AppImageKit/wiki/FUSE#install-fuse
点击链接或扫码加入 QQ 群:
本项目使用 AGPLv3
协议开源,您可以在 GitHub 获取本项目源代码。为了整个社区的良性发展,我们强烈建议您做到以下几点:
- 间接接触(包括但不限于使用
Http API
或 跨进程技术)到本项目的软件使用AGPLv3
开源 - 不鼓励,不支持一切商业使用