MCPcopy Index your code
hub / github.com/atopx/chessboard

github.com/atopx/chessboard @v0.1.2

Chat with this repo
repository ↗ · DeepWiki ↗ · release v0.1.2 ↗ · + Follow
100 symbols 215 edges 16 files 20 documented · 20%
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

中国象棋学习助手 🚩

项目简介

“象棋学习助手”是一款智能化的中国象棋辅助工具。通过实时识别屏幕中的棋盘局面,结合高性能引擎分析,为在线对战平台的玩家提供精准走法建议与策略指导,帮助象棋爱好者快速提升棋艺水平。

✨ 功能亮点

  • 轻量极速
    一键启动,无需繁琐配置,毫秒级别识别与分析,畅享零等待。
  • 🔒 安全可靠
    核心模块采用 Rust 开发,确保内存安全与高并发性能。
  • 🌐 多平台支持
    深度优化 Windows & macOS,同时兼容 Linux,让你随时随地稳如磐石。
  • 🚀 GPU 智能加速
    原生支持 CUDA、DirectML、CoreML 等主流推理框架,全力释放显卡性能。

🎯 核心功能

  • 📷 实时棋盘识别
    基于 YOLOv8 与 ONNX Runtime,精准定位与分类棋子,自动捕捉对局状态。
  • 🤖 智能走法分析
    集成 Pikafish 象棋引擎,提供深度搜索与多变策略,支持分析深度和线程数自定义。
  • 🀄️ 中文招法展示
    将专业分析结果转为易读的中文走法描述,让开局、布局一目了然。
  • 📚 开局库支持
    接入经典开局库,实时给出理论指导,助你构建坚实布局。

🏗 技术架构

前端

  • 框架:Vue 3 + TypeScript
  • UI 组件:Naive UI
  • 桌面发行版:Tauri(轻量化跨平台打包)

后端

  • 变成语言:Rust
  • 棋盘识别:YOLOv8 + ONNX Runtime
  • 象棋引擎:Pikafish(高性能中国象棋引擎)
  • 应用通信:Tauri API

🚀 快速上手

  1. 下载并运行程序
  2. 在弹窗中选择目标窗口
  3. 工具将自动识别棋盘并启动引擎分析
  4. 右侧面板实时展示最佳走法与评分
  5. 可在“设置”中自由调整分析深度、线程数及开局库参数

📸 应用截图

启动界面
主界面分析
参数配置

Linux

linux

🛠 开发计划

  • [x] 基础棋盘识别
  • [x] 引擎分析集成
  • [x] 跨平台适配
  • [x] 可视化配置界面
  • [ ] 自研轻量AI引擎接入
  • [ ] 更多引擎配置项
  • [ ] 开局库接入
  • [ ] 对局数据导出
  • [ ] 个性化学习数据统计
  • [ ] 人机对战模式

📜 许可声明

  1. 本项目基于 Apache-2.0 许可证(LICENSE),永久免费开源,仅供学习与研究使用。
  2. 严禁任何商业化或非法用途。
  3. 使用本工具时,请遵守各平台用户协议,本工具不涉及任何破解或自动化操作。

Core symbols most depended-on inside this repo

new
called by 31
server/src/engine/command.rs
get_piece_name
called by 16
server/src/chess.rs
save
called by 8
server/src/config.rs
overlap_piece_y
called by 7
server/src/chess.rs
update_ui
called by 5
server/src/worker.rs
setoption
called by 5
server/src/engine/mod.rs
analyze_board
called by 4
server/src/worker.rs
board_fen
called by 4
server/src/chess.rs

Shape

Function 48
Method 35
Class 13
Enum 4

Languages

Rust100%

Modules by API surface

server/src/chess.rs30 symbols
server/src/engine/mod.rs20 symbols
server/src/worker.rs16 symbols
server/src/config.rs10 symbols
server/src/yolo.rs6 symbols
server/src/listen.rs6 symbols
server/src/lib.rs3 symbols
server/src/logger.rs2 symbols
server/src/engine/chessdb.rs2 symbols
server/src/common.rs2 symbols
server/src/main.rs1 symbols
server/src/engine/command.rs1 symbols

For agents

$ claude mcp add chessboard \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page