安装指南
安装 KataGo 引擎
TensuGo 自己不会读棋。读棋的是 KataGo —— 一个跑在你自己电脑上的 开源围棋引擎，需要单独安装。装好之前，棋盘、打谱、做题、立体棋盘都能正常用， 只有 AI 分析用不了。
App 里有一个安装向导会替你完成这些。这一页是给向导走不通、或者你想自己动手的情况准备的。
Windows
先确认：你装的是哪个 TensuGo？
Windows 有两个安装包。名字里带 …-ui-only… 的那个故意不含引擎——
它是给已经装过 KataGo 的人准备的，免得重复下载几百 MB。如果你下的是它，
你的电脑没有任何问题，只是上面还没有 KataGo。
最省事的办法是改装完整版，它自带引擎： Windows 下载页。
或者自己装 KataGo
KataGo 有好几个版本，按你电脑的硬件选：
- OpenCL —— 几乎所有电脑都能跑，包括 Intel/AMD 核显。 不确定就选这个。
- CUDA —— 只适用于 NVIDIA 独立显卡，在这类机器上更快。 另外需要装 NVIDIA 的 CUDA 和 cuDNN 运行库。
- Eigen —— 纯 CPU，不需要显卡，慢好几倍， 但总比完全没有分析强。
可以从我们的引擎下载页拿（我们镜像了官方版本， 省得你到处找），也可以去 KataGo 官方发布页。
- 解压到一个固定位置，比如
C:\KataGo。 别留在「下载」文件夹里，Windows 会清理那里。 - 还需要一个权重文件（
.bin.gz）。 引擎是程序，权重是它「会下棋」的那部分，缺一个都不工作。 - 回到 TensuGo：设置 → 引擎 → 自动检测并配置。
如果自动检测找不到，就在同一个面板里手动指定三个文件：
katago.exe、.bin.gz 权重、以及一个 .cfg 配置
（KataGo 自带，用 gtp_example.cfg 就行）。
macOS
Mac 的 .dmg 里从来不含 KataGo。它确实带了一份拟人权重，
但那是给引擎用的数据，单独放着什么也做不了 ——
这就是为什么 App 看起来一切正常，却分析不出任何东西。
一条命令装好
KataGo 在 Homebrew 里：
brew install katagoTensuGo 的向导检测到 Homebrew 时，替你执行的就是这一条。 如果你还没有 Homebrew，先到 brew.sh 按官方说明装好， 再执行上面这行。
然后还要给它一份权重
Homebrew 只装引擎，不带权重文件。到我们的下载页 或 katagotraining.org 下一个， 然后跑设置 → 引擎 → 自动检测并配置。
Apple Silicon 上 Homebrew 装的版本走 Metal/OpenCL，就是对的那个。 Mac 不需要 CUDA 版 —— 那台机器上没有 NVIDIA 硬件可用。
还是不行的时候
- 提示「引擎未配置」 —— 路径是空的。跑一次自动检测， 或者手动指定那三个文件。
- 引擎启动后马上退出 —— 多半是权重和版本对不上， 或者装了 CUDA 版但没装 CUDA 运行库。换 OpenCL 版试试。
- 分析特别慢 —— 你大概率在用 Eigen（纯 CPU）版，这是正常的。 可以在设置 → 引擎里调低每手计算量，或者改装 OpenCL 版。
- macOS 不让运行这个程序 —— 在访达里右键点它、选「打开」， 确认一次之后系统就记住了。
还是卡住的话，把向导里那段日志复制下来发到论坛—— 里面写着真正失败的原因，有人能看懂。