1. 什么是 SGF?

SGF 是为了存储双人棋类对局记录而设计的一种文件格式。它是纯文本格式，就是它不能包含二进制数据，所以可以方便地使用电子邮件发送或发送到新闻组。基于树形结构的意思是从根节点开始沿着主枝进行或转到 分支(或分支的分支)。

版本

• FF[1] 是由 Anders Kierulf 制订的最初的规格。此规格是其后续版本的核心。一些应用软件仍然使用此已经过时的规格，如 MGT(MS-DOS 版本)，该软件曾随着 Windows 的流行而十分流行。
• FF[3] 是由 Martin Müller 于 1993 年修订的规格。此规格是第一个针对棋步的严谨的规格。此后 SGF 成为互联网上围棋棋谱的标准格式。FF[3]定义了大量的新属性，如许多比赛信息属性和一些棋盘标记属性。
• FF[4] 是由 Arno Hollosi 在一些应用软件程序员帮助下于 1997 年完成的。FF[4] 继承 FF[3]的精神提供一个严谨明确的 SGF 定义。一些新的特性如箭头、连线等被引入。另外，FF[4]作为一个教新的规格，尚未被广泛采用，希望在今后能有改变。

SGF 文件看上去是怎样的?

(;FF[4]GM[1]SZ[19]AP[SGFC:1.13b]

PB[troy]BR[12k*]
PW[john]WR[11k*]
KM[0.5]RE[W+12.5]
DT[1998-06-15]
TM[600]

;B[pd];W[dp];B[pq];W[dd];B[qk];W[jd];B[fq];W[dj];B[jp];W[jj]
;B[cn]LB[dn:A][po:B]C[dada: other ideas are 'A' (d6) or 'B' (q5)]
;W[eo](;B[dl]C[dada: hm - looks troublesome.
Usually B plays the 3,3 invasion - see variation];W[qo];B[qp]
...
;W[sr];B[sk];W[sg];B[pa];W[gc];B[pi];W[ph];B[de];W[ed];B[kn]
;W[dh];B[eh];W[se];B[sd];W[af];B[ie];W[id];B[hf];W[hd];B[if]
;W[fp];B[gq];W[qj];B[sj];W[rh];B[sn];W[so];B[sm];W[ep];B[mn])
...
(;W[dq]N[wrong direction];B[qo];W[qp]))

SGF 应用软件

2. 基本概念

节点是最小可见单元。 就是用户可以沿着对局树一步步地查看节点(向前或向后)。

节点由属性组成。 属性包含一定地信息，例如属性 B[] 描述黑子着子，属性 C[] 包含评论文本 (不用担心: 你不必这些属性名字)。

举例说明:  你向后查看一个新着子，可以看到评论窗口内显示评论，同时棋盘上对应位置被标记，所有这些信息通过位于同一节点内的不同的属性表现出来。

这样，编辑棋谱有两种层次: 增加／删除节点和增加／删除属性。
请明白这一点:  一个着子是一个节点的一部分，而非节点是着子的一部分。着子通过属性来描述而且节点可以包含不只一个属性。

3. “走子”和“放置棋子”

• 走子
• 放置棋子

放置棋子 是把棋子放置在棋盘上来设置棋形， 例如让子、设置题形或分析形势。这种情况下，可以放置多个棋子及不同色的棋子，移走棋子和改变子色等都在一个节点中。
注意: 不能捕获棋子，因为这不是按比赛规则进行！

约定

因此把设置属性和走子属性放在一个节点中是 非法的。

走子属性 是一个黑子或白子的着子，可以对一个走子给予注释(例如恶手、有趣手等)或指示该手后还剩多少时间。
设置属性 是用来设置棋形就是在棋盘上放置黑白子或指示轮哪方走棋。

4. 风格

5. 分支

应用软件演示分支进行有两种方式: 兄弟节点方式和子节点方式。

子节点方式演示分支是 从父节点可以向任一子节点进行。

