免费开源的中国象棋AI连线工具：5步让电脑接管看盘与落子
项目地址: https://gitcode.com/gh_mirrors/vi/VinXiangQi 打开天天象棋或JJ象棋的对局，电脑会实时认全32枚棋子、算出参考走法并直接替你点下去，你只需要看着学。这就是Vin象棋（VinXiangQi），一款基于YOLOv5识别模型的免费开源中国象棋AI连线工具。适合想复盘每一步得失、想让开局又快又稳，或想挂机自动跑棋的棋友。
📋 功能速览：这套工具能做什么
核心能力一句话概括：认出棋盘、算出走法、替你落子，主要功能如下。
| 功能 | 说明 | 对用户的价值 |
|---|---|---|
| 棋盘识别 | YOLOv5模型检测游戏截图，实时认出14类棋子与棋盘 | 无需手工记子，局面始终与对局同步 |
| 引擎分析 | 接入UCI/UCCI象棋引擎，输出最佳着法、深度与评分 | 每个局面都有参考走法，省去手动复盘 |
| 开局库 | 本地棋谱与云棋库优先匹配，未命中再交给引擎思考 | 开局阶段秒级响应，不耗引擎算力 |
| 自动点击 | 保存按钮截图模板，自动点击“续盘”等按钮 | 无需反复手动开局，对局可连续跑 |
| 连线方案管理 | 内置天天象棋、JJ象棋方案，也支持自建窗口方案 | 选定方案即连上对局，全程不写代码 |
这些能力不依赖象棋软件内置接口，工具以“截图识别加模拟点击”的方式工作在任何对局外面。
⚙️ 它是怎么跑起来的：一位“教练”的三步循环
整个流程像一位代班教练：先读盘，再算棋，最后指点落子。
第一步：教练读盘，YOLOv5识别
程序定时截取游戏窗口，图像送入YOLOv5的ONNX模型，一次检出15个目标：黑红双方14类棋子加棋盘本体。识别画面实时显示检测框，识别结果区以文字给出当前局面，对方一落子局面随即更新。
第二步：教练算棋，UCI/UCCI引擎
识别结果被转成标准棋局表示，交给你指定的引擎进程。程序会依次尝试UCI和UCCI两种协议，输出思考深度、耗时与评分；开启开局库时先查本地与云棋谱，未命中才让引擎深算。
第三步：教练指点，鼠标操作
引擎给出着法后，程序用两种方式点击游戏：后台鼠标发送系统消息、不占用鼠标，前台鼠标模拟真实操作、兼容性最好。配合按钮截图的模板匹配，还能完成“续盘”“开始对局”这类界面操作。
三步循环往复，对局就能一直跑下去。跑通之后，界面各区域的具体位置在 README.md 里有逐屏说明。
🚀 上手指南：从0到跑通连线的5步
第1步：克隆代码
git clone https://gitcode.com/gh_mirrors/vi/VinXiangQi
克隆后进入 VinXiangQi/ 目录，这就是完整的WinForms工程源码。
第2步：安装运行环境
装好 .NET Framework 4.8 后编译运行，得到主程序界面。
第3步：选择连线方案
在方案下拉框选内置的“天天象棋”或“JJ象棋_棋力评测”，其他对局用“寻找窗口句柄”新建。选定后程序就知道该截哪个窗口、往哪里点击。
第4步：配置引擎与缩放比
在引擎设置里填引擎程序路径，再进调试模式按左上角截图调缩放比，直到截图恰好覆盖棋盘。
第5步：开始对局
打开目标对局，按当前轮次选“我方开始”或“对方开始”并点开始。程序随即识别局面、计算并自动落子，识别画面全程可见。
| 依赖 | 说明 | 备注 |
|---|---|---|
| .NET Framework 4.8 | C# 程序运行时 | 多数 Windows 已预装 |
| 象棋引擎 | 支持UCI/UCCI协议的引擎程序 | 需自行准备，在引擎设置中指定路径 |
| YOLOv5模型文件 | .onnx 文件放入程序 Models 目录 | 默认名 nano.onnx，模型下载地址[待补充] |
主界面左侧是实时识别画面，右侧为引擎与连线设置，识别结果里的棋子可以点选并转发点击，方便调试落子位置。
🔧 调优与技巧：识别不准和点不中怎么调
跑通只是开始，参数调顺了体验才稳定。最常见的三种情况对应如下操作。
| 现象 | 操作 |
|---|---|
| 截图显示不全或有黑边 | 进调试模式调缩放比：不全就调大，有黑边就调小，直到窗口恰好盖住棋盘 |
| 后台截图画面黑屏或点击无效 | 改勾前台截图；点击失败就改勾前台鼠标，注意前台模式要求窗口不被遮挡、落子时别动鼠标 |
| 识别结果不稳或中途停止分析 | 点“重新检测棋盘”刷新；天天象棋等走子动画长的对局，识别确认次数至少设为2次 |
想挂机续盘就打开“自动点击管理”，在识别范围内尽量小地框选“续盘”按钮、保存模板，再勾选自动点击即可，框选范围越小检测越快。
❓ 常见问题：任意象棋平台都能用吗
Q：支持哪些象棋平台？ 界面清晰、能截到棋盘就行。天天象棋和JJ象棋有内置方案，其他平台用窗口标题或类名自建方案即可。
Q：识别模型和引擎都要自己准备吗？ 模型 .onnx 文件放入 Models 目录，默认名 nano.onnx，获取途径[待补充]；引擎需你指定一个支持UCI/UCCI的引擎程序。
Q：电脑配置低能跑吗？ 可以，把引擎思考深度和线程调低优先保流畅，识别本身开销不大。
到这里，克隆仓库、打开对局，按上手指南走5步，电脑就能接管看盘、算棋、落子的重复劳动：
git clone https://gitcode.com/gh_mirrors/vi/VinXiangQi
省下的时间，留给你研究它算出的每一步。
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
