Skip to content

An open-source, privacy-first, self-hosted knowledge workspace where humans and AI agents work together 开源、隐私优先、自托管的知识工作空间,让人与智能体在此协作

26.1 KB
Raw Blame
// SiYuan - https://github.com/siyuan-note/siyuan
// Copyright (c) 2020-present, b3log.org
// SPDX-License-Identifier: AGPL-3.0-or-later

package model

import (
	"errors"
	"fmt"
	"os"
	"path/filepath"
	"sort"
	"strings"
	"unicode/utf8"

	"github.com/88250/gulu"
	"github.com/88250/lute/ast"
	"github.com/88250/lute/editor"
	"github.com/88250/lute/parse"
	"github.com/siyuan-note/logging"
	"github.com/siyuan-note/siyuan/kernel/av"
	"github.com/siyuan-note/siyuan/kernel/filesys"
	"github.com/siyuan-note/siyuan/kernel/sql"
	"github.com/siyuan-note/siyuan/kernel/treenode"
	"github.com/siyuan-note/siyuan/kernel/util"
)

type BlockInfo struct {
	ID           string            `json:"id"`
	RootID       string            `json:"rootID"`
	Name         string            `json:"name"`
	RefCount     int               `json:"refCount"`
	SubFileCount int               `json:"subFileCount"`
	RefIDs       []string          `json:"refIDs"`
	IAL          map[string]string `json:"ial"`
	Icon         string            `json:"icon"`
	AttrViews    []*AttrView       `json:"attrViews"`
}

type AttrView struct {
	ID   string `json:"id"`
	Name string `json:"name"`
}

func GetDocInfo(blockID string) (ret *BlockInfo, err error) {
	return GetDocInfoInBox(blockID, "")
}

// GetDocInfoInBox 与 GetDocInfo 一致,但按 boxID 路由 blocktree/refs 查询到加密 db 或全局 db。
func GetDocInfoInBox(blockID, boxID string) (ret *BlockInfo, err error) {
	FlushTxQueue()

	tree, err := loadTreeByBlockIDInBox(blockID, boxID)
	if err != nil {
		if errors.Is(err, ErrIndexing) {
			logging.LogWarnf("load tree by root id [%s] failed: %s", blockID, err)
		} else {
			logging.LogErrorf("load tree by root id [%s] failed: %s", blockID, err)
		}
		return
	}
	ret = getDocInfoByTree(blockID, tree)
	return
}

