katrain

katrain

katrain是一个用于分析游戏并根据 KataGo 的 AI 反馈进行围棋的工具：

• 检查您的游戏，找出失分成本最高的动作。
• 与人工智能对战，立即获得错误反馈，并可以选择重试。
• 与各种风格各异的弱化版人工智能对战。
• 自动生成有针对性的 SGF 评论，显示您最大的错误。

手动的

katrain 手动的 预览和 YouTube 视频 安装 配置 KataGo 与人工智能对战 即时反馈 人工智能 分析 键盘和鼠标快捷键 为分布式训练做出贡献 主题 常问问题 支持/贡献

预览和 YouTube 视频

局部定式分析	分析教程	教学游戏教程

安装

• 请参阅发布页面，了解适用于 Windows 和 macOS 的可下载可执行文件。
• 或者使用pip3 install -U katrain在任何 64 位操作系统上安装 PyPI 的最新版本。
• 在macOS上，您还可以使用brew install katrain来安装该应用程序。
• 此页面包含针对 Window、Linux 和 macOS 的详细说明，以及故障排除和设置 KataGo 以使用多个 GPU 的信息。

配置 KataGo

katrain预先打包了适用于 Windows、Linux 和 M1 之前的 Mac 操作系统的可用 KataGo（OpenCL 版本）以及相当旧的 15 块模型。

要更改模型，请打开应用程序中的“常规和引擎设置”，然后打开“下载模型”。然后，您可以从下拉菜单中选择所需的型号。

要更改 katago 二进制文件，例如，如果您没有 GPU，则更改为 Eigen/CPU 版本，请单击“下载 KataGo 版本”。然后，您可以从下拉菜单中选择 KataGo 二进制文件。 KataGo 发布网站上还提供 CUDA 和 TensorRT 版本。特别是后者可能在 NVIDIA GPU 上提供更好的性能，但设置起来会更困难：请参阅此处了解更多详细信息。

最后，您可以覆盖用于启动分析引擎的整个命令，这对于连接到远程服务器非常有用。请记住， katrain使用 KataGo 的分析引擎，而不是 GTP 引擎。

与人工智能对战

• 在主菜单或“新游戏”下选择玩家。
• 在教学游戏中， katrain会分析你的动作并自动撤消那些足够糟糕的动作。
• 当与人工智能对战时，请注意“撤消”按钮将撤消人工智能和你的最后一步。

即时反馈

移动中的点表示该移动损失了多少分。

• 颜色表示根据 KataGo 的错误大小
• 大小表明错误是否确实受到了惩罚。从最大尺寸时受到完全惩罚，到最小尺寸时对分数没有实际影响。

简而言之，如果您是较弱的玩家，您应该主要关注红色或紫色的大点，而较强的玩家可以更多地关注较小的错误。如果您想隐藏板上的某些颜色，或者不在 SGF 中输出它们的详细信息，您可以在“配置教师”下执行此操作。

人工智能

本节介绍可用的 AI。

在“AI设置”中，经过测试和校准的设置位于顶部，颜色较浅，更改这些设置将显示排名的估计。只要您没有更改其他设置，此估计就应该相当准确。

• 严肃游戏的推荐选项包括：
  • KataGo是完整的KataGo，高于专业水平。给出的分析和反馈始终基于强大的 KataGo AI。
  • 校准排名机器人在各种机器人（例如不同强度设置的 GnuGo 和 Pachi）上进行了校准，以便从开局到残局进行平衡的游戏，而不会犯下严重的 (DDK) 错误。进一步的讨论可以在这里和这里找到。
  • 简单风格喜欢巩固双方玩家领地的动作，从而导致相对简单的动作。
• 早期开发的遗留选项包括：
  • ScoreLoss是 KataGo 像往常一样进行分析，但根据预期的分数损失从潜在的走法中进行选择，从而导致风格多样，大多是小错误。
  • 策略使用策略网络中的顶部移动（它是“形状感知”，无需阅读）。
  • 策略加权选择由策略加权的随机举动，导致风格多样，大多是小错误，偶尔也会因缺乏阅读而出现错误。
  • 盲策略随机选择一些走法，并选择其中最好的走法，每回合对棋盘的一部分实际上是“盲”的。校准排名基于相同的想法，并且推荐使用此选项。
