dsh-go-sensei

dsh-go-sensei —— DeepGo Sensei 围棋复盘教练

给 DSH（DeepSeek Harness）装一位围棋老师。把手上一盘棋的 SGF 棋谱交给它，它会像陪练老师那样逐手讲给你听：这手棋原本想干什么、问题出在哪、改下哪里会更好。讲完可以把讲解写回棋谱文件，也可以导出一份 Markdown 复盘报告。

• 装完即用（Windows）：插件自带一套 KataGo v1.16.4 + 18b 权重；棋谱里没有 AI 分析数据时自动补算，不需要你下载引擎，也不需要填任何路径。
• 没有引擎也能讲：引擎不可用（比如 macOS / Linux 没用到自带引擎）时照样能用——这一档只讲棋理，不报胜率。
• 追问的回答带配图：问「第 42 手改下 R16 会怎样」，回答里就直接画出那张变化图——着法按 1-9、A-Z 逐手编号，三角形标出关键棋子（还有方块/圆圈/叉/字母），配一句话图注。一张图只讲一个变化。每张棋盘（配图与面板）上沿都写着黑方白方的名字与段位（PB/PW/BR/WR），谁执黑不用问。
• 两张可折叠曲线看大势：胜率曲线与目差曲线（统一黑方视角）在下方面板、左侧栏整页、右侧栏文档三处都有；问题手在曲线上点着小色点，点图上任意位置就跳到那一手。
• 棋盘在左侧栏整页与右侧栏：列出问题手，点一行→棋盘跳到那一手（问题手彩点、AI 首选青圈、变化图半透明棋子带序号、讲解小方点；AI 首选与变化图对每一手都在，讲解点也有）；盘下带图例与开关（三类标注各自可关），Sensei 在对话里讲到哪一手，棋盘可以自动跟过去；输入框下方的面板只负责「填路径 → 读问题手 → 看两条曲线」（棋盘与问题手列表在左侧栏整页，见下文）。
• 口子都留着：想换更强的权重、换 CUDA / CPU 版引擎、调搜索量，有五个改法；想确认现在用的是哪个模型，问一句「现在用的是哪个模型？」即可。
• 不需要 Java，也不需要别的围棋软件。 KataGo 是唯一可能被插件启动的外部程序。

---

目录

• 它能帮你做什么
• 5 分钟上手
• 接入 DSH：安装、验证、卸载
• 配置项
• KataGo 引擎：自带一套，不够用再换
• 棋谱要求（SGF 格式）
• 棋谱从哪来（常见来源）
• 对话里怎么问
• Web 页面上的复盘面板
• 工具一览
• 内置讲棋技能（随件发行）
• 常见问题
• 已知限制
• 开发与发布
• 许可

它能帮你做什么

讲解由 DSH 会话里的「围棋老师」人格完成：先复述你的意图、指出问题、再给具体改进建议；术语密度按双方段位自动调整（18K10K 用生活化比喻，9K1D 用常规术语，2D 以上可以直接聊全局构思）。胜率与目差只是佐证——先讲棋理，再引数字。

5 分钟上手

# ① 装插件（在插件的上一级目录执行；下面这行是作者机器上的路径，换成你自己的）
cd C:\dsh\WeiQi
dsh plugin --profile web add ./dsh-go-sensei

# ② 重启 dsh web，浏览器打开 http://127.0.0.1:3080

③ 把一份棋谱放进当前会话的工作区（或者记住它的完整路径），在对话里说：

复盘这盘棋 [庄生梦1n4k]vs[鍾易成1]1788532348030034222.sgf

Sensei 会自己读谱、找问题手、逐手讲解。棋谱里没有 AI 分析数据也不打紧：插件自带 KataGo 引擎与 18b 权重（Windows），会自动补算，你不需要装任何东西。想换成更强的权重或换后端，见 KataGo 引擎 一节。

复盘过程中产生的分析数据与讲解都写进同目录的 <源名>-sensei.sgf 副本，你给的那份棋谱不会被改动（见 源棋谱只读）。

接入 DSH：安装、验证、卸载

前置

安装

# 方式一：本地目录（自己 clone 或改源码时用；装完是 link，改完重启即生效）
dsh plugin --profile web add ./dsh-go-sensei
dsh plugin --profile web add D:\path\to\dsh-go-sensei      # 也可以用绝对路径

