命令行 · 07

Read19 CLI:把云端 KataGo 接进 GUI 与脚本

用原生 CLI 登录一次,再在 GTP 与 Analysis Engine JSONL 两种模式中选择;Sabaki、LizzieYzy、q5Go 与 KaTrain 都无需在本机管理模型或 GPU。

  1. 安装原生 CLI 并完成登录

    从 /cli 下载与系统和芯片匹配的原生版本,核对 SHA-256 后解压,把 read19 放到固定位置,例如 macOS 的 ~/.local/bin/read19 或 Windows 的 C:\Tools\read19.exe。macOS 版本尚未公证,浏览器下载的文件需先执行 xattr -d com.apple.quarantine read19。随后运行 read19 login(无浏览器环境用 --no-open),再执行 read19 engine setup --name "MacBook · Sabaki" 为这个客户端创建并保存专用密钥。

    登录负责账户授权,engine setup 负责为这个客户端建立可单独撤销的密钥。
  2. GUI 选择 engine gtp

    GUI 从桌面启动时不会读取终端的 PATH,所以路径必须写绝对路径。Sabaki:引擎 → 管理引擎… → 新增,路径填 read19 的绝对路径,参数填 engine gtp,再在引擎侧边栏加载并按 F4 开始/停止分析。LizzieYzy:引擎 → 设置引擎,命令行整行填写“/绝对路径/read19 engine gtp”,需要 CLI 0.2.14 或更新版本。q5Go 在引擎设置中同样填写路径和 engine gtp。KaTrain 不走 GTP,可在本地引擎的“覆盖引擎命令”中填写“/绝对路径/read19 engine analysis”,或改用账户页的 WebSocket 地址。

    GUI 只看到本地 GTP 进程;CLI 在后台把局面转成云端请求并把响应翻回 GTP。
  3. 脚本选择 engine analysis

    需要机器处理完整 JSON 时运行 read19 engine analysis,向 stdin 写入一行一个 Analysis Engine query,并从 stdout 逐行读取结果;stdin 关闭后 CLI 会等已提交的查询返回最终结果再退出。可用 read19 usage、statement 与 status 检查用量、流水和服务状态。GUI 的连续分析会一直搜索到你停止为止,不看棋盘时记得关掉分析。

    JSONL 路径不经过 GUI,适合 shell 管道、Python、Node.js 与批量研究工具。

完整命令

  1. Read19 CLI 下载与命令
  2. KataGo GTP 扩展

成功信号

  • read19 account 能读取账户
  • GUI 显示的引擎名称是 KataGo Read19
  • 候选着能持续刷新,停止后不再增长
  • 用量记录出现对应任务
阅读模型与指标