• 更“有趣和实验”的选项包括：
  • 盲目策略的变体，使用相同的基本策略，但有所不同：
    • 局部风格将主要考虑接近最后一步的动作。
    • Tenuki Style会考虑远离最后一步的大部分动作。
    • 有影响力的风格将主要考虑 4 线以上的移动，从而形成以中心为导向的风格。
    • 领地风格偏向于相反的方向，偏向 1-3 线移动。
  • KataJigo是 KataGo 试图以 0.5 分获胜，通常是通过立即错误来回应你的错误。
  • KataAntiMirror是 KataGo，假设您正在玩镜像围棋，并尝试突破它并从中获利。

基于引擎的 AI（KataGo、ScoreLoss、KataJigo）受模型和访问选择以及最大时间的影响，而基于策略网的 AI 受模型文件选择的影响，但在 1 次访问时工作方式相同。

有关其中一些人工智能的更多技术细节和讨论可以在 19x19 论坛的 life 的这个帖子中找到。

分析

katrain中的分析选项允许您在游戏中的任何时刻探索变化并请求引擎进行更深入的分析。

钥匙	简短描述	细节
选项卡	在分析和播放模式之间切换	AI动作、教学模式和计时器在分析模式下暂停。分析选项以及右侧面板和选项的状态是独立保存的“播放”和“分析”，使您可以在更简约的“播放”模式和更复杂的“分析”模式之间快速切换。

屏幕顶部的复选框：

钥匙	简短描述	细节
q	显示子动作	默认情况下打开，可以将其关闭以避免模糊其他信息或在想要猜测下一步行动时。
w	显示所有点	切换是否在最后几次移动中显示彩色评估“点”。您可以配置阈值，以及在“教学/分析设置”下显示的最后移动次数。
e	热门动作	显示 KataGo 考虑的下一步行动，并按预期失分进行着色。小/微弱的点表示高度不确定性，并且从不显示文本（低于您的“快速访问”设置）。将鼠标悬停在其中任何一个上即可查看主要变化。
r	政策举措	显示 KataGo 的政策网络评估，即它认为下一步最好的行动纯粹是从立场出发，并且没有任何“解读”。这会关闭“顶部移动”设置，因为重叠通常没有用处。
t	预期领土	显示每个交叉路口的预期所有权。

“分析”按钮下可用的分析选项用于对职位进行更深入的评估：

钥匙	简短描述	细节
一个	更深入的分析	通过更多访问来重新评估职位，通常会得到更准确的评估。
s	均衡访问	重新评估当前显示的所有后续动作，其访问次数与当前最高动作相同。有助于增强对具有高度不确定性的建议的信心。
d	分析所有动作	评估所有可能的下一步行动。即使使用“fast_visits”，这也可能需要一些时间，但对于查看有多少合理的下一步可用是有用的。
f	寻找替代方案	将当前候选动作的分析增加到至少“快速访问”级别，并请求排除所有当前候选动作的新查询。
克	选择感兴趣的领域	设置一个区域并仅搜索此框中的移动。非常适合解决 tsumegos。请注意，由于建立了最佳移动的基线，某些结果可能会出现在框外，并且对手可以进行各种变化。
小时	重置分析	这会将分析恢复为引擎在正常查询后返回的结果，从而消除任何额外的探索。
我	启动插入模式	允许您插入动作，以在双方玩家都忽略重要的交流或生死攸关的情况时改进分析。再次按下可停止插入并复制分支的其余部分。
我	玩游戏直到最后并添加为折叠分支，以可视化错误的潜在影响	这是在后台完成的，并且可以在比较不同起始位置的结果时同时在多个节点上启动。
空间	打开/关闭连续分析。	这将不断改进对当前位置的分析，类似于 Lizzie 的“思考”，但前提是没有其他查询正在进行。
Shift +空格键	如上所述，但关闭时不会打开“顶级动作”提示。
进入	人工智能移动	无论当前玩家选择如何，AI 都会为当前玩家移动。
F2	更深入的完整比赛分析	分析整个游戏以获得更高的访问量。
F3	绩效报告	显示两名球员的表现统计数据概览。
F10	妻吾框架	将生死问题放置在角落/侧面后，用它来填充棋盘的其余部分，以提高AI解决生死问题的能力。

