🎮 Gomoku AI / 五子棋 AI

---

📖 项目介绍

这是一个基于 Avalonia 的桌面五子棋游戏，采用 Minimax 算法配合 Alpha-Beta 剪枝实现 AI 对手。应用面向 Windows 和 Linux， 两个平台共享同一套棋局核心、界面和交互逻辑。

✨ 功能特色

• 🤖 智能 AI 对手：基于 Minimax 算法和 Alpha-Beta 剪枝的传统 AI
• 🎯 三种难度等级：
  • 🐣 简单模式（深度 2）- 适合新手
  • 🐯 中等模式（深度 3）- 适合进阶玩家
  • 🐲 困难模式（深度 4）- 挑战自我！
• ⚫⚪ 自由选择执子：可选择执黑（先手）或执白（后手）
• ↩️ 悔棋功能：支持悔棋（一次悔两步）
• 🌐 跨平台支持：Avalonia 版本支持 Windows 和 Linux
• 🎨 精美界面：简洁直观的游戏界面，带有视觉反馈
• ⚡ 性能优化：
  • 多线程并行计算 AI 落子
  • 智能搜索窗口优化
  • 使用字节数组优化内存占用

🛠️ 技术栈

• 框架：Avalonia 12
• 语言：C# (.NET 10)
• AI 算法：带 Alpha-Beta 剪枝的 Minimax 算法
• 目标平台：Windows、Linux
• 界面：Avalonia XAML + 自定义棋盘控件

🖥️ 运行桌面版

Windows 和 Linux 共用同一个 Desktop 项目：

dotnet restore src/GomokuAI.Desktop/GomokuAI.Desktop.csproj
dotnet run --project src/GomokuAI.Desktop/GomokuAI.Desktop.csproj

当前版本支持难度与执子选择、AI 对局、胜负与和棋判断、悔棋和重新开局。 Windows 和 Linux 共用同一套页面、ViewModel 和棋盘控件。

📋 环境要求

• .NET 10 SDK
• Windows 平台：Windows 10 版本 1809 或更高
• Linux 平台：支持 .NET 10 和 X11/XWayland 的桌面发行版

🎮 游戏玩法

1. 启动应用并选择难度等级
2. 选择执子颜色：黑棋（先手）或白棋（后手）
3. 点击棋盘进行落子
4. AI 会自动完成它的回合
5. 获胜条件：横、竖、斜任意方向连成 5 子
6. 使用悔棋按钮撤销步数
7. 使用重新开始按钮开启新局

🗺️ 开发路线图

• 基于 Minimax 算法的传统 AI
• Avalonia Windows/Linux 桌面版
• 多难度等级
• 悔棋功能
• 基于机器学习的 AI（计划中的未来迭代）
• 在线对战模式
• 游戏统计和历史记录
• 自定义棋盘主题
• Web 版本（考虑中）

🤝 参与贡献

欢迎各种形式的贡献：

• 报告 Bug
• 提出新功能建议
• 提交 Pull Request
• 完善文档

📄 开源协议

本项目为开源项目，可自由使用和修改。

👨‍💻 作者

Mousika2049

---

⭐ 如果这个项目对你有帮助，请给个 Star！

⭐ If you find this project helpful, please give it a star!