如何使用YaneuraOu：世界最强将棋AI引擎的完整入门指南 🎯

YaneuraOu是一款屡获殊荣的将棋AI引擎，曾荣获WCSC29世界冠军，采用先进的深度学习技术和并行搜索算法，为将棋爱好者提供专业级对战体验和教育功能。无论是初学者还是专业棋手，都能通过这款开源引擎提升棋艺，探索将棋的无限可能。

🚀 核心功能亮点

🏆 冠军级对战能力

基于深度神经网络（NNUE）和传统评估函数（KPPT/KPP_KKPT）双重架构，实现毫秒级精准局面评估。支持256线程并行搜索，在复杂局面中也能快速找到最优解。

📚 教育与研究工具

内置局面分析、定跡生成和棋谱记录功能，帮助用户理解AI决策逻辑。提供详细的搜索参数配置，支持自定义评估函数权重，适合AI算法研究者深入探索。

💻 跨平台兼容性

完美支持Windows、Linux、macOS及ARM架构设备，提供预编译版本和源码编译选项。移动端通过JNI接口实现高效运行，随时随地享受对弈乐趣。

YaneuraOu赞助者横幅

⚡ 快速开始指南

🔧 系统要求

• 最低配置：64位CPU（支持SSE2）、4GB内存、100MB存储空间
• 推荐配置：多核CPU（支持AVX2）、16GB内存、NVIDIA GPU（加速深度学习推理）

📥 一键安装步骤

Windows系统

1. 从项目仓库克隆源码：
   git clone https://gitcode.com/gh_mirrors/ya/YaneuraOu
2. 运行Visual Studio解决方案：YaneuraOu.sln
3. 选择目标平台（x64/AVX2），点击"生成"即可自动编译

Linux/macOS系统

cd YaneuraOu/script
chmod +x mingw_gcc.sh
./mingw_gcc.sh  # 自动检测系统环境并编译

🎮 首次运行体验

1. 启动引擎后，通过USI协议与将棋GUI连接（推荐ShogiGUI或Bonanza）
2. 基础命令示例：
   • position startpos moves 7g7f 8c8d 设置初始局面并添加 moves
   • go depth 15 搜索深度15的最佳走法
   • eval 显示当前局面评估值

🛠️ 高级配置指南

⚙️ 性能优化参数

在source/config.h中可调整核心参数：

• MAX_PLY_NUM：最大搜索深度（默认246）
• TT_CLUSTER_SIZE：置换表集群大小（推荐设为4提升缓存效率）
• USE_AVX2：启用AVX2指令集加速（现代CPU推荐开启）

📊 评估函数选择

根据硬件条件选择合适的评估模式：

• NNUE模式：#define YANEURAOU_ENGINE_NNUE（需要50-500MB模型文件）
• 传统模式：#define YANEURAOU_ENGINE_KPPT（轻量快速，适合低配置设备）
• 深度学习模式：#define YANEURAOU_ENGINE_DEEP（需TensorRT/ONNX Runtime支持）

📖 实战应用场景

🏫 教学辅助工具

• 使用help-mate-search模块（old_engines/engines/help-mate-engine/）练习诘将棋
• 通过policybook功能（source/book/policybook.cpp）学习职业棋手开局策略

🤖 AI研究平台

• 自定义评估函数：修改source/eval/nnue/下的神经网络架构
• 训练新模型：启用EVAL_LEARN宏，使用learn命令从棋谱中学习权重

🎯 比赛竞技配置

//  tournament优化配置示例（source/config.h）
#define FOR_TOURNAMENT
#define ENABLE_QUICK_DRAW  // 简化重复局面检测
#undef ENABLE_TEST_CMD    // 禁用调试命令提升性能

📚 资源与支持

📄 官方文档

• 安装指南：docs/最初に：やねうら王遊び方説明.txt
• 命令参考：docs/USI拡張コマンド.txt
• 源码解析：docs/解説.txt

🌟 社区贡献

YaneuraOu开源社区欢迎贡献代码、报告bug或分享使用经验。主要开发方向包括：

• 移动端性能优化
• 新型神经网络架构集成
• 多语言界面支持

🎉 为什么选择YaneuraOu？

作为持续更新的顶级将棋AI，YaneuraOu不仅提供专业级对战体验，更开放全部核心技术供学习研究。其模块化设计允许用户按需定制功能，从休闲对弈到学术研究均能完美适配。立即加入全球10万+将棋爱好者的行列，探索AI与传统棋艺结合的无限可能！

🔍 提示：定期查看docs/更新履歴.txt获取最新功能和性能优化信息