功能详解
TensuGo 的每一项功能，以及它为什么存在
TensuGo（中文名天书阁）是一款本地优先的围棋研究工作台，把 KataGo 引擎跑在你自己的电脑上。 它的大部分功能之所以存在，是因为常规的复盘流程里缺了某样东西——引擎能指出正确的一手， 但那个结论通常在你关掉软件的那一刻就散了。这一页把全部功能讲清楚：它做什么、解决什么问题、 为什么是现在这个样子。
三十秒看懂
TensuGo 由两部分组成，两部分共用同一套棋盘渲染和同一份文档格式：
- 桌面端（Windows / Mac，免费）——真正的分析工作台。本机 KataGo、 变化树、候选点、研究文档写作、出题。棋谱不上传，断网可用。
- 网页端 forum.tensugo.com（免安装）——做题、论坛棋谱分享、定式库、 十题挑战。手机、平板、电脑都能打开，做题连注册都不需要。
下面十项功能按使用顺序排列：先是分析棋（1–4），再是把研究留下来（5–6）， 最后是练和分享（7–10）。
1. 本地 KataGo 分析
TensuGo 是 KataGo 的图形前端，引擎运行在你自己的机器上，不经过任何服务器。 候选点、胜率、目差、搜索量（visits）、主变化（PV）全部可见，随时可以让它在某个局面上多想一会儿， 也随时可以打断。没有排队，没有每日额度，没有「本月分析次数已用完」。
本地化不只是隐私问题，更是工作方式问题。云端分析天然是「提交—等待—拿结果」的批处理， 你不会为了一个一闪而过的疑问去排一次队。引擎就在手边时，复盘会变成来回试探： 这里如果脱先呢？这块如果不补呢？——这类小问题一局棋里有几十个，它们才是复盘真正的内容。
Windows 版（MSI）内置 KataGo OpenCL 引擎（2026.5 版），装完就能分析，不需要另外配置任何东西；
另有一个不含引擎的 MSI，适合机器上已经装好 KataGo 的用户。
macOS 版（DMG，Apple M 系列芯片）为保持体积轻量不内置引擎：
终端执行 brew install katago，然后在「设置 > 引擎」里点自动检测即可。
引擎这一步是新用户最容易卡住的地方，所以 TensuGo 带了一个引擎安装向导： 首次启动时如果检测到没有可用引擎，它会按你的系统给出可执行的选项—— Windows 上把 OpenCL 版排在第一并标为推荐（不需要你回答「有没有独显」这种问题）， 纯 CPU 的 Eigen 版也保留在列表里；macOS 上直接调用 Homebrew 安装， 并且会去查 Homebrew 的真实安装路径，而不是只看 PATH。每一步都有「遇到问题？」链到详细说明。
下载 TensuGo V1.1 → Windows 与 Mac · 免费 · 本地优先
2. 留得住的变化树与 TSG 研究文档
导入 SGF 时保留完整的分支结构，之后可以升变化、删变化、随时跳回任意一条线，研究不会被压平成一条主线。 这是 TensuGo 最基础也最容易被低估的一项：多数工具把 SGF 读成一条线加几条注释， 而真实的研究过程本来就是一棵树——你在第 58 手分了三个岔，三条都走到底，然后要能对着比较。
树只是形式，真正关键的是 TSG 研究文档：它把局面、分支、引擎给出的候选点与数值、 以及你自己写下的解释保存成同一份文件。这是 TensuGo 和普通 KataGo 界面最大的分野—— 普通界面的产出是一次会话，关掉就没了；TSG 的产出是一份资料，一个月后打开， 当时为什么这么判断依然在纸面上。它也是论坛帖子的附件格式、定式库的发布格式、 以及题目的来源格式，全站只有这一种研究单位。
3. 候选点、胜率走势与转折点
候选点气泡、着法表和胜率走势图三者始终同步：点图上的任何一处，棋盘和着法表一起跟过去。 这让「哪一手崩的」从一种感觉变成一个可以指着说的位置。
围棋复盘最难的不是找出错手，是找出方向性的错误。一个明显的失着自己就能发现； 真正吃亏的往往是连续三手看起来都不难看，但胜率一路往下滑——那不是某一手算错， 是整段方向选错了。胜率走势图把这种缓慢的流失画成一条线，斜率就是答案。
数值口径上有两条硬规矩：胜率必须说明是谁的胜率（黑先还是白先， 说反了整整差 100 个点）；「没算过」绝不显示成 0%， 那是空状态不是数字。这两条听起来是细节，但一个会读数的人被骗一次就不会再信这个界面。
4. 研究笔记与棋评写作
把局面图、候选变化和文字讲解汇成一份可以留存、可以拿去教学、可以导出的复盘材料。 桌面端有专门的「写棋评」模式，工具栏上四个模式（复盘 / 写棋评 / 出题 / 做题） 是一条分段控件，当前模式实心高亮——它表示的是「我现在在做什么」，而不是一个偏好设置。
写棋评模式解决的是一个很具体的麻烦：讲解一盘棋时，你需要的是「第 47 手这个局面 + 这三条变化 + 我的两段话」， 而不是整盘棋的全部内容。传统做法是截图加文字，截图一旦生成就死了，读者不能在上面走一手。 TensuGo 的讲解材料里，每一个局面图都还是活的棋盘，读者可以点进去继续摆。
5. 从自己的棋里出题
复盘到一个值得记住的局面，可以直接把它变成一道题，标注答案，投稿进公开题库。 这是训练材料最自然的来源——你真正下错过的地方，比任何题集都更贴近你的弱点。
投稿进来的题和官方题库共用同一张表，靠状态字段隔离：普通用户上传的题进入待审核队列， 管理员审核通过后才出现在公开题库里。题目的归属永远以上传账号为准， 不以题目里填写的作者名为准——后者是可以随便写的输入框。 审核通过之后，它就和其他题一样出现在做题页， 由 KataGo 的完整分析给出评分，而不是由出题人说了算。
6. 全局做题 TSQ
在完整的十九路盘面上给出 A–E 五个候选点，问的是：此刻全盘这么多大场，哪一个最大？ 死活题训练的是一局棋里决定不到 5% 手数的能力；全局选点是你超过 80% 的手数都在做的判断， 而它长期以来几乎无法训练——因为没有标准答案。强引擎把这件事改变了，所以 TensuGo 把训练直接建在它上面。
每道题来自真实对局中的真实一手，而且是选择确实要紧的那个时刻。 答题后给出的不是对错，而是你这一手相对 KataGo 完整分析的得分， 连同五个候选点各自的胜率、目差和搜索量——你会看到「不是最好但只差 0.4 目」和 「看着很大其实亏了 6 目」之间的区别。题库目前 2,409 题并持续增加。
做题在浏览器里就能用，不用安装，不用注册，手机上是专门优化过的一屏布局： 选点和提交分两步，先给结论再按需展开引擎细节，不需要为一道题上下滚两屏。
7. 立体棋盘 Plus 功能
实时渲染的三维棋盘，不是贴图也不是效果图，是真的在跑的 3D 场景。 棋子有两种：日式蛤石或中国云子，对局中随时切换。书房场景里有木地板、纸壁、 窗外一丛竹子，棋盘边上放着两个棋钵。
立体棋盘不只是好看。候选点气泡是画进棋盘平面里的， 会跟着木头的透视走，而不是浮在盘面上方——这意味着视角转动时， 标记和它所在的那个交叉点始终是同一件东西。论坛上分享的任何棋谱， 打开都是这块棋盘，桌面端和网页端用的是同一个渲染包，一行代码都没有重写。
立体棋盘是 Plus 功能，每个新注册账号自动获得 90 天免费 Plus，登录即可使用。 关闭 3D 永远是放行的——二维棋盘绝不会变成够不着的状态。
8. 论坛与棋谱分享
论坛帖子的附件就是可以直接打的谱。贴一份 TSG 或 SGF 上去， 读者在帖子里就能逐手前进后退、切换变化，而不是下载一个文件然后去别处打开。 这是论坛和普通贴图讨论的根本区别：讨论围棋需要能在盘上比划， 而截图是死的。
网页摆变化 = 提问；桌面端分析 = 回答。这两件事不是高低档，是一问一答。 论坛服务器上没有 GPU、也不该有——算力已经存在，在每一台装了桌面端的机器上。 缺的从来不是服务器，是让有算力的人参与讨论的入口。
论坛也是整个网页端的容器：做题、定式库、挑战链接、账号与设置都在这里， 不需要安装任何东西。管理员可以从桌面端把分析好的棋谱一键发布成帖子。
9. 定式库
定式研究以「一份完成的 TSG 文件」为单位发布，读者打开就能在变化树里点来点去。 每条变化的胜率、目差和搜索量是发布时保存下来的静态数据， 所以读者这边不需要任何 AI、不消耗任何算力，手机上也能流畅浏览。
这是把「一个人的一次深度研究」变成「很多人可以反复查阅的资料」的做法。 变化切换用鼠标点或键盘左右键，局面可以逐手走、后退、直达终点， 走到变化终点时会显示发布时保存的候选点和胜率。每篇研究下面可以评论。 定式库标明了一件事：这些数字是发布当时的静态值， 不是实时算的——把静态数据说成实时的，是这类页面最容易犯也最不该犯的错。
10. 十题挑战
一条链接，十道题，做完给分数和排名，可以直接发到群里或社交平台。 挑战链接是给不熟悉 TensuGo 的人准备的入口：不需要注册， 点开就是十道题，做完自然会想知道「这十道题是哪来的」。
一个挑战可以带多条不同标记的链接（/c/<token>?f=xhs），
发到不同平台。所有链接抽的是同一套十道题——
每个平台一套不同的题会让分数不可比、榜单被拆散。
附：四语言、账号与隐私
整个界面有四种语言：简体中文、English、日本語、한국어， 不是只翻了菜单，是包括做题反馈、错误提示和帮助文档在内的全部文案。 语言选择在 www 站和论坛之间共享，换一次就都记住了。
账号是可选的。做题、看棋谱、浏览定式库都不需要注册。 注册之后你会得到：做过的题的记录（并保证随机出题不重复）、 排行榜位置、投稿题目的能力，以及 90 天免费 Plus。 桌面端的本地分析完全不需要账号，也不需要联网。
附：还没有的东西
为了不浪费你的时间，这里也写清楚现在没有什么： 没有 iPhone / iPad / 安卓的原生 App（分析需要电脑处理器， 但做题和论坛的网页在手机上完全可用）； 桌面版需要 Windows 电脑或 Apple M 系列芯片的 Mac； 在线对弈功能正在开发中，尚未开放。
常见问题
TensuGo 收费吗？
桌面版免费下载使用，本地 KataGo 分析、变化树、研究文档和做题都不收费。 立体棋盘属于 Plus 功能，每个新注册账号自动获得 90 天免费 Plus。
我的棋谱会被上传吗？
不会。分析全部由运行在本机的 KataGo 完成，棋谱和分析结果留在你自己的磁盘上， 断网也能正常分析。只有你主动点击分享到论坛时，内容才会离开这台电脑。
和其他 KataGo 界面比，TensuGo 的区别是什么？
多数 KataGo 界面在分析结束时就结束了。TensuGo 把局面、备选变化、引擎数据 和你自己的解释保存成一份结构化的研究文档，并在这份文档之上长出了做题、 定式库和论坛分享——研究成果可以被复用，而不是看完就散。
需要多好的电脑？
有独立显卡当然更快，但不是必需的。Windows 版内置的 OpenCL 引擎在集成显卡上 可以工作，纯 CPU 的 Eigen 版在没有可用 GPU 的机器上也能跑—— 慢，但和「没有」是两回事。
支持多大的棋盘、什么规则？
支持标准的 19 路以及小棋盘，贴目可调。导入导出用标准 SGF， TensuGo 自己的研究格式是 TSG（在 SGF 的基础上多保存了引擎数据和讲解）。
功能详解系列
后续会一篇一篇地发：KataGo 本地分析、变化图树、研究文档、立体棋盘。