readboard

May 30, 2026 · View on GitHub

readboard

Windows 棋盘同步工具，为 LizzieYzy-Next 提供截图取棋、棋子识别、棋盘状态回传与模拟落子能力。

.NET Platform UI Release Downloads

简体中文 ｜ English

演示图

Important

本项目可能已不再适配原版 LizzieYzy。 当前所有维护、协议演进与打包流程都围绕 LizzieYzy-Next 进行，与原版 LizzieYzy 的兼容性不再保证。如果你使用的是原版 LizzieYzy，请使用其自带的 readboard，或切换到 LizzieYzy-Next。

概述

readboard 通过截屏方式从外部围棋客户端窗口抓取棋盘画面，使用颜色阈值识别棋子位置，并通过 TCP 或命名管道把棋盘状态实时同步给宿主程序（LizzieYzy-Next）。同时它也接收宿主下发的落子指令，通过模拟点击在客户端上完成落子。

仓库中的 .NET 10 WinForms 版本是唯一在维护的版本，「简易版 readboard」已停止维护，生产改动、打包、宿主集成都以本仓库为准。

功能

  • 外部棋盘窗口截图捕获，含野狐 / YeHu 平台的窗口绑定与标题解析
  • 棋子识别与棋盘状态实时回传宿主
  • 接收宿主指令模拟落子，野狐支持后台落子（窗口不能最小化）
  • 经典 / 优化双主题，浅色 / 深色 / 跟随系统三种配色
  • 多语言：简体中文 / English / 日本語 / 한국어

系统要求

  • Windows 10 / 11
  • .NET 10 运行时；开发需要 .NET 10 SDK

使用

正常使用时 readboard.exe 由 LizzieYzy-Next 启动，通过 TCP 或命名管道与宿主通信。无参数启动不会显示窗口。

需要单独打开 UI 调试时，用脚本模拟宿主启动：

pwsh.exe -NoProfile -ExecutionPolicy Bypass -File scripts/run-readboard-ui-debug.ps1

指定某个发布包里的 exe：

pwsh.exe -NoProfile -ExecutionPolicy Bypass -File scripts/run-readboard-ui-debug.ps1 -ExePath "D:\path\to\readboard.exe"

开发

dotnet restore readboard.sln --configfile NuGet.Config
dotnet build readboard.sln -c Debug
dotnet test tests/Readboard.VerificationTests/Readboard.VerificationTests.csproj --no-build

更多见 docs/DEVELOPMENT.md。

打包

Tip

始终使用 scripts/package-readboard-release.local.ps1，不要手写 build / copy / compress 命令。默认 -SkipZip 只生成目录，需要分发时再生成 zip。

# 仅生成 release 目录
pwsh.exe -NoProfile -ExecutionPolicy Bypass -File scripts/package-readboard-release.local.ps1 -SkipZip

# 生成发布用 zip
pwsh.exe -NoProfile -ExecutionPolicy Bypass -File scripts/package-readboard-release.local.ps1

与 LizzieYzy-Next 的关系

本项目是 LizzieYzy-Next 的外接同步工具，宿主侧启动逻辑位于：

lizzieyzy-next/src/main/java/featurecat/lizzie/analysis/ReadBoard.java

涉及启动参数、协议文本、发布目录结构或打包内容的改动，需要同步检查 LizzieYzy-Next。