项目值
名称TAG(规格文档 BIND TAG)
TAG ID0x1DAL
Codec ID0x00001DA0
规格文档0x00000000/codecs/0x00001DA0/(DECLARE 对象 1DA0)
章节14 1110(Meta),章节内偏移 C = 26
KindMeta · 类:谱系
TAG WORD0001 1101 1010 LLLL(000K KKKC CCCC LLLL)
索引说明附加在版本上的不可变名称。TEXT Value 与内容哈希(git annotated tag)
Hugo 侧meta/lineage/tag.md

字段(规格文档)

FIELD 在文档中的顺序就是 Payload 字段的顺序(Codec 规格文档)。

顺序字段(BIND)FIELD宽度接收格式(CODEC)ENUM
1name#2记录0720 UTF8-TEXT-EVEN, 0730 UTF8-TEXT-ODD
2target#7记录07C0 SHA-256-DIGEST, 0000 ABSENT(可选字段)

记录附加在版本上的不可变名称(git annotated tag)。

布局

TAG WORD          0001 1101 1010 LLLL      Codec 0x1DAL
[Length 扩展 TAG]
名称              UTF8-TEXT-* Value
对象              SHA-256-DIGEST Value,或省略标记 0x0000(可选字段)。省略则为本版本
  • Codec:Meta 0x1DAL,谱系类
  • Payload:内置 Value(文本 + 可选的内容哈希)
  • 数量:可有多个

解释与有效性

  • 名称是 UTF8-TEXT,对象是 SHA-256-DIGEST。
  • 省略对象时(ABSENT 0x0000,CODEC 可选字段),则是附加在本文档自身上的名称。自身的内容哈希无法写在自身之中。geul.org 规格 0x1DA0 是 name(0720·0730)与 target(07C0·0000)两个记录字段。
  • 同一名称不再用于其他版本。

示例

  • 名称 v1,本版本:1DA3 0721 7631 0000

未决问题

  • 已有版本 ID(序号)的情况下,是否仍需要 TAG。

规格文档原文

这是用 geul show 读取规格文档 0x00000000/codecs/0x00001DA0/latest.geul 的结果(十六进制为大写)。

SPEC-VERSION 0x0001
DOC-ID 0x04260000000000001DA000000000
BODY
#1 DECLARE 0x1DA0
#2 FIELD #1 record
#3 BIND #1 "TAG"
#4 BIND #2 "name"
#5 CODEC #2 0x0720
#6 CODEC #2 0x0730
#7 FIELD #1 record
#8 BIND #7 "target"
#9 CODEC #7 0x07C0
#10 CODEC #7 0x0000