Skip to content

USER_GUIDE.md

Latest commit

 

History

History
317 lines (223 loc) · 7.55 KB

USER_GUIDE.md

File metadata and controls

317 lines (223 loc) · 7.55 KB

GoSim 围棋模拟器使用指南

快速开始

启动应用

# 开发模式
npm run dev

# 生产模式（需先构建）
npm run build
npm start

界面说明

主界面布局

┌─────────────────────────────────────────────────────┐
│  GoSim - 围棋AI对弈模拟器                            │
├──────────────┬──────────────────────┬───────────────┤
│              │                      │               │
│  控制面板    │      棋盘显示区      │   统计信息    │
│              │                      │               │
│  - 游戏控制  │                      │   - 手数统计  │
│  - AI设置    │                      │   - 提子统计  │
│  - 速度控制  │                      │   - 胜率分析  │
│              │                      │               │
└──────────────┴──────────────────────┴───────────────┘

功能详解

1. AI 引擎选择

在左侧控制面板的 AI设置 区域，你可以为黑方和白方分别选择 AI 引擎：

可用引擎

引擎 描述 推荐用途
Mock 引擎 随机走子的测试引擎 开发测试、快速演示
Pachi 基于 MCTS 的开源引擎 正常对弈、学习观摩
GNU Go 经典开源围棋引擎 传统算法对比
KataGo 神经网络引擎（最强） 高水平对弈分析
Leela Zero 神经网络引擎 高水平对弈

选择步骤

  1. 在 黑方AI 或 白方AI 区域
  2. 点击 引擎类型 下拉菜单
  3. 选择你想使用的引擎
  4. 调整 强度 滑块（1-10）

2. 棋盘设置

棋盘大小

支持三种标准棋盘：

  • 9×9: 快速对弈，适合初学者
  • 13×13: 中等规模，平衡速度和复杂度
  • 19×19: 标准围棋棋盘

规则设置

  • 贴目: 默认 6.5 目（中国规则）
  • 让子: 支持 0-9 子让子对弈

3. 游戏控制

开始对弈

  1. 配置好 AI 引擎和棋盘设置
  2. 点击 开始对弈 按钮
  3. 系统会自动初始化引擎并开始对弈

对弈控制

  • 暂停: 暂停当前对弈，可以查看棋局
  • 继续: 从暂停状态恢复对弈
  • 停止: 结束当前对弈，显示最终结果

速度控制

使用 对弈速度 滑块调整 AI 思考和落子的速度：

  • 1-3: 慢速，便于观察每一步
  • 4-6: 中速，正常观看速度
  • 7-10: 快速，快速完成对弈

4. 统计信息

右侧面板实时显示：

  • 手数: 当前对弈进行的手数
  • 当前回合: 黑方或白方
  • 提子数: 黑白双方的提子统计
  • 游戏状态: 对弈中、已暂停、已结束等

使用场景

场景 1: 快速测试（Mock 引擎）

目的: 测试界面功能，快速演示

配置:

  • 黑方: Mock 引擎，强度 5
  • 白方: Mock 引擎，强度 5
  • 棋盘: 9×9
  • 速度: 8-10（快速）

特点: 随机走子，速度快，适合测试

场景 2: 观摩学习（Pachi 引擎）

目的: 观看 AI 对弈，学习围棋技巧

配置:

  • 黑方: Pachi，强度 6-7
  • 白方: Pachi，强度 6-7
  • 棋盘: 19×19
  • 速度: 3-5（中速）

特点: 有一定棋力，走子合理，适合学习

场景 3: 高水平对弈（KataGo）

目的: 观看高水平 AI 对弈

配置:

  • 黑方: KataGo，强度 8-10
  • 白方: KataGo，强度 8-10
  • 棋盘: 19×19
  • 速度: 1-3（慢速）

特点: 职业水平，需要较长思考时间

场景 4: 引擎对比

目的: 对比不同引擎的风格

配置:

  • 黑方: Pachi，强度 7
  • 白方: GNU Go，强度 7
  • 棋盘: 19×19
  • 速度: 4-5（中速）

特点: 观察不同算法的对弈风格差异

