katago下载安装配置至sabaki教程

先放本人准备的资源：（不定期更新，上次更新时间：2023/9/6）

• katago引擎(v1.13.0，GPU，windows)+权重压缩包。阿里云盘下载
  权重是目前katago自对战评级的顶级版本之一（kata1-b18c384nbt-s7192213760-d3579182099）。
• sabaki安装包(v0.52.2，windows)，自带中文。阿里云盘下载

以上资源分别来自开源地址：

• https://github.com/lightvector/KataGo（可以在这里下载最新的katago引擎）
• https://github.com/SabakiHQ/Sabaki

另附katago官方的权重下载地址： https://katagotraining.org/networks/
感兴趣的小伙伴可自行在官方网址挑选最新最强的katago权重（当然也有早期幼小的katago权重）
除此之外，你还可以在那里看到katago训练的每一盘棋，或者注册账号，加入katago的分布式训练，顺便贡献榜上留名做纪念等等。

感谢开源贡献者们

---

下面进入正题

教程最后编写时间：2022/8/15，一些细节可能对不上，不用在意就OK。

第一部分：自动生成katago配置文件

1. 下载好我准备的两个资源之后，找到下载文件的位置，文件夹名字叫:katago-v1.13.0-opencl-windows-x64

2. 点进去就是katago引擎的文件夹，内有我事先添加进去的权重文件，叫这个名字：model.txt
   注意！先将其重命名为model.bin。
   找不到model.txt文件只有model文件的同学，你右键model文件，点击属性，然后去改。注意是改后缀，不要重命名了但是后缀没变，那没有用。
   （解释一下多做这一步的原因：阿里云盘不支持分享压缩文件，于是改一下后缀用来绕过限制。这个限制真的很奇怪）
   

3. 改完后，往文件浏览器的地址栏里输入cmd，然后回车：
   

4. cmd窗口唤出后，输入这条命令：
   katago.exe genconfig -model model.bin -output gtp_custom.cfg
   然后回车。

5. 不出意外的话会看到这个这个提问：
   
   这是问katago默认的围棋规则是什么，我们这里就选中国规则，输入：
   chinese
   然后回车，感兴趣的同学可以自行了解其他规则。

6. 第二个提问：
   
   这是问katago要不要对读秒之类的时间规则加个额外限制，我们这里选不用。输入：
   n
   接着看到提示：
   没事，继续回车。

7. 第三个提问：
   
   这是问是否允许katago在对手读秒的时候思考，然后这么做要注意什么巴拉巴拉，默认是否。所以我们直接回车。

8. 第四个问题（重要）：根据硬件配置，每个人看到的不一样
   
   这是问katago要使用哪个计算核心，如图，每个选项最后面都有一个数字，例如：score 6000201。选数字最大的那一项。
   我的独立显卡选项是2(最后的数字也是最大的)，所以我输入：
   2
   回车。

9. 第五个问题：
   
   这是在问katago的内存上限设置为多少。上限而已，直接拉满
   建议电脑经常卡的同学输入：
   1
   建议偶尔会卡的同学输入：
   2
   建议其他的同学直接回车。

10. 最后一部分问题：
    
    这部分问题一路回车就行。最后会刷出来一堆东西。
    
    然后啥也不用干，等它完事。完事就可以关掉窗口了。
    注意，要确保看见了“DONE”这个单词，然后不再刷东西出来，才算结束。
    如果卡住了，可以敲几下回车让它刷新一下。
    

第二部分：将katago配置到sabaki

11. 下载sabaki安装文件，双击运行，按照它的提示安装好，运行sabaki。

12. 按下图设置中文。
    设置完后关掉重开sabaki。

13. 把显示引擎栏勾上

14. 点击管理引擎：
    

15. 点击新增按钮
    

注意！下面是关键步骤！配置引擎参数请注意空格，字符全用英文字符。

• 第一行：随便给katago起个名字就好。
• 第二行：点击第二行开头的小文件夹图标
  
  进入Katago解压位置，双击katago.exe
