棋类对战平台（第二阶段）

作者：陈骁

仓库：GitHub链接

1. 目标与范围

实现一个通用的棋类对战平台，包含五子棋、围棋与黑白棋的本地双人对战：

• 五子棋：任一方连成五子即胜，满盘和棋
• 围棋：支持提子、禁入点（无气点禁止）、虚着；终局通过双方连续虚着判定，简单中国数地法计算胜负（地盘 + 提子数 + 贴目）
• 黑白棋：棋盘填满或双方均无合法着法时，比较子数判胜负
• 通用能力：悔棋、认负、保存/读取局面、重新开始、设置棋盘大小（8~19）

UI 使用 Gradio，点击棋盘落子，美观、响应式。后端与 UI 分离，便于未来扩展更多棋种或接入其他客户端（CLI/GUI）。

2. 架构与设计

2.1 分层架构

• core/ 基础与棋规
  • ai/
    • base.py：AI 接口与基类
    • random_ai.py：一级AI（随机合法落子）
    • reversi_rule_ai.py：二级AI（黑白棋启发式评分，稳定胜过随机）
  • board.py：网格/位置/邻接/序列化
  • rules.py：通用规则算法（五连、气与提子等）
  • game.py：抽象模板（历史快照、悔棋、通用序列化）
  • gomoku.py / go.py：既有棋种实现
  • reversi.py：新增黑白棋实现（本次新增）
  • factory.py：工厂方法扩展，统一规范类型标识
  • go.py：围棋实现（继承 Game，使用气与提子策略）
  • models.py：枚举、异常、数据模型
  • accounts.py：账户模型、仓库、服务
  • replay.py：回放记录与播放器（Recorder、Replayer）
• ui/
  • renderer.py：PIL 渲染（英文文字），复用圆子绘制，支持不同棋种的视觉差异
  • controller.py：UI 控制器（按钮与事件逻辑），扩展对 Reversi 的处理（跳过回合、终局判定、保存/读取）
  • app_ui.py：Gradio UI，两列布局、右侧 Accordion 可隐藏、移动端响应式
• app.py：入口

2.2 关键类与职责

• Position(row, col)：不可变坐标值对象
• Board(size)：网格与棋子持有者，提供 get/set、邻接、遍历、序列化
• PlayerColor(Enum)：BLACK/WHITE；Piece(Enum)：空/黑/白
• Move：落子或特殊动作（虚着、认负）
• Game（抽象）：维护棋盘、当前手、历史、终局状态、保存/读取、模板方法驱动一步走子
• GomokuGame：实现 is_legal、apply_move、check_end、winner 判定
• GoGame：实现合法性（自杀禁手、打劫简单处理可选）、提子逻辑、虚着、终局与数地
• Rule helpers：is_five_in_a_row、find_group_and_liberties、capture_groups
• GameSerializer：将游戏状态保存/读取 JSON（包含棋种、棋盘、历史、当前手）
• UIController：与后端交互，绘图与交互状态（如选择棋种、棋盘大小）
• ImageRenderer：用 PIL 绘制棋盘为图像（避免外部图片 URL）

3. 运行与打包

• 依赖：gradio, pillow
• 运行：python app.py
• 浏览器：自动打开本地地址