引擎配置

Pachi 引擎

强度说明

强度 Playouts 思考时间 棋力估计 适用场景
1-3 1K-5K 10秒 业余初段 快速对弈
4-6 10K-50K 15秒 业余3-5段 正常对弈
7-9 100K-500K 30秒 业余5-7段 高质量对弈
10 1M 30秒 接近职业 最高水平

路径配置

默认路径: engines/pachi/pachi.exe

如需修改，在设置中配置引擎路径。

其他引擎

其他引擎（GNU Go、KataGo、Leela Zero）需要：

  1. 下载对应的引擎程序
  2. 在设置中配置引擎路径
  3. 确保引擎支持 GTP 协议

常见问题

Q1: 引擎启动失败

可能原因:

  • 引擎路径配置错误
  • 引擎文件不存在或损坏
  • 杀毒软件阻止执行

解决方案:

  1. 检查引擎路径是否正确
  2. 确认 engines/pachi/pachi.exe 存在
  3. 临时关闭杀毒软件测试
  4. 查看控制台日志获取详细错误

Q2: AI 思考时间过长

可能原因:

  • 强度设置过高
  • 电脑性能不足

解决方案:

  1. 降低 AI 强度（减少 playouts）
  2. 使用较小的棋盘（9×9 或 13×13）
  3. 使用 Mock 引擎进行快速测试

Q3: 界面无响应

可能原因:

  • 引擎进程卡死
  • 内存不足

解决方案:

  1. 点击 停止 按钮
  2. 重启应用
  3. 降低 AI 强度
  4. 关闭其他占用资源的程序

Q4: 控制台报错 "Failed to fetch"

说明: 这是 DevTools 自身的错误，不影响应用功能。

解决方案: 可以忽略，或关闭 DevTools 后重新打开。

快捷键

快捷键 功能
Ctrl+N 开始新对弈
Space 暂停/继续
Ctrl+S 停止对弈
Ctrl+, 打开设置
F11 全屏切换
Ctrl+Q 退出应用

高级功能

棋谱保存（开发中）

未来版本将支持：

  • 自动保存对弈棋谱（SGF 格式）
  • 手动导出棋谱
  • 导入棋谱回放

分析功能（开发中）

未来版本将支持：

  • 胜率曲线图
  • 关键手分析
  • 变化图推演

多引擎对比（开发中）

未来版本将支持：

  • 同时运行多个引擎
  • 引擎推荐着法对比
  • 引擎评分对比

性能优化建议

推荐配置

最低配置:

  • CPU: 双核 2.0GHz
  • 内存: 4GB
  • 系统: Windows 10+

推荐配置:

  • CPU: 四核 3.0GHz+
  • 内存: 8GB+
  • 系统: Windows 10/11

优化建议

  1. 快速测试: 使用 Mock 引擎 + 9×9 棋盘
  2. 正常使用: Pachi 强度 5-6 + 19×19 棋盘
  3. 高质量对弈: Pachi 强度 7-8，关闭其他程序
  4. 批量对弈: 降低速度，使用后台运行

技术支持

日志查看

开发模式下，按 F12 打开 DevTools 查看：

  • Console: 运行日志和错误信息
  • Network: 网络请求（如有）
  • Performance: 性能分析

问题反馈

如遇到问题，请提供：

  1. 操作系统版本
  2. 应用版本号
  3. 错误截图
  4. 控制台日志
  5. 复现步骤

更新日志

v1.0.0 (2026-02-13)

新增功能:

  • ✅ 支持 Pachi 引擎
  • ✅ AI 引擎选择界面
  • ✅ 强度可调节（1-10 级）
  • ✅ 多种棋盘尺寸（9/13/19 路）
  • ✅ 对弈速度控制
  • ✅ 实时统计显示

已知问题:

  • DevTools 控制台有 "Failed to fetch" 警告（不影响功能）
  • 部分引擎（KataGo、Leela）需要手动配置路径

后续计划:

  • 棋谱保存和回放
  • 胜率分析图表
  • 更多引擎集成
  • 多语言支持

祝你使用愉快！ 🎮♟️