func getDocInfoByTree(blockID string, tree *parse.Tree) (ret *BlockInfo) {
	boxID := tree.Box
	title := treenode.ReadDocumentTitle(tree.Root).Text
	ret = &BlockInfo{ID: blockID, RootID: tree.Root.ID, Name: title}
	ret.IAL = parse.IAL2Map(tree.Root.KramdownIAL)
	scrollData := ret.IAL["scroll"]
	if 0 < len(scrollData) {
		// scroll 属性值在持久化时会被 html.EscapeAttrVal() 进行 HTML 转义(如 " 变为 &quot;),
		// 虽然 parse.IAL2Map() 中会调用 html.UnescapeAttrVal() 进行反转义,
		// 但部分历史数据或某些历史路径下可能出现反转义不完整的情况,导致 JSON 解析失败,
		// 这里做一次防御性反转义,确保 JSON 解析不会因为残留的 HTML 实体而报错
		scrollData = util.UnescapeHTML(scrollData)
		scroll := map[string]any{}
		if parseErr := gulu.JSON.UnmarshalJSON([]byte(scrollData), &scroll); nil != parseErr {
			logging.LogWarnf("parse scroll data [%s] failed: %s", scrollData, parseErr)
			delete(ret.IAL, "scroll")
		} else {
			if zoomInId := scroll["zoomInId"]; nil != zoomInId {
				if !treenode.ExistBlockTreeInBox(zoomInId.(string), boxID) {
					delete(ret.IAL, "scroll")
				}
			} else {
				if startId := scroll["startId"]; nil != startId {
					if !treenode.ExistBlockTreeInBox(startId.(string), boxID) {
						delete(ret.IAL, "scroll")
					}
				}
				if endId := scroll["endId"]; nil != endId {
					if !treenode.ExistBlockTreeInBox(endId.(string), boxID) {
						delete(ret.IAL, "scroll")
					}
				}
			}
		}
	}

	bt := treenode.GetBlockTreeInBox(blockID, boxID)
	refBoxID := boxID
	if nil != bt {
		refBoxID = bt.BoxID
	}
	refDefs := queryBlockRefDefsInBox(bt, refBoxID)
	refDefs, _ = buildBacklinkListItemRefsInBox(refDefs, refBoxID)
	var refIDs []string
	for _, refDef := range refDefs {
		refIDs = append(refIDs, refDef.RefID)
	}
	if 1 > len(refIDs) {
		refIDs = []string{}
	}
	ret.RefIDs = refIDs
	ret.RefCount = len(ret.RefIDs)

	// 填充属性视图角标 Display the database title on the block superscript https://github.com/siyuan-note/siyuan/issues/10545
	avIDs := strings.SplitSeq(ret.IAL[av.NodeAttrNameAvs], ",")
	for avID := range avIDs {
		if !ast.IsNodeIDPattern(avID) {
			continue
		}

		var avName string
		var getErr error
		if boxID != "" && IsEncryptedBox(boxID) {
			avName, getErr = av.GetAttributeViewNameInBox(avID, boxID)
		} else {
			avName, getErr = av.GetAttributeViewName(avID)
		}
		if nil != getErr {
			continue
		}

		if "" == avName {
			avName = Conf.language(105)
		}

		attrView := &AttrView{ID: avID, Name: avName}
		ret.AttrViews = append(ret.AttrViews, attrView)
	}

	var subFileCount int
	if IsBoxDoc(tree.Box, tree.ID) {
		subFileCount = BoxDocSubFileCount(tree.Box)
	} else {
		boxLocalPath := filepath.Join(util.DataDir, tree.Box)
		subFiles, readErr := os.ReadDir(filepath.Join(boxLocalPath, strings.TrimSuffix(tree.Path, ".sy")))
		if readErr == nil {
			for _, subFile := range subFiles {
				if strings.HasSuffix(subFile.Name(), ".sy") {
					subFileCount++
				}
			}
		}
	}
	ret.SubFileCount = subFileCount
	if icon, ok := util.FilterIconValue(tree.Root.IALAttr("icon")); ok {
		ret.Icon = icon
	}
	return
}