• 第三行：
  gtp -model model.bin -config gtp_custom.cfg
• 第四行：
  time_settings 0 15 1
  在中国规则中，上面这个意思就是无保留时间，15秒一步

16. 试运行
    
    当左边引擎加载完毕之后（简单的判断就看左边显示的内容全部静止不动了。是的话就加载完毕了，否则说明之前的步骤出了问题），右击引擎，设置为分析器：
    成功运行效果：
    

成功之后就可以删掉那些除了 【katago路径】 和sabaki目录之外的安装文件和压缩包。

配置过程到这里就结束了

• Katago的详细设置可以在katago引擎文件夹中的： gtp_custom.cfg 文件中设置。这个配置文件生成后，下次更新权重，就只需要改引擎的参数就行，不需要再重新生成一次。
• Katago支持很多有意思的功能，比如自定义贴目和棋盘大小，可以直接用sabaki设置；貌似还支持了还棋头等围棋规则；支持设置搜索广度，默认设置倾向于在一个推荐点进行深度搜索，这导致在某些情况下狗狗要算很久才能发现一些更偏僻的选点；支持更改默认规则；此处不一一列举，感兴趣的同学可以自行查看gtp_custom.cfg文件。
• Sabaki也支持了很多可视化配置，比如：显示手数，显示目差而不是胜率，更改贴目，更改背景和棋子效果等等，建议同学们自行探索。
  此处以设置显示目差而非胜率为例：
  效果：
  

最最最常问的问题：

提示：Could not open file xxxx - does not exist or invalid permissions
答：这就是说xxxx文件找不到，一般就是因为这个文件不存在，或者你写错了路径之类的，解决办法：
1、确认xxxx文件是否存在，比如说gtp_custom.cfg不存在，就重新去生成一下配置文件。
2、确认xxxx文件名、路径之类的是否写错，是否路径中间有空格、有非英文字符等，比如说model.bin不存在，就看是否忘了第二步里的重命名权重文件。
3、如果确认不是以上原因导致的错误，那其他原因就比较难定位了，解决办法包括但不限于：删了katago再重新下载、进user文件夹删掉AppData\Local\Temp目录、更新系统、更新显卡驱动、卸载360/电脑管家之类的奇怪玩意、重启电脑、用管理员权限运行sabaki，彻底从头重新做一次等。

---

• 2023/2/18日注：关于资源文件的更新，我想提醒一下大家，尤其是权重(就是那个model文件)的更新，其实katago的棋力增长是越来越慢的，类似于一个对数函数。
  以过去一年为例，Strongest confidently-rated权重的Elo评分只从13467.4 ± 17.1上升到13479.4 ± 16.8，并没有统计学意义上的明显区分，且相对于人类的水平来说，这一点差别更没有意义。
  我甚至觉得目前的katago已经算是撞到了性能边界，因而从现在开始，除非有新的算法突破，否则对于大多数人而言，更新Katago权重，已经没有了作用。实际上，我自己还在用很老的权重。
  至于Katago和Sabaki的功能及补丁更新，毕竟是开源的，无盈利的，更新效率不用我多说。
  结论就是大多数人没有必要在意资源的更新问题。
  如果不出意外，我以后应该很少再更新资源，包括Katago引擎和权重、Sabaki安装包等，即使我更新了，大概率也是我闲得无聊而已。
  目前的Katago就已经很好用了。

---

• 2022/6/11日注：好多人私信我问问题，其实大部分时候我能解决的只是帮他们找出哪一步做错了，然后让他们按照教程重新做，因此希望大家问问题之前先仔细看几遍，如果我的教程有误，也欢迎指出。

---

• 2021/7/15日注：katago引擎于1.9版本改进了算法，推出了我一直想要的对称局面识别能力，非常感谢@fuhaoda，据katago作者说，新算法的同权重文件elo分提升了大概75。

---

• 2021/1/25日注：
  新消息：
  貌似有更好更适合katago的开源GTP围棋GUI了（katrain），本教程或许已经有点老旧，感兴趣的同学请移步：
  https://github.com/sanderland/katrain

---