SGF 围棋打谱网页生成器

将 SGF 格式的围棋棋谱转换为单文件 HTML 网页，支持本地浏览器打开进行交互式打谱。

功能亮点

🎯 多级变化分支 - 支持任意深度的嵌套变化图，可自由切换主分支和变化分支
🔊 真实音效系统 - 落子声、提子声、撤销声各有不同，Web Audio API 实时生成
✋ 试下功能 - 在任意局面下自由试下，支持提子判断
📱 响应式设计 - 手机/平板/桌面端自适应，触屏滑动支持
🌳 树状结构解析 - 完整支持 SGF 树状结构，支持 MultiGo、野狐等多种格式

安全说明 🔒

本技能是纯本地离线工具，无任何网络依赖：

安全项	说明
网络访问	❌ 无任何网络请求
文件系统	仅读写用户指定路径
第三方依赖	❌ 零依赖，仅用 Python 标准库
XSS防护	✅ `html.escape()` 转义所有 SGF 元数据
JSON注入防护	✅ `json.dumps()` + `html.escape()` + DOM解码三重保护

代码审计路径：

replay.py:43-48 - 所有用户输入的 HTML 转义
replay.py:58 - JSON 数据的安全编码
replay.html - JSON 解码使用 textarea.innerHTML 安全解码

功能描述

根据 SGF 格式的围棋棋谱数据，生成一个单文件 HTML 网页，支持本地浏览器打开进行交互式打谱。

依赖

无第三方依赖 - 使用 Python 标准库（sys, re, os, json, html）

核心文件

文件	功能
`scripts/replay.py`	SGF 转 HTML 主脚本
`scripts/sgf_parser.py`	SGF 树状解析模块
`scripts/templates/replay.html`	HTML 页面模板

使用方法

# 基本用法
python3 scripts/replay.py <输入.sgf> [输出.html]

# 示例
python3 scripts/replay.py game.sgf                    # 输出到 /tmp/sgf-viewer/
python3 scripts/replay.py game.sgf mygame.html        # 指定输出文件名
python3 scripts/replay.py game.sgf -o /path/to/dir    # 指定输出目录

直接用浏览器打开生成的 HTML 文件即可打谱。

快捷操作

平台	操作
桌面端	`←`/`→` 上一手/下一手，`空格` 播放/暂停
移动端	左滑下一手，右滑上一手

功能详解

变化图浏览

当棋谱包含 AI 变化图（如野狐围棋棋谱）时：

显示变化图按钮（带胜率信息，如"黑62%"）
点击进入变化图，自动显示手数标记
支持多级嵌套变化分支

试下功能

在棋盘任意空点点击可进入试下模式：

自由放置棋子，支持提子判断
可撤销/前进试下着法
点击 ✕ 退出试下，恢复原局面

音效系统

使用 Web Audio API 实时生成，无需加载音频文件：

落子声 - 清脆的"嗒"
提子声 - 短促的"啪"
撤销声 - 低沉的反馈

SGF 格式支持

格式	说明
标准格式	`(;GM[1];B[pd];W[pp]...)`
MultiGo	多分支嵌套格式
野狐格式	平面格式、带AI变化图
MULTIGOGM	定式库多向变化

API 接口

from sgf_parser import parse_sgf, parse_sgf_file

# 解析 SGF 字符串
result = parse_sgf(sgf_content)
# 返回: {"game_info": {...}, "tree": {...}, "stats": {...}, "errors": [...]}

# 解析 SGF 文件
result = parse_sgf_file("game.sgf")

更新日志

v2.0.1 (2026-04-09)

修复 JosekiDB 格式棋谱解析错误（支持分支起始处属性）
修复打谱网页滑条在主分支模式下无法跳转的问题
新增变化分支注释显示功能
新增快速返回上级按钮（⬅）
非主分支时自动隐藏音效按钮
使用棋局名称作为网页标题

v2.0.0 (2026-04-08)

重构打谱工具，支持嵌套变化图

使用指令示例

"把 xxx.sgf 生成打谱网页" "查看这盘棋的变化图" "生成一个围棋打谱页面"

围棋打谱工具

Safety Notice

Copy this and send it to your AI assistant to learn