func GetDocsInfo(blockIDs []string, queryRefCount bool, queryAv bool) (rets []*BlockInfo) {
	FlushTxQueue()

	trees := filesys.LoadTrees(blockIDs)
	bts := treenode.GetBlockTrees(blockIDs)
	for _, id := range blockIDs {
		if _, ok := bts[id]; !ok {
			for _, encBoxID := range treenode.GetOpenedEncryptedBoxIDs() {
				if encBT := treenode.GetBlockTreeInBox(id, encBoxID); nil != encBT {
					bts[id] = encBT
					break
				}
			}
		}
	}
	for _, blockID := range blockIDs {
		tree := trees[blockID]
		if nil == tree {
			continue
		}
		title := treenode.ReadDocumentTitle(tree.Root).Text
		ret := &BlockInfo{ID: blockID, RootID: tree.Root.ID, Name: title}
		ret.IAL = parse.IAL2Map(tree.Root.KramdownIAL)
		scrollData := ret.IAL["scroll"]
		if 0 < len(scrollData) {
			// scroll 属性值在持久化时会被 html.EscapeAttrVal() 进行 HTML 转义(如 " 变为 &quot;),
			// 虽然 parse.IAL2Map() 中会调用 html.UnescapeAttrVal() 进行反转义,
			// 但部分历史数据或某些路径下可能出现反转义不完整的情况,导致 JSON 解析失败,
			// 这里做一次防御性反转义,确保 JSON 解析不会因为残留的 HTML 实体而报错
			scrollData = util.UnescapeHTML(scrollData)
			scroll := map[string]any{}
			if parseErr := gulu.JSON.UnmarshalJSON([]byte(scrollData), &scroll); nil != parseErr {
				logging.LogWarnf("parse scroll data [%s] failed: %s", scrollData, parseErr)
				delete(ret.IAL, "scroll")
			} else {
				if zoomInId := scroll["zoomInId"]; nil != zoomInId {
					if !treenode.ExistBlockTree(zoomInId.(string)) {
						delete(ret.IAL, "scroll")
					}
				} else {
					if startId := scroll["startId"]; nil != startId {
						if !treenode.ExistBlockTree(startId.(string)) {
							delete(ret.IAL, "scroll")
						}
					}
					if endId := scroll["endId"]; nil != endId {
						if !treenode.ExistBlockTree(endId.(string)) {
							delete(ret.IAL, "scroll")
						}
					}
				}
			}
		}
		if queryRefCount {
			var refIDs []string
			refDefs := queryBlockRefDefs(bts[blockID])
			refDefs, _ = buildBacklinkListItemRefs(refDefs)
			for _, refDef := range refDefs {
				refIDs = append(refIDs, refDef.RefID)
			}
			if 1 > len(refIDs) {
				refIDs = []string{}
			}
			ret.RefIDs = refIDs
			ret.RefCount = len(ret.RefIDs)
		}

		if queryAv {
			// 填充属性视图角标 Display the database title on the block superscript https://github.com/siyuan-note/siyuan/issues/10545
			avIDs := strings.SplitSeq(ret.IAL[av.NodeAttrNameAvs], ",")
			for avID := range avIDs {
				if !ast.IsNodeIDPattern(avID) {
					continue
				}

				avName, getErr := av.GetAttributeViewName(avID)
				if nil != getErr {
					continue
				}

				if "" == avName {
					avName = Conf.language(105)
				}

				attrView := &AttrView{ID: avID, Name: avName}
				ret.AttrViews = append(ret.AttrViews, attrView)
			}
		}

		var subFileCount int
		if IsBoxDoc(tree.Box, tree.ID) {
			subFileCount = BoxDocSubFileCount(tree.Box)
		} else {
			boxLocalPath := filepath.Join(util.DataDir, tree.Box)
			subFiles, readErr := os.ReadDir(filepath.Join(boxLocalPath, strings.TrimSuffix(tree.Path, ".sy")))
			if readErr == nil {
				for _, subFile := range subFiles {
					if strings.HasSuffix(subFile.Name(), ".sy") {
						subFileCount++
					}
				}
			}
		}
		ret.SubFileCount = subFileCount
		if icon, ok := util.FilterIconValue(tree.Root.IALAttr("icon")); ok {
			ret.Icon = icon
		}

		rets = append(rets, ret)

	}
	return
}

func GetBlockRefText(id string) string {
	FlushTxQueue()

	bt := treenode.GetBlockTree(id)
	if nil == bt {
		return ErrBlockNotFound.Error()
	}

	tree, err := LoadTreeByBlockID(id)
	if err != nil {
		return ""
	}

	node := treenode.GetNodeInTree(tree, id)
	if nil == node {
		return ErrBlockNotFound.Error()
	}

	return getNodeRefText(node)
}

func GetDOMText(dom string) (ret string) {
	luteEngine := NewLute()
	tree := luteEngine.BlockDOM2Tree(dom)
	ret = renderBlockText(tree.Root.FirstChild, nil, true)
	return
}

func getBlockRefText(id string, tree *parse.Tree) (ret string) {
	node := treenode.GetNodeInTree(tree, id)
	if nil == node {
		return
	}

	ret = getNodeRefText(node)
	ret = maxContent(ret, Conf.Editor.Load().BlockRefDynamicAnchorTextMaxLen)
	return
}

func getNodeRefText(node *ast.Node) string {
	if nil == node {
		return ""
	}

	if ret := node.IALAttr("name"); "" != ret {
		ret = strings.TrimSpace(ret)
		ret = util.EscapeHTML(ret)
		return ret
	}
	return getNodeRefText0(node, Conf.Editor.Load().BlockRefDynamicAnchorTextMaxLen, true)
}

func getNodeAvBlockText(node *ast.Node, avID string) (icon, content string) {
	if nil == node {
		return
	}

	icon = node.IALAttr("icon")
	if filteredIcon, valid := util.FilterIconValue(icon); valid {
		icon = filteredIcon
	} else {
		icon = ""
	}
	if name := node.IALAttr("name"); "" != name {
		name = strings.TrimSpace(name)
		name = util.EscapeHTML(name)
		content = name
	} else {
		content = getNodeRefText0(node, 1024, false)
	}

	content = strings.TrimSpace(content)
	if "" != avID {
		if staticText := node.IALAttr(av.NodeAttrViewStaticText + "-" + avID); "" != staticText {
			content = staticText
		}
	}
	if "" == content {
		content = Conf.language(105)
	}
	return
}