兄弟节点方式演示分支是 从父节点下的某一子节点可以向该父节点的另一子节点进行。

这两种不同方式的分支进行方式可能会引起混淆。例如，如果有评论是这样的: 这手棋不好，请看变化图B。如果作者使用子节点演示方式的应用软件，该评注则处于父节点上。如果读者使用兄弟节点演示方式的应用软件，将会看到评注在父节点上，但没有变化图，变化图在下一手才出现。反之(作者用兄弟节点方式，读者用子节点方式)也出现类似问题，读者在子节点上看到评注，但不得不退到上一手才能进入变化图。

许多人更喜欢兄弟节点方式因为它比较自然。他们甚至在子节点方式的应用软件中使用模仿的兄弟节点方式。他们的做法是在分支节点上取走前一个着子并增加一个新着子。这是不好的风格，而且自 FF[4] 起这也是非法的句法。它将导致你无法一览某一手的所有变化图，而且，转换成其它文件格式时也会带来麻烦。如果你喜欢兄弟节点方式那么就使用兄弟节点方式的应用软件。

6. 棋盘标记

标记	属性	备注
	MA[]	很常见 (自 FF[3] 起被引入)
	TR[]	很常见 (自 FF[3] 起被引入)
simple markup	M[]	过时的 (仅 FF[1] 使用), 很常见 此标记被 MA[] 和 TR[] 继承。不过，老的应用软件无法识别 MA[] 和 TR[] ，仍然使用 M[]
	CR[]	常见 (自 FF[3] 起被引入)
	SQ[]	常见 (自 FF[4] 起被引入)
	LB[]	常见(自 FF[3] 起被引入) 老的应用软件不能显示(例如: MGT DOS版)。注意由多个字符组成的长文字标记是被允许的。不过，许多应用软件只能显示前2－3个字符。请谨慎使用长文件标记。
letters	L[]	过时的 (仅 FF[1] 使用), 很常见 此标记被 LB[] 继承。不过，老的应用软件无法识别 LB[] ，仍然使用 L[]
	SL[]	过时的，不常见
	DD[]	新的 (自 FF[4] 起被引入), 很不常见 (也许将来会更常见)
	AR[]	新的 (自 FF[4] 起被引入), 很不常见 (也许将来会更常见)
	LN[]	新的 (自 FF[4] 起被引入), 很不常见 (也许将来会更常见)

7. 评论和注释

• 语言－如果你不懂该语言，你就无法理解评论。
• 应用软件不能使用文本来实现一些高级功能(如不能搜索恶手或手筋等)。
• 计算机玩家不能利用文本信息。

• 多语言支持 - 应用软件使用选定的语言显示信息。
• 搜索或其它数据库功能
• 计算机玩家可利用布局或定式库中的注释来决定最佳应手或好的变化手。

注释	属性	类型	程度	意义
黑好	GB	基本注释	是	黑棋形势占优
白好	GW	基本注释	是	白棋形势占优
两分	DM	基本注释	是	黑白双方形势相当
形势不明	UC	基本注释	是	黑白双方形势不明
热点	HO	基本注释	是	重要的节点，令人关注的着子
手筋	TE	走子注释	是	局部的好的着手
恶手	BM	走子注释	是	不好的着手
疑问手	DO	走子注释	否	值得推敲的着手
有趣手	IT	走子注释	否	有趣的着手
轮谁走	PL	位置注释	否	轮某方走

令人遗憾的是许多应用软件不能支持这些属性，希望将来能有所改观。尽可能使用注释属性，尽管它们很简单，却有很大的优势。

8. 比赛信息

注意，某些条目属性使用强制的格式。为什么？
因为符合标准的条目可以方便地被应用软件解析，并且可以被从多个对局文件中搜索或者用读者喜爱(定制)的方式显示。令人遗憾的是许多应用软件允许用户输入不合法的信息，所以能否输入正确的信息取决于用户，请谨慎使用。

比赛信息属性列表