KaTrain

KaTrain 是一款用于分析棋局并结合 KataGo 的 AI 反馈进行围棋对弈的工具：

• 回顾你的对局，找出那些导致最多目数损失的着法。
• 与 AI 对弈，并即时获得错误提示及重试选项。
• 与多种风格、不同强度的弱化版 AI 对战。
• 自动生成功能聚焦的 SGF 回放文件，突出显示你最大的失误。

使用手册

KaTrain 使用手册 预览与 YouTube 视频 安装 配置 KataGo 与 AI 对弈 即时反馈 AI 选择 分析 键盘和鼠标快捷键 参与分布式训练 主题 常见问题解答 支持与贡献

预览与 YouTube 视频

局部定式分析	分析教程	教学棋谱教程

安装

• 请访问 发布页面，下载适用于 Windows 和 macOS 的可执行文件。
• 或者，您也可以使用 pipx install katrain 在任何 64 位操作系统上以隔离环境安装 PyPI 上的最新版本。
• 在 macOS 上，您还可以通过 brew install katrain 来安装该应用。
• 此页面 提供了针对 Windows、Linux 和 macOS 的详细安装说明， 以及故障排除指南和如何配置 KataGo 以使用多块 GPU 的方法。

配置 KataGo

KaTrain 已预装适用于 Windows、Linux 和 M1 之前的 Mac 操作系统的可用 KataGo（OpenCL 版本），以及一个相当老旧的 15 块模型。

要更换模型，只需在应用程序中打开“常规与引擎设置”，然后选择“下载模型”。之后，您就可以从下拉菜单中选择所需的模型。

若要更改 KataGo 的二进制文件，例如切换到 Eigen/CPU 版本以应对没有 GPU 的情况，请点击“下载 KataGo 版本”。随后，您可以在下拉菜单中选择相应的 KataGo 二进制文件。

此外，在 KataGo 发布页面上还提供了 CUDA 和 TensorRT 版本。尤其是后者，在 NVIDIA GPU 上可能带来更出色的性能，但其配置难度也更高：详情请参阅此处。

最后，您还可以覆盖用于启动分析引擎的完整命令行，这在连接远程服务器时非常有用。请注意，KaTrain 使用的是 KataGo 的 分析引擎，而非 GTP 引擎。

与 AI 对弈

• 在主菜单或“新游戏”中选择对弈双方。
• 在教学对局中，KaTrain 会分析您的每一步棋，并自动撤销那些明显不佳的着法。
• 与 AI 对弈时，请注意“撤销”按钮会同时撤销 AI 和您的上一步棋。

即时反馈

棋盘上的圆点表示该步棋导致的目数损失：

• 颜色代表 KataGo 判断的失误程度；
• 圆点大小则反映实际被惩罚的程度——从最大尺寸表示完全被惩罚，到最小尺寸表示对局势无实质性影响。

简而言之，对于水平较低的棋手，应重点关注红色或紫色的大圆点；而高段位棋手则可更多留意较小的失误。如果您希望隐藏棋盘上的某些颜色，或不在 SGF 文件中输出相关细节，可在“教师设置”中进行调整。

AI 介绍

本节将介绍可供选择的 AI。

在“AI 设置”中，经过测试和校准的选项位于顶部且背景较浅，更改这些设置后会显示一个段位估算值。只要未修改其他设置，这一估算通常较为准确。

• 适合认真对弈的推荐选项包括：
  • KataGo 是完整的 KataGo 算法，强度超过职业水平。其分析与反馈始终基于此全强度版本的 KataGo AI。
  • 校准段位机器人 曾通过与多种机器人（如不同强度的 GnuGo 和 Pachi）对弈进行校准，旨在从布局到收官阶段保持均衡的棋风，避免出现重大失误（DDK）。更多讨论请参见 这里 和 这里。
  • 简单风格 更倾向于巩固双方各自地盘的着法，因此棋局相对简洁。