func getNodeAvBlockRefSubtype(node *ast.Node, avID string) av.BlockRefSubtype {
	if nil == node {
		return av.BlockRefSubtypeDynamic
	}
	if "" != avID && "" != node.IALAttr(av.NodeAttrViewStaticText+"-"+avID) {
		return av.BlockRefSubtypeStatic
	}
	return av.BlockRefSubtypeDynamic
}

func getNodeRefText0(node *ast.Node, maxLen int, removeLineBreak bool) string {
	switch node.Type {
	case ast.NodeBlockQueryEmbed:
		return "Query Embed Block..."
	case ast.NodeIFrame:
		return "IFrame..."
	case ast.NodeThematicBreak:
		return "Thematic Break..."
	case ast.NodeVideo:
		return "Video..."
	case ast.NodeAudio:
		return "Audio..."
	case ast.NodeTabItem:
		if title := treenode.TabTitleParagraph(node); nil != title {
			return getNodeRefText0(title, maxLen, removeLineBreak)
		}
	case ast.NodeAttributeView:
		ret, _ := av.GetAttributeViewName(node.AttributeViewID)
		if "" == ret {
			ret = "Database..."
		}
		return ret
	}

	if ast.NodeDocument != node.Type && node.IsContainerBlock() {
		node = treenode.FirstLeafBlock(node)
	}
	if nil != node && ast.NodeDocument != node.Type {
		hasMemo := false
		ast.Walk(node, func(n *ast.Node, entering bool) ast.WalkStatus {
			if entering && n.IsTextMarkType("inline-memo") && "" != n.TextMarkInlineMemoContent {
				hasMemo = true
				return ast.WalkStop
			}
			return ast.WalkContinue
		})
		if hasMemo {
			// 锚文本只保留可见文字,在副本上过滤备注以保留源块内容。
			node = cloneRenderNode(node)
			ast.Walk(node, func(n *ast.Node, entering bool) ast.WalkStatus {
				if entering && n.IsTextMarkType("inline-memo") {
					n.TextMarkInlineMemoContent = ""
				}
				return ast.WalkContinue
			})
		}
	}
	ret := renderBlockText(node, nil, removeLineBreak)
	if maxLen < utf8.RuneCountInString(ret) {
		ret = gulu.Str.SubStr(ret, maxLen) + "..."
	}
	return ret
}

type RefDefs struct {
	RefID  string   `json:"refID"`
	DefIDs []string `json:"defIDs"`
}

// GetBlockRefsInBox 获取指定笔记本内的块引用关系。空 box 不回退搜索加密笔记本。
func GetBlockRefsInBox(defID, boxID string) (refDefs []*RefDefs, originalRefBlockIDs map[string]string) {
	refDefs = []*RefDefs{}
	originalRefBlockIDs = map[string]string{}
	bt := treenode.GetBlockTreeInBox(defID, boxID)
	if nil == bt {
		return
	}

	// 加密笔记本的 refs 在加密 db,用 bt.BoxID 路由
	refDefs = queryBlockRefDefsInBox(bt, bt.BoxID)
	refDefs, originalRefBlockIDs = buildBacklinkListItemRefsInBox(refDefs, bt.BoxID)
	return
}

func queryBlockRefDefs(bt *treenode.BlockTree) (refDefs []*RefDefs) {
	return queryBlockRefDefsInBox(bt, bt.BoxID)
}