# 方式二：直接从 GitHub 装（仓库公开）
dsh plugin --profile web add github:Zhuang-A/dsh-go-sensei

dsh plugin 会把这个包装进 web 这个 profile，并自动把声明了 dsh.bundle 的依赖加入 profile 图层列表——不需要你手工改 bundles。装完重启 dsh web 才生效。

仓库里带着引擎与权重，约 110 MB，clone / 首次安装会慢一些；本地目录安装用的是 link:，不复制文件，改完源码重启 dsh web 即生效。不需要自带引擎的话，删掉 engine/ 目录即可。

验证装好了

# 合成后的配置里应该能看到 go-sensei 这一层
dsh --profile web --dump-config | Select-String -Context 0,3 go-sensei

再看两处：

• Web 页面输入框下方出现一行「DeepGo Sensei」+「展开」按钮 → 浏览器端加载成功。
• 对话里随便问一句围棋，比如「帮我看看这盘棋」→ 模型开始用围棋老师的口吻回应，并能列出 go_* 系列工具 → 宿主端加载成功。

升级与卸载

dsh plugin --profile web update dsh-go-sensei        # 升级（本地 link 安装无需此步）
dsh plugin --profile web remove dsh-go-sensei        # 卸载

卸载后重启 dsh web 并刷新页面：面板与样式都不会残留。

兼容性（DSH 版本）

插件的 package.json 里声明了 dsh.engines.dsh（>=0.1.5-rc.1）与 dsh.compatibility.dshReleases 逐版本兼容表。当前情况：

两条在 0.2.x 上必须知道的事实：

• 闸门的判定顺序：插件写了 engines.dsh 就只按它判，peerDependencies 会被忽略；没写 engines.dsh 才逐个校验 @deepseek-ai/dsh* peer。semver 判定固定带 { includePrerelease: true }，所以 >=0.1.5-rc.1 能放行 0.2.1-rc.2（换成默认选项的话，预发布版会被判不满足——这是最容易踩的坑）。dsh.compatibility.dshReleases 只是对外声明，内核不读。
• 桌面端与浏览器端的配图形态不同：桌面端页面跑在 dsh-app://app 上，宿主 cookie 由外壳进程持有、不下发给页面，所以指向 http://127.0.0.1:<端口> 的绝对图片地址在那边会 401。插件会把配图 SVG 落盘（棋谱同目录的 .go-sensei/）并用本机路径出图，由界面改写成带鉴权的 /api/file；浏览器界面（web profile）仍用绝对直链。两种形态都由 go_draw_diagram 返回，原样粘贴即可，不要自己改。

配置项

全部可选，一个都不配也能用。 配置写在 profile 的补丁层文件里：

%USERPROFILE%\.dsh\profiles\web\cordis.patch.yml      # Windows
~/.dsh/profiles/web/cordis.patch.yml                  # macOS / Linux

（若你设过 DSH_HOME，就是 $DSH_HOME\profiles\web\cordis.patch.yml。目前 Web 设置页里没有 Sensei 的配置卡片，改配置请直接编辑这个文件。）

# ── DeepGo Sensei ─────────────────────────────────────────
# 全部可选：一段都不写也能用（自带引擎会自动被发现）。
# 路径用正斜杠，既被 Windows 接受，也避免 YAML 反斜杠转义踩坑。
- id: go-sensei
  config:
    level: auto                 # 讲解难度 18K..1K/1D..9D，或 auto（按双方段位自适应）
    winrateThreshold: 0.03      # 问题手胜率落差阈值（0~1 小数）
    scoreThreshold: 3           # 问题手目差阈值（目）
    maxCandidates: 10           # 每次复盘最多返回多少个问题手
    pvDepth: 6                  # 每条变化图保留多少手
    tokenBudget: 50000          # 单局讲解的 token 预算（软约束）
    engineDir: ''               # 引擎目录；留空＝用插件自带的 engine/
    kataGoPath: ''              # 可选：可执行文件（默认取 engineDir 里的 katago）
    kataGoConfig: ''            # 可选：analysis 配置（默认取 engineDir 里的 analysis_example.cfg）
    kataGoModel: ''             # 可选：权重文件；留空＝自动挑 engineDir 里最大的 *.bin.gz
    maxVisits: 100              # 补算每手搜索量：越大越准越慢
    allowEnginePathOverride: false  # 是否允许模型用工具入参临时改引擎路径（默认关，见下）
    autoInstallSkill: true      # 加载时把随件讲棋技能装进技能根（false＝不碰技能目录，也不要求模型加载它）