• 较早开发的遗留选项包括：
  • 失分优先 是 KataGo 以常规方式分析局面，但根据预期失分多少来选择下一步棋，从而形成风格多变、以小失误为主的棋风。
  • 策略网络 直接采用策略网络给出的最优着法（即不经过读秒的“棋感”着法）。
  • 策略加权 则根据策略网络的概率分布随机选择一步棋，同样以小失误为主，偶尔也会因缺乏深入计算而出现低级失误。
  • 盲选策略 会随机挑选若干着法，再从中选出最佳的一手，相当于每回合都对棋盘的一部分视而不见。校准段位正是基于类似思路设计的，因此建议优先使用该选项。
• 属于“趣味性与实验性”的选项包括：
  • 盲选策略 的几种变体，它们沿用相同的基本策略，但各有侧重：
    • 局部风格 主要考虑靠近上一手的着法。
    • 脱先风格 则倾向于远离上一手的着法。
    • 影响力风格 多选择四线及以上的着法，形成偏向中央的棋风。
    • 地盘风格 则相反，偏好一二三线的着法。
  • KataJigo 是 KataGo 试图以半目优势取胜的模式，通常会在您犯错时立即回敬一个类似的失误。
  • KataAntiMirror 是 KataGo 假设您正在下镜像围棋，并尝试在您持续如此的情况下打破僵局、争取获利。

基于引擎的 AI（KataGo、失分优先、KataJigo）会受到模型选择以及搜索次数和时限设置的影响；而基于策略网络的 AI 则仅受模型文件选择的影响，无论搜索次数为多少，表现均一致。

关于部分 AI 的更多技术细节及讨论，可参见 life in 19x19 论坛上的这篇帖子：链接。

分析

KaTrain 中的分析功能允许您探索变化分支，并在对局的任何阶段向引擎请求更深入的分析。

快捷键	简要说明	详细信息
Tab	切换分析与对弈模式	在分析模式下，AI 走子、教学模式和计时器等功能均会被暂停。分析选项以及右侧面板和功能的状态会分别保存为“对弈”和“分析”两种模式，方便您快速在简约的“对弈”模式与复杂的“分析”模式之间切换。

屏幕顶部的复选框：

键	简要说明	详情
q	显示子着	默认开启，可关闭以避免遮挡其他信息，或在希望自行猜测下一步时使用。
w	显示所有点	切换是否在最后几步棋上显示彩色的评估“点”。您可以在“教学/分析设置”中配置这些阈值，以及针对最后多少步棋显示这些点。
e	最佳着	显示 KataGo 认为的下一步着法，按其预期的目数损失程度进行着色。较小或较淡的点表示不确定性较高，且不会显示文字（低于您的“快速访问”设置）。将鼠标悬停在任意一个点上即可查看主变化线。
r	策略着	显示 KataGo 的策略网络评估结果，即仅根据当前局面、在不进行任何“读秒”的情况下，它认为的最佳下一步落子位置。此功能会关闭“最佳着”设置，因为两者经常存在重叠，意义不大。
t	预期地盘	显示每个交叉点的预期归属情况。

“分析”按钮下的分析选项用于对当前局面进行更深入的评估：

键	简要说明	详细说明
a	更深入分析	使用更多访问次数重新评估局面，通常会得到更准确的评估结果。
s	统一访问次数	将当前显示的所有下一步着法，都重新评估到与当前最佳着法相同的访问次数。这有助于提高对不确定性较高的建议的信心。
d	分析所有着法	评估所有可能的下一步着法。即使使用“快速访问”模式，这仍然可能需要一些时间，但可以帮助你了解有多少合理的下一步着法可供选择。
f	寻找替代方案	将当前候选着法的分析深度至少提升到“快速访问”级别，并请求一个新的查询，排除所有当前的候选着法。
g	选择兴趣区域	设置一个区域，只搜索该区域内的着法。非常适合解死活题。需要注意的是，由于需要确定最佳着法的基准，且对手在变化中可能会脱先，因此部分结果可能会出现在所选区域之外。
h	重置分析	这会将分析恢复到引擎正常查询后返回的状态，移除任何额外的探索内容。
i	开始插入模式	允许你插入着法，以改进分析，特别是在双方都忽视了重要的交换或生死局面时。再次按下即可停止插入，并复制剩余的分支。
l	将棋局一直下到终局，并以折叠分支的形式添加，以便可视化失误可能带来的影响	这会在后台进行，也可以同时在多个节点上启动，以便比较不同起始位置的结果。
空格	开启或关闭连续分析。	这将不断改进当前局面的分析，类似于 Lizzie 的“思考”功能，但仅在没有其他查询进行时才会生效。
Shift + 空格	同上，但在“最佳着法”提示关闭时不会自动开启。
Enter	AI 走子	不论当前轮到哪一方，都会让 AI 为当前方走一步棋。
F2	更深入的全盘分析	将整盘棋分析到更高的访问次数。
F3	性能报告	显示双方的性能统计概览。
F10	死活题框架	在角落或边上放置好死活题后，使用此功能填充棋盘的其余部分，以提高 AI 解决死活问题的能力。