// queryBlockRefDefsInBox 与 queryBlockRefDefs 一致,但按 boxID 路由到加密 db 或全局 db。
func queryBlockRefDefsInBox(bt *treenode.BlockTree, boxID string) (refDefs []*RefDefs) {
	refDefs = []*RefDefs{}
	if nil == bt {
		return
	}

	isDoc := bt.ID == bt.RootID
	if isDoc {
		refDefIDs := sql.QueryChildRefDefIDsByRootDefIDInBox(bt.RootID, boxID)
		for rID, dIDs := range refDefIDs {
			var defIDs []string
			for _, dID := range dIDs {
				defIDs = append(defIDs, dID)
			}
			if 1 > len(defIDs) {
				defIDs = []string{}
			}
			refDefs = append(refDefs, &RefDefs{RefID: rID, DefIDs: defIDs})
		}
	} else {
		refIDs := sql.QueryRefIDsByDefIDInBox(bt.ID, false, boxID)
		for _, refID := range refIDs {
			refDefs = append(refDefs, &RefDefs{RefID: refID, DefIDs: []string{bt.ID}})
		}
	}
	return
}

func GetBlockRefIDsByFileAnnotationIDInBox(id, boxID string) []string {
	return sql.QueryRefIDsByAnnotationIDInBox(id, boxID)
}

func GetBlockDefIDsByRefTextInBox(refText, boxID string) (ret []string) {
	if boxID == "" {
		ret = sql.QueryBlockDefIDsByRefText(refText)
	} else {
		ret = sql.QueryBlockDefIDsByRefTextInBox(refText, boxID)
	}
	sort.Sort(sort.Reverse(sort.StringSlice(ret)))
	if 1 > len(ret) {
		ret = []string{}
	}
	return
}

func GetBlockIndex(id string) (ret int) {
	tree, _ := LoadTreeByBlockID(id)
	if nil == tree {
		return
	}
	node := treenode.GetNodeInTree(tree, id)
	if nil == node {
		return
	}

	rootChild := node
	for ; nil != rootChild.Parent && ast.NodeDocument != rootChild.Parent.Type; rootChild = rootChild.Parent {
	}

	ast.Walk(tree.Root, func(n *ast.Node, entering bool) ast.WalkStatus {
		if !entering {
			return ast.WalkContinue
		}

		if !n.IsChildBlockOf(tree.Root, 1) {
			return ast.WalkContinue
		}

		ret++
		if n.ID == rootChild.ID {
			return ast.WalkStop
		}
		return ast.WalkContinue
	})
	return
}

func GetBlocksIndexes(ids []string) (ret map[string]int) {
	ret = map[string]int{}
	if 1 > len(ids) {
		return
	}

	tree, _ := LoadTreeByBlockID(ids[0])
	if nil == tree {
		return
	}

	idx := 0
	nodesIndexes := map[string]int{}
	ast.Walk(tree.Root, func(n *ast.Node, entering bool) ast.WalkStatus {
		if !entering {
			return ast.WalkContinue
		}

		if !n.IsChildBlockOf(tree.Root, 1) {
			if n.IsBlock() {
				nodesIndexes[n.ID] = idx
			}
			return ast.WalkContinue
		}

		idx++
		nodesIndexes[n.ID] = idx
		return ast.WalkContinue
	})

	for _, id := range ids {
		ret[id] = nodesIndexes[id]
	}
	return
}

func GetDocBlocksOrders(id string) (ret []string, err error) {
	ret = []string{}
	tree, err := LoadTreeByBlockID(id)
	if err != nil {
		return
	}
	if nil == tree || nil == tree.Root {
		err = ErrTreeNotFound
		return
	}
	if tree.Root.ID != id {
		err = fmt.Errorf("block [%s] is not a document", id)
		return
	}

	ret = getDocBlocksOrdersInTree(tree)
	return
}

func getDocBlocksOrdersInTree(tree *parse.Tree) (ret []string) {
	ret = []string{}
	ast.Walk(tree.Root, func(n *ast.Node, entering bool) ast.WalkStatus {
		if !entering || n == tree.Root || !n.IsBlock() || ast.NodeKramdownBlockIAL == n.Type || "" == n.ID {
			return ast.WalkContinue
		}

		ret = append(ret, n.ID)
		return ast.WalkContinue
	})
	return
}

type BlockPath struct {
	ID            string       `json:"id"`
	Name          string       `json:"name"`
	DocumentTitle string       `json:"documentTitle,omitempty"`
	Type          string       `json:"type"`
	SubType       string       `json:"subType"`
	Children      []*BlockPath `json:"children"`
	HasChildren   bool         `json:"hasChildren,omitempty"`
}

