pin

type Mode int

type Pinned struct {
	Key  cid.Cid
	Mode Mode
	Via  cid.Cid
}

type Pinner interface {
	//is pinned返回给定的cid是否被固定
	//解释了它为什么会被钉住
	IsPinned(cid.Cid) (string, bool, error)

	//ispinnedwithType返回给定的cid是否与
	//给定的pin类型，以及返回其固定的pin类型。
	IsPinnedWithType(cid.Cid, Mode) (string, bool, error)

	//固定给定节点（可选递归）。
	Pin(ctx context.Context, node ipld.Node, recursive bool) error

	//解锁给定的CID。如果recursive为true，则移除递归或
	//直接销如果recursive为false，则只删除直接pin。
	Unpin(ctx context.Context, cid cid.Cid, recursive bool) error

	//更新将递归pin从一个cid更新到另一个cid
	//这比简单地固定新的和取消固定
	//旧的
	Update(ctx context.Context, from, to cid.Cid, unpin bool) error

	//检查一组键是否固定，是否比
	//为每个键调用ispinned
	CheckIfPinned(cids ...cid.Cid) ([]Pinned, error)

	//pinwithMode用于手动编辑pin结构。使用与
	//小心！如果使用不当，垃圾收集可能不会
	//成功。
	PinWithMode(cid.Cid, Mode)

	//removePinWithMode用于手动编辑销结构。
	//小心使用！如果使用不当，垃圾收集可能不会
	//成功。
	RemovePinWithMode(cid.Cid, Mode)

	//flush将pin状态写入备份数据存储
	Flush() error

	//DirectKeys返回所有直接固定的CID
	DirectKeys() []cid.Cid

	//DirectKeys返回所有递归固定的CID
	RecursiveKeys() []cid.Cid

	//InternalPins返回为
	//佩内尔
	InternalPins() []cid.Cid
}