没写的键一律用默认值。各项含义：

引擎不可用（非 Windows 且没配 engineDir）时，go_engine_analyze 不会注册，复盘自动走纯棋理模式；随时可以让 Sensei 调 go_engine_info 看当前状态与改法。

KataGo 引擎：自带一套，不够用再换

先判断你会走到哪条路

怎么判断棋谱有没有分析数据：用记事本打开 .sgf，搜 WV[ 或 LZ[，或者搜「胜率」。搜得到就是自带分析。

开箱即用：插件自带的 18b 引擎

engine/ 目录随插件分发，不需要填任何配置就能补算：

想确认现在到底在用哪套引擎、哪个权重，直接问一句「现在用的是哪个模型？」，Sensei 会调 go_engine_info 念给你听。

换引擎 / 换权重 / 调速度：五个口子

生效时机要分清：权重与路径每次调用都重新解析，所以往 engine/ 里丢一个新权重，下一盘复盘就用上了；而 go_engine_analyze 这个工具本身注册与否在插件加载时决定，改了 engineDir / kataGoPath 记得重启 dsh web。想强制重算某盘棋（不吃缓存），用 go_engine_analyze 指定手数区间。

⚠️ 可执行文件名的限制（2026-09-30 起）：无论走 engineDir 还是 kataGoPath，可执行文件都必须是 KataGo 自己的发行名（katago / katago.exe / katago-opencl.exe 这类），且 kataGoPath 必须指向 真实存在的普通文件；不符合时按"没有引擎"处理并说明原因。原因见装机章节的说明。

🔒 "只临时换一次"默认是关的（allowEnginePathOverride: false）：工具入参里的引擎路径只有在配置 显式打开后才生效 —— 引擎路径决定宿主执行哪个可执行文件，这个决定权留在配置（部署者）手里。 打开后，模型可以在 go_engine_analyze 里临时换引擎/权重；关着时入参被忽略，结果里会写明"已被忽略"。 想临时试一个引擎又不想重启，推荐做法是：把新引擎放进一个目录，改配置的 engineDir 并重启 dsh web （重启只影响一次加载，仍然是显式动作）。

自己装一套（非 Windows，或想换后端）

自带的是 Windows x64 OpenCL 版：macOS / Linux 上插件不会自动启用它，需要自己下载对应平台的引擎，再把 engineDir（或 kataGoPath）指过去。人肉装机要备齐三样，缺一不可：

1. katago 可执行文件 —— 版本 v1.14 以上（v1.14 起 analysis 模式默认 JSON 协议；自带的是 v1.16.4）。
2. 模型权重 —— 形如 kata1-b18c384nbt-….bin.gz 的文件。
3. 一份 analysis 配置文件 —— 必须是 analysis 配置，不能拿 GTP 配置顶替。

步骤 1：下载引擎

打开 KataGo releases，挑一个匹配你系统的压缩包，按机器选后端：

解压到一个固定目录，例如 D:\katago\。

⚠️ 整个目录一起留着，别只拷 katago.exe。 它依赖同目录的一堆 DLL（libcrypto-3-x64.dll、libssl-3-x64.dll、libz.dll、libzip.dll、msvcp140*.dll、vcruntime140*.dll），只拷 exe 会启动即失败。

步骤 2：下载模型权重

到 katagotraining.org 下载最新的权重文件：

• b18c384nbt（约 98 MB）：够业余棋友复盘用，推荐先用这个。
• b28c512nbt（约 270 MB）：更强也更慢，机器好再上。

放进同一个目录，例如 D:\katago\kata1-b18c384nbt-s9996604416-d4316597426.bin.gz。

步骤 3：准备 analysis 配置文件

用引擎目录里自带的 analysis_example.cfg（官方压缩包里就有），不需要改任何一行：

• 搜索量由插件在查询里指定（maxVisits，见配置项），配置文件里的 maxVisits 不生效。
• 插件会额外加 -override-config numAnalysisThreads=1，避免多线程和单次查询抢资源。
• 配置里的 reportAnalysisWinratesAs 决定胜率视角（随包配置实测是 BLACK），插件会读这一个键做口径换算——所以别删它。

如果你的压缩包里没有这个文件，从官方仓库取： https://raw.githubusercontent.com/lightvector/KataGo/master/cpp/configs/analysis_example.cfg

⚠️ 别拿 GTP 配置顶替（形如 default_gtp.cfg、myconfig.cfg 的那类）。GTP 配置缺 analysis 模式必需的键，引擎会直接报 Could not find key。

步骤 4：先自己验证一次引擎

# 尖括号是占位符，换成你实际的位置（本文档别处的 D:\katago 只是示例目录名）
<你解压引擎的位置>\katago.exe version

正常输出（本机实测）：

KataGo v1.16.4
Git revision: 4b8de63bea2bd8790db96cd6f8daf86dc87be6f7
Compile Time: Oct 20 2025 12:25:23
Using OpenCL backend

能打印版本号与 Using <后端> backend 就算过了。这一步报错就先别往插件里填，先把引擎跑通。

步骤 5：把它填进插件配置

回到 配置项，在 %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml 里写：

- id: go-sensei
  config:
    engineDir: <你的引擎目录>      # 该目录里有 katago 可执行文件、analysis 配置、权重
    maxVisits: 100

⚠️ 可执行文件名必须还是 KataGo 的发行名（katago / katago.exe / katago-opencl.exe 这类， 即 katago 后面接 -、_ 或 . 再接后缀）。engineDir 里只认 katago.exe / katago 两个名字； 用 kataGoPath 显式指定时也只接受这一族名字，且必须是一个真实存在的普通文件。 这不是洁癖：go_engine_analyze 允许模型临时覆盖引擎路径，而那一串最终会走到 subprocess.spawn —— 没有这道闸门，一次被棋谱内容带偏的调用就能让宿主执行任意二进制 （2026-09-30 安全复查把这条收窄成"KataGo 自己的名字"）。所以：别把引擎重命名成别的名字， 想换后端就换整个目录里的 exe 文件（名字照旧）。被拒时 go_engine_info 会明确写出原因。

（<你的引擎目录> 是占位符——填你自己解压引擎的位置，别照抄本文档里的示例目录名。 也可以更细：kataGoPath 指可执行文件、kataGoConfig 指配置文件、kataGoModel 指权重，三者各自覆盖 engineDir 里的自动发现。）

重启 dsh web。之后凡是没有分析数据、19 路的棋谱，go_review_moves 与 Web 面板都会自动补算，不需要你手动调工具；补算失败不会打断复盘，会降级成纯棋理模式并把失败原因如实带回。

自带引擎的边界

• 平台：自带的 katago.exe 是 Windows x64 OpenCL 版，其他平台不会自动启用，请走上面的"自己装一套"。
• 许可：引擎与权重按 KataGo 官方 MIT 许可随插件分发（第三方组件声明见 engine/LICENSE.txt），上游条款以官方发布为准。
• 体积：仓库因此约 110 MB，clone 会慢一些；不需要自带引擎的话，删掉 engine/ 即可（插件会退回"自己装 / 纯棋理"两条路）。
• 显卡：OpenCL 后端要求显卡驱动带 OpenCL 运行时；驱动太旧或纯远程桌面环境可能起不来，换成 CPU（eigen）版最稳。
• 首次运行会写调优缓存：第一次补算要做 OpenCL 调优（本机实测同一查询首次 214 秒、第二次 8.7 秒），缓存落在 engine/KataGoData/（已在 .gitignore 里，删掉下次会重新调优）；运行日志在 engine/analysis_logs/。

常见装机坑

补算耗时会在 go_engine_analyze 的返回里以 seconds 字段给出，跑几次就有直观感受。

棋谱要求（SGF 格式）

基本要求

主变化线之外的手数不影响使用：在打谱软件里摆过的变化图、做过的手顺标记都可以留着。

源棋谱只读：复盘产物写在 -sensei 副本里

Sensei 从不修改你给的棋谱文件。 所有写回（AI 分析数据 + 逐手讲解）都落在同目录的副本上：

QiPu/091301[甲]vs[乙]1789308106030024548.sgf          ← 源棋谱：逐字节保持原样
QiPu/091301[甲]vs[乙]1789308106030024548-sensei.sgf   ← 复盘副本：WV/DM/LZ 分析 + C[] 讲解
QiPu/091301[甲]vs[乙]1789308106030024548-sensei.review.md  ← 复盘报告（跟着副本命名）

• 写：go_write_review（讲解）、补算写回的分析数据、go_export_report（报告）都写进副本；副本不存在时由第一次写入创建（内容是源棋谱 + 这次写入的东西），已存在时在它上面继续追加。
• 读：同一盘棋，若副本已存在，工具与面板都读副本 —— 那才是上一次复盘的成果（分析数据 + 讲解）。所以复盘过的棋谱再打开是秒开，不会因为"源文件里没有分析数据"而重算一遍。
• 配图：桌面端出图时（见「追问的回答会带配图」）会把 SVG 写进棋谱同目录的 .go-sensei/（diagram-<内容指纹>.svg），只为让界面能按本机路径加载；不想留就直接删掉整个 .go-sensei/ 目录，下次画图会重建。
• 想强制读源文件：把副本删掉/改名，或直接给副本路径（xxx-sensei.sgf 不会再叠一层后缀）。
• 副本名只由源文件名决定，与复盘次数无关：同一盘棋反复复盘，始终更新同一个副本。

编码：不用管，插件自己认

• 优先按 UTF-8 严格解码；不是 UTF-8 就回退 GBK（野狐、部分国产导出器常见）。
• 棋手名/棋局名若是「UTF-8 被当 GBK 解」的双重乱码，插件会尝试无损回修；修不干净时保留原文并给出 warning（不影响棋局分析）。
• 写回注释后副本统一存为 UTF-8（源棋谱的编码与字节不动）。

会被读取的属性

分析数据：三种写法都认

棋谱里只要有任意一手带分析数据，插件就直接用，不再补算。识别三种常见写法：

1. KataGo 标准属性：WV[]（白方视角胜率）、DM[]（黑方视角目差）、PV[]（后续变化）。
2. 分析属性：LZ[] / LZOP[]（部分打谱软件保存分析数据时写入的私有属性）。
3. 注释里的胜率行：把分析写进 C[] 的软件，形如 Move 42 黑胜率: 94.3% (±0.1%) (KataGo-18b / 1.0k 计算量)。插件按通行口径解析这类文本。

无分析数据 + 引擎可用 → 自动补算

触发条件（三条同时满足）：

• 引擎可用：插件自带的 engine/ 能解析到（Windows），或用 engineDir / kataGoPath 指向了自己的引擎；
• 棋谱完全没有分析数据（有一手带分析就不触发）；
• 棋盘是 19 路。

补算失败不阻断复盘：自动降级为纯棋理模式，并把原因（引擎退出码、引擎拒绝查询的原文、子进程不可用等）带回。

棋谱从哪来（常见来源）

棋谱放哪、怎么写路径

• 放进当前会话的工作区目录，对话里直接写文件名就行；也可以给绝对路径（如 C:\棋谱\2026-09-12-对局.sgf）。
• 野狐导出的文件名带中文与方括号 []，Windows 下照抄即可；路径里有空格时用引号包起来，或在输入框里用 @ 引用文件。
• 相对路径按当前会话工作区解析；Web 面板除了会话工作区，还会在你最近复盘过的目录里按文件名做一次有界查找。

对话里怎么问

复盘这盘棋 C:\棋谱\2026-09-12-对局.sgf
只看前 50 手，后面官子先不用讲
第 42 手为什么不好？我是 5K，讲简单点
第 42 手改下 R16 会怎样？给一条主变就行（回答里会配一张变化图）
把讲解写回棋谱
生成复盘报告

• 想省 token：先说「只看第 1~60 手」，再逐段追问。
• 同一局反复问：命中同局面缓存（工具返回 cached: true），不会重复消耗。
• 讲解口吻、术语密度都可以直接提要求（「讲简单点」「讲深一点」），Sensei 会照办。
• 追问涉及具体变化时，回答会带配图（见下文）；不想看图就说「不用画图，讲重点」。
• 左侧栏整页与右侧栏文档里「点一行 / 点交叉点」得到的追问语，末尾都写明了「画一张变化图」——配图靠模型主动调工具，在提问处写明比只写进人设可靠。

Web 页面上的复盘面板

三处视图各有分工：输入框下方的面板管「填路径 → 读棋谱 → 看曲线」，左侧栏整页看棋盘与讲解，右侧栏文档预览跟着对话一起看。同一盘棋、同一手在三处同步（共用一份视图状态，数据都来自宿主）。

访问控制：面板与界面共用同一道登录闸门（局域网可用）

插件往宿主注册了四条只读路由（/go-sensei/roots、/focus、/diagram、/review），浏览器面板与对话配图都靠它们取数据。这些路由直接挂在 webServer 上，而宿主默认监听 0.0.0.0（局域网可访问），所以它们各自先过一道闸门：

• 闸门实现 = DSH connection 服务的 requestRejection()，与界面自身的 /api 完全同一道：
  1. Host/Origin 围栏 —— Host 必须是 loopback 或本机局域网地址，且 Origin 与 Host 同源、Sec-Fetch-Site 不是 cross-site（挡 DNS rebinding 与跨站请求）；
  2. 浏览器会话 cookie —— 必须持有该 authority 的签名 cookie（由打开带 ?token=… 的界面地址时铸出）。
• 因此在局域网里用面板的前提，就是能在局域网里用界面：换设备 / 清了 cookie 后请用带 token 的地址重新打开一次界面；没登录过的设备一律 401，跨站请求一律 403。
• 拿不到 connection 服务时（纯 CLI 组合，或极简宿主）闸门退回「仅本机来源」，局域网面板随之不可用——宁可如此，也不留一个无鉴权又对外的读文件接口。

其余硬化：

• 读取范围（包含校验）：/review 与 /diagram 接受的 ?path 必须落在宿主的已知工作区根之内 —— 会话工作区、模型复盘过的棋谱所在目录、以及面板默认根。这些根之外的路径一律 404 并给出可操作提示；判定发生在 readBytes 之前，对绝对路径连 stat 都不做（不给"这个文件存不存在"做探针）。想让某个目录可用：在对话里让 Sensei 复盘一次那盘棋，宿主就会记下它所在的目录。
• ?cwd 不构成放行依据：它只在本身已经是已知工作区根时才作为本次请求的解析基准，否则直接拒绝 —— 否则调用方自造的基准会让包含校验自我作废。roots 仍只由工具执行与会话根补充。
• /review 有窗口限流（10 秒 / 20 次）与在飞上限（2 个），超限回 429/503（这条路由在没有分析数据时会现场启动 KataGo）。
• 错误响应只回通用文案，原始异常与工作区根列表只写宿主日志。

输入框下方的面板

Web 页面输入框下方有一行折叠面板「DeepGo Sensei」：

1. 点「展开」，填入 SGF 路径（相对工作区，或已知工作区之内的绝对路径 —— 范围见上一节的「读取范围」）；
2. 点「读取问题手」，状态行给出「停在第几手 · 这一手的坐标」，往下是两条可折叠的曲线；有问题手时行末写明「N 个问题手」，没有分析数据 / 补算失败时也照实说明；
3. 就这样——面板不画棋盘，也不列问题手（输入框下方地方小，又要给输入框让位）：棋盘、问题手列表与讲解都在左侧栏整页，见下文。

面板只管「读」。要追问就点左侧栏整页或右侧栏里的一行（追问语会复制到剪贴板），粘到下面的输入框回车即可。

胜率 / 目差曲线（三处视图都有）

每盘棋都带两条可折叠的曲线，横轴＝手数、纵轴＝黑方视角（胜率越高 / 目差越正＝黑越好），点表头即可收起：

• 问题手在曲线上点着小色点（紫＝大恶手、红＝失误、橙＝不精确），一眼能看出"哪几手把棋下坏了"；
• 竖直虚线是当前手，表头同时给出这一手的数值（如「第 81 手 2.9%」「第 81 手 −8.3 目」）；
• 点图上任意位置就跳到那一手，与棋盘上点交叉点是同一种手感；
• 三处视图（下方面板 / 左侧栏整页 / 右侧栏文档）共用同一条折叠状态，在哪儿收起，别处也收起。

数据口径由宿主一次算清（棋谱里 WV[] 是白方视角、DM[] 是黑方视角、LZ[] 是落子者视角、注释里的胜率又是另一套），浏览器只负责画 —— 所以三处视图上的同一条曲线永远是同一条。

内置棋盘（在左侧栏整页与右侧栏里）

棋盘不在输入框下方的面板里（那里地方小、又要给输入框让位）。看棋盘有两个入口：左侧栏的「Sensei 棋盘」整页（棋盘在左，曲线与问题手列表在右，讲解整幅在底部），或在对话里点开 .sgf 文件时的右侧栏文档预览。盘上的记号：

棋盘上沿写着黑方白方的名字（● 黑 庄生梦1n4k（18级） … 白 鍾易成1（17级） ○）：名字取自棋谱根节点的 PB/PW，段位取自 BR/WR，棋谱没写名字时这一条不占位、盘面照旧。讲解配图（go_draw_diagram）画的是同一张盘，同一条名条也在。

AI 首选与变化图不只给问题手看：只要棋谱里有候选着法（LZ[]，补算过的棋谱都有），翻到任意一手盘上都会画出首选点、它的胜率，以及首选之后的后续几手——包括「有讲解」但没被评为问题手的那几手（老师在好手、关键处同样会写讲解，那些手以前是空白的）。不是问题手时，盘下那行也会直接写出「◌ AI 首选 Q16（胜率 56.3%）　后续：D4 → Q4」，并在本手有讲解时提示「本手有讲解（见下方）」。这一层归「AI 首选 / 变化图」开关管，关掉后盘上与文字一起消失。

盘上的标注都只标"已经下到"的那几手：停在开局时盘面是干净的，问题点与讲解点随棋局展开一处处出现——这样一眼能看出"讲到哪儿了"，而不是一上来就满盘记号。

图例就在棋盘下面，每项＝色样 + 名称的小胶囊，点一下即可开/关那一类标注（关掉的项变淡划掉），三项分别是「问题手」「有讲解」「AI 首选 / 变化图」。开关是三个视图共享的：在下方面板关掉，右侧栏与整页棋盘同时生效。只想安静看棋形时，把三类全关掉即可。（形势判断不在这里：它是控制条上的一个按钮，按下即进入独占模式，见 形势判断。）

• 载入后自动停在最严重的那一处问题手（列表第一行就是它），圆圈与色点立刻可见；没有问题手时才停在末手。
• 控制条：⏮ ◀ ▶ ⏭ 逐手前后翻；◀恶点 / 恶点▶ 直接跳到上一处 / 下一处问题手，◀讲解 / 讲解▶ 跳到上/下一处有讲解的手（都到头绕回另一端，方便把每个恶点过一遍）；右侧滑块拖动快速定位。表头实时显示「第 N/M 手 · 黑 Q16」。
• 第一次读没有分析数据的棋谱要等一会儿：宿主会用自带的 KataGo 现场补算（实测一盘 87 手的棋谱约 87 秒，机器与 maxVisits 不同会有出入）。这期间按钮上是「读取中…」，面板会另起一行说明「正在用 KataGo 补算」，算完自动出结果——不是卡死。同一盘再读就走缓存，很快。
• 点盘上任意交叉点：就这个点复制一句追问（「这里如果下在 Q16 会怎样？」），你不用自己算坐标——粘到输入框回车即可。
• 跟随讲解（默认开）：Sensei 在对话里读到哪一盘、讲到第几手，棋盘与曲线就自动切过去——它调用 go_position_context 看第 42 手，三处视图的棋盘就都停在第 42 手的局面。
  • 还没载入棋谱时它照样守着：Sensei 一讲到某盘棋，棋盘就把那盘棋自动载入，你不用先知道路径；
  • 你手动「读取问题手」会认掉当前这条指针，旧的讲解不会把你刚选的棋谱抢走；只有新的讲解事件（比如 Sensei 又开始讲另一手）才会切过去；
  • 问宿主的频率：每 3 秒一次，纯内存查询（不读盘）。关掉开关即纯手动。
• 棋子与标记的配色照着 Lizzieyzy 的棋盘渲染来（最后一手反色圆点、失误按严重度取紫/红/橙、首选点青色圆加蓝圈、推荐点信息橙底黑字、变化图后续几手＝ghost stone 棋子 + 变化序号），平时用惯了那套配色的话，两边"哪个点是什么意思"能直接对上。
• 已写回的讲解直接显示在盘下：翻到某一手时，只要这一手在棋谱里有 C[] 注释（即 Sensei 用 go_write_review 写回去的那段讲解），棋盘下方就出现「讲解（已写回棋谱注释）」框，翻到哪手读哪手；问题手列表里对应行也会标出「有讲解」。

形势判断（引擎归属图）

照 Lizzieyzy 的判定规则做的：盘上把地画出来、棋盘右侧的浮窗把目数报出来，滑块拖到哪一手就按那一手的局面算。

默认不显示。在控制条上点「形势判断」才进入，而且它是独占模式：进入后只留地盘与浮窗，讲解小方点、问题手色点、AI 首选与变化图全部隐去，整页视图右列的曲线与问题手清单也一起让位（棋盘那一列随之外扩，专看地盘与数字）；点浮窗右上角的 ×（或再按一次按钮）退出，并恢复到按下按钮之前的显示状态（进入前是开的还开、是关的还关）。

数据来自引擎的归属图（KataGo analysis 的 ownership，与胜率/目差出自同一次搜索），判定只有三条规则：

1. 阈值 0.4：|归属| < 0.4 的点算未定，不画也不计（盘上留白）；
2. 四邻过滤：一个空点就算倾向黑，只要四个邻点里有一个不倾向黑，它也不算黑地（防孤点、画面干净）；白方对称；
3. 死子判定：落在对方区域里的己方棋子按死子算——盘上在那颗子上盖对方颜色的小方块，并记进对方的「地」。

计分用数子法：目 ＝ 活子 ＋ 地（未定不计），领先 ＝ 黑目 − 白目 − 贴目。浮窗里逐项报出来，形如：

形势判断 白领先 35 目（不贴目） 甲（黑）　145 目 乙（白）　180 目 提子　　　黑 3 · 白 1

没有归属数据时会当场补算：第一次点开若这盘棋还没算过（包括以前复盘过、只写了胜率/目差的老副本），会跑一次引擎（几十秒，浮窗里显示「正在补算」），算完把归属图写进 -sensei 副本的 TP[]，以后打开秒出。引擎不可用时按钮禁用并说明原因——不拿估算顶包。

口径注意：这里的目数是点目（盘上点数的合计），与目差曲线（引擎 DM，黑方视角）不是同一个数；讲地盘归属用前者，讲领先多少目优先用后者，不要并排报两个数。

配图也能用：go_draw_diagram 加 territory: true，生成的 SVG 上叠同样的地块、图下附一行形势判断，工具返回值里也带着那行数字（模型应直接引用它，不要自己另算）。

补算结果会写回棋谱（所以不必每次重算）

没有分析数据的棋谱要现场补算（本机实测 96 手约 29 秒）。补算完成后，插件会把逐手胜率、目差，以及 AI 首选与变化图一起写进 -sensei 副本：

LZ[] 不只是给别的软件看的：AI 首选与变化图只存在候选着法里。只写胜率/目差的话，文件下次被打开时已经算"有分析数据"→ 不会再补算，而候选又取不到 → 面板上就只剩问题手、没有首选点和变化图（2026-09-13 实报缺陷）。

于是同一份棋谱再打开就是秒开（面板、整页棋盘、右侧栏、go_review_moves 都不再触发补算），别的打谱软件打开副本也能直接看到胜率数据与首选/变化图。写回只发生在明确的分析动作里（go_review_moves 的自动补算、或显式调用 go_engine_analyze），只读的面板路由从不改文件；同一进程内还留了一份内存缓存，模型刚算过的棋谱面板直接复用。

早先复盘过的棋谱（那时只写了 WV[]/DM[]）想补上首选与变化图，对它显式跑一次 go_engine_analyze 即可：go_review_moves 不会自作主张重算（它认为"已有分析"），显式补算才会把 LZ[] 一并写上。补写同样落在副本里 —— 源棋谱里原有的分析数据原样不动。

写回与讲解回写共用同一套"重新序列化"逻辑，手数与旁支都不丢（幂等：重复写回不会堆积属性），而且都只动副本：**源棋谱一个字节