云端引擎 · 03

如何把 KaTrain 连接到 Read19 云端 KataGo

在本机保留 KaTrain 界面，把 KataGo 计算交给 Read19 云端引擎；无需在自己的电脑上配置 GPU。

1. 创建 Read19 账户与访问密钥

   登录账户页，新建一个专用于 KaTrain 的访问密钥。密钥只会完整显示一次；保存到密码管理器，不要放进截图、棋谱或公开帖子。

   为 KaTrain 单独创建密钥，可以在出现问题时只撤销这一条连接，而不影响其他客户端。名称写清设备和用途，例如“MacBook · KaTrain”，以后查看最近任务时更容易判断来源。密钥显示后立即保存到密码管理器，不要放进 shell 历史、同步笔记或截图。连接测试完成后，再回到账户页确认密钥的最近使用时间已经更新。

2. 复制 KaTrain 连接地址

   账户页会生成以 wss://read19.com/v1/katago/ 开头的 KataGo WebSocket URL。末尾包含你的密钥，因此整条地址都应当视为凭证。

   WSS 地址由协议、Read19 域名、KataGo 端点和 Token 组成，整条地址都属于凭证。复制时不要遗漏末尾字符，也不要额外加引号或空格。浏览器能打开 read19.com 并不代表网络一定允许 WebSocket；公司、校园或代理网络可能单独拦截 WSS。排障时可以核对域名与地址结构，但不要把完整地址粘贴到公开 Issue。

3. 在 KaTrain 中选择远程引擎

   打开 KaTrain 的引擎设置，选择 WebSocket Remote Engine，并粘贴完整连接地址。不同 KaTrain 版本的标签可能略有差异；如果看不到该选项，请先更新到支持 WebSocket 远程引擎的版本。

   在 KaTrain 的引擎设置中选择 WebSocket Remote Engine 后，只替换连接地址，不要随意复制另一台机器的整套配置。保留规则、模型偏好和每次分析设置的原有值，先用默认或较轻的分析量验证连通性。不同版本的菜单名称可能略有差异，但判断标准相同：远程引擎被选中、地址以 wss:// 开头、保存后没有立刻回退到本地进程。

4. 用真实名局和 TreeView 验证连接

   载入教程中的耳赤之局并开始分析。候选着返回后，在 TreeView 中打开一条分支并退回第 126 手；这能同时证明棋盘、候选着与分支状态正常。最后再核对最近任务和分析单位变化。

   验证时载入一份十几手的小棋谱，选择一个局面等待候选着返回。然后同时查看 KaTrain 状态和 Read19 最近任务：前者证明界面收到结果，后者证明请求确实经过云端并产生用量。如果只显示连接成功却没有候选着，检查当前局面是否触发分析；如果任务出现后失败，再检查密钥状态、账户余额和服务状态页面，而不是反复重新创建 Token。