键盘和鼠标快捷键

除了上述提到的快捷键以及主菜单中显示的那些之外：

键位	简要说明	详细说明
Alt	打开主菜单
~ 或 ` 或 F12	循环切换更简约的界面模式
k	切换棋盘坐标显示
p	过子
Pause	暂停/继续计时
← 或 z	撤销一步	按住 Shift 键可一次撤销 10 步，按 Ctrl 键则跳转到对局开始处。
→ 或 x	恢复一步	按住 Shift 键可一次恢复 10 步，按 Ctrl 键则跳转到对局结束处。
↑/↓	切换分支	行棋树中的正常操作。
Home/End	跳转到对局的开头/结尾
PageUp	将当前选中的节点设为主分支
Ctrl + Delete	删除当前节点
c	折叠/展开从当前节点到上一个分岔点的分支
b	回到上一个分岔点
Shift + b	回到主分支
n	跳转到人类棋手下出的下一个失误（橙色或更差）之前的一手	类似于点击向前的红色箭头
Shift + n	跳转到人类棋手下出的上一个失误之前的一手	类似于点击向后的红色箭头
鼠标滚轮	恢复/撤销步数，或滚动浏览主要变例	当光标悬停在右侧面板时：恢复/撤销步数。当光标悬停在候选步上时：滚动浏览主要变例。
中键单击	将主要变例添加到行棋树	滚动时，仅会添加你正在查看位置之前的步数。
点击某一步	查看该步的详细统计数据	包括原本的最佳变例，而非当前这一步
双击某一步	直接跳转到该步之前的位置
Ctrl + v	从剪贴板加载 SGF 文件，并对对局进行“快速”分析	对最后一步会进行高优先级的常规分析。
Ctrl + c	将 SGF 保存到剪贴板
Escape	停止所有分析

参与分布式训练

自2020年12月起，KataGo启动了分布式训练功能。这使得广大用户能够共同生成自我对弈棋局，从而提升KataGo的棋力并训练更大规模的模型。

KaTrain 1.8.0及以上版本让参与分布式训练变得非常简单：只需在主菜单中选择相应选项，注册一个账号，然后点击“运行”即可。在此模式下，您主要可以做的就是观看对局。

请注意，未完成的对局不会上传，因此为了更有效地贡献算力，建议至少持续运行一小时以上，最好能运行数小时。

在该模式下，一些键盘快捷键具有特殊功能：

键	简要说明	详细信息
空格	在手动浏览当前对局和自动推进之间切换	并自动推进它。
Esc	向KataGo发送quit命令	这将启动缓慢的关闭过程，完成正在进行中的对局但不再开始新的对局。仅适用于v1.11及以上版本。
Pause	通过pause和resume命令暂停/恢复贡献	KataGo v1.11版本引入的功能

主题

有关如何修改界面外观、颜色，以及创建或安装主题，请参阅这些说明。

常见问题解答

• 程序运行得太慢了，该如何加快速度？
  • 可以在设置中调整访问次数或最大允许时间。
• KataGo 出现“内存不足”的错误而崩溃，该如何避免？
  • 尝试在KataGo/analysis_config.cfg文件中降低nnMaxBatchSize的数值，并避免使用编译时设置了大尺寸棋盘的版本。
  • 如果仍然遇到问题，请单独启动KataGo，查看其是否报错。
  • 请注意，如果您没有GPU，或者您的GPU不支持OpenCL，则应使用仅能在CPU上运行的“eigen”二进制文件。
• 字体太小
  • 在某些超高分辨率显示器上，对话框和其他包含文本的元素可能会显得过小。请参考这些说明进行调整。
• 应用程序因“无法找到任何有价值的cutbuffer提供者”错误而崩溃
  • 使用sudo apt-get install xclip安装xclip工具。

支持与贡献

• 欢迎提出想法、反馈，以及对代码或翻译的贡献。
  • 对于改进建议和计划中的功能，请先查看GitHub上的开放问题，确认相关功能是否已在规划中。
• 您可以加入计算机围棋社区Discord（原Leela Zero & Friends）（使用#gui频道），获取帮助、讨论改进方案，或只是表达您的支持。请勿使用GitHub的问题来寻求技术支持，此处仅用于报告Bug、提出建议及讨论贡献事宜。

KaTrain 快速上手指南

KaTrain 是一款基于 KataGo 引擎的围棋 AI 辅助工具，支持对弈复盘、实时错误反馈及生成重点失误报告。

环境准备

• 操作系统：Windows, macOS (Intel/M1), Linux (64 位)。
• 硬件要求：
  • GPU 加速（推荐）：支持 OpenCL、CUDA 或 TensorRT 的显卡可获得最佳性能。
  • CPU 运行：若无独立显卡，可使用 CPU 版本（速度较慢）。
• 前置依赖：
  • 若使用预编译包：无需额外依赖。
  • 若使用 Python 安装：需安装 Python 3.8+ 及 pipx（推荐用于隔离环境）。

安装步骤

方法一：下载预编译包（推荐新手）

访问 GitHub Releases 页面 下载对应系统的可执行文件：

• Windows: 下载 .exe 安装包。
• macOS: 下载 .dmg 或 .app 文件。
• Linux: 下载对应的二进制包。

方法二：使用包管理器安装

macOS (Homebrew):

brew install katrain

任意 64 位系统 (Python pipx): 建议使用 pipx 在隔离环境中安装，避免依赖冲突：

pipx install katrain

方法三：源码安装与多 GPU 配置

如需详细配置多 GPU 或解决特定系统问题，请参考官方 INSTALL.md。

基本使用

1. 配置 KataGo 引擎

启动 KaTrain 后，默认已内置基础版 KataGo (OpenCL 版本 + 15 block 模型)。建议根据硬件优化配置：

• 进入菜单 General and Engine settings。
• 点击 Download models：从下拉菜单选择更强的权重模型（如较新的 Block 数模型）。
• 点击 Download KataGo versions：
  • 无 GPU 用户：选择 Eigen/CPU 版本。
  • NVIDIA 显卡用户：建议手动下载并配置 CUDA 或 TensorRT 版本以获得更高性能（需在 KataGo 发布页获取二进制文件）。

2. 与 AI 对弈 (Play against AI)

• 在主菜单或 New Game 中选择对手。
• 教学模式 (Teaching Game)：
  • 开启后，若你的着手亏损过大，AI 会自动提示并允许悔棋重试。
  • 实时反馈：棋盘上的圆点代表该手的亏损目数。
    • 颜色：表示错误严重程度（红色/紫色为严重失误）。
    • 大小：表示该错误是否被对手惩罚（大圆点表示已被惩罚，小圆点表示未影响胜负）。
• 悔棋注意：在对弈模式下点击 "Undo" 将同时撤销你和 AI 的最新一手。

3. 棋局分析 (Analysis)

• 按 Tab 键在“对弈模式”和“分析模式”间切换。
• 在分析模式下，计时器和自动落子暂停，你可自由探索变化图。
• 右键点击棋盘或使用右侧面板请求深度分析。
• 生成报告：分析结束后，可自动生成聚焦于重大失误的 SGF 复盘文件。

4. 常用快捷键

按键	功能描述
Tab	切换分析模式与对弈模式
鼠标右键	请求当前局面深度分析
鼠标滚轮	调整分支变化图

提示：KaTrain 使用的是 KataGo 的 Analysis Engine 而非 GTP 引擎，配置远程服务器时请注意命令差异。