type BlockBreadcrumbChildren struct {
	Items   []*BlockPath `json:"items"`
	HasMore bool         `json:"hasMore"`
}

func BuildBlockBreadcrumb(id string, excludeTypes []string) (ret []*BlockPath, err error) {
	return BuildBlockBreadcrumbInBox(id, excludeTypes, "")
}

// BuildBlockBreadcrumbInBox 与 BuildBlockBreadcrumb 一致,但按 boxID 路由 blocktree 查询到加密 db 或全局 db。
func BuildBlockBreadcrumbInBox(id string, excludeTypes []string, boxID string) (ret []*BlockPath, err error) {
	ret = []*BlockPath{}
	tree, err := loadTreeByBlockIDInBox(id, boxID)
	if nil == tree {
		err = nil
		return
	}
	node := treenode.GetNodeInTree(tree, id)
	if nil == node {
		return
	}

	ret = buildBlockBreadcrumb(node, excludeTypes, false)
	return
}

func GetBlockBreadcrumbChildrenInBox(id string, excludeTypes []string, offset, limit int, boxID string) (
	ret *BlockBreadcrumbChildren, err error) {
	ret = &BlockBreadcrumbChildren{Items: []*BlockPath{}}
	if offset < 0 {
		offset = 0
	}
	if limit < 1 {
		limit = 64
	} else if 256 < limit {
		limit = 256
	}

	tree, err := loadTreeByBlockIDInBox(id, boxID)
	if nil == tree {
		err = nil
		return
	}
	node := treenode.GetNodeInTree(tree, id)
	if nil == node {
		return
	}

	ret = collectBlockBreadcrumbChildren(node, excludeTypes, offset, limit)
	return
}

func collectBlockBreadcrumbChildren(node *ast.Node, excludeTypes []string, offset, limit int) (
	ret *BlockBreadcrumbChildren) {
	ret = &BlockBreadcrumbChildren{Items: []*BlockPath{}}
	index := 0
	walkBlockBreadcrumbChildren(node, func(child *ast.Node) bool {
		if index < offset {
			index++
			return true
		}
		if limit <= len(ret.Items) {
			ret.HasMore = true
			return false
		}

		item := buildBlockBreadcrumbChild(child, excludeTypes)
		item.HasChildren = hasBlockBreadcrumbChildren(child)
		ret.Items = append(ret.Items, item)
		index++
		return true
	})
	return
}

func walkBlockBreadcrumbChildren(node *ast.Node, walker func(child *ast.Node) bool) {
	if nil == node {
		return
	}

	if ast.NodeHeading == node.Type {
		headingLevels := []int{node.HeadingLevel}
		for child := node.Next; nil != child; child = child.Next {
			if !child.IsBlock() {
				continue
			}
			if ast.NodeHeading == child.Type {
				if child.HeadingLevel <= node.HeadingLevel {
					return
				}
				for 1 < len(headingLevels) && headingLevels[len(headingLevels)-1] >= child.HeadingLevel {
					headingLevels = headingLevels[:len(headingLevels)-1]
				}
				if 1 == len(headingLevels) && !walker(child) {
					return
				}
				headingLevels = append(headingLevels, child.HeadingLevel)
			} else if 1 == len(headingLevels) && !walker(child) {
				return
			}
		}
		return
	}

	if ast.NodeDocument != node.Type && !node.IsContainerBlock() {
		return
	}

	var headingLevels []int
	for child := node.FirstChild; nil != child; child = child.Next {
		if !child.IsBlock() {
			continue
		}
		if ast.NodeHeading == child.Type {
			for 0 < len(headingLevels) && headingLevels[len(headingLevels)-1] >= child.HeadingLevel {
				headingLevels = headingLevels[:len(headingLevels)-1]
			}
			if 0 == len(headingLevels) && !walker(child) {
				return
			}
			headingLevels = append(headingLevels, child.HeadingLevel)
		} else if 0 == len(headingLevels) && !walker(child) {
			return
		}
	}
}

func hasBlockBreadcrumbChildren(node *ast.Node) (ret bool) {
	walkBlockBreadcrumbChildren(node, func(child *ast.Node) bool {
		ret = true
		return false
	})
	return
}