键盘和鼠标快捷键

除了上面提到的快捷方式和主菜单中显示的快捷方式之外：

钥匙	简短描述	细节
替代	打开主菜单
~或`或F12	循环切换更简约的 UI 模式
k	切换板坐标的显示
p	经过
暂停	暂停/恢复计时器
←或z	撤消移动	按住 Shift 键一次移动 10 步，或按住 Ctrl 键跳到开头。
→或x	重做移动	按住 Shift 键一次移动 10 步，或按住 Ctrl 键跳到最后。
↑ / ↓	切换分支	正如移动树所期望的那样。
首页/完	转到游戏开始/结束
向上翻页	使当前选定的节点为主分支
Ctrl +删除	删除当前节点
c	折叠/展开从当前节点到上一个分支点的分支
乙	返回上一个分支点
Shift + b	返回主分支
n	转到人类玩家下一个错误（橙色或更严重）之前的一步	就像单击向前的红色箭头一样
Shift + n	转到上一个错误之前的一步	就像单击向后的红色箭头一样
滚动鼠标	重做/撤消移动或滚动主要变化	将光标悬停在右侧面板上时：重做/撤消移动。将鼠标悬停在候选动作上时：滚动浏览主要变体。
中间滚轮点击	向移动树添加主要变化	滚动时，只会添加到您正在查看的点。
单击移动	查看先前举动的详细统计数据	除了预期的变化以外，最好的替代方案是
双击移动	直接导航到游戏中该点之前的位置
Ctrl + v	从剪贴板加载 SGF 并对游戏进行“快速”分析	对最后一步进行高优先级的正常分析。
Ctrl + c	将 SGF 保存到剪贴板
逃脱	停止所有分析

为分布式训练做出贡献

从2020年12月开始，KataGo开始分布式训练。这使得人们都可以帮助生成自玩游戏，以增强 KataGo 的实力并训练更大的模型。

katrain 1.8.0+ 可以轻松地为分布式训练做出贡献：只需从主菜单中选择选项，注册一个帐户，然后单击运行。在此模式下，您除了观看比赛之外几乎不能做任何事情。

请记住，部分游戏不会上传，因此最好计划使其运行至少一个小时（如果不是几个小时），以获得最有效的贡献。

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

钥匙	简短描述	细节
空间	在手动导航当前游戏之间切换	并自动推进它。
逃脱	向 KataGo 发送quit命令	这会开始缓慢的关闭，完成部分游戏但不开始新的游戏。仅适用于 v1.11+。
暂停	通过pause和resume命令暂停/恢复贡献	KataGo v1.11 中引入

主题

请参阅这些说明，了解如何修改任何图形或颜色的外观以及创建或安装主题。

常问问题

• 程序运行速度太慢。我怎样才能加快速度？
  • 调整设置中允许的访问次数或最长时间。
• KataGo 因“内存不足”错误而崩溃，我该如何防止这种情况发生？
  • 尝试在KataGo/analysis_config.cfg中使用较小的nnMaxBatchSize数字，并避免使用使用大板尺寸编译的版本。
  • 如果仍然遇到问题，请自行启动 KataGo 以检查它是否给出任何错误。
  • 请注意，如果您没有 GPU，或者您的 GPU 不支持 OpenCL，则应使用仅在 CPU 上运行的“eigen”二进制文件。
• 字体太小
  • 在某些超高分辨率显示器上，对话框和其他带有文本的元素可能会显得太小。请参阅这些说明来调整它们。
• 该应用程序崩溃并出现“无法找到任何有价值的剪切缓冲区提供程序”的错误
  • 使用sudo apt-get install xclip xclip 安装 xclip

支持/贡献

• 非常欢迎提出想法、反馈以及对代码或翻译的贡献。
  • 有关建议和计划的改进，请参阅 github 上的未解决问题以检查该功能是否已计划。
• 您可以加入 Computer Go 社区 Discord（以前称为 Leela Zero & Friends）（使用 #gui 频道）来获取帮助、讨论改进或只是表达您的谢意。请不要使用 github issues 来寻求技术帮助，这仅用于 bug、建议和讨论贡献。