5 分钟跑通 Sabaki：免费开源的围棋棋盘与 SGF 编辑器完整指南

5 分钟跑通 Sabaki：免费开源的围棋棋盘与 SGF 编辑器完整指南

【免费下载链接】SabakiAn elegant Go board and SGF editor for a more civilized age.项目地址: https://gitcode.com/gh_mirrors/sa/Sabaki

Sabaki 是一款免费开源（MIT 协议）的跨平台围棋棋盘与 SGF 编辑器，面向需要"下棋、记谱、复盘、分析"一条龙处理的用户。它直接读写 SGF，并能导入 wBaduk NGF、Tygem GIB、PandaNET UGF 三种平台的棋谱文件；接上 Leela Zero 或 KataGo 这类 GTP 引擎后，还可以在棋盘上直接跑胜率与热力图分析。

🧭 一句话读懂它——Sabaki 是什么

对弈软件管不了谱，谱编辑器下不了棋，AI 工具又只吐数字——围棋玩家的工具链常常是散的。Sabaki 把这四件事塞进同一个 Electron 桌面窗口：一个棋盘既能对局、也能编辑、还能挂引擎分析。它完全本地运行、代码开源可审计，不依赖任何在线服务。对需要频繁整理跨平台棋谱、或者想用 AI 逐步验证棋局的棋手来说，这就是少装三套软件的那个选择。

🗺️ 能力版图——Sabaki 到底能干什么

Sabaki 实际运行界面：棋盘上叠加了 AI 胜率标注，右侧是胜率曲线、棋谱树与 Markdown 注释框

🚀 新手直达——最短上手链路

1. 获取代码（需要 Node.js 环境）：

   git clone https://gitcode.com/gh_mirrors/sa/Sabaki cd Sabaki

2. 安装依赖：

   npm install

3. 启动应用：

   npm start

   这条命令等价于直接electron .，窗口打开即进入主界面。

4. 第一步操作：Ctrl/Cmd+O打开一份现成的 SGF 棋谱看看效果；或按Ctrl/Cmd+N新建一局，在棋盘上直接点交叉点落子即可记录。

正式打包的安装包（Windows 安装版、macOS dmg、Linux AppImage）由 electron-builder 生成，普通用户装好即可双击使用，无需走上面的源码流程。

🎯 高频场景——把它真正用起来

场景一：复盘旧谱并让 AI 逐步打分

背景：你有一份职业对局的 SGF，想知道每一步和 AI 建议的差距。关键操作：

1. 打开 SGF，在设置里配置引擎路径与参数（见 docs/guides/engines.md）；
2. 启动分析后逐手翻谱，观察棋盘上叠加的胜率数字与热力图；
3. 用Ctrl/Cmd+Shift+]/Ctrl/Cmd+Shift+[把好手、劣手标记到对应节点；
4. 在注释框里写 Markdown 复盘笔记，支持#手数直接链接到指定一手。

结果：得到一份带 AI 胜率轨迹、带记号和文字讲解的可保存棋谱，Ctrl/Cmd+S存盘即成教学材料。

场景二：从零记录一局棋并修正错漏

背景：和人对弈后要把棋局录入，中途落子位置总点偏。关键操作：

1. Ctrl/Cmd+N新建，设置棋盘与对局者信息；
2. 利用模糊落子——点交叉点附近即可吸附到正确位置；
3. 记错时按Ctrl/Cmd+Z撤销（Sabaki 的撤销可以连续回退多步），或进编辑模式用棋子工具直接覆盖；
4. 需要分支推演时复制变体，再决定哪条线升为主线。

结果：一份结构完整、带变体的 SGF，全程没写过一行 SGF 语法。

场景三：把散落的棋谱库变成可检索资产

背景：几百份棋谱堆在文件夹里，找某一手棋靠翻。关键操作：

1. Ctrl/Cmd+Shift+M打开棋谱管理抽屉，统一浏览与管理棋库；
2. Ctrl/Cmd+I补全对局信息（选手、日期、规则）；
3. Ctrl/Cmd+F进入查找模式，按落点坐标或注释文字搜索，F3/Shift+F3在命中之间跳转。

结果：按条件定位到具体某一手只需几秒，不再依赖文件名记忆。

⚡ 进阶提效——从会用到用得快

把常用操作挂到快捷键上

以下快捷键均定义在 src/menu.js（macOS 上 Ctrl 即 Cmd）：

给 GTP 引擎喂对参数

Sabaki 对任何支持 GTP（Go Text Protocol）的软件都是图形外壳。引擎本体要自行安装，然后在设置里填启动参数。三个典型写法（摘自 docs/guides/engines.md）：

• Leela Zero：--gtp -w path/to/weightsfile
• KataGo：gtp -model /path/to/model.txt.gz -config /path/to/gtp_example.cfg
• GNU Go：--mode gtp

其中 Leela Zero 与 KataGo 还支持棋盘分析，接入细节见 docs/guides/engine-analysis-integration.md。

把界面改成自己的样子

棋盘纹理、棋子样式都可以整包替换，社区主题目录在 docs/guides/theme-directory.md；想自己动手写 CSS，docs/guides/userstyle-tutorial.md 和 docs/guides/create-themes.md 覆盖从 userstyle 到打包主题的完整流程。界面语言在偏好设置里切换，多语言机制见 src/i18n.js。

Sabaki 项目横幅，展示棋盘主题与程序整体风格

🩺 卡点排查——遇到问题怎么办

npm start 报错或窗口打不开？先确认 Node.js 已安装且版本较新；在项目目录内执行npm install后再npm start。依赖安装失败通常是网络或 node_modules 状态问题，删除 node_modules 后重装依赖再试。构建相关细节见 docs/guides/building-tests.md。

打开了 NGF / GIB / UGF 文件，保存时格式变了？这三种格式只读，Sabaki 导入后统一按 SGF 保存。属正常行为：Ctrl/Cmd+S存为 SGF 即可，SGF 是所有平台的通用交换格式。

配置了引擎却连接不上？两点逐一核对：① 引擎本体能否在命令行独立跑通 GTP 模式；② 参数是否与引擎版本匹配（Leela Zero 必须带--gtp和权重路径，KataGo 需指定-model）。引擎文档见 docs/guides/engines.md。

点错交叉点、谱记歪了怎么办？普通对局直接Ctrl/Cmd+Z强撤销回退；已生成的谱可进编辑模式（Ctrl+E），Ctrl+1选棋子工具在目标点直接覆盖，再删掉错误节点即可。

界面语言或落子音效不符合习惯？打开偏好设置（Ctrl/Cmd+,），语言与声音选项都在这里；音效文件位于 data/ 目录，可自行替换。

📚 延伸导航——继续深挖

• 官方文档总入口：docs/README.md
• 引擎配置指南：docs/guides/engines.md
• 棋盘分析集成：docs/guides/engine-analysis-integration.md
• Markdown 注释语法：docs/guides/markdown.md
• 纹理与主题目录：docs/guides/theme-directory.md
• 调试指南：docs/guides/debugging.md
• 快捷键与菜单实现：src/menu.js
• 端到端测试用例：e2e/

下一步建议：先按"新手直达"跑起来，打开一份职业对局 SGF 走完场景一的复盘流程，再配一个 Leela Zero 引擎体验棋盘分析。棋库整理和主题定制可以放到第二周——工具在手，谱才真正开始说话。

【免费下载链接】SabakiAn elegant Go board and SGF editor for a more civilized age.项目地址: https://gitcode.com/gh_mirrors/sa/Sabaki