func buildBlockBreadcrumbChild(node *ast.Node, excludeTypes []string) (ret *BlockPath) {
	maxNameLen := 1024
	fc := treenode.FirstLeafBlock(node)
	name := node.IALAttr("name")
	if ast.NodeAttributeView == node.Type {
		name, _ = av.GetAttributeViewName(node.AttributeViewID)
	} else if ast.NodeTabItem == node.Type && "" == name {
		name = getNodeRefText0(node, maxNameLen, true)
	} else if "" == name {
		if ast.NodeListItem == node.Type || ast.NodeList == node.Type || ast.NodeMindmapItem == node.Type || ast.NodeMindmap == node.Type || ast.NodeSuperBlock == node.Type ||
			ast.NodeBlockquote == node.Type || ast.NodeCallout == node.Type {
			name = gulu.Str.SubStr(renderBlockText(fc, excludeTypes, true), maxNameLen)
		} else {
			name = gulu.Str.SubStr(renderBlockText(node, excludeTypes, true), maxNameLen)
		}
	}
	if ast.NodeListItem == node.Type && "" == name {
		name = gulu.Str.SubStr(renderBlockText(fc, excludeTypes, true), maxNameLen)
	}

	name = strings.ReplaceAll(name, editor.Caret, "")
	name = util.UnescapeHTML(name)
	name = util.EscapeHTML(name)
	return &BlockPath{
		ID:      node.ID,
		Name:    name,
		Type:    node.Type.String(),
		SubType: treenode.SubTypeAbbr(node),
	}
}

func buildBlockBreadcrumb(node *ast.Node, excludeTypes []string, isEmbedBlock bool, headingMode ...int) (ret []*BlockPath) {
	ret = []*BlockPath{}
	if nil == node {
		return
	}
	box := Conf.Box(node.Box)
	if nil == box {
		return
	}

	// 默认 headingMode 为 0
	mode := 0
	if len(headingMode) > 0 {
		mode = headingMode[0]
	}

	headingLevel := 16
	maxNameLen := 1024
	var hPath string
	baseBlock := treenode.GetBlockTreeRootByPath(node.Box, node.Path)
	if nil != baseBlock {
		hPath = baseBlock.HPath
	}
	for parent := node; nil != parent; parent = parent.Parent {
		if "" == parent.ID {
			continue
		}
		id := parent.ID
		fc := treenode.FirstLeafBlock(parent)

		name := parent.IALAttr("name")
		if ast.NodeDocument == parent.Type {
			if IsBoxDoc(node.Box, parent.ID) {
				name = box.Name
			} else {
				name = box.Name + hPath
			}
		} else if ast.NodeAttributeView == parent.Type {
			name, _ = av.GetAttributeViewName(parent.AttributeViewID)
		} else if ast.NodeTabItem == parent.Type && "" == name {
			name = getNodeRefText0(parent, maxNameLen, true)
		} else {
			if "" == name {
				if ast.NodeListItem == parent.Type || ast.NodeList == parent.Type || ast.NodeMindmapItem == parent.Type || ast.NodeMindmap == parent.Type || ast.NodeSuperBlock == parent.Type || ast.NodeBlockquote == parent.Type || ast.NodeCallout == parent.Type {
					name = gulu.Str.SubStr(renderBlockText(fc, excludeTypes, true), maxNameLen)
				} else {
					name = gulu.Str.SubStr(renderBlockText(parent, excludeTypes, true), maxNameLen)
				}
			}
			if ast.NodeHeading == parent.Type {
				headingLevel = parent.HeadingLevel
			}
		}

		add := true
		if ast.NodeList == parent.Type || ast.NodeMindmap == parent.Type || ast.NodeSuperBlock == parent.Type || ast.NodeBlockquote == parent.Type || ast.NodeCallout == parent.Type {
			add = false
			if parent == node {
				// https://github.com/siyuan-note/siyuan/issues/13141#issuecomment-2476789553
				add = true
			}
		}
		if ast.NodeParagraph == parent.Type && nil != parent.Parent && ast.NodeListItem == parent.Parent.Type && nil == parent.Next && (nil == parent.Previous || ast.NodeTaskListItemMarker == parent.Previous.Type) {
			add = false
		}
		if ast.NodeListItem == parent.Type {
			if "" == name {
				name = gulu.Str.SubStr(renderBlockText(fc, excludeTypes, true), maxNameLen)
			}
		}

		name = strings.ReplaceAll(name, editor.Caret, "")
		name = util.UnescapeHTML(name)
		name = util.EscapeHTML(name)

		if !isEmbedBlock {
			if parent == node {
				name = ""
			}
		} else {
			if ast.NodeDocument != parent.Type {
				// 当headingMode=2(仅显示标题下方的块)且当前节点是标题时,保留标题名称
				if 2 == mode && ast.NodeHeading == parent.Type && parent == node {
					// 保留标题名称,不清空
				} else {
					// 在嵌入块中隐藏最后一个非文档路径的面包屑中的文本 Hide text in breadcrumb of last non-document path in embed block https://github.com/siyuan-note/siyuan/issues/13866
					name = ""
				}
			}
		}

		if add {
			documentTitle := ""
			if isEmbedBlock && ast.NodeDocument == parent.Type {
				documentTitle = util.EscapeHTML(strings.ReplaceAll(treenode.ReadDocumentTitle(parent).Text, editor.Caret, ""))
			}
			ret = append([]*BlockPath{{
				ID:            id,
				Name:          name,
				DocumentTitle: documentTitle,
				Type:          parent.Type.String(),
				SubType:       treenode.SubTypeAbbr(parent),
			}}, ret...)
		}

		// 容器块(引述/超级块/列表等)内部的标题构成独立的子大纲,扫描容器外部同级标题前需重置标题层级约束,
		// 否则容器内部更宽(层级更小)的标题会错误地限制容器外部同级标题的收集 https://github.com/siyuan-note/siyuan/issues/17930
		if ast.NodeDocument != parent.Type && parent.IsContainerBlock() {
			headingLevel = 16
		}

		for prev := parent.Previous; nil != prev; prev = prev.Previous {
			b := prev
			if ast.NodeSuperBlock == prev.Type {
				// 超级块中包含标题块时下方块面包屑计算不正确 https://github.com/siyuan-note/siyuan/issues/6675
				b = treenode.SuperBlockLastHeading(prev)
				if nil == b {
					// 超级块下方块被作为嵌入块时设置显示面包屑后不渲染 https://github.com/siyuan-note/siyuan/issues/6690
					b = prev
				}
			}

			if ast.NodeHeading == b.Type && headingLevel > b.HeadingLevel {
				if b.ParentIs(ast.NodeListItem) {
					// 标题在列表下时不显示 https://github.com/siyuan-note/siyuan/issues/13008
					continue
				}

				name = gulu.Str.SubStr(renderBlockText(b, excludeTypes, true), maxNameLen)
				name = util.UnescapeHTML(name)
				name = util.EscapeHTML(name)
				ret = append([]*BlockPath{{
					ID:      b.ID,
					Name:    name,
					Type:    b.Type.String(),
					SubType: treenode.SubTypeAbbr(b),
				}}, ret...)
				headingLevel = b.HeadingLevel
			}
		}
	}
	return
}

func buildBacklinkListItemRefs(refDefs []*RefDefs) (retRefDefs []*RefDefs, originalRefBlockIDs map[string]string) {
	return buildBacklinkListItemRefsInBox(refDefs, "")
}

func buildBacklinkListItemRefsInBox(refDefs []*RefDefs, boxID string) (retRefDefs []*RefDefs, originalRefBlockIDs map[string]string) {
	originalRefBlockIDs = map[string]string{}

	var refIDs []string
	for _, refDef := range refDefs {
		refIDs = append(refIDs, refDef.RefID)
	}
	sqlRefBlocks := sql.GetBlocksInBox(refIDs, boxID)
	refBlocks := fromSQLBlocks(&sqlRefBlocks, "", 12)
	for _, mapping := range buildBacklinkParentMappings(refBlocks, boxID) {
		for _, refDef := range refDefs {
			if mapping.coveredRefIDs[refDef.RefID] {
				refDef.RefID = mapping.parent.ID
			}
		}
		originalRefBlockIDs[mapping.parent.ID] = mapping.refBlock.ID
	}
	retRefDefs = mergeBacklinkRefDefs(refDefs)
	return
}